¶ TXT2TAGS 示例

2005-04-01 23:23

1. 介绍 Intro.

欢迎阅读 txt2tags 示例文件!

这里你可以看到常用的所有 t2t 使用

文件的头二行是文档的基本信息, 按照以下顺序填写:

行 1: 文档标题
行 2: 作者名,邮箱
行 3: 日期,时间

空行,是自然段间的分隔

中文用户,一般要再单另一行声明编码:

%!encoding: gb2312

最好使用更加通用的Unicode 编码:

%!encoding: UTF-8

1.1. 文档声明

使用编辑环境时最好加入类似文档声明:

%! Target  : html
%! Options : --toc --css-inside
%! Options : --css-sugar
%! Style   : css/moin.css

说明本文输出时的重要参数:

  1. 输出为标准HTML标签格式
  2. 要文档标题索引,并将CSS形式表包含在文档内
  3. 将文章按照结构使用 DIV 层来分离,以便使用CSS来进行美化
    • 就象sample中展示的modern 效果
  4. 使用外部指定的一个CSS定义

2. 字体与美化 Fonts and Beautifiers

整体上来说t2t 使用两种字体设定:

正常 字体可以使用各种美化处理

打印机字体 即“等宽体” 是被预格式化处理的不能被美化处理

现在进入详细章节...

2.1. 美化 Beautifiers

就象你在 email 中定义文本样式一样,t2t 可以简单的快速美化字样

  • 双* 产生 加重效果
  • 双/ 产生 斜体效果
  • 双_ 产生 下线

    并且可以混合使用

2.2. 更多的装饰 More Cosmetics

特殊的内容,比如说 email ([email protected]) 和 URL (http://www.duh.com) 会自动处理 还有横线:


^ 细的 或是 粗的 v


你也可以定义带URL的标签外部链接

并且记住,

在一行前缀一个制表符将产生引用, A TAB in front of the line does a quotation.
而且可以嵌套使用用 More TABs, more depth (if allowed).

非常好用的!.

3. 列表

形成一个列表非常的自然,只要在行前使用 减号 或是 加号

3.1. 普通列表 Plain List

减号 用来标识默许的列表. 对于嵌套列表只要在行前加 空格 , 并且很自然的,越多的空格,层次就越深

  • 地球
    • 中国
      • 北京
        • 海淀
          • 还要多深?
    • 朝鲜
      • 更多的国家
  • 火星
    • 上面有谁?

想结束列表,只要使用连续两个空行

3.2. 数字列表 Numbered List

同样的规则,只是使用 加号,则自动处理为数字式的列表

  1. 甲 one
  2. 乙 two
  3. 丙 three
    • 混合普通列表 mixed lists!
    • 没有关系
      1. 继续数字式的 counting again
      2. ...
  4. 丁 four

3.3. 定义列表 Definition List

使用冒号,可以引出词典式的列表. 内容是在紧接的下一行

桔 orange
黄色的水果 a yellow fruit
苹果 apple
绿色或是红色的 a green or red fruit
其它 other fruits
  • 嗬嗬 wee!
  • 当然可以混合 mixing lists
    1. 数字式的 again!
    2. 带来 and again!

4. 表格 Tables

使用竖线来组成表格, 双线开始,表示将解析表格,并作为表头 使用空格对齐来标识每个表格项

表头 1 表头 2 表头 3
内文 1.1 内文 1.2 内文 1.3
内文 2.1 内文 2.2 内文 2.3

没有最后的竖线,则没有边框:

表头 1 表头 2 表头 3
内文 1.1 内文 1.2 内文 1.3
内文 2.1 内文 2.2 内文 2.3

5. 特殊实体 Special Entities

让事儿都简单哪!

5.1. 图片 Images

非常简单的图片引用方式: [filename].

  • 文件必须是 PNG, JPG, GIF 格式
  • 方框内不能有空格

5.2. 其它 Other

%%date 宏会输出当前日期

是标准的ISO YYYYMMDD 格式 20101009

当然可以声明特殊的输出方式 比如说: %%date(%m-%d-%Y) 会形成: 10-09-2010.

That's all ! 现在你知道的足够开始使用 t2t 组织文档了!.


Translated to Chinese by Zoom.Quiet(Zoom Quiet).



  • t2t渲染:: 2010-10-09 02:21:37
  • 动力源自::txt2tags

§ 写于: Fri, 01 Apr 2005 | 永久链接;源文: rdf ,rss ,raw | 分类: /utility/py4str/StructuredText §
[MailMe] [Print] Creative Commons License

作品Zoom.Quiet创作,采用知识共享署名-相同方式共享 2.5 中国大陆许可协议进行许可。 基于zoomquiet.org上的作品创作。