J.3. Make를 사용하여 문서 작성#

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

J.3.1. HTML#

빌드하려면HTML문서 버전:

doc/src/sgml$HTML 만들기

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

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

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

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

J.3.2. 맨페이지#

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

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

J.3.3. PDF#

다음을 사용하여 문서의 PDF 변환을 생성하려면FOP, 선호하는 용지 형식에 따라 다음 명령 중 하나를 사용할 수 있습니다.

  • A4 형식의 경우:

    doc/src/sgml$토토 사이트 순위 postgres-A4.pdf
    
  • 미국 문자 형식의 경우:

    doc/src/sgml$토토 사이트 순위 postgres-US.pdf
    

PostgreSQL 문서가 상당히 방대하기 때문에,FOP상당한 양의 메모리가 필요합니다. 이로 인해 일부 시스템에서는 메모리 관련 오류 메시지와 함께 빌드가 실패합니다. 이 문제는 일반적으로 구성 파일에서 Java 힙 설정을 구성하여 해결할 수 있습니다.~/.foprc, 예:

# FOP 바이너리 배포
FOP_OPTS='-Xmx1500m'
# 데비안
JAVA_ARGS='-Xmx1500m'
# 레드햇
ADDITIONAL_FLAGS='-Xmx1500m'

필요한 최소 메모리 양이 있으며, 어느 정도 더 많은 메모리가 작업을 좀 더 빠르게 만드는 것으로 보입니다. 메모리가 매우 적은(1GB 미만) 시스템에서는 스와핑으로 인해 빌드가 매우 느리거나 전혀 작동하지 않습니다.

기본 구성에서FOP을 방출합니다정보각 페이지에 대한 메시지입니다. 로그 수준은 다음을 통해 변경할 수 있습니다.~/.foprc:

LOGCHOICE=-Dorg.apache.commons.logging.Log=​org.apache.commons.logging.impl.SimpleLog
LOGLEVEL=-Dorg.apache.commons.logging.simplelog.defaultlog=WARN

다른 XSL-FO 프로세서도 수동으로 사용할 수 있지만 자동화된 빌드 프로세스는 FOP만 지원합니다.

J.3.4. 구문 확인#

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

doc/src/sgml$확인하세요

수정사항 제출

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