Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


My developer blog containing handy admin and dev guides from my myriad of tinkering. Content is written primarily in Asciidoctor. Jekyll generates a static website from the content which is then deployed with GitHub Pages. The website is available at


Contributions in the form of issues, feedback, and even pull requests are welcome. I really appreciate pointing out typos, incorrect instructions, and ways to improve or simplify posts. Considering this my personal blog, you will want to create an issue or contact me before making any significant pull request. Make sure to adhere to the project’s Code of Conduct. If you wish to test the website locally, please see Getting Started.

Getting Started

The steps below will create an environment for generating the website locally. These steps assume you are on Fedora and familiar with the Linux command-line and Git.

  1. Clone the blog’s repository.

    git -C Projects clone
  2. Change into the blog’s directory.

    cd ~/Projects/blog
  3. Install the dependencies needed for asdf.

    sudo dnf -y install gcc gcc-c++ libffi-devel ruby-devel rubygem-bundler
  4. Install the required Ruby gems.



Jekyll supports running a web server on the local machine, which can be used to preview and test changes to the website. The steps below describe how to do this below, assuming you are in the project directory running Ubuntu with the GNOME desktop.

  1. Run the jekyll executable with the s subcommand, i.e. serve.

    bundle exec jekyll s
    Configuration file: /home/jordan/Source/blog/_config.yml
                Source: /home/jordan/Source/blog
           Destination: /home/jordan/Source/blog/_site
     Incremental build: disabled. Enable with --incremental
           Jekyll Feed: Generating feed for posts
     Auto-regeneration: enabled for '/home/jordan/Source/blog'
        Server address:
      Server running... press ctrl-c to stop.
  2. Open the server address provided in the previous output with your web browser of choice.

  3. When finished testing, type Ctrl+C to stop the local web server.


The website can be generated locally by passing the b subcommand, i.e. build, to Jekyll.

bundle exec jekyll b


Continuous integration is configured through Travis CI. Trigger the CI to build and deploy by pushing changes to the master branch on the GitHub remote.

git push

The updated website is deployed to

Open Source Software

This project is built on the hard work of countless open source contributors. Several of these projects are enumerated below.

Code of Conduct

The project’s Code of Conduct is available in the CODE_OF_CONDUCT.adoc file.


This repository is licensed under the GPLv3, available in the LICENSE.adoc file.

The website’s content is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

© 2020-2022 Jordan Williams



My developer blog containing handy admin and dev guides from my myriad of tinkering.







Contributors 4