mirror of
https://github.com/jgthms/bulma.git
synced 2024-10-17 09:04:18 +00:00
c416eb510d
* Add an extra prerequisite - ruby2.x-dev Trying to install Jekyll on my Linux (Ubuntu 16.04) machine failed because ```ruby 2.x``` was installed and ```ruby2.x-dev``` was not. I spent a lot of time trying to figure it out (I'm no ruby expert) but installing the ```ruby2.x-dev``` solved my problem. * Add a note for Ubuntu users
22 lines
1.2 KiB
Markdown
22 lines
1.2 KiB
Markdown
## Building the documentation
|
|
|
|
The documentation HTML is produced with the Ruby-based `jekyll` tool.
|
|
|
|
1. Make sure Ruby 2.x is installed.
|
|
2. `gem install jekyll`
|
|
|
|
> **Note**: If you are an ```Ubuntu user``` Make sure ruby2.x-dev is installed
|
|
|
|
## Viewing the documentation locally
|
|
|
|
Then to view the documentation in your local checkout:
|
|
|
|
1. Before you begin, cd into `docs/` directory, and `cp _config.yml _config.local.yml`. Then edit `_config.local.yml` and change the `url:` value to `http://localhost:4000`. This local config file will be ignored by git.
|
|
1. In a separate shell session, `cd` to the `docs/` directory, and do:
|
|
```
|
|
jekyll serve --incremental --config _config.local.yml
|
|
```
|
|
This will start an HTTP server at `http://localhost:4000/` that serves the docs built in the `_site` directory; and anytime the docs are rebuilt by you, it will serve the docs site on the fly.
|
|
2. In your main shell session where you develop, if you change anything in `docs/` the jekyll server will rebuild those on the fly. But if you change anything about the Bulma SASS or CSS, you need to do `npm run start-docs` to build the docs' CSS before you will see it in the browser. The process running `jekyll serve` will pick up the new CSS automatically.
|
|
|