Google Git
Sign in
apache / allura-site / 4e3da1261c84b90a2383fa31728c67f631a7eea3
commit4e3da1261c84b90a2383fa31728c67f631a7eea3[log] [tgz]
authorDave Brondsema <dave@brondsema.net>Wed Jun 12 14:55:10 2024 -0400
committerDave Brondsema <dave@brondsema.net>Wed Jun 12 14:55:10 2024 -0400
treeca3b9b7132dc25b92e87e9ebe7b09804dd7425dc
parent77ceca6f39e58a4546738224ab30ffc89ef270af [diff]
fix jenkins link; remove IRC link
2 files changed
tree: ca3b9b7132dc25b92e87e9ebe7b09804dd7425dc
  1. _src/
  2. feeds/
  3. images/
  4. posts/
  5. tag/
  6. theme/
  7. .asf.yaml
  8. .gitignore
  9. .htaccess
  10. 404.html
  11. cors.html
  12. download.html
  13. favicon.ico
  14. index.html
  15. news.html
  16. README.md
  17. robots.txt
README.md

We're using Pelican to generate static site. All source files are placed in the _src/ directory. Generated content is placed under root directory.

Bootstrapping pelican

~$ python -m venv ../allura-site-venv
~$ source ../allura-site-venv/bin/activate
~$ pip install pelican markdown

Working on site

~$ cd _src
~$ RELATIVE=1 make regenerate  # only use RELATIVE for local dev

Then open the html files directly, or run a little server with:

~$ make serve       # serve generated site at http://localhost:8000

When changes are looking good - commit them (including generated files).

~$ make html  # for a single publish