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

[Martin Geisler]

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