Главная страница
Навигация по странице:

  • make html

  • make STYLE=website html

  • make man

  • make postgres-A4.pdf

  • make INSTALL

  • make check

  • лекция. Коды ошибок Postgresql


    Скачать 223.85 Kb.
    НазваниеКоды ошибок Postgresql
    Анкорлекция
    Дата09.01.2023
    Размер223.85 Kb.
    Формат файлаdocx
    Имя файлаLektsia_Prilozhenia_PostgreSQL.docx
    ТипДокументы
    #878367
    страница19 из 30
    1   ...   15   16   17   18   19   20   21   22   ...   30

    Сборка документации


    Завершив все подготовительные действия, перейдите в каталог doc/src/sgml и запустите одну из команд сборки, описанных в следующих подразделах. (Помните, что для сборки нужно использовать GNU make.)

    HTML

    Чтобы собрать HTML-версию документации:

    doc/src/sgml$ make html

    Эта цель сборки также выбирается по умолчанию. Результат помещается в подкаталог html.

    Чтобы получить HTML-документацию со стилем оформления, используемым на сайте postgresql.org, вместо простого стандартного стиля, выполните:

    doc/src/sgml$ make STYLE=website html

    Страницы man


    Для преобразования страниц DocBook refentry в формат *roff, подходящий для страниц man, мы используем стили DocBook XSL. Страницы man также распространяются в архиве tar, подобно HTML-версии. Чтобы создать страницы man, выполните:

    doc/src/sgml$ make man

    PDF

    Чтобы получить документацию в формате PDF, используя FOP, выполните одну из следующих команд, в зависимости от предпочитаемого размера бумаги:

    Для формата A4:

    • doc/src/sgml$ make postgres-A4.pdf

    Для формата U.S. letter:

    • doc/src/sgml$ make postgres-US.pdf

    Так как документация PostgreSQL весьма объёмна, процессору FOP для её обработки требуется много памяти. Поэтому в некоторых системах сборка может прерваться ошибкой, связанной с памятью. Обычно это можно исправить, увеличив объём области кучи Java в файле конфигурации /.foprc, например:

    # Бинарный пакет FOP

    FOP_OPTS='-Xmx1500m'

    # Debian

    JAVA_ARGS='-Xmx1500m'

    # Red Hat

    ADDITIONAL_FLAGS='-Xmx1500m'

    Некоторый объём памяти является минимально необходимым, а если задать больший объём, возможно даже некоторое ускорение сборки. В системах с очень маленьким объёмом памяти (меньше 1 ГБ) сборка либо будет слишком медленной из-за подкачки, либо вообще не будет осуществляться.

    Также можно воспользоваться другими процессорами XSL-FO, запуская их вручную, но автоматическая процедура сборки поддерживает только FOP.

    Простые текстовые файлы


    Инструкции по установке также распространяются в виде обычного текста, на случай, если они понадобятся в ситуации, когда под рукой не окажется средств просмотра более удобного формата. Файл INSTALL соответствует Главе 16, с небольшими изменениями, внесёнными с учётом другого контекста. Чтобы пересоздать этот файл, перейдите в каталог doc/src/sgml и введите make INSTALL.

    В прошлом примечания к выпуску и инструкции по регрессионному тестированию также распространялись в виде простых текстовых файлов, но эта практика была прекращена.

    Проверка синтаксиса


    Сборка всей документации может занять много времени. Но если нужно проверить только синтаксис файлов документации, это можно сделать всего за несколько секунд:

    doc/src/sgml$ make check

    Написание документации


    Форматы SGML и DocBook не страдают от обилия средств их редактирования с открытым исходным кодом. Чаще всего для написания документации используется редактор Emacs/XEmacs в подходящем режиме. В некоторых системах эти редакторы устанавливаются при типичной полной установке.

    Emacs/PSGML

    Режим PSGML — наиболее популярный и мощный режим редактирования документов SGML. При правильной настройке в Emacs он позволяет вставлять теги и проверять корректность разметки. Его также можно использовать для редактирования HTML. Загружаемые файлы, инструкции по установке и подробную документацию вы можете найти на сайте PSGML.

    Необходимо отметить важный момент относительно PSGML: его автор предполагал, что вашим основным каталогом с DTD SGML будет /usr/local/lib/sgml. Если же у вас это каталог /usr/local/share/sgml, вам нужно дополнительно скорректировать предопределённый путь, либо воспользовавшись переменной окружения SGML_CATALOG_FILES, либо настроив соответственно вашу инсталляцию PSGML (как это сделать, можно узнать из его описания).

    Поместите следующие строки в файл /.emacs (изменив пути на подходящие для вашей системы):

    ; ********** для режима SGML (psgml)

    (setq sgml-omittag t)

    (setq sgml-shorttag t)

    (setq sgml-minimize-attributes nil)

    (setq sgml-always-quote-attributes t)

    (setq sgml-indent-step 1)

    (setq sgml-indent-data t)

    (setq sgml-parent-document nil)

    (setq sgml-exposed-tags nil)

    (setq sgml-catalog-files '("/usr/local/share/sgml/catalog"))

    (autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t )

    и добавьте в тот же файл запись для SGML в существующее определение auto-mode-alist:

    (setq

    auto-mode-alist

    '(("\\.sgml$" . sgml-mode)

    ))

    Используя PSGML, вы можете найти удобным вставлять подходящие объявления DOCTYPE в отдельные файлы книги, когда вы редактируете их. Например, редактируя текущий текст, который относится к главе приложений (appendix), вы можете обозначить документ как экземпляр документа «appendix», добавив в него следующую первую строку:

    Это будет означать, что всё и вся, читающее этот SGML, сможет прочитать его правильно, и его корректность можно будет проверить командой nsgmls -s docguide.sgml. (Но вы должны будете убрать эту строку, прежде чем собирать весь комплект документации.)
    1   ...   15   16   17   18   19   20   21   22   ...   30


    написать администратору сайта