| Postgresql 9.1.24 문서화 | ||||
|---|---|---|---|---|
| 토토 결과 : 문서 : 9.1 : DocBook | up | 부록 I. 선적 서류 비치 | PostgreSQL : 토토 사이트 : 9.1 : 토토 사이트 토토 | |
다음 와이즈 토토는 문서를 처리하는 데 사용됩니다. 언급했듯이 일부는 선택 사항 일 수 있습니다.
이것은 문서 자체의 정의입니다. 우리는 현재 버전 4.2; 나중에 또는 이전 버전을 사용할 수 없습니다. 당신은 필요합니다SGMLDocbook DTD의 변형이지만 Man Page를 작성하려면 필요XML변형 같은 버전.
DocBook에서 요구하지만 배포됩니다 ISO에 의해 유지되기 때문에 별도로.
여기에는 변환을위한 처리 지침이 포함되어 있습니다 문서 북 소스는과 같은 다른 형식으로 향합니다.html.
이것은 문서를 변환하기위한 또 다른 스타일 시트입니다 다른 형식. 우리는 현재 이것을 사용하여 사람 페이지를 제작합니다 및 선택적으로 htmlhelp. 이 와이즈 토토 체인을 사용할 수도 있습니다 HTML 또는 PDF 출력을 생산하지만 공식 와이즈 토토 릴리스는 DSSSL 스타일 시트를 사용합니다.
이것은의 기본 패키지입니다.SGML처리. 포함SGMLParser, ADSSSL프로세서 (그 IS, 변환하는 프로그램SGML를 사용하여 다른 형식으로dsssl스타일 시트), AS 다수의 관련 와이즈 토토.Jade이제 OpenJade Group, 더 이상 James Clark의
이것은 XSLT와 함께 사용할 처리 와이즈 토토입니다. 스타일 시트 (예 :Jade입니다 DSSSL 스타일 시트를위한 처리 와이즈 토토).
원한다면 설치할 수도 있습니다jadetex사용하려면Tex형식의 백엔드로Jade. jadetexPostScript 또는을 만들 수 있습니다.PDF파일 (후자 북마크와 함께).
그러나 출력은jadetex당신이 얻는 것보다 열등합니다 에서RTF백엔드. 특정 문제 영역은 테이블과 다양한 인공물입니다 수직 및 수평 간격. 또한 아무도 없습니다 결과를 수동으로 연마 할 수있는 기회.
우리는 여러 설치에 대한 경험을 문서화했습니다 처리하는 데 필요한 다양한 와이즈 토토를위한 방법 선적 서류 비치. 이것들은 아래에 설명되어 있습니다. 일부가있을 수 있습니다 이러한 와이즈 토토에 대한 기타 포장 배포. 보고 해주세요 문서 메일 링리스트에 패키지 상태, 그리고 우리는 그 정보를 여기에 포함 시키십시오.
대부분의 공급 업체는 DocBook에 대한 완전한 RPM 와이즈 토토를 제공합니다 processing in their distribution. 찾아보기"SGML"설치 중 옵션 또는 다음을 다음과 같습니다 패키지 :SGML-Common, docbook, 스타일 시트, OpenJade(또는Jade). 혹시SGML-TOOLS도 필요합니다. 당신의 경우 유통 업체는 이것들을 제공하지 않으면 합리적으로 호환되는 다른 패키지를 사용하십시오. 공급업체.
FreeBSD 문서 프로젝트 자체는 자체가 무거운 사용자입니다. 문서, 따라서 전체 와이즈 토토가 있다는 것은 놀라운 일이 아닙니다."포트"문서 와이즈 토토 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 문서 프로젝트 지침.
문서 도구의 전체 패키지 와이즈 토토가 있습니다. 사용 가능데비안 GNU/Linux. 설치하려면 간단히 사용하십시오 :
APT-GET DOCBOOK DOCBOOK-DSSSL DOCBOOK-XSL OPENJADE1.3 XSLTPROC 설치
Docbook 와이즈 토토의 수동 설치 프로세스는 다음과 같습니다 다소 복잡하므로 사전 구축 된 패키지가있는 경우 사용하십시오. 여기서 표준 설정 만 설명합니다 합리적으로 표준 설치 경로, 그리고"팬시"기능. 자세한 내용은 공부해야합니다 각각의 패키지의 문서화 및 읽기SGML입문 재료.
OpenJade의 설치는 GNU 스타일을 제공합니다./configure; 만들다; 만들다 설치하다빌드 프로세스. 세부 사항은 OpenJade 소스 배포. 간단히 말해 :
./configure-enable-default-catalog =/usr/local/share/sgml/catalog 만들다 설치
당신이 어디에 넣었는지 기억하십시오"기본 카탈로그"; 당신은 그것을 필요로 할 것입니다 아래에. 당신은 또한 그것을 떠날 수 있지만 그러면 당신은 환경 변수를 설정해야SGML_CATALOG_FILES파일을 가리려면 사용할 때마다Jade나중에. (이 방법은 OpenJade가있는 경우에도 옵션입니다 이미 설치되어 있으며 나머지를 설치하려고합니다. 로컬로 와이즈 토토 체인.)
참고 :일부 사용자는보고했습니다 OpenJade를 사용하여 분할 결함이 발생합니다 1.4 Devel 메시지와 함께 PDF를 구축합니다 좋다:
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/카탈로그"
(이것은 파일에 대한 상대 경로 참조입니다 에 설치단계 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에게 말한 내용) 및 a 이렇게하면 :
카탈로그 "DocBook-4.2/docbook.cat"
다운로드ISO 8879 캐릭터 엔터티 아카이브, 포장 풀기 그것, 파일을 당신이 넣은 것과 동일한 디렉토리에 넣습니다. Docbook 파일 :
$cd /usr/local/share/sgml/docbook-4.2 $unzip ...../isoents.zip
디렉토리에서 다음 명령을 실행하십시오 문서 및 ISO 파일 :
perl -pi -e 's/iso- (.*). gml/iso \ 1/g'docbook.cat
(이것은 문서 카탈로그 파일 및 ISO의 실제 이름 문자 엔티티 파일)
스타일 시트를 설치하려면 압축을 풀고 untar 배포하고 적절한 장소로 옮기십시오/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, 작업이 필요합니다 설치TexandLATEX2E, 지원와이즈 토토and그래픽패키지,babel, ams글꼴andAMS-LATEX, 그만큼PSNFSS확장 및 동반자 키트 의"35 글꼴", TheDVIPS생성 프로그램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다음 중 일부가 발견되었습니다 테스트가 건너 뜁니다.NSGMLS부분입니다 Jade 패키지의. 환경 변수를 전달할 수 있습니다JadeandNSGMLS찾을 수없는 경우 프로그램을 가리키도록 구성하려면 자동으로. 만약에"Docbook v4.2"찾을 수 없으면 Docbook DTD 키트를 Jade가 찾을 수있는 곳, 또는 설정하지 않았습니다. 카탈로그 파일을 올바르게합니다. 위의 설치 힌트를 참조하십시오. 그만큼 Docbook 스타일 시트는 비교적 여러 가지에서 찾고 있습니다. 표준 장소이지만 다른 곳이 있다면 환경 변수를 설정해야DocBookStyle위치 및 재실행구성나중에.