[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#778269: ITP: python-mkdocs -- Static site generator geared towards building project documentation



Hi Brian,

On Fri, 13 Feb 2015 10:06:25 +1100, Brian May wrote:
> MkDocs is a fast, simple and downright gorgeous static site generator
> that's geared towards building project documentation. Documentation
> source files are written in Markdown, and configured with a single YAML
> configuration file.
>
> This package is required to build the documentation in the latest
> upstream version of python-djangorestframework.
>
> I plan to maintain this as part of the python modules team.

Thank you, I also need this package because Python-Markdown is going to
use it for building its docs as well at some point in the future (will
need to think how to avoid the circular dependency though).

> The intention appears to be that mkdocs is used as a standalone
> application, although it supplies a mkdocs python package which could
> in theory be called directly.
>
> Given the above paragraph, is it still appropriate to build both a
> python-mkdocs and a python3-mkdocs package? Unless I hear otherwise,
> this will be my plan.

Looks like upstream really does not provide any stable Python API,
so I think there is no need to build public module packages.

But you will make me a bit happier if you make the executable use
Python 3.

--
Dmitry Shachnev

Attachment: signature.asc
Description: OpenPGP digital signature


Reply to: