comparison README.txt @ 92:bfab7367eb56

add some more documentation tidbits
author Jeff Hammel <jhammel@mozilla.com>
date Mon, 10 Jan 2011 21:49:43 -0800
parents 672d2d3ee322
children 3eb34cad5858
comparison
equal deleted inserted replaced
91:672d2d3ee322 92:bfab7367eb56
12 12
13 And this is the time of the iceberg. If it really is a one-off, who 13 And this is the time of the iceberg. If it really is a one-off, who
14 cares? But quickly one-offs become a deployment story, and not a very 14 cares? But quickly one-offs become a deployment story, and not a very
15 efficient one. 15 efficient one.
16 16
17
18 Making a New Template
19 ---------------------
20
21
17 Variable Conventions 22 Variable Conventions
18 -------------------- 23 --------------------
19 24
20 MakeItSo! provides a few variables for you. You can include another 25 MakeItSo! provides a few variables for you. You can include another
21 file or URL using {{include(URI)}}, where URI is the file path or the 26 file or URL using {{include(URI)}}, where URI is the file path or the
25 Files and URLS being interpolated also have the variable %(here)s, 30 Files and URLS being interpolated also have the variable %(here)s,
26 which is the parent of their resource. Therefor, using sensible path 31 which is the parent of their resource. Therefor, using sensible path
27 conventions, a neighboring file may be (e.g.) included like 32 conventions, a neighboring file may be (e.g.) included like
28 33
29 {{include(here + 'foo.txt')}} 34 {{include(here + 'foo.txt')}}
35
36 The python template asserts several conventions:
37
38 - project: the project chosen
39 - author: author of a project
40 - email: author's email
41 - url: url of the project
42
43
44 Adding a License to a Template
45 ------------------------------
46
47 [TODO]
48
49
50 Web Service
51 -----------
52
53 python has the ability to run files from stdin. This means you can
54 run makeitso directly from the web::
55
56 python <(curl http://k0s.org/mozilla/hg/MakeItSo/raw-file/tip/makeitso/makeitso.py) [URI]
57
58 This uses the bash shell. If you have another shell you may have to
59 use another syntax, download the file, or install the package.