{"id":1230,"date":"2011-07-30T23:09:30","date_gmt":"2011-07-30T22:09:30","guid":{"rendered":"https:\/\/www.entropywins.wtf\/blog\/?p=1230"},"modified":"2014-03-17T23:10:08","modified_gmt":"2014-03-17T22:10:08","slug":"semantic-mediawiki-1-6-released","status":"publish","type":"post","link":"https:\/\/www.entropywins.wtf\/blog\/2011\/07\/30\/semantic-mediawiki-1-6-released\/","title":{"rendered":"Semantic MediaWiki 1.6 released!"},"content":{"rendered":"

That\u2019s right, the next big release of Semantic MediaWiki<\/a> is finally here! \":)\" A little over a year and six minor releases after SMW 1.5. And a big release it is, packing my improvements and several new features. It has been in the making over the past four months and contains contributions by many people. So let\u2019s have a look at all the new awesomeness \":)\"<\/p>\n

Support for RDF triplestores<\/strong><\/p>\n

Full support added for storing SMW data directly within an RDF triplestore, and for answering #ask queries based on this data. The communication happens via SPARQL (1.1), and all SPARQL-capable stores should be supported. The following settings are needed in LocalSettings.php:<\/p>\n

$smwgDefaultStore = \u2018SMWSparqlStore\u2019;
\n$smwgSparqlDatabase = \u2018SMWSparqlDatabase\u2019;
\n\/\/ The following should be set to the URLs to reach the store:
\n$smwgSparqlQueryEndpoint = \u2018http:\/\/localhost:8080\/sparql\/\u2019;
\n$smwgSparqlUpdateEndpoint = \u2018http:\/\/localhost:8080\/update\/\u2019;
\n$smwgSparqlDataEndpoint = \u2018http:\/\/localhost:8080\/data\/\u2019; \/\/ can be empty<\/p><\/blockquote>\n

The specific support that SMW used to have for the RAP RDF store has been discontinued.<\/p>\n

The Type namespace has been abolished<\/strong><\/p>\n

Builtin types now are displayed by the special page Special:Types, and there are no \u201ccustom types\u201d any longer. By default, the Type namespace is gone and existing pages in this namespace can no longer be accessed. This can be changed by setting $smwgHistoricTypeNamespace = true in LocalSettings.php before including SMW.<\/p>\n

Changes to units of measurement<\/strong><\/p>\n

Changed the way in which units of measurement work. Type:Number now does not accept any units, and a new type \u201cQuantity\u201d is used for numbers with units. Units must be declared on the property page (not on the Type page as before), and only units that have a declared conversion factor are accepted.<\/p>\n

Type:Record changes<\/strong><\/p>\n

The declaration of Type:Record properties has changed. Instead of a list of datatypes, the declaration now requires a list of properties that are to be used for the fields of the record. The declaration is still done with the property \u201chas fields\u201d as before. Properties must not be used more than once in has_fields, or the order of values will be random.<\/p>\n

Reworked internal data model<\/strong><\/p>\n

Reworked internal data model, cleaning up and re-implementing SMWDataValue and all of its subclasses, and introducing new data item classes to handle data. The class SMWCompatibilityHelpers provides temporary help for extensions that still depend on the old format and APIs.<\/p>\n

This change is very important compatibility wise, as it removes support for some older behavior and deprecates a bunch more. Older versions of a lot of SMW extensions will not work with SMW 1.6. However, since 1.6 has been in the making for quite some time, most, if not all, of these extensions have released one or more versions that work just fine with 1.6. So if you stick with the latest releases, you should be good.<\/p>\n

There are already 2 SMW extensions that now require SMW version 1.6 or later: Semantic Maps<\/a> 1.0 and the new kid in town: Semantic Watchlist<\/a> (see Semantic Watchlist release post<\/a>).<\/p>\n

Result formats make use of Validator<\/strong><\/p>\n

Semantic MediaWiki now makes use of the Validator extension<\/a> to handle parameters passed to result printers. This opens the door to numerous awesome new functionality. For one, it allows for better parameter error feedback to the user. In SMW < 1.6 when you enter a text value for a numeric parameter, it\u2019ll simple be ignored (without giving any warning). With this new approach the user will get a warning along the lines of \u201cThe value \u2018foobar\u2019 is not valid for parameter limit, it must be an integer.\u201d. Another advantage of using Validator here is that the query argument GUI on Special:Ask can show more fitting controls and display default values. A third win, is that writing new query printers has now become easier, as you just have to specify the parameters they should accept, and then don\u2019t have to bother with cleaning, validating and formatting them. Further things that can be done with this in the future are automatic generation of documentation per result format, which would be a huge improvement over the current documentation and smarter behavior (such as autocompletion and live validation) in interfaces where the values for these parameters can be specified.<\/p>\n

New DSV format<\/strong><\/p>\n

I added a new result format to SMW that outputs data as UNIX-style Delimiter Separated Values. For those not familiar with the differences between DSV and CSV (which was already supported), it comes down to sane escaping of the delimiter characters. Instead of the weird and hard to parse approach taken in CSV, the familiar backlashing technique is used in DSV. You can use this format by adding \u201cformat=dsv\u201d to any ask query.<\/p>\n

New API module for version info<\/strong><\/p>\n

This is a very small feature I added geared towards developers and the SMW registry tool in particular; it has not relevance to regular end users. Up until now the SMW registry tool obtained info about SMW installs by scraping Special:Version, which is a HTML page intended for humans to look at, and by scraping Special:SemanticStatistics, which is also a HTML page. Now the info provided by these pages and used by the SMW registry, ie the version of SMW and the number of properties, users and pages, can be obtained via the MediaWiki API using action=smwinfo.<\/p>\n

New smwdoc parser hook<\/strong><\/p>\n

Similar to the new API module, this new parser hook is not geared to most end users, but rather to documenters and site admins. This hook utilizes Validators auto documentation capabilities to display tables with parameter info, such as name, type, default value and description, for a specified result format. It\u2019s in essence a result format oriented\u00a0 version of Validators more general purpose describe parser hook. As soon as the SMW documentation wiki updates to 1.6, it\u2019ll be possible to use this hook to fill part of the documentation gap there unfortunately is.<\/p>\n

Some noteworthy fixes<\/strong><\/p>\n