Stylesheet for Docutils output

[Felix Wiemann <Felix.Wiemann@…>]

Some output elements (e.g. line blocks or admonitions) of reStructuredText look really crappy without a stylesheet.

May I suggest you store tools/stylesheets/default.css from the Docutils tarball at /trac_common/css/docutils.css and add @import url(/trac_common/css/docutils.css) in front of the other import statements?

The Docutils stylesheet shouldn't interfere with any elements outside the Docutils-generated HTML code.

[anonymous]

where exactly do you have to put this

@import url(/trac_common/css/docutils.css)

to make /trac_common/css/docutils.css work?

[anonymous]

I can answer this question myself now:

The file templates/site_css.cs has to bee modified, as it has been described here:

​Gentoo HOWTO Trac

[Christopher Lenz]

It would still be nice if we fixed this in Trac.

[Christian Boos]

Milestone 2.0 deleted

[Christian Boos]

Need something better anyway for the API documentation (#8695).

[Thijs Triemstra <lists@…>]

Not sure if it's a defect when something "looks crappy".

[Thijs Triemstra <lists@…>]

File taken from docutils-0.7/docutils/writers/html4css1/html4css1.css

[Thijs Triemstra <lists@…>]

When you run rst2html.py test.rst test.html it includes the attached css​ inline, which is published in the public domain.

[Christian Boos]

Thanks for reviving the topic! We already have this version ​http://svn.edgewall.org/repos/edgewall/tools/doc/style/edgewall.css to integrate in Trac. It's 3 years older, but I think it was already customized a bit to better fit with the Trac style.

[bradley.ayers@…]

I for one would really like to see this happen.

[Thijs Triemstra]

Replying to cboos:

Thanks for reviving the topic! We already have this version ​http://svn.edgewall.org/repos/edgewall/tools/doc/style/edgewall.css to integrate in Trac. It's 3 years older, but I think it was already customized a bit to better fit with the Trac style.

So what do you suggest happens next?

[Christian Boos]

As I'm working on the ApiDoc, I gradually override the Sphinx's "sphinxdoc.css" style by adding rules in source:trunk/doc/utils/tracsphinx.css​. It should be possible to collect all the resulting rules, remove the "sphinx*" specific ones to keep only the ones relevant for docutils, and consolidate them (i.e. remove rules from basic.css or sphinxdoc.css which are overridden later, be careful not to readd rules already there like ol.loweralpha). At that point, we'll have tracdocutils.css.

[Remy Blank]

Preparing for 1.0.

[Christian Boos]

Moving enhancements to dev.

[Remy Blank]

I assume you meant to set the milestone.

[Ryan J Ollos]

Retargetting tickets to narrow focus for milestone:1.2. Please move the ticket back to milestone:next-dev-1.1.x if you intend to resolve it by milestone:1.2.