Differences between revisions 24 and 26 (spanning 2 versions)
Revision 24 as of 2016-11-14 14:01:21
Size: 1833
Editor: TheAnarcat
Comment:
Revision 26 as of 2016-11-19 00:30:41
Size: 1931
Editor: TheAnarcat
Comment: move main website to rtfd
Deletions are marked like this. Additions are marked like this.
Line 15: Line 15:
The current codebase is being rewritten from scratch into a package called [[https://anonscm.debian.org/git/collab-maint/debmans.git/|Debmans]], see the [[https://anonscm.debian.org/git/collab-maint/debmans.git/tree/README.md|README]] for more information and the [[https://anonscm.debian.org/git/collab-maint/debmans.git/tree/DESIGN.md|DESIGN]] file for a discussion on the implementation. The current codebase is being rewritten from scratch into a package called [[https://debmans.readthedocs.io/en/latest/|Debmans]] See the [[https://debmans.readthedocs.io/en/latest/design.html|design document]] for a discussion on the implementation.
Line 17: Line 17:
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. 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://debmans.readthedocs.io/en/latest/todo.html|TODO]] file for more information about the current status of the project and limitations.

For Debian maintainers not wishing to operate on the [[https://gitlab.com/anarcat/debmans|Gitlab platform]], there is also a [[https://anonscm.debian.org/git/collab-maint/debmans.git|collab-maint repository]] that is synchronised with Gitlab every hour.

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 design document 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.

For Debian maintainers not wishing to operate on the Gitlab platform, there is also a collab-maint repository that is synchronised with Gitlab every hour.

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.