Mercurial > mxd2map
comparison README @ 155:5a882b5773c9
initial website.
| author | Emanuel Schuetze <emanuel@intevation.de> |
|---|---|
| date | Wed, 30 Mar 2011 15:51:06 +0200 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 155:5a882b5773c9 |
|---|---|
| 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. |