| 롤 토토 : 문서 : 9.5 : | |||
|---|---|---|---|
| PostgreSQL : 롤 토토 : 9.5 : DocBook | PostgreSQL : 문서 : 9.5 : 토토 꽁 머니 | 부록 J. 문서 | PostgreSQL : 스포츠 토토 사이트 : 9.5 : 스포츠 토토 사이트 구축 |
다음 범퍼카 토토는 문서를 처리하는 데 사용됩니다. 명시된 대로 일부는 선택 사항일 수 있습니다.
이것이 DocBook 자체의 정의입니다. 현재 버전 4.2를 사용하고 있습니다. 이후 버전이나 이전 버전은 사용할 수 없습니다. 당신은SGMLDocBook DTD의 변형이지만 매뉴얼 페이지를 구축하려면 다음도 필요합니다.XML동일한 버전의 변형입니다.
이것들은 DocBook에 필요하지만 ISO에서 관리하기 때문에 별도로 배포됩니다.
이에는 DocBook 소스를 다음과 같은 다른 형식으로 변환하기 위한 처리 지침이 포함되어 있습니다.HTML.
이것은 DocBook을 다른 형식으로 변환하기 위한 또 다른 스타일시트입니다. 현재 이를 사용하여 매뉴얼 페이지와 선택적으로 HTMLHelp를 생성합니다. 이 툴체인을 사용하여 HTML 또는 PDF 출력을 생성할 수도 있지만 공식 범퍼카 토토 릴리스에서는 이를 위해 DSSSL 스타일시트를 사용합니다.
최소 필수 버전은 현재 1.74.0입니다.
이것은 기본 패키지입니다SGML처리 중. 여기에는가 포함되어 있습니다.SGML파서, aDSSSL프로세서(즉, 변환할 프로그램SGML다음을 사용하여 다른 형식으로DSSSL스타일시트) 및 다양한 관련 범퍼카 토토를 포함합니다.제이드이제 더 이상 James Clark이 아닌 OpenJade 그룹에서 관리하고 있습니다.
이 라이브러리와xmllint포함된 범퍼카 토토는 XML 처리에 사용됩니다. 많은 개발자들이 이미 가지고 있을 것입니다.Libxml2설치되었습니다. 범퍼카 토토 코드를 빌드할 때도 사용되기 때문입니다. 그러나 참고하세요.xmllint별도의 하위 패키지에서 설치해야 할 수도 있습니다.
이것은 XSLT 스타일시트와 함께 사용하는 처리 범퍼카 토토입니다(예:옥DSSSL 스타일시트 처리 범퍼카 토토입니다.
원하시면 설치할 수도 있습니다.JadeTeX사용하다TeX다음에 대한 형식 지정 백엔드로제이드. JadeTeX포스트스크립트를 생성할 수 있거나PDF파일(북마크가 있는 후자).
그러나 다음의 출력은JadeTeX당신이 얻는 것보다 열등합니다RTF백엔드. 특히 문제가 되는 부분은 테이블과 수직 및 수평 간격의 다양한 아티팩트입니다. 또한 결과를 수동으로 다듬을 기회도 없습니다.
우리는 문서를 처리하는 데 필요한 다양한 범퍼카 토토에 대한 여러 설치 방법에 대한 경험을 문서화했습니다. 이에 대해서는 아래에서 설명하겠습니다. 이러한 범퍼카 토토에 대한 다른 패키지 배포판이 있을 수 있습니다. 문서 메일링 리스트에 패키지 상태를 보고해 주시면 여기에 해당 정보를 포함하겠습니다.
필요한 패키지를 설치하려면 다음을 사용하십시오:
yum install docbook-dtds docbook-style-dsssl docbook-style-xsl libxslt openjade
FreeBSD 문서 프로젝트 자체는 DocBook을 많이 사용하는 사용자이므로 DocBook의 전체 세트가 있다는 것은 놀라운 일이 아닙니다."포트"FreeBSD에서 사용할 수 있는 문서 범퍼카 토토 중 하나입니다. FreeBSD에서 문서를 작성하려면 다음 포트를 설치해야 합니다.
textproc/docbook-sgml
textproc/docbook-xml
textproc/docbook-xsl
textproc/dsssl-docbook-modular
textproc/libxslt
textproc/openjade
다음의 여러 가지/usr/포트/인쇄 (텍스, jadetex)에도 관심이 있을 것 같습니다.
FreeBSD 문서 범퍼카 토토에 대한 자세한 내용은 다음에서 찾을 수 있습니다.FreeBSD 문서 프로젝트 지침.
다음에 사용할 수 있는 문서 범퍼카 토토의 전체 패키지 세트가 있습니다.데비안 GNU/리눅스. 설치하려면 다음을 사용하세요.
apt-get 설치 docbook docbook-dsssl docbook-xsl libxml2-utils openjade1.3 opensp xsltproc
MacPorts를 사용하는 경우 다음을 설정해야 합니다:
sudo 포트 설치 docbook-dsssl docbook-sgml-4.2 docbook-xml-4.2 docbook-xsl libxslt openjade opensp
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, 스타일-시트.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/카탈로그"
스타일시트는 자주 변경되기 때문에 때로는 대체 버전을 사용해 보는 것이 유익할 때도 있습니다.범퍼카 토토이 카탈로그 항목을 사용하지 않습니다. 참조섹션 J.2.6대신 스타일시트를 선택하는 방법에 대한 정보.
설치 및 사용하기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"을 찾을 수 없으면 Jade가 찾을 수 있는 위치에 DocBook DTD 키트를 설치하지 않았거나 카탈로그 파일을 올바르게 설정하지 않은 것입니다. 위의 설치 힌트를 참조하세요. DocBook 스타일시트는 상대적으로 표준적인 여러 위치에서 검색되지만 다른 위치에 있는 경우 환경 변수를 설정해야 합니다.DOCBOOKSTYLE위치로 이동하여 다시 실행구성나중에.