J.2. ÐнÑÑÑÑменÑаÑий #
ÐÐ»Ñ Ð¾Ð±ÑабоÑки докÑменÑаÑии пÑименÑÑÑÑÑ ÑледÑÑÑие ÑÑедÑÑва. ÐекоÑоÑÑе из Ð½Ð¸Ñ Ð¼Ð¾Ð³ÑÑ Ð±ÑÑÑ Ð½ÐµÐ¾Ð±ÑзаÑелÑнÑми, как оÑмеÑено ниже.
- DTD Ð´Ð»Ñ DocBook #
ÐÑо полное опÑеделение Ñамого ÑоÑмаÑа DocBook. РнаÑÑоÑÑее вÑÐµÐ¼Ñ Ð¼Ñ Ð¿ÑименÑем веÑÑÐ¸Ñ 4.5; более ÑаннÑÑ Ð¸Ð»Ð¸ более позднÑÑ Ð²ÐµÑÑÐ¸Ñ Ð½Ðµ подойдÑÑ. ÐÑполÑзоваÑÑ Ð½Ñжно XML-ваÑиаÑÐ¸Ñ Ð¾Ð¿ÑÐµÐ´ÐµÐ»ÐµÐ½Ð¸Ñ DocBook DTD (не SGML).
- ТаблиÑÑ ÑÑилей DocBook XSL #
Ðни ÑодеÑÐ¶Ð°Ñ Ð¸Ð½ÑÑÑÑкÑии обÑабоÑки Ð´Ð»Ñ Ð¿ÑеобÑÐ°Ð·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¸ÑÑ Ð¾Ð´Ð½ÑÑ Ð¼Ð°ÑеÑиалов DocBook в дÑÑгие ÑоÑмаÑÑ, напÑимеÑ, в HTML.
Ðа даннÑй Ð¼Ð¾Ð¼ÐµÐ½Ñ ÑÑебÑеÑÑÑ Ð²ÐµÑÑÐ¸Ñ ÐºÐ°Ðº минимÑм 1.77.0, но Ð´Ð»Ñ Ð»ÑÑÑего ÑезÑлÑÑаÑа ÑекомендÑеÑÑÑ Ð¸ÑполÑзоваÑÑ Ð¿Ð¾ÑледнÑÑ Ð´Ð¾ÑÑÑпнÑÑ Ð²ÐµÑÑиÑ.
- Libxml2 длÑ
xmllint# ÐÑа библиоÑека и вклÑÑÑÐ½Ð½Ð°Ñ Ð² Ð½ÐµÑ ÑÑилиÑа
xmllintпÑименÑÑÑÑÑ Ð´Ð»Ñ Ð¾Ð±ÑабоÑки XML. У Ð¼Ð½Ð¾Ð³Ð¸Ñ ÑазÑабоÑÑиков библиоÑека Libxml2 Ñже ÑÑÑановлена, поÑÐ¾Ð¼Ñ ÑÑо она Ñакже иÑполÑзÑÑÑÑÑ Ð¿Ñи ÑбоÑке кода PostgreSQL. ÐамеÑÑÑе, однако, ÑÑоxmllintÐ¼Ð¾Ð¶ÐµÑ Ð¿Ð¾ÑÑебоваÑÑÑÑ ÑÑÑановиÑÑ Ð¸Ð· оÑделÑного пакеÑа.- Libxslt длÑ
xsltproc# xsltprocâ пÑоÑеÑÑÐ¾Ñ XSLT, Ñо еÑÑÑ Ð¿ÑогÑамма, пÑеобÑазÑÑÑÐ°Ñ XML в дÑÑгие ÑоÑмаÑÑ Ñ Ð¿Ñименением ÑÐ°Ð±Ð»Ð¸Ñ ÑÑилей XSLT.- FOP #
ÐÑо пÑогÑамма Ð´Ð»Ñ Ð¿ÑеобÑазованиÑ, в Ñом ÑиÑле и XML в PDF. Ðна ÑÑебÑеÑÑÑ ÑолÑко Ð´Ð»Ñ ÑбоÑки докÑменÑаÑии в ÑоÑмаÑе PDF.
Ðиже Ð¼Ñ Ð¾Ð¿Ð¸Ñем ÑазлиÑнÑе ваÑианÑÑ ÑÑÑановки пÑогÑаммного обеÑпеÑениÑ, Ð½ÐµÐ¾Ð±Ñ Ð¾Ð´Ð¸Ð¼Ð¾Ð³Ð¾ Ð´Ð»Ñ Ð¾Ð±ÑабоÑки докÑменÑаÑии. ÐÑи пÑогÑÐ°Ð¼Ð¼Ñ Ð¼Ð¾Ð³ÑÑ ÑаÑпÑоÑÑÑанÑÑÑÑÑ Ð¸ в дÑÑÐ³Ð¸Ñ Ð¿Ð°ÐºÐµÑÐ°Ñ . ÐожалÑйÑÑа, ÑообÑиÑе о ÑоÑÑоÑнии конкÑеÑного пакеÑа в ÑпиÑок ÑаÑÑÑлки, поÑвÑÑÑннÑй докÑменÑаÑии, и Ð¼Ñ Ð´Ð¾Ð±Ð°Ð²Ð¸Ð¼ ÑÑÑ Ð¸Ð½ÑоÑмаÑÐ¸Ñ ÑÑда.
J.2.1. УÑÑановка в Fedora, RHEL и пÑоизводнÑÑ ÑиÑÑÐµÐ¼Ð°Ñ #
ЧÑÐ¾Ð±Ñ ÑÑÑановиÑÑ ÑÑебÑемÑе пакеÑÑ, вÑполниÑе:
yum install docbook-dtds docbook-style-xsl libxslt fop
J.2.2. УÑÑановка во FreeBSD #
ЧÑÐ¾Ð±Ñ ÑÑÑановиÑÑ ÑÑебÑемÑе пакеÑÑ, иÑполÑзÑÑ pkg, вÑполниÑе:
pkg install docbook-xml docbook-xsl libxslt fop
СобиÑÐ°Ñ Ð´Ð¾ÐºÑменÑаÑÐ¸Ñ Ð¸Ð· каÑалога doc, Ð²Ñ Ð´Ð¾Ð»Ð¶Ð½Ñ Ð¿ÑименÑÑÑ gmake, Ñак как ÑÑÑеÑÑвÑÑÑий Makefile не подÑ
Ð¾Ð´Ð¸Ñ Ð´Ð»Ñ make, имеÑÑегоÑÑ Ð²Ð¾ FreeBSD.
J.2.3. ÐакеÑÑ Debian #
ÐÐ»Ñ Debian GNU/Linux имееÑÑÑ Ð¿Ð¾Ð»Ð½Ñй Ð½Ð°Ð±Ð¾Ñ Ð¿Ð°ÐºÐµÑов инÑÑÑÑменÑаÑÐ¸Ñ ÑбоÑки докÑменÑаÑии. ЧÑÐ¾Ð±Ñ ÑÑÑановиÑÑ Ð¸Ñ , пÑоÑÑо вÑполниÑе:
apt-get install docbook-xml docbook-xsl libxml2-utils xsltproc fop
J.2.4. macOS #
ÐÑли Ð²Ñ Ð¸ÑполÑзÑеÑе ÑиÑÑÐµÐ¼Ñ MacPorts, Ð²Ñ Ð¼Ð¾Ð¶ÐµÑе полÑÑиÑÑ Ð²ÑÑ Ð½ÐµÐ¾Ð±Ñ Ð¾Ð´Ð¸Ð¼Ð¾Ðµ Ñак:
sudo port install docbook-xml docbook-xsl-nons libxslt fop
ÐÑли Ð²Ñ Ð¸ÑполÑзÑеÑе Homebrew, вÑполниÑе:
brew install docbook docbook-xsl libxslt fop
ÐÐ»Ñ Ð¿ÑогÑамм, ÑÑÑанавливаемÑÑ Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Homebrew, ÑÑебÑеÑÑÑ ÑÑÑановиÑÑ ÑледÑÑÑÑÑ Ð¿ÐµÑеменнÑÑ ÑÑедÑ. ÐÐ»Ñ ÐºÐ¾Ð¼Ð¿ÑÑÑеÑов на базе Intel:
export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
ÐÐ»Ñ ÐºÐ¾Ð¼Ð¿ÑÑÑеÑов на базе Apple Silicon:
export XML_CATALOG_FILES=/opt/homebrew/etc/xml/catalog
Ðез ÑÑой пеÑеменной xsltproc бÑÐ´ÐµÑ Ð²ÑдаваÑÑ Ñакие оÑибки:
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd postgres.sgml:21: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" ...
ХоÑÑ Ð¼Ð¾Ð¶Ð½Ð¾ иÑполÑзоваÑÑ Ð²ÐµÑÑии xmllint и xsltproc Ð¾Ñ Apple вмеÑÑо веÑÑий Ð¾Ñ MacPorts или Homebrew, вам вÑÑ Ñавно поÑÑебÑеÑÑÑ ÑÑÑановиÑÑ DocBook DTD и ÑÑили, а Ñакже наÑÑÑоиÑÑ Ñайл каÑалога, коÑоÑÑй бÑÐ´ÐµÑ Ð½Ð° ниÑ
ÑказÑваÑÑ.
J.2.5. ÐÑовеÑка ÑÑловий configure #
ÐÑежде Ñем Ð²Ñ ÑможеÑе ÑобÑаÑÑ Ð´Ð¾ÐºÑменÑаÑиÑ, Ð²Ñ Ð´Ð¾Ð»Ð¶Ð½Ñ Ð·Ð°Ð¿ÑÑÑиÑÑ ÑкÑÐ¸Ð¿Ñ configure Ñак же, как ÑÑо нÑжно ÑделаÑÑ Ð´Ð»Ñ ÑбоÑки пÑогÑаммной ÑаÑÑи PostgreSQL. ÐбÑаÑиÑе внимание на ÑообÑениÑ, вÑводимÑе ближе к конÑÑ. ÐÑ Ð´Ð¾Ð»Ð¶Ð½Ñ ÑвидеÑÑ Ð¿ÑимеÑно ÑледÑÑÑее:
checking for xmllint... xmllint checking for xsltproc... xsltproc checking for fop... fop checking for dbtoepub... dbtoepub
ÐÑли пÑогÑамма xmllint или xsltproc не бÑÐ´ÐµÑ Ð¾Ð±Ð½Ð°ÑÑжена, Ð²Ñ Ð½Ðµ ÑможеÑе ÑобÑаÑÑ Ð´Ð¾ÐºÑменÑаÑÐ¸Ñ Ð² каком-либо виде. ÐÑогÑамма fop ÑÑебÑеÑÑÑ ÑолÑко Ð´Ð»Ñ ÑбоÑки докÑменÑаÑии в ÑоÑмаÑе PDF, а dbtoepub нÑжна ÑолÑко Ð´Ð»Ñ ÑоÑмаÑа EPUB.
ÐÑи необÑ
одимоÑÑи Ð²Ñ Ð¼Ð¾Ð¶ÐµÑе ÑказаÑÑ configure, где наÑ
одÑÑÑÑ ÑÑи пÑогÑаммÑ, напÑÐ¸Ð¼ÐµÑ Ñак:
./configure ... XMLLINT=/opt/local/bin/xmllint ...
ÐÑли Ð²Ñ Ð¿ÑедпоÑиÑаеÑе ÑобиÑаÑÑ PostgreSQL Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Meson, вмеÑÑо ÑÑого запÑÑÑиÑе meson setup, как опиÑано в Разделе 17.4, а заÑем обÑаÑиÑеÑÑ Ðº РазделÑ J.4.