모든 설정이 완료되면 디렉토리로 변경하십시오.doc/src/sgml그리고 다음 하위 섹션에 설명된 명령 중 하나를 실행하여 문서를 작성하세요. (GNU make를 사용하는 것을 잊지 마세요.)
빌드하려면HTML문서 버전:
doc/src/sgml$HTML 만들기
이것은 또한 기본 목표입니다. 출력은 하위 디렉터리에 나타납니다.html.
다음에 사용된 스타일시트로 HTML 문서를 생성하려면토토 꽁 머니 : 문서 : 17 : 토토 꽁 머니 17.4 문서화기본 단순 스타일 대신 다음을 사용하세요.
doc/src/sgml$make STYLE=웹사이트 HTML
만약STYLE=웹사이트옵션이 사용되면 생성된 HTML 파일에는 다음에서 호스팅되는 스타일시트에 대한 참조가 포함됩니다.토토 꽁 머니 : 문서 : 17 : 토토 꽁 머니 17.4 문서화보려면 네트워크 액세스가 필요합니다.
우리는 DocBook XSL 스타일시트를 사용하여 변환합니다.문서북 재입국12545_12635
doc/src/sgml$사람을 만드세요
다음을 사용하여 문서의 PDF 변환을 생성하려면FOP, 선호하는 용지 형식에 따라 다음 명령 중 하나를 사용할 수 있습니다.
A4 형식의 경우:
doc/src/sgml$make postgres-A4.pdf
미국 문자 형식의 경우:
doc/src/sgml$make postgres-US.pdf
PostgreSQL 문서가 상당히 방대하기 때문에,FOP상당한 양의 메모리가 필요합니다. 이로 인해 일부 시스템에서는 메모리 관련 오류 메시지와 함께 빌드가 실패합니다. 이 문제는 일반적으로 구성 파일에서 Java 힙 설정을 구성하여 해결할 수 있습니다.~/.foprc, 예:
# FOP 바이너리 배포 FOP_OPTS='-Xmx1500m' # 데비안 JAVA_ARGS='-Xmx1500m' # 레드햇 ADDITIONAL_FLAGS='-Xmx1500m'
필요한 최소 메모리 양이 있으며 어느 정도 더 많은 메모리를 사용하면 작업이 좀 더 빨라지는 것으로 보입니다. 메모리가 매우 적은(1GB 미만) 시스템에서는 스와핑으로 인해 빌드가 매우 느리거나 전혀 작동하지 않습니다.
다른 XSL-FO 프로세서도 수동으로 사용할 수 있지만 자동화된 빌드 프로세스는 FOP만 지원합니다.
더 나은 읽기 도구를 사용할 수 없는 상황에서 필요한 경우 설치 지침은 일반 텍스트로도 배포됩니다.설치파일은 다음에 해당함토토 커뮤니티 : 문서 : 14 : 17 장. 소스 코드에서 설치, 다른 상황을 설명하기 위해 약간의 변경이 이루어졌습니다. 파일을 다시 생성하려면 디렉터리로 변경하세요.doc/src/sgml그리고 입력설치하기. 텍스트 출력을 작성하려면 다음이 필요합니다.판독추가 빌드 도구로 버전 1.13 이상.
과거에는 릴리스 노트와 회귀 테스트 지침도 일반 텍스트로 배포되었지만 이 관행은 중단되었습니다.
문서 작성에는 매우 오랜 시간이 걸릴 수 있습니다. 하지만 문서 파일의 올바른 구문을 확인하는 방법이 있습니다. 이 과정은 몇 초 밖에 걸리지 않습니다.
doc/src/sgml$확인하세요
문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 경험이 있거나 추가 설명이 필요한 경우 이용해주세요이 양식문서 문제를 보고합니다.