This is the repo that should be forked when you want to edit Daleks Homepage.
You need to have Ruby, Node.js installed, as well as Grunt, Sass and Bower.
After you cloned the repository, you need to install all the frontend and development dependencies. You can do this by running these commands from your command line:
npm install
bower install
git clone [email protected]:LeaVerou/prism.git bower_components/prism
Once you installed the dependencies, you can start a development server (port 8888) as well as the sass compiler, by simply running:
grunt
from the root directory of the homepage.
You can edit all files in the root
folder, as well as the html files in the pages
folder and all scss, image and js files in the css
, img
and js
folders.
All contents of the docs
folder are generated automatically, never ever edit them
manually, because all your changes will be overridden!
If you find a typo or want to add smth. to one of the pages in the docs
folder,
look for the corresponding dalek modules (e.g. if you want to change smth. in the firefox.html file, look for the dalek-browser-firefox module, in the json.html file, look for the dalek-reporter-json file, etc.).
The HTML files will be generated out of the DocBlock comments, every comment that is annotated with the @api
annotation will be parsed and included in the HTML file (top to bottom). Markdown is supported within the DocBlock comments and should be used to apply some markup to the docs.
Also, to syntax highlight specific parts with Prism, you can add language specific code blocks:
Example:
/**
* I am a dummy comment
*
* A list
* - One
* - Two
* - Three
*
* Code samples:
*
* ```html
* <div>FooBar</div>
* ```
*
* ```css
* selector {
* key: value
* }
* ```
*
* ```javascript
* var some = funky ? one : liner;
* ```
*
* ```bash
* $ dalek run_dalek_run.js
* ```
*
* @api
* @part Example
*/
The header
and footer
handlebars templates from the assets
folder
are used to add a header and a footer to all the subpages from the pages
folder, as well as to the auto generated contents of the docs
folder.
If you push changes to this repo or any of the module repos the page gets generated & deployed automatically once you pull request has been accepted.