docbook2texi(1) docbook2X docbook2texi(1)

docbook2texi - ?????????? ???????????? DocBook ???? Texinfo


docbook2texi
[?????????????????] xml-document

?????????? docbook2texi ?????? DocBook XML ????????????????? ???? ???? ???? ???? ?????? ?????? Texinfo ?????????? ?????????????. ????????????? ????????????????? ?????? ???????????? Texinfo ???? ?????????????????? ???????? ?????????? ???????? ???????????????.

?????????? docbook2texi ???? ?????????????? ?????????? ???????? ???? ???????????? ?????????? ???? ????????????????? ??????. ???????? ???????????? ?????????? ???? ?????? “???????????? ??????????” ???? ?????????? ???????????? ????????.

??????????????????? ???? ?????????? ???????????? ???????????? ??????????????????? ?????????????? db2x_xsltproc(1) ?? db2x_texixml(1) ??????????.

???????? ???? ??????????????????? ???????????????? ???? ?????? ???????? ??????:

?????????????? ??????????????????? ?????????? ???? ?????????? ?????????????.
???? ?????????????? ???????? ???????????? ???? ?????????? ????????????? (????????????????????? ???? ???? ???????? ?????????? ?????????? ?????? ???????????????????). ???????? ?????????????????????? ???? ??????????????????? ?????????? ?????????? ???? ?????? “???????????????????? ???????? ????????????” ???? ?????????? ???????????? ????????.
????????????? XML?? ???? ?????? ???????? SGML ???? ???? ?????????? ?????????? ?????????????????.

??????????. ?????? ???? ??????????????????????? ?????????? ???????? ??????????????????? ???????? (captions) ?????????????? ????????

?????????? ???????????????. 0 (???????? ???????????? / false)

?????? ???????? (true) ?????????? ???????????? title ???? ???????? ?????????? (????????) ???? ?????????????? @heading ???? Texinfo ???????? ?????????????.

?????? ???????????? (false) ?????????? ????????????????? ???? ???????? ???? ???????????????? ???????????????? ???????? ???????????????.

??????????. ?????????? link ???? ?????????????? ???? @pxref

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? link ???? ???????????? ?? ???? ?????????? ???? ?????????? ???????????? ???? ???????????? ?????????? ?????????????.

???? ?????? ?????? ?????????? ???????????? ???????????? ???? ?????????? ?????? ?????????? ???????????? ???? ???? @ref ??????????????????????? ?????? ?????? ?????????????. ?????????????? info ?????? ???????????? ???? ???? ?????? ???????????????? ?????????? ?????????????.

??????????. ?????????? ???? ??????????????? ?????? Texinfo ??????????????????? ???? ???????? ????????

?????????? ???????????????. 0 (???????? ???????????? / false)

?????????? ?????????? ???? ?????? ???????? ??????????????????? ???? ???????? ???????? ???? xreflabel?? ???? ???????? ?????????? ??????????????????? ???? title ???? role='texinfo-node' ???? ?????????????????? *info?? ???? ?????????? ?????? ?????? Texinfo ?????? ??????????????.

???? ?????? ???????? ???????? ???????? ???????????? ?????????? ??????????????? ???????? ?????? Texinfo ???? ?????????? ???????????? ?? ???????? ???????????? ?????? ????????????? ???????? ?????????? ?????????? ???????? ?????????? ???? ?????????? ???????????? ???? ????????. ?????? ???????????????? ???????? ?????? ?????????? ??????????. ?????? ?????? ?????????? ?????????? ?????? ???????? ?? ???????? ???????????? ???????? ???? ?????????? ?????? ?????????? ?????????? ???? ?????????? ???????? ????????????? ?? ?????????? ???? generate-id ???????? ?????? ?????????????? ???????????????.

???????????? ???? ???????????? ???????? ???? ???? ?????????? ???????????? ???????? ???????????? ??????????????????? ?????????? ?????? ????????????? ???? ?????????? ???????? ?? ???? ?????? ?????????? ?????????? ?????? ?????????? ?? ?????????????? ???? ??????????????? ???????? ?????? ?????????? ?????????????.

?????? ?????????? ????????????? ??????????????? ?????????? ???????? ?????? (???????? ???????????? / false ??????).

????????

????????????? ?????????????? ?????????? ???????? ?????????? ?????? ????????????? ?????????????? ???? ???????? XSLT ???? ?????? generate-id ???????? ?? ???????? ???????????? ???? ?????? ???????? ??????????????? ???? ?????????? ???????? ???? ?????????? explicit-node-names ?????????? ???? ?????????? ???????? ?????????????.

??????????. ?????? ?????????? comment ?????????? ???????? ??????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? ????????????????? ?????????? ???????? ???????????? ?????? ???? ?????? ?????? ???????? ?????????? ???????????????. ????????????????? ???? ?????????? ???? ???????? comment ?????????? ???????? ???? ???? DocBook V4.0 ???? remark ?????????? ?????? ???????? ???????? ???? ??????????????????? XML (<-- ?????????? ?????? -->) ???? ???? ?????????? ????????????.

??????????. ?????? ?????????? ???? FuncSynopsis ?????????? ??????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? ?????????? FuncSynopsis ?????????? ???????????? ???? (?????????? ?????????? ???? ????????). ?????????? ???????? ???????????? ?????????? ????????????? ???? ??????????????????? ???? ???? ???????? ??????????????????????? ???????????????? ????????.

??????????. ?????????? ???????????? ?????? ???? ???? ??????????

?????????? ???????????????. 0 (???????? ???????????? / false)

?????? ???????? ?????????? ??????????????????? ???????? <function> ???????? ?????????????????? ???????????????? ?????????? ??????.

??????????. ?????? ?????????? NAME ?????? ???? 'RefName'???? ?????????? ???????? ????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? ???? ?????????? ?????? "NAME" ?????? ???? ?????????? 'RefName'???? ?????????? ???????? ?????????????.

??????????. ?????? manvolnum ???? ?????????? ???????? ???? ?????????? ???????????? refentry ?????????? ???????? ????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? ?????????? ?????????? ???????????? ???? refentry?????? ???? ???? xref ?? ???? ???? citerefentry?? ???? manvolnum ?????????????? ?????????????.

??????????. ?????? textobject ???? imageobject ?????????? ???????? ????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? textobject ???? ???? mediaobject ???? ???? imageobject ?????????? ???????? ?????????????.

(?????????? ???????? ????????????????? ?????????? ?????? ???? Texinfo?? ?????????????? ?????????? ??????????????? ???? imageobject ?????????????? ?????????? ?????? Info ???? ???????? ????????????????? ??????.)

?????????? ???? ???????????? true ?? false?? ?????? ?????????????? ????????????????? ?????? 2 ?????? ?????????? ?????? ???? ???????? ?????? ???? ???? ?????? ?? ???? ???????????? ???????? ?????????? ???????? ????????. ???????? ?????? ?????????????? ?????? ?????? ???? ?????????? ???????? ???????? ???????? ???? ???????????????????????????????? Texinfo ??????????????????? ???????????? ???? ??????????????. ???????? ?????????? ?????????? ???? ?????????? @image ???? Texinfo ?????????????? ?????????? ???? ?????? ???? ???????? ??????????????????? ?????? ?????????? ?????? ?? ?????????? ???????? — ?????? ???? ???? ?????????? ???? ???? ?????????????? ?????????????????.

??????????????? true (????????) ??????.

??????????. ?????? ???? ??????????????????????? ????????????????? ???????????? Texinfo ?????????????? ????????

?????????? ???????????????. 1 (???????? ???????? / true)

?????? ???????? ?????????? ??????????????????????? ????????????????? ???????????? DocBook ???? (?????????????????????) ?????????? Texinfo ?????????? ?????????????. ?????? ???????? ??????????????? ??????.

???? ?????? ???????? ???? ???????? ???? ???????? Info ?????????? ???? ?????? ???????? ???????? ??????????????????????? ????????????????? ???????????? ???????? ???? ?????????????? ???? ???????????????????????? ???????? ???????????? ????????????? ???? ???????? ?????? ???????? ???????? ???????????? ????????. ??????????????????? ?????? ?????????? ???? ?????? false ?????????? ???????? ???? ???? ?????? ?????????? ?????????????? ??????. (???????? ?????????? ??????????????? ???? ??????????????????? ??????????????????? ??????????????????? ???? ???????? ???????????? ?????????????? ?????? ?????????????? ????????.)

??????????. ?????????? URI ?????? XML ???????? ????????????????? ??????????????????? ????????????

?????????? ???????????????. (????????)

?????? ?????????????? URI ???? ?????? XML ???? ???????? ????????????? ???? ??????????????????? ???????? (?? ???????? ?????????????? ???????????? ???? ???????????????????) ???????? ???????? ???????? ???????????? ???????? ???????????? ?????? DocBook ???? ?????????? ?????????????.

??????????????????? ???????? ???? ???????? ?????? ?????????????? ???????? ??????????????? ?????????? ???? ??????????????????? ???????? ??????????????? (???? ?????????????? ?????????? localization-file) ???????????? ??????????. ?????? ?????????? ???????? ???? ?????????? ???????? ???????????? ?????????? ???? ?????????? ??????????????? ???????????? ???? ?????????? ?????????????? ?????????????? ?????????????.

?????? ?????????????? ???????????? ???????? ?????????? ??????????????????? ???????????? ???????? ?????? ???? ???? ??????????????????? ?????? ???????? ?????????????? ???????????????. ?????????????? ??????????????????? ???????????? ???????? ???????? ?????? ???????? ???????????? ?????? ??????????????????? ???? ??????????????????? (locale) ?????? ???????????? ??????????.

???????? ?????? ?????????????? ???? ??????????????????? ???????? ?????????????? ?????? ?????????????? ???? ???? ?????????? ???????? ???????? ?????? ????????.

??????????. ?????? XML ???????? ????????????????? ??????????????????? ????????????

?????????? ???????????????. document($custom-localization-file)

?????? ?????????????? ?????? XML ???? ???????? ????????????? ???? ??????????????????? ???????? (?? ???????? ?????????????? ???????????? ???? ???????????????????) ???????? ???????? ???????? ???????????? ???????? ???????????? ?????? DocBook ???? ?????????? ?????????????.

?????? ?????????????? ???????? ???????? ???????????? ?????????? ??????. ???????? ?????????? ???? ???? ?????? XML ?????????? ???? ???? URI ???? ?????? ?????????? ???????? ????????????? ???? ???? ?????????????? custom-localization-file ?????????????? ????????.

???? ?????? ???????? ???????? ???? ???????? ???????????? ???????????? (???? ???? ???? ??????????) ?????? ?????????????? ????????????????? ?????? ?????????? XPath ???? ???????? document('') ?????????? ???????? ???? ???????? ????????????? ??????????????????? ???????????? ???? ???????????????? ???????? ???????? ???????????? ???????????? ?????????? ??????????????? ???????????? ????????.

??????????. ?????? othername ???? author ?????? ?????????? ????????

?????????? ???????????????. 1

?????? ???????? ?????????? othername ???? author ?????? firstname ?? surname ???????? ?????????????. ???? ?????? ?????? ?????????? othername ???????????? ?????????? ?????????????.

??????????. ?????? ???????? Info

?????????? ???????????????. (????????)

?????? ?????????????? ?????? ???????? ?????????? Info ???? ???????? ????????????? ?? ?????????????? ?????????? ???? ?????? ?????? ?? ???????????? ???????????? ???? ???????? ???????????? ???? ???????????????? ?????????????. ?????? ?????? ???? set ?????????? ?????? ?????????????? ???????????? ??????????.

??????

?????????? .info ???? ???? ?????? ???????? ??????????.

(???????? ?????????? ?????????? ???? ?????? ?????????????? ?????? ?????????????? ???? ?????? ?????????? Texi-XML ???????? ???????????????? XSLT ???? ?????? ???????? ???????????? ???? ???? ???? ???????? ??????????????? ??????????.)

??????????. ??????????????????? ?????? ???? ?????????????????? Info

?????????? ???????????????. (????????)

?????? ?????????????? ?????? ??????????????? ?????????? ????????????? ???? ?????? ???????? ???? ?????????????????? Info ????????????????? ??????????????? ?????? ???? ???????? ????????. ???????? ?????????? General Commands.

????????

??????????????? ???????? ?????? ???????????????? ???? ?????? ???????? ?????? ?????????? ????????. ?????? ?????? ?????? ?????????????? ???????? ???????????? ?????????? ?????????????? ?????????? ???? ?????? ???????? ???? ???????????????? ?????????????.

??????????. ?????????????? ?????? ???? ?????????????????? Info

?????????? ???????????????. (????????)

?????? ???? ?????????? ?????????? ???? ?????? ?????? ???? ???? ?????????????????? Info ????????????????? ??????????????? ?????????? ???????? ?????????????. ???????? ?????????? An Interactive Plotting Program..

????????

?????????????? ?????? ???????? ?????? ???????????????? ???? ?????? ???????? ?????? ?????????? ????????. ?????? ?????? ?????? ?????????????? ???????? ???????????? ?????????? ?????????????? ?????????? ???? ?????? ???????? ???? ???????????????? ?????????????.

??????????. ?????????? Texinfo ???????? ??????????????

?????????? ???????????????. cp

?????????? Texinfo ???????? indexterm ?? index ???? ?????????????? ???? ?????????? role ???????? ?????????????. ?????? ?????????? ?????? ?????????? role ???????????? ???????????? ???? ?????????? ??????????????? ????????????????? ???????? ?????? ?????????????? ?????????????? ?????????????.

??????????????????? ???? ?????? ??????????????????? ?????????????? ????:

?????????? ???????????? (Concept index)
?????????? ?????????? (Function index)
?????????? ?????????????? (Variable index)
?????????? ???????????? (Keystroke index)
?????????? ??????????????????? (Program index)
?????????? ?????????? ???????? (Data type index)

??????????????????? ??????????????????? ???????? ?????????? ???????? ???????????????? ?????????????????.

??????????. ?????????? ??????????????? defaultlabel ???? ?????? QandASet ?????????? ?????????????.

?????????? ???????????????.

?????? ?????? ?????????? defaultlabel ?????? ???? QandASet ???????? ???????? ?????????? ???? ?????? ?????????? ?????????????? ?????????????. ?????? ?????????? ???????? ?????? ???? ???????????? ???????? ???????? ?????????? defaultlabel ????????.

??????????. ?????? ???????? ?????????? (??????????) ???????? QandASet???? ?????????? ????????

?????????? ???????????????.

?????? ???????? ?????????? ???? ?????????? ?????????? ???????? QandASet???? ?????????? ?????????????.

$ docbook2texi tdg.xml
$ docbook2texi --encoding=utf-8//TRANSLIT tdg.xml
$ docbook2texi --string-param semantic-decorations=0 tdg.xml
.fi

???????????? DocBook ???? ???? ?????????? ???? Texinfo ?????????? ???????????????:

1.
???????? DocBook ???????? ???? ???????? ???????????? XSLT ???? ???? ???????? XML ?????????? ???? ?????? Texi-XML ?????????? ?????????????.

???????? Texi-XML ??????????????? ???? DocBook ?? ????????????????? ???? ???????? Texinfo ???????? ?????? ???? ??????????????? ???????? ?????? ????????????????? ???????????? ??????.

???????? ???????????? ???????? ?????? ?????????? ???? ???????? xslt/texi/docbook.xsl ???????? ????????. ???????? ?????????????? ?? ??????????????????????????? ?????????? ???????? ???? URI ?????? ???? ???? ?????????? ???????? ??????:

http://docbook2x.sourceforge.net/latest/xslt/texi/docbook.xsl

?????? ???????? ???????????? ???? ???? db2x_xsltproc(1) ???????? ????????.

???????????????????????. ???????????? ??????????????????? ???? ?????????? ???????? ???????????? XSLT ?????????????? ?????? — ?????????? ?????????????????? ???? ???????????? ?????????????? ???????? — ?? ???????? ???????? ???????? xslt/texi/docbook.xsl?? ?????????? ???? ??????????????????????? ????????.

2.
???????? Texi-XML ???????? ?????????? db2x_texixml(1) ???? ????????????????? ?????????? Texinfo ?????????? ?????????????.

?????????? docbook2texi ???? ???? ?????????? ???? ????????????? ???????????? ?????????? ??????????????? ?????? ???? ???????? ???????? ???????????? ?????????? ??????????????????? ???? ?????????? ?????????????? ???? ???????????? ?????????? ???? ???? ???????? ???????????? ???????????? ????????:

$ db2x_xsltproc -s texi mydoc.xml -o mydoc.txml
$ db2x_texixml mydoc.txml
.fi
??????????????????? ?????????? ???? ???????? ???????????? ?????????? ???? ?????????????? ???????? ????????????????? ???????????? Texinfo ?????? ???????? ?????? ??????.

?????????? ?????????? XML ???? ????????????????? ?????????? ?????????? ???? ASCII ???? ???????????????? ???????? ???? ?????????????? ?????????? ?????????? ???????????? (man) ?? Texinfo?? ?????????? ?????? ???????? ???????? ???????? ???? ??????????????????? ???????????? ???? ?????? ???????? ?????? ???????? ???? ???????? ?????????? ????????.

???? ?????????? ???????????? ???????????? ????????????????? ???? ???????????? ???????? ?????????? ???????? ???????????? ?????????? ?????????? ???? ?????????????? US-ASCII ???? ISO Latin-1 ???????? ???????? ??????????????????? ???????????? ?????????? ???? ???????? ?? ??????????????????? ??????????????? ??????????????? ???? ???? ?????? ???????????? ???? ?????????? XML ?????????????? ????????????????? ????????. ?????? ??????????????????????? ?????????? (man ?? Texinfo) ?????????? ??????????????? ???????? ????????????????????? ???? ???? ?????????? ???????? ??????????????????????? ???????? ????????: ???????? ?????????? \(lq ???????? ?????????? ??????????????? ??????????????? ???? “. ?? ?????? ???? ???????? ???? ?????? ??????????????????????? ???? ?????????? ???????????? ???????? ?????? ???? ???? ????????????????????????? ???? ASCII ?????????????? ??????: ???????? ?????????? ?????????????? ???? ?????????? ??????????????? ???? ASCII ???????? < ???????? ?????????? ??????????????? ??????????????????? ⟨.

???????????????? ???????? ??????????????????? ???????????? ???? ??????????????? ???? ???? ?????????? ???? ??????:

1.
???????????? utf8trans(1)?? ??????????????????? ?????????? ???? ???????? docbook2X?? ??????????????????? ???????????? ???? ???? ???????????????????????????????? ???? ???????????? ???????? ???? ?????? ??????????????????????? ?????????? ?????????????.

???? ???????? ???? ???????????? ???? ?????????? ???????? ?? ???????? ???????? ??????????????????? ???????????? ???????? ???????????? utf8trans ????????????????? ??????????????????? ?????????? ????????????????????? ???????? ?????????? ???? ???? ???? ????????????????? ???????? ???????? ??????????????? ???????????? ?? ?????????? ??????. (???????????? ???????? ???????????????????????????????? ???????????? ??????????.)

???? ?????????????? charmaps/man/roff.charmap ?? charmaps/man/texi.charmap ??????????????????? ????????????????? ???????? ?????????? ???? ??????????????????? ???????? ?????????? ?????????? ???????????? ?? Texinfo ?????????????? ????????. ????????????????????? db2x_manxml(1) ?? db2x_texixml(1) ?????? ??????????????????? ???????????? ???? ?????????? ?????????? ?????????? ???? ???????? ?????????? ???????? ?????? ???? ????????????? ???????????? ?????????? ???????????????.

2.
???????? ?????? ???????????? ???? ???? ???????????? ?????????? ???????? (??????????????) ?????????? ?????????????. ???????? ?????????? ???? ?????? ?????????????? ???? ??????????????????? ?????????? ?????????? (?????????? é) ???????? ?????? ???? ISO Latin 1 ?????????? ??????.

?????? ?????????? ???? ???? ?????????? ?????????? ???????? utf8trans?? ???? ?????????????? ???? ?????????? ?????????? ?????????????? iconv(1) ?????????? ?????????????. ???? ???? ?????????? db2x_manxml(1) ?? db2x_texixml(1) ??????????????????? ?????????? ?????????? ?????????? ???????? iconv(1) ???? ????????????? ???????????? ???????????????? ????????.

/usr/local/share/docbook2X/xslt/texi/docbook.xsl
/usr/local/share/docbook2X/xslt/backend/db2x_texixml.xsl
/usr/local/share/docbook2X/xslt/catalog.xml
/usr/local/share/docbook2X/charmaps/texi.charmap.xml
/usr/local/share/docbook2X/charmaps/texi.charmap.xml

????????????????? ?????? ???????? ???????? docbook2X ?????????? ?? ?????? ???????????????.

?????????????? docbook2man ???? docbook2texi ?????? ???????? ?????? ???? ?????? ???????? ?????????????? ???? ???????? docbook2X ?????????? ???????????????. ?????????? ???? ???? ???? ???????????? ???? ???????? ?????? ???? ???????? ??????????????????? docbook-utils ???????????? ????????.

•
???????? ?????????????? ???? ???? ???????? ???????????? ???? ??????????????????? ???????? ???????? ???? ?????? ?????? ???? ???? ???????? ?????????????. ?????? ???? ?????? ???? ?????? ???? ???????? ???? ???????? ?????????? ?????? (?????? ???? ?????????? ?????????? ?????????? ???????????? ?????????? ???? ??????????????????? ????????????)?? ???????????? ???????? ???????? ?????? ???? ???????? ???????? ???????????????? ?????????? — ???? ?????? ?????????? ?????? ???????? ?????????? docbook2X ???? ???? ???????? ?????????????? ???????? ????????.

Steve Cheng <stevecheng@users.sourceforge.net>.

db2x_xsltproc(1), db2x_texixml(1), utf8trans(1)

?????????????? docbook2X (???? ???????? Texinfo ???? HTML) ???? ?????? ???????? ???????? ?????????? DocBook ???? ?????????? ???????????? ?? Texinfo ???? ?????? ?????????????.

?????????????? ????????????? ???????????? ?????? ???????????? ???? ??????????????? ???? ??????????????? docbook2X ⟨http://docbook2x.sourceforge.net⟩ ????????.

3 March 2007 docbook2X 0.8.8