docbook2man(1) docbook2X docbook2man(1) ?????? (NAME) docbook2man - ?????????? ?????????? DocBook ???? ?????????? ???????????? (man pages) ?????????? ?????????? (SYNOPSIS) docbook2man [options] xml-document ?????????????? (DESCRIPTION) ?????????? docbook2man ?????? DocBook XML ????????????????? ???? ???? ?????????? ???????????? ?????????? ?????????????. ????????????? ????????????????? ?????????? ???????????? ???? ?????????????????? ???????? ?????????? ???????? ???????????????. ???????? ???????????? refentry ???? ?????? DocBook ?????????? ?????????????. (???????? ?????????? ???????????? ???????? ???? ???? refentry?? ??????????????????????? ??????????????????? ???????? ???????? ??????. ???????? ???????????? ???? ???????? docbook2X ???????????? ????????.) ?????????? docbook2man ???? ?????????????? ???????? (wrapper) ???????? ???? ???????????? ?????????? ????????????????????? ??????. ???????? ?????????????? ?????? ?????????????? ???????????? (CONVERSION PROCESS) ???? ???? ?????????? ????????????. ????????????????? (OPTIONS) ??????????????????? ?????????? ???????????? ???????????? ??????????????????? db2x_xsltproc(1) ?? db2x_manxml(1) ??????????. ???????? ???? ??????????????????? ???????????????? ???? ?????????? ?????????? ???????????????: --encoding=encoding ?????????????? ??????????????????? ?????????? ???? ?????????? ?????????????. --string-param parameter=value ???? ?????????????? ??????????????????? ???? ?????????? ????????????? (????????????????????? ???? ???? ???????? ?????????? ?????????? ???????????????????). ???????? ?????????????????????? ???? ??????????????? ?????????? ???????? ?????? ?????????????????????? ????????????????????? ???? ???? ?????????? ????????????. --sgml ???? ?????? ???????? SGML ???? ???? ?????? XML ???? ?????????? ?????????? ?????????????????. --solinks ?????????? ???????????? (stub) ???? ???????? ??????????????? ?????????????? ???? ???????? ?????????????? ?????????? ?????????? ?????????????. ???????????????????? ??????????????????? (STYLESHEET PARAMETERS) uppercase-headings ??????????. ????????????????? ???? ???????? ???????? ???????????? ?????????? ???????????????. 1 (???????? ??????????) ????????????????? ???? ???????????? ???????? ???????????? ???????? ???? ???????? ???????? ?????????? ???????? ???? ??????. manvolnum-cite-numeral-only ??????????. ?????????? ???? ?????? ???????? ???????????? ???????? ???????? ???? ?????? ?????????????? ?????? ?????????? ???????????????. 1 (???????? ??????????) ?????????? ?????????? ???? ???????? ?????????? ?????????????? ?????? ???????? ???????????? ???? ????????????????? ???? ?????? ?????????? ??????????????? ???? ???????? ???? ?????? ?????? ?? ???????? ?????????? ?????? ?????????? ???????? ????????????? (???????? ???????? ?????? 3x ?????????? ???? 3 ?????????????). ?????? ?????????? ?????? ???????? ?????? ???? ???????? ?????????????. quotes-on-literals ??????????. ?????????? ??????????????? ???? ?????????? ?????????? literal?? ?????????? ???????????????. 0 (???????????? ??????????) ?????? ???????? ?????????? ?????????? literal ???? ?????????? ??????????????? ???? ?????????? ??????????? ?????????? ???????? ???????????????. show-comments ??????????. ?????????? ?????????? comment?? ?????????? ???????????????. 1 (???????? ??????????) ?????? ???????? ?????????? ?????????????? ?????????? ???????? ????????????????? ???? ?????? ?????? ???????? ?????????? ?????????????????. ?????????????? ???? ?????????? ???? ???????? comment ?????????? ?????????? ???? ???? DocBook V4.0 ???? remark ?????????? ?????? ????????????????? ???? ?????????????? XML (<-- ?????????? ?????? -->) ???? ???? ?????????? ????????????. function-parens ??????????. ?????? ???????????? ???? ???? ?????? ?????????? ?????????? ???????????????. 0 (???????????? ??????????) ?????? ???????? ?????????? ??????????????????? ???? ???????? ???????? ???????????? ???????????????? ?????????? ??????. xref-on-link ??????????. ?????? link ???????? ???? ?????????? ???????????? ?????????? ???????? ?????????? ???????????????. 1 (???????? ??????????) ?????????? ???????????? ???????? ???? ?????????? ???????????????? ?????????????? ???????????????? ???????? link ????????????. ?????? ?????? ?????????? ???????? ?????????? ??????????????????? ???? ?????????? ???????????? ???? ???????? ?????????? ?????????? ?????????????. (?????? ?????? ???????? ?????? ?????????? ?????? ???? ???????? ??????). ???? ?????? ?????? ?????????? ???????? ???????????? link ?????????? ???????? ?????? ?? ?????? ?????????? ???????????? ?????????? ?????????????. header-3 ??????????. ?????? ?????????? ?????? ?????????? ???????????????. (????????) ?????? ?????????? ?????? ???????? ???????????? ???? ?????????? ??????????????? ???? ?????????????? ?????????? ???????? ???????????? ??????. ???? ???????? ???????? ?????????? ???????????? date ?????????? ???? refentry ?????????????? ?????????????. header-4 ??????????. ?????? ?????????? ?????????? ?????????? ???????????????. (????????) ?????? ?????????? ?????????? ???? ???????? ???????????? ???? ???????? ?????????????. ???? ???????? ???????? ?????????? ???????????? refmiscinfo ?????????? ???? refentry ?????????????? ?????????????. header-5 ??????????. ?????? ?????????? ???????? ?????????? ???????????????. (????????) ?????? ?????????? ???????? ???? ???????? ???????????? ???? ???????? ?????????????. ???? ???????? ???????? ?????????? ???????? ???????????????? ???????? ?????????? ?????? ????????????????????? book ???? reference ?????????????? ?????????????. default-manpage-section ??????????. ?????? ??????????????? ???????? ???????????? ?????????? ???????????????. 1 ?????? ???????? ?????????????? ???????? ????????????? ???? ???? ???????? ???????????? ???????? ???? ???? ???????? ???????? ?????????? ???????? (???? manvolnum ???? refmeta). ???? ?????????? ???? ?????? ???????? ??????????????? ???????? ???????????? ???? ???????? ?????????? ?????????? ?????? ?????????? ?????????? ??????????????? ???? ?????????? ?????????????. 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('')?? ???? ???????? ????????????? ??????????????????? ???????????? ???? ???????????????? ???????? ??????????????????? ???????????? ?????????? ??????????????? ???????????? ????????. author-othername-in-middle ??????????. ?????? othername ???? author ?????? ?????????? ???????? ?????????? ???????????????. 1 ?????? ???????? ?????????? othername ???? author ?????? firstname ?? surname ???????? ?????????????. ???? ?????? ?????? ?????????? othername ?????????? ???????????????. ??????????????? (EXAMPLES) $ docbook2man --solinks manpages.xml $ docbook2man --solinks --encoding=utf-8//TRANSLIT manpages.xml $ docbook2man --string-param header-4="Free Recode 3.6" document.xml .fi ???????????? ?????????? (CONVERSION PROCESS) ?????????? ???? ?????????? ???????????? ?????????? DocBook ???? ???? ?????????? ???? ?????????? ???????????? ?????????? ???????????????: 1. ???????? DocBook ???????? ???? ??????????????????? XSLT ???? ???? ???????? XML ???????????? ???????? Man-XML?? ?????????? ?????????????. ???????? Man-XML ??????????????? ???? DocBook ?? ????????????????? ???? ???????? ?????????? ???????????? ???????? ?????? ???? ???? ??????????????? ???????? ?????????? ?????????????????????????? ??????. ??????????????????? ?????????? ???? ?????? ?????? ???? xslt/man/docbook.xsl ???????? ????????. ???? ?????????? ?????????????? ?? ????????????????????? ?????????? ???????? ???? ?????????????? ???? ?????????? URI ?????? ???? ???? ?????????? ???????? ??????: http://docbook2x.sourceforge.net/latest/xslt/man/docbook.xsl ?????? ??????????????????? ???? ???? db2x_xsltproc(1) ???????? ????????. ???????????????????????. ???????????? ??????????????????? ?????????? ???? ???? ?????????? ??????????????????? XSLT ?????????????? ?????? -- ?????????? ?????????????????? ???? ???????????? ?????????????? ???????? -- ?? ???????? ???????? (import) xslt/man/docbook.xsl ??????????????????????? ????????. 2. ?????? Man-XML ???????? db2x_manxml(1) ???? ?????????? ?????????????? ?????????? ?????????? ?????????????. ?????????? docbook2man ???? ???? ?????????? ???? ????????????? ???????????? ?????????? ??????????????? ?????? ???? ???????? ???????? ???????????? ?????????? ?????? ???? ?????????? ???? ?????????????? ?????????? ?????????? ??????????????????? ?????????? ???? ??????????????? ???????????? ????????: $ db2x_xsltproc -s man mydoc.xml -o mydoc.mxml $ db2x_manxml mydoc.mxml .fi ??????????????????? ?????????? ???? ??????????????????? ?????????? ???? ???????? ???????????????????????????? ?????????? ???????????? ?????????? ???????? ?????? ??????. ?????????? ???????? ???? XSLT. ???? ?????????????? ???????? ?????????????? ?????? db2x_manxml?? ??????????????????? XSLT ???? xslt/backend/db2x_manxml.xsl ??????. ?????? ??????????????????? ???????????? ???????????? ???????? ?????????? Man-XML ???? ?????????? ?????????????? ?????????? ?????????? ?????????????. ?????? ????????????? ?????????? ?????????? ???? XSLT ???? ???????? ?????????? ?????????? ???????????? ?????????? ????????????????? ???????? ??????. ???????????? ?????????? ?????????? ???? ?????? ??????????????????? ??????????????? ???? ???????? ?????????????? ?????? db2x_manxml ???????????? ?????? ?? ?????????? ???????? ?????????????. ????????????????? ???????? ???????? XSLT ???? ?????? ???????? ???? ??????????????? ???? ?????????? ???????????? ???????????????? ????????????????? ???? ???????? ???? ?????????? ?????? ???? ???????????????? ?????????????. ?????????? ???????????? ????????????????? ?????????? ?????????? XML ???? ????????????????? ?????????? ?????????? ???? ASCII ???? ???????????????? ???????? ???? ???????????? (?????????? ?????????? ???????????? ?? Texinfo)?? ???????????? ?????? ???????? ???????? ???????? ???? ??????????????????? ???????????? ?????????? ???? ?????? ???????? ?????? ???????? ???? ???????? ?????????? ????????. ???? ?????????? ???????? ???????????? ????????????????? ???? ???????????? ???????? ?????????? ???????? ???????????? ??????????????????? ?????????? ???? ?????????????? US-ASCII ???? ISO Latin-1 ???????? ???????? ??????????????????? ?????????? ?????????? ???? ???????? (dash) ?? ??????????????????? ??????????????? ??????????????? ???? ????????????? ???????????? ???? ?????????? XML ???? ?????? ??????????????? ????????????. ?????? ??????????????????????? ?????????? (man ?? Texinfo) ?????????? ??????????????? ???????? ????????????????????? ???? ???? ???????????? ???????? (markup escape) ???????? ????????: ???????? ?????????? \(lq ???????? ??????????????? ??????????????? ???? ". ?? ?????? ???????? ???? ?????? ??????????????????????? ???? ?????????? ???????????? ???????? ?????? ????????????????????????? (transliteration) ???????? ?????????????? ??????: ???????? ?????????? ?????????????? ???? ?????????? ?????????????? ???? ???????? < ???????? ??????????????? ????????????????? <. ???????????????? ???????? ??????????????????? ???????????? ???? ??????????????? ???? ???? ?????????? ???? ??????: 1. ???????????? utf8trans(1)?? ??????????????????????? ???? docbook2X?? ??????????????????? ???????????? ???? ???? ????????????????????? ???????? ???? ?????? ??????????????????????? ???? ????????????????????????? ?????????? ?????????????. ???? ???????? ???? ???????????? ?????????? ???????? ?? ???????? ???????? ??????????????????? ???????????? ???????? ???????????? utf8trans ????????????????? ??????????????????? ????????????????? ???????? ?????????? ???????? ?????????? ???? ???? ????????????????????? ???????? ???????? ??????????????? ???? ???????????? ?? ?????????? ?????? (???????????? ???????? ????????????????? ???????????? ?????????????????). ???? charmaps/man/roff.charmap ?? charmaps/man/texi.charmap ??????????????????? ????????????????? ???????? ?????????? ???? ??????????????????? ???????? ?????????? ?????????? ???????????? ?? Texinfo ?????????????? ????????. ????????????????????? db2x_manxml(1) ?? db2x_texixml(1) ?????? ??????????????????? ??????????????????? ???? ?????????? ????????????????? ?????????? ???? ???? ?????????? ???????? ???????? ???????? ????????????? ???????????? ?????????? ???????????? ??????. 2. ???????? ?????? ???????????? ???? ???? ???????????? ?????????? (??????????????) ???????? ?????????? ?????????????. ???????? ?????????? ???? ?????? ?????????????? ???? ??????????????????? ?????????? ?????????? (?????????? e) ???????? ?????? ???? ISO Latin 1 ?????????? ??????. ?????? ?????????? ???? ???? ?????????? ????????????????? utf8trans ???? ?????????????? ???? ?????????? ?????????? ?????????????? iconv(1) ?????????? ?????????????. ???? ???? ???????????? db2x_manxml(1) ?? db2x_texixml(1) ??????????????????? ?????????? ?????????? ?????????? ???????? iconv(1) ???? ????????????? ???????????? ???????????????? ????????. ??????????????? (FILES) /usr/local/share/docbook2X/xslt/man/docbook.xsl /usr/local/share/docbook2X/xslt/backend/db2x_manxml.xsl /usr/local/share/docbook2X/xslt/catalog.xml /usr/local/share/docbook2X/charmaps/roff.charmap /usr/local/share/docbook2X/charmaps/roff.charmap.xml ????????????????????? ?????? ???????? ???????? docbook2X ?????????? ?? ?????? ???????????????. ???????? (NOTES) ?????????? docbook2man ???? docbook2texi ?????? ????????????????? ???? ?????? ???????? ???????????? ???? ???????? docbook2X ???????????????. ?????? ?????????? ???? ?????????? ???? ???????????? ???? ???????? ?????? ???? ???????? ?????????? ?? ??????????????????? docbook-utils ???????????? ????????. ????????????????????? (LIMITATIONS) o ???? ???????? ?????????????? ???? ???? ???????? ???????????? ???? ??????????????????? ???????? ???????? ???? ?????? ?????? ???? ???? ???????? ?????????????. ?????? ???? ???????? ???? ?????? ???? ???????? ???? ???????? ?????????? ?????? (?????? ???? ?????? ?????????? ?????????? ???????? ???????????? ??????????????????? ????????????)?? ?????? ?????? ???????????? ???????? ???????? ?????? ?????????? ???????? -- ???? ?????? ?????????? ?????? ???????? ??????????????? docbook2X ???? ??????????????? ?????????????? ???????? ????????. ?????????????? (AUTHOR) Steve Cheng . ???????????? ???????????? (SEE ALSO) db2x_xsltproc(1), db2x_manxml(1), utf8trans(1) ?????????????? docbook2X (???? ???????? Texinfo ???? HTML) ???????????? ?????????? DocBook ???? ?????????? ???????????? ?? Texinfo ???? ????????????? ???????? ?????? ?????????????. ?????????????? ????????????? ???????????? ?????? ???????????? ???? ??????????????? ?????? ???????? ???????????? ??????: ??????????????? docbook2X . docbook2X 0.8.8 3 March 2007 docbook2man(1)