|
155
|
1 ----------------------------------------------------------------------
|
|
|
2 mapWOC Web Site
|
|
|
3 ----------------------------------------------------------------------
|
|
|
4
|
|
|
5 INTRODUCTION:
|
|
|
6
|
|
|
7 Getting the source:
|
|
|
8
|
|
|
9 You can work on the website independently of the rest of mapWOC.
|
|
|
10 First check out the website from SVN repository:
|
|
|
11
|
|
|
12 svn checkout svn+ssh://USER@svn.wald.intevation.org/mapWOC/trunk/doc/website
|
|
|
13
|
|
|
14 where USER is you name at wald.intevation.org.
|
|
|
15 If you are not a member of the mapWOC project at wald.intevation.org,
|
|
|
16 you can also checkout anonymously:
|
|
|
17
|
|
|
18 svn checkout https://svn.wald.intevation.org/mapWOC/trunk/doc/website
|
|
|
19
|
|
|
20 but of course you can not update the official website www.mapWOC.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 WARNING: you might need a latin1 locale for m4 to work correctly.
|
|
|
38
|
|
|
39 To build to web sites use the file `buildhtml.mk':
|
|
|
40
|
|
|
41 make -f buildhtml.mk
|
|
|
42
|
|
|
43
|
|
|
44 INSTALLING:
|
|
|
45
|
|
|
46 To install the generated web site you need a mapWOC docwriter or
|
|
|
47 developer account on wald.intevation.org.
|
|
|
48
|
|
|
49 Installing is done from within the "doc/website" directory,
|
|
|
50 just type:
|
|
|
51
|
|
|
52 make -f buildhtml.mk online
|
|
|
53
|
|
|
54 You will have to enter the ssh password of your account at wald.intevation.org.
|
|
|
55
|
|
|
56 If you are interested on web site management on wald.intevation.org
|
|
|
57 in general, please read the online manual:
|
|
|
58 http://wald.intevation.org/docman/view.php/1/34/project-websites.txt
|
|
|
59
|
|
|
60 If you need the website as offline version for some other
|
|
|
61 purposes just run:
|
|
|
62
|
|
|
63 make -f buildhtml.mk tar
|
|
|
64
|
|
|
65 After thar you have the file "www.mapWOC.org.tar.gz".
|
|
|
66
|
|
|
67 TEMPLATES:
|
|
|
68
|
|
|
69 template.m4 : Contains the definition of the main macros PAGE_START
|
|
|
70 and PAGE_BOXES as well as some helper macros normally
|
|
|
71 not used in the .htm4 files. Authors should not need to
|
|
|
72 change this file.
|
|
|
73
|
|
|
74 template_header.m4: Contains the actual page layout. This file is
|
|
|
75 included by `template.m4'. Authors should not
|
|
|
76 need to change this file, but if additional
|
|
|
77 languages are added the navigation must be added
|
|
|
78 in here.
|
