code2html - En ligne dans le Cloud

PROGRAMME:

Nom

code2html - Convertit le code source d'un programme en HTML

SYNOPSIS

(1) code2html [Options] [fichier-entrée [fichier de sortie]]

(2) code2html -p [filet [fichier de sortie alternatif]]

(3) code2html (en tant que script CGI ; voir la section sur CGI)

DESCRIPTION

code2html est un script perl qui convertit le code source d'un programme en syntaxe mise en évidence
HTML, ou tout autre format pour lequel des règles sont définies.

(1) OPTIONS
fichier-entrée
C'est le fichier qui contient le code source du programme à formater. Si non
spécifié ou un moins (-) est donné, le code sera lu à partir de STDIN.

fichier de sortie
Est le fichier dans lequel écrire le code formaté. Si non spécifié ou un moins (-) est
donné, le code sera écrit dans STDOUT.

-l, --langue-mode
Spécifiez l'ensemble d'expressions régulières à utiliser. Ceux-ci doivent être définis dans un
fichier de langue (voir DES DOSSIERS au dessous de). Pour savoir quels modes de langue sont définis,
émettre un code2html --modes.

Cette entrée est traitée insensible à la casse.

Si elle n'est pas fournie, certaines heuristiques seront utilisées pour déterminer la langue du fichier.

-v, --verbeux
Imprime les informations de progression sur STDERR.

-n, --numéros de ligne
Imprimez le code source avec les numéros de ligne.

-N, --numéros de liens
Imprimez le code source avec les numéros de ligne. Les numéros de ligne seront liés à
eux-mêmes, ce qui facilite l'envoi de liens vers des lignes.

-P, --préfixe
Préfixe facultatif à utiliser pour les ancres de numéro de ligne.

-t, --replace-onglets[=TABSTOP-LARGEUR]
Remplacer chaque occurrence d'un caractère avec la bonne quantité d'espaces pour obtenir
à la tabulation suivante. La valeur par défaut est une largeur de tabulation de 8 caractères.

-L, --langue-fichier=LANGUE-FILE
Spécifiez un autre fichier à partir duquel prendre les définitions de langue et de format de sortie
(voir la section sur DES DOSSIERS ci-dessous).

-m, --modes
Imprimer tous les modes de langue et formats de sortie actuellement définis sur STDOUT et quitter
avec succès. Imprime également les modes à partir d'un LANGUE-FILE donné par --langue-fichier if
en vigueur.

--se retirer=LANGUE
Si le mode de langue donné avec --langue-mode introuvable, alors utilisez ceci
mode.

--se retirer plaine par exemple est utile quand code2html est appelé depuis un script vers
assurez-vous que la sortie est créée.

-h, --Aidez-moi
Imprimez une courte aide et quittez avec succès.

-V, --version
Imprimez la version du programme et quittez avec succès.

-c, --type-de-contenu
Imprime « Type de contenu : text/html\n\n » (ou tout ce que le format de sortie définit comme un
content-type) avant le reste de la sortie. Utile si le script est invoqué comme
un script cgi.

-o, --format de sortie
Sélectionne le format de sortie. html est la valeur par défaut. Pour savoir quels formats de sortie
sont définis, émettre un code2html --modes.

-H, --aucun en-tête
n'utilisez pas le modèle défini par le format de sortie. Pour HTML, cela signifie
qu'il n'y aura pas , , et non
Mots clés.

--modèle=DOSSIER
remplace le modèle par défaut pour le format de sortie donné. Si --aucun en-tête is
donné aussi, cela n'a aucun sens, puisque le modèle est ignoré de toute façon.

-T, --Titre
Définissez le titre du fichier de sortie produit. Ne fonctionne que si le modèle fonctionne
prise en charge de la définition du titre.

-w, --largeur de ligne=LARGEUR DE LIGNE
Enrouler les lignes après LARGEUR DE LIGNE personnages. La valeur par défaut est de ne pas enrouler les lignes du tout.

-b, --linebreakprefix=PREFIXE DE LIGNE
Utilisez PREFIXE FILINE au début des lignes enroulées. La valeur par défaut est "» ".

(2) HTML patcher
code2html -p [filet [fichier de sortie alternatif]]

code2html vous permet également d'avoir le code source en ligne dans un fichier html. Il peut alors prendre
ce fichier html et insérez le code en surbrillance de la syntaxe.

Si aucun fichier n'est fourni, code2html lit à partir de STDIN et écrit dans STDOUT. Si un seul fichier est
étant donné qu'il remplace ce fichier par la sortie. Si deux fichiers sont fournis, le premier est
lu depuis et le second écrit vers.

Pour utiliser cette fonctionnalité, insérez simplement un like comme celui-ci dans votre fichier html :

-->

le fichier en surbrillance de la syntaxe sera inséré à cette position entourée de Mots clés.

Toutes les options qui peuvent être données sur la ligne de commande comme --numéros de ligne etc. travail. --Aidez-moi,
--version, etc. fonctionnent aussi mais il n'est pas très intelligent de les utiliser :). À l'aide de
--format de sortie choisir un format de sortie non HTML n'est pas conseillé. --type-de-contenu is
ignoré.

Vous pouvez également écrire le code source du programme directement dans le fichier html avec les éléments suivants
syntaxe:

<!-- code2html ajouter [options]



->

C'est généralement une bonne idée de donner au moins la --langue-mode possibilité de spécifier le
la langue.

(3) CGI
Si le script est utilisé comme script CGI (GATEWAY_INTERFACE environnement défini et non
arguments de ligne de commande donnés) code2html lit les arguments soit à partir de la chaîne de requête
ou du SDTIN. (méthodes POST et GET).

--type-de-contenu s'allume automatiquement et la sortie passe toujours à STDOUT.

Les paramètres/options suivants sont acceptés :

mode-langue - optionnel
"c", "cc", "pas", etc.

si elle n'est pas donnée, certaines heuristiques sont utilisées pour trouver la langue.

se retirer - optionnel
`plain', `c', etc. si le mode de langue ne peut pas être trouvé, utilisez celui-ci

sélecteur d'entrée - optionnel
soit `file', `cgi-input1', `cgi-input2', ou `REDIRECT_URL'

par défaut : fichier

nom de fichier
fichier à lire si sélecteur d'entrée est 'fichier'

cgi-entrée1
Le code source à mettre en surbrillance syntaxique. Par exemple d'un ou d'un
télécharger. Voir sélecteur d'entrée.

cgi-entrée2
Le code source à mettre en surbrillance syntaxique. Par exemple d'un ou d'un
télécharger. Voir sélecteur d'entrée.

numéros de ligne - optionnel
'oui', 'non' ou 'lien'

par défaut : non

remplacer-onglets - optionnel
Si 0 alors les tabulations ne sont pas remplacées, sinon remplacez chaque occurrence d'un personnage
avec la bonne quantité d'espaces pour accéder à la tabulation suivante.

par défaut: 0

titre - optionnel
Set est le titre du fichier.

pas d'encodage - optionnel
Par défaut code2html essaie d'encoder la sortie comme bz2/gz/Z si le client
soutient ceci (HTTP_ACCEPT_ENCODING) et le programme nécessaire est disponible sur le
serveur. Vous devrez peut-être modifier @CGI_ENCODAGE dans le script pour correspondre à votre programme
Emplacements.

If pas d'encodage est défini comme « vrai » code2html n'essaie pas d'encoder la sortie.

Pourquoi deux entrées cgi vous pouvez demander : Ceci est pour permettre à vos utilisateurs de choisir
interface s'ils veulent insérer leur fichier dans un ou utilisez un <parcourir>
bouton pour sélectionner leur fichier. Voir l'exemple sur ma page d'accueil.

Notez que si $FILES_DISALLOWED_IN_CGI est 0, il est possible pour vos utilisateurs de lire tous les
fichiers que le httpd peut lire (si vous n'exécutez pas un wrapper cgi ou quelque chose comme ça. Par
par défaut, cette valeur est définie sur 1, donc la lecture de fichiers via cgi ne devrait pas être autorisée. Vous pouvez
permettez-le avec le réglage $FILES_DISALLOWED_IN_CGI à 0 en haut du script.

Le sélecteur d'entrée REDIRECT_URL a besoin d'une explication spéciale. Le nom du fichier est formé de
les deux variables d'environnement DOCUMENT_ROOT ainsi que REDIRECT_URL.

Si vous voulez qu'Apache appelle automatiquement code2html pour tous les fichiers de code source du programme que vous
pouvez le faire en ajoutant ces deux lignes à votre srm.conf :

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

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

ou quelque chose de similaire à cela. Dans la ligne AddHandle, vous pouvez choisir les extensions à
passer à travers code2html.

ATTENTION: N'ajoutez pas de .pl à cette ligne et nommez ce script « code2html.pl ». Cela entraînera
dans une boucle.

Assurez-vous également de charger le module Action (srm.conf).

Remplacez /cgi-bin/code2html par l'emplacement virtuel sous lequel le fichier est accessible.
Notez la partie "foo=". Apache ajoute l'URL du fichier à afficher à la fin du
partie action. Nous n'en avons pas besoin puisque nous utilisons la variable d'environnement REDIRECT_URL
Cependant, nous ne voulons pas que l'url s'ajoute à la chaîne du sélecteur d'entrée. Par conséquent, nous
ajoutez la partie "&foo=".

Tnx à Kevin Burton[email protected]> pour l'idée. Il déclare également que

> Il est plus puissant si vous l'utilisez dans un Apache
> étiqueter
>
>
>
> #avec votre balise d'action ici... de cette façon, vous pouvez
> #toujours avoir des fichiers .java réguliers sur votre serveur.
>
>
>

EXEMPLE

en supposant code2html est dans le répertoire courant, vous pouvez taper

code2html -l perl code2html.pl code2html.html

pour convertir le script en un fichier html.

Utilisez code2html en ligne à l'aide des services onworks.net