code2html - クラウドでオンライン

プログラム：

NAME

code2html - プログラムのソースコードをHTMLに変換します

SYNOPSIS

(1) コード2html [オプション] [入力ファイル [出力ファイル]]

(2) コード2html -p [file [代替出力ファイル]]

(3) コード2html (CGI スクリプトとして。「 CGI)

DESCRIPTION

コード2html プログラムのソースコードを構文強調表示に変換する Perl スクリプトです
HTML、またはルールが定義されているその他の形式。

(1) OPTIONS
入力ファイル
フォーマットするプログラムのソースコードを含むファイルです。 そうでない場合
指定するか、マイナス (-) を指定すると、コードは STDIN から読み取られます。

出力ファイル
フォーマットされたコードを書き込むファイルです。 指定されていない場合、またはマイナス (-) が指定されている場合
指定すると、コードは STDOUT に書き込まれます。

-l, --言語モード
使用する正規表現のセットを指定します。 これらは、
言語ファイル（を参照） ファイル 下に）。 どの言語モードが定義されているかを確認するには、
発行する コード2html --モード.

この入力は大文字と小文字が区別されません。

指定しない場合、ファイル言語を決定するためにいくつかのヒューリスティックが使用されます。

-v, -詳細
進行状況情報を STDERR に出力します。

-n, --行番号
ソースコードを行番号付きで出力します。

-N, --リンク番号
ソースコードを行番号付きで出力します。 行番号は次の場所にリンクされます
リンクを簡単にラインに送信できるようになります。

-P, --prefix
行番号アンカーに使用するオプションのプレフィックス。

-t, --タブの置換[=天板幅]
出現するたびに置き換えます取得する適切な量のスペースを持つ文字
次のタブストップへ。 デフォルトのタブストップ幅は 8 文字です。

-L, --言語ファイル=言語ファイル
言語と出力形式の定義を取得する代替ファイルを指定します。
(「 ファイル 下）。

-m, --モード
現在定義されているすべての言語モードと出力形式を STDOUT に出力して終了します
無事に。 また、 言語ファイル によって与えられた --言語ファイル if
該当します。

- 後退する=言語
言語モードが指定されている場合、 --言語モード 見つからない場合はこれを使用してください
モード。

- 後退する 平野 たとえば、次のような場合に便利です コード2html スクリプトから呼び出されます
出力が作成されていることを確認します。

-h, - 助けて
短いヘルプを印刷し、正常に終了します。

-V, - バージョン
プログラムのバージョンを出力し、正常に終了します。

-c, --コンテンツタイプ
「Content-Type: text/html\n\n」（または出力形式で定義されているもの）を印刷します。
content-type) を出力の残りの前に置きます。 スクリプトが次のように呼び出される場合に便利です
CGIスクリプト。

-o, - 出力フォーマット
出力形式を選択します。 html がデフォルトです。 どの出力形式を確認するには
定義されている場合は、 コード2html --モード.

-H, -ヘッダーなし
出力形式で定義されたテンプレートは使用しないでください。 HTML の場合、これは次のことを意味します
何もないだろう、 、いいえ
タグ。

- レンプレート=FILE
指定された出力形式のデフォルトのテンプレートをオーバーライドします。 もし -ヘッダーなし is
いずれにしてもテンプレートは無視されるため、これには意味がありません。

-T, - 題名
生成される出力ファイルのタイトルを設定します。 テンプレートがそうする場合にのみ機能します
タイトルの設定をサポートします。

-w, --線幅=線幅
後で行を折り返す 線幅 文字。 デフォルトでは、行はまったく折り返されません。

-b, --linebreakprefix=ラインプレフィックス
　 fILINEプレフィックス 折り返された行の先頭。 デフォルトは「» 」です。

(2) HTML パッチ適用
コード2html -p [file [代替出力ファイル]]

コード2html HTML ファイル内にインライン ソース コードを含めることもできます。 それからかかることができます
この HTML ファイルを開き、構文強調表示されたコードを挿入します。

ファイルが指定されていない場合は、 コード2html STDIN から読み取り、STDOUT に書き込みます。 ファイルが XNUMX つだけの場合
このファイルを出力に置き換えます。 XNUMX つのファイルが提供される場合、最初のファイルは
から読み取られ、XNUMX 番目に書き込まれます。

この機能を使用するには、次のようなものを HTML ファイルに挿入するだけです。

-->

構文強調表示されたファイルは、で囲まれたこの位置に挿入されます。 タグ。

コマンドラインで指定できるすべてのオプションは次のとおりです。 --行番号 などの作業です。 - 助けて,
- バージョンなども機能しますが、それらを使用するのはあまり賢明ではありません:)。 使用する
- 出力フォーマット HTML 以外の出力形式を選択することはお勧めできません。 --コンテンツタイプ is
無視されます。

次のようにプログラムのソース コードを HTML ファイルに直接記述することもできます。
構文：

<!-- code2html [オプション] を追加



- >

通常は、少なくとも --言語モード を指定するオプション
言語。

(3) CGI
スクリプトを CGI スクリプトとして使用する場合 (GATEWAY_INTERFACE 環境設定あり、なし
コマンドライン引数が指定されています) コード2html クエリ文字列から引数を読み取ります
またはSDTINから。 (メソッド POST および GET)。

--コンテンツタイプ は自動的にオンになり、出力は常に STDOUT になります。

次のパラメータ/オプションが受け入れられます。

言語モード -オプション
`c'、`cc'、`pas' など。

指定されない場合、言語を見つけるためにいくつかのヒューリスティックが使用されます。

フォールバック -オプション
`plain'、`c' など。言語モードが見つからない場合は、これを使用します。

入力セレクター -オプション
「file」、「cgi-input1」、「cgi-input2」、または「REDIRECT_URL」のいずれか

デフォルト: ファイル

ファイル名
if から読み取るファイル 入力セレクター は「ファイル」です

CGI入力1
ソースコードを構文強調表示します。 たとえば、 またはから
アップロード。 見る 入力セレクター.

CGI入力2
ソースコードを構文強調表示します。 たとえば、 またはから
アップロード。 見る 入力セレクター.

行番号 -オプション
「はい」、「いいえ」、または「リンク」

デフォルト: いいえ

タブを置き換える -オプション
0 の場合はタブは置換されません。それ以外の場合は、タブが出現するたびに置換されます。 キャラクター
次のタブストップに移動するために適切な量のスペースを入れてください。

デフォルト：0

タイトル -オプション
ファイルのタイトルを設定します。

エンコーディングなし -オプション
デフォルトでは コード2html 出力を次のいずれかとしてエンコードしようとします bz2/gz/Z もしクライアントが
これをサポートします (HTTP_ACCEPT_ENCODING) 必要なプログラムは次の場所から入手できます。
サーバ。 変更が必要な場合があります @CGI_ENCODING プログラムに合わせてスクリプト内で
場所。

If エンコーディングなし は「真」と定義されます コード2html 出力のエンコードは試行しません。

なぜ XNUMX つの CGI 入力があるのか​​と疑問に思われるかもしれません。これは、ユーザーが XNUMX つの方法から選択できるようにするためです。
ファイルをまたは、<brow> を使用します。
ボタンをクリックしてファイルを選択します。 私のホームページの例を参照してください。

もし $FILES_DISALLOWED_IN_CGI 0 の場合、ユーザーはすべてのファイルを読み取ることができます。
httpd が読み取ることができるファイル (CGI ラッパーなどを実行しない場合。
デフォルトでは、この値は 1 に設定されているため、CGI によるファイルの読み取りは許可されません。 あなたはできる
設定で許可する $FILES_DISALLOWED_IN_CGI スクリプトの先頭で 0 に設定します。

入力セレクター REDIRECT_URL 特別な説明が必要です。 ファイル名の構成は次のとおりです。
XNUMX つの環境変数 DOCUMENT_ROOT & REDIRECT_URL.

Apache に自動的に呼び出してもらいたい場合 コード2html すべてのプログラムのソース コード ファイルに対して、
これを行うには、次の XNUMX 行を srm.conf に追加します。

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

アクション text/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

またはこれに似たもの。 AddHandle 行では、どの拡張機能を追加するかを選択できます。
通過する コード2html.

警告注: この行に .pl を追加せず、このスクリプトに「code2html.pl」という名前を付けます。 この結果は
ループで。

また、必ずアクション モジュール (srm.conf) をロードしてください。

/cgi-bin/code2html を、ファイルにアクセスできる仮想の場所に置き換えます。
「foo=」の部分に注目してください。 Apache は、表示するファイルの URL を末尾に追加します。
アクション部分。 環境変数を使用するため、これは必要ありません。 REDIRECT_URL
ただし、入力セレクター文字列に追加される URL を取得する必要はありません。 したがって、私たちは
「&foo=」の部分を追加します。

ケビン・バートンに送信[メール保護]> アイデアに関しては。 彼は次のようにも述べています

> Apacheで使うとさらに強力です
> 鬼ごっこ
>
>
>
> #ここにアクションタグを使用します...この方法で次のことができます
> #サーバー上には通常の .java ファイルがまだあります。
>
>
>

実施例

前提 コード2html が現在のディレクトリにある場合は、次のように入力します。

code2html -l perl code2html.pl code2html.html

スクリプトを HTML ファイルに変換します。

onworks.net サービスを使用してオンラインで code2html を使用する