다음 도구는 토토 결과를 처리하는 데 사용됩니다. 명시된 대로 일부는 선택 사항일 수 있습니다.
이것이 DocBook 자체의 정의입니다. 현재 버전 4.2를 사용하고 있습니다. 이후 버전이나 이전 버전은 사용할 수 없습니다. 당신은SGML그리고XML동일 버전의 DocBook DTD 변형입니다. 일반적으로 별도의 패키지로 제공됩니다.
이것들은 DocBook SGML에 필요하지만 ISO에 의해 유지관리되기 때문에 별도로 배포됩니다.
이에는 DocBook 소스를 다음과 같은 다른 형식으로 변환하기 위한 처리 지침이 포함되어 있습니다.HTML.
최소 필수 버전은 현재 1.77.0이지만 최상의 결과를 위해서는 사용 가능한 최신 버전을 사용하는 것이 좋습니다.
이것은 기본 패키지입니다SGML처리 중. 더 이상 OpenJade가 필요하지 않습니다.DSSSL프로세서, SGML을 XML로 변환하기 위한 OpenSP 패키지만.
xmllint이 라이브러리와xmllint포함된 도구는 XML 처리에 사용됩니다. 많은 개발자들이 이미 가지고 있을 것입니다.Libxml2설치되었습니다. 토토 결과 코드를 빌드할 때도 사용되기 때문입니다. 그러나 참고하세요.xmllint별도의 하위 패키지에서 설치해야 할 수도 있습니다.
xsltprocxsltprocXSLT 프로세서, 즉 XSLT 스타일시트를 사용하여 XML을 다른 형식으로 변환하는 프로그램입니다.
이것은 무엇보다도 XML을 PDF로 변환하는 프로그램입니다.
우리는 토토 결과를 처리하는 데 필요한 다양한 도구에 대한 여러 설치 방법에 대한 경험을 토토 결과화했습니다. 이에 대해서는 아래에서 설명하겠습니다. 이러한 도구에 대한 다른 패키지 배포판이 있을 수 있습니다. 토토 결과 메일링 리스트에 패키지 상태를 보고해 주시면 여기에 해당 정보를 포함하겠습니다.
필요한 파일이 인터넷에서 다운로드되어 로컬에 캐시되기 때문에 DocBook XML 및 DocBook XSLT 스타일시트를 로컬에 설치하지 않아도 됩니다. 이는 실제로 운영 체제 패키지가 특히 스타일시트의 이전 버전만 제공하거나 패키지를 전혀 사용할 수 없는 경우 선호되는 솔루션일 수 있습니다. 참조--nonet옵션xmllint그리고xsltproc더 많은 정보를 원하시면.
필요한 패키지를 설치하려면 다음을 사용하십시오:
yum install docbook-dtds docbook-style-xsl fop libxslt opensp
FreeBSD 토토 결과화 프로젝트 자체는 DocBook의 많은 사용자이므로 전체 세트가 있다는 것은 놀라운 일이 아닙니다.“포트”15218_15349
textproc/docbook-sgml
textproc/docbook-xml
textproc/docbook-xsl
textproc/dsssl-docbook-modular
textproc/libxslt
textproc/fop
textproc/opensp
필수 패키지를 설치하려면pkg, 사용:
pkg install docbook-sgml docbook-xml docbook-xsl fop libxslt opensp
토토 결과를 작성할 때토토 결과사용해야 할 디렉토리gmake, 제공된 makefile이 FreeBSD에 적합하지 않기 때문입니다.만들다.
FreeBSD 토토 결과 도구에 대한 자세한 내용은 다음에서 찾을 수 있습니다.FreeBSD 토토 결과 프로젝트 지침.
다음에 사용할 수 있는 토토 결과 도구의 전체 패키지 세트가 있습니다.데비안 GNU/리눅스. 설치하려면 다음을 사용하세요.
apt-get 설치 docbook docbook-xml docbook-xsl fop libxml2-utils opensp xsltproc
MacPorts를 사용하는 경우 다음을 설정해야 합니다:
sudo 포트 설치 docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl fop libxslt opensp
DocBook 도구의 수동 설치 과정은 다소 복잡하므로 사전 빌드된 패키지가 있는 경우 이를 사용하십시오. 여기서는 합리적인 표준 설치 경로가 포함된 표준 설정에 대해서만 설명합니다.“멋진”기능. 자세한 내용은 해당 패키지의 토토 결과를 연구하고 읽어보세요.SGML소개 자료.
OpenSP 설치는 GNU 스타일을 제공합니다../구성; 만들다; 설치하다빌드 프로세스. 자세한 내용은 OpenSP 소스 배포판에서 확인할 수 있습니다. 간단히 말해서:
./configure --enable-default-catalog=/usr/local/etc/sgml/catalog 만들다 설치하다
당신이 어디에 두었는지 기억하십시오“기본 카탈로그”; 아래에서 필요합니다. 그대로 둘 수도 있지만 환경 변수를 설정해야 합니다.SGML_CATALOG_FILES나중에 OpenSP의 프로그램을 사용할 때마다 파일을 가리킵니다. (이 방법은 OpenSP가 이미 설치되어 있고 나머지 툴체인을 로컬에 설치하려는 경우에도 사용할 수 있는 옵션입니다.)
얻으십시오DocBook V4.2 배포.
디렉토리 생성/usr/local/share/sgml/docbook-4.2그리고 그것을 변경하세요. (정확한 위치는 관련이 없지만 여기에서 따르는 레이아웃 내에서는 이 위치가 합리적입니다.)
$mkdir /usr/local/share/sgml/docbook-4.2$cd /usr/local/share/sgml/docbook-4.2
아카이브 압축 풀기:
$unzip -a ...../docbook-4.2.zip
(아카이브는 현재 디렉토리에 파일의 압축을 풉니다.)
파일 편집/usr/local/share/sgml/catalog(또는 설치 중에 jade에게 말한 내용) 다음과 같은 줄을 입력하세요.
카탈로그 "docbook-4.2/docbook.cat"
다운로드ISO 8879 문자 엔터티 아카이브, 압축을 풀고 DocBook 파일을 넣은 동일한 디렉토리에 파일을 넣습니다.
$cd /usr/local/share/sgml/docbook-4.2$압축 해제 ...../ISOEnts.zip
DocBook 및 ISO 파일이 있는 디렉토리에서 다음 명령을 실행하십시오:
perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat
(이것은 DocBook 카탈로그 파일에 사용된 이름과 ISO 문자 엔터티 파일의 실제 이름 사이의 혼동을 수정합니다.)
구성토토 결과를 작성하기 전에 다음을 실행해야 합니다.구성빌드할 때와 같은 스크립트포스트그레SQL스스로 프로그램합니다. 실행이 끝날 무렵 출력을 확인하면 다음과 같아야 합니다.
onsgmls 확인 중... onsgmls
DocBook V4.2를 확인 중입니다... 예
dbtoepub을 확인하는 중... dbtoepub
xmllint를 확인하는 중... xmllint
xsltproc를 확인하는 중... xsltproc
osx를 확인하는 중... osx
fop 확인 중... fop둘 다 아니라면onsgmls아니요nsgmls발견되면 다음 테스트 중 일부를 건너뜁니다.nsgmls은 OpenSP 패키지의 일부입니다. 환경 변수를 전달할 수 있습니다.NSGMLS프로그램이 자동으로 발견되지 않으면 해당 프로그램을 가리키도록 구성합니다. 만일“DocBook V4.2”찾을 수 없는 경우 OpenSP가 찾을 수 있는 위치에 DocBook DTD 키트를 설치하지 않았거나 카탈로그 파일을 올바르게 설정하지 않은 것입니다. 위의 설치 힌트를 참조하세요.