The OpenNET Project / Index page

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

форумы  помощь  поиск  регистрация  майллист  ВХОД  слежка  RSS
"Создание документации"
Вариант для распечатки  
Пред. тема | След. тема 
Форумы OpenNET: Виртуальная конференция (Public)
Изначальное сообщение [Проследить за развитием треда]

"Создание документации"  
Сообщение от weldpua2008 email(ok) on 18-Май-07, 12:06 
Привет ВСЕМ
Что можете посоветовать, что бы создавать документацию под линух?
Что - то в духе qt help'а тоже подойдет...Можно на php or etc... -тобишь в браузере или (повторюсь) отдельная программа...
Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

 Оглавление

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


1. "Создание документации"  
Сообщение от newser (ok) on 18-Май-07, 13:32 
>Привет ВСЕМ
>Что можете посоветовать, что бы создавать документацию под линух?
>Что - то в духе qt help'а тоже подойдет...Можно на php or
>etc... -тобишь в браузере или (повторюсь) отдельная программа...

Смотрите в сторону docbook - это в некотором роде стандарт на оформление документации.

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

2. "Создание документации"  
Сообщение от weldpua2008 email(ok) on 19-Май-07, 05:32 
>>Привет ВСЕМ
>>Что можете посоветовать, что бы создавать документацию под линух?
>>Что - то в духе qt help'а тоже подойдет...Можно на php or
>>etc... -тобишь в браузере или (повторюсь) отдельная программа...
>
>Смотрите в сторону docbook - это в некотором роде стандарт на оформление
>документации.

А такой вопрос - что бы можно было просто сесть и набрать документацию?
Ну типа прога какая-то что бы её набивать?

Про docbok не вьехал - что Она может делать, видимо из-за того что счас 4-ре утра :)

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

3. "Создание документации"  
Сообщение от A Clockwork Orange on 19-Май-07, 08:18 
>>>Привет ВСЕМ
>>>Что можете посоветовать, что бы создавать документацию под линух?
>>>Что - то в духе qt help'а тоже подойдет...Можно на php or
>>>etc... -тобишь в браузере или (повторюсь) отдельная программа...
>>
>>Смотрите в сторону docbook - это в некотором роде стандарт на оформление
>>документации.
>
>А такой вопрос - что бы можно было просто сесть и набрать
>документацию?
>Ну типа прога какая-то что бы её набивать?
>
>Про docbok не вьехал - что Она может делать, видимо из-за того
>что счас 4-ре утра :)

на сколько я понял docbook имелась в виду docbook.css (каскадная таблица стилей) используя которую написан Handbook
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

4. "Создание документации"  
Сообщение от newser (ok) on 19-Май-07, 12:07 
>на сколько я понял docbook имелась в виду docbook.css (каскадная таблица стилей)
>используя которую написан Handbook
>http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/

Неправильно поняли! Про docbook читать здесь: http://www.docbook.org/

Это не программа! Это определенный набор правил, по которому при помощи утилит типа xsltproc генерируется документация. С docbook работает несколько текстовых редакторов и IDE, так что google в зубы - и вперед!

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

5. "Создание документации"  
Сообщение от weldpua2008 email(ok) on 19-Май-07, 14:54 
>>на сколько я понял docbook имелась в виду docbook.css (каскадная таблица стилей)
>>используя которую написан Handbook
>>http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/
>
>Неправильно поняли! Про docbook читать здесь: http://www.docbook.org/
>
>Это не программа! Это определенный набор правил, по которому при помощи утилит
>типа xsltproc генерируется документация. С docbook работает несколько текстовых редакторов и
>IDE, так что google в зубы - и вперед!

Хм...
Ответьте на вопрос - возможно ли сделать с помощью docbook?
Мне надо... эм инструментарий абы не тратить время на забивание текста...
Както же документацию генерируют - не пишут же в html все руками?
_____________________________________________
|меню               ||       <содержание>   |
|===========================================|
|_раздел1           ||     Текущая страница |
|_раздел2           ||                      |
|_раздел3           ||                      |
  |_подраздел1      ||                      |
|_раздел4           ||                      |
  |_подраздел1      ||                      |
    |_подраздел1    ||                      |
        |_подраздел1||                      |
---------------------------------------------

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

6. "Создание документации"  
Сообщение от newser (ok) on 19-Май-07, 16:15 
>>>на сколько я понял docbook имелась в виду docbook.css (каскадная таблица стилей)
>>>используя которую написан Handbook
>>>http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/
>>
>>Неправильно поняли! Про docbook читать здесь: http://www.docbook.org/
>>
>>Это не программа! Это определенный набор правил, по которому при помощи утилит
>>типа xsltproc генерируется документация. С docbook работает несколько текстовых редакторов и
>>IDE, так что google в зубы - и вперед!
>
>Хм...
>Ответьте на вопрос - возможно ли сделать с помощью docbook?
>Мне надо... эм инструментарий абы не тратить время на забивание текста...
>Както же документацию генерируют - не пишут же в html все руками?
>
>_____________________________________________
>|меню               ||       <содержание>   |
>|===========================================|
>|_раздел1           ||
>    Текущая страница |
>|_раздел2           ||
>          
>          |
>
>|_раздел3           ||
>          
>          |
>
>  |_подраздел1      ||    
>          
>       |
>|_раздел4           ||
>          
>          |
>
>  |_подраздел1      ||    
>          
>       |
>    |_подраздел1    ||    
>          
>       |
>        |_подраздел1||    
>          
>       |
>---------------------------------------------


Если бы Вы хоть краешком глаза заглянули по приведенной ссылке, то не задавали бы подобных вопросов. :)

docbook основан на SGML/XML и предназначен как раз для подготовки технической документации. Если взгляните на документ, подготовленный в виде docbook-документа, то поймете, что он не сложнее html. В довесок к нему есть еще набор таблиц стилей docbook-xsl, при помощи которых и генерируется конечный документ. Возможные форматы вывода: html (single file), html (split), rtf, dvi, pdf... И все это из ОДНОГО источника, чем и является docbook-документ.

В общем, еще раз: google Вам в руки!

Высказать мнение | Ответить | Правка | Наверх | Cообщить модератору

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

Индекс форумов | Темы | Пред. тема | След. тема
Оцените тред (1=ужас, 5=супер)? [ 1 | 2 | 3 | 4 | 5 ] [Рекомендовать для помещения в FAQ]




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

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