Revision: 43813 Author: mkroetzsch Date: 2008-11-21 13:38:05 +0000 (Fri, 21 Nov 2008)
Log Message: ----------- updated files to SMW 1.4.0 release Modified Paths: -------------- trunk/extensions/SemanticMediaWiki/INSTALL trunk/extensions/SemanticMediaWiki/RELEASE-NOTES Modified: trunk/extensions/SemanticMediaWiki/INSTALL =================================================================== --- trunk/extensions/SemanticMediaWiki/INSTALL 2008-11-21 13:20:27 UTC (rev 43812) +++ trunk/extensions/SemanticMediaWiki/INSTALL 2008-11-21 13:38:05 UTC (rev 43813) @@ -1,4 +1,4 @@ -[[Semantic MediaWiki 1.4d Version for Alpha-Testers!]] +[[Semantic MediaWiki 1.4.0]] Install instructions for the latest SMW version are also online in a more convenient format for reading: @@ -34,12 +34,12 @@ == Requirements == -* MediaWiki 1.11.* or greater (tested from 1.11.0 to 1.14alpha (r40427)). +* MediaWiki 1.11.* or greater (tested from 1.11.0 to 1.14alpha (r43727)). * PHP 5.x or greater installed and working * MySQL >= 4.0.14 (version required by MediaWiki) Notes: -* SMW 1.2 currently has no Postgres support. It could be done if someone cares +* SMW 1.4 currently has no Postgres support. It could be done if someone cares to support this action. * SMW uses the PHP mb_*() multibyte functions such as mb_strpos in the php_mbstring.dll extension. This is standard but not enabled by default on @@ -81,29 +81,25 @@ It is no problem to access a site by more than one servername in any case. If you have custom namespaces (such as "Portal"), read the note below. (3) In your wiki, log in as a user with admin status and go to the page - "Special:SMWAdmin" to do the final setup steps. This can also be done with - a command-line php script. See [SMW_path]/maintenance/README for details. - Please consider announcing your new site to the SMW semantic wiki list by - using the according button on "Special:SMWAdmin". + "Special:SMWAdmin" to do the final setup steps. Two steps are needed: at + first, trigger the database setup ("Database installation and upgrade"). + Afterwards, activate the automatic data update ("Data repair and upgrade"). + Note that the first step requires persmissions to alter/create database + tables, as explained in the above note. The second step takes some time; + go to Special:SMWAdmin to follow its progress. - Note that this requires persmissions to alter/create database tables, as - explained in the above note. + Both of those actions can also be accomplished with the command-line PHP + scripts SMW_setup.php and SMW_refreshData.php. Read the documentation in + [SMW_path]/maintenance/README for details on how to run such scripts. -(4) If you already have categories in your wiki, they will not immediately be - available for SMW queries. Category information becomes available if a - page in a category is edited next time. To make all information available - immediately, run the script [SMW_path]/maintenance/SMW_refreshData.php - as described in [SMW_path]/maintenance/README. - '''Remark:''' Semantic MediaWiki uses ten additional namespace indexes (see http://meta.wikimedia.org/wiki/Help:Custom_namespaces), in the range from 100 to 109. 100 and 101 are only needed if $smwgSMWBetaCompatible is set. -106 and 107 are reserved for the SemanticForms extension and not used by SMW. -If you have your own custom namespaces, you have to set the parameter -$smwgNamespaceIndex before including SMW_Settings.php. See the documentation -$within SMW_Settings.php for details. If you add more namespaces later on, -then you have to assign them to higher numbers than those used by Semantic -MediaWiki. +106 and 107 are reserved for the SemanticForms extension. If you have your own +custom namespaces, you have to set the parameter $smwgNamespaceIndex before +including SMW_Settings.php. See the documentation $within SMW_Settings.php for +details. If you add more namespaces later on, then you have to assign them to +higher numbers than those used by Semantic MediaWiki. There is currently no working Postgres support. If you need that, please contact the developers and support them in adjusting SMW appropriately. @@ -131,22 +127,9 @@ === Customising Semantic MediaWiki === -Semantic MediaWiki can be customised by a number of settings. To do so, you -can set respective parameters somewhere below the line -"include_once('extensions/SemanticMediaWiki/includes/SMW_Settings.php');" -in your LocalSetting.php. For example, one can write +Semantic MediaWiki can be customised by a number of settings. The available +options are detailed in http://semantic-mediawiki.org/wiki/Help:Configuration - include_once('extensions/SemanticMediaWiki/includes/SMW_Settings.php'); - $smwgQDefaultLimit = 20; - enableSemantics('example.org'); - -to have only 20 results of inline queries being shown by default. The -parameters that are available are documented in the file SMW_Settings.php. Do -not change this file directly, but put adoptions into your LocalSettings.php. - -Further options are explained at -http://semantic-mediawiki.org/wiki/Help:Configuration - === Running SMW on older versions of MediaWiki === If your site is still running on PHP4, SMW is not supported. It would hardly @@ -158,31 +141,33 @@ == Upgrading existing installations == -SMW 1.3 does not require major steps for upgrading from SMW 1.2. You can follow -the same steps as for new installations above (you just do not need to edit -LocalSettings.php). Especially, you must trigger the SMW database setup via -Special:SMWAdmin or using the script SMW_setup.php. Further actions may be -required only if one of the following applies to you. +(Please read all of this before upgrading) -If you still use a version before SMW 1.2, or if you use SMW 1.3 manually set -to use the old store "SMWSQLStore" or "SMWRAPStore", then follow the upgrading -instructions given at -http://semantic-mediawiki.org/wiki/Help:Installation_1.2#Notes_on_Upgrading, -or SMW will not be working any more. If you have a version that is even older -than SMW 1.0, then read the installation steps given for your version in the -installation instructions for SMW 1.1: -http://semantic-mediawiki.org/wiki/Help:Installation_1.1#Notes_on_Upgrading +Existing SMW installations that already use the default store (SMWSQLStore2) +can simply follow the above installation steps. This covers all sites with SMW +1.2 to 1.3 that do not use a special setting to switch back to the old store +("SMWSQLStore" or "SMWRAPStore"). In these cases the new data upgrade feature +("will ensure that your data is refreshed to the new version. To speed up the +update, use MediaWiki's script runJobs.php. -If you use imported vocabulary, you will have to re-store the data for all -pages that use the property imported from. This can often be done manually by -just editing those (typically few) pages. If there are many affected pages, use -the script to repair all data at once. +Older SMW versions or SMW versions that use the old store can upgrade in the +same fashion, but first need to remove any setting that configures SMW to +use the old store. Again, all data will immediately be availabel when the data +upgrade has finished. -If you use concepts, then it might be useful to re-store the data for the -concept pages, but only if you are interested in using the new concept caching -features of SMW. Otherwise concepts will also continue to work normally without -taking any actions. +Directly after enabling SMW 1.4.0, it can potentially happen that the site +shows SQL errors due to background jobs trying to access the new DB structure +even before you intialised it. This can even block you from reaching SMWAdmin. +In this case, either use the script SMW_setup.php from the command-line, or +access your database and delete all entries in the table "job". After this, no +errors should show up while accessing the special page for initalisation. +Extensions of SMW (e.g. Semantic Forms) need to be updated to a version that is +compatible with SMW 1.4. See your extension homepage for details. If you use +format timeline (or eventline) in inline queries, then you need to install the +new extension SemanticResultFormats (SRF). Timeline has been migrated to this +extension package. + === Changed configuration options === Some configuration options (used in LocalSettings.php) have changed since SMW @@ -190,7 +175,7 @@ following list gives the version in which a setting was first introduced, so it can be ignored if you already run this version or a more recent one. -* [1.3] Since SMW 1.3, the Factbox is hidden by default and will only appear. +* [1.3] Since SMW 1.3, the Factbox is hidden by default and will not appear. As a compensation, the toolbox (usually on the left below the search field) shows a link to Special:Browse. To use the display behaviour of the Factbox as it was before SMW 1.3, set $smwgShowFactbox = SMW_FACTBOX_NONEMPTY; The new Modified: trunk/extensions/SemanticMediaWiki/RELEASE-NOTES =================================================================== --- trunk/extensions/SemanticMediaWiki/RELEASE-NOTES 2008-11-21 13:20:27 UTC (rev 43812) +++ trunk/extensions/SemanticMediaWiki/RELEASE-NOTES 2008-11-21 13:38:05 UTC (rev 43813) @@ -1,5 +1,28 @@ For a documentation of all features, see http://semantic-mediawiki.org +== SMW 1.4.0 == + +See http://semantic-mediawiki.org/wiki/SMW_1.4.0 + +* Easier installation, upgrade, repair: + Special:SMWAdmin now has a control for refreshing the wiki data online. +* Better Type:Date + ** much larger range of dates, covering all of human history + ** internationalisation, support for localised date formats in input + ** support for single year numbers in dates + ** incomplete dates handled properly +* Query for page modification date using Property:Modification_date +* Full integration of "special properties" such as Property:Has_type + ** can be queried in #ask, and printed in printouts + ** usable in all browsing interfaces + ** display uses of properties on property page +* Improved parsing process + ** avoid data loss in unusual circumstances + ** much better compatibility with other parser extensions +* Shorter and cleaner code +* Extended translations +* Many bugfixes + == Semantic MediaWiki 1.3 == See http://semantic-mediawiki.org/wiki/SMW_1.3 _______________________________________________ MediaWiki-CVS mailing list MediaWiki-CVS@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-cvs