bulma/docs
CS Rhymes fd909d1eea Fix broken image reference for bulma-block-list extension (#2735)
* Added bulma-block-list to extensions

* Update extension image to png
2019-12-10 22:58:48 +01:00
..
_data Update colors.json approving it 0.8.0 version 2019-12-02 16:22:47 -05:00
_includes Update backers November 2019, Fix #2696 2019-11-14 14:34:40 +00:00
_javascript Docs: Prevent JS error if Vimeo does not load. Resolves #2635. 2019-11-30 15:24:41 -05:00
_layouts Write 0.8 blog post 2019-10-17 20:51:42 -04:00
_posts New 0.8.0 blog post 2019-10-21 15:22:27 -04:00
_sass Update sponsors 2019-11-24 18:02:30 -05:00
_scripts Rename scripts folder 2019-05-18 16:11:16 +01:00
css Update sponsors 2019-11-24 18:02:30 -05:00
documentation Fix typo in tag name 2019-11-06 05:45:54 -05:00
favicons Update favicons 2017-01-04 19:00:50 +01:00
images Fix broken image reference for bulma-block-list extension (#2735) 2019-12-10 22:58:48 +01:00
lib Docs: Prevent JS error if Vimeo does not load. Resolves #2635. 2019-11-30 15:24:41 -05:00
vendor Add native 2018-03-29 22:25:55 +01:00
_config.yml Website 0.7.0 2018-04-13 16:45:12 +01:00
.babelrc Add babel 2017-07-01 18:30:39 +01:00
.gitignore fix: documentation button hidden on tablets 2019-10-17 11:49:01 +01:00
alternative-to-bootstrap.html add Accessibility section for Bootstrap 2018-10-02 06:24:00 +01:00
atom.xml Xml Escape for Author Name 2019-01-23 22:13:52 +00:00
backers.html Add GitHub sponsor button 2019-10-07 14:56:18 +01:00
blog.html Update backers July 2019 2019-07-09 12:20:21 +01:00
bulma-dark.sass Add more color documentation, Add light buttons to docs 2019-10-17 20:51:42 -04:00
bulma-docs.sass Add more color documentation, Add light buttons to docs 2019-10-17 20:51:42 -04:00
bulma-start.html Update bulma-start 2019-02-07 19:22:21 +00:00
CNAME Create CNAME 2016-09-11 14:32:11 +01:00
docker-compose.yml docker-compose file 2017-04-01 13:39:17 +01:00
documentation.html Add documentation icons 2018-04-10 22:38:00 +01:00
expo.html Fix share URL 2019-10-18 07:43:14 -04:00
extensions.html Added bulma-block-list to extensions 2019-12-09 05:09:08 +00:00
index.html Add Boosta 2019-07-18 10:56:18 +02:00
LICENSE Update templates 2017-01-15 21:45:20 +00:00
love.html Fix tw element 2019-04-07 16:28:01 +01:00
made-with-bulma.html Add documentation icons 2018-04-10 22:38:00 +01:00
more.html Add link element 2018-04-10 22:50:18 +01:00
package.json Update docs for 0.7.4 2019-02-08 12:15:52 +00:00
README.md Add tip to open local server URL after build 2019-03-05 12:13:39 +01:00
templates.html Organize partials 2018-04-09 22:25:26 +01:00
thank-you.html Organize partials 2018-04-09 22:25:26 +01:00
tiles.html Organize partials 2018-04-09 22:25:26 +01:00
videos.html Fix relative links 2018-10-12 11:23:32 +01:00
yarn.lock Upgrade docs yarn.lock 2019-10-12 21:50:39 +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 if jekyll is not already installed.

Note

: If you are an Ubuntu user, make sure ruby2.x-dev is installed.

Viewing the documentation locally

To view the documentation on your system locally:

Setup

  1. cd into docs/ directory
  2. Copy the config file, cp _config.yml _config.local.yml
  3. Edit _config.local.yml and change the url: value to http://localhost:4000. This local config file will be ignored by git.

Run Jekyll

  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. You can also add the --open-url option (or its alias --o) to automatically open the server URL in your default browser when it's ready.

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