帮助:安装1.7.1

来自semantic-mediawiki.org
跳转到:航行,搜索
SMW管理手册
安装
配置
概念缓存
固定属性
使用SPARQL和RDF存储
SPARQLStore(SPARQL商店)
漂亮的URI
故障排除
修复数据和数据结构
扩展
基本扩展
语义扩展
SMW用户手册
目录

本页介绍如何安装语义媒体Wiki 1.7.1之后下载它(其他版本请参阅本页底部)。安装和升级说明从版本到版本的更改:文件安装SMW附带的包含您下载的特定版本的说明。

收件人升级运行旧版本SMW的wiki,请务必阅读相关章节 之前开始升级。

要安装SMW,请检查确切要求并仔细遵循说明。安装不会对MediaWiki数据库进行不可逆的更改(它只是添加了一些以后可能被删除的表)。然而,如果卸载Semantic MediaWiki,目前还没有从文章文本中删除注释的自动化过程(可以通过编辑时删除注释的脚本来实现)。

免责声明[编辑]

确保您理解文件中的法律免责声明复制.

要求[编辑]

  • MediaWiki 1.16.0或更高版本(建议使用MediaWiki1.17.0或更高)
  • 扩展“验证器”扩展版本0.4.13或更高
  • 已安装PHP 5.2或更高版本并可正常工作(5.3.1版除外)
  • MySQL>=4.0.14(MediaWiki要求的版本,5.1.49至5.1.52版本除外)
或PostgreSQL>=8.3(注意,对后者的支持仍处于初步阶段,需要一些额外的步骤,请参见PostgreSQL详细信息)
笔记
  • 另请参阅上的页面兼容性.
  • SMW在PHP_mbstring.dll扩展中使用PHP mb_*()多字节函数,如mb_strpos。这是标准的,但在某些PHP发行版上默认不启用。请参阅PHP手册了解详细信息。
  • 对于安装和升级,SMW需要创建新表的权限(创建)和更改表格(ALTER表格). 设置SMW后,您可以删除这两个权限。脚本SMW_设置.php可以使用来自的DB凭据管理设置.php为此,避免了wiki DB用户需要额外的权限。
  • 使用时SMWSQL商店2(SMW的默认数据存储),SMW为某些语义查询创建和更改临时表。为此,您的wikidb用户必须具有创建临时表的权限。通过将以下内容添加到Localsettings.php中,可以禁用相应的功能:
$smwgQ子类别深度= 0;
$smwgQPropertyDepth   = 0;
$smwgQ功能        = SMW_ANY_QUERY公司 & ~SMW_DISJUNCTION_QUERY公司;
$smwgQConcept特性 = SMW_ANY_QUERY公司 & ~SMW_DISJUNCTION_QUERY公司 &
                       ~SMW_ CONCEPT_查询;
  • 使用时SMWSparqlStore(RDF存储连接器),SMW使用PHP的CURL函数。这些功能可能必须启用/安装才能使用。
在旧版本的MediaWiki上运行SMW

一般来说,不建议运行旧版本的MediaWiki,因为每个新版本都会带来安全修复。如果您的站点仍在PHP4上运行,则不支持SMW。很难将代码反向移植到旧的PHP版本。如果您使用的是PHP5,但使用的是旧的MediaWiki版本,则可能需要额外的补丁程序/修改。下载旧版本的SMW,并查看其中包含的INSTALL指令,以了解其中是否建议进行其他更改。

安装[编辑]

如果您升级了Semantic MediaWiki的现有安装,也请阅读部分中的备注升级现有安装下面!安装SMW基本上需要三(或四)个简单步骤:

(1) 复制文件。 提取Validator和Semantic MediaWiki的下载档案,或从Git中签出当前文件,以获取包含所有相关文件的目录“Validator”和“SemanticMediaWika”。将这些目录复制到“[wikipath]/extensions/”(或将其解压缩/下载到此位置)。

(2)[可选]调整名称空间。 如果您没有对wiki的名称空间进行任何更改,可以跳过此步骤。如果您已经定义了自己的自定义命名空间,您必须设置参数$smwgNamespace索引在包括SemanticMediaWiki.php之前。Semantic MediaWiki使用额外的名称空间索引,范围从102到109。注:104和105仅在以下情况下需要$smwgHistoricTypeNamespace($smwg历史类型命名空间)已设置。106和107为扩展“页面表单”SMW未使用。有关详细信息,请参阅SMW_Settings.php中的文档。如果在安装SMW后添加名称空间,则必须将其分配给比Semantic MediaWiki使用的名称空间更大的数字。

注:Semantic MediaWiki仅评估某些名称空间中的语义注释。例如,默认情况下,它忽略对话页面中的语义注释。如果要使用注释更改名称空间(可能是添加了自己的自定义名称空间),则必须为参数添加所需的数组带有语义链接的$smwgNamespaces在LocalSettings.php中。

(3) 启用扩展。 在文件“[wikipath]/LocalSettings.php”中插入以下行:

 要求一次(_O)( "$IP(美元)/extensions/Validator/Validator.php“ );
 包含一次(_O)( "$IP(美元)/extensions/SemanticMediaWiki/SemanitMediaWiki.php“ );
 启用语义('示例.org');

其中example.org应替换为服务器的名称(或IP地址)。此字符串仅用作标识wiki的全局唯一名称导出的数据语义Web,并且有效的服务器名称可以很好地用于此目的。如果一个wiki有多个服务器名,无需担心,只需选择一个即可。

(4) 设置数据库。 在您的wiki中,以管理员身份登录,然后转到页面“Special:SMWAdmin”以执行最后的设置步骤。需要两个步骤:首先,触发数据库设置(“数据库安装和升级”)。然后,激活自动数据更新(“数据修复和升级”)。注意,第一步需要更改/创建数据库表的权限,如上面的注释所述。第二步需要一些时间;点击Special:SMWAdmin了解其进度。SMW可以在完成之前使用,但还不能访问所有数据(例如页面类别)。

特殊:SMWAdmin
存储已成功设置
SMW已成功测试

测试您的安装[编辑]

如果您不确定一切进展顺利,可以执行一些测试步骤来检查SMW设置是否正确:

  1. 转到特殊:版本页面。您应该看到顶部“语义扩展”部分中列出的Semantic MediaWiki(nn版)。
  2. 创建一个名为“TestSMW”的常规wiki页面,并在其中输入wiki文本
    性能测试:[[testproperty::Dummypage]]
    在保存之前预览页面时,您应该会在文章底部看到一个显示您输入的Factbox。保存页面后,单击页面工具箱中的链接“浏览属性”。此视图应显示值为Dummypage的Testproperty。

升级现有安装[编辑]

  1. 请进一步阅读以下可能适用的部分。
  2. 下载并安装新文件。
  3. 通过运行维护脚本升级数据库结构SMW_设置.php,或使用特殊页面特殊:SMWAdmin.
  4. 可以通过运行以下命令刷新数据SMW_刷新数据.php,或再次使用特殊页面特殊:SMWAdmin。有关刷新和修复数据的完整说明,请参阅上的帮助页修复SMW的数据.

升级SMW 1.6.x和SMW 1.7[编辑]

SMW 1.6.x和SMW 1.7的安装可以通过替换文件和像往常一样更新数据库来升级。此外,强烈建议在从SMW 1.6.x升级时,启用刷新过程以更新Special:SMWAdmin上的所有数据。旧版本的SMW可以以相同的方式升级,但可能会有更多需要更改wiki页面的功能更改。有关使用当前版本的详细信息,请参阅当前文档。

升级SMW 1.5.x[编辑]

SMW 1.6.0引入了一个新的软件依赖项(也适用于所有后续版本):扩展“验证器”帮助Semantic MediaWiki验证用户提供的参数的扩展。必须安装SMW才能工作。确保在LocalSettings.php中包含SMW之前包含Validator。请注意,从1.6.0版开始,Validator与SMW发行版捆绑在一起。如果您是通过Git获得代码的,那么您需要自己检查Validator。

不要忘记首先安装扩展Validator,并在SMW之前使用以下代码行将其包含在LocalSettings.php中。之后,您可以继续升级SMW。

要求一次(_O)( "$IP(美元)/extensions/Validator/Validator.php“ );


对于SMW 1.5.*以下版本的扩展,不应假定与SMW 1.6.0一起使用。所有SMW扩展都应升级到与SMW 1.6兼容的版本。此外,某些功能已更改,页面可能需要更新(请参阅下文)。下面给出了有关升级旧SMW版本的其他备注。

如果尚未完成,建议将LocalSettings.php中包含的SMW更改为以下内容,如上述安装说明所述:

包含一次(_O)("$IP(美元)/extensions/SemanticMediaWiki/SemanitMediaWiki.php“);


与早期版本一样包含SMW_Settings.php将不再有效。

更改的配置选项[编辑]

一些配置选项(在LocalSettings.php中使用)自SMW1.0以来已更改。文件中详细记录了所有设置SMW_设置.php。下表列出了首次引入设置的版本,因此如果您已经运行此版本或更高版本,则可以忽略此设置。

  • [1.4]1.4版之前,设置的默认值$smwgQ比较程序'<|>|!'。现在已更改为'<|>|!|~'所以“like”比较器~默认情况下启用。
  • [1.4]版本1.4仍然支持设置$smwgSMWBeta兼容以启用旧的<ask>查询语法和关系名称空间。这种向后兼容性现在已被删除,不再使用该设置。请更新您的wiki,不要使用过时的(现在没有文档记录的)功能。
  • [1.3]自SMW 1.3以来事实箱默认情况下是隐藏的,并且只显示在页面预览中。作为补偿,工具箱(通常位于搜索字段下方的左侧)显示了指向特殊:浏览。要像SMW 1.3之前一样使用Factbox的显示行为,请设置$smwgShowFactbox=SMW_FACTBOX_NONEMPTY;编辑过程中的新链接和Factbox也可以进行配置;看见SMW_设置.php了解详细信息。
  • [1.2.1]默认情况下,SMW将不再支持属性值中的嵌套链接语法,因为这会导致问题。要重新启用此功能,请设置$smwgLinksInValues=true;
  • [1.2]如果您的wiki使用<询问>语法或关系:命名空间,您可能需要设置$smwgSMWBetaCompatible=true; 之前在LocalSettings.php中包含SemanticMediaWiki.php(以前是SMW_Settings.php)的行。考虑改变<询问>#询问能够删除SMW测试版兼容性。
  • [1.2]如果你有一个设置$smwgQDisjunctionSupport=false;那么您现在需要在您的本地设置.php:
  $smwgQ功能        = SMW_ANY_QUERY公司 & ~SMW_DISJUNCTION_QUERY公司;
  $smwgQConcept特性 = SMW_ANY_QUERY公司 & ~SMW_DISJUNCTION_QUERY公司 & ~SMW_ CONCEPT_查询;
  • [1.0] $smwgQEquality支持是其中之一SMW_EQ_NONE、SMW_EQ_SOME、SMW _EQ_FULL(它是真的直到SMW 1.0 RC1-3)。
  • [1.0] $smwgQDefaultNamespaces现在是无效的默认情况下,以便查询所有名称空间。SMW RC 1-3中的默认值为“阵列(NS_MAIN、NS_IMAGE)'.
  • [1.0] $smwgQDefaultLinking现在默认为“全部的'以便链接所有查询结果。这不再是性能问题。SMW RC 1-3之前的默认值为“主题'.

如果您当前在本地设置.php,您需要更新此文件。请参阅SMW_设置.php有关可用参数的更多文档。

另请参见[编辑]


本文档页面适用于1.7.1至1.7.1的所有SMW版本。

安装英语1.7.1 1.7.1