| 1 |
General Information |
| 2 |
=================== |
| 3 |
|
| 4 |
This is CTPL version 0.3.5. CTPL (which stands for C Template (Parser) |
| 5 |
Library) is a template engine library written in C and distributed under the |
| 6 |
terms of the GNU GPL. It allows fast and easy parsing of templates and fine |
| 7 |
control over template parsing environment. |
| 8 |
|
| 9 |
More information can be found on-line at the official website: |
| 10 |
http://ctpl.tuxfamily.org/ |
| 11 |
|
| 12 |
Installation |
| 13 |
============ |
| 14 |
|
| 15 |
You need the following packages to build CTPL: |
| 16 |
- libglib (http://www.gtk.org/) |
| 17 |
- libgio (http://www.gtk.org/) |
| 18 |
- pkg-config (http://www.freedesktop.org/software/pkgconfig/) |
| 19 |
- A working C compiler (GCC for example, http://gcc.gnu.org/) |
| 20 |
- A make utility (GNU make (http://www.gnu.org/software/make) is recommended) |
| 21 |
|
| 22 |
You may also want the following packages that enables extra features: |
| 23 |
- gio-unix GIO module (http://www.gtk.org/) is needed for the ctpl command-line |
| 24 |
tool. It generally comes together with GIO on platforms that supports it. |
| 25 |
- gtk-doc (http://www.gtk.org/) if you want to (re)build the documentation |
| 26 |
|
| 27 |
For detailed installation instructions, see the INSTALL file. |
| 28 |
|
| 29 |
If you are working on Windows, you may want to consider using the alternate |
| 30 |
build system, see below. |
| 31 |
|
| 32 |
Optional features |
| 33 |
----------------- |
| 34 |
|
| 35 |
You can explicitly enable or disable building of the command-line tool by giving |
| 36 |
the --enable-cli-tool or --disable-cli-tool argument to configure. |
| 37 |
|
| 38 |
|
| 39 |
Alternate installation, Waf |
| 40 |
=========================== |
| 41 |
|
| 42 |
There is an alternate build system that use Waf (http://code.google.com/p/waf/). |
| 43 |
This build system is not very well supported and have some lacks but it is easy |
| 44 |
to use on MS Windows where Autotools-based build systems are often harder to get |
| 45 |
working. |
| 46 |
|
| 47 |
Dependencies with this build system are the same than with the standard one, |
| 48 |
except that Make is not needed, but you need Python >= 2.4 |
| 49 |
(http://www.python.org). |
| 50 |
|
| 51 |
Everything (should) work, except building the documentation from source. |
| 52 |
Documentation can be installed if it is already build, but it cannot be |
| 53 |
generated from sources for now. You then either need to generate it with the |
| 54 |
standard build system or to get it pre-generated (it can be found pre-generated |
| 55 |
in release tarballs) if you want it. |
| 56 |
|
| 57 |
To configure, build and install CTPL with the Waf build system, do the |
| 58 |
following (on Windows, prefix with the path to Python): |
| 59 |
./waf configure --prefix=/where/you/want/to/install |
| 60 |
./waf build |
| 61 |
# Gain administrator rights if needed |
| 62 |
./waf install |