remarkablemark.org

Site of @remarkablemark. Built with Jekyll and hosted on GitHub Pages. Please support this site and join our Discord!

Prerequisites

Ruby 2.7.3:

ruby --version

If your version is behind, you can install ruby with rbenv or RVM.

Install and set up rbenv on macOS:

brew install rbenv
rbenv init

Reload or open a new shell:

curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash
rbenv install 2.7.3
rbenv local 2.7.3

gem install bundler
bundler --version

Update bundler:

bundle update --bundler

Clone the repository:

git clone --recursive https://github.com/remarkablemark/remarkablemark.github.io.git
cd remarkablemark.github.io

If you forgot to clone the git submodule:

git submodule update --init --recursive

To switch the git submodule remote URL from HTTPS to SSH:

cd assets
git remote set-url origin git@github.com:remarkablemark/assets.git

Install the dependencies:

bundle install

Update the dependencies:

git checkout master
git pull
bundle update

bundle exec jekyll serve --livereload # --incremental --limit_posts 1

The server will be running at http://127.0.0.1:4000/:

open http://127.0.0.1:4000/

To stop the server, press CTRL-C.

bundle exec jekyll build

The site will be generated at ./_site/.

Use HTMLProofer to validate HTML output (see post):

bundle exec jekyll build
bundle exec htmlproofer --http-status-ignore '0,301,400,401,429,999' ./_site/

:tophat: Site of @remarkablemark.

Language:SCSS 59.0%Language:HTML 40.6%Language:Ruby 0.4%