The OpenNET Project / Index page

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

форумы  помощь  поиск  регистрация  майллист  вход/выход  слежка  RSS
"Книга по написанию man-страниц в открытом доступе"
Вариант для распечатки  
Пред. тема | След. тема 
Форум Разговоры, обсуждение новостей
Изначальное сообщение [ Отслеживать ]

"Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от opennews on 28-Авг-11, 23:34 
Кристапс Джонсонс (Kristaps Dzonsons), один из разработчиков mandoc (http://mdocml.bsd.lv/), выложил в открытый доступ свою книгу "Practical UNIX Manuals (http://manpages.bsd.lv/)", посвященную созданию man-страниц. По словам (http://undeadly.org/cgi?action=article&sid=20110827115056) автора, он видел немало справочной информации по формату mdoc, но ни одного полноценного (корректного и освещающего все основные нюансы) руководства для начинающих. Теперь такое руководство есть и доступно для всех желающих.


Проект (http://manpages.bsd.lv/cgi-bin/cvsweb/?cvsroot=manpages) открыт для принятия дополнений и исправлений. Сама книга представляет собой простой набор XHTML-страниц, поэтому написание патчей не должно составить труда для любого IT-специалиста.


URL: http://undeadly.org/cgi?action=article&sid=20110827115056
Новость: https://www.opennet.ru/opennews/art.shtml?num=31612

Ответить | Правка | Cообщить модератору

Оглавление

Сообщения по теме [Сортировка по времени | RSS]


1. "Книга по написанию man-страниц в открытом доступе"  –2 +/
Сообщение от пыщь on 28-Авг-11, 23:34 
чтоб написать мануал - прочитайте мануал.
когда выйдете из рекурсии, скажите;)
Ответить | Правка | ^ к родителю #0 | Наверх | Cообщить модератору

2. "Книга по написанию man-страниц в открытом доступе"  +1 +/
Сообщение от пыщь пыщь on 29-Авг-11, 00:13 
Ну так пишутся и читаются разные мануалы.
Ответить | Правка | ^ к родителю #1 | Наверх | Cообщить модератору

12. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от Andrey Mitrofanov on 29-Авг-11, 12:06 
> Ну так пишутся и читаются разные мануалы.

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

Ответить | Правка | ^ к родителю #2 | Наверх | Cообщить модератору

13. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от PereresusNeVlezaetBuggy (ok) on 29-Авг-11, 12:13 
>> Ну так пишутся и читаются разные мануалы.
> И кстати, да, дайшь _книгу "Чтение man-ов для иди^Wманекенов".:D

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

Ответить | Правка | ^ к родителю #12 | Наверх | Cообщить модератору

14. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от анонимус (??) on 29-Авг-11, 13:04 
>Да что там манекены, если уж для предметов быта пишут: то ли для кофейников, то ли для кастрюль, не помню... ;)

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

Ответить | Правка | ^ к родителю #13 | Наверх | Cообщить модератору

5. "Книга по написанию man-страниц в открытом доступе"  –1 +/
Сообщение от Аноним (??) on 29-Авг-11, 05:31 
Вы никогда не слышали про pkunzip.zip? :)
Ответить | Правка | ^ к родителю #1 | Наверх | Cообщить модератору

3. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от Дмитрий Ю. Карпов on 29-Авг-11, 02:00 
Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.
Ответить | Правка | ^ к родителю #0 | Наверх | Cообщить модератору

4. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от AHAHAC (ok) on 29-Авг-11, 04:39 
> Давно пора перевести мануалы на 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

Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

6. "Книга по написанию man-страниц в открытом доступе"  +5 +/
Сообщение от Аноним (??) on 29-Авг-11, 08:18 
И обязательно что-нибкдь на js сделать надо в манах!
Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

8. "Книга по написанию man-страниц в открытом доступе"  +1 +/
Сообщение от Andrew Kolchoogin on 29-Авг-11, 10:35 
> И обязательно что-нибкдь на js сделать надо в манах!

На VRML. :)

Ответить | Правка | ^ к родителю #6 | Наверх | Cообщить модератору

7. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от Andrew Kolchoogin on 29-Авг-11, 10:35 
HTML, HTML... Уж тогда в SGML сразу...
Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

9. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от Аноним (??) on 29-Авг-11, 11:01 
> Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.

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

Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

10. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от PereresusNeVlezaetBuggy (ok) on 29-Авг-11, 11:17 
> Давно пора перевести мануалы на HTML, а раздел "SEE ALSO" сделать ссылками.

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

Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

11. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от TheLibertyMan (ok) on 29-Авг-11, 11:35 
>а раздел "SEE ALSO" сделать ссылками

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

Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

16. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от анонимус (??) on 29-Авг-11, 14:24 
> Давно пора перевести мануалы на 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'

Ответить | Правка | ^ к родителю #3 | Наверх | Cообщить модератору

15. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от Аноним (??) on 29-Авг-11, 14:05 
маны без полноценной поддержки opengl и javascript никто читать не будет
Ответить | Правка | ^ к родителю #0 | Наверх | Cообщить модератору

17. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от анонимус (??) on 29-Авг-11, 14:41 
Может кто подскажет по комманде info, почему-то русский поиск не работает? =\ дебиан utf8
Ответить | Правка | ^ к родителю #0 | Наверх | Cообщить модератору

18. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от nuclight email(ok) on 29-Авг-11, 19:26 
По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще называть "язык mdoc", когда он на самом деле nroff, несколько, гм, некорректно.
Ответить | Правка | ^ к родителю #0 | Наверх | Cообщить модератору

19. "Книга по написанию man-страниц в открытом доступе"  +/
Сообщение от PereresusNeVlezaetBuggy (ok) on 29-Авг-11, 19:55 
> По линку на не-белом фоне стилизация под маны совершенно нечитаема. А еще
> называть "язык mdoc", когда он на самом деле nroff, несколько, гм,
> некорректно.

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

Ответить | Правка | ^ к родителю #18 | Наверх | Cообщить модератору

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

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

Ответить | Правка | ^ к родителю #19 | Наверх | Cообщить модератору

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

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

Ответить | Правка | ^ к родителю #20 | Наверх | Cообщить модератору

Архив | Удалить

Рекомендовать для помещения в FAQ | Индекс форумов | Темы | Пред. тема | След. тема




Спонсоры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

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