| docbook2texi(1) | docbook2X | docbook2texi(1) |
?????? (NAME)
docbook2texi - ?????????? ???????????? DocBook ???? Texinfo
?????????? ?????????? (SYNOPSIS)
docbook2texi
[?????????????????] xml-document
?????????????? (DESCRIPTION)
?????????? docbook2texi ?????? DocBook XML ????????????????? ???? ???? ???? ???? ?????? ?????? Texinfo ?????????? ?????????????. ????????????? ????????????????? ?????? ???????????? Texinfo ???? ?????????????????? ???????? ?????????? ???????? ???????????????.
?????????? docbook2texi ???? ?????????????? ?????????? ???????? ???? ???????????? ?????????? ???? ????????????????? ??????. ???????? ???????????? ?????????? ???? ?????? “???????????? ??????????” ???? ?????????? ???????????? ????????.
????????????????? (OPTIONS)
??????????????????? ???? ?????????? ???????????? ???????????? ??????????????????? ?????????????? db2x_xsltproc(1) ?? db2x_texixml(1) ??????????.
???????? ???? ??????????????????? ???????????????? ???? ?????? ???????? ??????:
- --encoding=??????????????
- ?????????????? ??????????????????? ?????????? ???? ?????????? ?????????????.
- --string-param ??????????????=??????????
- ???? ?????????????? ???????? ???????????? ???? ?????????? ????????????? (????????????????????? ???? ???? ???????? ?????????? ?????????? ?????? ???????????????????). ???????? ?????????????????????? ???? ??????????????????? ?????????? ?????????? ???? ?????? “???????????????????? ???????? ????????????” ???? ?????????? ???????????? ????????.
- --sgml
- ????????????? XML?? ???? ?????? ???????? SGML ???? ???? ?????????? ?????????? ?????????????????.
???????????????????? ???????? ???????????? (STYLESHEET PARAMETERS)
- captions-display-as-headings
- ??????????. ?????? ???? ??????????????????????? ?????????? ????????
??????????????????? ???????? (captions) ?????????????? ????????
?????????? ???????????????. 0 (???????? ???????????? / false)
?????? ???????? (true) ?????????? ???????????? title ???? ???????? ?????????? (????????) ???? ?????????????? @heading ???? Texinfo ???????? ?????????????.
?????? ???????????? (false) ?????????? ????????????????? ???? ???????? ???? ???????????????? ???????????????? ???????? ???????????????.
- links-use-pxref
- ??????????. ?????????? link ???? ?????????????? ???? @pxref
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? link ???? ???????????? ?? ???? ?????????? ???? ?????????? ???????????? ???? ???????????? ?????????? ?????????????.
???? ?????? ?????? ?????????? ???????????? ???????????? ???? ?????????? ?????? ?????????? ???????????? ???? ???? @ref ??????????????????????? ?????? ?????? ?????????????. ?????????????? info ?????? ???????????? ???? ???? ?????? ???????????????? ?????????? ?????????????.
- explicit-node-names
- ??????????. ?????????? ???? ??????????????? ?????? Texinfo
??????????????????? ???? ???????? ????????
?????????? ???????????????. 0 (???????? ???????????? / false)
?????????? ?????????? ???? ?????? ???????? ??????????????????? ???? ???????? ???????? ???? xreflabel?? ???? ???????? ?????????? ??????????????????? ???? title ???? role='texinfo-node' ???? ?????????????????? *info?? ???? ?????????? ?????? ?????? Texinfo ?????? ??????????????.
???? ?????? ???????? ???????? ???????? ???????????? ?????????? ??????????????? ???????? ?????? Texinfo ???? ?????????? ???????????? ?? ???????? ???????????? ?????? ????????????? ???????? ?????????? ?????????? ???????? ?????????? ???? ?????????? ???????????? ???? ????????. ?????? ???????????????? ???????? ?????? ?????????? ??????????. ?????? ?????? ?????????? ?????????? ?????? ???????? ?? ???????? ???????????? ???????? ???? ?????????? ?????? ?????????? ?????????? ???? ?????????? ???????? ????????????? ?? ?????????? ???? generate-id ???????? ?????? ?????????????? ???????????????.
???????????? ???? ???????????? ???????? ???? ???? ?????????? ???????????? ???????? ???????????? ??????????????????? ?????????? ?????? ????????????? ???? ?????????? ???????? ?? ???? ?????? ?????????? ?????????? ?????? ?????????? ?? ?????????????? ???? ??????????????? ???????? ?????? ?????????? ?????????????.
?????? ?????????? ????????????? ??????????????? ?????????? ???????? ?????? (???????? ???????????? / false ??????).
????????????? ?????????????? ?????????? ???????? ?????????? ?????? ????????????? ?????????????? ???? ???????? XSLT ???? ?????? generate-id ???????? ?? ???????? ???????????? ???? ?????? ???????? ??????????????? ???? ?????????? ???????? ???? ?????????? explicit-node-names ?????????? ???? ?????????? ???????? ?????????????.
- show-comments
- ??????????. ?????? ?????????? comment ?????????? ????????
??????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? ????????????????? ?????????? ???????? ???????????? ?????? ???? ?????? ?????? ???????? ?????????? ???????????????. ????????????????? ???? ?????????? ???? ???????? comment ?????????? ???????? ???? ???? DocBook V4.0 ???? remark ?????????? ?????? ???????? ???????? ???? ??????????????????? XML (<-- ?????????? ?????? -->) ???? ???? ?????????? ????????????.
- funcsynopsis-decoration
- ??????????. ?????? ?????????? ???? FuncSynopsis ??????????
??????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? ?????????? FuncSynopsis ?????????? ???????????? ???? (?????????? ?????????? ???? ????????). ?????????? ???????? ???????????? ?????????? ????????????? ???? ??????????????????? ???? ???? ???????? ??????????????????????? ???????????????? ????????.
- function-parens
- ??????????. ?????????? ???????????? ?????? ???? ???? ??????????
?????????? ???????????????. 0 (???????? ???????????? / false)
?????? ???????? ?????????? ??????????????????? ???????? <function> ???????? ?????????????????? ???????????????? ?????????? ??????.
- refentry-display-name
- ??????????. ?????? ?????????? NAME ?????? ???? 'RefName'????
?????????? ???????? ????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? ???? ?????????? ?????? "NAME" ?????? ???? ?????????? 'RefName'???? ?????????? ???????? ?????????????.
- manvolnum-in-xref
- ??????????. ?????? manvolnum ???? ?????????? ???????? ????
?????????? ???????????? refentry ?????????? ???????? ????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? ?????????? ?????????? ???????????? ???? refentry?????? ???? ???? xref ?? ???? ???? citerefentry?? ???? manvolnum ?????????????? ?????????????.
- prefer-textobjects
- ??????????. ?????? textobject ???? imageobject ?????????? ????????
????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? textobject ???? ???? mediaobject ???? ???? imageobject ?????????? ???????? ?????????????.
(?????????? ???????? ????????????????? ?????????? ?????? ???? Texinfo?? ?????????????? ?????????? ??????????????? ???? imageobject ?????????????? ?????????? ?????? Info ???? ???????? ????????????????? ??????.)
?????????? ???? ???????????? true ?? false?? ?????? ?????????????? ????????????????? ?????? 2 ?????? ?????????? ?????? ???? ???????? ?????? ???? ???? ?????? ?? ???? ???????????? ???????? ?????????? ???????? ????????. ???????? ?????? ?????????????? ?????? ?????? ???? ?????????? ???????? ???????? ???????? ???? ???????????????????????????????? Texinfo ??????????????????? ???????????? ???? ??????????????. ???????? ?????????? ?????????? ???? ?????????? @image ???? Texinfo ?????????????? ?????????? ???? ?????? ???? ???????? ??????????????????? ?????? ?????????? ?????? ?? ?????????? ???????? — ?????? ???? ???? ?????????? ???? ???? ?????????????? ?????????????????.
??????????????? true (????????) ??????.
- semantic-decorations
- ??????????. ?????? ???? ??????????????????????? ?????????????????
???????????? Texinfo ?????????????? ????????
?????????? ???????????????. 1 (???????? ???????? / true)
?????? ???????? ?????????? ??????????????????????? ????????????????? ???????????? DocBook ???? (?????????????????????) ?????????? Texinfo ?????????? ?????????????. ?????? ???????? ??????????????? ??????.
???? ?????? ???????? ???? ???????? ???? ???????? Info ?????????? ???? ?????? ???????? ???????? ??????????????????????? ????????????????? ???????????? ???????? ???? ?????????????? ???? ???????????????????????? ???????? ???????????? ????????????? ???? ???????? ?????? ???????? ???????? ???????????? ????????. ??????????????????? ?????? ?????????? ???? ?????? false ?????????? ???????? ???? ???? ?????? ?????????? ?????????????? ??????. (???????? ?????????? ??????????????? ???? ??????????????????? ??????????????????? ??????????????????? ???? ???????? ???????????? ?????????????? ?????? ?????????????? ????????.)
- custom-localization-file
- ??????????. ?????????? URI ?????? XML ???????? ?????????????????
??????????????????? ????????????
?????????? ???????????????. (????????)
?????? ?????????????? URI ???? ?????? XML ???? ???????? ????????????? ???? ??????????????????? ???????? (?? ???????? ?????????????? ???????????? ???? ???????????????????) ???????? ???????? ???????? ???????????? ???????? ???????????? ?????? DocBook ???? ?????????? ?????????????.
??????????????????? ???????? ???? ???????? ?????? ?????????????? ???????? ??????????????? ?????????? ???? ??????????????????? ???????? ??????????????? (???? ?????????????? ?????????? localization-file) ???????????? ??????????. ?????? ?????????? ???????? ???? ?????????? ???????? ???????????? ?????????? ???? ?????????? ??????????????? ???????????? ???? ?????????? ?????????????? ?????????????? ?????????????.
?????? ?????????????? ???????????? ???????? ?????????? ??????????????????? ???????????? ???????? ?????? ???? ???? ??????????????????? ?????? ???????? ?????????????? ???????????????. ?????????????? ??????????????????? ???????????? ???????? ???????? ?????? ???????? ???????????? ?????? ??????????????????? ???? ??????????????????? (locale) ?????? ???????????? ??????????.
???????? ?????? ?????????????? ???? ??????????????????? ???????? ?????????????? ?????? ?????????????? ???? ???? ?????????? ???????? ???????? ?????? ????????.
- custom-l10n-data
- ??????????. ?????? XML ???????? ?????????????????
??????????????????? ????????????
?????????? ???????????????. document($custom-localization-file)
?????? ?????????????? ?????? XML ???? ???????? ????????????? ???? ??????????????????? ???????? (?? ???????? ?????????????? ???????????? ???? ???????????????????) ???????? ???????? ???????? ???????????? ???????? ???????????? ?????? DocBook ???? ?????????? ?????????????.
?????? ?????????????? ???????? ???????? ???????????? ?????????? ??????. ???????? ?????????? ???? ???? ?????? XML ?????????? ???? ???? URI ???? ?????? ?????????? ???????? ????????????? ???? ???? ?????????????? custom-localization-file ?????????????? ????????.
???? ?????? ???????? ???????? ???? ???????? ???????????? ???????????? (???? ???? ???? ??????????) ?????? ?????????????? ????????????????? ?????? ?????????? XPath ???? ???????? document('') ?????????? ???????? ???? ???????? ????????????? ??????????????????? ???????????? ???? ???????????????? ???????? ???????? ???????????? ???????????? ?????????? ??????????????? ???????????? ????????.
- ??????????. ?????? othername ???? author ?????? ?????????? ????????
?????????? ???????????????. 1
?????? ???????? ?????????? othername ???? author ?????? firstname ?? surname ???????? ?????????????. ???? ?????? ?????? ?????????? othername ???????????? ?????????? ?????????????.
- output-file
- ??????????. ?????? ???????? Info
?????????? ???????????????. (????????)
?????? ?????????????? ?????? ???????? ?????????? Info ???? ???????? ????????????? ?? ?????????????? ?????????? ???? ?????? ?????? ?? ???????????? ???????????? ???? ???????? ???????????? ???? ???????????????? ?????????????. ?????? ?????? ???? set ?????????? ?????? ?????????????? ???????????? ??????????.
?????????? .info ???? ???? ?????? ???????? ??????????.
(???????? ?????????? ?????????? ???? ?????? ?????????????? ?????? ?????????????? ???? ?????? ?????????? Texi-XML ???????? ???????????????? XSLT ???? ?????? ???????? ???????????? ???? ???? ???? ???????? ??????????????? ??????????.)
- directory-category
- ??????????. ??????????????????? ?????? ???? ?????????????????? Info
?????????? ???????????????. (????????)
?????? ?????????????? ?????? ??????????????? ?????????? ????????????? ???? ?????? ???????? ???? ?????????????????? Info ????????????????? ??????????????? ?????? ???? ???????? ????????. ???????? ?????????? General Commands.
??????????????? ???????? ?????? ???????????????? ???? ?????? ???????? ?????? ?????????? ????????. ?????? ?????? ?????? ?????????????? ???????? ???????????? ?????????? ?????????????? ?????????? ???? ?????? ???????? ???? ???????????????? ?????????????.
- directory-description
- ??????????. ?????????????? ?????? ???? ?????????????????? Info
?????????? ???????????????. (????????)
?????? ???? ?????????? ?????????? ???? ?????? ?????? ???? ???? ?????????????????? Info ????????????????? ??????????????? ?????????? ???????? ?????????????. ???????? ?????????? An Interactive Plotting Program..
?????????????? ?????? ???????? ?????? ???????????????? ???? ?????? ???????? ?????? ?????????? ????????. ?????? ?????? ?????? ?????????????? ???????? ???????????? ?????????? ?????????????? ?????????? ???? ?????? ???????? ???? ???????????????? ?????????????.
- index-category
- ??????????. ?????????? Texinfo ???????? ??????????????
?????????? ???????????????. cp
?????????? Texinfo ???????? indexterm ?? index ???? ?????????????? ???? ?????????? role ???????? ?????????????. ?????? ?????????? ?????? ?????????? role ???????????? ???????????? ???? ?????????? ??????????????? ????????????????? ???????? ?????? ?????????????? ?????????????? ?????????????.
??????????????????? ???? ?????? ??????????????????? ?????????????? ????:
??????????????????? ??????????????????? ???????? ?????????? ???????? ???????????????? ?????????????????.
- qanda-defaultlabel
- ??????????. ?????????? ??????????????? defaultlabel ???? ??????
QandASet ?????????? ?????????????.
?????????? ???????????????.
?????? ?????? ?????????? defaultlabel ?????? ???? QandASet ???????? ???????? ?????????? ???? ?????? ?????????? ?????????????? ?????????????. ?????? ?????????? ???????? ?????? ???? ???????????? ???????? ???????? ?????????? defaultlabel ????????.
- qandaset-generate-toc
- ??????????. ?????? ???????? ?????????? (??????????) ????????
QandASet???? ?????????? ????????
?????????? ???????????????.
?????? ???????? ?????????? ???? ?????????? ?????????? ???????? QandASet???? ?????????? ?????????????.
??????????????? (EXAMPLES)
$ docbook2texi tdg.xml $ docbook2texi --encoding=utf-8//TRANSLIT tdg.xml $ docbook2texi --string-param semantic-decorations=0 tdg.xml .fi
???????????? ?????????? (CONVERSION PROCESS)
?????????? ???? Texinfo
???????????? 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 ?????? ???????? ?????? ??????.
?????????? ???????????? ????????????????? (Character set conversion)
?????????? ?????????? 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) ???? ????????????? ???????????? ???????????????? ????????.
??????????????? (FILES)
/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 ?????????? ?? ?????? ???????????????.
???????? (NOTES)
?????????????? docbook2man ???? docbook2texi ?????? ???????? ?????? ???? ?????? ???????? ?????????????? ???? ???????? docbook2X ?????????? ???????????????. ?????????? ???? ???? ???? ???????????? ???? ???????? ?????? ???? ???????? ??????????????????? docbook-utils ???????????? ????????.
????????????????????? (LIMITATIONS)
- •
- ???????? ?????????????? ???? ???? ???????? ???????????? ???? ??????????????????? ???????? ???????? ???? ?????? ?????? ???? ???? ???????? ?????????????. ?????? ???? ?????? ???? ?????? ???? ???????? ???? ???????? ?????????? ?????? (?????? ???? ?????????? ?????????? ?????????? ???????????? ?????????? ???? ??????????????????? ????????????)?? ???????????? ???????? ???????? ?????? ???? ???????? ???????? ???????????????? ?????????? — ???? ?????? ?????????? ?????? ???????? ?????????? docbook2X ???? ???? ???????? ?????????????? ???????? ????????.
?????????????? (AUTHOR)
Steve Cheng <stevecheng@users.sourceforge.net>.
???????????? ???????????? (SEE ALSO)
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 |