Auto-build and host pretty HTML documentation using AsciiDoc, GitHub Pages & GitHubActions

Auto-build and host pretty HTML documentation using AsciiDoc, GitHub Pages & GitHub Actions. How to automatically build AsciiDoc into HTML on every Git commit using GitHub actions, and host it using GitHub pages. I use AsciiDoc for the “real” documentation.

How to automatically build AsciiDoc into HTML on every Git commit using GitHub actions, and host it using** GitHub pages.**

Example of the end result;

• docs.upsilonproject.io which is built from  https://github.com/upsilonproject/upsilon-docs
• https://redhat-cop.github.io/agnosticd/ which is built from  https://github.com/redhat-cop/agnosticd

Setup AsciiDoc in your repository

GitHub favours Markdown the the README — so in my projects I keep a README.md that describes the project like normal. , but I use AsciiDoc for the “real” documentation. My real documentation spans multiple files, so I use a docs directory in my repositories. As your project grows, you’ll find you cannot document everything in the README.md .

While your README.md serves as a high level introduction, or a quickstart to your project, your docs is something different — much more detailed, how to use your project, troubleshooting etc. I use AsciiDoc because I’ve found it’s better than markdown for more detailed project documentation.

If you’re not used AsciiDoc before, it’s similar to Markdown, but has lots of extra syntax that allows for much more rich documentation. For example, tables of contents, better control over heading levels, links to headings, heading numbering, etc.

github github-pages documentation

Long story short: Jekyll is a template engine changing markdown documents on static HTML webpages, that you can then host anywyere, because you don't need databases or server that has PHP or Python.

Deploying my portfolio website on Github Pages using Github Actions. I recently deployed my portfolio site and wanted to try out github actions and this is my experience of automating the deployment.

In this post, I will show you how to publish your book or documentation on GitHub Pages in less than ten minutes.

In this article we are going to compare three most popular machine learning projects for you.

Convert Your Jupyter-notebook to Github pages with Github-action. Merge pull request and wait until Github-action makes Github pages.