This repo contains the content for the https://orbitalmock.com website.
The site is hosted via GitHub Pages. It is built using the Jekyll static site generator.
To make changes to the site, merge the updates into the main
branch and GitHub will re-compile and update the pages automatically after a few minutes.
- Navigate to Ruby Installer for Windows and download the latest version.
- Launch the requisite
<ruby_version>.exe
file inDownloads
directory and follow the install Wizard prompts. Accept licensing terms, check packages and installation location. - Once installed, a cmd shell opens and instructs to install dependencies - press
1,3
and hitEnter
to install all. - A second prompt asks to install further dependencies. Hit
Enter
to install. - The shell automatically closes down. Open a new terminal to confirm installation with
ruby -v
. Output should read similar to:
PS C:\Users\<USERNAME> ruby -v
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x64-mingw-ucrt]
- Open a new cmd and install Jekyll and Bundler using
gem install jekyll bundler
- Confirm install with
jekyll -v
. Output should read similar to:
PS C:\Users\<USERNAME> jekyll -v
jekyll 3.9.2
- Navigate to
Orbital-Docs
directory where the_config.yml
andGemfile
are located. - Open a cmd shell (VSCode recommended) and enter
bundle exec jekyll serve
. - The builder will confirm configs, dependencies and serve the website locally on http://localhost:4000
For further troubleshooting info and guides, please consult the Official Jekyll docs for Windows
- Install the Homebrew package manager.
-
Use Homebrew to install ruby:
brew install ruby
-
Add the homebrew ruby to the
PATH
to override the macOS ruby
https://mac.install.guide/ruby/13.html
Edit the~/.zshrc
file and add the following to the bottom of the file (For Intel Mac):if [ -d "/usr/local/opt/ruby/bin" ]; then export PATH=/usr/local/opt/ruby/bin:$PATH export PATH=`gem environment gemdir`/bin:$PATH fi
-
Launch a new terminal and confirm the ruby version with
ruby -v
It should be version 3.x.x (not 2.x.x)
i.e.ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-darwin20]
- Install Jekyll and Bundler using
gem install jekyll bundler
- Confirm install with
jekyll -v
. Output should read similar to:jekyll 4.2.2
Note:jekyll -v
may not work from the repo directory, try from the home directorycd ~
- Open a terminal
- Navigate to
Orbital-Docs
directory where theGemfile
file is located. - Install the bundle using
bundle install
- Navigate to
Orbital-Docs
directory where the_config.yml
is located. - Open a terminal and enter
bundle exec jekyll serve
. - The builder will confirm configs, dependencies and serve the website locally on http://localhost:4000