LINUX.ORG.RU
решено Форум — Development  

Есть ли хотя бы одна машина, на которой работает DocBook?


0

1

Вот простейший пример из википедии: 

 <?xml version="1.0" encoding="UTF-8"?>
 <book xml:id="simple_book" xmlns="http://docbook.org/ns/docbook" version="5.0">
   <title>Very simple book</title>
   <chapter xml:id="chapter_1">
     <title>Chapter 1</title>
     <para>Hello world!</para>
     <para>I hope that your day is proceeding <emphasis>splendidly</emphasis>!</para>
   </chapter>
   <chapter xml:id="chapter_2">
     <title>Chapter 2</title>
     <para>Hello again, world!</para>
   </chapter>
 </book>
и вот что говорит docbook: 
$ docbook2dvi docbook.sgml 
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/minoru/Downloads/docbook.sgml
openjade:/home/minoru/Downloads/docbook.sgml:2:1:E: prolog can't be omitted unless CONCUR NO and LINK EXPLICIT NO and either IMPLYDEF ELEMENT YES or IMPLYDEF DOCTYPE YES
openjade:/home/minoru/Downloads/docbook.sgml:2:1:E: no document type declaration; will parse without validation

Кто-нибудь знает в чем дело? Так же, как быть с кириллицей?

★★★

Я знаю целые пакеты документации, которые собираются DocBook'ом.

С другой стороны, я лично считаю его формат очень многословным и человеконечитаемым, и стараюсь избегать.

JackYF ★★★★
()

Мой опыт общения с DocBook'ом также был печальным. Впрочем, как и мои первые опыты общения с TeX'ом :)

buddhist ★★★★★
()
Ответ на: комментарий от kondor 
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
<?xml version="1.0" encoding="UTF-8"?>
<book xml:id="simple_book" xmlns="http://docbook.org/ns/docbook" version="5.0">
  <title>Very simple book</title>
  <chapter xml:id="chapter_1">
    <title>Chapter 1</title>
    <para>Hello world!</para>
    <para>I hope that your day is proceeding <emphasis>splendidly</emphasis>!</para>
  </chapter>
  <chapter xml:id="chapter_2">
    <title>Chapter 2</title>
    <para>Hello again, world!</para>
  </chapter>
</book>

$ docbook2dvi hello.sgml 
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/minoru/hello.sgml
openjade:/home/minoru/hello.sgml:1:54:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V3.1//EN"
openjade:/home/minoru/hello.sgml:1:54:E: reference to entity "book" for which no system identifier could be generated
openjade:/home/minoru/hello.sgml:1:0: entity was defined here
openjade:/home/minoru/hello.sgml:1:54:E: DTD did not contain element declaration for document type name
openjade:/home/minoru/hello.sgml:3:13:E: there is no attribute "xml:id"
openjade:/home/minoru/hello.sgml:3:33:E: there is no attribute "xmlns"
openjade:/home/minoru/hello.sgml:3:73:E: there is no attribute "version"
openjade:/home/minoru/hello.sgml:3:78:E: element "book" undefined
openjade:/home/minoru/hello.sgml:4:8:E: element "title" undefined
openjade:/home/minoru/hello.sgml:5:18:E: there is no attribute "xml:id"
openjade:/home/minoru/hello.sgml:5:29:E: element "chapter" undefined
openjade:/home/minoru/hello.sgml:6:10:E: element "title" undefined
openjade:/home/minoru/hello.sgml:7:9:E: element "para" undefined
openjade:/home/minoru/hello.sgml:8:9:E: element "para" undefined
openjade:/home/minoru/hello.sgml:8:54:E: element "emphasis" undefined
openjade:/home/minoru/hello.sgml:10:29:E: element "chapter" undefined
openjade:/home/minoru/hello.sgml:11:10:E: element "title" undefined
openjade:/home/minoru/hello.sgml:12:9:E: element "para" undefined

Кто-нибудь таки может привести рабочий helloworld на docbook? :)

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

Кто-нибудь таки может привести рабочий helloworld на docbook? :)

https://bitbucket.org/syntext/serna-free/src/3b29676188d5/serna/dist/examples...

Если и этот не сработает, выкидывай свой docbook-процессор :)

Не может найти:

openjade:/home/minoru/hello.sgml:1:54:W: cannot generate system identifier for public text "-//OASIS//DTD DocBook V3.1//EN"

в

Using catalogs: /etc/sgml/catalog

Посмотри как создаются DocBook документы в XML-редакторе Serna Free

kondor ★★★
()

$ dblatex -b xetex a.xml
Build the book set list...
Build the listings...
XSLT stylesheets DocBook - LaTeX 2e (0.3.2-1)
===================================================
Stripping NS from DocBook 5/NG document.
Processing stripped document.
Build a.pdf
'a.pdf' successfully built

http://ompldr.org/vYWx0Nw

Eshkin_kot ★★
()

А как запинать русский язык?

openjade:/home/minoru/docbook1.sgml:41:18:E: non SGML character number 129
openjade:/home/minoru/docbook1.sgml:41:20:E: non SGML character number 130
Minoru ★★★
() автор топика
2 ноября 2011 г.
Ответ на: комментарий от Minoru

2 Модератор и All: тема давняя, но судя по всему, для автора еще актуальная.

2Minoru Добрый день!

К вопросу: «Есть ли хотя бы одна машина, на которой работает DocBook?»

У нас в компании вся документация построена на docbook (уже порядка 5-х лет). Примерно 300-500 документов. Редактирование - локально с помощью GUI (XMLMind). Обработка и представление - централизованно на debian-сервере и в реалтайме (с учетом различных форматов, профайлинга, олинков и т.п. специфических docbook фич).

По поводу вашего примера. Я немного не понял суть вопроса про «работает» - вы имеете в виду работает вообще или работает именно конверт в dvi? По поводу работает вообще - я ответил чуть выше. Насчет вашего примера. Вы используете пятый докбук, судя по коду. В нем не надо применять DTD, т.к. там все построено на Relax NG. Для простоты расмотрим четвертую версию (точнее, стандарт OASIS 4.5).

Вот рабочий пример: 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<article id="x_adminguide" lang="ru">
  <title>Руководство администратора системы X</title>

  <articleinfo>
    <productname>X</productname>

    <productnumber>2.0</productnumber>

  </articleinfo>

  <section id="x_intro">
    <title id="x_intro_title">Введение</title>

    <section>
      <title>Назначение этого документа</title>

      <para>Руководство администратора предназначено для описания установки и
      развертывания системы X.</para>
    </section>
  </section>
</article>
Установите docbook-xsl-1.76.1 и xsltproc и сделайте так: 
xsltproc --output sample.html <path_to_docbook_xsl>\html\docbook.xsl sample.xml

Это покажет вам, что docbook работает (правильно говорить, конечно, работает генерация/вывод докбук документа в формате html) .

Если есть вопрос - спрашивайте. Чем смогу - помогу.

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