Armenian Knowledge Base  

Go Back   Armenian Knowledge Base > Entertainment > Literary nook > TWARM
Register

Reply
 
LinkBack Thread Tools
Old 29.09.2004, 09:46   #1
eternal_flame
 
Join Date: 08 2004
Location: Yerevan
Age: 36
Posts: 254
Downloads: 1
Uploads: 0
Reputation: 8 | 0
Default DocBook

DocBook — это описание типа документа (DTD) для языка XML, разработанное для создания документации.
В отличие от LinuxDoc и HTML, DocBook очень сильно ориентирован на разметку, описывающую что это, а не на описание того, как это должно выглядеть.

DocBook позволяет структурировать документ несколькими способами. В Проекте Документирования FreeBSD мы используем два основных типа документа DocBook: книга (book) и статья (article).
Книга организуется в виде глав (<chapter>). Это обязательное условие. Между книгой и главой могут быть части (<part>) для того, чтобы дать дополнительный уровень организации. Руководство организовано именно так.
Глава может содержать (или может не содержать) один или большее количество разделов. Это выделяется элементом <sect1>. Если раздел содержит другой подраздел, то используются элемент <sect2> и так далее, до <sect5>.
В главах и разделах содержится оставшийся текст.
Статья устроена проще, чем книга, в ней не используются главы. Вместо них содержимое статьи организуется в один или большее количество разделов, с использованием те же самые элементы <sect1> (<sect2> и так далее), что используются в книгах.
Очевидно, что вы должны следовать характеру документа, который вы создаете, для решения того, лучше размечать его как книгу или как статью. Статьи хорошо подходят для информации, которую не нужно разбивать дальше на несколько глав, и которая имеет относительно небольшой объем, до 20-25 страниц текста. Книги лучше подходят для информации, которая может разбиваться на несколько глав, возможно, с примечаниями и тому подобным содержимым.

Ссылки на информацию по Docbook (на английском языке):

Домашняя страница Docbook; http://www.docbook.org/

«DocBook: The Definitive Guide». Можно скачать одним файлом; http://docbook.org/tdg/en/html/docbook.html

Docbook FAQ; http://www.dpawson.co.uk/docbook/index.html
Reply With Quote
Old 29.09.2004, 13:28   #2
★★★★★★★★★★★★★
 
Hrach_Techie's Avatar
 
Join Date: 08 2004
Location: London, UK
Age: 38
Posts: 16,531
Downloads: 8
Uploads: 0
Reputation: 482 | 6
Default

thanks for the info ... btw, FM supports doc book devlopement as well ...just fyi

Last edited by Hrach_Techie; 10.02.2005 at 10:29.
Reply With Quote
Old 10.02.2005, 10:30   #3
★★★★★★★★★★★★★
 
Hrach_Techie's Avatar
 
Join Date: 08 2004
Location: London, UK
Age: 38
Posts: 16,531
Downloads: 8
Uploads: 0
Reputation: 482 | 6
Default

this is a good one
http://www.dulug.duke.edu/~mark/docbookmarks/
Reply With Quote
Old 13.02.2005, 10:22   #4
★★★★★★★★★★★★★
 
Hrach_Techie's Avatar
 
Join Date: 08 2004
Location: London, UK
Age: 38
Posts: 16,531
Downloads: 8
Uploads: 0
Reputation: 482 | 6
Default

http://www.lodestar2.com/people/dyor...es/frames.html
Reply With Quote
Sponsored Links
Reply

Thread Tools


На правах рекламы:
реклама

All times are GMT. The time now is 14:57.


Powered by vBulletin® Copyright ©2000 - 2017, Jelsoft Enterprises Ltd.