So you wanna build the site?
mochajs.org is built using Jekyll, the popular static site generator.
- Ruby
- RubyGems
- Bundler (
gem install bundler
) - Node.js v6.x or greater
- Run
npm install
from working copy root to get Node.js deps. - Run
bundle install
to install Jekyll and its dependencies. This may or may not require elevated privileges, depending on your system. - To serve the site and rebuild as changes are made, execute
npm start docs.watch
. - To rebuild the site once, execute
npm start docs
.
- The content lives in
docs/index.md
; everything else is markup, scripts, assets, etc. - This file (
docs/README.md
) should not be included in the build. docs/index.md
may be mutated upon build, depending on whatscripts/docs-update-toc.js
does. If it updates the table of contents (because of your changes), you must commitdocs/index.md
.docs/_site/
is where the generated static site lives (and is what you see at mochajs.org). It is not under version control.
©️ 2016-2018 JS Foundation and contributors.
Content licensed CC-BY-4.0.
Code licensed MIT.