[PATCH 0 of 2] styles for man pages

Sun Nov 8 03:53:10 CST 2009

Yuya Nishihara <yuya at tcha.org> writes:

> stylesheet for mercurial man pages.
>
> this suit with the brand-new mercurial website,
> and should work with it.

This looks super, it's nice to get some colors in there! I really like
how you've put the table of contents to the right. The style can be seen
here:

  http://cs.au.dk/~mg/tmp/hg.1.html

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?

I tried with a minimal style like this:

  .document kbd, .document tt, .document pre {
    font-family: monospace;
    font-weight: bold;
  }

  body {
    font-family: sans-serif;
  }

and I kind of like the result.

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

  .. raw:: html
     :file: header.html

Can we move the <script> elements down from the <head> element to the
<body> element without messing things up? If so, then we'll just include
the header as the first thing in the files and link to a combined style
sheet. That will unfortunately duplicate some things from the website.

-- 
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/b36d8021/attachment.pgp 