LINUX.ORG.RU

Docbook никуда не годится.


0

0

Мда. Оказывается, Docbook не годится для работы. Во-первых, в нем неудобно писать. И совершенно неважно, каким инструментом пользоваться. xml есть xml. Хотя я легко мог бы представить себе даже xml, который был бы гораздо удобнее Docbook'а. Для меня было откровением, что не только ISO-шные комитеты способны придумать стандарт, в котором для добавления картинки я должен написать:

<screenshot>
<screeninfo>Это скриншот.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="бубубу.jpeg" format="JPEG"/>
</imageobject>
</mediaobject>
</screenshot>

Ну, хорошо, если немножко нарушить рекомендации Docbook, можно ужаться всего в 5 строк, но скажите мне, зачем они нужны, если хватило бы и одной?

Во-вторых, toolbox для Docbook близок к полному отсутствию(по крайней мере, для Linux; прочие OS мне иррелевантны). Что у нас есть? docbook-utils, которым нужен полумертвый jadetex. xmlto, которому нужен уже совершенно мертвый passivetex. Два xsl:fo форматтера: мегатерий fop, который никак не доделают уже лет пять и который никогда не мог угнаться за спецификацией xsl:fo, и новорожденный xmlroff, который толком не работает ни с одним из двух своих backends. А, забыл про dblatex. Работает. Но только так, как ему хочется, а не так, как мне нужно.

В-третьих, главным преимуществом Docbook (и LaTeX, но это отдельный разговор) обычно называют то, что "вы пишете текст в формате DocBook и не забываете его структурировать в соответствии со смысловой нагрузкой каждого элемента, а о последующем форматировании (внешнем виде выходного документа) вы не думаете вовсе." (из http://viju.tvercity.net/articles/worddocbook). Фиг! Если кто-то не думает о форматировании, он напишет все в plain text. А вот если мне нужно форматирование, но меня не устраивает то, которое предлагает по умолчанию имеющийся инструментарий, то я попал.

Вот понадобилось мне быстро сделать pdf под экран размером 3.5" на 4.5", да шрифт уменьшить на пару пунктов. И все. Работы на два часа.

Короче. Желчь я излил. Теперь конструктивно. А куды бечь? Какие есть альтернативы? Нужно быстро и легко писать недлинные документы (инструкции, полиси, etc.), быстро менять форматирование в разумных пределах, вставлять картинки, получать pdf, rtf, html. Хотя бы.


Ответ на: комментарий от kondor

http://dita-ot.sourceforge.net/ :

> Key output targets are XHTML, HTML Help, PDF2 (processed using the Idiom plug-in and RenderX XEP)

http://www.renderx.com/download/personal.html :

> RenderX is pleased to offer a Free, Personal Edition of our software for non-commercial use.

Наверное, я что-то не понимаю... Впрочем, я действительно посмотрю на нее поближе. [безнадежно упавшим голосом] А больше, значит, ничего? Спасибо. Наверное, пойду я лучше перечитывать Гуссенса с Самариным...

mind
() автор топика
Ответ на: комментарий от kondor

Я тут почитал немного, и у меня сложилось впечатление. что DITA мне подходит еще меньше, чем Docbook. Docbook меня не устраивает реализацией, а DITA вообще ориентирована на другие цели:

http://www.dclab.com/dita_docbook.asp :

db: DocBook is a document type definition (DTD) for writing technical books and articles, with the structure that such forms imply.

dita: DITA is both a DTD and a set of rules for writing online contextual documentation such as software help files.

db: Simple. Can usually be downloaded and set up in a day.

dita: More complex. Usually requires more time and some technical expertise.

db: Well supported by the XML community

dita: Small but strong, growing community

db: With a little development, DocBook can do what DITA is attempting on a smaller scale

dita: DITA is impressively engineered, but can be too industrial-strength

http://drmacros-xml-rants.blogspot.com/2008/04/choosing-xml-schema-docbook-or... :

If you are looking for a documentation schema that you can just pick up and use and you don't need the modularity features of DITA (that is, you don't need the functionality of DITA maps) then DocBook probably makes the most sense for the reasons Richard cites, namely that there are more element types of likely utility out of the box and the processing infrastructure is more mature and better documented.

http://xml.coverpages.org/DocBook-DITA-customDTD.html :

As for whether to start with DocBook or DITA, my standard guidance is:

* If you need to get started immediately, want to initially invest as close to zero as you can, and your primary task is to produce typical technical manuals, use DocBook.

* If you have any requirement for re-use, specialization, or modular delivery AND you can afford a little up-front investment in analysis, specialization, and tool development, then use DITA.

The tradeoff is that DITA is, as currently defined, less well suited to book production out of the box — you can do everything you need but it may require more effort on your part (for example, DITA 1.0 is underspecified for index markup, something the DITA Technical Committee is discussing right now). Also, the current free DITA tool kits are not as functionally complete as the comparable DocBook tool kits are.

mind
() автор топика
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.