code2html - Online nel cloud

PROGRAMMA:

NOME

code2html - Converte il codice sorgente di un programma in HTML

SINOSSI

(1) codice2html [Opzioni] [file di input [file di uscita]]

(2) codice2html -p [filetto [file-out alternativo]]

(3) codice2html (come script CGI; vedere la sezione su CGI)

DESCRIZIONE

codice2html è uno script perl che converte il codice sorgente di un programma nella sintassi evidenziata
HTML o qualsiasi altro formato per il quale sono definite le regole.

(1) VERSIONI
file di input
È il file che contiene il codice sorgente del programma da formattare. Altrimenti
specificato o viene indicato un meno (-), il codice verrà letto da STDIN.

file di uscita
È il file in cui scrivere il codice formattato. Se non specificato o un meno (-) è
dato, il codice verrà scritto su STDOUT.

-l, --modalità-lingua
Specificare l'insieme di espressioni regolari da utilizzare. Questi devono essere definiti in a
file di lingua (vedi FILE sotto). Per scoprire quali modalità linguistiche sono definite,
problema a codice2html --modalità.

Questo input viene trattato senza distinzione tra maiuscole e minuscole.

In caso contrario, verranno utilizzate alcune euristiche per determinare la lingua del file.

-v, --verboso
Stampa le informazioni sullo stato di avanzamento su STDERR.

-n, --numeri di riga
Stampa il codice sorgente con i numeri di riga.

-N, --linknumbers
Stampa il codice sorgente con i numeri di riga. I numeri di lino si collegheranno a
stessi, il che semplifica l'invio di collegamenti alle linee.

-P, --prefisso
Prefisso opzionale da utilizzare per gli ancoraggi dei numeri di riga.

-t, --sostituisci-tab[=TABSTOP-LARGHEZZA]
Sostituisci ogni occorrenza di a personaggio con la giusta quantità di spazi da ottenere
alla tabulazione successiva. L'impostazione predefinita è una larghezza di tabulazione di 8 caratteri.

-L, --file-lingua=LINGUA-FILE
Specificare un file alternativo da cui prendere le definizioni della lingua e del formato di output
(vedi la sezione su FILE sotto).

-m, --modalità
Stampa tutte le modalità di lingua e i formati di output attualmente definiti su STDOUT ed esci
con successo. Stampa anche le modalità da a LINGUA-FILE dato da --file-lingua if
applicabile.

--ricaderci=LUNGO
Se la modalità lingua fornita con --modalità-lingua non può essere trovato, quindi usa questo
modalità.

--ricaderci pianura per esempio è utile quando codice2html è chiamato da uno script a
assicurarsi che l'output venga creato.

-h, --Aiuto
Stampa un breve aiuto ed esci con successo.

-V, --versione
Stampa la versione del programma ed esci con successo.

-c, --tipo di contenuto
Stampa "Content-Type: text/html\n\n" (o qualunque cosa il formato di output definisca come
content-type) prima del resto dell'output. Utile se lo script viene invocato come
uno script cgi.

-o, --formato di output
Seleziona il formato di output. html è l'impostazione predefinita. Per scoprire quali formati di output
sono definiti, problema a codice2html --modalità.

-H, --nessuna intestazione
non utilizzare il modello definito dal formato di output. Per HTML questo significa
che non ci sarà , , e no
tag.

--modello=RISORSE
sovrascrive il modello predefinito per il formato di output specificato. Se --nessuna intestazione is
dato anche questo, questo non ha significato, poiché il modello viene comunque ignorato.

-T, --titolo
Imposta il titolo del file di output prodotto. Funziona solo se il modello lo fa
supportare l'impostazione del titolo.

-w, --larghezza della linea=LARGHEZZA DELLA LINEA
Avvolgi le righe dopo LARGHEZZA DELLA LINEA caratteri. L'impostazione predefinita è non avvolgere affatto le righe.

-b, --linebreakprefix=PREFISSOLINEA
Usa il FILEPREFIX all'inizio delle righe avvolte. L'impostazione predefinita è "» ".

(2) HTML rattoppo
codice2html -p [filetto [file-out alternativo]]

codice2html ti permette anche di avere il codice sorgente in linea in un file html. Può quindi prendere
questo file html e inserisci il codice evidenziato dalla sintassi.

Se non viene fornito alcun file, codice2html legge da STDIN e scrive su STDOUT. Se solo un file è
dato che sostituisce questo file con l'output. Se vengono forniti due file, il primo è
letto da e il secondo scritto a.

Per utilizzare questa funzione, inserisci un like come questo nel tuo file html:

-->

il file evidenziato dalla sintassi verrà inserito in questa posizione racchiusa tra tag.

Tutte le opzioni che possono essere fornite sulla riga di comando come --numeri di riga ecc. lavoro. --Aiuto,
--versione, ecc. funzionano anche ma non è molto intelligente usarli :). Usando
--formato di output non è consigliabile scegliere un formato di output non HTML. --tipo di contenuto is
ignorato.

Puoi anche scrivere il codice sorgente del programma direttamente nel file html con quanto segue
sintassi:

<!-- code2html aggiungi [opzioni]



->

Di solito è una buona idea dare almeno il --modalità-lingua opzione per specificare il
Lingua.

(3) CGI
Se lo script viene utilizzato come script CGI (GATEWAY_INTERFACE ambiente impostato e no
argomenti della riga di comando forniti) codice2html legge gli argomenti dalla stringa di query
o da SDTIN. (metodi POST e GET).

--tipo di contenuto si accende automaticamente e l'uscita va sempre a STDOUT.

Sono accettati i seguenti parametri/opzioni:

modalità lingua - opzionale
"c", "cc", "pas", ecc.

se non viene data, vengono utilizzate alcune euristiche per scoprire la lingua.

fallback - opzionale
`plain', `c', ecc. se non è possibile trovare la modalità lingua, usa questa

selettore di ingresso - opzionale
o `file', `cgi-input1', `cgi-input2' o `REDIRECT_URL'

predefinito: file

Nome del file
file da leggere da if selettore di ingresso è "file"

cgi-input1
Il codice sorgente per evidenziare la sintassi. Ad esempio da a o da a
caricamento. Vedere selettore di ingresso.

cgi-input2
Il codice sorgente per evidenziare la sintassi. Ad esempio da a o da a
caricamento. Vedere selettore di ingresso.

numeri di riga - opzionale
"sì", "no" o "collegamento"

predefinito: no

sostituire-schede - opzionale
Se 0 le schede non vengono sostituite, altrimenti sostituire ogni occorrenza di a carattere
con la giusta quantità di spazi per arrivare alla tabulazione successiva.

predefinito: 0

titolo - opzionale
Set è il titolo del file.

nessuna codifica - opzionale
Di default codice2html prova a codificare l'output come bz2/gz/Z se il cliente
supporta questo (HTTP_ACCEPT_ENCODING) e il programma necessario è disponibile sul
server. Potrebbe essere necessario modificare @CGI_ENCODING nello script per abbinare il tuo programma
posizioni.

If nessuna codifica è definito “vero” codice2html non tenta di codificare l'output.

Perché due ingressi cgi potresti chiedere: questo è per consentire ai tuoi utenti di scegliere vie a
interfaccia se vogliono inserire il loro file in a o usa un <sfoglia>
pulsante per selezionare il loro file. Vedi l'esempio sulla mia home page.

Si noti che se $FILES_DISALLOWED_IN_CGI è 0 è possibile che i tuoi utenti leggano tutti i
file che httpd può leggere (se non si esegue un cgi- wrapper o qualcosa del genere. Per
di default questo valore è impostato su 1, quindi la lettura di file tramite cgi non dovrebbe essere consentita. Puoi
consentirlo con l'impostazione $FILES_DISALLOWED_IN_CGI a 0 nella parte superiore dello script.

Il selettore di ingresso REDIRECT_URL ha bisogno di una spiegazione speciale. Il nome del file è formato da
le due variabili d'ambiente DOCUMENT_ROOT ed REDIRECT_URL.

Se vuoi che Apache chiami automaticamente codice2html per tutti i file di codice sorgente del programma tu
puoi farlo aggiungendo queste due righe al tuo srm.conf:

AddHandler testo/x-codice sorgente .c .cc .cpp .pas .h .p

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

o qualcosa di simile a questo. Nella riga AddHandle puoi scegliere a quali estensioni
passare attraverso codice2html.

AVVERTIMENTO: Non aggiungere .pl a questa riga e denominare questo script "code2html.pl". Questo risulterà
in un ciclo.

Assicurati anche di caricare il modulo Action (srm.conf).

Sostituisci /cgi-bin/code2html con la posizione virtuale in cui è possibile accedere al file.
Nota la parte "foo=". Apache aggiunge l'URL del file da visualizzare alla fine del
parte di azione. Non ne abbiamo bisogno poiché usiamo la variabile d'ambiente REDIRECT_URL
tuttavia non vogliamo ottenere l'aggiunta dell'URL alla stringa del selettore di input. quindi noi
aggiungere la parte "&foo=".

Grazie a Kevin Burton[email protected]> per l'idea. Dichiara anche che

> È più potente se lo usi in un Apache
> etichetta
>
>
>
> #con il tuo tag Azione qui... in questo modo puoi
> #disponi ancora di file .java regolari sul tuo server.
>
>
>

ESEMPIO

supponendo codice2html è nella directory corrente, puoi digitare

codice2html -l perl codice2html.pl codice2html.html

per convertire lo script in un file html.

Usa code2html online utilizzando i servizi onworks.net