Once you've created the Living Style Guide, you may want to publish it to share it with your team.
The Generated Site
However you decide to publish your Living Style Guide, everything you need has been generated in the output directory defined in your document.json configuration file. In our guides, this directory is styleguide. Simply publish this entire folder and you'll have a self-contained site.
Live Hosting
Your Living Style Guide will automatically change and evolve along with your project. However, if you'd like your published guide to change as well, you'll need to do some additional setup based on how you're hosting the site.
GitHub Pages
If your project is using GitHub Pages, the published version will automatically update whenever you push changes to the gh-pages branch. It is important to note that you must run the documentjs command to build the site locally, then push the generated files to GitHub.
Advanced Setup
For other situations, you may need a developer's help with hosting the Living Style Guide. If you need help with a specific project, you can also ask in Gitter.
The Generated Site
However you decide to publish your Living Style Guide, everything you need has been generated in the output directory defined in your
document.json
configuration file. In our guides, this directory isstyleguide
. Simply publish this entire folder and you'll have a self-contained site.Live Hosting
Your Living Style Guide will automatically change and evolve along with your project. However, if you'd like your published guide to change as well, you'll need to do some additional setup based on how you're hosting the site.
GitHub Pages
If your project is using GitHub Pages, the published version will automatically update whenever you push changes to the gh-pages branch. It is important to note that you must run the documentjs command to build the site locally, then push the generated files to GitHub.
Advanced Setup
For other situations, you may need a developer's help with hosting the Living Style Guide. If you need help with a specific project, you can also ask in Gitter.