| Index: trunk/extensions/SemanticMaps/INSTALL |
| — | — | @@ -1,47 +1,56 @@ |
| 2 | 2 | [[Semantic Maps 0.7.3]] |
| 3 | 3 | |
| 4 | | -Make sure you have Semantic MediaWiki, Maps and Validator successfully installed before proceeding |
| 5 | | -withthe installation. Semantic Maps and Maps are always released together. This means you should |
| 6 | | -always use the same version of Maps as the one of Semantic Maps you have. For example Maps 0.3.4 |
| 7 | | -and Semantic Maps 0.3.4, but not Maps 0.2 and Semantic Maps 0.3. For the correct version of |
| 8 | | -Validator, see the INSTALL file of Maps. Once you have downloaded the code, place the 'SemanticMaps' |
| 9 | | -directory within your MediaWiki 'extensions' directory. Then add the following code to your |
| 10 | | -LocalSettings.php file after the lines that install Maps: |
| | 4 | +You can find a wiki version of this document, which includes various helpfull links, at |
| | 5 | +http://mapping.referata.com/wiki/Help:Installation#Semantic_Maps |
| 11 | 6 | |
| 12 | | -# Semantic Maps |
| | 7 | +Make sure you have Semantic MediaWiki, Maps and Validator successfully installed |
| | 8 | +before proceeding with the installation. Once you have downloaded the code, |
| | 9 | +place the 'SemanticMaps' directory within your MediaWiki 'extensions' directory. |
| | 10 | +Then add the following code to your LocalSettings.php file after the lines that install Maps: |
| | 11 | + |
| 13 | 12 | require_once( "$IP/extensions/SemanticMaps/SemanticMaps.php" ); |
| 14 | 13 | |
| 15 | | -The placement of the inclusion of Maps and Semantic Maps needs to be at a certain position. Hold |
| 16 | | -the following rules into account: |
| | 14 | +The placement of the inclusion of Maps and Semantic Maps needs to be at a certain position. |
| | 15 | +Hold the following rules into account: |
| 17 | 16 | * Maps needs to be included before Semantic Maps. |
| 18 | 17 | * Semantic MediaWiki needs to be included before Maps. |
| 19 | 18 | * Semantic Forms (if used) needs to be included before Maps (after SMW). |
| 20 | | -An example of a typical inclusion order: ..., SMW, ..., SF, ..., Validator, Maps, SM, ... |
| 21 | 19 | |
| 22 | | -Once you have successfully installed Semantic Maps, please add your wiki to the sites that use |
| 23 | | -Semantic Maps section [0]. |
| | 20 | +An example of a typical inclusion order: ..., SMW, ..., SF, ..., Maps, SM, ... |
| 24 | 21 | |
| 25 | | -=== Upgrading to 0.6 === |
| | 22 | +=== Installing 0.6 and above === |
| 26 | 23 | |
| 27 | | -Make sure you have upgraded SMW to version 1.5.1 before installing Semantic Maps 0.6! |
| | 24 | +This applies only to people installing version 0.6 or later. |
| 28 | 25 | |
| 29 | | -When upgrading to 0.6 from any previous version, you need to run the "database installation and upgrade" script in [http://semantic-mediawiki.org/wiki/Help:Installation#Upgrading_existing_installations Special:SMWAdmin]. Not doing this will result into fatal PHP errors. You will also need to run the "data repair and upgrade" script on the same page, which is required in order to store all coordinates so that Semantic Maps recognizes them. Not doing this will result into queries not returning any coordinates. |
| | 26 | +Once You installed Semantic Maps, go to Special:SMWAdmin and run "database installation and upgrade". |
| | 27 | +If you do not do this, geographic coordinates will not work properly, and you might encounters |
| | 28 | +database errors on pages using them anyway. |
| 30 | 29 | |
| | 30 | +=== Upgrading to 0.6 and above === |
| | 31 | + |
| | 32 | +This applies to everyone upgrading from the first Semantic Google Maps to Semantic Maps 0.5.5. |
| | 33 | + |
| | 34 | +Make sure you have upgraded SMW to version 1.5.1 or above before installing Semantic Maps 0.6! |
| | 35 | + |
| | 36 | +When upgrading to 0.6 from any previous version, you need to run the "database installation and upgrade" |
| | 37 | +script in Special:SMWAdmin. Not doing this will result into fatal PHP errors. You will also need to run |
| | 38 | +the "data repair and upgrade" script on the same page, which is required in order to store all |
| | 39 | +coordinates so that Semantic Maps recognizes them. Not doing this will result into queries not |
| | 40 | +returning any coordinates. |
| | 41 | + |
| 31 | 42 | === Upgrading from Semantic Google Maps === |
| 32 | 43 | |
| 33 | | -If you have Semantic Google Maps installed, and want to upgrade to Semantic Maps, these are the steps you need to follow: |
| | 44 | +If you have Semantic Google Maps installed, and want to upgrade to Semantic Maps, these are the |
| | 45 | +steps you need to follow: |
| 34 | 46 | |
| 35 | 47 | * Remove the SemanticGoogleMaps directory from your extension directory. |
| 36 | 48 | * Remove (when you use it) Google Geocoder in a similar fashion. |
| 37 | 49 | * Upload both Maps and Semantic Maps to your extension directory. |
| 38 | | -* Make sure your API keys are in the right place (the variable $wgGoogleMapsKey will need to be renamed, or copied, to $egGoogleMapsKey). |
| | 50 | +* Make sure your API keys are in the right place |
| | 51 | + (the variable $wgGoogleMapsKey will need to be renamed, or copied, to $egGoogleMapsKey). |
| 39 | 52 | * Change all #semantic_google_map parser functions with #display_point. |
| 40 | 53 | * Add parameter names to the value of the #display_point calls. |
| 41 | 54 | |
| 42 | | -After doing all these steps, you should be done. Maps and Semantic Maps are designed to be backward compatible with SGM, so all SGM code ''should'' work on Semantic Maps. If you encounter some problem though, please let the extension developers know. |
| 43 | | - |
| 44 | | - |
| 45 | | -More information can be found at [1]. |
| 46 | | - |
| 47 | | -[0] http://www.mediawiki.org/wiki/Extension:Semantic_Maps#Sites_that_use_Semantic_Maps |
| 48 | | -[1] http://mapping.referata.com/wiki/Semantic_Maps#Installation |
| \ No newline at end of file |
| | 55 | +After doing all these steps, you should be done. Maps and Semantic Maps are designed to be |
| | 56 | +backward compatible with SGM, so all SGM code ''should'' work on Semantic Maps. If you |
| | 57 | +encounter some problem though, please let the extension developers know. |
| Index: trunk/extensions/SemanticMaps/RELEASE-NOTES |
| — | — | @@ -8,7 +8,7 @@ |
| 9 | 9 | |
| 10 | 10 | |
| 11 | 11 | === Semantic Maps 0.7.3 === |
| 12 | | -(2010-11-xx) |
| | 12 | +(2010-11-30) |
| 13 | 13 | |
| 14 | 14 | ==== new features ==== |
| 15 | 15 | |