forum.opennet.ru - "Книга по написанию man-страниц в открытом доступе" (21)

форумы

помощь

поиск

регистрация

майллист

вход/выход

слежка

"Книга по написанию 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 Новость: http://www.opennet.me/opennews/art.shtml?num=31612
Ответить \| Правка \| Cообщить модератору

Оглавление

Книга по написанию man-страниц в открытом доступе, пыщь, 23:34 , 28-Авг-11, (1) –2

Книга по написанию man-страниц в открытом доступе, пыщь пыщь, 00:13 , 29-Авг-11, (2) +1

Книга по написанию man-страниц в открытом доступе, Andrey Mitrofanov, 12:06 , 29-Авг-11, (12)

Книга по написанию man-страниц в открытом доступе, PereresusNeVlezaetBuggy, 12:13 , 29-Авг-11, (13)

Книга по написанию man-страниц в открытом доступе, анонимус, 13:04 , 29-Авг-11, (14)

Книга по написанию man-страниц в открытом доступе, Аноним, 05:31 , 29-Авг-11, (5) –1

Книга по написанию man-страниц в открытом доступе, Дмитрий Ю. Карпов, 02:00 , 29-Авг-11, (3)

Книга по написанию man-страниц в открытом доступе, AHAHAC, 04:39 , 29-Авг-11, (4)
Книга по написанию man-страниц в открытом доступе, Аноним, 08:18 , 29-Авг-11, (6) +5

Книга по написанию man-страниц в открытом доступе, Andrew Kolchoogin, 10:35 , 29-Авг-11, (8) +1

Книга по написанию man-страниц в открытом доступе, Andrew Kolchoogin, 10:35 , 29-Авг-11, (7)
Книга по написанию man-страниц в открытом доступе, Аноним, 11:01 , 29-Авг-11, (9)
Книга по написанию man-страниц в открытом доступе, PereresusNeVlezaetBuggy, 11:17 , 29-Авг-11, (10)
Книга по написанию man-страниц в открытом доступе, TheLibertyMan, 11:35 , 29-Авг-11, (11)
Книга по написанию man-страниц в открытом доступе, анонимус, 14:24 , 29-Авг-11, (16)

Книга по написанию man-страниц в открытом доступе, Аноним, 14:05 , 29-Авг-11, (15)
Книга по написанию man-страниц в открытом доступе, анонимус, 14:41 , 29-Авг-11, (17)
Книга по написанию man-страниц в открытом доступе, nuclight, 19:26 , 29-Авг-11, (18)

Книга по написанию man-страниц в открытом доступе, PereresusNeVlezaetBuggy, 19:55 , 29-Авг-11, (19)

Книга по написанию man-страниц в открытом доступе, nuclight, 20:00 , 29-Авг-11, (20)

Книга по написанию man-страниц в открытом доступе, PereresusNeVlezaetBuggy, 20:06 , 29-Авг-11, (21)

Сообщения по теме [Сортировка по времени | 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 (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 (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 | Индекс форумов | Темы | Пред. тема | След. тема

Партнёры:

Хостинг:

Закладки на сайте
Проследить за страницей

Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру

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 (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 (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ообщить модератору