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.
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.
Clone the blog’s repository.
git -C Projects clone email@example.com:jwillikers/blog.git
Change into the blog’s directory.
Install the dependencies needed for asdf.
sudo dnf -y install gcc gcc-c++ libffi-devel ruby-devel rubygem-bundler
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.
jekyllexecutable with the
ssubcommand, 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 Generating... Jekyll Feed: Generating feed for posts Auto-regeneration: enabled for '/home/jordan/Source/blog' Server address: http://127.0.0.1:4000/ Server running... press ctrl-c to stop.
Open the server address provided in the previous output with your web browser of choice.
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
Open Source Software
Code of Conduct
The project’s Code of Conduct is available in the CODE_OF_CONDUCT.adoc file.
The website’s content is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
© 2020-2022 Jordan Williams