Differences between revisions 22 and 24 (spanning 2 versions)
Revision 22 as of 2016-11-14 13:53:12
Size: 1183
Editor: TheAnarcat
Comment:
Revision 24 as of 2016-11-14 14:01:21
Size: 1833
Editor: TheAnarcat
Comment:
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
<<Include(Services/Debian manpages archive)>> <<Include(Services/Debian manpages archive,,editlink)>>

== Current implementation ==

The current `manpages.debian.org` service has been disabled by [[Teams/DSA]] because of performance issues. The source code is available in http://anonscm.debian.org/viewvc/ddp/man-cgi/ and was supposed to be migrated to a different host.

== New implementation ==
Line 10: Line 16:

At this point, the code can extract all files from a mirror efficiently and convert them to HTML. It has not been tested on a full mirror yet, because TheAnarcat is waiting for `manpages` group access and dependencies install (`setuptools` from backports and/or `python-click`, `python-apt` and `python-debian`). See the [[https://anonscm.debian.org/git/collab-maint/debmans.git/tree/TODO.md|TODO]] file for more information about the current status of the project and limitations.
Line 14: Line 22:

Note that to configure a vhost on DSA machines, you need to follow the [[https://dsa.debian.org/doc/subdomains/|DSA subdomains documentation]].

https://manpages.debian.org/ is a service providing online manpages in HTML format for the public.

Current status

Debian manpages archive

Current implementation

The current manpages.debian.org service has been disabled by Teams/DSA because of performance issues. The source code is available in http://anonscm.debian.org/viewvc/ddp/man-cgi/ and was supposed to be migrated to a different host.

New implementation

The current codebase is being rewritten from scratch into a package called Debmans, see the README for more information and the DESIGN file for a discussion on the implementation.

At this point, the code can extract all files from a mirror efficiently and convert them to HTML. It has not been tested on a full mirror yet, because TheAnarcat is waiting for manpages group access and dependencies install (setuptools from backports and/or python-click, python-apt and python-debian). See the TODO file for more information about the current status of the project and limitations.

Hardware

The old service used to run on glinka.debian.org. Teams/DSA requested the service should be moved to manziarly.debian.org.

Forum

Discussions about manpages.debian.org can take place on the regular Teams/DDP channels, for example the #debian-doc IRC channel and debian-doc@lists.debian.org mailing list.

You can also subscribe to this wiki page to get updates, which also functions as a ad-hoc forum.