1 |
---------------------------------------------------------------------- |
2 |
Gpg4kde Web Site |
3 |
---------------------------------------------------------------------- |
4 |
|
5 |
INTRODUCTION: |
6 |
|
7 |
Getting the source: |
8 |
|
9 |
You can work on the website independently of the rest of gpg4kde. |
10 |
First check out the website from SVN repository: |
11 |
|
12 |
svn checkout svn+ssh://USER@svn.wald.intevation.org/gpg4kde/trunk/doc/website |
13 |
|
14 |
where USER is you name at wald.intevation.org. |
15 |
If you are not a member of the gpg4kde group at wald.intevation.org, |
16 |
you can also checkout anonymously: |
17 |
|
18 |
svn checkout https://svn.wald.intevation.org/gpg4kde/trunk/doc/website |
19 |
|
20 |
but of course you can not update the official website www.gpg4kde.org |
21 |
this way. |
22 |
|
23 |
|
24 |
File organisation: |
25 |
|
26 |
The .html files are build from the *.htm4 files using GNU m4. The |
27 |
*.htm4 files consist of mainly simple plain HTML and some macros |
28 |
implementing the overall page layout. |
29 |
|
30 |
The structure of the .htm4 files should be rather self explaining. |
31 |
|
32 |
|
33 |
BUILDING: |
34 |
|
35 |
Building the web site is _not_ incorporated into the autotools based |
36 |
build process. |
37 |
|
38 |
To build to web sites use |
39 |
|
40 |
make |
41 |
|
42 |
|
43 |
INSTALLING: |
44 |
|
45 |
To install the generated web site you need a gpg4kde docwriter or |
46 |
developer account on wald.intevation.org. |
47 |
|
48 |
Installing is done from within the "doc/website" directory, |
49 |
just type: |
50 |
|
51 |
make online |
52 |
|
53 |
You will have to enter the ssh password of your account at wald.intevation.org. |
54 |
|
55 |
If you are interested on web site management on wald.intevation.org |
56 |
in general, please read the online manual: |
57 |
http://wald.intevation.org/docman/view.php/1/34/project-websites.txt |
58 |
|
59 |
If you need the website as offline version for some other |
60 |
purposes just run: |
61 |
|
62 |
make -f buildhtml.mk tar |
63 |
|
64 |
After that you have the file "www.gpg4kde.org.tar.gz". |
65 |
|
66 |
TEMPLATES: |
67 |
|
68 |
template.m4 : Contains the definition of the main macros PAGE_START |
69 |
and PAGE_BOXES as well as some helper macros normally |
70 |
not used in the .htm4 files. Authors should not need to |
71 |
change this file. |
72 |
|
73 |
template_header.m4: Contains the actual page layout. This file is |
74 |
included by `template.m4'. Authors should not |
75 |
need to change this file, but if additional |
76 |
languages are added the navigation must be added |
77 |
in here. |
78 |
|
79 |
template_link_boxes_en.m4, |
80 |
template_link_boxes_de.m4: Contains the link boxes in the right |
81 |
column of the page. |