RubyGems - mkblog - Versions diffs - 0.0.1 - Mend

mkblog 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

data/LICENSE +13 -0
data/README.rdoc +38 -0
data/bin/mkblog +90 -0
data/lib/mkblog_version.rb +3 -0
data/templates/README.markdown +24 -0
data/templates/Rakefile +46 -0
data/templates/_config.yml +2 -0
data/templates/_layouts/master.html +50 -0
data/templates/_layouts/post.html +39 -0
data/templates/_posts/2012-03-06-travis-ci-is-evolution.mkd +111 -0
data/templates/_site/README.markdown +24 -0
data/templates/_site/Rakefile +46 -0
data/templates/_site/about.html +55 -0
data/templates/_site/atom.xml +936 -0
data/templates/_site/blog.html +581 -0
data/templates/_site/drafts/outsource-your-blog.html +96 -0
data/templates/_site/favicon.ico +0 -0
data/templates/_site/images/about.gif +0 -0
data/templates/_site/images/alm-overview.jpg +0 -0
data/templates/_site/images/blog.gif +0 -0
data/templates/_site/images/build-matrix.png +0 -0
data/templates/_site/images/building-status-tag.png +0 -0
data/templates/_site/images/gerrit-demo.jpg +0 -0
data/templates/_site/images/github.gif +0 -0
data/templates/_site/images/green_gradient.gif +0 -0
data/templates/_site/images/header_bg.gif +0 -0
data/templates/_site/images/header_gradient.gif +0 -0
data/templates/_site/images/jenkins-jobs.jpg +0 -0
data/templates/_site/images/jenkins-logo.jpg +0 -0
data/templates/_site/images/linkedin.gif +0 -0
data/templates/_site/images/subscribe-icon.gif +0 -0
data/templates/_site/images/subscribe.png +0 -0
data/templates/_site/images/title.gif +0 -0
data/templates/_site/images/twitter.gif +0 -0
data/templates/_site/images/weibo.gif +0 -0
data/templates/_site/images/whiteboard.jpg +0 -0
data/templates/_site/index.html +471 -0
data/templates/_site/javascripts/jquery.github.js +3 -0
data/templates/_site/javascripts/jquery.js +19 -0
data/templates/_site/open-source.html +78 -0
data/templates/_site/stylesheets/master.css +296 -0
data/templates/_site/stylesheets/syntax.css +60 -0
data/templates/about.textile +16 -0
data/templates/atom.xml +27 -0
data/templates/blog.html +29 -0
data/templates/drafts/outsource-your-blog.textile +32 -0
data/templates/favicon.ico +0 -0
data/templates/images/about.gif +0 -0
data/templates/images/blog.gif +0 -0
data/templates/images/build-matrix.png +0 -0
data/templates/images/building-status-tag.png +0 -0
data/templates/images/github.gif +0 -0
data/templates/images/green_gradient.gif +0 -0
data/templates/images/header_bg.gif +0 -0
data/templates/images/header_gradient.gif +0 -0
data/templates/images/jenkins-jobs.jpg +0 -0
data/templates/images/linkedin.gif +0 -0
data/templates/images/subscribe-icon.gif +0 -0
data/templates/images/subscribe.png +0 -0
data/templates/images/title.gif +0 -0
data/templates/images/twitter.gif +0 -0
data/templates/images/weibo.gif +0 -0
data/templates/index.html +62 -0
data/templates/javascripts/jquery.github.js +3 -0
data/templates/javascripts/jquery.js +19 -0
data/templates/open-source.html +33 -0
data/templates/stylesheets/master.css +296 -0
data/templates/stylesheets/syntax.css +60 -0
metadata +125 -0

data/templates/_site/blog.html ADDED Viewed

@@ -0,0 +1,581 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
+  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+<html>
+  <head>
+    <meta http-equiv="Content-type" content="text/html; charset=utf-8">
+    <title>Larry Cai - Blog</title>
+    <link rel="stylesheet" href="/stylesheets/master.css" type="text/css" media="screen" charset="utf-8"/>
+    <link rel="stylesheet" href="/stylesheets/syntax.css" type="text/css" media="screen" charset="utf-8"/>
+    <script src="/javascripts/jquery.js" type="text/javascript" charset="utf-8"></script>
+    <script src="/javascripts/jquery.github.js" type="text/javascript" charset="utf-8"></script>
+    <link rel='alternate' type='application/rss+xml' href='http://feeds2.feedburner.com/larrycai' />
+  </head>
+  <body>
+    <div id='wrapper'>
+      <div id='header'>
+        <h1><a href='/'>Larry Cai</a></h1>
+        <div id='menu'>
+          <ul>
+            <li><a href='/blog.html' id='blog_link' title='Blog'>Blog</a></li>
+            <li><a href='/about.html' id='about_link' title='About'>About</a></li>
+            <li><a href='http://github.com/larrycai' target='_blank' title='GitHub' rel='me' id='github_link'>GitHub</a></li>
+            <li><a href='http://cn.linkedin.com/in/larrycaiyu' title='LinkedIn' target='_blank' rel='me' id='linkedin_link'>LinkedIn</a></li>
+            <li><a href='http://weibo.com/larrycaiyu' title='Weibo' target='_blank' rel='me' id='weibo_link'>Weibo</a></li>
+          </ul>
+        </div>
+      </div>
+      <div id='content'>
+        <a href='http://feeds.feedburner.com/~u/14174549791849888941' class='float-right'><img src='/images/subscribe.png' alt='Subscribe to XML Feed'/></a>
+  <div class='post'>
+    <span class='date'>06 Mar 2012</span>
+    <h1><a href='/2012/03/06/travis-ci-is-evolution.html'>Travis CI会替代Jenkins吗？</a></h1>
+    <div class='body'><h1>介绍</h1>
+<p>你可能用Github了。但是你是怎么自动构建你的开源项目的呢？你的Github项目有“构建状态”标签吗？</p>
+<p><img src="http://larrycai.github.com/images/building-status-tag.png" alt="Github上的项目构建状态" /></p>
+<p>如果你还不知道这个，你就有些落伍了，因为这是Travis CI带来的持续集成的革新，它可能会替代Jenkins现在的地位。</p>
+<p>让我们一起来看看Travis-ci到底带来了什么，先从Jenkins说起。</p>
+<p>在写这篇博客时，发现好友晓斌也写了一篇<a href="http://www.juvenxu.com/2012/03/06/travis-ci/">Travis CI，翩翩而至的CI云</a>，可以参考阅读。</p>
+<h2>Jenkins介绍</h2>
+<p>持续集成是敏捷软件开发的一个重要工具，开源工具<a href="http://jenkins-ci.org/">Jenkins</a>是实施持续集成首选，大概占据了半壁江山。</p>
+<p><img src="http://larrycai.github.com//images/jenkins-jobs.jpg" alt="Jenkins界面" /></p>
+<p>Jenkins以前叫Hudson，后来由于Oracle收购了Sun公司，Oracle与开源软件社区谈崩了。Hudson创始人Kohsuke Kawaguchi(简称 KK)一怒之下，和社区的人其他人重起炉灶，建立了Jenkins社区。详细可以看看InfoQ的文章<a href="http://www.infoq.com/cn/news/2011/01/hudson-jenkins2">Hudson社区提议将项目更名为Jenkins</a>。</p>
+<h3>Jenkins功能</h3>
+<p>它有很多极佳的特性：</p>
+<ol>
+<li>易于安装：一个命令就可启动，也方便部署到各种Web容器中（如tomcat)。</li>
+<li>易于配置：所有的配置都在Web界面实现，权限控制得也不错。</li>
+<li>插件支持：基本上所有的扩展都是有插件完成的，开发插件也很方便，由此产生了庞大的社区。</li>
+<li>支持分布式构建：Jenkins能够让通过主从模式（master/slave）多台机器一起构建。</li>
+</ol>
+<h3>Jenkins在企业中常见步骤</h3>
+<p>Jenkins服务器一般先架设在一台服务器上，有配置管理人员管理。</p>
+<p>产品有构建需求后，配置管理人员就新建一个任务，配好源码仓库，设置构建时间，指定运行脚本来编译测试产品，并且设置报告输出。一切都可以在Web界面中运行。</p>
+<h2>Jenkins的一些弊端</h2>
+<p>Jenkins虽然非常好用，但还是有些弊端。</p>
+<h3>多平台或依赖的包</h3>
+<p>如果你的软件想在不同的操作系统软件构建并验证，这将是相当有难度和技巧性，一般主要是准备不同的操作系统的机器，然后使用主/从模式进行分布式构建。</p>
+<p>在C++中你可以使用有关的交叉编译器，一个不错的解决方案。</p>
+<p>但是再进一步如果你的第三方软件和不同的依赖比较多，那么这个环境的准备是非常困难的，因为这个组合将很大。</p>
+<p>当然你可有使用虚拟机的技术vagrant/virtualbox，参见<a href="http://larrycai.github.com/2011/10/25/vagrant-jenkins-ci.html">使用vagrant+jenkins来管理虚拟机的技巧</a>。可以工作，不太优雅。因为它不是原生的，有点复杂。</p>
+<h3>配置管理人员的工作</h3>
+<p>一般来说Jenkins的构建任务，它是集中控制的。大多来说都是有专职的配置管理人员来管理，否者权限会混乱。</p>
+<p>当有需求时，他们负责在CI服务器创建任务（记住：这些配置文件不是有版本控制的）。这个就涉及到了沟通成本，你有变化需求，很难及时满足。</p>
+<p>由于服务器是有限的，它主要构建重要分支的内容。在你自己的私有分支上运行CI是比较奢侈的，而且环境不一样，也不推荐。</p>
+<p>你可以想象如果在一个C/C++产品的公司，你要为一个Lisp的项目创建CI要花多久？</p>
+<p>作为开发者，为什么不能随时构建你想要的东西呢？这就是Travis CI想做的。</p>
+<h2>Travis CI 介绍</h2>
+<p>Travis CI 这里就不介绍怎么使用了具体可以先看<a href="http://www.juvenxu.com/2012/03/06/travis-ci/">晓斌的博客</a>和<a href="http://saberma.me/other/2011/11/29/travis-ci-is-a-free-continuous-integration-test-server.html">免费的持续集成测试服务</a>，强烈建议你先试一下。</p>
+<p>初看Travis CI象和Jenkins没啥区别，指定你Github中的项目，然后他帮你编译，而且它使用的也是Vagrant/Virtualbox技术。但实际上里面有很多好点子。</p>
+<h2>Travis CI带来的变革</h2>
+<h3>配置本地化和可读性</h3>
+<p>不像以前，构建的任务是在Jenkins服务器上的，现在构建的配置文件直接就和源码放在一起，而且配置文件使用DSL写的，可读性更高。</p>
+<pre><code>before_script:
+  - sudo apt-get install pandoc
+  - sudo apt-get install ttf-arphic-gbsn00lp ttf-arphic-ukai ttf-wqy-microhei ttf-wqy-zenhei
+  - sudo apt-get install texlive-xetex texlive-latex-recommended texlive-latex-extra
+  - gem install mkbok
+rvm:
+  - 1.9.3
+  - 1.8.7
+script: mkbok --lang zh --build pdf
+after_script:
+    - which curl ; curl -v --upload-file sdcamp.zh.pdf http://blobs.ge.tt/3iBcNNC/sdcamp.zh.pdf?sig=-TY5O1GAx8xHwWiCqd8aySlQiroFAnHK2o4
+</code></pre>
+<p>作为用户，关心的是要哪些依赖包，然后怎么构建就行了，上面的配置每一行都没有浪费。</p>
+<h3>多版本支持</h3>
+<p>像上面的例子中，我要求在两个Ruby环境中运行，它就帮我做到了，我并不关心它是怎么切换的。</p>
+<p><img src="http://larrycai.github.com/images/build-matrix.png" alt="多版本构建结果" /></p>
+<h3>原生的云技术来分布式构建</h3>
+<p>Travis CI使用的Ruby语言，一开始考虑的就是分布式构建，比Jenkins的插件式进了一步。</p>
+<p>虽然Travis CI并不是直接用到了云机器，它的虚拟机部分只是Vagrant/Virtualbox，但是这一块是很容易迁移到其他的技术的。</p>
+<h1>总结</h1>
+<p>Jenkins有点可惜，改了名字以后，功能上面并没有突破。当然这就是开源竞争的好处，总有新的理念，新的工具产生。你不前进，别人就迎头赶上。</p>
+<p>Travis CI现在只是支持Github的公开项目，但已经爆发出它的优点了。要不了多久，我相信就能运行在你公司内部了。</p>
+<p>让我们一起期待这个革新吧！</p>
+<h1>相关阅读</h1>
+<ol>
+<li>Juven Xu的“Travis CI，翩翩而至的CI云” <a href="http://www.juvenxu.com/2012/03/06/travis-ci/">http://www.juvenxu.com/2012/03/06/travis-ci/</a></li>
+<li>免费的持续集成测试服务 <a href="http://saberma.me/other/2011/11/29/travis-ci-is-a-free-continuous-integration-test-server.html">http://saberma.me/other/2011/11/29/travis-ci-is-a-free-continuous-integration-test-server.html</a></li>
+</ol>
+</div>
+    <a href='/2012/03/06/travis-ci-is-evolution.html#disqus_thread'>View Comments</a>
+  </div>
+  <div class='post'>
+    <span class='date'>13 Jan 2012</span>
+    <h1><a href='/2012/01/13/ebook-chinese-fonts.html'>开源书和开源技术-PDF中蛋疼的中文字体</a></h1>
+    <div class='body'><h1>介绍</h1>
+<p>上次我介绍了一个用<a href="http://www.ituring.com.cn/article/828">Markdown格式来写开源书和相关的开源技术</a>，还留了个在Linux下产生PDF所需要的中文字体这个大尾巴。这次我想借用我写<a href="http://weibo.com/2104936813/y0oXC350t">【跟我学企业敏捷开发】</a>的一点经验，给不太了解这一块知识的朋友一起探讨一下。</p>
+<p>有些问题还是没有解决，希望有Latex的高手解答。</p>
+<p>不管怎样，还是希望能借此机会推动国内电子书，特别是开源电子书的发展。</p>
+<h1>Linux下的中文编码和字体</h1>
+<p>首先，我用的是Linux环境并且选用的是<strong>UTF-8</strong>的编码，而不是GBK，否者在github上显示会有问题，不了解这方面的朋友自己找找资料吧，够讲个把小时的。</p>
+<p>在产生PDF时，一般建议内嵌中文字体的，但是真正能用的中文字体实际很少，极大多数是有版权的：</p>
+<ul>
+<li><a href="http://www.arphic.com.tw/">文鼎</a>开放的四套字体（简报宋、细上海宋、简中楷、中楷），没有一点版权问题，是大部分的中文Linux的缺省安装。</li>
+<li><a href="http://wenq.org/">文泉驿</a>的几套字体（微米黑、正黑、点阵宋体）是开放但是GPL性质的，所以不是随便可以商用的。</li>
+<li>Adobe有两套开放字体（宋体、黑体）我认为是可以随便用的，忘了在哪里看到这个解释的了。</li>
+</ul>
+<p>可以看看<a href="http://wiki.ubuntu.org.cn/�%8D费中文字体">Ubuntu免费中文字体</a>的介绍有个认识。</p>
+<h2>怎么选择对应字体</h2>
+<p>一般缺省中文正文字体是宋体、细明体，对应英文Serif类的英文字体：Georgia、Times New Roman等。</p>
+<p>标题和重要内容可以选楷体和黑体，对应英文Sans Serif类的英文字体：Arial、Tahoma、Verdana等</p>
+<p>技术文章中常见的代码典型的等宽体用黑体，对应英文Monospace类的英文字体：Courier New等</p>
+<p>所以对应的在<a href="https://github.com/larrycai/sdcamp/blob/master/latex/config.yml">我的中文Latex配置</a>中可选的是：</p>
+<ul>
+<li>font：文鼎的简报宋、细上海宋，文泉驿的点阵宋体，Adobe的宋体</li>
+<li>bold: 文鼎的简中楷、中楷，文泉驿的微米黑、正黑，Adobe的黑体</li>
+<li>mono: 文泉驿的微米黑、正黑，Adobe的黑体</li>
+</ul>
+<h2>如何安装字体</h2>
+<p>我用的试验环境是Ubuntu 11.04 (Natty)，大部分可以直接从Ubuntu源中下载了。</p>
+<p>你可以用命令<code>fc-list :lang=zh-cn</code>查看安装好的中文字体，结果中前半部分就是字体名称（如<code>AR PL UMing CN</code>）。</p>
+<pre><code>user@puppet1:~$ fc-list :lang=zh-cn | grep CN
+AR PL UMing CN:style=Light
+AR PL UKai CN:style=Book
+</code></pre>
+<p>文鼎开放的四套字体的Ubuntu包、字体名字和名称如下：</p>
+<pre><code>ttf-arphic-gbsn00lp      "AR PL SungtiL GB" 文鼎PL简报宋
+ttf-arphic-gkai00mp      "AR PL KaitiM GB" 文鼎PL简中楷
+ttf-arphic-ukai          "AR PL UKai" 文鼎PL中楷
+ttf-arphic-uming         "AR PL UMing" 文鼎PL细上海宋
+</code></pre>
+<p>文泉驿字体的Ubuntu包、字体名字和名称如下</p>
+<pre><code>ttf-wqy-microhei   "WenQuanYi Micro Hei" 文泉驿的微米黑
+ttf-wqy-zenhei     "WenQuanYi Zen Hei" 文泉驿的正黑
+xfonts-wqy         "WenQuanYi Bitmap Song" 文泉驿的点阵宋体
+</code></pre>
+<p>Adobe的中文字体有<a href="http://www.adobe.com/support/downloads/detail.jsp?ftpID=4421">官方下载</a></p>
+<pre><code>$ tar -jzxf FontPack910_chs_i486-linux.tar.bz2
+$ tar -xvf CHSKIT/LANGCHS.TAR
+$ mkdir ~/.fonts
+$ cp Adobe/Reader9/Resource/CIDFont/*.otf ~/.fonts
+$ fc-cache -f -v
+$ fc-list :lang=zh | grep Adobe
+</code></pre>
+<h2>蛋疼的问题</h2>
+<p>只可惜现在正文在产生PDF时没有一种字体是有完美表现的。</p>
+<ol>
+<li>文鼎贡献的字体中台湾字形的细上海宋的句号在中间，出来的效果不伦不类的。</li>
+<li>文鼎贡献的字体中大陆字形的简中楷和简报宋，标点符号的位置是对的，但是当碰到条目（Item）的时候条目的点没能显示出来。</li>
+<li>Adobe的宋体，条目的时候显示一个田子框，很难看。</li>
+<li>文泉驿的点阵宋体老是转化Latex时出错，搞不定。</li>
+</ol>
+<p>现在将就着用文鼎的细上海宋。</p>
+<p>【更新】
+2、3 条目的问题，我hack成其他字符（*）显示就没问题了（如下），不知道缺省的圆点显示不对。<a href="http://wiki.ctex.org/index.php/LaTeX/%E5%88%97%E8%A1%A8">http://wiki.ctex.org/index.php/LaTeX/%E5%88%97%E8%A1%A8</a>，现在就用文鼎的细上海宋了。</p>
+<pre><code>\begin{itemize}\setlength{\itemsep}{1pt}\setlength{\parskip}{0pt}\setlength{\parsep}{0pt}
+\item[*]
+% 原来是
+% \item
+</code></pre>
+<h1>其他</h1>
+<p>本文也是我用git记录在<a href="https://github.com/larrycai/larrycai.github.com">github</a>上的，你可以看到每次的变化。</p>
+<p>如果对此文有兴趣，帮忙顶一下，别忘了 <a href="http://weibo.com/larrycaiyu">@larrycaiyu</a>。</p>
+<h1>参考</h1>
+<ol>
+<li>中文字体没有版权问题的解决方案？http://bbs.ctex.org/viewthread.php?tid=46106&amp;extra=&amp;page=1</li>
+</ol>
+</div>
+    <a href='/2012/01/13/ebook-chinese-fonts.html#disqus_thread'>View Comments</a>
+  </div>
+  <div class='post'>
+    <span class='date'>31 Dec 2011</span>
+    <h1><a href='/2011/12/31/ebook-by-markdown.html'>开源书和开源技术-Markdown篇</a></h1>
+    <div class='body'><h1>开源书和开源技术-Markdown篇</h1>
+<h1>背景</h1>
+<p>看到<a href="http://weibo.com/1404949082/xDeyDEaDq">霍泰稳关于infoq的架构师电子书问题的微博</a>和图灵社区的文章<a href="http://www.ituring.com.cn/article/details/764">为什么写作自由书籍？</a>，我就想通过一个用Markdown格式写的<a href="http://progit.org/">Pro Git</a>开源书 的例子来介绍其中用到的技术。希望能借此机会推动国内电子书，特别是开源电子书的发展。</p>
+<p>【声明】我并没有写书的经历，这里只是对电子书出版技术的入门介绍而已。</p>
+<h1>从Pro Git说起</h1>
+<p>如果你了解Git，或者想了解Git。那么你就应该知道<a href="http://progit.org/">Pro Git</a>，它是Git的书中写得最好的一本（至少是之一），可是你是否知道它有网络中文版，而且能在iPad上极其漂亮得阅读。并且是免费的，不是盗版的免费！如果你想要最新的，你甚至可以自己生成它。哈哈，我就是这么干的。</p>
+<p>这一切就归功于开源社区和它后面用到的技术。</p>
+<h1>开源书</h1>
+<p>这里我不用多讲，开源书就像其他的开源产品（如维基百科）一样，只要是开放的，社区就有人会贡献。<a href="http://progit.org/">Pro Git</a>的作者Scott很慷慨得把书的内容全部共享在<a href="http://github.com/progit/progit">github/progit</a>库中，使用得是<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/us/">CC BY-NC-SA 3.0</a>。</p>
+<p>Scott只负责英文版，其他许许多多语言的翻译都是社区贡献的，中国翻译相当有质量，你可以在线读<a href="http://progit.org/book/zh/">Pro Git中文版</a>。</p>
+<h1>开源技术生成电子书</h1>
+<p>这本书不仅仅开源了内容，使用的技术也是开源的。让我们看看他是怎么做的。</p>
+<h2>markdown原始文件</h2>
+<p>首先书的内容是用markdown格式写的。markdown格式的普及要归功于<a href="github.com">Github</a>和<a href="http://stackoverflow.com/">StackOverflow</a>。因为它们越来越流行，它们支持markdown格式也越来越流行。这里要赞一个的是，国内的<a href="http://www.ituring.com.cn/">图灵社区</a>也支持markdown，用起来超级方便。</p>
+<p>简单来说，markdown格式的文件看着像一般的文本文件，里面只是加了很少的格式标记，因此看文本文件也不影响理解，这种格式也有很多工具帮你去转化，而且很容自动化解决。并且这些技术大多数是开源或免费的。</p>
+<p>你可以直接看一下【Pro Git】的<a href="https://raw.github.com/progit/progit/master/zh/01-introduction/01-chapter1.markdown">“第一章 介绍” 的markdown原始文件</a>，顺便看看github自动生成的简单<a href="https://github.com/progit/progit/blob/master/zh/01-introduction/01-chapter1.markdown">“第一章 介绍” 的html</a>。</p>
+<h2>产生电子书</h2>
+<h3>epub/mobi格式</h3>
+<p>Ruby的<a href="https://github.com/rtomayko/rdiscount">rdiscount</a>帮你从markdown转成html格式，然后有<a href="calibre">Calibre</a>附带的命令<code>ebook-convert</code>生成最终的<code>.mobi</code> (Kindle) 和 <code>.epub</code> (iPad)。</p>
+<h3>PDF格式</h3>
+<p>为了能达到出版的质量，Latex是一个常用的格式，PDF也能很容易的产生出来，有关Latex，自己看看参考链接学习吧。</p>
+<p><a href="http://johnmacfarlane.net/pandoc/">pandoc</a>能帮着从markdown转换出latex格式，然后<a href="http://www.tug.org/texlive/">TexLive</a>软件中的<code>xelatex</code>再转成PDF格式。</p>
+<h2>试验环境</h2>
+<p>你只需要一台Linux机器（虚拟机就可以了）和简单的Linux命令就可以试验了。有git和ruby的知识那就更方便了。</p>
+<p>我用的试验环境是Ubuntu 11.04 (Natty)</p>
+<h3>下载Pro Git开源书</h3>
+<p>很简单，<code>git clone</code>一下就可以了，下载它的源文件包我觉得还是烦了点。</p>
+<pre><code>$ git clone https://github.com/progit/progit.git
+</code></pre>
+<h3>epub/mobi格式</h3>
+<p>做电子书相对简单一点，因为要求没有PDF的高，<a href="http://calibre-ebook.com/">calibre</a>就可以满足了。</p>
+<p>如果装的Ubuntu是服务器版的（没有X-Windows），建议安装<a href="http://en.wikipedia.org/wiki/Xvfb">xvfb</a>无头(headless)X服务器，因为不知道什么原因有几个命令需要。XMing还不行，因为需要<code>X-Input</code></p>
+<pre><code>$ sudo apt-get install ruby rubygems # ruby 1.8.7 is used
+$ sudo apt-get install calibre # calibre 0.7.44 for ubuntu 11.04
+$ gem install rdiscount ruby-debug
+$ xvfb-run ./makeebooks zh  # 缺省.mobi格式
+$ export FORMAT=epub
+$ xvfb-run ./makeebooks zh # .epub格式
+</code></pre>
+<h3>PDF格式</h3>
+<p>生成PDF是一个比较复杂的东西，<a href="http://johnmacfarlane.net/pandoc/">pandoc</a>用Ubuntu库里的，TexLive建议下载最新的<a href="http://www.tug.org/texlive/">TexLive</a>包安装，并配置到搜索路径中。</p>
+<pre><code>$ sudo apt-get install pandoc
+$ # 安装texlive 2011
+</code></pre>
+<p>因为是中文PDF，需要把字体嵌入在文件中，因此需要安装字体文件（如果不是Ubuntu中文版）</p>
+<pre><code>$ sudo apt-get install language-support-fonts-zh-hans
+</code></pre>
+<p>现在你就可以生成pdf文件了。</p>
+<pre><code>$ ./makepdfs zh
+</code></pre>
+<h1>其他常用的格式</h1>
+<p>计算机类图书对格式要求不是很多，图文、章节、源代码基本就够了，就算有些复杂公式，也可用图来显示。这也从理论上说明，它不需要复杂的格式。现在对这类技术书出版我的理解主要有几种：</p>
+<ol>
+<li>Microsoft的Word格式，虽然国内出版界如日中天，缺省就认它（对技术没追求，鄙视）。简单好学，但是不擅长自动化，是开源的死敌。</li>
+<li>Latex格式（就是Donald E. Knuth（高德纳）发明的，这是很棒的东西，特别适合学术类的各种复杂的公式等，不过学习曲线很高，国内也只有几家学术期刊使用。</li>
+<li>docbook格式是最有名的（从SGML演化过来？），Orielly和Pragmatic出版社缺省就用它，它能    很方便的转化出出版要的各种样式。如<a href="http://www.wakaleo.com/books/jenkins-the-definitive-guide">Jenkins - the definition guide</a>开源书就是采用docbook。但由于是XML格式，很多人不习惯，而且多人网上协作不是很方便。</li>
+<li>通过蒋鑫的<a href="http://www.worldhello.net/gotgithub/">Got Github</a>开源书，我也了解reStructureText也是和markdown差不多纯文本（plain text)的，也是蛮流行的。</li>
+</ol>
+<p>如果有机会，我再介绍一下docbook和reStructureText的相关技术。</p>
+<h1>其他</h1>
+<p>本文也是我用git记录在<a href="https://github.com/larrycai/larrycai.github.com">github</a>上的，你可以看到每次的变化。</p>
+<p>如果对此文有兴趣，帮忙顶一下，别忘了 <a href="http://weibo.com/larrycaiyu">@larrycaiyu</a>。</p>
+<h1>Latex的参考</h1>
+<ol>
+<li>http://share.chinatex.org/</li>
+<li>http://manual.calibre-ebook.com/conversion.html</li>
+<li>http://calibre-ebook.com/download_linux</li>
+<li>http://johnmacfarlane.net/pandoc/</li>
+<li>http://latex.yo2.cn/articles/latex-introduction0.html</li>
+<li>http://product.china-pub.com/54569</li>
+</ol>
+</div>
+    <a href='/2011/12/31/ebook-by-markdown.html#disqus_thread'>View Comments</a>
+  </div>
+  <div class='post'>
+    <span class='date'>16 Dec 2011</span>
+    <h1><a href='/2011/12/16/visualize-quality-4-cxx-legacycode.html'>企业C++大型系统遗留代码变迁的布道之旅</a></h1>
+    <div class='body'><h1>企业C++大型系统遗留代码变迁的布道之旅</h1>
+<h1>前沿</h1>
+<p>特别声明：本文专为<a href="http://www.ituring.com.cn/activity/details/696">图灵社区活动“唤醒你心中的布道师”</a>而写，欢迎大家积极参与！</p>
+<p><a href="http://www.programmer.com.cn/9072/">程序员杂志第十二期</a>中讲到了企业开发的困境，其中有一点就是企业有很多的遗留代码，而且是C/C++的大型系统。怎么处理一直是推动软件开发中的头疼问题，为什么头疼呢？</p>
+<ol>
+<li>旧代码，又大，怎么下手，时间在哪里？</li>
+<li>C/C++代码，和java比起来没有统一的单元测试工具，又难改造，怎么办？</li>
+</ol>
+<p>现在我们已经基本完成了这个转变，主要代码覆盖率在60%以上，很好得支持了敏捷开发（如持续集成）。</p>
+<p>在看了<a href="http://www.ituring.com.cn/book/736">布道之道</a>一书后，把我们用的一些技巧和策略用实际例子和大家一起来探讨一下。</p>
+<h1>背景介绍</h1>
+<p>变革开始于2007年左右，那时，这是一个有几十万行代码的C++产品，始于上个世纪末，基于Corba，XML，组件（component）的技术，由于架构的关系，没有单元测试，只有集成测试。</p>
+<p>功能持续增加，开发者交付压力大。质量开始有下降、维护成本有提高的苗头。</p>
+<p>我们就想通过提高C++的代码测试覆盖率来解决这些问题；这就需要把单元测试从无到有，再到一个高度。</p>
+<p>基础这么差，不得不需要布道！</p>
+<h1>什么样的怀疑者</h1>
+<p>在推动这个变革前，先看看有什么样的怀疑者会阻碍你。</p>
+<p>在大公司里最多的还是孤陋寡闻型，时间紧迫型。</p>
+<p><strong>孤陋寡闻型</strong>：主要是开发者，我又想叫他们埋头苦干型。因为他们干活踏踏实实，只是由于项目压力的关系，没有额外的时间去看看外面的新技术，习惯了按步就班。</p>
+<p>他们早已经习惯了用集成测试来替代单元测试。猛然间听说要上单元测试，一下子就觉得不行。Java么还可以考虑考虑，C++的产品需要搞单元测试吗？而且这种复杂的架构，能搞成功吗？就算能成，代价也太大了，那么多旧的代码，不可能！</p>
+<p><strong>时间紧迫型</strong>：主要就是项目管理者，他们最大的愿望是项目准时完成，质量达到要求，项目完成后，他们基本就会转战到另一个战场。</p>
+<p>所以一听说想在项目里面加点东西，还不知道干嘛呢，就问多少时间？问为什么在这个项目做（潜台词就是别在我这儿捣乱）。等到一听说要做以前都不做的单元测试，头摇得就像拨浪鼓一样，死活都不肯。</p>
+<h1>对症下药：采用合适的技术</h1>
+<p>对上面两种人和我们要解决的问题，我们采用了好多种方法，下面介绍主要的两种：展示技术和适当妥协</p>
+<p><strong>展示技术</strong>：你要告诉他们，你要推动的变革是可以做到的，这样来消除他们的疑惑。</p>
+<p>这是对付孤陋寡闻型的最好办法，告诉他们这个能做到，也没有想象中的难。</p>
+<p>我记得我花了两周的时间找了一个最典型的组件，采用了CppUnit这个单元测试框架，并应用了虚函数（java中的接口）的方式把对平台架构的依赖全部隔离掉，顺利地跑通了几个测试。并且我还准备了ppt，召集大家一起来探讨确认这是一个可以工作的方式。</p>
+<p>就象书上说的，孤陋寡闻型的人看到了, 了解了以后，就很容易得接受你的建议了。</p>
+<p><strong>适当妥协</strong>：就是要找到折中方案，让大家都能过的去。</p>
+<p>这是对付时间紧迫型的一个好办法，要求不能太高，把一下子想做的东西放在一个地方。</p>
+<p>我们决定用循序渐进的方式，提出一个中肯的方案：</p>
+<ol>
+<li>新代码必须要用单元测试，这个没话可说，因为从项目质量上这个是可以要求的。当然怎么做单元测试，由于是新的，会有人提供培训和帮助。</li>
+<li>旧代码在改变时必须要用单元测试，因为改了代码，有测试保证这也是应该的。</li>
+<li>在改动的组件中，每次要对旧代码增加一些测试。</li>
+</ol>
+<p>这样一来，每个项目中都会对单元测试有所贡献，长而久之，会积累到比较客观的数量，虽然慢了点，但还是往前进步的。</p>
+<p>时间紧迫型当然不是吃素的，老觉得亏了点，就盯着第三点说：“项目没时间做这个额外的事情”，这个要靠策略了。</p>
+<h1>辅以策略：贯彻实施</h1>
+<p>两个最基本的策略：竭力支持者，说服管理层。</p>
+<p><strong>竭力支持者</strong> 是最该采纳的，他们会鼓动周边的人和你一起服务，要善于团结他们，这要就扭成了一股绳。</p>
+<p>对大多数有经验的开发者，大家都明白单元测试是保证质量的最好办法，技术上说服以后，他们很快就变成了<strong>竭力支持者</strong>，觉得不加单元测试就是一种罪过，项目中有谁忘了，<strong>竭力支持者</strong>也会及时提醒他们，不需要你们一直跟踪，减轻了很多压力。</p>
+<p><strong>说服管理层</strong> 是一个最棒的方式，当然前提是你要能说服他们。</p>
+<p>实际上管理层也知道没有单元测试这一弊端，只是苦于没有行之有效的方案而已。所以当你告诉他们技术上没有问题了，代价也不是很大，并且你又提供了切实可行的计划。管理层立马会通知大家把这个落实到各个项目中去（包括上面的第三条）。</p>
+<p>拿到了这个尚方宝剑，没有谁会阻碍了，我们就可以把主要精力花在技术支持上，当然千万不能搞砸了。</p>
+<h1>收获果实</h1>
+<p>果然，经过了几年，到2010年单元测试已经达到了60%左右（对C++来说不错了），现在开发人员也习以为常了。</p>
+<h1>结束语</h1>
+<p><a href="http://www.ituring.com.cn/book/736">布道之道</a> 真是一本好书（翻译要记一功），它的好多种模式一看就明白。如果你是个有经验的人，你会发现你的很多技巧都在书上提到了，它会帮你进一步的提炼升华，使你下次做的更好。</p>
+<p>布道会使你有一种成就感，让我们一起来把这个软件行业变得越来越好吧。</p>
+<h1>其他</h1>
+<p>本文也是我用git记录在<a href="https://github.com/larrycai/larrycai.github.com">github</a>上的，你可以看到每次的变化。</p>
+<p>如果对此文有兴趣，帮忙顶一下，别忘了 <a href="http://weibo.com/larrycaiyu">@larrycaiyu</a> ，希望有机会有人能帮我推荐到QConf 2012中去分享，到时我们可以探讨得更多。</p>
+<p>这儿再留一个关子，如何建立一个好的C++代码质量检测框架，并且最终和其他java代码质量清晰得显示在一起又是另外一个布道故事了，而且有一些就是因为没有看这本书而得到的一个反面教材。</p>
+</div>
+    <a href='/2011/12/16/visualize-quality-4-cxx-legacycode.html#disqus_thread'>View Comments</a>
+  </div>
+    <h3>Older Posts</h3>
+    <table class='post-list'>
+    <tr>
+      <th><a href='/2011/12/10/clearcase-2-git.html'>企业版本控制的改革：从ClearCase到Git--我的布道之旅</a></th>
+      <td>10 Dec 2011</td>
+      <td><a href='/2011/12/10/clearcase-2-git.html#disqus_thread'>Comments</a></td>
+    </tr>
+    <tr>
+      <th><a href='/2011/11/04/veewee-create-vm.html'>用veewee创建vagrant的虚拟机</a></th>
+      <td>04 Nov 2011</td>
+      <td><a href='/2011/11/04/veewee-create-vm.html#disqus_thread'>Comments</a></td>
+    </tr>
+    <tr>
+      <th><a href='/2011/10/25/vagrant-jenkins-ci.html'>使用vagrant+jenkins来管理虚拟机的技巧</a></th>
+      <td>25 Oct 2011</td>
+      <td><a href='/2011/10/25/vagrant-jenkins-ci.html#disqus_thread'>Comments</a></td>
+    </tr>
+    <tr>
+      <th><a href='/2011/08/18/agile-tools.html'>敏捷和工具</a></th>
+      <td>18 Aug 2011</td>
+      <td><a href='/2011/08/18/agile-tools.html#disqus_thread'>Comments</a></td>
+    </tr>
+</table>
+        <div class='clearfix'></div>
+      </div>
+    </div>
+    <div id='footer'>
+      Copyright &copy; 2011 Larry Cai. Hosted by <a href='http://github.com/larrycai/larrycai.github.com/' target='_blank'>GitHub</a> and powered by <a href='http://github.com/mojombo/jekyll'>Jekyll</a>, and reuse the template from <a href='http://github.com/mbleigh/mbleigh.github.com/'>Michael Bleigh</a>.
+    </div>
+    <script type="text/javascript">
+        /* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
+        var disqus_shortname = 'larrycaiyu'; // required: replace example with your forum shortname
+        /* * * DON'T EDIT BELOW THIS LINE * * */
+        (function () {
+            var s = document.createElement('script'); s.async = true;
+            s.type = 'text/javascript';
+            s.src = 'http://' + disqus_shortname + '.disqus.com/count.js';
+            (document.getElementsByTagName('HEAD')[0] || document.getElementsByTagName('BODY')[0]).appendChild(s);
+        }());
+    </script>
+  </body>
+</html>