A step-by-step guide to publishing a standalone story from a dataset.
- Tutorial: palewi.re/docs/first-visual-story
- Demonstration: palewire.github.io/first-visual-story
- Issues: https://github.com/palewire/first-visual-story/issues
The documentation for this site is published via Sphinx and written in Markdown files in the tutorial
directory.
An edit there followed by push to the master branch on GitHub will trigger the docs being redeployed to https://palewi.re/docs/first-visual-story/.
- If you're using pipenv (recommended), start a virtual environment with
pipenv shell
- Install dependencies with
pipenv install --dev
- Run
make docs
. You'll be able to see your local version of the docs at localhost:8000
The demonstration site at palewire.github.io/first-visual-story is published via GitHub Pages and the demo
folder, following the instructions in the tutorial. Changes made there will go live following a push to the main
branch.