deplate(Viki) 全面定制

最近拿 deplate 重新制作了个人主页（www.chenshuo.com），其间对 deplate 0.7.3 做了不少改动，记录在这里，备查。头一次用 ruby，可能方法比较笨拙，见笑。

1. 禁用符号替换。根据 deplate 手册第 9.10 节，它会自动把 ->、<=、!= 等等符号替换为单个字符，而这些符号在程序代码中经常出现，不能替换。这个工作由 fmt/hrml.rb 的 format_symbol(invoker, text) 函数负责，修改办法是：

class Deplate::Formatter::HTML < Deplate::Formatter
def format_symbol(invoker, text)
case text
# 已拿掉这里一截代码
when "+++", "###", "???", "!!!"
m = plain_text(text)
return %{<span class="marker"><em class="marker">#{m}</em></span>}
# when "<~"
# return ""
# when "~>"
# return ""
# when "<~>"
# return ""
else
return plain_text(text)
end
end
...

2. 禁用引号替换，在默认情况下，deplate 会把 "string" 替换为 “string”，这是我不想要的，修改办法是：

class Deplate::Formatter::HTML < Deplate::Formatter
def doublequote_open(invoker)
'"'
end

def doublequote_close(invoker)
'"'
end

def singlequote_open(invoker)
"'"
end

def singlequote_close(invoker)
"'"
end
...

3. 允许给标题设置超链接。修改办法是：

class Deplate::Formatter::HTML < Deplate::Formatter
def format_heading(invoker)
l = format_label(invoker, nil, nil, false)
level = invoker.level
args = invoker.args
elt = invoker.elt
html_args = invoker.html_args || ''
id = invoker.get_id
if consume_label(id)
html_args += %{ id="#{id}"}
end
if level > 0 and level <= 6
hd = "h#{level}"
if invoker.plain_caption?
ls = ""
else
ls = invoker.level_as_string + "&nbsp;"
end
url = invoker.args["url"]
if url
%{\n<#{hd}#{html_args}>#{l}#{ls}<a href="#{url}">#{elt}</a></#{hd}>\n}
else
%{\n<#{hd}#{html_args}>#{l}#{ls}#{elt}</#{hd}>\n}
end
else
l += format_label(invoker, :string, [id]) if id
"\n#{l}#{elt}"
end
end

使用办法：

** 《C# Primer 中文版》
#OPT: caption="C# Primer" id=csprimer url=http://jjhou.csdn.net/jjtbooks-csprimer.htm

4. 左侧 SideBar 中区分章与节，用不同的 class，在css中修改格式。修改办法：

class Deplate::Core
def tabbar_auto_entries(tabbar, idx, style, depth, inactivedepth, tags, tabsize)
if @variables["tabBarHomeName"]
s = idx == 0 ? "#{style}Active" : "#{style}Inactive"
title = @variables["tabBarHomeName"]
file = @formatter.navbar_guess_file_name(0, idx, :navbar)
tabbar << tabbar_entry(%{<a class="tabBarEntry" href="#{file}">#{title}</a>}, tags, s, tabsize)
end

each_heading(depth) do |hd, title|
lstr = hd.level_as_string
lnr = hd.top_heading_idx
file = hd.output_file_name(:basename => true)
if hd.level > 1
anchor = hd.args[:id] || hd.label.first
if anchor
file = [file, "#", anchor].join
end
end

if top_heading_by_idx(idx) == hd.top_heading
s = "#{style}" # Active
else
s = "#{style}" # Inactive
if hd.level > inactivedepth
next
end
end

if hd.level == 1
tabbar << tabbar_entry(%{<a href="#{file}">#{title}</a>}, tags, s, tabsize)
else
s = [s, "Sec"].join
tabbar << tabbar_entry(%{<a href="#{file}">#{title}</a>}, tags, s, tabsize)
end
end
end
...

5. 允许按节(section)分割文件。修改办法：

class Deplate::Core
# Set the current top heading.
# heading:: Heading object
# text:: The output filename base
def set_top_heading(heading, text)
if heading.level == 1|| heading.level == 2
fname = nil
下同

class Deplate::Element::Heading < Deplate::Element
def is_top_heading?
@level == 1 || @level == 2
end
...

6. 自动根据输入文件名设置输出文件名。修改办法：

class Deplate::Element::Heading < Deplate::Element
def register_heading
sc = @args['id'] || @args['shortcaption'] || File.basename(@deplate.current_source, ".*")
log(['Register heading', level_as_string, sc], :debug)
@deplate.set_top_heading(self, sc)
end
end

例如输入文件是 articles.txt，输出文件自动为 articles.html，要求每个章为一个文件：以下是 articles.txt 示例

* 文章

- 部分文章为 PDF 格式，需要 Acrobat Reader，这些文章通常更正式一些。
[[http://www.adobe.com/products/acrobat/readstep2.html][{img w=88 h=31:get_adobe_reader.png}]*]

*** 2006 年

** zlib 在 Visual Studio 2005 下编译失败的解决办法
#OPT: noList! url=zlib_vs2005.html

** 向 Word 和 PowerPoint 插入 LaTeX 公式的小工具
#OPT: id=eqLaTeX url=http://blog.csdn.net/Solstice/archive/2006/01/28/589643.aspx
- 通过拖拽方式向 Word 和 PowerPoint 插入 LaTeX 公式图片。（2006 年 1 月）