Permalink
Browse files

update BUILD.md to reflect of mkbok

  • Loading branch information...
1 parent bc6cfd5 commit b255ad4071f168b96b265703f0f4b8eb2cf48759 @larrycai committed Feb 22, 2012
Showing with 6 additions and 67 deletions.
  1. +6 −67 BUILD.md
View
@@ -17,10 +17,11 @@ Ubuntu Platform Oneiric (11.10) is used mainly due to pandoc.
Though texlive 2011 can be installed separately, the default one texlive 2009 from Ubuntu repository is good enough so far.
+ $ sudo apt-get install ruby1.9.1
$ sudo apt-get install pandoc
- $ sudo apt-get texlive-xetex
- $ sudo apt-get texlive-latex-recommended # main packages
- $ sudo apt-get texlive-latex-extra # package titlesec
+ $ sudo apt-get install texlive-xetex
+ $ sudo apt-get install texlive-latex-recommended # main packages
+ $ sudo apt-get install texlive-latex-extra # package titlesec
You need to install related fonts for Chinese, fortunately they exist in ubuntu source also.
@@ -29,75 +30,13 @@ You need to install related fonts for Chinese, fortunately they exist in ubuntu
Then it should work perfectly
- $ ./makepdfs zh
+ $ ./mkbok
-If you are fans of ruby, you can even try
-
- $ gem install mkbok
- $ mkbok --lang=zh
-
Just remind you, some [extra pandoc markdown format](http://johnmacfarlane.net/pandoc/README.html) is used inside this book:
* code syntax highlight (doesn't work in pdf, while it should work in html/epub which needed later)
* footnote
-
-# Making Ebooks #
-
-**In long term** I will use pandoc instead of solution below since from 1.8.x, pandoc supports for epub as well.
-
-[ruby rdiscount](https://github.com/rtomayko/rdiscount) is used to convert all the markdown files to html format.
-
-[Calibre][calibre]'s command `ebook-convert` is used to convert html files into ebooks like `.mobi` (Kindle) and `.epub` (for iPad), it exists in several platforms (Windows, OS X, Linux).
-
-[Calibre][calibre] needs X-Windows for some reason, If X-Windows is not used like server only, then [xvfb](http://en.wikipedia.org/wiki/Xvfb) (Virtual Framebuffer 'fake' X server) package should be installed to support headless X-Windows. Simple X-Windows server like XMing doesn't support X-Input.
-
-After preparing the environment, you can simple run the command below to generate related ebooks
-
- $ ./makeebooks zh # default for .mobi
- $ export FORMAT=epub ;
- $ ./makeebooks zh # for epub
-
-## Ubuntu ##
-Ubuntu 11.04 (Natty) is verified, it should work in other version as well with slight changes.
-
- $ sudo apt-get install ruby calibre 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
-
-## Windows (not fixed) ##
-
-[RubyInstaller & DevKit](http://rubyinstaller.org/downloads/) is needed for ruby environment on windows, ruby 1.9 is verified, and "Git for windows" is used to provide unix environment.
-
- $ gem install rdiscount
- $ gem install ruby-debug19 # have problem
-
- Building native extensions. This could take a while...
- ERROR: Error installing ruby-debug19:
- ERROR: Failed to build gem native extension.
-
- c:/Ruby193/bin/ruby.exe extconf.rb
- checking for vm_core.h... no
- c:/Ruby193/lib/ruby/gems/1.9.1/gems/ruby_core_source-0.1.5/lib/ruby_core_source.rb:39: Use RbConfig instead of obsolet
- and deprecated Config.
- checking for vm_core.h... no
- *** extconf.rb failed ***
- ...
-
-[Calibre][calibre]'s command `ebook-convert` is under `calibre` directory, it should be added into your path, then the related ebook can be created.
-
-Then you should be able to generate pdf
-
- $ xvfb-run ./makeebooks zh # if no X-Windows
-
-## Fedora platform ##
-This is copied from [Pro Git][progit], not verified yet
-
-On Fedora you can run something like this::
-
- $ yum install ruby calibre rubygems ruby-devel rubygem-ruby-debug
- $ gem install rdiscount
- $ makeebooks en # will produce a mobi
-
+
[pandoc]: http://johnmacfarlane.net/pandoc/
[calibre]: http://calibre-ebook.com/
[progit]: http://github.com/progit/progit

0 comments on commit b255ad4

Please sign in to comment.