다음 젠 토토는 문서를 처리하는 데 사용됩니다. 명시된 대로 일부는 선택 사항일 수 있습니다.
이것이 DocBook 자체의 정의입니다. 우리는 현재 버전 4.2를 사용하십시오. 이후 버전이나 이전 버전은 사용할 수 없습니다. 다음도 있습니다.XMLDocBook 버전 — 사용하지 마세요 그거.
이것들은 DocBook에 필요하지만 배포됩니다 ISO에서 관리하기 때문에 별도로 관리됩니다.
이것은 기본 패키지입니다SGML처리 중. 여기에는가 포함되어 있습니다.SGML파서, aDSSSL프로세서(이 변환하는 프로그램입니다SGML다음을 사용하여 다른 형식으로DSSSL스타일시트), 다양한 관련 젠 토토도 포함됩니다.제이드이제 관리되고 있습니다. OpenJade 그룹은 더 이상 James Clark이 아닙니다.
여기에는 변환을 위한 처리 지침이 포함되어 있습니다. DocBook 소스를 다음과 같은 다른 형식으로 변환합니다.HTML.
이 선택적 패키지는 매뉴얼 페이지를 생성하는 데 사용됩니다. 그것 자체적으로 여러 가지 필수 구성 요소 패키지가 있습니다. 확인해보세요 웹사이트.
원하시면 설치할 수도 있습니다.JadeTeX사용하다TeX다음에 대한 형식 지정 백엔드로제이드. JadeTeX포스트스크립트를 생성할 수 있거나PDF파일(후자 북마크 포함).
그러나 다음의 출력은JadeTeX당신이 얻는 것보다 열등합니다 에서RTF백엔드. 특정 문제 영역은 테이블과 다양한 아티팩트입니다. 수직과 수평 간격의. 또한, 결과를 수동으로 다듬을 수 있는 기회.
우리는 여러 설치 경험을 문서화했습니다. 처리하는 데 필요한 다양한 젠 토토에 대한 방법 문서. 이에 대해서는 아래에서 설명하겠습니다. 일부 있을 수 있습니다. 이러한 젠 토토에 대한 다른 패키지 배포판. 신고해주세요 패키지 상태를 문서 메일링 리스트에 보내주시면 됩니다. 여기에 해당 정보를 포함하세요.
대부분의 공급업체는 DocBook에 대한 완전한 RPM 세트를 제공합니다. 배포 과정에서 처리됩니다. 다음을 찾으세요."SGML"13740_13799sgml-공통, 문서북, 스타일시트, 오픈제이드(또는옥). 아마도sgml-tools또한 필요합니다. 만약 당신의 유통업체가 이를 제공하지 않으면 귀하는 다음을 수행할 수 있어야 합니다. 합리적으로 호환되는 다른 패키지를 사용하십시오. 공급업체.
FreeBSD 문서 프로젝트 자체는 다음을 많이 사용하는 사용자입니다. DocBook, 따라서 전체 세트가 있다는 것은 놀라운 일이 아닙니다."포트"문서화 젠 토토 중 FreeBSD에서 사용 가능합니다. 다음 포트를 설치해야 합니다. FreeBSD에 대한 문서를 작성합니다.
텍스트프로세스/sp
textproc/openjade
textproc/iso8879
textproc/dsssl-docbook-modular
분명히 DocBook V4.2 SGML DTD용 포트가 없습니다 지금 바로 이용 가능합니다. 수동으로 설치해야 합니다.
다음의 여러 가지/usr/포트/인쇄 (텍스, jadetex) 어쩌면 또한 관심을 가지십시오.
포트가 기본 카탈로그를 업데이트하지 않을 가능성이 있습니다 제출/usr/local/share/sgml/catalog. 꼭 가지고 가세요 거기에 다음 줄이 있습니다:
카탈로그 "/usr/local/share/sgml/docbook/4.2/docbook.cat"
파일을 편집하고 싶지 않다면 다음을 설정할 수도 있습니다. 환경 변수SGML_CATALOG_FILES콜론으로 구분된 카탈로그 파일 목록(예: 위).
FreeBSD 문서화 젠 토토에 대한 더 많은 정보는 다음에서 찾을 수 있습니다.FreeBSD 문서화 프로젝트의 지침.
문서화 젠 토토의 전체 패키지 세트가 있습니다. 에 사용 가능데비안 GNU/리눅스. 설치하려면 다음을 사용하세요.
apt-get 설치 옥 설치 apt-get 설치 문서집 apt-get 설치 docbook-stylesheets
DocBook 젠 토토의 수동 설치 과정은 다음과 같습니다. 다소 복잡하므로 사전 빌드된 패키지를 사용할 수 있는 경우 그들을 사용하십시오. 여기서는 표준 설정만 설명합니다. 합리적으로 표준 설치 경로이며 아니요"멋져요"기능. 자세한 내용은 공부해야합니다 해당 패키지의 문서를 읽고SGML입문 자료.
OpenJade 설치는 GNU 스타일을 제공합니다../구성; 만들다; 만들다 설치빌드 프로세스. 자세한 내용은 다음에서 확인할 수 있습니다. OpenJade 소스 배포. 간단히 말해서:
./configure --enable-default-catalog=/usr/local/share/sgml/catalog 만들다 설치하다
당신이 어디에 두었는지 기억하십시오"기본 카탈로그"; 당신은 그것이 필요합니다 아래. 그대로 놔둘 수도 있지만 그러면 그렇게 됩니다. 환경 변수를 설정해야 합니다SGML_CATALOG_FILES파일을 가리키려면 사용할 때마다옥나중에. (이 방법은 OpenJade가 이미 설치되어 있고 나머지 부분도 설치하려고 합니다. 젠 토토 체인을 로컬로 저장합니다.)
추가로 파일을 설치해야 합니다dsssl.dtd, fot.dtd, 스타일-시트.dtd및카탈로그에서dsssl디렉토리 어딘가에, 아마도/usr/local/share/sgml/dsssl. 아마도 전체 디렉토리를 복사하는 것이 가장 쉬울 것입니다.
cp -R dsssl /usr/local/share/sgml
마지막으로 파일을 생성합니다/usr/local/share/sgml/catalog그리고 추가하세요 이 줄에:
카탈로그 "dsssl/카탈로그"
(이것은 파일에 대한 상대 경로 참조입니다. 설치됨걸음 2. 선택한 경우 반드시 조정하세요. 설치 레이아웃이 다릅니다.)
얻으십시오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의 실제 이름 문자 엔터티 파일.)
스타일 시트를 설치하려면 압축을 풀고 배포하고 적절한 장소로 옮깁니다. 예를 들어/usr/local/share/sgml. (아카이브 자동으로 하위 디렉터리가 생성됩니다.)
$ gunzip docbook-dsssl-1.xx.tar.gz $ tar -C /usr/local/share/sgml -xf docbook-dsssl-1.xx.tar
다음의 일반적인 카탈로그 항목/usr/local/share/sgml/catalog또한 가능합니다 만들어졌습니다:
카탈로그 "docbook-dsssl-1.xx/카탈로그"
스타일시트는 자주 변경되기 때문에 때로는 대체 버전을 사용해 보는 것이 좋습니다.젠 토토이것을 사용하지 않습니다 카탈로그 항목. 참조섹션 G.2.5스타일시트 선택 방법에 대한 정보 대신.
설치 및 사용하기JadeTeX, 작업이 필요합니다 설치TeX그리고LaTeX2e포함 지원됨젠 토토그리고그래픽패키지,바벨, AMS글꼴그리고AMS-LaTeX,PSNFSS확장 및 컴패니언 키트 의"35가지 글꼴", 그dvips생성 프로그램포스트스크립트, 매크로 패키지fancyhdr, 하이퍼참조, 미니톡, url그리고ot2enc. 이 모든 내용은 다음에서 찾을 수 있습니다. 당신의 친절한 이웃CTAN 사이트. 설치TeX기본 시스템이 범위를 훨씬 벗어났습니다. 이 소개의. 바이너리 패키지를 사용할 수 있어야 합니다. 실행할 수 있는 모든 시스템TeX.
사용하기 전에JadeTeX와 함께젠 토토문서 소스, 당신 크기를 늘려야 합니다.TeX의 내부 데이터 구조. 세부정보 이에 대한 내용은JadeTeX설치 지침.
일단 완료되면 설치할 수 있습니다.JadeTeX:
$ gunzip jadetex-xxx.tar.gz $ tar xf jadetex-xxx.tar $ cd jadetex $ 설치하기 $ mktexlsr
마지막 두 가지는 다음과 같이 수행되어야 합니다.루트.
문서를 작성하기 전에 다음을 실행해야 합니다.구성언제든지 스크립트를 작성하세요 건물을 짓는다젠 토토스스로 프로그램합니다. 실행이 거의 끝날 무렵 출력을 확인하고, 다음과 같아야 합니다:
onsgmls 확인 중... onsgmls openjade 확인 중... openjade DocBook V4.2를 확인 중입니다... 예 DocBook 스타일시트를 확인하는 중... /usr/lib/sgml/stylesheets/nwalsh-modular sgmlspl 확인 중... sgmlspl
둘 다 아니라면onsgmls아니요nsgmls발견된 후에는 볼 수 없습니다. 남은 4줄.nsgmls다음의 일부입니다. 제이드 패키지. 환경 변수를 전달할 수 있습니다.제이드그리고NSGMLS프로그램을 찾을 수 없는 경우 해당 프로그램을 가리키도록 구성 자동으로. 만일"DocBook V4.2"이었어 찾을 수 없으면 DocBook DTD 키트를 설치하지 않은 것입니다. Jade가 찾을 수 있는 장소, 또는 귀하가 설정하지 않은 장소 카탈로그 파일이 올바르게 작성되었습니다. 위의 설치 힌트를 참조하세요. 는 DocBook 스타일시트는 상대적으로 여러 곳에서 검색됩니다. 표준 장소이지만 다른 장소에 있다면 환경 변수를 설정해야 합니다DOCBOOKSTYLE위치로 이동하여 다시 실행구성나중에.