Re: Use Tinkerer for open source project

[Vlad Riscutia]

Hi Benjamin and thanks for trying out Tinkerer!

pages/* is not a restriction, it's just what Tinkerer supports for pages. You can manually alter the master.rst file and add documents in any subdirectory. You won't be able to use the tinker --post or tinker --page command line, you will have to manually open master.rst and hook your pages there, but once that is done, they should be picked up by the Sphinx build.

For the index.html, you can probably tweak the aggregated.html template to display something else. Create an aggregated.html under your __templates directory and tweak it to your liking.

Thank you,

Vlad

On Sat, May 11, 2013 at 11:56 AM, Benjamin Eberlei <kon...@beberlei.de> wrote:

Hello everyone,

we use Sphinx to render our Open Source Project docs (we have 10+ subprojects) on readthedocs and then have a sphinx project for our website itself.

This website consists of a blog and 2 sphinx plugins that uses a configuration file + Github API to render all our projects releases and a frontpage.

See: http://www.doctrine-project.org/

Because we want to start blogging more, I evaluated if tinkerer could help us render our website instead of sphinx only. However there are some problems:

* pages/* is too restrictive, can i put .rst files everywhere in the source tree?

* index.html should be our project page, not the tinkerer index. Can I change that somehow?

I would be very grateful for any hints regarding this two topics.

Benjamin

--
You received this message because you are subscribed to the Google Groups "tinkerer-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to tinkerer-dev...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.