code2html - Online na nuvem

PROGRAMA:

NOME

code2html - Converte o código-fonte de um programa em HTML

SINOPSE

(1) código2html [opções] [Arquivo de entrada [arquivo de saída]]

(2) código2html -p [lima [arquivo de saída alternativa]]

(3) código2html (como um script CGI; consulte a seção sobre CGI)

DESCRIÇÃO

código2html éum script perl que converte o código-fonte de um programa para a sintaxe destacada
HTML, ou qualquer outro formato cujas regras sejam definidas.

(1) OPÇÕES
Arquivo de entrada
É o arquivo que contém o código-fonte do programa a ser formatado. Se não
especificado ou um menos (-) é fornecido, o código será lido de STDIN.

arquivo de saída
É o arquivo no qual gravar o código formatado. Se não for especificado ou um menos (-) for
dado, o código será escrito em STDOUT.

-l, --modo-idioma
Especifique o conjunto de expressões regulares a serem usadas. Estes devem ser definidos em um
arquivo de idioma (ver ARQUIVOS abaixo). Para descobrir quais modos de linguagem estão definidos,
um problema código2html --modos.

Esta entrada não diferencia maiúsculas de minúsculas.

Se não for fornecido, algumas heurísticas serão usadas para determinar o idioma do arquivo.

-v, --verbose
Imprime informações de progresso em STDERR.

-n, --números de linha
Imprima o código-fonte com os números das linhas.

-N, --linknumbers
Imprima o código-fonte com os números das linhas. Os números de linho serão vinculados a
próprios, o que facilita o envio de links para linhas.

-P, --prefixo
Prefixo opcional a ser usado para âncoras de número de linha.

-t, --replace-tabs[=TABSTOP-LARGURA]
Substitua cada ocorrência de um personagem com a quantidade certa de espaços para obter
para a próxima parada de tabulação. O padrão é uma largura de tabulação de 8 caracteres.

-L, --arquivo de idioma=ARQUIVO DE IDIOMA
Especifique um arquivo alternativo para obter as definições de idioma e formato de saída de
(veja a seção sobre ARQUIVOS abaixo).

-m, --modos
Imprimir todos os modos de linguagem e formatos de saída atualmente definidos para STDOUT e sair
com sucesso. Também imprime modos de um ARQUIVO DE IDIOMA dado por --arquivo de idioma if
aplicável.

--cair pra trás=GRANDE
Se o modo de linguagem fornecido com --modo-idioma não pode ser encontrado, então use isto
modo.

--cair pra trás planície por exemplo é útil quando código2html é chamado de um script para
certifique-se de que a saída seja criada.

-h, --Socorro
Imprima uma pequena ajuda e saia com sucesso.

-V, --versão
Imprima a versão do programa e saia com sucesso.

-c, --tipo de conteúdo
Imprime ”Content-Type: text / html \ n \ n“ (ou o que quer que o formato de saída defina como um
content-type) antes do resto da saída. Útil se o script for usado como
um script cgi.

-o, --Formato de saída
Seleciona o formato de saída. html é o padrão. Para descobrir quais formatos de saída
são definidos, questão a código2html --modos.

-H, --nenhum cabeçalho
não faça uso do modelo definido pelo formato de saída. Para HTML, isso significa
que não haverá , , e não
Tag.

--modelo=ARQUIVO
substitui o modelo padrão para o formato de saída fornecido. Se --nenhum cabeçalho is
fornecido também, isso não tem significado, uma vez que o modelo é ignorado de qualquer maneira.

-T, --título
Defina o título do arquivo de saída produzido. Só funciona se o modelo
apoiar a definição do título.

-w, --espessura da linha=ESPESSURA DA LINHA
Quebrar as linhas depois ESPESSURA DA LINHA personagens. O padrão é não quebrar as linhas.

-b, --linebreakprefix=LINHA PREFIXO
Use FILINEPREFIX no início das linhas quebradas. O padrão é "» ".

(2) HTML patching
código2html -p [lima [arquivo de saída alternativa]]

código2html também permite que você tenha código-fonte embutido em um arquivo html. Pode então levar
este arquivo html e insira o código destacado da sintaxe.

Se nenhum arquivo for fornecido, código2html lê de STDIN e grava em STDOUT. Se apenas um arquivo for
dado que substitui este arquivo com a saída. Se dois arquivos forem fornecidos, o primeiro será
ler e o segundo escrito.

Para usar este recurso, basta inserir um semelhante a este em seu arquivo html:

-->

o arquivo de sintaxe destacado será inserido nesta posição entre Tag.

Todas as opções que podem ser fornecidas na linha de comando, como --números de linha etc. trabalho. --Socorro,
--versão, etc. funcionam também, no entanto, não é muito inteligente usá-los :). Usando
--Formato de saída escolher um formato de saída não HTML não é aconselhável. --tipo de conteúdo is
ignorado.

Você também pode escrever o código-fonte do programa diretamente no arquivo html com o seguinte
sintaxe:

<!-- code2html adicionar [opções]



->

Normalmente, é uma boa ideia dar pelo menos o --modo-idioma opção para especificar o
língua.

(3) CGI
Se o script for usado como um script CGI (GATEWAY_INTERFACE ambiente definido e não
argumentos de linha de comando fornecidos) código2html lê os argumentos da string de consulta
ou de SDTIN. (métodos POST e GET).

--tipo de conteúdo é ligado automaticamente e a saída sempre vai para STDOUT.

Os seguintes parâmetros / opções são aceitos:

modo de linguagem - opcional
`c ',` cc', `pas ', etc.

se não for fornecido, algumas heurísticas são usadas para descobrir a linguagem.

recuo - opcional
`plain ',` c', etc. se o modo de linguagem não puder ser encontrado, use este

seletor de entrada - opcional
tanto `file ',` cgi-input1', `cgi-input2 'ou` REDIRECT_URL'

padrão: arquivo

nome do arquivo
arquivo para ler se seletor de entrada é `arquivo '

entrada cgi1
O código-fonte para realçar a sintaxe. Por exemplo, de um ou de um
Envio. Ver seletor de entrada.

entrada cgi2
O código-fonte para realçar a sintaxe. Por exemplo, de um ou de um
Envio. Ver seletor de entrada.

números de linha - opcional
`sim ',` não' ou `link '

padrão: não

substituir guias - opcional
Se 0, então as guias não são substituídas, caso contrário, substitua cada ocorrência de um personagem
com a quantidade certa de espaços para ir para a próxima parada de tabulação.

padrão: 0

título - opcional
Defina o título do arquivo.

sem codificação - opcional
Por padrão código2html tenta codificar a saída como bz2/gz/Z se o cliente
suporta isso (HTTP_ACCEPT_ENCODING) e o programa necessário está disponível no
servidor. Você pode precisar modificar @CGI_ENCODING no script para corresponder ao seu programa
Localizações.

If sem codificação é definido como “verdadeiro” código2html não tenta codificar a saída.

Por que você pode perguntar duas entradas cgi: isso é para permitir que seus usuários escolham
interface se eles desejam inserir seu arquivo em um ou usuário um <browse>
botão para selecionar seu arquivo. Veja o exemplo em minha página inicial.

Note que se $ FILES_DISALLOWED_IN_CGI é 0, é possível para seus usuários lerem todos os
arquivos que o httpd pode ler (se você não executar um cgi- wrapper ou algo assim.
por padrão, esse valor é definido como 1, portanto, a leitura de arquivos via cgi não deve ser permitida. Você pode
permitir com configuração $ FILES_DISALLOWED_IN_CGI para 0 na parte superior do script.

O seletor de entrada REDIRECT_URL precisa de uma explicação especial. O nome do arquivo é formado por
as duas variáveis ​​de ambiente DOCUMENT_ROOT e REDIRECT_URL.

Se você quiser que o Apache ligue automaticamente código2html para todos os arquivos de código-fonte do programa que você
pode fazer isso adicionando estas duas linhas ao seu srm.conf:

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

Texto de ação / x-sourcecode / cgi-bin / code2html? Input-selector = REDIRECT_URL & foo =

ou algo semelhante a isso. Na linha AddHandle, você pode escolher quais extensões deseja
passar por código2html.

ATENÇÃO: Não adicione .pl a esta linha e nomeie este script “code2html.pl”. Isso vai resultar
em um loop.

Certifique-se também de carregar o módulo Action (srm.conf).

Substitua / cgi-bin / code2html pelo local virtual sob o qual o arquivo pode ser acessado.
Observe a parte “foo =”. Apache anexa a URL do arquivo para exibir no final do
parte da ação. Não precisamos disso, pois usamos a variável de ambiente REDIRECT_URL
entretanto, não queremos obter os addes de url para a string do seletor de entrada. Portanto nós
acrescente a parte “& foo =”.

Tnx para Kevin Burton[email protegido]> para a ideia. Ele também afirma que

> É mais poderoso se você usá-lo em um Apache
> marcação
>
>
>
> #com sua tag de ação aqui ... desta forma, você pode
> #ainda tem arquivos .java regulares em seu servidor.
>
>
>

EXEMPLO

assumindo código2html está no diretório atual, você pode digitar

code2html -l perl code2html.pl code2html.html

para converter o script em um arquivo html.

Use code2html online usando serviços onworks.net