This GitHub repository is my method of learning how to use git
version control, GitHub, web templating, HTML, CSS and JavaScript.
To view the GitHub pages site generated by this repository, go to: https://notes.bweston.uk.
To build this site manually use the following instructions for Arch Linux. For more general instructions, refer to Testing your GitHub Pages site locally with Jekyll. To start, clone the repository.
-
Install Ruby and RubyGems:
# pacman -S rubygems base-devel
-
Install Bundler:
$ gem install bundler
-
Add the RubyGem intall directory to your
PATH
:$ export PATH="$HOME/.local/share/gem/ruby/2.7.0/bin:$PATH"
This is only required if you were prompted by
gem
to do so in step 2. To set this permanently, add this line to the end of yourbashrc
or equivalent and thensource
the file. -
Navigate to
/docs
and runbundle
to install the site dependencies:$ cd docs $ bundle install
This may take several minutes to complete.
-
To build the site run:
$ bundle exec jekyll serve
This may also take some time to run due to the number of posts.
This will build the site in the folder
/docs/_site
. You can also preview the site athttps://localhost:4000
.
All source files are located in /docs
. To make accessing these files easier on desktop, they are symlinked by folders in each module. This structure doesn't work well on github.com as the links are treated as files.