- 浏览: 63329 次
最新评论
文章列表
一个 AsciiDoc 转换后的网页(UTF-8 编码)直接在电脑上打开正常,但是放到某 web server(Apache) 上却显示乱码,手工选择为 utf-8 编码才显示正常。想可能是 http 包头的问题,抓包一看果然是 gb2312 。
找到 httpd.conf 文件,果然配置 apache 的时候通过 AddDefaultCharset 指令设置 apache 的默认字符集为 gb2312。这时候浏览器请求到的网页 http 包头中就会使用该值来指定字符集,而浏览器会根据该值决定网页的字符集——这时候网页的 html 中通过 meta 指定字符集会被忽略。在 ie6, ie7, ...
- 2008-01-23 04:22
- 浏览 1746
- 评论(0)
前言
http 协议概要
尽可能减少 http 请求
前言
一想到优化网站,大多数情况下我们都是优化动态的后台程序,比如程序执行效率,查询数据库效率等。一些大规模的站点,比如 www.yahoo.com 等,页面的载入已经是超越了动态程序生成页面的消耗。虽然书中说 10-20% 的时间损耗在服务器端程序生成 html ,其他的损耗在浏览器和服务器的交互以及页面渲染。但是我看来,很多时候还是需要根据网站的规模和表现来评估实际损耗,给出这样的数据并不一定适应所有,甚至是大部分网站。当然,基本上是网站规模(主要是说页面内容量)越大,后台生成 html 的损耗越小——实际上大型站点的很多 ...
- 2008-01-17 00:31
- 浏览 579
- 评论(0)
页面元素载入时间图. 官方文档中的全称为 Real-Time Page Level Time Charts 。可以显示网页各个组件的载入速度以及先后顺序和消耗时间等详细情况。从帮助文档中翻过来的说明:
灰色 blocked
灰色表示阻塞的时间。主要是一些预处理(比如浏览器检索 cache)以及网络连接等待时间。因为 IE 对同一主机同时只能够并发两个连接(这也是 rfc 文档建议的), 当需要多个连接来处理时页面元素时, 某些处理就会被阻塞. 这种情况在请求图片的时候会表现得比较明显.(实际上我还没有确认最多并发两个连接的限制, 据说 firefox 是 8 个并发连接)
粉红 DNS ...
- 2008-01-16 00:39
- 浏览 953
- 评论(0)
之前在找 DocBook 资料的时候,曾经接触一个翻译英文技术文档的虚拟团队使用 Git 管理源代码。简单看过一下,今天又无意之中看到有人提及它。
Git 是 Linus Torvalds 实现的源代码管理软件。“Git 是一个快速、可扩展的分布式版本控制系统,它具有极为丰富的命令集,对内部系统提供了高级操作和完全访问。”
Torvalds 开始着手开发 Git 是为了作为一种过渡方案来替代 BitKeeper,后者之前一直是 Linux 内核开发人员在全球使用的主要源代码工具。开放源码社区中的有些人觉得 BitKeeper 的许可证并不适合开放源码社区的工作,因此 Torvalds 决定着 ...
- 2008-01-06 10:56
- 浏览 1334
- 评论(0)
形象点说,outline-mode 带给 Emacs 类似代码折叠功能,再简单的说,outline-mode 能够根据一定的规则”生成”并”收缩/打开”目录。有了这玩意,写起文本文档来就能够大大提高效率了。下面是某个文档的 outline-mode 效果图:
“生成目录”
“打开目录”
更详细的情况参见 http://www.hickwu.com/doc/emacs-outline.htm
尝试最近的战果,转换了一个PDF 版
- 2007-09-08 08:56
- 浏览 1352
- 评论(0)
5. 文档结构5.1. 块元素
AsciiDoc 由一些块元素组成。下面是块元素的关系描述(类似 XML 的 DTD):
Document ::= (Header?,Preamble?,Section*)
Header ::= (Title,(AuthorLine,RevisionLine?)?)
AuthorLine ::= (FirstName,(MiddleName?,LastName)?,EmailAddress?)
RevisionLine ::= (Revision?,Date)
Preamble ::= (SectionBody)
Sect ...
- 2007-08-18 14:04
- 浏览 1006
- 评论(0)
DocBook 主要维护人 Norman Walsh 写了一个用来写 DocBook 的 emacs mode: DocBook IDE ,以前写 DocBook 就用这个,可以实现自动提示 DocBook 元素等。刚上他个人网站又看了一下,提到这个插件不再维护,他已经用 nxml-mode 了。
官方网站 http://www.thaiopensource.com/nxml-mode/
下载 http://www.thaiopensource.com/download/
nxml-mode 比一般的 emacs mode 来得肥胖。安装方法:把相关文件下载放到某目录比如 home(~) 目 ...
- 2007-08-16 05:47
- 浏览 1261
- 评论(0)
哈哈,一大早开水木,赫然发现十大有一条“CCTV正式把李宇春列为男歌手”,八卦的 Hick 打开一看,竟然真有一链接: http://club.2008.cctv.com/public/poll/page_3/ , 调查中有:
认为今年奥运会主题歌的男演唱者是谁?
刘欢
张学友
李宇春
刘德华
哈哈,人说“cctv 总算正常了一把”!八卦 Hick 截图为证:
- 2007-08-14 23:56
- 浏览 842
- 评论(0)
4. AsciiDoc Backends
通过 -b 或 –backend 参数,可以用 asciidoc 命令把 AsciiDoc 转换成各种支持的格式。不用去关心他们之间的差异,相关的转换规则都可以在相关的配置文件中定义。
AsciiDoc 支持转换成 DocBook, XHTML1.1, HTML4 以及 LinuxDoc 和 LaTex 格式。
4.1. docbook
如前面所说, AsciiDoc 中的 Book, article, manpage 对应 DocBook 中的 book, article 和 refentry 。DocBook 支持转换成的文档格式相当丰富(有 Pos ...
- 2007-08-14 23:47
- 浏览 1370
- 评论(0)
:) AsciiDoc 的文档看起来还是比较舒服的。
1. AsciiDoc 概要
这种文件格式最大的优点就是简洁!语法和使用以及手册都是如此,常用的转换工具只有一个 asciidoc.py 文件。通过配置文件,可以定制 asciidoc 的语法以及输出文件的大部分信息。
2. 开始 AsciiDoc 之旅
安装 AsciiDoc 相当简单,在安装好 python 2.4 以上版本以后,解压缩文件即可通过运行 asciidoc.py 来进行基本的转换。而 a2x 则没有实现 windows 下的移植。
在安装包中的 doc 目录,有很多可以参考的实例。
3. AsciiDoc 的文档类型
Asc ...
- 2007-08-14 01:05
- 浏览 1897
- 评论(0)
当然,有时候得懒得跟 Google Fans 争个谁猴谁狗的,我就经常到 BaiDu 去 Google,你们爱怎么着怎么着,干我 p 事,嘿嘿。
Google Fans 们一直指责 BaiDu 把“广告”放到搜索结果里,说 Google 如何如何。其实呢,心放宽点,就可以理解,这不,Google 也“心放宽”了一回:
本来俺是搜索 DocBook 的时候发现广告的,结果过一会再搜,狡猾的 Google 同学又把广告弄没了,还好 Hick 英明,掐脚指头一算,又把广告给拽回来了。
- 2007-08-14 00:38
- 浏览 867
- 评论(0)
最近有点时间整理以前的一些文档,翻出这个 AsciiDoc学习笔记 来,还是觉得非常有用的。
1. 2006-06-25 23:02:01|开始接触AsciiDoc
老早以前就下了 AsciiDoc 的包,一直放在那里没有研究,最近又看了一下,觉
得真的是解决了 DocBook 和 reST 两个的问题,融合了他们的优点。刚在
python-cn 的 google group 发了个帖,看看有没有熟悉的人可以评论一下
AsciiDoc 的优劣。
官方的介绍:AsciiDoc 是一种用来写短文档、文章、书籍以及 Unix 帮助页面等
等的文档格式。它能够被转换成 HTML 以及 DocBook ...
- 2007-08-12 16:13
- 浏览 1790
- 评论(0)
Emacs 两三年了,还在初级阶段,老只能够学些这个那个小伎俩。咱不懂 elisp ,也没天分花太多时间折腾,本来想着借 erlang 的风把 elisp 也学一下,感受一下函数式编程,结果那啥那啥夭折了… 木办法,咱大忙人哪!
嘿嘿,今天又学到一招,设置字体。 Courier New 字体看久了有些审美批量,也确实是 0o、 l1、 {( 难分。正好前几天找了觉得还不错的字体: Envy Code R 。具体设置方法如下:
- S-down mouse 1 调出字体设置,选择 Envy Code R 字体,这里设置了以后无法保存。
- M-: (frame-parameter nil ‘f ...
- 2007-08-12 14:07
- 浏览 1007
- 评论(0)
用到 XSLT processor 的机会可能并不多,我是因为 DocBook 才知道这个工具,
具体来说就是 xsltproc 命令。通过它,结合 docbook-xsl 可以把 DocBook 转换
成 html/chm/fo(pdf) 等多种格式。
从 http://www.zlatkovic.com/libxml.en.html 找到相关下载地址,需要安装的
包括:libxml2(用于进行xml语法合法性检验和资料整理), libxslt(负责格式
转换), zlib(资料压缩处理),和 iconv(语言转换) 。我下载的包如下:
zlib-1.2.3.win32.zip(bin 中 2 ...
- 2007-08-11 15:49
- 浏览 1486
- 评论(0)
关于 DocBook 有两本权威的书籍。一本是官方的《DocBook: The Definitive Guide》,可以在 http://www.docbook.org 下载到 chm 版等,由 DocBook 的主创人员所写,适宜作为编写 DocBook 时的标签使用参考;另外一本就是《DocBook XSL: The Complete Guide》,作者 Bob Stayton ,可以免费在线查看 html 版,地址 http://www.sagehill.net/docbookxsl/ 。
一年多前就开始看《DocBook XSL: The Complete Guide》了,后来陆陆续续瞅 ...
- 2007-08-05 15:04
- 浏览 2009
- 评论(0)