remarkablemark.org
Site of remarkablemark. Built with Jekyll and hosted on GitHub Pages.
Please support this site and join the Discord!
Prerequisites
Ruby 2.7.4:
ruby --versionIf your version is behind, you can install ruby with rbenv or RVM.
rbenv
Install and set up rbenv on macOS:
brew install rbenv
rbenv initReload or open a new shell:
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash
rbenv install
rbenv localgem install bundler
bundler --versionUpdate bundler:
bundle update --bundlerInstall
Clone the repository:
git clone --recursive https://github.com/remarkablemark/remarkablemark.github.io.git
cd remarkablemark.github.ioIf you forgot to clone the git submodule:
git submodule update --init --recursiveTo switch the git submodule remote URL from HTTPS to SSH:
cd assets
git remote set-url origin [email protected]:remarkablemark/assets.gitInstall the dependencies:
bundle installUpdate
Update the dependencies:
git checkout master
git pull
bundle updateRun
Development Server
bundle exec jekyll serve --livereload # --incremental --limit_posts 1The 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.
Production Build
bundle exec jekyll buildThe site will be generated at ./_site/.
Testing
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/Support
License
Copyright © Menglin "Mark" Xu.