Hugo & Asciidoctor, edited with VS Code, built with GitLab CI/CD and hosted on Firebase.

Showing how Hugo and Asciidoc files can live together, and the tools to make it happen.

Why on Earth would you ever do something like this? Well, because Hugo is a fantastic static site generator that supports Asciidoc format content files with an external helper, and Asciidoc is an excellent plain text documentation format for content that requires a bit more power than Markdown alone can provide. This post goes over what I setup to make this happen. Overview Of course you can roll your own to get the job done, but here is what I used in my solution.

Why I keep Hugo in my repository and how I update it with Python.

A simple Python script for updating Hugo and Keeping Binaries in my Repository

For one of my projects I have a few different site developers and content authors. I really wanted to simplify the process of adding a new member to the team and get them up to speed quickly. Fortunately, the Static Site Generator “Hugo” uses compiled binaries and does not require anything setup on the system to run. Having said that, setting up a couple of external tools (NPM and Python) can make running and updating Hugo on any OS a breeze for anyone on the team.