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

Re: manpages.debian.org has been modernized!

On Thu, Jan 19, 2017 at 4:41 AM, Paul Wise <pabs@debian.org> wrote:
> On Thu, Jan 19, 2017 at 1:23 AM, Michael Stapelberg wrote:
>> https://manpages.debian.org has been modernized! We have just launched
>> a major update to our manpage repository. What used to be served via a
>> CGI script is now a statically generated website, and therefore
>> blazingly fast.
> My dman shell function is now broken:
> dman () {
>         w3m "https://manpages.debian.org/man0/$1";
> }
> The manpages.d.o URLs on these pages are broken:
> https://wiki.debian.org/AppArmor/Debug
> https://manpages.debian.org/man/0/aa-notify
> https://wiki.debian.org/lsusb
> https://manpages.debian.org/man/0/lsusb
> The previous site had 0 as a wildcard for any section.
>> While we were at it, we have restructured the paths so that we can
>> serve all manpages, even those whose name conflicts with other binary
>> packages (e.g. crontab(5) from cron, bcron or systemd-cron). Don’t
>> worry: the old URLs are redirected correctly.
> Does this take into account that some manual pages are available only
> on certain architectures? Or that some manual pages might differ
> between architectures?
> In #264589 I wrote a patch for packages.debian.org to link to manual
> pages from a few locations. Could you advise on any changes I should
> make to the links in the patch?
>> Furthermore, the design of the site has been updated and now includes
>> navigation panels that allow quick access to the manpage in other
>> Debian versions, other binary packages, other sections and other
>> languages. Speaking of languages, the site serves manpages in all
>> their available languages and respects your browser’s language when
>> redirecting or following a cross-reference.
> I notice you force the URL to contain the package, version, language
> and format, I would prefer normal URLs to not include either of those
> and the defaults to be chosen via Accept-* if they are not part of the
> URL. The links could then override them as needed.
> Would it be possible to titlecase the section names in the table of
> contents and in the HTML?
> Personally I much prefer non-monospaced text when reading
> documentation. IIRC the debmans code did this better.
> The manual page converter seems to use line breaks rather than proper
> paragraph tags.
> The Debian logo appears to be missing when I view the site in Tor
> Browser on high security mode, due to the use of SVG with no fallback.

I looked around for how to implement SVGs with fallback, and all
solutions either hard-code fallbacks for older browsers (not helpful
for this case) or require JavaScript (presumably not helpful/desired
in this case). See for example
http://callmenick.com/post/svg-fallback-with-png. Could you clarify
how I can implement a fallback in a way that works for Tor Browser

> Non-truncated version numbers don't need the popup like truncated ones do.
> IIRC, according to the design principles  of the current Debian
> website design, the 'Index' link should not be present because the
> link above it points at the same place.
> https://wiki.debian.org/KallesDesign
> Can you change the top 'MANPAGES' link to 'Manual pages' instead? Any
> other occurrences should change too (such as on the suite contents
> pages).
> The suite contents pages contain a lot of whitespace on desktop
> browsers. Just putting every manual page on one long line to be
> wrapped by the browser might be better.
> If I press up in my browser, these URLs don't work or do the wrong thing:
> https://manpages.debian.org/jessie/manpages/
> https://manpages.debian.org/jessie/
> https://manpages.debian.org/unstable/
>> Much like the Debian package tracker, manpages.debian.org includes
>> packages from Debian oldstable, oldstable-backports, stable,
>> stable-backports, testing and unstable. New manpages should make their
>> way onto manpages.debian.org within a few hours.
> I'd really suggest using suite names by default instead of codenames
> in the text of the versions section and in all URLs, with the
> codenames also supported in URLs though.
>> We’d love to hear your feedback and thoughts. Either contact us via an
>> issue on https://github.com/Debian/debiman/issues/, or send an email
>> to the debian-doc mailing list (see
>> https://lists.debian.org/debian-doc/).
> It would be really nice if man-db had support for both manpages.d.o
> and manpages.u.c.
> Highlighting some more of the features on the front page might be useful.
> Is the rebuilding of new and updated manual pages triggered by Debian
> mirror pushes?
> Are incoming.debian.org/archive.debian.org to be used as sources of
> manual pages too?
> I hope you aren't hard-coding any architecture info or codenames in
> the source code or configs :)
> https://wiki.debian.org/SuitesAndReposExtension
> You may want to mention this on debian-derivatives, to the
> manpages.u.c maintainers and to the maintainers of other distros
> manual page websites, some of them might like to use it, although Go
> might put some of them off.
> The wiki page needs to be rewritten now that debmans is dropped and
> debiman is used on the site.
> https://wiki.debian.org/manpages.debian.org
> --
> bye,
> pabs
> https://wiki.debian.org/PaulWise

Best regards,

Reply to: