다음 와이즈 토토는 문서를 처리하는 데 사용됩니다. 명시된 대로 일부는 선택 사항일 수 있습니다.
이것이 DocBook 자체의 정의입니다. 우리는 현재 버전 4.2를 사용하십시오. 이후 버전이나 이전 버전은 사용할 수 없습니다. 당신은SGMLDocBook DTD의 변형이지만 매뉴얼 페이지를 구축하려면 필요하다XML변종 같은 버전입니다.
이것들은 DocBook에 필요하지만 배포됩니다 ISO에서 관리하기 때문에 별도로 관리됩니다.
여기에는 변환을 위한 처리 지침이 포함되어 있습니다. DocBook 소스를 다음과 같은 다른 형식으로 변환합니다.HTML.
이것은 DocBook을 다음으로 변환하기 위한 또 다른 스타일시트입니다. 다른 형식. 우리는 현재 이것을 맨 페이지를 생성하는 데 사용합니다. 그리고 선택적으로 HTMLHelp. 이 툴체인을 사용하여 다음을 수행할 수도 있습니다. HTML 또는 PDF 출력을 생성하지만 공식 와이즈 토토 릴리스에서는 이를 위해 DSSSL 스타일시트를 사용합니다.
이것은 기본 패키지입니다SGML처리 중. 여기에는가 포함되어 있습니다.SGML파서, aDSSSL프로세서(이 변환하는 프로그램입니다SGML다음을 사용하여 다른 형식으로DSSSL스타일시트), 다양한 관련 와이즈 토토도 포함됩니다.제이드이제 관리되고 있습니다. OpenJade 그룹은 더 이상 James Clark이 아닙니다.
이것은 XSLT와 함께 사용하는 처리 와이즈 토토입니다 스타일시트(예:옥이것은 DSSSL 스타일시트 처리 와이즈 토토).
원하시면 설치할 수도 있습니다.JadeTeX사용하다TeX다음 형식 지정 백엔드로제이드. JadeTeX포스트스크립트를 생성할 수 있거나PDF파일(후자 북마크 포함).
그러나 다음의 출력은JadeTeX당신이 얻는 것보다 열등합니다 에서RTF백엔드. 특정 문제 영역은 테이블과 다양한 아티팩트입니다. 수직과 수평 간격의. 또한, 결과를 수동으로 다듬을 수 있는 기회.
우리는 여러 설치 경험을 문서화했습니다. 처리하는 데 필요한 다양한 와이즈 토토에 대한 방법 문서. 이에 대해서는 아래에서 설명하겠습니다. 일부있을 수 있습니다 이러한 와이즈 토토에 대한 다른 패키지 배포판. 신고해주세요 패키지 상태를 문서 메일링 리스트에 보내주시면 됩니다. 여기에 해당 정보를 포함하세요.
대부분의 공급업체는 DocBook에 대한 완전한 RPM 세트를 제공합니다. 배포 과정에서 처리됩니다. 다음을 찾으세요."SGML"설치 중 옵션 또는 다음 패키지:sgml-공통, 문서북, 스타일시트, 오픈제이드(또는옥). 아마도sgml-tools또한 필요합니다. 만약 당신의 배포자가 이를 제공하지 않으면 귀하는 다음을 수행할 수 있어야 합니다. 합리적으로 호환되는 다른 패키지를 사용하십시오. 공급업체.
FreeBSD 문서 프로젝트 자체는 다음을 많이 사용하는 사용자입니다. DocBook, 따라서 전체 세트가 있다는 것은 놀라운 일이 아닙니다."포트"문서화 와이즈 토토 중 FreeBSD에서 사용 가능합니다. 다음 포트를 설치해야 합니다. FreeBSD에 대한 문서를 작성합니다.
텍스트프로세스/sp
textproc/openjade
textproc/iso8879
textproc/dsssl-docbook-modular
textproc/docbook-420
다음의 여러 가지/usr/포트/인쇄 (텍스, jadetex) 어쩌면 또한 관심을 가지십시오.
포트가 기본 카탈로그를 업데이트하지 않을 가능성이 있습니다 제출/usr/local/share/sgml/catalog.ports또는 그 순서가 올바르지 않습니다. 다음 줄이 있는지 확인하십시오. 파일의 시작 부분:
카탈로그 "오픈제이드/카탈로그" 카탈로그 "iso8879/카탈로그" 카탈로그 "docbook/dsssl/modular/catalog" 카탈로그 "docbook/4.2/catalog"
파일을 편집하고 싶지 않다면 다음을 설정할 수도 있습니다. 환경 변수SGML_CATALOG_FILES콜론으로 구분된 카탈로그 파일 목록(예: 위).
FreeBSD 문서 와이즈 토토에 대한 자세한 내용은 다음에서 찾을 수 있습니다.FreeBSD 문서화 프로젝트의 지침.
문서화 와이즈 토토의 전체 패키지 세트가 있습니다. 에 사용 가능데비안 GNU/리눅스. 설치하려면 다음을 사용하세요.
apt-get 설치 docbook docbook-dsssl docbook-xsl openjade1.3 xsltproc
DocBook 와이즈 토토의 수동 설치 과정은 다음과 같습니다. 다소 복잡하므로 사전 빌드된 패키지를 사용할 수 있는 경우 그들을 사용하십시오. 여기서는 표준 설정만 설명합니다. 합리적으로 표준 설치 경로이며 아니요"멋져요"기능. 자세한 내용은 공부해야합니다 해당 패키지의 문서를 읽고SGML입문 자료.
OpenJade 설치는 GNU 스타일을 제공합니다../구성; 만들다; 만들다 설치빌드 프로세스. 자세한 내용은 다음에서 확인할 수 있습니다. OpenJade 소스 배포. 간단히 말해서:
./configure --enable-default-catalog=/usr/local/share/sgml/catalog 만들다 설치하다
당신이 어디에 두었는지 기억하십시오"기본 카탈로그"; 당신은 그것이 필요합니다 아래. 그대로 놔둘 수도 있지만 그러면 그렇게 됩니다. 환경 변수를 설정해야 합니다SGML_CATALOG_FILES파일을 가리키기 위해 사용할 때마다옥나중에. (이 방법은 OpenJade가 이미 설치되어 있고 나머지 부분도 설치하려고 합니다. 툴체인을 로컬에서 실행합니다.)
참고:일부 사용자가 신고했습니다. openjade를 사용하여 분할 오류 발생 1.4devel은 메시지와 함께 PDF를 작성합니다. 좋아요:
openjade:./stylesheet.dsl:664:2:E: 흐름 개체가 포트에서 허용되지 않습니다. 표시 흐름 객체만 허용됩니다. make: *** [postgres-A4.tex-pdf] 분할 오류openjade 1.3으로 다운그레이드하면 이 오류입니다.
추가로 파일을 설치해야 합니다dsssl.dtd, fot.dtd, style-sheet.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/카탈로그"
스타일시트는 자주 변경되기 때문에 때로는 대체 버전을 사용해 보는 것이 좋습니다.와이즈 토토이것을 사용하지 않습니다 카탈로그 항목. 참조섹션 I.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/share/sgml/docbook/stylesheet/dsssl/modular collateindex.pl 확인 중... /usr/bin/collateindex.pl xsltproc를 확인하는 중... xsltproc osx를 확인하는 중... osx
둘 다 아니라면onsgmls아니요nsgmls다음 중 일부가 발견되었습니다. 테스트는 건너뜁니다.nsgmls부분입니다 Jade 패키지의 환경 변수를 전달할 수 있습니다.제이드그리고NSGMLS프로그램을 찾을 수 없는 경우 해당 프로그램을 가리키도록 구성 자동으로. 만일"DocBook V4.2"이었음 찾을 수 없으면 DocBook DTD 키트를 설치하지 않은 것입니다. Jade가 찾을 수 있는 장소, 또는 귀하가 설정하지 않은 장소 카탈로그 파일이 올바르게 작성되었습니다. 위의 설치 힌트를 참조하세요. 는 DocBook 스타일시트는 상대적으로 여러 곳에서 검색됩니다. 표준 장소이지만 다른 장소에 있다면 환경 변수를 설정해야 합니다DOCBOOKSTYLE위치로 이동하여 다시 실행구성나중에.