code2html - Интернет в облаке

ПРОГРАММА:

ИМЯ

code2html - конвертирует исходный код программы в HTML.

СИНТАКСИС

(1) код2html [кредита] [входной файл [выходной файл]]

(2) код2html -p [файл [альтернативный аутфил]]

(3) код2html (как сценарий CGI; см. раздел о CGI)

ОПИСАНИЕ

код2html это сценарий Perl, который преобразует исходный код программы в выделенный синтаксис
HTML или любой другой формат, для которого определены правила.

(1) ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ
входной файл
Файл, содержащий исходный код программы для форматирования. Если не
или указан минус (-), код будет прочитан из STDIN.

выходной файл
Файл, в который нужно записать форматированный код. Если не указано или стоит минус (-)
учитывая, код будет записан в STDOUT.

-l, --language-mode
Укажите набор используемых регулярных выражений. Они должны быть определены в
языковой файл (см. FILES ниже). Чтобы узнать, какие языковые режимы определены,
выдать код2html - режимы.

Этот ввод обрабатывается без учета регистра.

Если не указан, для определения языка файла будет использована эвристика.

-v, --подробный
Печатает информацию о ходе выполнения в STDERR.

-n, - постельные номера
Распечатайте исходный код с номерами строк.

-N, --linknumbers
Распечатайте исходный код с номерами строк. Номера будут ссылаться на
сами по себе, что позволяет легко отправлять ссылки на строки.

-P, --приставка
Необязательный префикс для использования для привязки номеров строк.

-t, --replace-вкладки[=ТАБСТОП-ШИРИНА]
Замените каждое появление символ с нужным количеством пробелов, чтобы получить
к следующей позиции табуляции. По умолчанию ширина табуляции составляет 8 символов.

-L, --language-файл=ЯЗЫК-ФАЙЛ
Укажите альтернативный файл, из которого будут взяты определения языка и формата вывода.
(см. раздел о FILES ниже).

-m, - режимы
Распечатать все языковые режимы и форматы вывода, определенные в настоящий момент, в STDOUT и выйти.
успешно. Также печатает режимы из ЯЗЫК-ФАЙЛ дано --language-файл if
применимо.

--отступать=ДЛИННЫЙ
Если языковой режим задан --language-mode не может быть найдено, тогда используйте это
Режим.

--отступать простой например, полезно, когда код2html вызывается из сценария в
убедитесь, что вывод создан.

-h, --Помогите
Распечатайте краткую справку и успешно выйдите.

-V, --версия
Распечатайте версию программы и успешно выйдите.

-c, --Тип содержимого
Печатает «Content-Type: text / html \ n \ n» (или любой другой формат вывода, определяемый как
content-type) перед остальной частью вывода. Полезно, если скрипт вызывается как
скрипт cgi.

-o, --Формат вывода
Выбирает выходной формат. html используется по умолчанию. Чтобы узнать, какие форматы вывода
определены, выпустить код2html - режимы.

-H, --нет заголовка
не используйте шаблон, определенный форматом вывода. Для HTML это означает
что не будет , , и нет
теги.

--шаблон=ФАЙЛОВ
отменяет шаблон по умолчанию для данного формата вывода. Если --нет заголовка is
при условии, что это не имеет значения, поскольку шаблон все равно игнорируется.

-T, --заглавие
Задайте заголовок создаваемого выходного файла. Работает только в том случае, если шаблон
поддержка установки заголовка.

-w, --ширина линии=ШИРИНА ЛИНИИ
Перенести строки после ШИРИНА ЛИНИИ символы. По умолчанию строки вообще не переносятся.

-b, --linebreakprefix=ПРЕФИКС ЛИНИИ
Используйте ФИЛИНЕПРЕФИКС в начале обернутых строк. По умолчанию «» ».

(2) HTML латание
код2html -p [файл [альтернативный аутфил]]

код2html также позволяет иметь встроенный исходный код в html-файле. Тогда это может занять
этот html-файл и вставьте выделенный синтаксисом код.

Если файл не указан, код2html читает из STDIN и записывает в STDOUT. Если только один файл
учитывая, что он заменяет этот файл выводом. Если предоставлены два файла, первым будет
прочитал и второй записал.

Чтобы использовать эту функцию, просто вставьте что-то вроде этого в свой html-файл:

-->

выделенный синтаксис файл будет вставлен в эту позицию, заключенную в теги.

Все параметры, которые можно указать в командной строке, например - постельные номера и т.д. работают. --Помогите,
--версияи т.п. тоже работают, но пользоваться ими не очень разумно :). С использованием
--Формат вывода не рекомендуется выбирать выходной формат, отличный от HTML. --Тип содержимого is
игнорируются.

Вы также можете написать исходный код программы прямо в html-файле со следующими
синтаксис:

<!-- code2html добавить [опции]



->

Обычно рекомендуется хотя бы дать --language-mode возможность указать
язык.

(3) CGI
Если сценарий используется как сценарий CGI (GATEWAY_INTERFACE набор среды и нет
указаны аргументы командной строки) код2html читает аргументы либо из строки запроса
или из SDTIN. (методы POST и GET).

--Тип содержимого включается автоматически, и выход всегда переходит в режим STDOUT.

Принимаются следующие параметры / опции:

языковой режим - необязательный
c, cc, pas и т. д.

если не указан, для определения языка используются некоторые эвристики.

отступление - необязательный
`plain ',` c' и т. д., если языковой режим не может быть найден, используйте этот

вход-селектор - необязательный
либо `file ',` cgi-input1', `cgi-input2 ', или` REDIRECT_URL'

по умолчанию: файл

имя файла
файл для чтения, если вход-селектор это `файл '

cgi-input1
Исходный код для выделения синтаксиса. Например из или из
загрузить. Видеть вход-селектор.

cgi-input2
Исходный код для выделения синтаксиса. Например из или из
загрузить. Видеть вход-селектор.

номера строк - необязательный
`да ',` нет' или `ссылка '

по умолчанию: нет

заменить вкладки - необязательный
Если 0, вкладки не заменяются, иначе заменяйте каждое появление персонаж
с нужным количеством пробелов, чтобы перейти к следующей позиции табуляции.

по умолчанию: 0

название - необязательный
Установить заголовок файла.

без кодирования - необязательный
По умолчанию код2html пытается закодировать вывод как bz2/gz/Z если клиент
поддерживает это (HTTP_ACCEPT_ENCODING) и нужная программа доступна на
сервер. Вам может потребоваться изменить @CGI_ENCODING в скрипте, чтобы соответствовать вашей программе
местах.

If без кодирования определяется как «истинный» код2html не пытается кодировать вывод.

Вы можете спросить, почему два cgi-input: Это позволяет вашим пользователям выбирать
интерфейса, хотят ли они вставить свой файл в или используйте <browse>
кнопку, чтобы выбрать их файл. См. Пример на моей домашней странице.

Обратите внимание, что если $ FILES_DISALLOWED_IN_CGI 0, ваши пользователи могут читать все
файлы, которые httpd может читать (если вы не запускаете cgi-wrapper или что-то в этом роде.
по умолчанию это значение установлено на 1, поэтому чтение файлов через cgi не должно быть разрешено. Вы можете
разрешить это с настройкой $ FILES_DISALLOWED_IN_CGI до 0 в верхней части скрипта.

Селектор входа REDIRECT_URL требует специального объяснения. Имя файла формируется из
две переменные среды DOCUMENT_ROOT и REDIRECT_URL.

Если вы хотите, чтобы apache автоматически звонил код2html для всех файлов исходного кода программы, которые вы
можете сделать это, добавив эти две строки в ваш srm.conf:

AddHandler текст / x-исходный код .c .cc .cpp .pas .h .p

Текст действия / x-sourcecode / cgi-bin / code2html? Input-selector = REDIRECT_URL & foo =

или что-то подобное. В строке AddHandle вы можете выбрать, какие расширения
проходить через код2html.

ПРЕДУПРЕЖДЕНИЕ: Не добавляйте .pl к этой строке и назовите этот скрипт «code2html.pl». Это приведет к
в петле.

Также убедитесь, что вы загрузили модуль Action (srm.conf).

Замените / cgi-bin / code2html виртуальным расположением, из которого можно получить доступ к файлу.
Обратите внимание на часть «foo =». Apache добавляет URL-адрес файла для отображения в конце
часть действия. Нам это не нужно, так как мы используем переменную окружения REDIRECT_URL
однако мы не хотим, чтобы URL-адрес добавлялся к строке селектора ввода. Поэтому мы
добавьте часть «& foo =».

Tnx Кевину Бертону[электронная почта защищена]> за идею. Он также заявляет, что

> Он будет более мощным, если вы используете его в Apache.
> ярлык
>
>
>
> # здесь с вашим тегом Action ... таким образом вы можете
> # на вашем сервере все еще есть обычные файлы .java.
>
>
>

ПРИМЕР

при условии, код2html находится в текущем каталоге, вы можете ввести

code2html -l perl code2html.pl code2html.html

для преобразования скрипта в HTML-файл.

Используйте code2html онлайн с помощью сервисов onworks.net