code2html - 云端在线

程序：

您的姓名

code2html - 将程序源代码转换为 HTML

概要

(1) 代码2html [选项[输入文件 [输出文件]]

(2) 代码2html -p [文件 [备用输出文件]]

(3) 代码2html （作为 CGI 脚本；请参阅有关 CGI)

商品描述

代码2html 是一个 perl 脚本，它将程序源代码转换为突出显示的语法
HTML，或为至多规则定义的任何其他格式。

(1) 配置
输入文件
是包含要格式化的程序源代码的文件。 如果不
指定或给定减号 (-)，将从 STDIN 读取代码。

输出文件
是要写入格式化代码的文件。 如果未指定或减号 (-) 是
给定，代码将被写入 STDOUT。

-l, --语言模式
指定要使用的正则表达式集。 这些必须在一个
语言文件（见 FILES 以下）。 要找出定义了哪些语言模式，
发出 代码2html --模式.

此输入不区分大小写。

如果未给出，将使用一些启发式方法来确定文件语言。

-v, --详细
将进度信息打印到 STDERR。

-n, --行号
打印出带有行号的源代码。

-N, --链接编号
打印出带有行号的源代码。 行号将链接到
自己，这使得发送链接到线路变得容易。

-P, - 字首
用于行号锚点的可选前缀。

-t, --替换标签[=制表位宽度]
替换每次出现的具有适当数量的空格的字符
到下一个制表位。 默认值为 8 个字符的制表位宽度。

-L, --语言文件=语言文件
指定一个替代文件以从中获取语言和输出格式定义
（见有关部分 FILES 下文）。

-m, --模式
打印当前定义为 STDOUT 的所有语言模式和输出格式并退出
成功。 还从一个打印模式 语言文件 由 --语言文件 if
适用。

- 倒退=朗
如果给定的语言模式 --语言模式 找不到然后使用这个
模式。

- 倒退 平原 例如，当 代码2html 从脚本调用
确保创建输出。

-h, - 帮帮我
打印一个简短的帮助并成功退出。

-V, - 版
打印程序版本并成功退出。

-c, - 内容类型
打印“Content-Type: text/html\n\n”（或任何输出格式定义为
内容类型）在输出的其余部分之前。 如果脚本被调用为有用
一个 cgi 脚本。

-o, - 输出格式
选择输出格式。 html 是默认的。 找出哪些输出格式
被定义，发出一个 代码2html --模式.

-H, --无标题
不要使用输出格式定义的模板。 对于 HTML 这意味着
不会有, ， 和不
标签。

- 模板=文件
覆盖给定输出格式的默认模板。 如果 --无标题 is
也给出了，这没有意义，因为无论如何都会忽略模板。

-T, - 标题
设置生成的输出文件的标题。 仅当模板有效时才有效
支持设置标题。

-w, - 行宽=行宽
换行 行宽 人物。 默认是根本不换行。

-b, --换行前缀=行前缀
使用 线前缀 在换行的开头。 默认为“»”。

(2) HTML 修补
代码2html -p [文件 [备用输出文件]]

代码2html 还允许您在 html 文件中包含内联源代码。 然后它可以
此 html 文件并插入语法突出显示的代码。

如果没有给出文件， 代码2html 从 STDIN 读取并写入 STDOUT。 如果只有一个文件
鉴于它用输出替换了这个文件。 如果提供了两个文件，第一个是
读取和第二个写入。

要使用此功能，只需在您的 html 文件中插入类似的内容：

-->

语法高亮文件将被插入到这个位置标签。

可以在命令行上给出的所有选项，如 --行号 等工作。 - 帮帮我,
- 版等也可以工作，但是使用它们不是很聪明:)。 使用
- 输出格式 不建议选择非 HTML 输出格式。 - 内容类型 is
忽略了。

您也可以直接在 html 文件中编写程序的源代码，如下所示
句法：

<!-- code2html 添加[选项]



- >

通常最好至少给出 --语言模式 选项来指定
语言。

(3) CGI
如果脚本用作 CGI 脚本 (GATEWAY_INTERFACE 环境设置和没有
给出命令行参数） 代码2html 从查询字符串中读取参数
或来自 SDTIN。 （方法 POST 和 GET）。

- 内容类型 自动开启，输出始终为 STDOUT。

接受以下参数/选项：

语言模式 - 选修的
‘c’、‘cc’、‘pas’等。

如果没有给出，则使用一些启发式方法来找出语言。

后备 - 选修的
`plain', `c' 等，如果找不到语言模式，就用这个

输入选择器 - 选修的
“文件”、“cgi-input1”、“cgi-input2”或“REDIRECT_URL”

默认值：文件

文件名
要从中读取的文件 if 输入选择器 是‘文件’

cgi输入1
语法高亮的源代码。 例如从一个或从
上传。 看 输入选择器.

cgi输入2
语法高亮的源代码。 例如从一个或从
上传。 看 输入选择器.

行号 - 选修的
“是”、“否”或“链接”

默认值：否

替换标签 - 选修的
如果为 0，则不替换制表符，否则替换每次出现的特点
使用适量的空格进入下一个制表位。

默认值：0

标题 - 选修的
设置文件的标题。

无编码 - 选修的
默认情况下 代码2html 尝试将输出编码为 bz2/gz/Z 如果客户
支持这个（HTTP_ACCEPT_ENCODING) 并且所需的程序可在
服务器。 您可能需要修改 @CGI_编码 在脚本中匹配您的程序
位置。

If 无编码 被定义为“真” 代码2html 不尝试对输出进行编码。

为什么你可能会问两个 cgi 输入：这是为了让你的用户选择一个
接口是否要将他们的文件插入到或用户 <browse>
按钮选择他们的文件。 请参阅我主页上的示例。

请注意，如果 $FILES_DISALLOWED_IN_CGI 为 0 您的用户可以阅读所有
httpd 可以读取的文件（如果您不运行 cgi-wrapper 或类似的东西。通过
默认此值设置为 1，因此不应允许通过 cgi 读取文件。 你可以
允许它设置 $FILES_DISALLOWED_IN_CGI 到脚本顶部的 0。

输入选择器 重定向网址 需要特别说明。 文件名由
两个环境变量 DOCUMENT_ROOT 和 重定向网址.

如果你想让apache自动调用 代码2html 对于所有程序源代码文件，您
可以通过将这两行添加到您的 srm.conf 来做到这一点：

AddHandler 文本/x-源代码 .c .cc .cpp .pas .h .p

动作文本/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

或类似的东西。 在 AddHandle 行中，您可以选择要添加的扩展名
通过 代码2html.

警告: 不要将 .pl 添加到此行并将此脚本命名为“code2html.pl”。 这将导致
在一个循环中。

还要确保您加载了 Action 模块 (srm.conf)。

将 /cgi-bin/code2html 替换为可以访问文件的虚拟位置。
注意“foo=”部分。 Apache 附加文件的 URL 以显示在
动作部分。 我们不需要这个，因为我们使用环境变量 重定向网址
但是我们不想将 url 添加到输入选择器字符串中。 因此我们
附加“&foo=”部分。

Tnx 到凯文伯顿[电子邮件保护]> 的想法。 他还指出

> 如果在 Apache 中使用它会更强大
> 标签
>
>
>
> #在这里使用你的 Action 标签...这样你就可以
> #您的服务器上仍然有常规的 .java 文件。
>
>
>

例

假设 代码2html 在当前目录中，您可以键入

code2html -l perl code2html.pl code2html.html

将脚本转换为 html 文件。

使用 onworks.net 服务在线使用 code2html