code2html: en línea en la nube

PROGRAMA:

NOMBRE

code2html: convierte el código fuente de un programa en HTML

SINOPSIS

(1) codigo2html [opciones] [fichero de entrada [archivo de salida]]

(2) codigo2html -p [presentar [archivo de salida alternativo]]

(3) codigo2html (como un script CGI; consulte la sección sobre CGI)

DESCRIPCIÓN

codigo2html es un script de perl que convierte el código fuente de un programa a la sintaxis resaltada
HTML, o cualquier otro formato para el que se definan reglas.

(1) CAMPUS
fichero de entrada
Es el archivo que contiene el código fuente del programa a formatear. Que no
especificado o se da un signo menos (-), el código se leerá desde STDIN.

archivo de salida
Es el archivo para escribir el código formateado. Si no se especifica o un signo menos (-) es
dado, el código se escribirá en STDOUT.

-l, --modo de idioma
Especifique el conjunto de expresiones regulares que se utilizarán. Estos deben definirse en un
archivo de idioma (ver ARCHIVOS debajo). Para saber qué modos de idioma están definidos,
emitir un codigo2html - modos.

Esta entrada no distingue entre mayúsculas y minúsculas.

Si no se proporciona, se utilizarán algunas heurísticas para determinar el idioma del archivo.

-v, --verboso
Imprime información de progreso en STDERR.

-n, --Línea de números
Imprima el código fuente con números de línea.

-N, --números de enlace
Imprima el código fuente con números de línea. Los números de lino se vincularán a
ellos mismos, lo que facilita el envío de enlaces a las líneas.

-P, --prefijo
Prefijo opcional que se utilizará para los anclajes de números de línea.

-t, --reemplazar pestañas[=ANCHO DE TABSTOP]
Reemplace cada ocurrencia de un personaje con la cantidad adecuada de espacios para obtener
al siguiente tope de pestañas. El valor predeterminado es un ancho de tabulación de 8 caracteres.

-L, --archivo de idioma=ARCHIVO DE IDIOMA
Especifique un archivo alternativo para tomar las definiciones de idioma y formato de salida
(ver la sección sobre ARCHIVOS abajo).

-m, - modos
Imprima todos los modos de idioma y formatos de salida definidos actualmente en STDOUT y salga
con éxito. También imprime modos desde un ARCHIVO DE IDIOMA dada por --archivo de idioma if
aplicable.

--retroceder=IDIOMA
Si el modo de idioma dado con --modo de idioma no se puede encontrar, entonces use esto
modo.

--retroceder llanura por ejemplo es útil cuando codigo2html se llama desde un script a
asegúrese de que se cree la salida.

-h, --ayuda
Imprima una ayuda breve y salga correctamente.

-V, --versión
Imprima la versión del programa y salga correctamente.

-c, --tipo de contenido
Imprime "Content-Type: text / html \ n \ n" (o lo que sea que el formato de salida defina como
content-type) antes que el resto de la salida. Útil si el script se indica como
un script CGI.

-o, --formato de salida
Selecciona el formato de salida. html es el predeterminado. Para averiguar qué formatos de salida
están definidos, emitir un codigo2html - modos.

-H, --sin encabezado
no utilice la plantilla definida por el formato de salida. Para HTML esto significa
que no habra , , y no
las etiquetas.

--plantilla=ARCHIVO
anula la plantilla predeterminada para el formato de salida dado. Si --sin encabezado is
dado también, esto no tiene ningún significado, ya que la plantilla se ignora de todos modos.

-T, --título
Establezca el título del archivo de salida producido. Solo funciona si la plantilla lo hace
apoyo a la configuración del título.

-w, --ancho de línea=ANCHO DE LÍNEA
Envuelva las líneas después ANCHO DE LÍNEA caracteres. El valor predeterminado es no ajustar las líneas en absoluto.

-b, --prefijo de salto de línea=PREFIJO DE LÍNEA
Uso FILINEPREFIX al comienzo de las líneas envueltas. El valor predeterminado es "» ".

(2) HTML parcheo
codigo2html -p [presentar [archivo de salida alternativo]]

codigo2html también le permite tener código fuente en línea en un archivo html. Entonces puede tomar
este archivo html e inserte el código resaltado de sintaxis.

Si no se proporciona ningún archivo, codigo2html lee de STDIN y escribe en STDOUT. Si solo un archivo es
dado que reemplaza este archivo con la salida. Si se proporcionan dos archivos, el primero es
leído desde y el segundo escrito en.

Para usar esta función, simplemente inserte algo como este en su archivo html:

-->

el archivo resaltado de sintaxis se insertará en esta posición encerrada en etiquetas.

Todas las opciones que se pueden dar en la línea de comando como --Línea de números etc. trabajar. --ayuda,
--versión, etc. también funcionan, sin embargo, no es muy inteligente usarlos :). Utilizando
--formato de salida no es aconsejable elegir un formato de salida que no sea HTML. --tipo de contenido is
ignorado

También puede escribir el código fuente del programa directamente en el archivo html con lo siguiente
sintaxis:

<!-- code2html add [options]



->

Por lo general, es una buena idea dar al menos la --modo de idioma opción para especificar el
idioma.

(3) CGI
Si el script se utiliza como script CGI (GATEWAY_INTERFACE entorno establecido y no
argumentos de línea de comando dados) codigo2html lee los argumentos de la cadena de consulta
o de SDTIN. (métodos POST y GET).

--tipo de contenido se enciende automáticamente y la salida siempre va a STDOUT.

Se aceptan los siguientes parámetros / opciones:

modo de idioma - Opcional
`c ',` cc', `pas ', etc.

si no se da, se utilizan algunas heurísticas para averiguar el idioma.

de repliegue - Opcional
`plain ',` c', etc. si no se puede encontrar el modo de idioma, use este

selector de entrada - Opcional
ya sea `archivo ',` cgi-input1', `cgi-input2 'o` REDIRECT_URL'

predeterminado: archivo

nombre de archivo
archivo para leer si selector de entrada es "archivo"

cgi-entrada1
El código fuente para resaltar la sintaxis. Por ejemplo de un o de un
subir. Ver selector de entrada.

cgi-entrada2
El código fuente para resaltar la sintaxis. Por ejemplo de un o de un
subir. Ver selector de entrada.

Línea de números - Opcional
"sí", "no" o "enlace"

predeterminado: no

reemplazar-pestañas - Opcional
Si 0, las pestañas no se reemplazan, de lo contrario, reemplace cada aparición de un personaje
con la cantidad adecuada de espacios para llegar a la siguiente pestaña.

predeterminado: 0

título - Opcional
Establece el título del archivo.

sin codificación - Opcional
Por defecto codigo2html intenta codificar la salida como bz2/gz/Z si el cliente
apoya esto (HTTP_ACCEPT_ENCODING) y el programa necesario está disponible en el
servidor. Es posible que deba modificar @CGI_ENCODING en el script para que coincida con su programa
ubicaciones.

If sin codificación se define como "verdadero" codigo2html no intenta codificar la salida.

Por qué dos entradas cgi puede preguntar: Esto es para permitir que sus usuarios elijan vie a
interfaz si quieren insertar su archivo en una o usuario un <browse>
para seleccionar su archivo. Vea el ejemplo en mi página de inicio.

Tenga en cuenta que si $ FILES_DISALLOWED_IN_CGI es 0, es posible que sus usuarios lean todos los
archivos que httpd puede leer (si no ejecuta un contenedor cgi o algo como esto.
por defecto, este valor se establece en 1, por lo que no se debe permitir la lectura de archivos a través de cgi. Usted puede
permitirlo con el ajuste $ FILES_DISALLOWED_IN_CGI a 0 en la parte superior de la secuencia de comandos.

El selector de entrada REDIRECCIONAR URL necesita una explicación especial. El nombre del archivo se forma a partir de
las dos variables ambientales DOCUMENT_ROOT y REDIRECCIONAR URL.

Si desea que apache llame automáticamente codigo2html para todos los archivos de código fuente del programa
puede hacer esto agregando estas dos líneas a su srm.conf:

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

Texto de acción / x-sourcecode / cgi-bin / code2html? Input-selector = REDIRECT_URL & foo =

o algo similar a esto. En la línea AddHandle puede elegir qué extensiones desea
pasar codigo2html.

ADVERTENCIA: No agregue .pl a esta línea y nombre este script “code2html.pl”. Esto resultará
en un bucle.

También asegúrese de cargar el módulo Action (srm.conf).

Reemplace / cgi-bin / code2html con la ubicación virtual bajo la cual se puede acceder al archivo.
Tenga en cuenta la parte "foo =". Apache agrega la URL del archivo para mostrar al final de la
parte de acción. No necesitamos esto ya que usamos la variable de entorno REDIRECCIONAR URL
sin embargo, no queremos que la URL se añada a la cadena del selector de entrada. Por lo tanto, nosotros
agregue la parte "& foo =".

Tnx a Kevin Burton[email protected]> por la idea. También afirma que

> Es más poderoso si lo usa en un Apache
> etiqueta
>
>
>
> #con su etiqueta de acción aquí ... de esta manera puede
> #todavía tiene archivos .java regulares en su servidor.
>
>
>

EJEMPLO

asumiendo codigo2html está en el directorio actual, puede escribir

codigo2html -l perl codigo2html.pl codigo2html.html

para convertir el script en un archivo html.

Use code2html en línea usando los servicios de onworks.net