우리는 두 가지 젠 토토 방법에 대한 경험을 문서화했습니다 문서를 처리하는 데 필요한 다양한 도구. 하나 에서 젠 토토됩니다.rpms onLinux, 다른 하나는 일반적입니다 개별 도구의 원래 배포에서 젠 토토. 둘 다 아래에 설명되어 있습니다.
우리는 다른 포장 배포가 있다는 것을 이해합니다 이 도구의 경우.freebsd사용할 수있게하십시오. 패키지 상태를 문서에보고하십시오 메일 링리스트 및 우리는 여기에 해당 정보를 포함시킬 것입니다.
installrpmSforJade및 관련 패키지.
이것은 획득 과정의 간단한 런 Docbook 소스를 다음으로 편집하는 데 필요한 소프트웨어 젠 토토 Emacs 및 Norman Walsh의 DSSSL 스타일 시트로 처리하십시오. 만들다htmlandRTF.
이 지침은 새로운 것을 다루지 않습니다Jade/Docbook 지원SGML-TOOLS패키지. 저자는 시도하지 않았습니다 Docbook을 채택한 이후이 패키지는 거의 확실합니다. 사용하기에 좋은 후보.
필요한 것 :
GCC의 작업 젠 토토 2.7.2
EMACS의 작업 젠 토토 19.19 이상
UNIX가 포장을 풀기위한 실행되지 않은 프로그램
당신이 가져와야 할 것 :
중요한 URL :
Jade 젠 토토
위의 나열된 내용에서 젠 토토 지침을 읽으십시오 url.
유통 키트를 적절한 장소에서 압축합니다. 그만큼 이렇게하라는 명령은와 같은 것입니다.
unzip -au jade1_1.zip
jade사용하지 않음gnu autoconf이 필요합니다 a 편집하려면makefile자신. 부터 제임스 클라크는 키트를 준비하기에 충분했습니다. 빌드 디렉토리를 만드는 것이 좋습니다 ( 아마도 기계 아키텍처는 아마도 메인 디렉토리 아래에 있습니다 그만큼Jade배포, 사본 파일makefile메인 디렉토리에 들어가서 편집 한 다음 실행make거기.
그러나makefile필요합니다 편집 할. 라는 파일이 있습니다.makefile.jade기본 디렉토리의 경우입니다 와 함께 사용하려는 의도만들기 -f makefile.jade빌딩시Jade(단지SP, TheSGML파서 키트Jade가 구축되었습니다). 우리는 당신을 제안합니다 그래도 그렇게하지 마십시오. 에있는 것보다 변화makefile.jade, 그 중 하나를 편집해야합니다 어쨌든.
makefile, 읽기 필요에 따라 James의 지시 및 편집. 다양한 것이 있습니다 설정 해야하는 변수. 다음은 수집 된 요약입니다 일반적인 가치를 가진 가장 중요한 것 :
prefix = /usr /local xdefines = -dsgml_catalog_files_default = \ "/usr/local/share/sgml/catalog \" xlibs = -lm ranlib = ranlib srcdir = .. xlibdirs = Grove spgrove 스타일 xprogdirs = jade기본 카탈로그를 찾을 위치의 사양에 유의하십시오. 의SGML지원 파일 - 원할 수도 있습니다 그것을 당신 자신에 더 적합한 것으로 바꾸려면 젠 토토. 시스템에 위의 설정이 필요하지 않은 경우 수학 도서관과ranlib명령, 그들이있는대로 남겨 둡니다makefile.
타입makejade and the를 구축합니다 다양한SP도구.
소프트웨어가 구축되면만들기 젠 토토하다명백한 일을 할 것입니다.
젠 토토docbook dtd키트
당신은를 구성하는 파일을 배치하고 싶을 것입니다docbook dtd당신이 만든 디렉토리의 키트Jade그들을 기대하려면, 위의 제안을 따랐다면/usr/local/share/sgml/. 외에 실제docbook파일 가 필요합니다카탈로그파일 in 문서 유형 사양의 매핑을 위해 배치하십시오 외부 엔티티는 해당 디렉토리의 실제 파일을 참조합니다. 당신은 또한를 원할 것입니다.ISO문자 세트 매핑 및 아마도 하나 이상의 버전의html.
다양한 젠 토토 방법dtd및 지원 파일을 설정하고를 설정하십시오.카탈로그파일은 그것들을 수집하는 것입니다 위에서 언급 한 디렉토리에 모두 단일 파일을 사용하십시오. 이름카탈로그그들 모두를 설명하려면, 그런 다음 파일 생성카탈로그AS 한 줄을 제공하여 전자에 대한 카탈로그 포인터 내용 :
카탈로그/usr/local/share/sgml/catalog
the카탈로그파일이 필요합니다 세 가지 유형의 선을 포함합니다. 첫 번째는 (선택 사항)입니다.SGML선언, 따라서 :
SGMLDECL DOC.DCL다음, 다양한 참조dtd및 엔티티 파일을 해결해야합니다.docbook파일,이 라인은 보입니다 이와 같이:
public "-// davenport // dtd docbook v3.0 // en"docbook.dtd Public "-// USA-DOD // DTD 테이블 모델 951010 // en"Cals-tbl.dtd public "-// Davenport // 요소 Docbook Information Pool v3.0 // en"dbpool.mod public "-// Davenport // 요소 문서 문서 계층 v3.0 // en"dbhier.mod 공개 "-// Davenport // 엔티티 문서 책 추가 일반 엔티티 v3.0 //"dbgenent.mod
물론, 이들이 포함 된 파일은와 함께 제공됩니다.DocBook키트. 주목하십시오 이 라인 각각의 마지막 항목은 여기에 주어진 파일 이름입니다. 길없이. 파일을 하위 디렉토리에 넣을 수 있습니다 당신의 메인SGML디렉토리 물론,에서 참조를 수정하십시오.카탈로그파일.docbook또한 참조ISO문자 세트 엔티티이므로 필요합니다 이것들을 가져 와서 젠 토토하십시오 (그것들은 여러 곳에서 구할 수 있습니다 소스, 나열된 URL을 통해 쉽게 찾을 수 있습니다. 위), 그들 모두를위한 카탈로그 항목과 함께 처럼:
public "iso 8879-1986 // 엔티티가 추가 된 라틴어 1 // en"iso/rotromat1여기의 파일 이름에 디렉토리 이름이 포함 된 방법에 유의하십시오. 우리가 배치했음을 보여줍니다ISO하위 디렉토리의 엔티티 파일ISO. 다시, 적절한 카탈로그 항목은 엔티티 키트와 동반해야합니다. 술책.
Norman Walsh 's 젠 토토dsssl스타일 시트
위에 나열된 내용의 젠 토토 지침을 읽으십시오 url.
Norman의 스타일 시트를 젠 토토하려면 단순히 감금됩니다 적절한 장소에있는 유통 키트. 점점 좋은 곳 이건/usr/local/share, 키트를 디렉토리 트리에 배치하는/usr/local/share/docbook. 명령이 될 것입니다 와 같은 것
unzip -au db107.zip
젠 토토를 테스트하는 한 가지 방법은를 구축하는 것입니다.htmlandRTF형태PostgreSQL매뉴얼.
구축하려면html파일, 로 이동SGML소스 예배 규칙서,doc/src/sgml및 말하다
jade -t sgml -d /usr/local/share/docbook/html/docbook.dsl -d ../graphics postgres.sgml
book1.htm는 최상위 레벨입니다 출력 노드 ..
생성하려면rtf출력, 좋아하는 단어로 가져올 준비가되었습니다 가공 시스템 및 인쇄, 유형 :
jade -t rtf -d /usr/local/share/docbook/print/docbook.dsl -d ../graphics postgres.sgml
젠 토토PSGML
위에 나열된 내용에서 젠 토토 지침을 읽으십시오 url.
배포 파일을 풀고, 구성, make 및 make를 실행하십시오 바이트 컴파일 된 파일 및 정보 라이브러리를 장소.
그런 다음 다음 줄을 추가/usr/local/share/emacs/site-lisp/site-start.el만들기 파일emacs올바르게 짐PSGML필요할 때 :
(setq load-path (단점 "/usr/local/share/emacs/site-lisp/psgml"load-path))) (Autoload 'SGML-Mode "PSGML" "SGML 파일을 편집하려는 주요 모드."T).
사용하려는 경우PSGML편집 할 때html또한 추가하십시오 이것:
(setq auto-mode-alist (cons '( "\\. s? html? \\'".
PSGML: 저자는 당신의 메인이라고 가정했습니다SGML dtd디렉토리가 될 것입니다/usr/local/lib/sgml. 예제에서와 같이 이 장에서는 사용/usr/local/share/sgml, 당신은 보상해야합니다 이것을 위해.
당신은를 설정할 수 있습니다SGML_CATALOG_FILES환경 변하기 쉬운.
당신은 당신의 사용자 정의 할 수 있습니다PSGML젠 토토 (매뉴얼이 알려줍니다 너 방법).
소스 파일을 편집 할 수도 있습니다psgml.el컴파일 및 젠 토토 전PSGML, 변경 자신의 기본값에 맞는 하드 코딩 된 경로.
원한다면 젠 토토할 수도 있습니다jadetex사용하려면Tex형식의 백엔드로Jade. 이것은 여전히 상당히 연마되지 않았습니다 소프트웨어, 그리고 무엇보다 열등한 인쇄 출력을 생성합니다. 당신은에서 얻는다rtf백엔드. 아직, 특히 사용하지 않는 간단한 문서에 대해 잘 작동합니다. 테이블, 그리고 둘 다jadetex및 스타일 시트는 지속적인 개선 중입니다 확실히 시간이 지남에 따라 더 나아집니다.
젠 토토 및 사용하려면jadetex, 당신 의 작업 젠 토토가 필요합니다.TexandLATEX2E, 지원되는 것을 포함하여도구and그래픽패키지,babel, ams글꼴andAMS-LATEX, ThePSNFSS확장 및 동반자 키트 "35 글꼴",DVIPS프로그램 생성을 위해PostScript, 매크로 패키지FancyHdr, HyperRef, Minitoc, URLandot2enc및 물론jadetex자체. 이 모든 것이 할 수 있습니다 친절한 동네에서 찾을 수 있습니다CTAN사이트.
jadetex당시에는 그렇지 않습니다 글쓰기는 많은 젠 토토 안내서와 함께 제공되지만가 있습니다.makefile필요한 것을 보여줍니다. 그것 디렉토리도 포함요리, 여기서 필요한 매크로 패키지 중 일부를 찾을 수는 있지만 전부는 아닙니다. 완전하지 않음 - 적어도 우리는 마지막으로 보았습니다.
건설 전jadetex.fmt형식 파일, 아마도를 편집하고 싶을 것입니다.jadetex.ltx파일, 구성 변경바벨귀하의 지역에 맞게. 그만큼 변경하는 선은
\ 요구 사항 [독일어, 프랑스어, 영어] babel [1997/01/23]그리고 당신은 실제로 당신이 실제로 언어 만 나열해야합니다. 필요하고 구성바벨for.
withjadetex일하는, 당신 생성 및 형식을 생성 할 수 있어야합니다Tex출력PostgreSQL명령을 제공하여 매뉴얼 (AS 위에서,doc/src/sgml디렉토리)
jade -t tex -d /usr/local/share/docbook/print/docbook.dsl -d ../graphics postgres.sgml jadetex postgres.tex jadetex postgres.tex dvips postgres.dvi물론, 당신이 할 때,Tex두 번째 달리기 중에 멈추고 말합니다 당신은 그 용량이 초과되었다고 생각합니다. 이것은 우리가 할 수있는 한입니다 말해봐, 길 때문에jadetex크로스 참조 정보 생성.Tex물론 더 큰 상태로 컴파일 할 수 있습니다 데이터 구조 크기. 이것의 세부 사항은 다음에 따라 다릅니다 젠 토토.