¶ 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 (duh@somewhere.com) 和 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上的作品创作。

¶ xhtml.py

2005-04-01 23:23

# -*- coding: utf-8 -*-
"""XHTML - html Parser
    - 仅仅适用于 t2t 输出的xhtml

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell copies of the
Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Copyleft 2005, 2006 Zoom.Quiet

"""


## Leo: tab_width=-4 page_width=80
PREFORMATTER_ID = 'xhtml'
FILE_EXT = 'xhtml'
__version__ = "v10.4.14"
__author__ = 'Zoom.Quiet '
#__url__ = "http://blog.zoomquiet.org/pyblosxom/OpenSource/PyBlosxom/plugins/xhtml.phtm"
__url__ = "http://blog.zoomquiet.org/pyblosxom/techic/PyBlosxom/plugins/xhtml.html"

__description__ = "txt2tags export xhmtl entry - Pyblosxom Parser."

from Pyblosxom import tools

def cb_entryparser(args):
    args['xhtml'] = parse
    return args
def parse(filename, request):
    import os, sys
    config = request.getConfiguration()
    ## 简单处理,基于 t2t 2.4.3
    source = open(filename,"r").readlines()
    body = "".join(source[11:-1])
    #print source[6]
    title = source[6][7:-9]
    #print source[14]
    #tags = source[14][4:-6]
    #print tags
    '''
    title = ""
    for line in open(filename,"r").readlines():
        if "" in line:
            title=line[7:].replace("","")
            break
    if "" == title:
        title = filename.replace(config['datadir'], '')
    '''
    entryData = {'body' : body
                 ,'title' : title
                 #,'tags' : tags
                 #filename.replace(config['datadir'], '')
                 }

    return entryData


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

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