Pages and posts can be written in markdown (.md) restructured text (.rst) or in html (.html). In any document format, the headers are essential to generating valid web pages.
Do not use H1 to represent the title of a document. Use H1s as the highest level of your page outline. You can have multiple H1s.
This project generates static content for databrary.org and datavyu.org using Pelican, a python library. It pulls content from other databrary repos, including policies, datavyu, and datavyu-docs.
see requirements.txt
make start SITE=(databrary|datavyu)
make stop SITE=(databrary|datavyu)
These commands start and stop the development server for the site requested on a default port, such that they can be run it parallel.
databrary : port 8001 datavyu : port 8002
It also automatically regenerates theme and content files on update. (But does not watch config files nor local static assets.)
SITE is a required parameter.
make html [SITE=(databrary|datavyu)]
This command produces HTML output with relative links and no feeds. Only useful for development.
If SITE is unspecified, it generates output for all sites.
make publish [SITE=(databrary|datavyu)]
This command produces HTML output with absolute links, feeds, and sitemap. It will override production site!
If SITE is unspecified, it generates output for all sites.