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

Martin Geisler mg at lazybytes.net
Sun Nov 8 14:29:46 CST 2009

Yuya Nishihara <yuya at tcha.org> writes:

> Martin Geisler wrote:
>># 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.

Nice job!

>> 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.

I agree, thanks for the quick update!

>>> 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?

I meant to include a copy of them so that the documentation can be
browsed without requiring an internet connection.

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

Right, but I don't think we should invest too much energy in that since
I hope we can move to a better template system in the future.

I would like to move away from the man page-look. Today we assemble the
reST input files for the man pages and use them for both HTML output
too. I think we should assemble a reST file for just the man page, and
then assemble another for the HTML documentation.

Martin Geisler

VIFF (Virtual Ideal Functionality Framework) brings easy and efficient
SMPC (Secure Multiparty Computation) to Python. See: http://viff.dk/.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: not available
Url : http://selenic.com/pipermail/mercurial-devel/attachments/20091108/9d280cfd/attachment.pgp 

More information about the Mercurial-devel mailing list