???????????????????? ??????????????????? (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 (???????????? ??????????)

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

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 ?????????? ???????????????.

?????????? ???? ?????????? ????????????

?????????? 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.

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

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