The OpenNET Project / Index page

[ новости /+++ | форум | wiki | теги | ]

Книга по написанию man-страниц в открытом доступе

28.08.2011 18:01

Кристапс Джонсонс (Kristaps Dzonsons), один из разработчиков mandoc, выложил в открытый доступ свою книгу "Practical UNIX Manuals", посвященную созданию man-страниц. По словам автора, он видел немало справочной информации по формату mdoc, но ни одного полноценного (корректного и освещающего все основные нюансы) руководства для начинающих. Теперь такое руководство есть и доступно для всех желающих.

Проект открыт для принятия дополнений и исправлений. Сама книга представляет собой простой набор XHTML-страниц, поэтому написание патчей не должно составить труда для любого IT-специалиста.



  1. Главная ссылка к новости (http://undeadly.org/cgi?action...)
  2. Репозиторий с исходным текстом книги
Автор новости: Вадим Жуков
Тип: К сведению
Ключевые слова: man, unix
При перепечатке указание ссылки на opennet.ru обязательно
Обсуждение (21) Ajax | 1 уровень | Линейный | +/- | Раскрыть всё | RSS
  • 1.1, пыщь (?), 23:34, 28/08/2011 [ответить] [﹢﹢﹢] [ · · · ]  
  • –2 +/
    чтоб написать мануал - прочитайте мануал.
    когда выйдете из рекурсии, скажите;)
     
     
  • 2.2, пыщь пыщь (?), 00:13, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +1 +/
    Ну так пишутся и читаются разные мануалы.
     
     
  • 3.12, Andrey Mitrofanov (?), 12:06, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > Ну так пишутся и читаются разные мануалы.

    И кстати, да, дайшь _книгу "Чтение man-ов для иди^Wманекенов".:D

     
     
  • 4.13, PereresusNeVlezaetBuggy (ok), 12:13, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    >> Ну так пишутся и читаются разные мануалы.
    > И кстати, да, дайшь _книгу "Чтение man-ов для иди^Wманекенов".:D

    Да что там манекены, если уж для предметов быта пишут: то ли для кофейников, то ли для кастрюль, не помню... ;)

     
     
  • 5.14, анонимус (??), 13:04, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    >Да что там манекены, если уж для предметов быта пишут: то ли для кофейников, то ли для кастрюль, не помню... ;)

    И очень правильно делают.

     
  • 2.5, Аноним (-), 05:31, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • –1 +/
    Вы никогда не слышали про pkunzip.zip? :)
     

  • 1.3, Дмитрий Ю. Карпов (?), 02:00, 29/08/2011 [ответить] [﹢﹢﹢] [ · · · ]  
  • +/
    Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.
     
     
  • 2.4, AHAHAC (ok), 04:39, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > Давно пора перевести мануалы на HTML

    1. Для тех, у кого браузер смысл жизни - http://linuxmanpages.com/

    2. Для фетиша на локальной машине:

    # cd /usr/share/man;
    # for i in 'find . -name *.gz'; do zcat $i | man2html > $i.html; rm $i; done;

    # firefox /usr/share/man/man7/socket.gz.html

    >а раздел "SEE ALSO" сделать ссылками.

    Для тех у кого не забанили Гугла
    http://www.google.com/search?q=SEE+ALSO

    ---
    Сиди в своём браузере, отъ...бись от UNIX Way

     
  • 2.6, Аноним (-), 08:18, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +5 +/
    И обязательно что-нибкдь на js сделать надо в манах!
     
     
  • 3.8, Andrew Kolchoogin (?), 10:35, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +1 +/
    > И обязательно что-нибкдь на js сделать надо в манах!

    На VRML. :)

     
  • 2.7, Andrew Kolchoogin (?), 10:35, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    HTML, HTML... Уж тогда в SGML сразу...
     
  • 2.9, Аноним (-), 11:01, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.

    Будет неудобно при восстановлении системы, например. И на серверах.

     
  • 2.10, PereresusNeVlezaetBuggy (ok), 11:17, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.

    «mandoc -Thtml» работает ничуть не хуже, чем «mandoc -Tascii». Почему не сразу в HTML? Да потому что HTML не сохраняет семантику. Тогда уж в монстроидальный docbook скорее переводить надо. Вот только кому?..

     
  • 2.11, TheLibertyMan (ok), 11:35, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    >а раздел "SEE ALSO" сделать ссылками

    s/man/info/ и будет тебе счастье!

     
  • 2.16, анонимус (??), 14:24, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.

    Use pinfo, Luke!

    >Pinfo also supports viewing of manual pages -- they're colorised like in the midnight commander's viewer, and additionaly they are hypertextualized (i.e. when pinfo encounters a reference of form manualname (n), then you can press enter there, and voila -- you're on the page for 'manualname'.

    http://pinfo.sourceforge.net/


    alias man='pinfo -m'

     

  • 1.15, Аноним (-), 14:05, 29/08/2011 [ответить] [﹢﹢﹢] [ · · · ]  
  • +/
    маны без полноценной поддержки opengl и javascript никто читать не будет
     
  • 1.17, анонимус (??), 14:41, 29/08/2011 [ответить] [﹢﹢﹢] [ · · · ]  
  • +/
    Может кто подскажет по комманде info, почему-то русский поиск не работает? =\ дебиан utf8
     
  • 1.18, nuclight (ok), 19:26, 29/08/2011 [ответить] [﹢﹢﹢] [ · · · ]  
  • +/
    По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще называть "язык mdoc", когда он на самом деле nroff, несколько, гм, некорректно.
     
     
  • 2.19, PereresusNeVlezaetBuggy (ok), 19:55, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    > По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
    > называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
    > некорректно.

    У него официального названия вообще нет. :) nroff — лишь одна из (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и в *BSD, и в Linux... :)

     
     
  • 3.20, nuclight (ok), 20:00, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    >> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
    >> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
    >> некорректно.
    > У него официального названия вообще нет. :) nroff — лишь одна из
    > (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да
    > и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и
    > в *BSD, и в Linux... :)

    Ну это ж не язык, а пакет макросов просто. А то так и до языка ms(7) докатиться можно :)

     
     
  • 4.21, PereresusNeVlezaetBuggy (ok), 20:06, 29/08/2011 [^] [^^] [^^^] [ответить]  
  • +/
    >>> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
    >>> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
    >>> некорректно.
    >> У него официального названия вообще нет. :) nroff — лишь одна из
    >> (самая известная на данный момент) утилит, кушающих ROFF с -mdoc. Да
    >> и man-страницы, в которых обсуждается этот макроязык, везде называются mdoc(7), и
    >> в *BSD, и в Linux... :)
    > Ну это ж не язык, а пакет макросов просто. А то так
    > и до языка ms(7) докатиться можно :)

    Сторгуемся на «макроязыке»? ;)

     
     Добавить комментарий
    Имя:
    E-Mail:
    Текст:



    Спонсоры:
    Слёрм
    Inferno Solutions
    Hosting by Ihor
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2019 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру