code2html - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

code2html - перетворює вихідний код програми в HTML

СИНТАКСИС

(1) code2html [опції] [вхідний файл [вихідний файл]]

(2) code2html -p [файл [альтернативний вихідний файл]]

(3) code2html (як сценарій CGI; див. розділ про CGI)

ОПИС

code2html це сценарій на Perl, який перетворює вихідний код програми у виділений синтаксис
HTML або будь-який інший формат, для якого визначено правила.

(1) ВАРІАНТИ
вхідний файл
Це файл, який містить вихідний код програми, який потрібно відформатувати. Якщо ні
якщо вказано мінус (-), код буде зчитуватися з STDIN.

вихідний файл
Це файл для запису відформатованого коду. Якщо не вказано або є мінус (-).
враховуючи, код буде записано в STDOUT.

-l, --мовний режим
Вкажіть набір регулярних виразів для використання. Вони мають бути визначені в а
мовний файл (див ФАЙЛИ нижче). Щоб дізнатися, які мовні режими визначені,
випуск а code2html -- режими.

Цей вхід не чутливий до регістру.

Якщо не вказано, для визначення мови файлу буде використано деякі евристики.

-v, -багатослівний
Друкує інформацію про прогрес у STDERR.

-n, --номери рядків
Роздрукуйте вихідний код з номерами рядків.

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

-P, --префікс
Необов’язковий префікс для прив’язки номерів рядків.

-t, --замінити вкладки[=ТАБЛИЦЯ-ШИРИНА]
Замініть кожне повторення a символ із потрібною кількістю пробілів
до наступної вкладки. За замовчуванням ширина зупинки табуляції становить 8 символів.

-L, --мова-файл=МОВА-ФАЙЛ
Вкажіть альтернативний файл, з якого братиме визначення мови та вихідного формату
(див. розділ про ФАЙЛИ нижче).

-m, -- режими
Надрукуйте всі мовні режими та вихідні формати, які наразі визначені в STDOUT, і вийдіть
успішно. Також друкує режими з a МОВА-ФАЙЛ дається --мова-файл if
застосовується.

--відступати=МОВА
Якщо мовний режим, заданий с --мовний режим не можна знайти, тоді скористайтеся цим
Режим.

--відступати простий наприклад, корисно, коли code2html викликається зі сценарію до
переконатися, що вихідні дані створені.

-h, --допомога
Надрукуйте коротку довідку та успішно вийдіть.

-V, -- версія
Роздрукуйте версію програми та успішно вийдіть.

-c, --тип вмісту
Друкує "Content-Type: text/html\n\n" (або будь-який інший вихідний формат, який визначає як
content-type) перед рештою виводу. Корисно, якщо сценарій викликається як
cgi скрипт.

-o, --формат виведення
Вибирає вихідний формат. html за замовчуванням. Щоб дізнатися, які вихідні формати
визначено, випуск а code2html -- режими.

-H, --без заголовка
не використовуйте шаблон, визначений вихідним форматом. Для HTML це означає
що не буде , , і ні
теги.

--шаблон=Фото
замінює шаблон за замовчуванням для заданого формату виведення. Якщо --без заголовка is
це також не має значення, оскільки шаблон все одно ігнорується.

-T, -- назва
Встановіть назву створеного вихідного файлу. Працює, лише якщо шаблон працює
підтримка встановлення назви.

-w, --ширина лінії=ШИРИНА ЛІНІЇ
Оберніть рядки після ШИРИНА ЛІНІЇ символів. За замовчуванням не переносять рядки взагалі.

-b, --префікс розриву рядка=LINEPREFIX
Скористайтесь FILINEPREFIX на початку обгорнутих рядків. За замовчуванням «»».

(2) HTML латка
code2html -p [файл [альтернативний вихідний файл]]

code2html також дозволяє мати вбудований вихідний код у файлі html. Тоді це може прийняти
цей html-файл і вставте виділений синтаксис код.

Якщо файл не надано, code2html читає з STDIN і записує в STDOUT. Якщо є лише один файл
враховуючи, що він замінює цей файл вихідним. Якщо надано два файли, то перший
читати з, а другий записувати.

Щоб скористатися цією функцією, просто вставте подібне до свого html-файлу:

-->

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

Всі параметри, які можна задати в командному рядку, як --номери рядків тощо робота. --допомога,
-- версія, тощо також працюють, але використовувати їх не дуже розумно :). Використання
--формат виведення не рекомендується вибирати вихідний формат, відмінний від HTML. --тип вмісту is
ігнорується.

Ви також можете написати вихідний код програми безпосередньо у файлі html із наступним
синтаксис:

<!-- code2html add [параметри]



->

Зазвичай гарна ідея принаймні дати --мовний режим можливість вказати
мова.

(3) CGI
Якщо сценарій використовується як сценарій CGI (GATEWAY_INTERFACE середовище набір і ні
наведені аргументи командного рядка) code2html читає аргументи або з рядка запиту
або з SDTIN. (методи POST і GET).

--тип вмісту вмикається автоматично, а вихід завжди переходить на STDOUT.

Приймаються такі параметри/опції:

мовний режим - за бажанням
`c', `cc', `pas' тощо.

якщо не вказано, для визначення мови використовуються деякі евристики.

відступати - за бажанням
`plain', `c' тощо, якщо мовний режим не знайдено, використовуйте цей

вхід-селектор - за бажанням
або "файл", "cgi-input1", "cgi-input2" або "REDIRECT_URL"

за замовчуванням: файл

ім'я файлу
файл для читання з if вхід-селектор є `файлом'

cgi-вхід1
Вихідний код для виділення синтаксису. Наприклад від а або від а
завантажити. Побачити вхід-селектор.

cgi-вхід2
Вихідний код для виділення синтаксису. Наприклад від а або від а
завантажити. Побачити вхід-селектор.

номери рядків - за бажанням
"так", "ні" або "посилання"

за замовчуванням: ні

замінити вкладки - за бажанням
Якщо 0, то вкладки не замінюються, інакше заміняйте кожну зустріч a характер
з потрібною кількістю пробілів, щоб перейти до наступної вкладки.

за замовчуванням: 0

назву - за бажанням
Встановити назву файлу.

без кодування - за бажанням
За замовчуванням code2html намагається закодувати вихід як будь-який bz2/gz/Z якщо клієнт
підтримує це (HTTP_ACCEPT_ENCODING) і необхідна програма доступна на сайті
сервер. Можливо, вам знадобиться змінити @CGI_ENCODING у сценарії, щоб відповідати вашій програмі
Місця розташування

If без кодування визначається як «правдивий» code2html не намагається кодувати вихід.

Чому два cgi-входи ви можете запитати: Це дозволить вашим користувачам вибирати через a
інтерфейсу, чи хочуть вони вставити свій файл у a або користувач <browse>
кнопку, щоб вибрати їхній файл. Дивіться приклад на моїй домашній сторінці.

Зауважте, що якщо $FILES_DISALLOWED_IN_CGI is 0 це можливо для ваших користувачів прочитати всі
файли, які може читати httpd (якщо ви не запускаєте cgi-wrapper чи щось подібне
за замовчуванням це значення встановлено на 1, тому читання файлів за допомогою cgi заборонено. Ти можеш
дозволити це з налаштуванням $FILES_DISALLOWED_IN_CGI до 0 у верхній частині сценарію.

Селектор входу REDIRECT_URL потребує спеціального пояснення. Ім’я файлу формується з
дві змінні середовища DOCUMENT_ROOT та REDIRECT_URL.

Якщо ви хочете, щоб apache автоматично викликав code2html для всіх файлів вихідного коду програми
можна зробити це, додавши ці два рядки до вашого srm.conf:

AddHandler text/x-sourcecode .c .cc .cpp .pas .h .p

Текст дії/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

або щось подібне до цього. У рядку AddHandle ви можете вибрати, які розширення використовувати
проходити через code2html.

УВАГА: Не додавайте .pl до цього рядка і назвіть цей сценарій “code2html.pl”. Це буде результатом
у циклі.

Також переконайтеся, що ви завантажили модуль Action (srm.conf).

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

Tnx Кевіну Бертону[захищено електронною поштою]> за ідею. Він також стверджує, що

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

приклад

припускаючи code2html знаходиться в поточному каталозі, ви можете ввести

code2html -l perl code2html.pl code2html.html

щоб перетворити скрипт у файл html.

Використовуйте code2html онлайн за допомогою служб onworks.net