hgbook

diff en/ch10-template.xml @ 654:1c13ed2130a7

Merge with http://hg.serpentine.com/mercurial/book
author Dongsheng Song <dongsheng.song@gmail.com>
date Mon Mar 30 16:23:33 2009 +0800 (2009-03-30)
parents 7e7c47481e4f 4ce9d0754af3
children ef53d025f410
line diff
     1.1 --- a/en/ch10-template.xml	Fri Mar 20 16:43:35 2009 +0800
     1.2 +++ b/en/ch10-template.xml	Mon Mar 30 16:23:33 2009 +0800
     1.3 @@ -1,6 +1,6 @@
     1.4  <!-- vim: set filetype=docbkxml shiftwidth=2 autoindent expandtab tw=77 : -->
     1.5  
     1.6 -<chapter id="chap.template">
     1.7 +<chapter id="chap:template">
     1.8    <?dbhtml filename="customizing-the-output-of-mercurial.html"?>
     1.9    <title>Customising the output of Mercurial</title>
    1.10  
    1.11 @@ -10,7 +10,7 @@
    1.12      command, or to customise the entire appearance of the built-in web
    1.13      interface.</para>
    1.14  
    1.15 -  <sect1 id="sec.style">
    1.16 +  <sect1 id="sec:style">
    1.17      <title>Using precanned output styles</title>
    1.18  
    1.19      <para id="x_579">Packaged with Mercurial are some output styles that you can
    1.20 @@ -107,7 +107,7 @@
    1.21        <emphasis>escape sequence</emphasis>, telling Mercurial to print
    1.22        a newline at the end of each template item.  If you omit this
    1.23        newline, Mercurial will run each piece of output together.  See
    1.24 -      section <xref linkend="sec.template.escape"/> for more details
    1.25 +      <xref linkend="sec:template:escape"/> for more details
    1.26        of escape sequences.</para>
    1.27  
    1.28      <para id="x_587">A template that prints a fixed string of text all the time
    1.29 @@ -121,14 +121,13 @@
    1.30        been replaced in the output with the description of each
    1.31        changeset.  Every time Mercurial finds text enclosed in curly
    1.32        braces (<quote><literal>{</literal></quote> and
    1.33 -      <quote><literal>}</literal></quote>), it will try to replace the braces
    1.34 -      and text with the expansion of whatever is inside.  To print a
    1.35 -      literal curly brace, you must escape it, as described in section
    1.36 -      <xref
    1.37 -	linkend="sec.template.escape"/>.</para>
    1.38 -
    1.39 -  </sect1>
    1.40 -  <sect1 id="sec.template.keyword">
    1.41 +      <quote><literal>}</literal></quote>), it will try to replace the
    1.42 +      braces and text with the expansion of whatever is inside.  To
    1.43 +      print a literal curly brace, you must escape it, as described in
    1.44 +      <xref linkend="sec:template:escape"/>.</para>
    1.45 +
    1.46 +  </sect1>
    1.47 +  <sect1 id="sec:template:keyword">
    1.48      <title>Common template keywords</title>
    1.49  
    1.50      <para id="x_589">You can start writing simple templates immediately using the
    1.51 @@ -149,8 +148,8 @@
    1.52  	  Date information.  The date when the changeset was
    1.53  	  committed.  This is <emphasis>not</emphasis> human-readable;
    1.54  	  you must pass it through a filter that will render it
    1.55 -	  appropriately.  See section <xref
    1.56 -	    linkend="sec.template.filter"/> for more information
    1.57 +	  appropriately.  See <xref
    1.58 +	    linkend="sec:template:filter"/> for more information
    1.59  	  on filters. The date is expressed as a pair of numbers.  The
    1.60  	  first number is a Unix UTC timestamp (seconds since January
    1.61  	  1, 1970); the second is the offset of the committer's
    1.62 @@ -197,13 +196,12 @@
    1.63      <para id="x_596">As we noted above, the date keyword does not produce
    1.64        human-readable output, so we must treat it specially.  This
    1.65        involves using a <emphasis>filter</emphasis>, about which more
    1.66 -      in section <xref
    1.67 -	linkend="sec.template.filter"/>.</para>
    1.68 +      in <xref linkend="sec:template:filter"/>.</para>
    1.69  
    1.70      &interaction.template.simple.datekeyword;
    1.71  
    1.72    </sect1>
    1.73 -  <sect1 id="sec.template.escape">
    1.74 +  <sect1 id="sec:template:escape">
    1.75      <title>Escape sequences</title>
    1.76  
    1.77      <para id="x_597">Mercurial's templating engine recognises the most commonly
    1.78 @@ -245,7 +243,7 @@
    1.79        it.</para>
    1.80  
    1.81    </sect1>
    1.82 -  <sect1 id="sec.template.filter">
    1.83 +  <sect1 id="sec:template:filter">
    1.84      <title>Filtering keywords to change their results</title>
    1.85  
    1.86      <para id="x_5a0">Some of the results of template expansion are not