CONTRIBUTING.md: note about using 'localhost'

This commit is contained in:
Yann Cébron 2019-04-12 17:00:27 +02:00
parent 71467a655a
commit 0e76e3bd67

View File

@ -101,6 +101,8 @@ This is made easier if you use [Chocolatey](https://chocolatey.org), a package m
To build and test the site, simply run `rake preview`. This will build the site and host it, using the config provided. The URL of the hosted site is displayed on the screen and depends on the `baseurl` field defined in `_config.yml`.
> **NOTE** You must use `localhost` as hostname, otherwise fonts will fail to load.
## Markup
By default, when building the site, all files are copied to the destination `_site` folder. Some files are excluded in the `_config.yml` and `sdkdocs-template/jekyll/_config-defaults.yml` files. The documentation files themselves are [Markdown](https://daringfireball.net/projects/markdown/) files (`.md`) that get automatically converted to HTML when the site is built.