다음 도구는 문서를 처리하는 데 사용됩니다. 언급했듯이 일부는 선택 사항 일 수 있습니다.
이것은 문서 자체의 정의입니다. 우리는 현재 버전 4.2를 사용하고 있습니다.SGMLand theXML같은 버전의 Docbook DTD의 변형. 이들은 일반적으로 별도의 패키지에 있습니다.
DocBook SGML에 의해 요구되지만 ISO에 의해 유지되기 때문에 별도로 배포됩니다.
여기에는 토토 결과 소스를 다른 형식으로 변환하기위한 처리 지침이 포함되어 있습니다.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 Docbook-DTDS Docbook-Style-XSL FOP Libxslt Opensp 설치
FreeBSD 토토 결과 프로젝트 자체는 DocBook의 무거운 사용자이므로 전체 세트가 있다는 것은 놀라운 일이 아닙니다.“포트”freebsd에서 사용할 수있는 문서 도구. freebsd에 문서를 작성하려면 다음 포트를 설치해야합니다.
TextProc/DocBook-SGML
TextProc/DocBook-XML
TextProc/DocBook-XSL
TextProc/dsssl-docbook-modular
TextProc/libxslt
TextProc/fop
TextProc/Opensp
필요한 패키지를 설치하려면PKG, 사용 :
PKG DocBook-SGML DocBook-XML DocBook-XSL FOP Libxslt Opensp 설치
doc사용해야 할 디렉토리gmake.만들기.
FreeBSD 문서 도구에 대한 자세한 내용은에서 찾을 수 있습니다.FreeBSD 토토 결과 프로젝트 지침.
토토 결과 도구의 전체 패키지 세트가 있습니다.Debian GNU/Linux. 설치하려면 간단히 사용하십시오 :
apt-get Docbook-xml Docbook-XSL FOP libxml2-utils Opensp XSLTPROC
Macports를 사용하면 다음을 설정할 수 있습니다.
Sudo Port 설치 DocBook-SGML-4.2 DocBook-XML-4.2 DocBook-XSL FOP Libxslt Opensp
Docbook 도구의 수동 설치 프로세스는 다소 복잡하므로 사전 제작 된 패키지가있는 경우 사용하십시오. 여기서는 표준 설치 경로가있는 표준 설정 만 설명합니다.“공상”기능. 자세한 내용은 해당 패키지의 문서를 연구하고 읽어야합니다SGML입문 자료.
OpenSP의 설치는 GNU 스타일을 제공합니다./configure; 만들다;빌드 프로세스. 세부 사항은 OpenSP 소스 배포에서 찾을 수 있습니다.
./configure-enable-default-catalog =/usr/local/etc/sgml/catalog만들다
당신이 어디에 넣었는지 기억하십시오“기본 카탈로그”; 아래에서 필요합니다.SGML_CATALOG_FILES나중에 OpenSP의 프로그램을 사용할 때마다 파일을 가리 키십시오. (이 방법은 OpenSP가 이미 설치되어 있고 나머지 도구 체인을 로컬로 설치하려는 경우 옵션이기도합니다.)
디렉토리 만들기/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 캐릭터 엔티티 아카이브, 포장을 풀고 파일을 동일한 디렉토리에 넣고 토토 결과 파일을 넣습니다.
$cd /usr/local/share/sgml/docbook-4.2$unzip ...../isoents.zip
Docbook 및 ISO 파일을 사용하여 디렉토리에서 다음 명령을 실행합니다.
perl -pi -e 's/iso- (.*). gml/iso \ 1/g'docbook.cat
(이것은 토토 결과 카탈로그 파일에 사용 된 이름과 ISO 문자 엔티티 파일의 실제 이름 사이의 믹스 업을 수정합니다.)
구성토토 결과를 작성하기 전에를 실행해야합니다.구성만들 때와 마찬가지로 스크립트토토 결과프로그램 자체. 달리기가 끝날 때 출력을 확인하십시오.
ONSGMLS 확인 ... ONSGMLSDocbook v4.2 확인 ... 예그렇지 않은 경우ONSGMLSNORNSGMLS발견되었습니다. 다음 테스트 중 일부가 건너 뛸 것입니다.NSGMLSOpenSP 패키지의 일부입니다. 환경 변수를 통과 할 수 있습니다NSGMLS프로그램이 자동으로 찾을 수없는 경우 프로그램을 가리키도록 구성합니다. 만약에“Docbook v4.2”찾을 수 없었습니다. 그렇다면 OpenSP가 찾을 수있는 장소에 DocBook DTD 키트를 설치하지 않았거나 카탈로그 파일을 올바르게 설정하지 않았습니다. 위의 설치 힌트를 참조하십시오.