code2html – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

code2html – Konvertiert einen Programmquellcode in HTML

ZUSAMMENFASSUNG

(1) code2html [Optionen] [Eingabedatei [Ausgabedatei]]

(2) code2html -p [Datei [alternative-outfile]]

(3) code2html (als CGI-Skript; siehe Abschnitt über CGI)

BESCHREIBUNG

code2html ist ein Perl-Skript, das den Quellcode eines Programms in eine hervorgehobene Syntax umwandelt
HTML oder ein anderes Format, für das Regeln definiert sind.

(1) OPTIONAL
Eingabedatei
Ist die Datei, die den zu formatierenden Programmquellcode enthält. Wenn nicht
angegeben oder ein Minus (-) angegeben wird, wird der Code aus STDIN gelesen.

Ausgabedatei
Ist die Datei, in die der formatierte Code geschrieben werden soll. Wenn nichts angegeben oder ein Minus (-) ist
gegeben, wird der Code nach STDOUT geschrieben.

-l, --Sprachmodus
Geben Sie den Satz der zu verwendenden regulären Ausdrücke an. Diese müssen in a definiert werden
Sprachdatei (siehe DATEIEN unten). Um herauszufinden, welche Sprachmodi definiert sind,
Ausgabe a code2html --modi.

Bei dieser Eingabe wird die Groß-/Kleinschreibung nicht beachtet.

Wenn nicht angegeben, werden einige Heuristiken verwendet, um die Dateisprache zu bestimmen.

-v, - ausführlich
Druckt Fortschrittsinformationen an STDERR.

-n, --Linien Nummern
Drucken Sie den Quellcode mit Zeilennummern aus.

-N, --linknumbers
Drucken Sie den Quellcode mit Zeilennummern aus. Die Zeilennummern werden verlinkt
selbst, wodurch es einfach ist, Links an Leitungen zu senden.

-P, prefix
Optionales Präfix zur Verwendung für Zeilennummernanker.

-t, --replace-tabs[=TABSTOP-BREITE]
Ersetzen Sie jedes Vorkommen von a Charakter mit der richtigen Menge an Leerzeichen zu bekommen
zum nächsten Tabstop. Standardmäßig beträgt die Tabstoppbreite 8 Zeichen.

-L, --Sprachdatei=SPRACHDATEI
Geben Sie eine alternative Datei an, aus der die Sprach- und Ausgabeformatdefinitionen übernommen werden sollen
(siehe Abschnitt über DATEIEN unten).

-m, --modi
Alle aktuell definierten Sprachmodi und Ausgabeformate auf STDOUT ausgeben und beenden
erfolgreich. Druckt auch Modi von a SPRACHDATEI gegeben durch --Sprachdatei if
anwendbar.

--Zurückfallen=SPRACHE
Wenn der mit angegebene Sprachmodus --Sprachmodus nicht gefunden werden kann, verwenden Sie dies
Modus arbeiten können.

--Zurückfallen Ebene ist zum Beispiel nützlich, wenn code2html wird von einem Skript aufgerufen
Stellen Sie sicher, dass eine Ausgabe erstellt wird.

-h, --help
Drucken Sie eine kurze Hilfe aus und beenden Sie den Vorgang erfolgreich.

-V, --Version
Drucken Sie die Programmversion aus und beenden Sie das Programm erfolgreich.

-c, --Inhaltstyp
Gibt „Content-Type: text/html\n\n“ aus (oder was auch immer das Ausgabeformat als definiert).
Inhaltstyp) vor dem Rest der Ausgabe. Nützlich, wenn das Skript aufgerufen wird als
ein CGI-Skript.

-o, --Ausgabeformat
Wählt das Ausgabeformat. html ist die Standardeinstellung. Um herauszufinden, welche Ausgabeformate
definiert sind, geben Sie a aus code2html --modi.

-H, --no-header
Verwenden Sie nicht die durch das Ausgabeformat definierte Vorlage. Für HTML bedeutet dies
dass es keine geben wird , , und nein
Stichworte.

--Vorlage=FILE
überschreibt die Standardvorlage für das angegebene Ausgabeformat. Wenn --no-header is
Auch gegeben hat dies keine Bedeutung, da die Vorlage sowieso ignoriert wird.

-T, --Titel
Legen Sie den Titel der erzeugten Ausgabedatei fest. Funktioniert nur, wenn die Vorlage dies tut
Unterstützung beim Festlegen des Titels.

-w, --Linienbreite=LINIENBREITE
Zeilen danach umbrechen LINIENBREITE Figuren. Standardmäßig werden Zeilen überhaupt nicht umbrochen.

-b, --linebreakprefix=LINEPREFIX
Verwenden Sie die fiLINEPREFIX am Anfang umbrochener Zeilen. Der Standardwert ist „»“.

(2) HTML Patching
code2html -p [Datei [alternative-outfile]]

code2html ermöglicht es Ihnen auch, Inline-Quellcode in einer HTML-Datei zu haben. Es kann dann dauern
Öffnen Sie diese HTML-Datei und fügen Sie den syntaktisch hervorgehobenen Code ein.

Wenn keine Datei angegeben ist, code2html liest von STDIN und schreibt nach STDOUT. Wenn nur eine Datei vorhanden ist
vorausgesetzt, es ersetzt diese Datei durch die Ausgabe. Wenn zwei Dateien bereitgestellt werden, ist die erste
gelesen von und der zweite geschrieben.

Um diese Funktion zu nutzen, fügen Sie einfach ein Like wie dieses in Ihre HTML-Datei ein:

-->

Die syntaxhervorgehobene Datei wird an dieser Position in eingefügt Stichworte.

Alle Optionen, die in der Befehlszeile angegeben werden können, z --Linien Nummern usw. funktionieren. --help,
--Versionusw. funktionieren auch, aber es ist nicht sehr intelligent, sie zu verwenden :). Benutzen
--Ausgabeformat Es ist nicht ratsam, ein Nicht-HTML-Ausgabeformat zu wählen. --Inhaltstyp is
ignoriert.

Sie können den Quellcode des Programms auch wie folgt direkt in die HTML-Datei schreiben
Syntax:

<!-- code2html add [Optionen]



->

Normalerweise ist es eine gute Idee, das zumindest zu geben --Sprachmodus Option zur Angabe der
Sprache.

(3) CGI
Wenn das Skript als CGI-Skript verwendet wird (GATEWAY_INTERFACE Umgebungssatz und Nr
angegebene Befehlszeilenargumente) code2html liest die Argumente entweder aus der Abfragezeichenfolge
oder von SDTIN. (Methoden POST und GET).

--Inhaltstyp wird automatisch eingeschaltet und der Ausgang geht immer auf STDOUT.

Folgende Parameter/Optionen werden akzeptiert:

Sprachmodus - Optional
„c“, „cc“, „pas“ usw.

Wenn nicht angegeben, werden einige Heuristiken verwendet, um die Sprache herauszufinden.

Fallback- - Optional
„plain“, „c“ usw. Wenn der Sprachmodus nicht gefunden werden kann, verwenden Sie diesen

Eingangsselektor - Optional
entweder „file“, „cgi-input1“, „cgi-input2“ oder „REDIRECT_URL“

Standard: Datei

Dateinamen
Datei, aus der if gelesen werden soll Eingangsselektor ist „Datei“

cgi-input1
Hervorhebung des Quellcodes zur Syntax. Zum Beispiel von a oder von a
hochladen. Sehen Eingangsselektor.

cgi-input2
Hervorhebung des Quellcodes zur Syntax. Zum Beispiel von a oder von a
hochladen. Sehen Eingangsselektor.

Linien Nummern - Optional
„Ja“, „Nein“ oder „Link“

Standard: Nein

Tabs ersetzen - Optional
Wenn 0, werden Tabulatoren nicht ersetzt, andernfalls wird jedes Vorkommen von a ersetzt Charakter
mit der richtigen Anzahl an Leerzeichen, um zum nächsten Tabstopp zu gelangen.

Standard: 0

Titel - Optional
Legt den Titel der Datei fest.

Keine Kodierung - Optional
Standardmäßig code2html versucht, die Ausgabe als eines von beiden zu kodieren bz2/gz/Z wenn der Kunde
unterstützt dies (HTTP_ACCEPT_ENCODING) und das benötigte Programm ist auf der verfügbar
Server. Möglicherweise müssen Sie Änderungen vornehmen @CGI_ENCODING im Skript passend zu Ihrem Programm
Standorte.

If Keine Kodierung wird als „wahr“ definiert code2html versucht nicht, die Ausgabe zu kodieren.

Warum zwei CGI-Eingaben Sie fragen könnten: Dies dient dazu, Ihren Benutzern die Auswahl über eine zu ermöglichen
Schnittstelle, ob sie ihre Datei in eine einfügen möchten oder Benutzer a <browse>
Klicken Sie auf die Schaltfläche, um ihre Datei auszuwählen. Siehe das Beispiel auf meiner Homepage.

Beachten Sie, dass wenn $FILES_DISALLOWED_IN_CGI 0 ist, ist es für Ihre Benutzer möglich, alles zu lesen
Dateien, die der httpd lesen kann (wenn Sie keinen CGI-Wrapper oder ähnliches ausführen. Von
Standardmäßig ist dieser Wert auf 1 gesetzt, daher sollte das Lesen von Dateien über CGI nicht erlaubt sein. Du kannst
Erlaube es mit der Einstellung $FILES_DISALLOWED_IN_CGI auf 0 am Anfang des Skripts.

Der Eingangsselektor REDIRECT_URL bedarf einer besonderen Erklärung. Der Dateiname wird gebildet aus
die beiden Umgebungsvariablen DOCUMENT_ROOT und REDIRECT_URL.

Wenn Sie möchten, dass Apache automatisch anruft code2html für alle Programmquellcodedateien, die Sie erhalten
Sie können dies tun, indem Sie diese beiden Zeilen zu Ihrer srm.conf hinzufügen:

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

Aktion text/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

oder so ähnlich. In der AddHandle-Zeile können Sie auswählen, welche Erweiterungen verwendet werden sollen
durchgehen code2html.

WARNUNG: Fügen Sie dieser Zeile kein .pl hinzu und nennen Sie dieses Skript „code2html.pl“. Dies wird zur Folge haben
in einer Schleife.

Stellen Sie außerdem sicher, dass Sie das Aktionsmodul (srm.conf) laden.

Ersetzen Sie /cgi-bin/code2html durch den virtuellen Speicherort, unter dem auf die Datei zugegriffen werden kann.
Beachten Sie den Teil „foo=“. Apache hängt die URL der anzuzeigenden Datei am Ende an
Aktionsteil. Wir brauchen dies nicht, da wir die Umgebungsvariable verwenden REDIRECT_URL
Wir möchten jedoch nicht, dass die URL zur Eingabeauswahlzeichenfolge hinzugefügt wird. Deshalb wir
Hängen Sie den Teil „&foo=“ an.

Danke an Kevin Burton[E-Mail geschützt] > für die Idee. Das gibt er auch an

> Es ist leistungsfähiger, wenn Sie es in einem Apache verwenden
> Etikett
>
>
>
> #mit Ihrem Action-Tag hier... so können Sie es tun
> #immer noch reguläre .java-Dateien auf Ihrem Server.
>
>
>

BEISPIEL

angenommen code2html sich im aktuellen Verzeichnis befindet, können Sie eingeben

code2html -l perl code2html.pl code2html.html

um das Skript in eine HTML-Datei zu konvertieren.

Verwenden Sie code2html online über die Dienste von onworks.net