[PATCH 1 of 2] style: styles for man page, which suit with the mercurial website

Yuya Nishihara yuya at tcha.org
Sun Nov 8 09:24:55 CST 2009


Martin Geisler wrote:
> Okay, I didn't notice :-) Can you make the patch against doc/style.css
> in the mercurial repository? That makes it easier to apply.
...
> We can include the docutils style as a base style? I don't think it's a
> big problem if the style does not support all docutils constructs as
> long as it supports those we use :-)

A patch against mercurial-crew:
># HG changeset patch
># User Yuya Nishihara <yuya at tcha.org>
># Date 1257692447 -32400
># Node ID 49753857f6e0add31e11f4536d33da90e70abf6e
># Parent  dd1a95ccbe0770bc70a0ae55c3c05324689fb02f
>doc: styles for man page, which suit with the mercurial website

This preserves original styles as possible.

>With the fonts available on my machine the text in <tt> is slightly
>larger than the surrounding body text -- the x-height is not uniform.
>Can you pick other fonts that match better?

Fixed. As we cannot know what font is available, it seems better
to specify fonts by generic name, except for headings.

>> 2nd patch is the test case for insertion of site navigation bar.
>
>This is a very nice idea and it looks excellent.
>
>We should make it self-contained and make it work directly with
>rst2html. You can include raw files in reStructuredText, so it's easy to
>include a header on each page:

Do you mean putting local copy of styles.css, mercurial-logo.png, etc.?
or just adding links to them?

We can do it by rst2html --template XXX.txt



More information about the Mercurial-devel mailing list