templates.txt
40 lines
| 1.3 KiB
| text/plain
|
TextLexer
Dan Villiom Podlaski Christiansen
|
r9999 | Mercurial allows you to customize output of commands through | ||
templates. You can either pass in a template from the command | ||||
line, via the --template option, or select an existing | ||||
template-style (--style). | ||||
You can customize output for any "log-like" command: log, | ||||
outgoing, incoming, tip, parents, heads and glog. | ||||
Dan Connolly <http://www.w3.org/People/Connolly/>
|
r11034 | Four styles are packaged with Mercurial: default (the style used | ||
when no explicit preference is passed), compact, changelog, | ||||
and xml. | ||||
Dan Villiom Podlaski Christiansen
|
r9999 | Usage:: | ||
$ hg log -r1 --style changelog | ||||
A template is a piece of text, with markup to invoke variable | ||||
expansion:: | ||||
$ hg log -r1 --template "{node}\n" | ||||
b56ce7b07c52de7d5fd79fb89701ea538af65746 | ||||
Strings in curly braces are called keywords. The availability of | ||||
keywords depends on the exact context of the templater. These | ||||
keywords are usually available for templating a log-like command: | ||||
Patrick Mezard
|
r13585 | .. keywordsmarker | ||
Dan Villiom Podlaski Christiansen
|
r9999 | |||
The "date" keyword does not produce human-readable output. If you | ||||
want to use a date in your output, you can use a filter to process | ||||
it. Filters are functions which return a string based on the input | ||||
Dirkjan Ochtman
|
r10759 | variable. Be sure to use the stringify filter first when you're | ||
applying a string-input filter to a list-like input variable. | ||||
You can also use a chain of filters to get the desired output:: | ||||
Dan Villiom Podlaski Christiansen
|
r9999 | |||
$ hg tip --template "{date|isodate}\n" | ||||
2008-08-21 18:22 +0000 | ||||
List of filters: | ||||
Patrick Mezard
|
r13591 | .. filtersmarker | ||