Mercurial > hgbook

changeset 765:d8c85d831fb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Merge with http://hg.serpentine.com/mercurial/book
author Dongsheng Song <songdongsheng@live.cn>
date Tue, 31 Mar 2009 21:17:59 +0800
parents 53f179393f5c (current diff) 88b611f37646 (diff)
children 3b33dd6aba87
files README README.BUILD stylesheets/base-html-stylesheet.xsl
diffstat 5 files changed, 132 insertions(+), 104 deletions(-) [+]
line wrap: on
line diff
--- a/README	Tue Mar 31 14:54:24 2009 +0800
+++ b/README	Tue Mar 31 21:17:59 2009 +0800
@@ -1,99 +1,16 @@
-HOW-TO:  Compiling the Mercurial Book
-======================================
-
-This Mercurial Book is written in DocBook 4.5.
-
-The goal of this document is to give simple instructions to anyone who
-wants to compile this book into a useful format, like HTML or PDF.  It
-should state *exactly* which tools to use, and how to invoke them, in
-simplest terms.
-
-Table of Contents:
-
-  I. PRIMER
- II. COMPILING THE DOCS
-III. HACKING ON THE DOCS
-
-I. PRIMER
-
-  DocBook has a tortured, confusing history.  Before you do anything,
-  take a look at Eric Raymond's excellent "DocBook Demystification HOWTO":
-
-      http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/
+Mercurial: The Definitive Guide
+-------------------------------
 
-  It's very short and clears up many things.
-
-
-II. COMPILING THE DOCS
-
-
-1. Install XML DTD and XSL stylesheets for DocBook
-
-      % sudo apt-get install docbook-xml docbook-xsl
-
-2. Install libxml2-utils
+Welcome to the source code for the book.  You can clone the definitive
+copy of the source tree using Mercurial as follows:
 
-      % sudo apt-get install libxml2-utils
-
-3. Install graph drawing tools
-
-      % sudo apt-get install graphviz inkscape
-
-4. Install pdf support
-
-      % sudo apt-get install openjdk-6-jdk docbook-xsl-saxon libsaxon-java fop
-
-  The Makefile will actually invoke tools/fop/fop.sh, you should do
-  some trick, let fop's CLASSPATH include saxon.jar and docbook-xsl-saxon.jar .
+  hg clone http://hg.serpentine.com/mercurial/book
 
-5. Make
-  Run 'make' for more details, for example:
-
-  * make all document(pdf, html and html-single for all languages)
-      % make all
-
-  * make english document(pdf, html and html-single for all languages)
-      % make LINGUA=en all
-
-  * make Chinese document(pdf, html and html-single for all languages)
-      % make LINGUA=zh all
-
-  * make Chinese pdf document
-      % make LINGUA=zh pdf
-
-III. HACKING ON THE DOCS
-
-In addition to everything in section II:
-
-
-1. Get a nice editing environment for SGML/XML.
-
-  This isn't strictly required, but it's nice when your editor
-  colorizes things, understands the DTD, tells you what tags you can
-  insert, etc.
+Here's a top-level tour of interesting directories:
 
-  If you use emacs, we recommend the PSGML major-mode.  Most free
-  operating systems package it, or its home page is here:
-
-      http://www.lysator.liu.se/projects/about_psgml.html
-
-  If you use vim, you might check out xmledit, at:
-
-      http://www.vim.org/scripts/script.php?script_id=301
-
-
-2. Get a validating parser.
-
-  Actually, if you have what you need to compile the documentation,
-  then you almost certainly have an XML validator installed already -
-  it is called xmllint, and comes as part of libxml2.
-
-  The makefile is preconfigured with a suitable invocation of it,
-  so simply run:
-
-      $ make validate
-
-3. Read about DocBook.
-
-  You'll want to get real intimate with a DocBook reference, such as
-  can be found at:  http://www.docbook.org/tdg/en/html/
+en        English-language content
+es        Spanish-language content
+examples  Miscellaneous example scripts
+tools     Old, largely unused conversion scripts
+web       Content and comment system for http://hgbook.red-bean.com/
+xsl       XSLT scripts for generating HTML
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.BUILD	Tue Mar 31 21:17:59 2009 +0800
@@ -0,0 +1,99 @@
+HOW-TO:  Compiling the Mercurial Book
+======================================
+
+This Mercurial Book is written in DocBook 4.5.
+
+The goal of this document is to give simple instructions to anyone who
+wants to compile this book into a useful format, like HTML or PDF.  It
+should state *exactly* which tools to use, and how to invoke them, in
+simplest terms.
+
+Table of Contents:
+
+  I. PRIMER
+ II. COMPILING THE DOCS
+III. HACKING ON THE DOCS
+
+I. PRIMER
+
+  DocBook has a tortured, confusing history.  Before you do anything,
+  take a look at Eric Raymond's excellent "DocBook Demystification HOWTO":
+
+      http://tldp.org/HOWTO/DocBook-Demystification-HOWTO/
+
+  It's very short and clears up many things.
+
+
+II. COMPILING THE DOCS
+
+
+1. Install XML DTD and XSL stylesheets for DocBook
+
+      % sudo apt-get install docbook-xml docbook-xsl
+
+2. Install libxml2-utils
+
+      % sudo apt-get install libxml2-utils
+
+3. Install graph drawing tools
+
+      % sudo apt-get install graphviz inkscape
+
+4. Install pdf support
+
+      % sudo apt-get install openjdk-6-jdk docbook-xsl-saxon libsaxon-java fop
+
+  The Makefile will actually invoke tools/fop/fop.sh, you should do
+  some trick, let fop's CLASSPATH include saxon.jar and docbook-xsl-saxon.jar .
+
+5. Make
+  Run 'make' for more details, for example:
+
+  * make all document(pdf, html and html-single for all languages)
+      % make all
+
+  * make english document(pdf, html and html-single for all languages)
+      % make LINGUA=en all
+
+  * make Chinese document(pdf, html and html-single for all languages)
+      % make LINGUA=zh all
+
+  * make Chinese pdf document
+      % make LINGUA=zh pdf
+
+III. HACKING ON THE DOCS
+
+In addition to everything in section II:
+
+
+1. Get a nice editing environment for SGML/XML.
+
+  This isn't strictly required, but it's nice when your editor
+  colorizes things, understands the DTD, tells you what tags you can
+  insert, etc.
+
+  If you use emacs, we recommend the PSGML major-mode.  Most free
+  operating systems package it, or its home page is here:
+
+      http://www.lysator.liu.se/projects/about_psgml.html
+
+  If you use vim, you might check out xmledit, at:
+
+      http://www.vim.org/scripts/script.php?script_id=301
+
+
+2. Get a validating parser.
+
+  Actually, if you have what you need to compile the documentation,
+  then you almost certainly have an XML validator installed already -
+  it is called xmllint, and comes as part of libxml2.
+
+  The makefile is preconfigured with a suitable invocation of it,
+  so simply run:
+
+      $ make validate
+
+3. Read about DocBook.
+
+  You'll want to get real intimate with a DocBook reference, such as
+  can be found at:  http://www.docbook.org/tdg/en/html/
--- a/stylesheets/base-html-stylesheet.xsl	Tue Mar 31 14:54:24 2009 +0800
+++ b/stylesheets/base-html-stylesheet.xsl	Tue Mar 31 21:17:59 2009 +0800
@@ -114,7 +114,14 @@
   </xsl:template>
 
   <xsl:template name="user.footer.navigation">
-    <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script>
-    <script type="text/javascript">_uacct = "UA-1805907-3"; urchinTracker();</script>
+    <script type="text/javascript">
+    var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+    document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+    </script>
+    <script type="text/javascript">
+    try {
+    var pageTracker = _gat._getTracker("UA-1805907-5");
+    pageTracker._trackPageview();
+    } catch(err) {}</script>
   </xsl:template>
 </xsl:stylesheet>
--- a/web/hgbook/comments/feeds.py	Tue Mar 31 14:54:24 2009 +0800
+++ b/web/hgbook/comments/feeds.py	Tue Mar 31 21:17:59 2009 +0800
@@ -8,9 +8,9 @@
     
 class Comments(Feed):
     feed_type = MyAtomFeed
-    title = 'Real World Haskell: recent comments'
-    subtitle = ('Recent comments on the text of &#8220;Real World '
-                'Haskell&#8221;, from our readers')
+    title = 'Mercurial - The Definitive Guide: recent comments'
+    subtitle = ('Recent comments on the text of &#8220;Mercurial: The '
+                'Definitive Guide&#8221;, from our readers')
     link = '/feeds/comments/'
     author_name = 'Our readers'
 
--- a/web/hgbook/templates/boilerplate.html	Tue Mar 31 14:54:24 2009 +0800
+++ b/web/hgbook/templates/boilerplate.html	Tue Mar 31 21:17:59 2009 +0800
@@ -24,9 +24,14 @@
 	  href="http://mattahan.deviantart.com/">Mattahan</a>.</p>
     </div>
 
-    <script src="http://www.google-analytics.com/urchin.js"
-      type="text/javascript"></script>
-    <script type="text/javascript">_uacct = "UA-1805907-3";
-      urchinTracker();</script>
+    <script type="text/javascript">
+    var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
+    document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
+    </script>
+    <script type="text/javascript">
+    try {
+    var pageTracker = _gat._getTracker("UA-1805907-5");
+    pageTracker._trackPageview();
+    } catch(err) {}</script>
   </body>
 </html>