bulma/docs/versions/0.5.1
2017-08-10 21:04:24 +01:00
..
2016 Archive version 0.5.1 2017-08-10 21:04:24 +01:00
2017 Archive version 0.5.1 2017-08-10 21:04:24 +01:00
alternative-to-bootstrap Archive version 0.5.1 2017-08-10 21:04:24 +01:00
blog Archive version 0.5.1 2017-08-10 21:04:24 +01:00
css Archive version 0.5.1 2017-08-10 21:04:24 +01:00
documentation Archive version 0.5.1 2017-08-10 21:04:24 +01:00
expo Archive version 0.5.1 2017-08-10 21:04:24 +01:00
extensions Archive version 0.5.1 2017-08-10 21:04:24 +01:00
favicons Archive version 0.5.1 2017-08-10 21:04:24 +01:00
images Archive version 0.5.1 2017-08-10 21:04:24 +01:00
lib Archive version 0.5.1 2017-08-10 21:04:24 +01:00
love Archive version 0.5.1 2017-08-10 21:04:24 +01:00
thank-you Archive version 0.5.1 2017-08-10 21:04:24 +01:00
tiles Archive version 0.5.1 2017-08-10 21:04:24 +01:00
vendor Archive version 0.5.1 2017-08-10 21:04:24 +01:00
versions Archive version 0.5.1 2017-08-10 21:04:24 +01:00
index.html Archive version 0.5.1 2017-08-10 21:04:24 +01:00
LICENSE Archive version 0.5.1 2017-08-10 21:04:24 +01:00
README.md Archive version 0.5.1 2017-08-10 21:04:24 +01:00

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

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.
  2. 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.