| 사설 토토 9.3.25 문서화 | ||||
|---|---|---|---|---|
| 이전 | 스포츠 토토 베트맨 : 문서 : 9.3 : 문서화 | 부록 J. 선적 서류 비치 | 토토 캔 : 문서 : 9.3 : 문서 구축 | |
다음 사설 토토는 문서를 처리하는 데 사용됩니다. 일부 언급했듯이 선택 사항 일 수 있습니다.
이것은 문서 자체의 정의입니다. 우리는 현재 사용하고 있습니다 버전 4.2; 나중에 또는 이전 버전을 사용할 수 없습니다. 당신은 필요합니다SGMLDocbook DTD의 변형, 그러나 Man Pages를 만들려면도 필요합니다.XML같은 버전의 변형.
Docbook에서 요구하지만 별도로 배포됩니다 iso에 의해 유지되기 때문에.
여기에는 변환하기위한 처리 지침이 포함되어 있습니다 와 같은 다른 형식에 대한 문서 책 소스html.
이것은 문서를 다른 것으로 변환하기위한 또 다른 스타일 시트입니다 형식. 우리는 현재 이것을 사용하여 사람 페이지를 생산하고 선택적으로 htmlhelp. 이 사설 토토 체인을 사용하여 HTML 또는 PDF를 생성 할 수도 있습니다. 출력이지만 공식 사설 토토 릴리스는 DSSSL 스타일 시트를 사용합니다 그것을 위해.
최소 필수 버전은 현재 1.74.0입니다.
이것은의 기본 패키지입니다.SGML처리. 포함SGMLParser, ADSSSL프로세서 (즉, 변환 할 프로그램SGML|DSSSL스타일 시트) 및 a 관련 사설 토토 수.jadeis 이제 OpenJade Group에 의해 유지되고 있으며 더 이상 James가 클라크.
이것은 XSLT 스타일 시트와 함께 사용할 처리 사설 토토입니다. (좋다Jade는 처리 사설 토토입니다 DSSSL 스타일 시트).
원하는 경우 설치할 수도 있습니다jadetex사용하려면Tex형식의 백엔드로Jade. jadetexPostScript 또는를 만들 수 있습니다.PDF파일 (후자는 북마크가있는 후자).
그러나 출력은jadetex당신이 얻은 것보다 열등합니다RTF백엔드. 특별한 문제 영역은 테이블 및 수직 및 수평의 다양한 아티팩트입니다. 간격. 또한 수동으로 연마 할 기회가 없습니다 결과.
우리는 여러 설치 방법에 대한 경험을 문서화했습니다 문서를 처리하는 데 필요한 다양한 사설 토토. 이것들은 아래에 설명되어 있습니다. 다른 패키지가있을 수 있습니다 이러한 사설 토토에 대한 배포. 패키지 상태를보고하십시오 문서 메일 링리스트, 우리는 해당 정보를 포함시킬 것입니다 여기.
대부분의 공급 업체는 문서 처리를위한 완전한 RPM 사설 토토를 제공합니다. 그들의 분포에서. 찾아보기"SGML"설치 중 옵션 또는 다음을 다음과 같습니다 패키지 :SGML-Common, docbook, 스타일 시트, OpenJade(또는Jade). 당신은 또한 필요할 수 있습니다SGML-TOOLS및 어느xsltproc또는libxslt. 만약에 유통 업체는 이것을 제공하지 않으면 합리적으로 호환되는 다른 패키지를 사용하십시오. 공급업체.
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_FILESa 콜론으로 구분 된 카탈로그 파일 목록 (위의 것).
freebsd 문서 사설 토토에 대한 자세한 정보는 가능합니다 에서 발견FreeBSD 문서 프로젝트 지침.
문서 도구의 전체 패키지 사설 토토가 있습니다. 사용 가능Debian GNU/Linux. 에게 설치, 간단히 사용하십시오 :
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 스타일을 제공합니다./configure; 만들다; 설치빌드 프로세스. 세부 사항은 OpenJade 소스 배포에서 찾을 수 있습니다. a 간단히 말해 :
./configure-enable-default-catalog =/usr/local/share/sgml/catalog 만들다 설치
당신이 어디에 넣었는지 기억하십시오"기본 카탈로그"; 아래에서 필요합니다. 당신은 할 수 있습니다 또한 그대로두면 환경을 설정해야합니다. 변하기 쉬운SGML_CATALOG_FILES사용할 때마다 파일Jade나중에 에. (이 방법은 OpenJade가 이미 설치된 경우에도 옵션입니다. 그리고 나머지 사설 토토 체인을 로컬로 설치하고 싶습니다.)
참고 :일부 사용자는 a OpenJade 1.4devel을 사용하여 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/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, 당신 의 작업 설치가 필요합니다.Tex및LATEX2E, 지원되는 것을 포함하여사설 토토and그래픽패키지,babel, ams글꼴andAMS-LATEX, ThePSNFSS확장 및 동반자 키트"35 글꼴 ", TheDVIPS프로그램 생성을 위해PostScript, 매크로 패키지FancyHdr, HyperRef, Minitoc, URLandot2enc. 이 모든 것이 될 수 있습니다 친절한 동네에서 발견CTAN사이트. 그만큼 설치Tex베이스 시스템은이 소개의 범위를 훨씬 뛰어 넘습니다. 이진 실행할 수있는 모든 시스템에 패키지를 사용할 수 있어야합니다Tex.
사용하기 전에jadetex그만큼사설 토토문서 출처, 당신은의 크기를 늘려야합니다.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의 일부입니다 옥 패키지. 환경 변수를 전달할 수 있습니다JadeandNSGMLS프로그램이 자동으로 찾을 수없는 경우 프로그램을 가리 키십시오. 만약에"Docbook v4.2"당신은 찾을 수 없었습니다 Jade가 찾을 수있는 곳에 Docbook DTD 키트를 설치하지 않았습니다. 또는 카탈로그 파일을 올바르게 설정하지 않았습니다. 참조 위의 설치 힌트. Docbook 스타일 시트를 찾고 있습니다 상대적으로 표준적인 곳이 많지만 일부가 있다면 다른 곳에서 환경 변수를 설정해야합니다DocBookStyle위치 및 재실행구성나중에.
| 이전 | 배트맨 토토 : 문서 : 9.3 : 배트맨 토토 9.3.25 문서화 | 다음 |
| docbook | 스포츠 토토 베트맨 : 문서 : 9.3 : 문서화 | 건물 선적 서류 비치 |