这是 t2html 命令，可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
t2html - 简单的文本到 HTML 转换器。 依赖于文本缩进规则。
概要
t2html [选项] file.txt > file.html
商品描述
将纯文本文件转换为漂亮的、可能带有框架的 HTML 页面。 一个例子
转换：
1.纯文本源代码
http://pm-doc.git.sourceforge.net/git/gitweb.cgi?p=pm-doc/pm-doc;a=blob_plain;f=doc/index.txt;hb=HEAD
2. 自定义 --css-file 选项的转换结果：
http://pm-doc.sourceforge.net/pm-tips.html
http://pm-doc.sourceforge.net/pm-tips.css
3. Emacs 模式 tinytf.el 用于编写文本文件（可选）
https://savannah.nongnu.org/projects/emacs-tiny-tools
操作系统需求 HPMC胶囊 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 输入 ASCII 档
该文件必须以技术格式编写，其布局在此
手动的。 基本上这个想法很简单，只有两个标题级别：一个在第 0 列
另一个在第 4 列（标签宽度的中间）。 标准文本从列开始
8（按下tab键后的位置）。
技术格式的思想是每一列代表不同的渲染布局
生成的 HTML。 文本文件中不需要特殊标记，因此您可以使用
文本版本作为常见问题解答等的主副本。项目符号、编号列表、单词强调和
引语等可以用自然的方式表达。
HTML 描述
生成的 HTML 包括嵌入的层叠样式表 2 (CSS2) 和一小段
爪哇代码。 CSS2 用于为页面布局着色并定义合适的打印
字体大小。 生成的 HTML 还采用了一种支持 XHTML 的方法。 见页面
http://www.w3.org/TR/xhtml1/#guidelines 其中向后兼容性建议
概述：
合法的 HTML XHTML 要求
..
XHTML 不支持带有“name”元素的片段标识符#foo，但使用“id”
反而。 为了向后兼容，定义了两个元素：
< ..name="tag"> 现在是 <.. name="tag" id="tag">
注意：这个程序从来没有被设计用于 XHTML 和严格的 XHTML 有效性
不值得期待。
激励卡片
编写大型文档（如常见问题解答）的最简单格式是文本。 一个文本文件提供
WysiWyg 编辑，它可以很容易地变成 HTML 格式。 文本文件很容易
维护并且没有特殊文本编辑器的要求。 任何文本编辑器，如
notepad、vi、Emacs都可以用来维护文档。
如果文档处于版本控制之下，文本文件也是唯一合理的格式
像 RCS、CVS、SVN、Arch、Perforce、ClearCase。 它们可以很容易地与 diff 和
补丁可以很容易地接收和发送给他们。
为了帮助维护大型文档，还提供了一个 Emacs的 次要模式，包
被称为 小精灵，提供带有颜色的文本字体、缩进控制、项目符号
填充、标题重新编号、单词标记、语法突出显示等。请参阅项目
http://freshmeat.net/projects/emacs-tiny-tools
配置
网址： 标题 和 页脚 选项
--按原样
禁止任何额外的 HTML 格式或文本操作。 文本按原样保留
出现在文件中。 如果您计划交付或打印所见文本，请使用此选项。
o 如果文件包含“目录”，则不会删除
o 未创建内容块表（通常会）
- 作者 -a STR
文件的作者，例如 - 作者 “约翰 母鹿”
--免责声明文件 文件
出现在页脚的文本是从此文件中读取的。 如果没有给出默认值
添加了版权文本。 选项“--quiet”和“--simple”禁止免责声明。
- 文档 文件
姓名 文档或文件名。 您可以列出文档的所有替代 URL
使用此选项。
- 电子邮件 -e 邮箱地址
文档作者的联系地址。 必须是纯电子邮件地址，没有
包括“<”和“>”字符。 例如。 - 电子邮件 [电子邮件保护]
- 电子邮件 ”[电子邮件保护]>" 错
- 电子邮件 ”[电子邮件保护]“ 对
- 简单的 -s
仅打印最小页脚：联系人、电子邮件和日期。 使用“--quiet”完全
丢弃页脚。
--t2html-标签
允许处理嵌入的#T2HTML- 文件内的指令。 查看完整说明
通过阅读主题“嵌入文本内的指令”。 默认情况下，您不需要
提供这个选项 - 默认情况下它是“on”的。
要忽略文本文件中的嵌入指令，请提供“no”选项： --not2html-标签.
- 标题 STR -t STR
出现在浏览器顶部框架中的标题文本。
--网址 网址
HTML 文件的位置。 什么时候 - 文档 给出了名字，这给出了位置。 这个
信息打印在页脚处。
网址： 导航 网址
- 根据 网址
HTML 文件在 目的地 网站 它将在哪里可用。
仅当文档托管在 FTP 服务器上时才需要此选项（罕见，但
可能的）。 基于 FTP 服务器的文档不能使用目录链接（片段
＃标签 标识符），除非还定义了 HTML 标记 BASE。
参数可以是文档的完整 URL：
- 根据 ftp://ftp.example.com/file.html
- 根据 ftp://ftp.example.com/
--按钮标题顶部
添加额外 [TOC] 每个标题末尾的导航按钮。 这可能有用
在长的非框架 HTML 文件中。
--按钮顶部 网址
按钮按顺序放置在文档顶部：[上一个][顶部][下一个]和
- 按钮-* 选项定义 URL。
如果 URL 是字符串 没有 然后没有插入按钮。 如果按钮是
由单独的程序定义。 以及使用 Perl 的示例：
#!/usr/bin/perl
我的 $top = "index.html"; # 设置默认值
我的 $prev = "none";
我的 $next = "none";
# ... 某处 $prev 或 $next 可能会被设置，或者不会
qx(t2html --button-top "$top" --button-prev "$prev" --button-next "$next" ...);
# 示例程序结束
--按钮上一个 网址
转到上一个文档或字符串的 URL 没有.
--下一个按钮 网址
转到下一个文档或字符串的 URL 没有.
- 参考 标签=值
您可以在文本中添加任何自定义引用（标签）并将它们扩展为任何值。
可以多次给出此选项，并且每次出现 TAG 时都替换为
价值。 例如，当给出以下选项时：
--reference "#HOME-URL=http://www.example.com/dir"
--reference "#ARCHIVE-URL=http://www.example.com/dir/dir2"
在文本中引用时，生成的 HTML 包括扩展扩展为值。 一个
示例文本：
主页是 #HOME-URL/page.html 和它的镜像页面
#ARCHIVE-URL/page.html 您可以在其中找到最新版本。
-R, --引用分隔符 STRING
看上面。 用于拆分 TAG 和 VALUE 的字符串。 默认为等号“=”。
-T, --toc-url-打印
显示构成目录 (NAME
AHREF 标签）在文档中。 列表输出到stderr，这样就可以
分开：
% t2html --toc-url-print tmp.txt > file.html 2> toc-list.txt
你在哪里需要这个？ 如果您想知道文件的片段标识，
你需要名单。
http://www.example.com/myfile.html#fragment-标识符
网址： 控制 的CSS 代 （HTML 表）
--css-代码-bg
此选项会影响代码部分（第 12 列）的呈现方式。 通常该部分
被一个包围.. 代码，但有了这个选项，更多的东西
发烧友使用。 代码被包裹在一个... 和背景
颜色设置为灰色阴影。
--css-代码注释 “正则表达式”
附加选项 --css-代码-bg 需要激活此选项。 使用定义的特殊词
regexp（默认为“注意：”）将专门标记代码部分。 “第一个字”是
与提供的 Perl 正则表达式匹配。
提供的正则表达式不得、重复、不得包括任何匹配的组运算符。
这只是意味着，不允许使用像“(one|two|three)”这样的分组括号。
您必须使用 Perl 非分组的，如“(?:one|two|three)”。 请参考perl
手册页 [perlre] 如果这个简短的介绍没有提供足够的绳索。
使用此选项，而不是呈现第 12 列文本.. ， 文本
看起来就像普通文本，但有一些扭曲。 文本的背景颜色有
已更改为深灰色，以在视觉上从文本中脱颖而出。
一个例子将阐明。 假设你传递了选项 --css-代码-bg 和
--css-code-note='(?:Notice|Note):'，它指示在处理第一段
第 12 列不同。 像这样：
这是出现在第 8 列某处的常规文本。
它可能包含本段中的几行文本。
注意：这是特别部分，第 12 列，
本段中的第一个词是“注意：”。
只有这样才能使第 12 列的这一段特别。
现在，我们有一些代码要显示给用户：
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
一个注释，用首字母特殊词书写的文本，如“通知：”，必须全部合二为一
完整的段落。 随后的任何其他段落都呈现为代码部分。 喜欢
这里：
这是出现在某处的常规文本
它可能包含本段中的几行文本
注意：这是特别部分，第 12 列，
这一段的第一个词是“注意：”
这使它特别
然而，这一段不是特别呈现
没有了。 只有上面的第一段。
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
好像这还不够，有一些特殊的表控制指令可以让
你控制.. 它放在第 12 列的代码部分周围。
以下是一些示例：
这是示例 1
#t2html::td:bgcolor=#F7F7DE
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
这是示例 2
#t2html::td:bgcolor=#F7F7DE:tableborder:1
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
这是示例 3
#t2html::td:bgcolor="#FFFFFF":tableclass:dashed
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
这是示例 4
#t2html::td:bgcolor="#FFFFFF":table:border=1_width=94%_border=0_cellpadding="10"_cellspacing="0"
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
看起来很神秘？ 无能为力，为了让你完全理解什么
这些指令可以，您需要了解可以将哪些元素添加到
和令牌。 有关可用属性，请参阅 HTML 规范。 这是
简要介绍您可以做什么：
启动命令是：
#t2html::
|
在此之后是 key:value 形式的属性对
和多个作为 key1:value1:key2:value2 ...
“键：值”对可以是：
td:属性
|
这被转换为
表：属性
|
这被转换为
ATTRIBUTES 中不能有空格，因为“First-word”必须是一个
连续词。 可以使用下划线代替空格：
表：边框=1_宽度=94%
|
解释为
也可以使用单词“tableclass”更改默认的 CLASS 样式。 为了
CLASS 有用，它的 CSS 定义必须是默认的
配置或从外部文件提供。 查看选项 --脚本文件.
表类：名称
|
解释为
例如，可以使用几种默认样式：
1）这是CLASS“虚线”示例
#t2html::tableclass:虚线
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
2）这是CLASS“solid”示例：
#t2html::tableclass:solid
for ( i = 0; i++; i < 10 )
{
// 在这个循环中做一些事情
}
您可以更改默认表定义的任何单个值，即：
要更改例如仅值 cellpadding，您会说：
#t2html::table:tablecellpadding:2
如果您不确定所有这些是关于什么的，只需运行程序 --测试页面
并查看源文件和生成的 HTML 文件。 那应该提供更多的绳索
实验。
--css-文件 文件
包括它指的是外部 CSS 样式定义源。 这个选项
被忽略如果 --脚本文件 已给出选项，因为该选项导入整个
HEAD 标签内的内容。 此选项可以多次出现，并且外部 CSS
文件按列出的顺序添加。
--css-字体类型 CSS定义
将 BODY 元素的字体定义设置为 CSS-DEFINITION。 使用的默认值是
报纸和书籍中使用的常规排版：
--css-font-type='font-family: "Times New Roman", serif;'
--css-字体大小 CSS定义
将 body 元素的字体大小设置为 CSS-DEFINITION。 默认字体大小表示
分：
--css-font-size="字体大小：12pt;"
网址： 控制 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 身体 of 文件
- 删除 REGEXP
删除匹配 perl REGEXP 的行。 如果您使用某些文档工具，这很有用
在文本文件中使用导航标签，您不想在生成的
HTML。
--删除电子邮件标题
删除文件开头的电子邮件标题，直到第一个空行开始
身体。 如果您将文档准备好用于 Usenet 新闻发布，它们可能包含
标题和正文：
从： ...
新闻组：...
X-Sender-信息：
概要：
正文
--nodelete-默认值
使用此选项可取消默认文本删除（已启用）。
Emacs "folding.el" 包和 vi 可以与任何文本或编程语言一起使用
在标签之间放置文本部分 {{{ 和 }}}. 您可以打开或关闭此类折叠。
这允许将大文档保持有序且易于管理。 对于 Emacs
支持，看 ftp://ftp.csd.uu.se/pub/users/andersl/beta/
默认值会删除这些标记和特殊注释“#_comment”，这使得它
可以包含未包含在生成的输出中的自己的笔记。
{{{ 安全部分
#_comment 确保您将此部分修改为
#_comment 下一个版本
安全性是日常管理中的一个重要问题...
更多文字...
}}}
--html-正文 STR
添加到 HTML 标签的附加属性. 您可以例如定义语言
文字与 --html-正文 语言=en 这将生成 HTML 标签看
ISO 639 的“另请参见”部分。
--html-column-beg="规范 HTML-规范"
列 1,2,3 5,6,7,8,9,10,11,12 的默认解释可以更改为
求 和 end 开关。 列 0,4 不能更改，因为它们是为
标题。 以下是一些示例：
--html-column-beg="7quote "
--html-column-end="7quote "
--html-column-beg="10 类='column10'"
--html-column-end="10 ”
--html-column-beg="引用"
--html-column-end="引用"
请注意： 您只能给出直到第 12 列的规格。如果文本超出列
12，它的解释就像在第 12 列一样。
除了列号， SPEC 也可以是以下字符串之一
规范等效词标记
------------------------------
引用`'
胆大 _
工作 *
小+
大 =
ref [] like: [Michael] 引用 [rfc822]
其他可用规格
------------------------------
7quote 当第 7 列以双引号开头时。
有关每种颜色的样式表值，请参阅 程 属性和用途 --脚本文件
导入定义的选项。 通常 /usr/lib/X11/rgb.txt 列出可能的颜色值
和 HTML 标准在 http://www.w3.org/ 定义以下标准命名颜色：
黑色 #000000 栗色 #800000
绿色 #008000 海军蓝 #000080
银色 #C0C0C0 红色 #FF0000
石灰色 #00FF00 蓝色 #0000FF
灰色 #808080 紫色 #800080
橄榄色 #808000 青色 #008080
白色 #FFFFFF 紫红色 #FF00FF
黄色 #FFFF00 水色 #00FFFF
--html-column-end="COL HTML-规范"
参见 --html-列-beg
--html-字体 尺寸
定义字体大小。 为演示文稿设置更大的字体大小可能很有用。
-F， --html框架 [框架参数]
如果给定，则生成三个单独的 HTML 文件。 左框架将包含
TOC 和右框架包含文本的其余部分。 这 框架参数 可以是任何有效的
HTML 标记 FRAMESET 的参数。 默认值为“cols="25%,75%"”。
使用这意味着 - 出去 自动选项，因为无法打印三个文件
到标准输出。
文件.html
--> file.html Frame文件，点浏览器这里
file-toc.html 左框架（导航）
file-body.html 右框架（内容）
- 语 ID
使用语言 ID，一个两个字符的 ISO 标识符，如英语中的“en”
生成 HTML。 这只会影响向最终用户显示的文本，如文本
“目录”。 默认设置为“en”。 有关标准，请参阅“另请参见”部分
ISO 639 和 ISO 3166 以获得正确的代码。
所选语言以两种方式更改 propgram 的内部数组：1) 而不是
将使用以国家语言等效为标题的默认“ocntents 表” 2)
嵌入顺序编号图片下方的文字“图片”将使用天然
当量。
如果您的语言不受支持，请发送“目录”的短语和
在您的语言中向维护者提供“图片”一词。
--脚本文件 文件
包含必须完整的java代码从文件。 代码是
放进去每个 HTML。
- --脚本文件 是将任何内容导入 HEAD 元素的通用方法。 例如。 如果
你想为所有人保留单独的样式定义，你只能导入一个指针
到样式表。 看 14.3.2 指定 外部 样式 表 在 HTML 4.0 标准中。
--元关键字 STR
元关键字。 被搜索引擎使用。 将像“AA、BB、CC”这样的关键词与
逗号。 请参阅 HTML 4.01 规范和主题“7.4.4 元数据”并查看
http://www.htmlhelp.com/reference/wilbur/ 和
--元关键字“AA，BB，CC”
--元描述 STR
元描述。 包括描述字符串，最多 1000 个字符。 这是由
搜索引擎。 请参阅 HTML 4.01 规范和主题“7.4.4 元数据”
--名称唯一性
标题中的前 1-4 个单词用于 HTML 姓名 标签。 然而，它是
可能两个相同的标题以完全相同的 1-4 个单词开头。 在这些情况下
你必须打开这个选项。 它将使用计数器 00 - 999 而不是来自
用于构建 HTML 的标题 姓名 引用。
请仅在紧急情况下使用此选项，因为指的是跳转块 姓名 通过
httpI://example.com/doc.html#header_name
比使用晦涩的引用更方便
httpI://example.com/doc.html#11
此外，每次添加新标题时，数字都会发生变化，而符号
只要您不更改标题，从标题中选取的名称就会保持不变。 想一想
为您收藏页面的网友的福利。 尝试制作没有标题的标题
相同的主题，您不需要此选项。
文件 保养 和 批量 工作 命令
-一种， - 自动侦测
仅当从文件中找到标签“#T2HTML-”时才转换文件。 这个选项很方便，如果你
运行批处理命令将所有文件转换为 HTML，但前提是它们看起来像 HTML base
文件：
找 。 -name "*.txt" -type f \
-exec t2html --自动检测 --verbose --out {} \;
该命令搜索当前目录下的所有 *.txt 文件并将它们提供给
转换程序。 这 - 自动侦测 只转换包含“#T2HTML-”的文件
指令。 其他文本文件不会被转换。
--链接检查 -l
检查所有 http 和 ftp 链接。 本篇 选项 is 应该 至 be 运行 独立 附加选项
- 安静的 与链接检查一起使用时具有特殊含义。
使用此选项，您可以定期验证您的文档并删除无效链接或
更新移动的链接。 有问题的链接输出到 斯特德. 这个链接检查
仅当您安装了 LWP Web 库时，该功能才可用。 程序将
检查您是否在运行时拥有它。
大的链接，例如哪个匹配 tar.gz的 邮编 ... 或者运行程序（链接到
? 字符）被忽略，因为检查中使用的 GET 请求将返回整个
链接的内容，它会。 太贵了。
一个建议：当你把二进制链接放到你的文档中时，用空格添加它们：
http://example.com/dir/dir/ 文件名.tar.gz
然后程序 不 检查http地址。 用户可能无法获取文件
一键，检查器至少可以验证目录。 如果您不是所有者
链接，也有可能文件已移动，新版本名称有
出现了。
-L, --链接检查单
打印压缩输出 grep的 -n 喜欢的样子 文件:行:消息
此选项将 url 响应文本连接到单行，以便您可以查看
一行中的消息。 您可以使用编程工具（如 Emacs Mx 编译）
可以解析标准 grep 语法以跳转到文档中的位置以更正
稍后链接。
-o， - 出去
将生成的 HTML 写入从输入文件名派生的文件。
--out --print /dir/file --> /dir/file.html
--out --print /dir/file.txt --> /dir/file.html
--out --print /dir/file.this.txt --> /dir/file.this.html
--链接缓存 缓存文件
当定期检查链接时，检查每个链接将是相当严格的
每次都已经成功了。 为了节省链接检查时间，“确定”
链接可以缓存到单独的文件中。 下次检查链接时，缓存是
打开，只检查发现不在缓存中的链接。 这应该
显着改善长搜索。 考虑这个例子，其中每个文本文件
递归检查。
$ t2html --link-check-single \
--安静 --link-cache ~tmp/link.cache \
`找到。 -name "*.txt" -type f`
-O, --输出目录 DIR
喜欢 - 出去，但切碎目录部分并将输出文件写入 DIR。 下列
将生成 HTML 文件到当前目录：
--out-dir 。
如果你有自动填写目录的工具，你可以用word 没有 至
忽略此选项。 以下是一个空操作，它不会生成输出到目录
“没有任何”：
--out-dir 无
-p, - 打印
HTML 处理后将文件名打印到标准输出。 通常程序不打印文件名，
只有生成的 HTML。
% t2html --out --print page.txt
--> page.html
-P, --打印网址
以 URL 格式打印文件名。 如果您想检查布局，这很有用
立即使用您的浏览器。
% t2html --out --print-url page.txt | 猞猁
--> 文件：/users/foo/txt/page.html
- 分裂 REGEXP
当 REGEXP 匹配时，将文档拆分为更小的部分。 分裂 命令 旨在 独立,
意思是，它开始和退出。 没有进行文件的 HTML 转换。
如果从线中找到 REGEXP，则它是拆分的起点。 例如分裂
根据没有编号的顶级标题，您可以使用：
--split '^[AZ]'
一个 3 位数的序列号被添加到生成的分音中：
文件名.txt-NNN
如果您想从每个标题生成幻灯片，拆分功能非常方便：首先
拆分文档，然后将每个部分转换为HTML，最后打印每个部分（页面）
单独到打印机。
-S1， --split1
这是简写 - 分裂 命令。 定义正则表达式以在顶级标题上拆分。
-S2， --split2
这是简写 - 分裂 命令。 定义正则表达式以在二级标题上拆分。
-SN， --拆分命名文件
拆分命令的附加指令。 如果您使用例如按标题拆分 --split1,
根据来自的前几个词生成文件名会提供更多信息
标题名称。 假设发生拆分的标题名称是：
计划指南
结语
然后生成的部分文件名如下。
文件名-program_guidelines
FILENAME-结论
-X， --xhtml
使用严格的 XHTML 呈现。 这意味着使用, 和段落使用.. .
“注意：这个选项是实验性的。见BUGS”
其他 选项
-调试 LEVEL
使用正 LEVEL 数字打开调试。 零意味着没有调试。
- 帮帮我 -h
打印帮助屏幕。 终止程序。
--帮助-CSS
打印使用的默认 CSS。 终止程序。 您可以复制和修改此输出并
指示使用你自己的 --css-file=文件. 您还可以将选项嵌入到文件中
使用“#T2HTML-OPTION”指令。
--帮助-html
以 HTML 格式打印帮助。 终止程序。
--帮助者
以 Unix 手册页格式打印帮助页面。 您想将此输出提供给 恩罗夫 -男子
为了阅读它。 终止程序。
--测试页面
打印测试页：演示功能的 HTML 和示例文本文件。
- 时间
打印到 stderr 用于处理文件的时间。
-v， --详细 [等级]
打印详细消息。
-q, - 安静的
根本不打印页脚。 这个选项有不同的含义，如果 --链接检查 选项是
开启：仅打印错误链接。
V, - 版
打印程序版本信息。
FORMAT 商品描述
程序将文本文件转换为 HTML。 基本思想是依靠缩进级别，并且
使用的布局称为“技术格式”（TF），其中仅使用最少的约定
标记斜体、粗体等文本。 基本原理可以在下面演示。 注意
顶部的列 Poisiton 标尺：
--//-- 解说开始
123456789 123456789 123456789 123456789 123456789 列号
标题 1 以最左边第 1 列的一个大字母开头
列位置 1,2,3 当前未定义，可能不会
格式正确。 不要将文本放在第 1,2、3 或 XNUMX 列。
标题级别 2 从半标签第 4 列开始，带有一个大字母
第 5 列的正常但有颜色的文本
第 6 列的正常但有颜色的文本
标题 3 可以考虑在位置 TAB 减 1，第 7 列。
“第7 列的特殊文本以双引号开头”
标准文本从第 8 列开始，您可以*强调*文本或
使其 _strong_ 并写入 =SmallText= 或 +BigText+ 显示
变量名“ThisIsAlsoVariable”。 你可以`_*嵌套*_'`the'
标记。 本段更多txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt
文本文件
第 9 列的强文本
第 10 列保留用于报价
第 10 列保留用于报价
第 10 列保留用于报价
第 10 列保留用于报价
第 11 列的强文本
第 12 列和进一步保留用于代码示例
第 12 列和进一步保留用于代码示例
这里的所有文字都被包围HTML代码
此 CODE 列受 --css-code* 选项的影响。
再次在第 2 列标题 4
如果您想要标题级别 3 之类的内容，请使用第 7 列（粗体）
第 8 列。标准选项卡位置。 txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt
[1998-09-10 傅先生说]：
引文引文引文引文引文引文引文
引文引文引文引文引文引文引文
引文引文引文引文引文引文引文
文本引用文本
* 第 8 列的项目符号。注意 (*) 后有 3 个空格，因此
文本从第 12 列的半标签向前开始。
* 子弹。 txt txt txt txt txt txt txt txt txt txt txt txt
* 子弹。 txt txt txt txt txt txt txt txt txt txt txt txt
,txt txt txt txt
请注意，上一段以 P 逗号结尾
代码，它告诉本段继续
项目符号模式，否则此文本在第 12 列
将被解释为代码部分 surrpoundedn
经过HTML 代码。
. 这是有序列表。
. 这是有序列表。
. 这是有序列表。
.此行以wirg dot开头，并单独显示在一行中。
.此行以wirg dot开头，并单独显示在一行中。
!! 这增加了一个HTML 代码，行中的文本标记为
!!
使此电子邮件地址可点击[电子邮件保护]> 不要
使此电子邮件地址可点击 [电子邮件保护]， 因为它
只是一个例子，不是真正的地址。 请注意，
最后一个没有被<>包围。 常见的登录名，如
忽略 foo、bar、quux 或 Internet 站点“示例”
自动。
也不做 [电子邮件保护]> 因为有额外的
空白。 这可能是禁用电子邮件的更方便的方法
临时地址。
在第 1 列再次标题 0
第 4 栏的副标题
和普通文本，第8列txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本文本
--//-- 解说结束
就是这样，描述了整个布局。 更正式的文本规则
格式如下所述。
用过的 标题
· 只有 二 这种风格的标题级别。 标题列是 0 和 4，而
标题必须以大写字母或数字开头
· 在第 4 列，如果文本以小写字母开头，则该行被解释为
·一个HTML 在级别 1 打印标题之前添加标记。
· 收集标题，构建TOC 并插入到HTML 的开头
页。 HTML TOC 中使用的引用是来自
标题。 确保你的标题是唯一命名的，否则会有相同的
生成的 HTML 中的 NAME 引用。 当空格被转换为下划线时
加入的话。 如果你不能用四个词写出唯一的标题，那么你必须
使用 --名称唯一性 开关
文字 放置 规则
一般用途总体评估
在某些列中定位文本的基本规则：
· 第 0 列的文本如果不是以大写字母或数字开头则未定义
指明标题级别 1。
· 第 1-3 列之间的文本标有
· 第 4 列保留用于标题级别 2
· 第 5-7 列之间的文本标有
·第7 列的文本是第一个字符是否为双引号。
· 第 10 列保留用于文本。 如果您想引用某人或添加参考
文本，将文本放在此列中。
· 第 9,11 列的文本标有
文本和特殊代码的第 8 列
· 第 8 列为普通文本保留
· 正文开头，第8栏，可以有DOT-code或COMMA-code。
第 12 列是特殊的
· 第 12 列被特殊处理：块以和线被标记为
. 当最后一个文本在 栏 12 被发现，块被关闭
请注意以下示例
txt txt txt ;均匀放置块，很好，就这样
文本文件
txt txt txt txt ;不能终止/pre，因为最后
txt txt txt txt ;列不在12
txt 文本 文本 文本 文本
txt 文本 文本 文本 文本
txt 文本 文本 文本 文本
txt 文本 文本 文本 文本
;; 完成评论，现在文本被均匀放置
额外 令牌 HPMC胶囊 使用 at 栏 8
· 如果在一行的开头有“.”（点）并且立即是非空格，那么
代码添加到行尾。
.这条线会有一个末尾的 HTML 标记。
虽然这两条线连接在一起
通过浏览器，取决于框架宽度。
· 如果有“,”（逗号），那么如果前一行是，则不插入代码
空的。 如果同时使用“.”（点）和“,”（逗号），它们必须按点逗号排列。 这
","（逗号）如果在项目符号中使用则不同
一种如果有段落分隔，总是添加，但是当你写一个
子弹，有问题，因为只要保留文本，子弹就存在
一起
* 这是一个项目符号，它包含所有文本 ketp
即使子弹中有另一行。
但是要将项目符号写成分散多个段落，您必须指示那些是
保持在一起，下一段中的文字不是当它被放置在
列12
* 这是一个项目符号，它包含所有文本 ketp
，即使项目符号中有另一行。
这是上一个项目符号的新段落，这是
不是文本样本。 请参阅上面的续 COMMA 代码。
* 这是新的子弹
// 这是子弹后的代码示例
如果 ( $flag ) { ..做某事.. }
Special 文本 标记
斜体、粗体、代码、小、大标记
_this_被intepreted因为这
*this* 被解释为this
“这”被解释为这个`
可以与上述混合的 Exra 修饰符。 通常如果你想要更大的字体，
大写单词。
这= =被intepreted因为这
这+ +是intepreted因为这
[this] 被解释为this
上标
word[this] 被解释为上标。 你可以使用像
this[1]、multiple[(2)] 和几乎 any[(ab)] 和
可以想象的[IV superscritps]只要左边
括号附在单词上。
下标
12[[10]] 是值 12 un base 10 的表示。
这被解释为下标。 你可以使用像
this[[1]]、multiple[[(2)]] 和几乎 any[[(ab)]] 和
可以想象的[[IV superscritps]] 只要*两个*左
括号附在单词上。
嵌入标准 HTML 标记
标准的特殊 HTML 实体可以以正常方式添加到文本中，或者使用
符号名称或哈希码。 以下是示例：
× < > ≤ ≥ ≠ √ −
α β γ ÷
« » ‹ › - - -
≈ ≡ ∑ ƒ ∞
° ±
™ © ®
€ £ ¥
将纯 HTML 嵌入到文本中
本篇 特集 is 高度 试验. 可以在文本中嵌入纯 HTML
在某些情况下，例如需要一些特殊格式。 问题很简单：你写
HTML 像往常一样，但将每个 '<' 和 '>' 字符加倍，例如：
< >
另一个规则是所有 PURE HTML 必须放在一起。 必须没有线
在纯 HTML 行之间中断。 这是不正确的：
<
< >一
< >二
< >
纯 HTML 必须在没有额外换行符的情况下编写：
<
< >一
< >二
< >
这种“加倍”也会影响正常的文本书写规则。 如果你写文件，
在您描述 Unix 风格的 HERE-documents 的地方，您不得将标记放在
彼此：
bash$ 猫<
一种
EOF
您必须使用空格编写上面的代码示例以防止“<<”解释
作为纯 HTML：
bash$ cat << EOF # 对了，加空格
一种
EOF
画一个短分隔符
一种 ！！ （两个感叹号）在文本列（位置 8）导致立即添加
代码。 之后的任何文字！！ 在同一行中写入和插入
刚过代码，因此文字格式化命令在此无效
线。
HTTP 和 email 标记 控制
· 所有 http 和 ftp 引用以及[电子邮件保护]> 电子邮件地址被标记
可点击。 电子邮件必须有周围的 <> 字符才能被识别。
· 如果 url 前面有连字符，则无法点击。 如果一个字符串 foo, bar, quux,
测试，从 url 中找到站点，则不计为可点击。
<[电子邮件保护]> 可点击
http://example.com 点击
< [电子邮件保护]> 不可点击； 包含空间
<5dko56$[电子邮件保护]> 消息 ID，不可点击
-http://example.com 连字符，不可点击
http://$EXAMPLE variable. not clickable
书单 和 子弹
·如果第8列有“o”或“*”，后面有3个空格，则构建公告表
它，以便文本从第 12 列开始。建议将项目符号行放在一起；
子弹块之间没有空格。
· 有序列表以“.”开头，一个点，写成文字开始的项目符号
在第 12 列。
Line 休息
· 所有换行符都在您的文档中可见，请勿使用多个换行符
单独的段落。
· 很重要的是只有 一种 标题后换行。
嵌入式 指令 INSIDE 文字
命令行选项
您可以通过提供选项取消遵守所有嵌入式指令 --not2html-标签.
您可以在文档的任何位置包含这些行，它们的内容包含在
HTML 输出。 每个指令行必须在一行中，并且不能被打破
单独的行。
#T2HTML-标题
#T2HTML-电子邮件
#T2HTML-作者
#T2HTML-DOC
#T2HTML-元关键字
#T2HTML-元描述
您可以传递嵌入在文件中的命令行选项。 就像你想要代码一样
部分（第 12 列）以灰色阴影着色，您可以添加：
#T2HTML-选项 --css-code-bg
或者您可以要求打开特定选项。 请注意，每一行都是
因为您在命令行中传递了参数。 想象一下周围的双引号
围绕作为相关选项参数的行。
#T2HTML-选项——原样
#T2HTML-OPTION --安静
#T2HTML-选项--语言
#T2HTML-OPTION zh
#T2HTML-OPTION --css-字体类型
#T2HTML-OPTION 投石机 MS
#T2HTML-选项 --css-code-bg
#T2HTML-选项 --css-code-note
#T2HTML-选项（？：注意|通知|警告）：
您还可以将自己的评论嵌入到文本中。 这些被剥离：
#T2HTML-COMMENT 你在这里评论
#T2HTML-COMMENT 你还有一个评论
嵌入文件
#INCLUDE- 命令
这用于将内容包含到当前当前位置。 网址可以是
文件名引用，其中每个 $VAR 都从环境变量中替换。 这
不支持波浪号 (~) 扩展。 包含的文件名是操作系统
支持的路径位置。
前缀“raw:”禁用任何正常格式。 文件内容按原样包含在内。
URL 也可以是对远程位置的 HTTP 引用，其内容包含在
在这一点上。 如果是远程内容或文件名以扩展名“.html”结尾或
“.html”，内容被剥离以包含内容
可能的。 在下图中，只有 BODY 内标有 !! 的线条是
包括：
...
这篇文！！
还有更多这个！！
例子：
#INCLUDE-$HOME/lib/html/picture1.html
＃包括-http://www.example.com/code.html
#INCLUDE-raw：示例/code.html
嵌入图片
#PIC 命令用于在文本中包含图片
#PIC picture.png#Caption Text#Picture HTML 属性#align#
（1）（2）（3）（4）
1. 图片的名称或 URL 地址。 喜欢图片/this.png
2. 出现在图片下方的文字
3.里面附加的附加属性标签。
为了, 这条线会
读：
#PIC some.png#标题文字#width=200 length=200##
4.图像位置：“左”（默认）、“中”、“右”
注意：“标题文本”也将成为图像的 ALT 文本，用于
如果浏览器无法显示图片。 您可以取消 ALT 文本
带选项 --无图片替代.
命名标签的片段标识符
#REF 命令用于引用 HTML 当前文档中的标签。 这
整个命令必须放在一行上，不能分成多个
线。 一个例子：
#REF #how_to_profile；（注意：分析）；
（1）（2）
1. 当前文档中的 NAME HTML 标签引用，一个单词。
这也可以是完整的 URL 链接。
您可以通过启用 --toc-url-print 选项来获取 NAME 列表。
2. 可点击文本由 ; 人物。
参考外部文件。
“#URL”标签可用于内嵌 URL，从而使完整链接不可见。
只有显示的文本用于跳转到 URL。 该指令不能被分解为
单独的行，
#网址
| |
| 此处允许空格
必须保持在一起
就像这样写：
查看搜索引擎#URLhttp://www.google.com>
表 OF 内容 标题
如果标题 1 准确命名为“目录”，则所有文本到
下一个标题将从生成的 HTML 文件中丢弃。 这样做是因为程序
生成自己的 TOC。 假设您使用一些文本格式化程序来
在 .txt 文件中为您生成目录，您无需手动维护它。 例如
Emacs 包 小精灵 可以使用。
故障排除
产生 HTML 文件 做了 而不去 看 什么 I 拟
最常见的错误是文档中有多余的换行符。 保持 一种 空的
标题和文本之间的线，保持 一种 段落之间空行，保留 一种 空的
正文和项目符号之间的线。 让它成为你的口头禅： 一种 一种 一种 ...
接下来，您可能将文本放在错误的列位置。 请记住，常规文本位于
第 8 列。
如果生成的 HTML 突然开始只使用一种字体，例如，那你就忘了
关闭块。 让它读起来均匀，像这样：
代码块
代码块
代码块
;; 在此处添加空注释以“关闭”第 12 列的代码示例
标题以大字母或数字开头，例如“标题”，而不是“标题”。 再检查一遍
拼写。
示例
要打印测试页并显示所有可能性：
t2html --测试页面
要制作没有任何元信息的简单 HTML 页面：
t2html --title "Html 页面标题" --author "Mr. Foo" \
--simple --out --打印文件.txt
如果您定期发布电子邮件格式，请使用 --删除电子邮件标题 忽略标题
文本：
t2html --out --print --delete-email-headers page.txt
使页面快速
t2html --html-frame --out --print page.txt
从文本文档转换页面，包括元标记、按钮、颜色和框架。 支付
注意切换 --html-正文 它定义了文档语言。
t2html\
- 打印 \
- 出去 \
--作者“富先生”\
- 电子邮件 ”[电子邮件保护]" \
--title "这是页面 BAR 的手册页" \
--html-body 语言=en \
--button-prev previous.html \
--按钮顶部index.html \
--buttion-next next.html \
- 文档 http://example.com/dir/this-page.html \
--url 手册.html \
--css-代码-bg \
--css-code-note '(?:Note|Notice|Warning):' \
--html-框架\
--免责声明文件 $HOME/txt/my-html-footer.txt \
--meta-keywords "language-en,manual,program" \
--meta-description "Bar 程序来做这个和更多的那些" \
手册.txt
检查链接并打印所有链接的状态与 http 错误消息（大多数
详细）：
t2html --link-check file.txt | 三通链接-error.log
仅打印有问题的链接：
t2html --link-check --quiet file.txt | 三通链接-error.log
以 egep -n 之类的方式打印简洁的输出：行号、链接和错误代码：
t2html --link-check-single --quiet file.txt | 三通链接-error.log
要检查来自多个页面的链接并将好的链接缓存到单独的文件，请使用 --链接缓存
选项。 下一个链接检查将运行得更快，因为缓存的有效链接不会被
又取了。 定期删除链接缓存文件以强制完成检查。
t2html --link-check-single \
--链接缓存 $HOME/tmp/link.cache \
--安静的文件.txt
要将大文档拆分为多个片段，并将每个片段转换为 HTML：
t2html --split1 --split-name 文件.txt | t2html --simple --out
环境
邮箱地址
如果环境变量 邮箱地址 已定义，它用于页脚中的联系地址。
附加选项 - 电子邮件 覆盖环境设置。
朗
开关“--language”的默认语言设置确保前两个
字符包含语言定义，如： LANG=en.iso88591
使用 onworks.net 服务在线使用 t2html
