From: Tony N. <to...@gi...> - 2017-08-18 21:22:40
|
Greetings docutils users, I have recently created a website backed by docutils. It’s called https://devel.tech. - https://devel.tech/tips/n/sNZwQvNh/django-compressor-vs-django-webpack-loader/ (docutils, with Günter’s html5_polyglot Writer) - https://devel.tech/site/updates (docutils) - https://devel.tech/features/django-vs-flask/ (sphinx w/ WebSupport, but I had to fork it https://github.com/develtech/sphinxcontrib-websupport/tree/lean) Docutils provides extensibility, customizability, and great access via python. The site makes full use of the new html5_polyglot Writer as well as various other database-backed roles and writer transformations. My hope is to port sphinx features to work with pure docutils and open source them as extensions. This way more people can leverage the power of pure docutils without pulling in an additional framework. About reStructuredText and why it was picked over markdown: the language is consistent, similar enough to markdown, and allows for flexibility via roles and directives. It was the most powerful, yet nimblest of the two; a great fit for software developers. Best, Tony |