The website for Electron (formerly known as Atom-Shell).
This is a Jekyll site hosted on GitHub Pages. To build a Jekyll site you'll need a few things on your system so double check the Jekyll requirements. In addition to those, you'll need these Ruby gems:
$ gem install jekyll
$ gem install bundlerFollow these steps to copy this repository to your computer and build the site:
$ git clone https://github.com/electron/electron.atom.io.git
$ cd electron.atom.io
$ script/bootstrap
$ script/serverThis site has versioned documentation, recent release change logs and the current versions of Node.js, Chromium and V8 that are used in Electron.
Each of these are updated upon a minor release of Electron. They're done so with the command line interface detailed below.
You'll need Node.js installed on your system in order to use the CLI. Then you can install the dependencies:
$ cd electron.atom.io
$ npm installVersions of Electron documentation are fetched from the electron/electron repository's docs directory. To fetch documentation at a specific version:
$ script/docs <version> [options]
# Example:
$ script/docs v0.26.0 --latestOptions:
--latest Set this version as the latest version of documentation
The most recent release notes from the electron/electron repository are made available on the site and can be updated by running:
$ script/releasesTo update the _config.yml in this site with the versions of Node.js, Chromium and V8 that the latest [minor release] of Electron is using run:
$ script/versionsThe scripts above do each task separately but to run all the things at once:
$ npm run latest -- <version>
# Example:
$ npm run latest -- v0.36.0Note This assumes version is the latest and sets it as such by default.
Testing
To test the documentation script:
$ npm testThanks for contributing to the site! Checkout the contributing documentation for guidelines on pull requests.