| 윈 토토 : 문서 : 9.4 : | |||
|---|---|---|---|
| PostgreSQL : 사설 토토 : 9.4 : DocBook | PostgreSQL : 사설 토토 사이트 : 9.4 : 사설 토토 사이트화 | 부록 J. 문서화 | PostgreSQL : 젠 토토 : 9.4 : 젠 토토 구축 |
다음 도구는 문서를 처리하는 데 사용됩니다. 언급했듯이 일부는 선택 사항 일 수 있습니다.
이것은 문서 자체의 정의입니다. 우리는 현재 버전 4.2를 사용하고 있습니다. 나중에 또는 이전 버전을 사용할 수 없습니다. 당신은 필요합니다SGMLDocbook DTD의 변형이지만 Man 페이지를 작성하려면도 필요합니다.XML같은 버전의 변형.
Docbook에서 요구하지만 ISO에 의해 유지되기 때문에 별도로 배포됩니다.
여기에는 문서 소스를 다른 형식으로 변환하기위한 처리 지침이 포함되어 있습니다.html.
이것은 문서를 다른 형식으로 변환하기위한 또 다른 스타일 시트입니다. 우리는 현재 이것을 사용하여 사람 페이지와 선택적으로 htmlhelp를 생산합니다. 이 도구 체인을 사용하여 HTML 또는 PDF 출력을 생성 할 수 있지만 공식 범퍼카 토토 릴리스는 DSSSL 스타일 시트를 사용합니다..
최소 필수 버전은 현재 1.74.0입니다.
이것은의 기본 패키지입니다.SGML처리. 포함SGMLParser, ADSSSL프로세서 (즉, 변환 할 프로그램SGML사용 사용을 사용하여 다른 형식으로DSSSL스타일 시트) 및 여러 관련 도구.jade이제 OpenJade Group이 더 이상 James Clark에 의해 유지되고 있습니다.
이것은 XSLT 스타일 시트와 함께 사용할 수있는 처리 도구입니다 (좋아요JadeDSSSL 스타일 시트의 처리 도구입니다).
원하는 경우 설치할 수도 있습니다jadetex사용하려면Tex형식의 백엔드로Jade. jadetexPostScript 또는를 만들 수 있습니다.PDF파일 (후자는 북마크가있는 후자).
그러나 출력은jadetex당신이 얻은 것보다 열등합니다RTF백엔드. 특정 문제 영역은 테이블과 수직 및 수평 간격의 다양한 아티팩트입니다. 또한 결과를 수동으로 연마 할 기회가 없습니다.
우리는 문서를 처리하는 데 필요한 다양한 도구에 대한 여러 설치 방법에 대한 경험을 문서화했습니다. 이것들은 아래에 설명되어 있습니다. 이러한 도구에 대한 다른 포장 배포가있을 수 있습니다. 패키지 상태를 문서 메일 링리스트에보고하십시오. 여기에 해당 정보를 포함시킬 것입니다.
대부분의 공급 업체는 배포의 문서 처리를위한 완전한 RPM 범퍼카 토토를 제공합니다. 찾아보기"SGML"설치 중 옵션 또는 다음 패키지 :SGML-Common, DocBook, 스타일 시트, OpenJade(또는Jade). 당신은 또한 필요할 수 있습니다SGML-TOOLS및 어느xsltproc또는libxslt. 유통 업체가 제공하지 않으면 합리적으로 호환되는 다른 공급 업체로부터 패키지를 사용할 수 있어야합니다.
freebsd 문서 프로젝트 자체는 Docbook의 무거운 사용자이므로 전체 범퍼카 토토가 있다는 것은 놀라운 일이 아닙니다."포트"freebsd에서 사용할 수있는 문서 도구. freebsd에 문서를 작성하려면 다음 포트를 설치해야합니다.
TextProc/SP
TextProc/OpenJade
TextProc/ISO8879
TextProc/dsssl-docbook-modular
TextProc/DocBook-420
여러 가지/usr/ports/print(Tex, jadetex) 관심이있을 수도 있습니다.
포트가 기본 카탈로그 파일을 업데이트하지 않을 수 있습니다/usr/local/share/sgml/catalog.ports또는 주문이 적절하지 않습니다. 파일의 시작 부분에 다음 줄이 있어야합니다.
카탈로그 "OpenJade/Catalog" 카탈로그 "ISO8879/카탈로그" 카탈로그 "DocBook/DSSSL/Modular/Catalog" 카탈로그 "DocBook/4.2/Catalog"
파일을 편집하지 않으려면 환경 변수를 설정할 수도 있습니다SGML_CATALOG_FILES콜론으로 구분 된 카탈로그 파일 목록 (위의 것)..
freeBSD 문서 도구에 대한 자세한 내용은에서 찾을 수 있습니다.FreeBSD 문서 프로젝트 지침.
문서 도구의 전체 패키지 범퍼카 토토가 있습니다.Debian GNU/Linux. 설치하려면 간단히 사용하십시오 :
APT-GET DOCBOOK DOCBOOK-DSSSL DOCBOOK-XSL OPENJADE1.3 OPENSP XSLTPROC
Macports를 사용하면 다음을 설정할 수 있습니다.
Sudo Port 설치 DocBook-DSSSL DocBook-SGML-4.2 DocBook-XML-4.2 DocBook-XSL libxslt OpenJade Opensp
Docbook 도구의 수동 설치 프로세스는 다소 복잡하므로 사전 제작 된 패키지가있는 경우 사용하십시오. 여기서는 표준 설치 경로가있는 표준 설정 만 설명합니다."팬시"기능. 자세한 내용은 해당 패키지의 문서를 연구하고 읽어야합니다SGML입문 자료.
OpenJade의 설치는 GNU 스타일을 제공합니다./configure; 만들다; 설치빌드 프로세스. 세부 사항은 OpenJade 소스 배포에서 찾을 수 있습니다. 간단히 말해 :
./configure-enable-default-catalog =/usr/local/share/sgml/catalog 만들다 설치
당신이 어디에 넣었는지 기억하십시오"기본 카탈로그"; 아래에서 필요합니다. 당신은 또한 그것을 떠날 수 있지만, 환경 변수를 설정해야합니다.SGML_CATALOG_FILES사용할 때마다 파일을 가리 키려면Jade나중에. (이 방법은 OpenJade가 이미 설치되어 있고 나머지 도구 체인을 로컬로 설치하려는 경우 옵션이기도합니다.)
참고 :일부 사용자는 OpenJade 1.4devel을 사용하여 세그먼트 화 결함이 발생했다고보고했습니다.
OpenJade : ./ Stylesheet.dsl : 664 : 2 : E : 포트로 허용되지 않는 흐름 객체; 허용되는 유량 객체 만 표시됩니다 MATE : *** [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/CATALOG"
(이것은 설치된 파일에 대한 상대 경로 참조입니다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 $unzip ...../isoents.zip
Docbook 및 ISO 파일을 사용하여 디렉토리에서 다음 명령을 실행합니다.
perl -pi -e 's/iso- (.*). gml/iso \ 1/g'docbook.cat
(이것은 문서 카탈로그 파일에 사용 된 이름과 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/카탈로그 "
스타일 시트가 자주 바뀌고 때로는 대체 버전을 시도하는 것이 유리하기 때문에범퍼카 토토이 카탈로그 항목을 사용하지 않습니다. 보다섹션 J.2.6대신 스타일을 선택하는 방법에 대한 정보.
설치 및 사용하려면jadetex,의 작업 설치가 필요합니다TexandLATEX2E, 지원되는 것을 포함하여도구and그래픽패키지,babel, ams글꼴andAMS-LATEX, ThePSNFSS확장 및 동반자 키트"35 글꼴",DVIPS생성 프로그램PostScript, 매크로 패키지FancyHdr, HyperRef, Minitoc, URLandot2enc. 이 모든 것이 당신의 친절한 동네에서 찾을 수 있습니다CTAN사이트. 의 설치Tex기본 시스템은이 소개의 범위를 훨씬 뛰어 넘습니다. 실행할 수있는 모든 시스템에 이진 패키지를 사용할 수 있어야합니다Tex.
사용하기 전에jadetexwith범퍼카 토토문서 소스,의 크기를 늘려야합니다.Tex의 내부 데이터 구조. 이것에 대한 자세한 내용은에서 찾을 수 있습니다.jadetex설치 지침.
일단 완료되면 설치할 수 있습니다jadetex:
$ Gunzip Jadetex-xxx.tar.gz $ 타르 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
그렇지 않은 경우ONSGMLSNORNSGMLS발견되었습니다. 다음 테스트 중 일부가 건너 뛸 것입니다.NSGMLSjade 패키지의 일부입니다. 환경 변수를 전달할 수 있습니다Jade및NSGMLS자동으로 찾을 수없는 경우 프로그램을 가리키도록 구성합니다. 만약에"Docbook v4.2"찾을 수 없었습니다. 그러면 Jade가 찾을 수있는 곳에 Docbook DTD 키트를 설치하지 않았거나 카탈로그 파일을 올바르게 설정하지 않았습니다. 위의 설치 힌트를 참조하십시오. Docbook 스타일 시트는 비교적 표준적인 장소에서 찾고 있지만 다른 장소가 있으면 환경 변수를 설정해야합니다.DocBookStyle위치 및 재실행구성나중에.