再记轻量标记驱动的文档工具与系统

经过一段时间的学习与查阅资料,发现 unix下面实现的各种 轻量标记 文档系统很多,而且格式花样, 在sytax上 有

可选的轻量文档标记系统有:

Markdown(extra) ,reStructuredText, txt2tags, textile, Asciidoc, 等等,发现在sytax风格上有相似,但是又不同,经典 Markdown 是不支持表格的,txt2tags 也不怎么完善(虽然我针对html和tex做了hack),reStructuredText 和  textile 的 ruby实现版本比较完备但又简单, Asciidoc是最复杂的也是最齐全的,基本上元素丰富程度接近与 Docbook 和 TeX 系统了,Asciidoc感觉是 Docbook的轻量标记版。

以这些sytax为驱动的文档系统可以选择的有:

txt2tags: 输出各种格式,简单,缺点是txt2tags的syntax功能上还是稍显欠缺。

pandoc: 以markdown为主syntax,但是由于支持几乎全部syntax的各种格式的输入,所以, reStructuredText 等各种都被比较好的支持 …

more ...

txt2tags 与 xelatex输出pdf

txt2tags由于输出target比较多,支持pdf,html,docbook,redmine wiki,所以基本被我“相中”。

公司要求写个需求文档,就试着写了下,用自己的写的格式输出tex,再转换xelatex-ctex格式,就发现生成pdf没有问题了,编译完全通过,只不过为了pdf有更好的脸面: 支持标签目录,目录颜色,页眉页脚样式修正就做了个脚本对txt2tags输出的格式做了简单调整,现在一个make,html,pdf就ready了,哈哈!

下面是我的tex输出心得:

1.tex系统有N多实现,在windows上ctex不能配置就能工作,在linux上面要安装texlive-cjk相关,安装recommded,extra等包。

gentoo系统有ebuild,相对简单,ubuntu貌似我现在用的11.10还没包上线(ubuntu NB,但不专业了).

  1. 我用xelatex,tex文档开头得改成:
documentclass[UTF8,adobefonts,a4paper]{ctexart}

%ctexart就是ctex article了,开始恼了半天。

3. adobefonts得有,网上下载的放进/usr …

more ...

各种用来写wiki和文档的light-weight markup 工具

wordpress,redmine,wikipedia 等都支持使用一些标记语言来写wiki页面,其实这些东西都是一种 "Lightweight_markup_language " ,搜索了下发现跟redmine使用的textile类似的东西包括: markdown, markdown2(extra), txt2tags, AsciiDoc, texy! ,BBcode,Mediawiki等等,都有一个特点 :*就是使用纯文本标记来标记文档的格式标题等*

经过比较发现:

#. .. raw:: html
***AsciiDoc**    最复杂,可以用来写 文章,书本,与docbook转换比较好,功能上最解决与     docbook,有 git         manual,Programming iOS 4 这样的作品都是用它写的,查看其手册的确也很好很强大的感觉。* .. raw:: html
#. **txt2tags**          输出格式多,未来可以支持 redmine wiki, wordpress, #. **markdown** 用的最多,存在各种实现,c,python,perl等各种语言的版本 … more ...