mkbok 0.0.10 → 0.0.11

data/templates/latex/makepdf

@@ -0,0 +1,195 @@
+#!/usr/bin/env ruby
+# -*- coding: utf-8 -*-
+# please use ruby1.8.*, there is problem for utf-8 in ruby 1.9 
+require 'fileutils'
+require 'erb'
+require 'yaml'
+
+include FileUtils
+
+$here = File.expand_path(File.dirname(__FILE__))
+$root = File.join($here, '..')
+$outDir = File.join($root, 'pdf')
+
+def figures(&block)
+	begin
+		Dir["#$root/figures/18333*.png"].each do |file|
+			cp(file, file.sub(/18333fig0(\d)0?(\d+)\-tn/, '\1.\2'))
+		end
+		block.call
+	ensure
+		Dir["#$root/figures/18333*.png"].each do |file|
+			rm(file.gsub(/18333fig0(\d)0?(\d+)\-tn/, '\1.\2'))
+		end
+	end
+end
+
+def usage
+	puts <<USAGE
+Usage:
+  makepdf [OPTION...] LANGUAGE [LANGUAGE 2...]
+
+Options:
+  -d, --debug      prints TeX and other output
+USAGE
+	exit
+end
+
+def command_exists?(command)
+	if File.executable?(command) then
+		return command
+	end
+	ENV['PATH'].split(File::PATH_SEPARATOR).map do |path|
+		cmd = "#{path}/#{command}"
+		File.executable?(cmd) || File.executable?("#{cmd}.exe") || File.executable?("#{cmd}.cmd")
+	end.inject{|a, b| a || b}
+end
+
+def replace(string, &block)
+	string.instance_eval do
+		alias :s :gsub!
+		instance_eval(&block)
+	end
+	string
+end
+
+def verbatim_sanitize(string)
+	string.gsub('\\', '{\textbackslash}').
+		gsub('~', '{\textasciitilde}').
+		gsub(/([\$\#\_\^\%])/, '\\\\' + '\1{}')
+end
+
+def pre_pandoc(string, config)
+	replace(string) do
+                s /\#\#\#\#\# (.*?) \#\#\#\#\#/, 'PARASECTION: \1'
+		# Pandoc discards #### subsubsections #### - this hack recovers them
+		s /\#\#\#\# (.*?) \#\#\#\#/, 'SUBSUBSECTION: \1'
+		
+		# Turns URLs into clickable links
+		s /\`(http:\/\/[A-Za-z0-9\/\%\&\=\-\_\\\.]+)\`/, '<\1>'
+		s /(\n\n)\t(http:\/\/[A-Za-z0-9\/\%\&\=\-\_\\\.]+)\n([^\t]|\t\n)/, '\1<\2>\1'
+
+		# Process figures
+		s /Insert\s18333fig\d+\.png\s*\n.*?\d{1,2}-\d{1,2}\. (.*)/, 'FIG: \1'
+	end
+end
+
+def post_pandoc(string, config)
+	replace(string) do
+		space = /\s/
+
+		# Reformat for the book documentclass as opposed to article
+		s '\section', '\chap'
+		s '\sub', '\\'
+		s /SUBSUBSECTION: (.*)/, '\subsubsection{\1}'
+                s /PARASECTION: (.*)/, '\paragraph{\1}'
+
+		# Enable proper cross-reference
+		s /#{config['fig'].gsub(space, '\s')}\s*(\d+)\-\-(\d+)/, '\imgref{\1.\2}'
+		s /#{config['tab'].gsub(space, '\s')}\s*(\d+)\-\-(\d+)/, '\tabref{\1.\2}'
+		s /#{config['prechap'].gsub(space, '\s')}\s*(\d+)(\s*)#{config['postchap'].gsub(space, '\s')}/, '\chapref{\1}\2'
+
+		# Miscellaneous fixes
+		s /FIG: (.*)/, '\img{\1}'
+		s '\begin{enumerate}[1.]', '\begin{enumerate}'
+		s /(\w)--(\w)/, '\1-\2'
+		s /``(.*?)''/, "#{config['dql']}\\1#{config['dqr']}"
+
+		# Typeset the maths in the book with TeX
+		s '\verb!p = (n(n-1)/2) * (1/2^160))!', '$p = \frac{n(n-1)}{2} \times \frac{1}{2^{160}}$)'
+		s '2\^{}80', '$2^{80}$'
+		s /\sx\s10\\\^\{\}(\d+)/, '\e{\1}'
+
+		# Convert inline-verbatims into \texttt (which is able to wrap)
+		s /\\verb(\W)(.*?)\1/ do
+			"{\\texttt{#{verbatim_sanitize($2)}}}"
+		end
+
+		# Ensure monospaced stuff is in a smaller font
+		s /(\\verb(\W).*?\2)/, '{\footnotesize\1}'
+		s /(\\begin\{verbatim\}.*?\\end\{verbatim\})/m, '{\footnotesize\1}'
+
+		# Shaded verbatim block
+		s /(\\begin\{verbatim\}.*?\\end\{verbatim\})/m, '\begin{shaded}\1\end{shaded}'
+		
+		# http://www.devdaily.com/blog/post/latex/control-line-spacing-in-itemize-enumerate-tags
+		# http://wiki.ctex.org/index.php/LaTeX/%E5%88%97%E8%A1%A8
+		# set the space of itemsize
+		s /(\\begin\{itemize\})/m,'\begin{itemize}\setlength{\itemsep}{1pt}\setlength{\parskip}{0pt}\setlength{\parsep}{0pt}'
+		s /(\\begin\{enumerate\})/m,'\begin{enumerate}\setlength{\itemsep}{1pt}\setlength{\parskip}{0pt}\setlength{\parsep}{0pt}'
+		# hardcode for itemize to use * instead of dot, which is missed in some chinese fonts
+		s /(^\\item)/m,'\item[*]'
+		
+	end
+end
+
+ARGV.delete_if{|arg| $DEBUG = true if arg == '-d' or arg == '--debug'}
+languages = ARGV.select{|arg| File.directory?("#$root/#{arg}")}
+usage if languages.empty?
+
+$config = YAML.load_file("#$here/config.yml")
+template = ERB.new(File.read("#$here/template.tex"))
+
+missing = ['pandoc', 'xelatex'].reject{|command| command_exists?(command)}
+unless missing.empty?
+	puts "Missing dependencies: #{missing.join(', ')}."
+	puts "Install these and try again."
+	exit
+end
+
+figures do
+	languages.each do |lang|
+		config = $config['default'].merge($config[lang]) rescue $config['default']
+
+		puts "#{lang}:"
+		markdown = Dir["#$root/#{lang}/*/*.markdown"].sort.map do |file|
+			File.read(file)
+		end.join("\n\n")
+
+		print "\tParsing markdown... "
+		latex = IO.popen('pandoc -p --no-wrap -f markdown -t latex', 'w+') do |pipe|
+			pipe.write(pre_pandoc(markdown, config))
+			pipe.close_write
+			post_pandoc(pipe.read, config)
+		end
+		puts "done"
+
+		print "\tCreating main.tex for #{lang}... "
+		dir = "#$here/#{lang}"
+		mkdir_p(dir)
+		File.open("#{dir}/main.tex", 'w') do |file|
+			file.write(template.result(binding))
+		end
+		puts "done"
+
+		abort = false
+
+		puts "\tRunning XeTeX:"
+		cd($root)
+		3.times do |i|
+			print "\t\tPass #{i + 1}... "
+			IO.popen("xelatex -output-directory=\"#{dir}\" \"#{dir}/main.tex\" 2>&1") do |pipe|
+				unless $DEBUG
+					if ~ /^!\s/
+						puts "failed with:\n\t\t\t#{$_.strip}"
+						puts "\tConsider running this again with --debug."
+						abort = true
+					end while pipe.gets and not abort
+				else
+					STDERR.print while pipe.gets rescue abort = true
+				end
+			end
+			break if abort
+			puts "done"
+		end
+
+		unless abort
+			print "\tMoving output to kaiyuanbook.#{lang}.pdf... "
+                        mv("#{dir}/main.pdf", "#$root/kaiyuanbook.#{lang}.pdf")
+			puts "done"
+        else
+            print "\tConvent error, exit !"
+            exit 1
+		end
+	end
+end

data/templates/latex/template.tex

@@ -0,0 +1,209 @@
+\documentclass[a4paper]{book}
+\usepackage{tocbibind} % for toc show inside pdf
+\usepackage[
+	%urlbordercolor = {1 1 1},
+	%linkbordercolor = {1 1 1},
+	%citebordercolor = {1 1 1},
+    bookmarksnumbered, % add bookmark number in pdf output
+	urlcolor = blue,
+	colorlinks = true,
+	citecolor = black,
+	linkcolor = black]{hyperref}
+\usepackage{graphicx}
+\usepackage{xltxtra}
+\usepackage{fancyhdr}
+\usepackage{booktabs}
+\usepackage{indentfirst}
+\usepackage{framed,color}
+\usepackage{footnpag}
+\usepackage{array}
+\usepackage[font=small,format=plain,labelfont=bf,up,textfont=it,up]{caption}
+
+\usepackage{titlesec} % texlive-latex-extra package
+\usepackage[titletoc]{appendix} % this is used for \appendices
+
+\definecolor{colorchapter}{RGB}{70,130,180}     % SteelBlue
+\definecolor{colorsection}{RGB}{95,158,160}    % CadetBlue
+\definecolor{colorsubsection}{RGB}{139,0,0} % DarkRed
+\definecolor{colorheader}{RGB}{70,130,180} % SteelBlue
+
+
+\titleformat{\section}
+{\color{colorsection}\normalfont\Large\bfseries}
+{\color{colorsection}\thesection}{1em}{}
+\titleformat{\subsection}
+{\color{colorsubsection}\normalfont\large\bfseries}
+{\color{colorsubsection}\thesubsection}{1em}{}
+
+\definecolor{shadecolor}{gray}{0.90}
+
+\setromanfont[Mapping=tex-text,BoldFont=<%= config['bold'] %>]{<%= config['font'] %>}
+\setmonofont{<%= config['mono'] %>}
+
+\XeTeXlinebreaklocale{<%= lang %>}
+<%= config['langrule'] %>
+
+\settowidth{\parindent}{<%= config['indent'] %>}
+\setcounter{footnote}{0}
+
+\title{{<%= config['title'] %>}}
+\author{Larry Cai}
+
+\makeatletter
+\let\savedauthor=\@author
+\let\savedtitle=\@title
+\def\imgwidth{.6\linewidth}
+\def\maxwidth{\ifdim\Gin@nat@width>\imgwidth\imgwidth
+\else\Gin@nat@width\fi}
+\makeatother
+
+\title{\huge{\savedtitle}}
+
+\author{\textbf{\savedauthor}\thanks{<%= config['thanks'] %>}}
+\def\w3cdtfymd{\the\year-\ifnum\month<10 0\fi\the\month-\ifnum\day<10 0\fi\the\day}
+\date{\w3cdtfymd}
+%\renewcommand{\thefootnote}{\fnsymbol{footnote}}
+
+\newcommand{\PreserveBackslash}[1]{\let\temp=\\#1\let\\=\temp}
+\let\PBS=\PreserveBackslash
+\makeatletter
+  \setlength\headheight{12\p@}
+  \setlength\headsep   {.25in}
+  \setlength\topskip   {10\p@}
+  \setlength\footskip{.35in}
+  \setlength\textwidth{400\p@}
+  
+  \setlength\@tempdima{\paperheight}
+  \addtolength\@tempdima{-2in}
+  \divide\@tempdima\baselineskip
+  \@tempcnta=\@tempdima
+  \setlength\textheight{\@tempcnta\baselineskip}
+  \addtolength\textheight{\topskip}
+  
+  \setlength\@tempdima        {\paperwidth}
+  \addtolength\@tempdima      {-\textwidth}
+  \setlength\oddsidemargin    {\paperwidth}
+  \addtolength\oddsidemargin  {-2.35in}
+  \addtolength\oddsidemargin  {-\textwidth}
+  \setlength\marginparwidth   {0pt}
+  \@settopoint\oddsidemargin
+  \@settopoint\marginparwidth
+  \setlength\evensidemargin  {\paperwidth}
+  \addtolength\evensidemargin{-2.35in}
+  \addtolength\evensidemargin{-\textwidth}
+  \@settopoint\evensidemargin
+  
+  \setlength\topmargin{\paperheight}
+  \addtolength\topmargin{-2in}
+  \addtolength\topmargin{-\headheight}
+  \addtolength\topmargin{-\headsep}
+  \addtolength\topmargin{-\textheight}
+  \addtolength\topmargin{-\footskip}     % this might be wrong!
+  \addtolength\topmargin{-.5\topmargin}
+  \@settopoint\topmargin
+  %\@addtoreset{footnote}{page}  
+\makeatother
+
+%\fancypagestyle{plain}{\fancyhf{}\fancyfoot[LE,RO]{\footnotesize\textbf\thepage}}
+\fancypagestyle{plain}{\fancyhf{}\fancyfoot{}} % make sure no page number in page of first chapter
+
+\pagestyle{plain}
+
+
+\renewcommand{\headrulewidth}{0pt}
+\renewcommand{\footrulewidth}{0pt}
+
+\newcounter{img}[chapter]
+\renewcommand{\theimg}{\thechapter.\arabic{img}}
+\newcommand{\img}[1]{\begin{figure}[h!]
+	\refstepcounter{img}
+	\label{img:\theimg}
+	\centering\includegraphics[width=\maxwidth]{figures/\theimg.png}
+	\caption{#1}
+\end{figure}}
+
+\newcounter{tab}[chapter]
+\renewcommand{\thetab}{\thechapter.\arabic{tab}}
+
+\newcommand{\prechap}{<%= config['prechap'] %>}
+\newcommand{\postchap}{<%= config['postchap'] %>}
+\newcommand{\presect}{<%= config['presect'] %>}
+\newcommand{\postsect}{<%= config['postsect'] %>}
+\renewcommand{\chaptermark}[1]{\markboth{\textbf{\prechap \thechapter \postchap}\hspace*{1ex}#1}{}}
+\renewcommand{\sectionmark}[1]{\markright{\textbf{\presect \thesection \postsect}\hspace*{1ex}#1}}
+\newcommand{\chap}[1]{\newpage\thispagestyle{empty}\chapter{#1}\label{chap:\thechapter}}
+\newcommand{\chapref}[1]{\hyperref[chap:#1]{\prechap #1\postchap}}
+\newcommand{\imgref}[1]{\hyperref[img:#1]{<%= config['fig'] %>#1}}
+\newcommand{\tabref}[1]{\hyperref[tab:#1]{<%= config['tab'] %>#1}}
+\newcommand{\e}[1]{$ \times 10^{#1}$}
+\renewcommand{\contentsname}{<%= config['con'] %>}
+\renewcommand{\figurename}{<%= config['fig'] %>}
+\renewcommand{\tablename}{<%= config['tab'] %>}
+\renewcommand{\appendixname}{<%= config['appendix'] %>}
+
+% chapter 
+\makeatletter
+\def\@makechapterhead#1{%
+  \vspace*{50\p@}%
+  {\parindent \z@ \raggedright \normalfont
+    \ifnum \c@secnumdepth >\m@ne
+      \if@mainmatter
+        \color{colorchapter}\normalfont\huge\bfseries\prechap{ }\thechapter{ }\postchap
+        \par\nobreak
+        \vskip 20\p@
+      \fi
+    \fi
+    \interlinepenalty\@M
+    \color{colorchapter}\normalfont\Huge\bfseries #1\par\nobreak
+    \vskip 40\p@
+  }}  
+ 
+% this is for non-normal chapter like Acknownledgement, Preface, Contents  
+\def\@makeschapterhead#1{%
+  \vspace*{50\p@}%
+  {\parindent \z@ \raggedright \normalfont
+    \ifnum \c@secnumdepth >\m@ne
+      \if@mainmatter
+        \color{colorchapter}\normalfont\huge\bfseries \thechapter{ }
+        \par\nobreak
+        \vskip 20\p@
+      \fi
+    \fi
+    \interlinepenalty\@M
+    \color{colorchapter}\normalfont\Huge\bfseries #1\par\nobreak
+    \vskip 40\p@
+  }}  
+\makeatother
+
+\linespread{1.3}
+
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+\setcounter{tocdepth}{4}
+
+\frontmatter
+<%= preface %>
+\tableofcontents\newpage\thispagestyle{empty}
+
+% customize header & footer
+
+\fancyhf{}
+\fancyhead[LE]{\color{colorheader}\quad\small\textbf\thepage\quad\quad\small\leftmark}
+\fancyhead[RO]{\color{colorheader}\small\rightmark\quad\quad\small\textbf\thepage\quad}
+%\fancyhead[RE,LO]{\color{colorheader}\small{\savedtitle}} % book title 
+%\fancyfoot[LE,RO]{\small\textbf\thepage} % page number
+%\fancyfoot[C]{\small\textbf{hello}} % could add release information
+
+%\renewcommand{\headrulewidth}{0.4pt}  % add one line
+%\renewcommand{\headrule}{\color{red}} % conflict with headrulewidth
+\pagestyle{fancy}
+
+\mainmatter
+<%= latex %>
+
+\appendices
+\renewcommand{\prechap}{\appendixname}
+\renewcommand{\postchap}{}
+<%= appendix %>
+\end{document}

data/templates/summary.rb

@@ -0,0 +1,29 @@
+#! /usr/bin/env ruby
+#
+
+command = ARGV[0]
+exclude = ['figures', 'figures-dia', 'figures-source', 'couchapp', 'latex', 'pdf', 'epub', 'en', 'ebooks']
+
+data = []
+original_lines=`grep -r -h '^[^[:space:]#]' en/[0]* | grep -v '^Insert'| wc -l`.to_i
+Dir.glob("*").each do |dir|
+  if !File.file?(dir) && !exclude.include?(dir)
+    lines = `git diff-tree -r -p --diff-filter=M master:en master:#{dir} | grep '^-[^[:space:]#-]' | grep -v '^-Insert' | wc -l`.strip.to_i
+    last_commit = `git log -1 --no-merges --format="%ar" #{dir}`.chomp
+    authors = ""
+    if command == 'authors'
+      authors = `git shortlog --no-merges -s -n #{dir}`.chomp
+    end
+    data << [dir, lines, authors, last_commit]
+  end
+end
+
+d = data.sort { |a, b| b[1] <=> a[1] }
+d.each do |dir, lines, authors, last|
+  puts "#{dir.ljust(10)} - #{(lines*100)/original_lines}% (#{last})"
+  if command == 'authors'
+    puts "Authors: #{authors.split("\n").size}"
+    puts authors 
+    puts
+  end
+end

data/templates/zh/chapters/01-chapter2.markdown

@@ -0,0 +1,89 @@
+# 基础知识和10分钟写出第一本开源书 #
+## 先从Pro Git说起 ##
+
+如果你了解Git，或者想了解Git。那么你就应该知道[Pro Git](http://progit.org/)，它是Git的书中写得最好的一本（至少是之一），可是你是否知道它有网络中文版，而且能在iPad上极其漂亮得阅读。并且是免费的，不是盗版的免费！如果你想要最新的，你甚至可以自己生成它。哈哈，我就是这么干的。
+
+这一切就归功于开源社区和它后面用到的技术。
+
+###开源书###
+这里我不用多讲，开源书就像其他的开源产品（如维基百科）一样，只要是开放的，社区就有人会贡献。[Pro Git](http://progit.org/)的作者Scott很慷慨得把书的内容全部共享在[github/progit](http://github.com/progit/progit)库中，使用得是[CC BY-NC-SA 3.0](http://creativecommons.org/licenses/by-nc-sa/3.0/us/)。
+
+Scott只负责英文版，其他许许多多语言的翻译都是社区贡献的，中文翻译相当有质量，你可以在线读[Pro Git中文版](http://progit.org/book/zh/)。
+
+### 开源技术生成电子书 ###
+这本书不仅仅开源了内容，使用的技术也是开源的。让我们看看他是怎么做的。
+
+### Markdown原始文件 ###
+首先书的内容是用Markdown格式写的。Markdown格式的普及要归功于[Github](github.com)和[StackOverflow](http://stackoverflow.com/)。因为它们越来越流行，它们支持Markdown格式也越来越流行。这里要赞一个的是，国内的[图灵社区](http://www.ituring.com.cn/)也支持Markdown，用起来超级方便。
+
+简单来说，Markdown格式的文件看着像一般的文本文件，里面只是加了很少的格式标记，因此看文本文件也不影响理解，这种格式也有很多工具帮你去转化，而且很容易自动化解决。并且这些技术大多数是开源或免费的。
+
+松本行弘在他的Ruby书中说的好，想象一下几十年后，你是否还能找到软件来打开你的Word老格式的文档，没有那些软件，你的文档也就没用了。文本文件就没有这个问题。
+
+你可以直接看一下【Pro Git】的[“第一章 介绍” 的Markdown原始文件](https://raw.github.com/progit/progit/master/zh/01-introduction/01-chapter1.markdown)，顺便看看github自动生成的简单[“第一章 介绍” 的html](https://github.com/progit/progit/blob/master/zh/01-introduction/01-chapter1.markdown)。
+
+## 产生电子书 ##
+### PDF格式 ###
+为了能达到出版的质量，Latex是一个常用的格式，PDF也能很容易地转换出来，有关Latex，自己看看参考链接学习吧。
+
+[Pandoc](http://johnmacfarlane.net/pandoc/)能帮着从Markdown转换出Latex格式，然后再用[TexLive](http://www.tug.org/texlive/)软件中的`xelatex`转成PDF格式。
+
+### Epub/Mobi格式 ###
+Ruby的[rdiscount](https://github.com/rtomayko/rdiscount)能帮你从markdown转成html格式，然后有[Calibre](calibre)附带的命令`ebook-convert`生成最终的`.mobi` (Kindle) 和 `.epub` (iPad)。
+
+从1.8版本开始，Pandoc也开始支持生成Epub格式了。
+
+## 工作环境 ##
+你只需要一台Linux机器（虚拟机就可以了）和熟悉简单的Linux命令就可以试验了。有Git和Ruby的知识那就更方便了。
+
+我用的试验环境是Ubuntu Oneiric (11.10）
+
+### 下载中文开源书 ###
+很简单，`git clone`一下这本书就可以了，下载它的源文件包我觉得还是烦了点。
+    
+	$ git clone git@github.com/larrycai/kaiyuanbook.git
+    
+### PDF格式 ###
+生成PDF是一个比较复杂的东西，[pandoc](http://johnmacfarlane.net/pandoc/)用Ubuntu库里1.8.x版本，[TexLive](http://www.tug.org/texlive/)用缺省Ubuntu源里的2009版也够了。当然也可下载最新的[TexLive](http://www.tug.org/texlive/)包安装，并配置到搜索路径中。
+    
+~~~~~~~~~~ {.bash}
+$ sudo apt-get install ruby1.9.1
+$ sudo apt-get install pandoc
+$ sudo apt-get install texlive-xetex
+$ sudo apt-get install texlive-latex-recommended # 主要的Latex包
+$ sudo apt-get install texlive-latex-extra # titlesec包，先不用知道
+~~~~~~~~~~~~~~~~~~~~
+
+因为是中文PDF，需要把字体嵌入在文件中，因此需要安装字体文件，幸运的是在源里有不错的字体。
+
+~~~~~~~~~~ {.bash}
+$ sudo apt-get install ttf-arphic-gbsn00lp ttf-arphic-ukai # 文鼎字体
+$ sudo apt-get install ttf-wqy-microhei ttf-wqy-zenhei # 文泉驿字体
+~~~~~~~~~~ 
+    
+现在你就可以用`mkbok`命令生成Pdf文件了，`mkbok`会自动调用Pandoc和Latex工具生成Pdf、Html、Epub格式。
+
+    $ ./mkbok	
+    
+怎么样，打开看看Pdf文件，很漂亮了吧。
+
+## 自己试试 ##
+一定要做，搜索一下，改掉一些内容，再运行一遍。
+
+好了，你可以把书扔到一遍，写你自己的书了。照样画葫芦，你行的。在下一章会对书的结构和怎么对应地用Markdown写进行详细地解释。
+	
+## 其他常用的格式 ##
+
+计算机类图书对格式要求不是很多，图文、章节、源代码基本就够了，就算有些复杂公式，也可用图来显示。这也从理论上说明，它不需要复杂的格式。现在对这类技术书出版我的理解主要有几种：
+
+ 1. Microsoft的Word格式，虽然国内出版界如日中天，缺省就认它（对技术没追求，鄙视）。简单好学，但是不擅长自动化，是开源的死敌。
+ 2. Latex格式（就是Donald E. Knuth（高德纳）发明的，这是很棒的东西，特别适合学术类的各种复杂的公式等，不过学习曲线很高，直接写还是很有难度的。国内也只有几家学术期刊使用。
+ 3. Docbook格式是最有名的（从SGML演化过来？），Orielly和Pragmatic出版社缺省就用它，它能    很方便的转化出出版要的各种样式。如[Jenkins - the definition guide](http://www.wakaleo.com/books/jenkins-the-definitive-guide)开源书就是采用Docbook。但由于是XML格式，很多人不习惯，而且多人网上协作不是很方便。
+ 4. 通过蒋鑫的[Got Github](http://www.worldhello.net/gotgithub/)开源书，我也了解reStructureText也是和Markdown差不多纯文本的，也是蛮流行的。
+ 
+## 参考 ##
+ 1. Pro Git: <http://progit.org/>
+ 2. LaTeX2e完全学习手册: <http://book.douban.com/subject/5450816/>
+
+
+ 

data/templates/zh/chapters/01-chapter3.markdown

@@ -0,0 +1,105 @@
+# 用Markdown来写 #
+希望你已经照着上一章生成出了第一个Pdf文件，看到了一本蛮标准的书的样子。
+
+这一章详细点介绍这是如何用Markdown写出来的。
+
+首先简单介绍一下一本书的组成
+
+## 标准书稿的组成 ##
+
+一部完整的书稿，通常按顺序由封面、扉页、版权页（含内容简介）、序、前言、目录、正文（含图稿）、附录（可选项）、参考文献（可选项）、符号表（可选项）、索引（可选项）等组成。
+
+详细请看电子出版社的《作译者手册》<http://www.phei.com.cn/wstg/zyzxz>
+
+封面、扉页、版权页（含内容简介）封底一般有设计师用图形软件做出来单独印刷的。
+
+序、前言、目录、正文（含图稿）、附录（可选项）都是标准提交格式写的。
+
+参考文献（可选项）、符号表（可选项）、索引（可选项）一般应该是自动生成的。
+
+## 怎么从Markdown到书 ##
+前一章提到过，技术书籍对排版要求不高，不同级别的章节，代码显示和一些图示就可以了。因此有机会用文本的方式一一对应过去。
+
+最[基本的Markdown](http://daringfireball.net/projects/markdown/)可以完成上面的功能了。
+
+在Latex中设置好书的模板（`latex/template.tex`），如页眉、页脚、目录、颜色等等，一般有经验的人可以帮你搞定。
+
+Pandoc软件会把Markdown文件转换成Latex格式，然后套上上面的模板。
+
+`mkbok`是一个小工具，做了一些额外的定义和调整。
+
+### Markdown扩展 ###
+
+基本的Markdown功能不是很全（如没有脚注），因此可以考虑用一些Markdown的扩展。
+
+由于会用Pandoc转换，我建议推荐用Pandoc的Markdown扩展<http://johnmacfarlane.net/pandoc/README.html>
+
+你有兴趣也可以看看Github的<http://github.github.com/github-flavored-markdown/>
+
+## 如何使用Markdown写书 ##
+现在可以看看结构了。
+
+~~~~~~~~~ {.bash}
+$ find zh
+zh/preface # 序和前言
+zh/chapters # 正文
+zh/appendix # 附录
+~~~~~~~~~~~~
+
+### 标准章节 ###
+每一章的第一行基本就是章节名字，应该只出现一次
+
+~~~~~~~
+# 用Markdown来写 #
+~~~~~~~
+
+其他的小章节用`##`和`###`表示，最好不要有更多的层次。
+
+### 序、前言、附录 ###
+这和其他章节是一样的，只是在PDF的目录显示中章节号和计数不同。
+
+### 页眉、页脚 ###
+这是有Latex设定的，不需要Markdown参与。
+
+### 目录 ###
+这是有Latex自动生成的，不需要Markdown参与。
+
+### 图片 ###
+把图片放在`figures`目录中。
+
+### 脚注 ###
+这是Pandoc扩展Markdown才能支持
+
+### 代码 ###
+基本的Markdown用空四格的方式，不支持代码高亮显示。
+
+我建议使用Pandoc扩展Markdown，它在生成的Epub和Html中支持代码高亮显示（还没搞定）
+
+## 中文字体 ##
+首先，我用的是Linux环境并且选用的是**UTF-8**的编码，而不是GBK，否则在github上显示会有问题，不了解这方面的朋友自己找找资料吧，够讲个把小时的。
+
+在产生PDF时，一般建议内嵌中文字体的，但是真正能用的中文字体实际很少，极大多数是有版权的：
+
+ * [文鼎](http://www.arphic.com.tw/)开放的四套字体（简报宋、细上海宋、简中楷、中楷），没有一点版权问题，是大部分的中文Linux的缺省安装。
+ * [文泉驿](http://wenq.org/)的几套字体（微米黑、正黑、点阵宋体）是开放但是GPL性质的，所以不是随便可以商用的。
+ * Adobe有两套开放字体（宋体、黑体）我认为是可以随便用的，忘了在哪里看到这个解释的了。
+
+可以看看[Ubuntu免费中文字体](http://wiki.ubuntu.org.cn/免费中文字体)的介绍有个认识。
+
+## 怎么选择对应字体 ##
+一般缺省中文正文字体是宋体、细明体，对应英文Serif类的英文字体：Georgia、Times New Roman等。
+
+标题和重要内容可以选楷体和黑体，对应英文Sans Serif类的英文字体：Arial、Tahoma、Verdana等
+
+技术文章中常见的代码典型的等宽体用黑体，对应英文Monospace类的英文字体：Courier New等
+
+所以对应的在[我的中文Latex配置](https://github.com/larrycai/sdcamp/blob/master/latex/config.yml)中可选的是：
+
+ * font：文鼎的简报宋、细上海宋，文泉驿的点阵宋体，Adobe的宋体
+ * bold: 文鼎的简中楷、中楷，文泉驿的微米黑、正黑，Adobe的黑体
+ * mono: 文泉驿的微米黑、正黑，Adobe的黑体
+
+ 
+ 
+
+