2025년 9월 25일:토토 커뮤니티 : 토토

J.3. 문서 작성

모든 설정이 완료되면 디렉토리로 변경하십시오.doc/src/sgml그리고 다음 하위 섹션에 설명된 명령 중 하나를 실행하여 문서를 작성하세요. (GNU make를 사용하는 것을 잊지 마세요.)

J.3.1. HTML

빌드하려면HTML문서 버전:

doc/src/sgml$HTML 만들기

이것은 또한 기본 목표입니다. 출력은 하위 디렉터리에 나타납니다.html.

다음에 사용된 스타일시트로 HTML 문서를 생성하려면토토 꽁 머니 : 문서 : 17 : 토토 꽁 머니 17.4 문서화기본 단순 스타일 대신 다음을 사용하세요.

doc/src/sgml$make STYLE=웹사이트 HTML

만약STYLE=웹사이트옵션이 사용되면 생성된 HTML 파일에는 다음에서 호스팅되는 스타일시트에 대한 참조가 포함됩니다.토토 꽁 머니 : 문서 : 17 : 토토 꽁 머니 17.4 문서화보려면 네트워크 액세스가 필요합니다.

J.3.2. 맨페이지

우리는 DocBook XSL 스타일시트를 사용하여 변환합니다.문서북 재입국12545_12635

doc/src/sgml$사람을 만드세요

J.3.3. PDF

다음을 사용하여 문서의 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만 지원합니다.

J.3.4. 일반 텍스트 파일

더 나은 읽기 도구를 사용할 수 없는 상황에서 필요한 경우 설치 지침은 일반 텍스트로도 배포됩니다.설치파일은 다음에 해당함토토 커뮤니티 : 문서 : 14 : 17 장. 소스 코드에서 설치, 다른 상황을 설명하기 위해 약간의 변경이 이루어졌습니다. 파일을 다시 생성하려면 디렉터리로 변경하세요.doc/src/sgml그리고 입력설치하기. 텍스트 출력을 작성하려면 다음이 필요합니다.판독추가 빌드 도구로 버전 1.13 이상.

과거에는 릴리스 노트와 회귀 테스트 지침도 일반 텍스트로 배포되었지만 이 관행은 중단되었습니다.

J.3.5. 구문 확인

문서 작성에는 매우 오랜 시간이 걸릴 수 있습니다. 하지만 문서 파일의 올바른 구문을 확인하는 방법이 있습니다. 이 과정은 몇 초 밖에 걸리지 않습니다.

doc/src/sgml$확인하세요

수정사항 제출

문서에 올바르지 않은 내용이 있으면 일치하지 않습니다. 특정 기능에 대한 경험이 있거나 추가 설명이 필요한 경우 이용해주세요이 양식문서 문제를 보고합니다.