forked from abw/Template2
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
233 lines (152 loc) · 7.2 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
Template Toolkit
Version 2.24
February 2012
Copyright (C) 1996-2012 Andy Wardley. All Rights Reserved
This is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
QUICK INSTALL
-------------
If you have the CPAN module installed then you can install the Template
Toolkit like this from the command line:
$ cpan Template
Otherwise you can install from source code. The latest version of the Template
Toolkit can be retrieved from:
http://www.cpan.org/modules/by-module/Template/
Fetch and install AppConfig 1.56 if you don't already have it installed.
Available from CPAN in:
http://www.cpan.org/authors/Andy_Wardley/
To install the Template Toolkit from the command line:
$ tar zxf Template-Toolkit-2.24.tar.gz
$ cd Template-Toolkit-2.24
$ perl Makefile.PL
$ make
$ make test
$ make install
The Makefile.PL will prompt for any additional configuration options.
For further details, see the sections below on CONFIGURATION, BUILDING
AND TESTING, and INSTALLATION. The Template Toolkit web site also has
further information about installation.
http://template-toolkit.org/download/index.html
PREREQUISITES
-------------
The Template Toolkit is written entirely in Perl and should run on any
platform on which Perl is available. It requires Perl 5.006 or later.
The 'ttree' utility uses the AppConfig module (version 1.56 or above)
for parsing command line options and configuration files. It is
available from CPAN:
http://www.cpan.org/authors/Andy_Wardley/
The Template Toolkit implements a "plugin" architecture which allow
you to incorporate the functionality of virtually any Perl module into
your templates. A number of plugin modules are included with the
distribution for adding extra functionality or interfacing to external
CPAN modules. You don't need to install any of these external modules
unless you plan to use those particular plugins. See Template::Plugins
and Template::Manual::Plugins for further details.
OBTAINING AND INSTALLING THE TEMPLATE TOOLKIT
---------------------------------------------
The latest release version of the Template Toolkit can be downloaded
from any CPAN site:
http://www.cpan.org/modules/by-module/Template/
Interim and development versions may also be available, along with
other useful information, news, publications, mailing list archives,
etc., from the Template Toolkit web site:
http://template-toolkit.org/
The Template Toolkit is distributed as a gzipped tar archive file:
Template-Toolkit-<version>.tar.gz
where <version> represents the current version number, e.g. 2.24.
To install the Template Toolkit, unpack the distribution archive to
create an installation directory. Something like this:
$ tar zxf Template-Toolkit-2.24.tar.gz
or
$ gunzip Template-Toolkit-2.24.tar.gz
$ tar xf Template-Toolkit-2.24.tar
You can then 'cd' into the directory created,
$ cd Template-Toolkit-2.24
and perform the usual Perl installation procedure:
$ perl Makefile.PL
$ make
$ make test
$ make install # may need root access
The Makefile.PL performs various sanity checks and then prompts for a
number of configuration items. The following CONFIGURATION section
covers this in greater detail.
If you choose to install the optional components then you may need to
perform some post-installation steps to ensure that the template
libraries, HTML documentation and examples can be correctly viewed via
your web browser. The INSTALLATION section covers this.
INSTALLING ON MICROSOFT WIN32 PLATFORMS
---------------------------------------
For advice on using Perl under Microsoft Windows, have a look here:
http://win32.perl.org/
If you're using Strawberry Perl then you can install the Template
Toolkit using the CPAN module as described above.
If you're using ActivePerl then you can install it using the Perl Package
Manager (ppm) with the pre-compiled packages built by Chris Winters. For
further details, see:
http://openinteract.sourceforge.net/
http://activestate.com/
If you prefer, you can manually install the Template Toolkit on Win32
systems by following the instructions in this installation guide.
However, please note that you are likely to encounter problems using
'make' and should instead download and use 'nmake' as a replacement.
This is available from Microsoft's ftp site.
ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe
In this case, you should substitute 'nmake' for 'make' in all the
instructions contained herein.
CONFIGURATION
-------------
This section covers the configuration of the Template Toolkit via
the Makefile.PL program. If you've successfully run this and didn't
have any problems answering any of the questions then you probably
don't need to read this section.
The Makefile.PL Perl program performs the module configuration and
generates the Makefile which can then be used to build, test and
install the Template Toolkit.
$ perl Makefile.PL
The Template Toolkit now boasts a high-speed implementation of
Template::Stash written in XS. You can choose to build this as
an optional module for using explicitly as an alternative to
the regular pure-perl stash module. In additional, you can opt
to use the XS Stash as the default, typically making the Template
Toolkit run twice as fast!
When prompted, answer 'y' or 'n' to build and optionally use
the XS Stash module by default:
Do you want to build the XS Stash module? [y]
Do you want to use the XS Stash for all Templates? [n]
BUILDING AND TESTING
--------------------
This section describes the "make" and "make test" commands which build
and test the Template Toolkit. If you ran these without incident,
then you can probably skip this section.
The 'make' command will build the Template Toolkit modules in the
usual manner.
make
The 'make test' command runs the test scripts in the 't' subdirectory.
make test
You can set the TEST_VERBOSE flag when running 'make test' to see the
results of the individual tests:
make test TEST_VERBOSE=1
INSTALLATION
------------
This section describes the final installation of the Template Toolkit
via the "make install" and covers any additional steps you may need to
take if you opted to build the HTML documentation and/or examples.
The 'make install' will install the modules and scripts on your
system. You may need administrator privileges to perform this task.
Alternately you can can install the Template Toolkit to a local
directory (see ExtUtils::MakeMaker for full details), e.g.
$ perl Makefile.PL PREFIX=/home/abw/
Don't forget to update your PERL5LIB environment variable if you do
this, or add a line to your script to tell Perl where to find the files,
e.g.
use lib qw( /home/abw/lib/perl5/site_perl/5.10.0 );
AUTHOR
------
The Template Toolkit was written by Andy Wardley <[email protected]> with
the invaluable assistance and contributions from many other people.
See Template::Manual::Credits for details.
COPYRIGHT
---------
Copyright (C) 1996-2012 Andy Wardley. All Rights Reserved.
This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.