On Tue, 2011-01-18 at 11:33 +0100, Javier Fernandez-Sanguino wrote: > I just wanted to update the bug report (and the -www team) on the > status of the manpages.debian.net interface. Thanks for this status, sorry the reply took so long. I implemented linking to individual manual pages on my local machine today, from both the filelist and package pages. > - searches through package names could be implemented by building a package index Based on my preliminary implementation, I think we do need a way to do a search by package names. For packages that have a lot of manual pages, lots of links to individual manual pages bloats the page, so I think we want one link to all the manual pages for each binary package. Later on someone might implement info.debian.net or docs.debian.net (doc-base) and so we might want "Manual page(s)", "Info documents", "More documentation" (doc-base) in a "Documentation" section. > - the content (as I said following a pool structure) could be exposed > for direct access and download of the original manpages, I don't think this would be required. > Could someone clarify what are the interface requirements from the > packages.debian.org perspective? We need per-package links. The packages site also requires a way to link to the manual page of a specific language and fall back on the English version. So something like this: http://manpages.debian.net/pkg/<suite>/<package>/<lang>/ http://manpages.debian.net/pkg/<suite>/<package>/ If there is only one manual page in the package, that should present it. If there are several manual pages in the package, it should list them. 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? http://manpages.debian.net/man/1/dpkg http://manpages.ubuntu.com/manpages/precise/en/man1/dpkg.1.html -- bye, pabs http://wiki.debian.org/PaulWise
Attachment:
signature.asc
Description: This is a digitally signed message part