다음 사설 토토는 문서를 처리하는 데 사용됩니다. 일부 명시된 대로 선택사항일 수 있습니다.
이것이 DocBook 자체의 정의입니다. 우리는 현재 사용 버전 4.2; 이후 버전이나 이전 버전은 사용할 수 없습니다. 당신은SGMLDocBook DTD의 변형, 하지만 매뉴얼 페이지를 구축하려면 다음도 필요합니다.XML동일한 버전의 변형입니다.
이것들은 DocBook에 필요하지만 별도로 배포됩니다. ISO에서 관리하기 때문입니다.
여기에는 변환을 위한 처리 지침이 포함되어 있습니다. DocBook 소스는 다음과 같은 다른 형식으로 제공됩니다.HTML.
이것은 DocBook을 다른 스타일로 변환하기 위한 또 다른 스타일시트입니다. 형식. 우리는 현재 이를 사용하여 맨 페이지를 생성하고 선택적으로 HTML도움말. 이 툴체인을 사용하여 HTML 또는 PDF를 생성할 수도 있습니다. 출력되지만 공식 사설 토토 릴리스는 DSSSL 스타일시트를 사용합니다. 그러기 위해서.
최소 필수 버전은 현재 1.74.0입니다.
이것은 기본 패키지입니다SGML처리 중. 여기에는가 포함되어 있습니다.SGML파서, aDSSSL프로세서(즉, 변환할 프로그램SGML다음을 사용하여 다른 형식으로DSSSL스타일시트) 및 관련 사설 토토의 수입니다.제이드이다 이제 더 이상 James가 아닌 OpenJade 그룹에서 관리하고 있습니다. 클락.
이것은 XSLT 스타일시트와 함께 사용하는 처리 사설 토토입니다 (좋아요옥다음을 위한 처리 사설 토토입니다. DSSSL 스타일시트).
원하시면 설치할 수도 있습니다.JadeTeX사용하다TeX다음에 대한 형식 지정 백엔드로제이드. JadeTeX포스트스크립트를 생성할 수 있거나PDF파일(북마크가 있는 후자).
그러나 다음의 출력은JadeTeX당신이 얻는 것보다 열등합니다RTF백엔드. 특별한 문제 영역은 테이블과 수직 및 수평의 다양한 인공물입니다. 간격. 또한 수동으로 연마할 기회가 없습니다. 결과.
우리는 여러 설치 방법에 대한 경험을 문서화했습니다. 문서를 처리하는 데 필요한 다양한 사설 토토에 대해 설명합니다. 이에 대해서는 아래에서 설명하겠습니다. 다른 포장이 있을 수도 있습니다. 이러한 사설 토토에 대한 배포판입니다. 패키지 상태를 다음 담당자에게 보고해 주세요. 문서 메일링 리스트에 포함되며 해당 정보가 포함됩니다. 여기.
대부분의 공급업체는 DocBook 처리를 위한 완전한 RPM 세트를 제공합니다. 그들의 배포에서. 다음을 찾으세요."SGML"13688_13743sgml-공통, 문서북, 스타일시트, 오픈제이드(또는옥). 필요할 수도 있습니다.sgml-tools그리고 둘 중 하나xsltproc또는libxslt. 만약에 귀하의 유통업체가 이를 제공하지 않으면 귀하는 다음을 수행할 수 있어야 합니다. 합리적으로 호환되는 다른 패키지를 사용하십시오. 공급업체.
FreeBSD 문서 프로젝트 자체는 다음을 많이 사용하는 사용자입니다. DocBook, 따라서 전체 세트가 있다는 것은 놀라운 일이 아닙니다."포트"문서화 사설 토토 중 FreeBSD에서 사용 가능합니다. 다음 포트를 설치해야 합니다. FreeBSD에서 문서를 작성하세요.
텍스트프로세스/sp
textproc/openjade
textproc/iso8879
textproc/dsssl-docbook-modular
textproc/docbook-420
몇 가지 내용/usr/ports/print (텍스, 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 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다음의 일부입니다. 제이드 패키지. 환경 변수를 전달할 수 있습니다.제이드그리고NSGMLS다음으로 구성 프로그램이 자동으로 발견되지 않으면 해당 프로그램을 가리킵니다. 만일"DocBook V4.2"그때 발견되지 않았습니다 Jade가 찾을 수 있는 곳에 DocBook DTD 키트를 설치하지 않았습니다. 또는 카탈로그 파일을 올바르게 설정하지 않았습니다. 참조 위의 설치 힌트. DocBook 스타일시트는 다음에서 찾습니다. 상대적으로 표준적인 장소가 많이 있지만, 그런 곳이 있다면 다른 곳에서는 환경 변수를 설정해야 합니다DOCBOOKSTYLE위치로 이동하여 다시 실행구성나중에.
| 이전 | 배트맨 토토 : 문서 : 9.3 : 배트맨 토토 9.3.25 문서화 | 다음 |
| 문서북 | 스포츠 토토 베트맨 : 문서 : 9.3 : 문서화 | 건물을 짓다 문서 |