Man page website

[Christopher Meng]

On 8/1/12, Pete Travis <me at petetravis.com> wrote:
> On Tue, Jul 31, 2012 at 11:51 AM, Christopher Antila <
> crantila at fedoraproject.org> wrote:
>
>> On 30 July 2012 10:16:04 Eric "Sparks" Christensen wrote:
>> > A few weeks ago we received a ticket[0] asking about publishing man
>> > pages for Fedora on the Internet.  We know that there are other man
>> > pages out there however we have found that they may not be up to date
>> > with the versions that are in Fedora.
>> >
>> > The overall opinion, that I've seen, is that this would be something
>> > that might be worthwhile *if* we can script the entire process.
>> >
>> > Does anyone have any ideas for doing this or have any opinions on
>> > doing this?
>> >
>> >
>> > [0] https://bugzilla.redhat.com/show_bug.cgi?id=828669
>> >
>> > -- Eric
>> >
>> >
>> > =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
>> > Fedora Project  -  https://fedoraproject.org
>> >
>> > Member of:
>> >    * Fedora Board
>> >    * Documentation Project
>> >
>> > 097C 82C3 52DF C64A 50C2  E3A3 8076 ABDE 024B B3D1
>> > =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
>>
>> Hi:
>>
>> For the ground-breaking kind of effort this would take, I think it's a
>> waste of
>> time. We'd be better off spending this effort on improving our
>> pre-existing,
>> user-oriented documentation. The fact is, only a very small percentage of
>> the
>> population uses manual pages and there isn't much advantage for them to
>> be
>> accessible in a web browser.
>>
>> We need to think about our distribution's target user base. If you're
>> looking
>> up a manual page, you're using a terminal emulator, and you should be
>> comfortable enough to know how to use the up-arrow, down-arrow, and 'q'
>> buttons on your keyboard. In other words, I think the advantage of
>> web-based
>> manual pages is negligible.
>>
>> But...
>> If we do put them online, we should not say "man" anywhere, if possible.
>>
>> But...
>> If we can localize the manual pages *and* send the translations upstream,
>> then
>> maybe it's worth it.
>>
>>
> If we wanted to go forward looking at the packages app, is there a way for
> us to look its implementation? I see it uses moshka, but the keywords I
> tossed at http://git.fedorahosted.org/cgit/ didn't find anything.
>
> I like the idea of pushing translated manpages upstream. Does `man` itself
> have localization features?
>
> --pete
>

Well,I think that may also be a giant project...And tough,too.
-- 
Yours sincerely,
Christopher Meng

Ambassador/Contributor of Fedora Project and many others.
http://cicku.me