LINUX.ORG.RU
 

Открыт сайт Docbook.ru


0

0

Сайт посвящен одноименному формату, призванному стандартизировать оформление разнообразной документации

DocBook - это технология разработки документации на основе SGML или XML, позволяющая из единого исходного текста автоматически получать выходные документы в различных форматах (наиболее распространенные - HTML, PDF, HTML Help) и с разными вариантами компоновки и оформления (подробнее)

>>> Подробности

anonymous ()
Проверено: Pi (17.05.2005 20:28:47)

ПОСАДИ КОМПЬЮТЕР НА ЦЕПЬ И ЗАСТАВЬ ЛАЯТЬ!

домашняя автоматизация: сделай сам; лучший подарок для техногика

http://www.unicontrollers.com/products/unc01x

[#] Ответ на: Re: Открыт сайт Docbook.ru от BreadFan 18.05.2005 10:04:18  

Re: Открыт сайт Docbook.ru

>И чтобы все коллеги на работе были грудастыми брюнетками.

Лучше рыжими ;)

* ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от Dimentiy 18.05.2005 15:29:57  

Re: Открыт сайт Docbook.ru

Главное шоб грудастыми, а там - пусть хоть блондинки будут

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от anonymous 18.05.2005 15:39:45  

Re: Открыт сайт Docbook.ru

Грудастыми и пиздатыми!

anonymous ()
[#]  

Re: Открыт сайт Docbook.ru

И что б давали бесплатно!

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от BreadFan 18.05.2005 10:04:18  

Re: Открыт сайт Docbook.ru

>8. И чтобы все коллеги на работе были грудастыми брюнетками.

Ты чего, с дерева упал? Какие брюнетки!!? Только блондинки!

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от majordomo 18.05.2005 0:49:23  

Re: Открыт сайт Docbook.ru

>>*roff? imho, обучение до уровня, достаточного для оформления адекватной документации идет несколько часов.

т.е. чтобы написать доку всего на несколько страниц, нужно кого-то просить, т.к. номальный разработчик _сам_ писать это не будет. Особенно дока под KDE.

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от Skull 18.05.2005 10:20:20  

Re: Открыт сайт Docbook.ru

>>Для красноглазых виндузятников? После Quanta - жалкая студенческая поделка... :)

Это тот, который переведён только наполовину, и падает иногда ? Переместите себе этот редактор в /dev/null.

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от Skull 18.05.2005 10:18:44  

Re: Открыт сайт Docbook.ru

>>это не язык программирования, а язык разметки. HTML вы тоже языком программирования считаете?

Я сказал фактически. Чтобы написать простейший html, мне нужно знать 10-15 элементарных тегов. А чтобы написать в докбуке документацию для, скажем, КДЕ-шной проги, нужно сначала изучить хренову тучу тегов и особенностей устройства документа.

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от anonymous 18.05.2005 20:38:26  
AP

Re: Открыт сайт Docbook.ru

Чтобы написать простейший документ в db/xml -- около 20. Я уже считал :)

***** ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от AP 18.05.2005 21:10:41  

Re: Открыт сайт Docbook.ru

это протстейший. А ты почитай руководство по докбуку для KDE. и заодно template.docbook из kdelibs/kdoctools/ (500 строк).

anonymous ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от anonymous 18.05.2005 17:09:43  

Re: Открыт сайт Docbook.ru

>Ты чего, с дерева упал? Какие брюнетки!!? Только блондинки!

Не. Если не рыжими - то лучше пусть брюнетки будут.

* ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от anonymous 18.05.2005 15:39:45  

Re: Открыт сайт Docbook.ru

>Главное шоб грудастыми

Спорно ;0)

* ()
[#]  

По теме.

Docbook - конечно хорошая штука, теоретически.

Но, учитывая что качественных его редакторов для `нормальных людей` не существует - работать неудобно.
1. Не надо про редактор от xmlmind - он не умеет ENTITY в документе. Фтопку.
2. Не надо про тулзы от Altova - они вообще много чего не умеют. А главное, у них своеобразные взгляды на стандарты.
3. Не надо про emacs - это для гиков.
Вот и остаётся колить это ручками. А оно надо?

Соответственно, не рулит.
Если не сказать, что сосёт.

* ()
[#] Ответ на: По теме. от Dimentiy 19.05.2005 1:13:02  

p.s.

Сделавшим русский сайт всё равно спасибо.

* ()
[#] Ответ на: Re: Открыт сайт Docbook.ru от anonymous 18.05.2005 17:09:43  

Re: Открыт сайт Docbook.ru

> Только блондинки!

Каменный век. Давно вышли из моды.

anonymous ()
[#] Ответ на: По теме. от Dimentiy 19.05.2005 1:13:02  
AP

Re: По теме.

> Но, учитывая что качественных его редакторов для `нормальных людей` не существует - работать неудобно.

Причём тут "нормальные" и "ненормальные"? Есть техписы, для них оно и сделано.

> 1. Не надо про редактор от xmlmind - он не умеет ENTITY в документе. Фтопку.

Ну не пользуйтесь :)

> 2. Не надо про тулзы от Altova - они вообще много чего не умеют. А главное, у них своеобразные взгляды на стандарты.

Ими тоже никто пользоваться не заставляет :)

> 3. Не надо про emacs - это для гиков.

Очень спорно. Те же psgml и nxml моды вполне удобны.

> Вот и остаётся колить это ручками. А оно надо?

Если нужен DB/XML, то почему нет? Мой личный опыт показывает, что куда как проще писать с логической разметкой в докбуке, чем корячиться с вордом, даже используя ТОЛЬКО стилевую разметку. Производительность однозначно выше.

***** ()
[#] Ответ на: Re: По теме. от AP 19.05.2005 12:49:06  

Re: По теме.

2AP:

>Причём тут "нормальные" и "ненормальные"? Есть техписы, для них оно и сделано.

Ну, я не техпис ;) Хотя был бы техписом - всё равно сказал бы, что инструментов не хватает.

>Ну не пользуйтесь :) >Ими тоже никто пользоваться не заставляет :)

Да в общем-то да, я и не пользуюсь :)

Кстати, кто-нибудь знает визуальный докбук-редактор, которым можно работать вот с этим: http://svn.red-bean.com/svnbook/trunk/src/en/book/ Из того, что я смотрел, ни один редактор не прожевал.

Только редактор не должен быть emacsом :)

>Очень спорно.

Не, _для_меня_ бесспорно. Ума не хватает emacs освоить :)

>Если нужен DB/XML, то почему нет? Мой личный опыт показывает, что куда как проще писать с логической разметкой в докбуке, чем корячиться с вордом, даже используя ТОЛЬКО стилевую разметку. Производительность однозначно выше.

Да не, я ничего против докбука не имею. Но всё-таки руками в тэгах - мазохизм, а редакторы не очень.

По мне так докбук хорош только тем, что он стандарт и его можно использовать как промежуточный формат. Например, была бы wiki, которая умела бы свой контент в подмножество докбука конвертить... [ Или может быть уже есть? ;) ]

Насчёт ворда - он _лично_для_меня_ очень удобен _обычно_. Но с ним беда - как только начинаешь делать что-то более-менее сложное, лезут малопонятные глюки. Если например документ из нескольких sections и т.д.

p.s. Это Вы бываете на форуме философта?

--------------------

2All:

Я правильно понял, что против рыжих возражений нет? ;)

* ()
[#] Ответ на: Re: По теме. от Dimentiy 19.05.2005 15:32:07  
AP

Re: По теме.

> Кстати, кто-нибудь знает визуальный докбук-редактор, которым можно работать вот с этим: http://svn.red-bean.com/svnbook/trunk/src/en/book/ Из того, что я смотрел, ни один редактор не прожевал.

Дайте догадаюсь -- ругались на —? :)

> Например, была бы wiki, которая умела бы свой контент в подмножество докбука конвертить... [ Или может быть уже есть? ;) ]

http://en.tldp.org/wt2db/

> Но с ним беда - как только начинаешь делать что-то более-менее сложное, лезут малопонятные глюки. Если например документ из нескольких sections и т.д.

Прямо сейчас у меня в ворде открыт 45-страничное "Описание комплекса технических средств". Десяток таблиц, чуть меньше иллюстраций, гостовские рамки по бокам. Ворд за сутки свалился на нём четыре раза. правка в режиме не только сохранения, но и отображения изменений приводит к существуенному замедлению прорисовки вносимых изменений. Попросту говоря, набираешь слово и ждёшь, пока оно нарисуется. Компьютер: Celeron 1,5 ГГц, 512 Мбайт RAM. И всё это при довольно неудобно пользовательском интерфейсе (в сравнении с Writer, к примеру).

> p.s. Это Вы бываете на форуме философта?

Да :)

***** ()
[#] Ответ на: Re: По теме. от AP 19.05.2005 17:24:15  
vm

Re: По теме.

докбук вещь архи полезная

** ()