I write most of my documents (blog posts, documentation, recipes and so on) with Asciidoctor . Everything is organized in Git repositories.
So today I played with WSL2 and a Makefile to build all Asciidoctor files in a directory.
What happened the last 18 months? I stayed with the theme I selected 2018, but I tweaked it a little bit. So I added
lunr to implement searching, changed all scripts and fonts from CDN to local (privacy and tracking), updated Bootstrap 3 to 4.
Working with Bootstrap was quite fun, I haven’t done a lot of
CSS the last years, but the grid and css classes from Bootstrap are working without checking each change on all browsers and are responsive.
This time there was a technical issue during the recording and so there are only the slides available, but you can still watch the video of the Froscon talk: Froscon 13: Documentation with any Editor
Most used means always most interesting for bad guys. Dynamic pages are slower and can contain more vulnerabilities than static pages (which Hugo generates). Hugo supports git, so I have version control in my posts and design. I can start a small web server locally and test the posts:
hugo server -D and the most convenient thing: I can use VIM for editing.