[Owasp-leaders] Sharing experience of yet another way to publish documentation projects
taras.ivaschenko at owasp.org
Sun Feb 17 19:47:35 UTC 2019
I see that last time some OWASP documentation projects migrated to
GitHub and text based formats plus various technologies to publish it.
In this letter I want just share yet another way to do it :) May be it
could be helpful for someone (like
For Russian translation of OWASP Proactive Controls we used:
* GitHub for repository
* Sphinx (http://www.sphinx-doc.org) as documentation generator which
gives us various output format and l10n support out of box
* reStructuredText (https://en.wikipedia.org/wiki/ReStructuredText) as
base text format. It is similar to Markdown but much more powerful
* Popular documentation service called "Read The Docs"
(https://readthedocs.org/) as publishing platform and CI/CD service. So
we get free web hosting for result docs, multilanguage support,
auto-generated PDF, EPUB and HTML versions and other cool features. It
also has support for custom domain, so if we want we could have e.g.
* For localization we used special service Transifex
(https://www.transifex.com/). So translators don't need to fork original
English version and get easy to use special l10n service.
HTML version is available at
Feel free to ask questions.
-------------- next part --------------
A non-text attachment was scrubbed...
Size: 833 bytes
Desc: OpenPGP digital signature
More information about the OWASP-Leaders