Re: manpages.debian.org has been modernized!

[Michael Stapelberg <stapelberg@debian.org>]

On Thu, Jan 19, 2017 at 5:33 AM, Boyuan Yang <073plan@gmail.com> wrote:
> [ Dropping debian-devel -- this is a bug-report email ]
>
>
>
> 在 2017年1月18日星期三 SGT 下午6:23:16，Michael Stapelberg 写道：
>
>> 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.
>
>>
>
>> 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/).
>
>
>
> Thanks for your work! The new website is indeed a great leap forward.
>
>
>
> That said, there are still several minor problems with the rendering of man
> pages:
>
>
>
> 1. When the man page is a stub and cannot fit the full width of 80 chars,
> the page would be somehow ugly. See the example at
> https://manpages.debian.org/jessie/manpages-zh/intro.1.zh_CN.html when all
> lines are short and the navigation div just occupied the middle of the page.

Thanks for the example. Tracking this in
https://github.com/Debian/debiman/issues/22

>
>
>
> 2. Several strange adjustment characters appeared in man pages generated by
> po4a. Take a look at the SYNOPSIS section of
> https://manpages.debian.org/testing/manpages-zh/test.1.zh_CN.html and
> /usr/share/man/zh_CN/man1/test.1.gz (provided by manpages-zh).

This is a mandoc rendering issue:

$ curl -s https://manpages.debian.org/testing/manpages-zh/test.1.zh_CN.gz
| mandoc /dev/stdin | head
TEST(1)                            用户命令                            TEST(1)



 名 称
       test - 检查文件类型并比较值

 概 述
       test ,表达式/
       test

$ curl -s https://manpages.debian.org/testing/manpages-zh/test.1.zh_CN.gz
| man /dev/stdin | head
TEST(1)
用户命令
TEST(1)

名
       test - 检查文件类型并比较值

概
       test 表达式
       test

       [ 表达式 ]

Mandoc upstream is http://mdocml.bsd.lv/. Would you like to report the
issue there yourself, or would you prefer if I did?


-- 
Best regards,
Michael