This is the source for the babeljs.io website, powered by Jekyll.
This repo also contains babel's source documentation.
The babel repo is babel/babel
Feel free to suggest changes to our docs, or add new content!
- Please install ruby, if not already installed.
- Use
which ruby
orruby --version
, to verify if ruby is installed. - Make sure
bundler
is installed by runninggem install bundler
- Use
$ git clone [email protected]:babel/babel.github.io.git
$ cd babel.github.io
$ make bootstrap
- Just run
npm start
next time.
To keep documentation in sync across all of Babel's packages and plugins, the documentation for the plugins and presets is sourced directly from the README files located inside their respective repositories (Babel's packages, Babili's packages, ...).
For pages that are sourced from README files, the package
field in the header needs to correspond to your package name. This package name also needs to be added to scripts/download-readmes.js
.
layout: docs
title: babel-register (require hook)
description: How to use babel-register, the require hook.
permalink: /docs/usage/babel-register/
redirect_from:
- /docs/usage/require/
package: babel-register
{% include package_readme.html %}
For example babel.github.io/docs/plugins/preset-stage-0.md which then points to babel/packages/babel-preset-stage-0/README.md
If you encounter an Liquid Exception: Included file '_includes/.../packages/.../README.md' not found
, please double check your package
configuration, and ensure you have ran scripts/download-readmes.js
(make build
will run this for you).
npm test
This will lint markdown documents inside both the website and the imported repositories (like babel, babili, etc).
rake
Running this will check the compiled output for broken links and invalid markup.
For questions and support please join our Slack community, channel #website or directly here.