Mercurial > mxd2map
annotate website/README @ 306:ea3fde77ea48
Catch generic Exceptions to avoid leaking them and creating
silent errors
| author | Andre Heinecke <aheinecke@intevation.de> |
|---|---|
| date | Thu, 06 Sep 2012 18:56:20 +0200 |
| parents | dd4bb5869f86 |
| children |
| rev | line source |
|---|---|
| 155 | 1 ---------------------------------------------------------------------- |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
2 MXD2map Web Site |
| 155 | 3 ---------------------------------------------------------------------- |
| 4 | |
| 5 INTRODUCTION: | |
| 6 | |
| 7 Getting the source: | |
| 8 | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
9 You can work on the website independently of the rest of MXD2map. |
| 155 | 10 First check out the website from SVN repository: |
| 11 | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
12 svn checkout svn+ssh://USER@svn.wald.intevation.org/MXD2map/trunk/doc/website |
| 155 | 13 |
| 14 where USER is you name at wald.intevation.org. | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
15 If you are not a member of the MXD2map project at wald.intevation.org, |
| 155 | 16 you can also checkout anonymously: |
| 17 | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
18 svn checkout https://svn.wald.intevation.org/MXD2map/trunk/doc/website |
| 155 | 19 |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
20 but of course you can not update the official website www.MXD2map.org |
| 155 | 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 | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
46 To install the generated web site you need a MXD2map docwriter or |
| 155 | 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 | |
|
162
dd4bb5869f86
replaced mapWOC with MXD2map
Stephan Holl <stephan.holl@intevation.de>
parents:
159
diff
changeset
|
65 After thar you have the file "www.MXD2map.org.tar.gz". |
| 155 | 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. |