09 November 2018

Versie 0.7 - Static sites: alternatieven voor Joomla
Eerste versie geschreven op 2018-09-24

Ik ga alle tekst van mijn websites omzetten naar ASCIIDOC. Nieuwe artikelen worden voortaan ook in dat format geschreven. De documenten zet ik om met JBake zodat ze leesbaar worden op internet.

een 'beetje terug naar vroeger' en de mogelijkheid om wat nieuws te leren.

2 redenen: (1) ik wil geen tijd meer besteden aan software die websites in de lucht houden, (2) mijn ISP upgrade haar platformen wat al mijn websites vernaggelt. Ik zou (2) kunnen oplossen met upgrades van software, maar dat is strijdig met (1).. :-)

Een maand geleden zette ik de eerste asciidoc/jbake website online. Alle tekst uit mijn stamboom website is omgezet en hier beschikbaar gemaakt. Met de teksten uit mijn persoonlijke website ben ik nog bezig.

Al doende loop ik door de asciidocor manual heen en experimenteer ik met het inbedden van plaatjes, het maken van tabellen, opnemen van footnotes e.d.

Dynamisch

Voor websites met relatief weinig content zijn database gestuurde websites overkill. Eind '90 was het hip als je van handmatig gebouwde statische sites overging naar dynamische versies, zoals PHPnuke, Joomla, Drupal, Wordpress en andere. Elk met een eigen - steile - leercurve. Het was lollig. Maar nu niet meer.

Niet lollig is het als je meer tijd besteedt aan webmaster-en dan aan het creƫren van content.

De websites op al mijn domeinen draaiden jaren op Joomla. Ik ben dat beu. Dit type CMS software, die strikt genomen alleen bedoeld is om teksten en plaatjes te presenteren op internet, verlangt constant en in toenemende mate onderhoud. Soms simpel en zo klaar, meestal niet (Murphy). Daarbij de inbraken en vernielingen van sriptkiddys en ander gespuis. Ik ben op zoek naar alternatieven.

Internet Service Provider

Mijn huidige ISP 'mijndomein' is bezig haar systemen te voorzien van nieuwe software. Op zichzelf een goed streven. In mijn geval had dit proces als resultaat dat al mijn domeinen voor een week niet bereikbaar waren en/of dat Joomla niet meer naar behoren werkte. Nog steeds niet.[1] Een mens kan daar teleurgesteld over zijn.. Misschien had ik meer aandacht moeten besteden aan het updaten van Joomla en alle utils die ik gebruik. [BORING] Misschien had de ISP beter moeten nadenken over hun conversie.

Het betekent het dat het hoog tijd is om wat anders te doen met het presenteren van mijn verhaaltjes. Het wordt een beetje 'terug naar vroeger': statische websites met alleen HTML en wat Javascript en CSS.

Bestands format

Niet meer terug naar 'WYSIWYG HTML Editors'. Geen HTML meer. Welk format dan? Er zijn 2 kandidaten:

1 Markdown

"Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)."

2Asciidoc

"AsciiDoc is a text document format for writing notes, documentation, articles, books, ebooks, slideshows, web pages, man pages and blogs. AsciiDoc files can be translated to many formats including HTML, PDF, EPUB, man page. You write an AsciiDoc document the same way you would write a normal text document, there are no markup tags or weird format notations. AsciiDoc files are designed to be viewed, edited and printed directly or translated to other presentation formats using the asciidoc(1) command.

The asciidoc(1) command translates AsciiDoc files to HTML, XHTML and DocBook markups. DocBook can be post-processed to presentation formats such as HTML, PDF, EPUB, DVI, LaTeX, roff, and Postscript using readily available Open Source tools."

Static sites

Om de Markdown of Asciidoc tekst formats om te zetten in het op het www gebruikte HTML, gebruiken we 'Static Site Generators'. Gelukkig bestaan er veel 'Static Site Generators' en 'Static Site Baking Tools' die precies dat doen.

Pico CMS

Ik had al een experiment lopen met Pico CMS. Ik hoorde ervan omdat het een van de app’s is die je kan gebruiken in Nextcloud. Ik gebruik Nextcloud als hosting platform voor mijn data. PicoCMS is simpel en snel. Geen backend en database. Het vertaalt Markdown-bestandjes met platte tekst naar webpagina’s. Markdown is eenvoudig te leren, maar heeft z’n beperkingen.

Jbake

JBake is a Java based open source static site/blog generator. Het werkt met Markdown en Asciidoc bestanden.

Software

Ok. In de lucht.. Met Asciidoc en JBake. How nerd is dat? ;-)

Er kwam een hele reeks aan programma’s aan te pas. De meeste waren al bekend. Git ben ik aan het bekijken om grote en kleine veranderingen aan configs en teksten te kunnen bijhouden. Ik denk met name aan data met betrekking tot mijn stamboom onderzoek. In de loop der jaren is her en der wat geschreven wat ik bij elkaar wil zetten.

Tool Beschrijving

Visual Studio Code

Free, opensource editor. Ik schrijf er de asciidoc en Markdown teksten mee. Ik gebruik het natuurlijk ook voor configfiles e.d.

Jbake

Java based open source static site/blog generator. Deze site is ermee gemaakt

Asciidoctor

Text processor and publishing tool

WinSCP

WinSCP is a SFTP client and FTP client for Microsoft Windows. Copy file between a local computer and remote servers using FTP, FTPS, SCP, SFTP, WebDAV or S3 file transfer protocols.

Draw.io

For making flowcharts, process diagrams, org charts, UML, ER diagrams, network diagrams and much more. Feitelijk gebruik ik de plugin in Nextcloud

Irfanview

IrfanView is a fast, compact and innovative FREEWARE (for non-commercial use) graphic viewer. I use it ua for Batch conversion (with advanced image processing)

git

free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

Wat nu

Ik ga me verder verdiepen in de mogelijkheden van Asciidoc / Asciidoctor. Dat zal zal om te beginnen heel praktisch zijn:

  • alle tekst uit de 2 Joomla databases knippen, plakken en opmaken in asciidoc format. Graphics opnemen in de bestanden.

  • renderen met jbake

  • online publicatie

⇒ geschreven met Visual Studio Code in Asciidoc.


1. per 8 november 2018 verwijzen https://www.familiebastiaans.nl en https://roelbazuin.com/ automatisch door naar deze website en zijn niet meer afzonderlijk te bezoeken. Daags daarvoor hadden de upgrades ze definitief gebroken