How to develop Ciro Santilli's website before the cirodown migration | 🗖 nosplit | ↑ parent "Ciro Santilli's website" | 220
The website moved from Asciidoctor to Cirodown in 2020, making this section mostly useless. But hey, history!
The source code is located at: https://github.com/cirosantilli/cirosantilli.github.io
Build locally, watch for changes and rebuild automatically, and start a local server with:
The website will be visible at: http://localhost:4000.
Tested on the latest Ubuntu.
Publish changes to GitHub Pages:
GitHub forces us to use the master branch for the build output... so the actual source is in the branch
Update the gems with:
His website was originally written in Markdown, however those were deprecated in favour of Asciidoctor when Ciro saw the light, rationale shown at: markdown-style-guide#use-asciidoc
GitHub pages is chosen instead of a single page GitHub README.adoc for the following reasons:
- Ciro will want some unsupported extensions, notably mathematics, likely with KaTeX server side:
- when GitHub dies, Ciro's website URL still lives and retains the PageRank!