Semantic MediaWiki 1.6.1 | |
---|---|
Release date: | August 20, 2011 |
Previous version: | Semantic MediaWiki 1.6.0 |
Next version: | Semantic MediaWiki 1.7.0 |
Compatible with: | MW 1.15.x - 1.18.x |
Current version: | |
SMW 4.2.0 |
Version 1.6.1 of Semantic MediaWiki is the next minor release after Semantic MediaWiki 1.6.0 that brings a number of tweaks and bugfixes.
Contents
Upgrading existing installations[edit]
Note that SMW has a new software dependency as of version 1.6.0: the Extension "Validator" extension that helps Semantic MediaWiki to validate user-provided parameters. It must be installed for SMW to work. Make sure that you include Validator prior to the inclusion of SMW in your LocalSettings.php. Do note that Validator comes bundled with SMW releases as of version 1.6.0. If you are obtaining the code via svn, you will need to get a checkout of Validator yourself.
Upgrading SMW 1.6.0[edit]
Installations of SMW 1.6.0 can be upgraded by just replacing the files, but it must be noted that not all SMW extensions may already be available in versions compatible to SMW 1.6.1.
Upgrading from SMW 1.5.0 to 1.5.6[edit]
Installations of SMW 1.5.* and can be upgraded by replacing the files, and by running the database update (Special:SMWAdmin or SMW_setup.php script) as usual. Moreover, it is strongly suggested to enable the refresh process to update all data on Special:SMWAdmin. Older versions of SMW can be upgraded in the same way, but there can be more feature changes that require changes of wiki pages. See the current documentation for details on using the current version.
Do not forget to also install the extension Validator first and include it in LocalSettings.php prior to SMW with the following line of code. After that you may proceed to upgrade SMW.
require_once( "$IP/extensions/Validator/Validator.php" );
Extensions for SMW versions up to 1.5.* should not be assumed to work with SMW 1.6.0 out of the box. All SMW extensions should be upgraded to versions that are compatible with SMW 1.6. Moreover, some functions changed and pages might need updates (see below). Additional remarks on upgrading older SMW versions are given below.
If not done already, it is suggested to change the inclusion of SMW in LocalSettings.php to the following as described in the installation instructions above:
include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php");
Including SMW_Settings.php as in earlier versions will continue to work, but may be disabled in some future version.
The main user-visible changes in SMW 1.6.0 concern the Type namespace, the use of custom units of measurement (with custom conversion factors), and the declaration of Type:Record properties. Moreover, the support for the RAP (RAP - RDF API) was replaced by general RDF store support. Please see the documentation for details on how to configure this.
Type namespace[edit]
SMW no longer uses namespaces "Type" and "Type talk." All types are now built-in and there is no good reason to keep a namespace just for documenting them. A new special page, Special:Types, lists all the available datatypes (and the set of properties properties of the given type). This functionality replaces the Type namespace pages.
If you still want to use Type (for example to recover text from those pages), you should set $smwgHistoricTypeNamespace = true; before including SMW in LocalSettings.php. This should only be used to move old content to a better place, e.g. to the Help namespace and to remove links still pointing to it. The old namespaces will not be kept indefinitely.
Custom units[edit]
The only use of Type pages was the declaration of custom types that would allow unit conversion. The declaration of properties with custom units of measurement has changed in two ways:
- The type of these properties is now "Quantity" (not a "custom" type page)
- The conversion factors that used to be on the Type page are now given on the property page. So one can simply move this text (Type must be activated for this as described above).
The internal data format of SMW has not changed for custom units, so stored data will be accessible immediately after the change.
Type:Record[edit]
The fields declaration of Record properties now refer to properties, not to types. If you have a property with
[[has type::Record]]
that uses a setting like
[[has fields::Page; Number; String]]
then you should now replace it with something like
[[has fields::my page; my number; my string]]
where "my page", "my number", and "my string" are properties in your wiki that have the right types. The use of properties instead of types is better since it allows custom settings beyond the datatype of a field (e.g. conversion factors).
The new method also involves internal changes in the data format, and it is not possible to make the update without temporarily loosing access to the stored data for Type:Record properties (until SMW's self repair has fixed all data entries).
Changes[edit]
Duplicate printouts[edit]
#Ask queries now allow printouts (table columns) that are exactly the same. In previous versions, multiple printouts with the same label would be collapsed (e.g. {{#ask: [[Catgegory:City]] |?|?|?}} now shows four columns).
Bugfixes[edit]
SMW 1.6.1 closes a number of bugs that have been identified in earlier versions. The more noteworthy ones include:
- Fixed continue and limit escaping issues on Special:Ask.
- Fixed error occurring for invalid queries with count or debug formats.
- Fixed several small issues with the table format and cleaned it up somewhat.
- Fixed parsing of years for properties of datatype Date.
Extended translations[edit]
As usual, translations have been extended thanks to the Translatewiki.net project.
This page in other languages: de