Prodigal is a static website generator written in Python. You can use it to generate static websites based on Jinja2 templates. Prodigal handles website translations natively: this means that you can use Prodigal to generate multiple versions of your website, one for each language.
pip install -e git+https://github.com/regisb/prodigal.git#egg=prodigalProdigal generates content from Jinja2 templates. Content generation should proceed as follows:
- Write your html/jinja2 content in src/
Generate a translation file in the target language:
prodigal translate fr src/- Edit the generated src/fr.po file in order to produce translations for all your localized strings.
Generate the localized version of your content:
prodigal generate -l fr src/ dst/
While you are developing your website, you might want to skip the generation step and see directly what your website looks like. Prodigal comes with an embedded HTTP server which can serve your content from your source folder:
prodigal serve -l fr src/Consider the following content:
example/
_base.html
blog/
post1.html
post2.html_base.html:
<!DOCTYPE html>
<html>
<body>{% block content %}{% endblock %}</body>
</html>blog/post1.html:
{% extends "_base.html" %}
{% block content %}Hey, check it out! I just wrote a great blog post.{% endblock %}blog/post2.html:
<html>
<body>{% trans %}Some entirely different (translated) content.{% endtrans %}</body>
</html>You can first generate the French translation file for this website:
prodigal translate example/ frThis command generated the file example/fr.po. You may now edit it in order to provide the correct French translation for your content:
#: ./example/post2.html:2
msgid "Some entirely different (translated) content."
msgstr "Un peu de contenu (traduit) complètement différent"And finally, you can use this translation file to deploy a translated version of your website:
prodigal generate -l fr ./example /var/www/In further iterations, you can serve your content directly from your source folder thanks to the embedded HTTP server:
prodigal serve -l fr ./exampleThen head to http://127.0.0.1:8000 in your browser to see your rendered templates. Note that translations will be recompiled on-the-fly as you modify your .po file.
Install development dependencies:
pip install -r requirements.txtIf you wish to write a contribution, don't forget to write unit tests! Tests can be run with:
python -m unittest discoverQuestions? Comments? Just open an issue request, tweet me at @regisb, or shoot me an email at prodigal@behmo.com.
Q. There are so many static website generators already, why did you create another one?
A. None of the static website generators I found allowed me to generate two versions of the same website in two different languages. I needed to do that for nulinu.li. I figured: how hard can it be? Existing bricks where already present in Django, I only had to pull them out.
- How can I list recent blog posts by title?
A. This is a frequent use case, so I included it in the example website located at example/. Basically, you need to list your blog posts in the _config.html file, which is rendered before all other templates and allows you to define custom variables to be used later in other templates. Then, you can list your blog posts using the {{ 5|latest_pages }} command in your templates.
- Non-html files are not copied when I generate my website!
A. The rendering engine of Prodigal renders only *.html files. If there is non-html content that you wish to include in your website, such as CSS, Javascript or image assets, you need to list them using the {{ add_media }} command. E.g: see the example/_config.html file.
"Occasionally, members of the Institute of Arcane Study acquire a taste for worldly pleasures. Seldom do they have trouble finding employment."