code2html - Online in de cloud

PROGRAMMA:

NAAM

code2html - Converteert een programmabroncode naar HTML

KORTE INHOUD

(1) code2html [opties] [Invoer bestand [output-bestand]]

(2) code2html -p [filet [alternatieve-outfile]]

(3) code2html (als een CGI-script; zie het gedeelte over CGI)

PRODUCTBESCHRIJVING

code2html is een perl-script dat een programmabroncode converteert naar gemarkeerde syntaxis
HTML, of elk ander formaat waarvoor regels zijn gedefinieerd.

(1) OPTIES
Invoer bestand
Is het bestand dat de programmabroncode bevat die moet worden geformatteerd. Als niet
opgegeven of een minteken (-) wordt gegeven, wordt de code uit STDIN gelezen.

output-bestand
Is het bestand om de geformatteerde code naar te schrijven. Indien niet opgegeven of een minteken (-) is
gegeven, wordt de code naar STDOUT geschreven.

-l, --taal-modus
Geef de set reguliere expressies op die u wilt gebruiken. Deze moeten worden gedefinieerd in a
taalbestand (zie FILES onderstaand). Om erachter te komen welke taalmodi zijn gedefinieerd,
uitgeven een code2html --modi.

Deze invoer wordt niet hoofdlettergevoelig behandeld.

Indien niet gegeven, zullen enkele heuristieken worden gebruikt om de bestandstaal te bepalen.

-v, --uitgebreid
Drukt voortgangsinformatie af naar STDERR.

-n, --lijn nummers
Print de broncode met regelnummers uit.

-N, --linknummers
Print de broncode met regelnummers uit. De regelnummers zullen linken naar
zelf, wat het gemakkelijk maakt om links naar lijnen te sturen.

-P, --voorvoegsel
Optioneel voorvoegsel om te gebruiken voor lijnnummerankers.

-t, --vervangen-tabbladen[=TABSTOP-BREEDTE]
Vervang elk voorkomen van a personage met het juiste aantal spaties om te krijgen
naar de volgende tabstop. Standaard is een tabstopbreedte van 8 tekens.

-L, --taalbestand=TAAL-BESTAND
Geef een alternatief bestand op om de taal- en uitvoerformaatdefinities uit te halen
(zie het gedeelte over FILES hieronder).

-m, --modi
Druk alle momenteel gedefinieerde taalmodi en uitvoerformaten af ​​naar STDOUT en sluit af
met succes. Drukt ook modi af van een TAAL-BESTAND gegeven door --taalbestand if
van toepassing.

--terugvallen=TAAL
Als de taalmodus wordt gegeven met --taal-modus niet gevonden, gebruik dit dan
modus.

--terugvallen vlakte bijvoorbeeld handig wanneer code2html wordt aangeroepen vanuit een script naar
zorgen dat er output ontstaat.

-h, --help
Druk een korte hulp af en sluit succesvol af.

-V, --versie
Druk de programmaversie af en sluit succesvol af.

-c, --inhoudstype
Drukt "Content-Type: text/html\n\n" af (of wat het uitvoerformaat ook definieert als een
content-type) vóór de rest van de uitvoer. Nuttig als het script wordt aangeroepen als
een cgi-script.

-o, --uitvoer-formaat
Selecteert het uitvoerformaat. html is de standaard. Om erachter te komen welke uitvoerformaten
zijn gedefinieerd, geeft u a code2html --modi.

-H, --geen koptekst
maak geen gebruik van het sjabloon dat wordt gedefinieerd door het uitvoerformaat. Voor HTML betekent dit
dat er geen zal zijn , , en nee
labels.

--sjabloon=FILE
overschrijft de standaardsjabloon voor het opgegeven uitvoerformaat. Als --geen koptekst is
gegeven, heeft dit geen betekenis, aangezien de sjabloon toch wordt genegeerd.

-T, --titel
Stel de titel van het geproduceerde uitvoerbestand in. Werkt alleen als de sjabloon dat doet
ondersteuning bij het instellen van de titel.

-w, --lijnbreedte=LIJNBREEDTE
Wikkel lijnen na LIJNBREEDTE karakters. Standaard is om helemaal geen regels te omwikkelen.

-b, --linebreakvoorvoegsel=LIJNPREFIX
Te gebruiken fILINEPREFIX aan het begin van omwikkelde lijnen. Standaard is "» ".

(2) HTML patching
code2html -p [filet [alternatieve-outfile]]

code2html stelt u ook in staat om inline broncode in een html-bestand te hebben. Het kan dan duren
dit html-bestand en voeg de syntaxis gemarkeerde code in.

Als er geen bestand is opgegeven, code2html leest van STDIN en schrijft naar STDOUT. Als er maar één bestand is
aangezien het dit bestand vervangt door de uitvoer. Als er twee bestanden worden verstrekt, is de eerste
gelezen van en de tweede geschreven naar.

Om deze functie te gebruiken, voegt u gewoon een dergelijke in uw html-bestand in:

-->

het door syntaxis gemarkeerde bestand wordt ingevoegd op deze ingesloten positie labels.

Alle opties die op de opdrachtregel kunnen worden gegeven, zoals --lijn nummers enz. werk. --help,
--versie, enz. werken ook, maar het is niet erg intelligent om ze te gebruiken :). Gebruik makend van
--uitvoer-formaat een niet-HTML uitvoerformaat kiezen is niet aan te raden. --inhoudstype is
buiten beschouwing gelaten.

U kunt de broncode van het programma ook rechtstreeks in het html-bestand schrijven met het volgende
syntaxis:

<!-- code2html voeg [opties] toe



->

Het is meestal een goed idee om op zijn minst de --taal-modus optie om de
taal.

(3) CGI
Als het script wordt gebruikt als een CGI-script (GATEWAY_INTERFACE omgeving ingesteld en nee
opdrachtregelargumenten gegeven) code2html leest de argumenten uit de querystring
of van SDTIN. (methoden POST en GET).

--inhoudstype wordt automatisch ingeschakeld en de uitgang gaat altijd naar STDOUT.

De volgende parameters/opties worden geaccepteerd:

taal-modus - optioneel
`c', `cc', `pas', enz.

indien niet gegeven, worden enkele heuristieken gebruikt om de taal te achterhalen.

fallback - optioneel
`plain', `c', enz. als de taalmodus niet kan worden gevonden, gebruik deze dan

ingangskiezer - optioneel
ofwel `bestand', `cgi-input1', `cgi-input2' of `REDIRECT_URL'

standaard: bestand

bestandsnaam
bestand om uit te lezen als ingangskiezer is `bestand'

cgi-invoer1
De broncode om syntaxis te markeren. Bijvoorbeeld van een of van een
uploaden. Zien ingangskiezer.

cgi-invoer2
De broncode om syntaxis te markeren. Bijvoorbeeld van een of van een
uploaden. Zien ingangskiezer.

lijn nummers - optioneel
`ja', `nee' of `koppeling'

standaard: nee

vervangen-tabbladen - optioneel
Als 0 dan worden de tabbladen niet vervangen, anders vervangt u elk voorkomen van a karakter
met het juiste aantal spaties om naar de volgende tabstop te gaan.

standaard: 0

titel - optioneel
Set is de titel van het bestand.

geen codering - optioneel
Standaard code2html probeert de uitvoer als een van beide te coderen bz2/gz/Z als de opdrachtgever
ondersteunt dit (HTTP_ACCEPT_ENCODING) en het benodigde programma is beschikbaar op de
server. Mogelijk moet u wijzigen @CGI_ENCODING in het script dat overeenkomt met uw programma
locaties.

If geen codering wordt gedefinieerd als "waar" code2html probeert de uitvoer niet te coderen.

Waarom twee cgi-ingangen die u kunt vragen: dit is om uw gebruikers in staat te stellen een keuze te maken
interface of ze hun bestand in een of gebruik een <browse>
knop om hun bestand te selecteren. Zie het voorbeeld op mijn homepage.

Merk op dat als $FILES_DISALLOWED_IN_CGI is 0 is het mogelijk voor uw gebruikers om alle
bestanden die de httpd kan lezen (als je geen cgi-wrapper of iets dergelijks gebruikt. By
standaard staat deze waarde op 1, dus het lezen van bestanden via cgi zou niet toegestaan ​​moeten zijn. Jij kan
sta het toe met instelling $FILES_DISALLOWED_IN_CGI naar 0 bovenaan het script.

De ingangskiezer REDIRECT_URL heeft een speciale uitleg nodig. De bestandsnaam is gevormd uit
de twee omgevingsvariabelen DOCUMENT_ROOT en REDIRECT_URL.

Als u wilt dat apache automatisch belt code2html voor alle broncodebestanden van programma's u
kan dit doen door deze twee regels toe te voegen aan uw srm.conf:

AddHandler tekst/x-broncode .c .cc .cpp .pas .h .p

Actie tekst/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

of iets dergelijks. In de regel AddHandle kunt u kiezen naar welke extensies u wilt
doorgaan code2html.

WAARSCHUWING: Voeg geen .pl toe aan deze regel en noem dit script "code2html.pl". Dit zal resulteren
in een lus.

Zorg er ook voor dat u de Action-module (srm.conf) laadt.

Vervang /cgi-bin/code2html door de virtuele locatie waaronder het bestand toegankelijk is.
Let op het gedeelte "foo=". Apache voegt de URL van het weer te geven bestand toe aan het einde van het
actie deel. We hebben dit niet nodig omdat we de omgevingsvariabele gebruiken REDIRECT_URL
we willen echter niet dat de url wordt toegevoegd aan de input-selector string. Daarom, wij
voeg het gedeelte "&foo=" toe.

Bedankt aan Kevin Burton[e-mail beveiligd]> voor het idee. Dat stelt hij ook

> Het is krachtiger als je het in een Apache gebruikt
> label
>
>
>
> #met je Action tag hier... zo kan het
> #heeft nog steeds gewone .java-bestanden op uw server.
>
>
>

VOORBEELD

ervan uitgaand code2html zich in de huidige map bevindt, kunt u typen

code2html -l perl code2html.pl code2html.html

om het script om te zetten in een html-bestand.

Gebruik code2html online met behulp van onworks.net-services