[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#264589: Link from packages.debian.org to manpages.debian.net - updated information (bug 264589)

On 27 December 2012 08:47, Paul Wise <pabs@debian.org> wrote:
> In addition, I noticed that the Ubuntu manual pages have HTML markup,
> would it be possible to adopt whatever code they are using for that?

Some months ago I started tinkering with their scripts (actually
Dustin Kirkland's). They basicly extract all the manpages from
packages and convert them to (static) HTML pages. On top of this there
is a Python script to search the archive.

The code [1] is a little bit Ubuntu-specific but could be changed for
Debian. I have added some of it (and modified it slightly) here:
http://anonscm.debian.org/viewvc/ddp/man-cgi/static-repository/ and
started playing with it in glinka.  It is available through here:
http://manpages.debian.org/static/ (not fully working, very draft

However, it's far from finished. I have not been able to allocate
enough time to have a final implementation though

The downside of this approach is that the service would consume double
the disk space it currently does. As it would have two repositories:

- one with the original manpages (aprox. 6 GB currently)
- one with the manpages converted into static HTML files

The HTML files would be there regardless of whether they actually get
used or not.

On the upside: it would be faster, since the CGI script would not need
to generate the manpages on the fly for every user.

Best regards


[1] https://blueprints.launchpad.net/ubuntu-docs/+spec/ubuntu-manpage-repository

Reply to: