pod2html

СОДЕРЖАНИЕ

• ИМЯ
• СИНТАКСИС
• ОПИСАНИЕ
• АРГУМЕНТЫ
• АВТОР
• ОШИБКИ
• СМОТРИТЕ ТАКЖЕ
• АВТОРСКИЕ ПРАВА

ИМЯ

pod2html - преобразовать файлы .pod в файлы .html

СИНТАКСИС

pod2html --help --htmldir=<name> --htmlroot=<URL>
         --infile=<name> --outfile=<name>
         --podpath=<name>:...:<name> --podroot=<name>
         --cachedir=<name> --flush --recurse --norecurse
         --quiet --noquiet --verbose --noverbose
         --index --noindex --backlink --nobacklink
         --header --noheader --poderrors --nopoderrors
         --css=<URL> --title=<name>

ОПИСАНИЕ

Преобразует файлы из формата pod (см. perlpod) в формат HTML.

АРГУМЕНТЫ

pod2html принимает следующие аргументы:

help

--help

Отображает сообщение об использовании.

htmldir

--htmldir=name

Устанавливает каталог, относительно которого все перекрестные ссылки в результирующем HTML-файле будут относительными. Если этот параметр не указан, все ссылки будут абсолютными, поскольку это значение указывает Pod::Html корень дерева документации.

Не используйте этот параметр и --htmlroot в одном вызове pod2html; они взаимоисключающие.

htmlroot

--htmlroot=URL

Устанавливает базовый URL для HTML-файлов. При создании перекрестных ссылок к URL добавляется корень HTML.

Не используйте этот параметр, если нужны относительные ссылки: используйте --htmldir вместо него.

Не передавайте оба параметра --htmlroot и --htmldir в pod2html; они взаимоисключающие.

infile

--infile=name

Укажите файл pod для преобразования. Входные данные берутся из стандартного ввода, если infile не указан.

outfile

--outfile=name

Укажите HTML-файл для создания. Вывод направляется в стандартный вывод, если outfile не указан.

podroot

--podroot=name

Укажите базовый каталог для поиска под-файлов библиотек.

podpath

--podpath=name:...:name

Укажите подкаталоги каталога podroot, содержащие файлы pod, HTML-версии которых могут быть связаны в перекрестных ссылках.

cachedir

--cachedir=name

Укажите каталог для хранения кэша. По умолчанию используется текущий рабочий каталог.

flush

--flush

Очистить кэш.

backlink

--backlink

Преобразовать директивы =head1 в ссылки, указывающие на начало HTML-файла.

nobacklink

--nobacklink

Не преобразовывать директивы =head1 в ссылки, указывающие на начало HTML-файла (по умолчанию).

header

--header

Создать заголовки и подвалы, содержащие текст раздела "ИМЯ".

noheader

--noheader

Не создавать заголовки и подвалы, содержащие текст раздела "ИМЯ" (по умолчанию).

poderrors

--poderrors

Включить раздел "ОШИБКИ ПОД" в outfile, если в infile были ошибки POD (по умолчанию).

nopoderrors

--nopoderrors

Не включать раздел "ОШИБКИ ПОД" в outfile, если в infile были ошибки POD.

index

--index

Создать оглавление в начале HTML-файла (по умолчанию).

noindex

--noindex

Не создавать оглавление в начале HTML-файла.

recurse

--recurse

Рекурсивно переходить в подкаталоги, указанные в podpath (по умолчанию).

norecurse

--norecurse

Не переходить рекурсивно в подкаталоги, указанные в podpath.

css

--css=URL

Укажите URL каскадной таблицы стилей для ссылки из результирующего HTML-файла. По умолчанию стиль отсутствует.

title

--title=title

Укажите заголовок результирующего HTML-файла.

quiet

--quiet

Не отображать в основном безвредные сообщения об ошибках.

noquiet

--noquiet

Отображать в основном безвредные сообщения об ошибках (по умолчанию). Но это не то же самое, что режим "verbose".

verbose

--verbose

Отображать сообщения о ходе выполнения.

noverbose

--noverbose

Не отображать сообщения о ходе выполнения (по умолчанию).

АВТОР

Tom Christiansen, <tchrist@perl.com>.

ОШИБКИ

См. Pod::Html для списка известных ошибок переводчика.

СМОТРИТЕ ТАКЖЕ

perlpod, Pod::Html

АВТОРСКИЕ ПРАВА

Эта программа распространяется под лицензией Artistic License.