本文档页面适用于1.5.2至1.5.2的所有SMW版本。
本页介绍如何安装语义媒体Wiki 1.5.2在拥有之后已下载它（其他版本请参阅本页底部）。安装和升级说明从版本到版本的更改：文件安装SMW附带的包含您可能下载的特定版本的说明。
收件人升级运行旧版本SMW的wiki，请确保已阅读相关章节 之前开始升级。
对于SMW的安装，请检查确切要求并仔细遵循说明。安装不会对MediaWiki数据库进行不可逆的更改（它只会添加一些可以再次删除的表）。然而，在再次卸载Semantic MediaWiki的情况下，目前没有自动从文章文本中删除注释的过程，但可以通过一些脚本来实现这一点，该脚本可以消除编辑时的注释。
免责声明[编辑]
确保您理解文件中的法律免责声明复制.
- MediaWiki 1.15.4或更高版本（在1.16.0到1.17alpha（r63248）上测试）。
- 已安装PHP 5.*或更高版本并可正常工作
- MySQL>=4.0.14（MediaWiki要求的版本）或PostgreSQL>=8.3（注意，对后者的支持仍处于初步阶段，需要一些额外的步骤，请参阅PostgreSQL详细信息）
笔记：
- SMW在PHP_mbstring.dll扩展中使用PHP mb_*（）多字节函数，如mb_strpos。这是标准的，但在某些PHP发行版上默认不启用。请参阅PHP手册了解详细信息。
- 对于安装和升级，SMW需要创建新表的权限(创建)和更改表格(ALTER表格). 设置SMW后，可以再次删除两者。脚本SMW_设置.php可以使用来自的DB凭据管理设置.php为此，避免了wiki DB用户需要额外的权限。
- SMW为某些语义查询创建和更改临时表。要执行此操作，您的wikidb用户必须具有创建临时表格。如果不需要，可以通过将以下内容添加到来禁用需要此权限的SMW功能本地设置.php:
$smwgQSubcategoryDepth=0；$smwgQPropertyDepth=0；$smwgQFeatures=SMW_ANY_QUERY&~SMW_DISJUNCTION_QUERY；$smwgQConceptFeatures=SMW_ANY_QUERY&~SMW_DISJUNCTION_QUERY&~SMW_CONCEPT_QUERY；
如果您升级了Semantic MediaWiki的现有安装，也请阅读部分中的备注升级现有安装下面！安装SMW基本上需要三（或四）个简单步骤：
（1） 复制文件。 解压缩下载的存档，或从SVN中检出当前文件，以获取包含所有相关文件的目录“SemanticMediaWiki”。将此目录复制到“[wikipath]/extensions/”（或将其解压缩/下载到此位置）。我们在下面将“[wikipath]/extensions/ShemanticMediaWiki”缩写为“[SMW_path]”。
(2)[可选]调整名称空间。 如果您没有对wiki的名称空间进行任何更改，可以跳过此步骤。如果您已经定义了自己的自定义命名空间，在包含SemanticMediaWiki.php之前，必须设置参数$smwgNamespaceIndex。Semantic MediaWiki使用了10个额外的名称空间索引，范围从100到109。注意，只有在以下情况下才需要100和101$smwgSMWBeta兼容已设置。106和107为SemanticForms扩展保留，SMW不使用。有关详细信息，请参阅SMW_Settings.php中的文档。如果在安装SMW后添加名称空间，则必须将其分配给比Semantic MediaWiki使用的名称空间更大的数字。
注：Semantic MediaWiki仅评估某些名称空间中的语义注释。例如，默认情况下，它忽略对话页面中的语义注释。如果要使用注释更改名称空间（可能是添加了自己的自定义名称空间），则必须更改数组变量带有语义链接的$smwgNamespaces在SMW_Settings.php中。
（3） 启用扩展。 在文件“[wikipath]/LocalSettings.php”中插入以下两行：
include_once（“$IP/extensions/ShemanticMediaWiki/ShemanitMediaWik.php”）；enableSemantics（'example.org'）；
其中example.org应替换为服务器的名称（或IP地址）。此字符串仅用作标识wiki的全局唯一名称导出的数据上语义Web，并且有效的服务器名称可以很好地用于此目的。如果一个wiki有多个服务器名，无需担心，只需选择一个即可。
（4） 设置数据库。 在您的wiki中，以管理员身份登录，然后转到页面“Special:SMWAdmin”以执行最后的设置步骤。需要两个步骤：首先，触发数据库设置（“数据库安装和升级”）。然后，激活自动数据更新（“数据修复和升级”）。注意，第一步需要更改/创建数据库表的权限，如上面的注释所述。第二步需要一些时间；点击Special:SMWAdmin了解其进度。SMW可以在完成之前使用，但还不能访问所有数据（例如页面类别）。
测试您的安装[编辑]
如果您不确定是否一切正常，可以执行一些测试步骤来检查SMW是否设置正确。
转到特别：版本页面。您应该会看到Semantic MediaWiki（版本nn）在那里作为Parser Hook列出。
创建一个名为“TestSMW”的常规wiki页面，并在其中输入wiki文本
性能测试：[[testproperty:：Dummypage]]
在保存之前预览页面时，您应该会在文章底部看到一个显示您输入的Factbox。保存页面后，单击页面工具箱中的链接“浏览属性”。此视图应显示值为Dummypage的Testproperty。
在旧版本的MediaWiki上运行SMW[编辑]
一般来说，不建议运行旧版本的MediaWiki，因为每个新版本都会带来安全修复。如果您的站点仍在PHP4上运行，则不支持SMW。很难将代码反向移植到旧的PHP版本。如果您使用的是PHP5，但使用的是旧的MediaWiki版本，则可能需要额外的补丁程序/修改。下载旧版本的SMW，并查看其中包含的INSTALL指令，以了解其中是否建议进行其他更改。
升级现有安装[编辑]
SMW 1.5.*的安装只需更换文件即可升级，所有与SMW 1.5.1兼容的扩展都应在不进行修改的情况下工作。请注意，不再支持非常旧的MediaWiki版本–无论如何，在公共服务器上运行早于MediaWiki 1.15的版本是不明智的。从SMW 1.5.0升级时，请确保SMW扩展更新到兼容版本，例如：。，扩展“地图”要求版本0.6。如果出现问题，只需使用旧文件即可返回1.5.0，等待升级，直到相关扩展提供更新。
如果尚未完成，建议将LocalSettings.php中包含的SMW更改为以下内容，如上述安装说明所述：
include_once（“$IP/extensions/ShemanticMediaWiki/ShemanitMediaWik.php”）；
像在早期版本中那样包含SMW_Settings.php将继续工作，但在某些未来版本中可能会禁用。
现有的SMW 1.4.*安装和所有已使用默认存储区（SMWSQLStore2）的SMW安装基本上可以遵循上述安装步骤。后者涵盖SMW 1.2到1.3的所有站点，这些站点不使用特殊设置切换回旧存储（“SMWSQLStore”或“SMWRAPStore”）。旧版本的SMW可以以类似的方式升级，但必须确保它们不依赖于旧版本的现有特性。有关详细信息，请阅读SMW 1.2和1.3版的升级说明。此外，SMW 1.5.0最终删除了与以下SMW测试版的所有向后兼容性语义媒体Wiki 1.0.0。如果您的wiki仍在使用该设置$smwgSMWBetaCompatible=真那么，在您发现禁用此设置工作正常且没有任何复杂情况之前，您不应该升级。
SMW功能中有两个更改，可能会影响使用早期版本的某些站点。如果wiki使用n元（多值）属性或类型的属性地理坐标所需的升级步骤在下面的单独部分中进行了描述。
直接启用SMW 1.5.1后，可能会发生由于后台作业试图访问新的数据库结构（甚至在您初始化之前）而导致站点显示SQL错误的情况。这甚至会阻止您访问SMWAdmin。在这种情况下，可以从命令行使用脚本SMW_setup.php，也可以访问数据库并删除表“job”中的所有条目。在此之后，在访问用于初始化的特殊页面时，不应显示任何错误。
从SMW 1.4.*或更早版本升级时，SMW的扩展（例如。扩展“页面表单”)需要更新到与SMW 1.5.1兼容的版本。有关详细信息，请参阅分机的主页。如果使用，建议更新为兼容版本的SemanticResultFormats（SRF）。这些格式已迁移到此扩展包中，并在安装后默认启用。
地理坐标[编辑]
数据类型地理坐标已从SMW移至扩展“地图”扩展。使用这种类型的Wiki应该安装0.6或更高版本的语义地图。不需要进行其他更改，但建议在升级SMW之前安装语义地图，以避免随时出现问题。此举旨在将地理相关功能集中在一个扩展中，以便更好地维护和使用。
N元（多值）属性[编辑]
自SMW 1.4.3以来，这些属性在属性页上的声明方式发生了变化，有必要更改所有此类属性的页面，以便再次像以前一样使用它们。在SMW 1.4.*之前，此类属性是通过类型声明声明的，如下例所示：
[[具有类型：：Page；Number；String]]
在这种情况下，声明了一个具有三个指定类型字段的属性。您可以使用内联查询｛｛#ask:[[has-type:：~*；*]]｝｝来获取wiki中所有此形式的属性的列表。在SMW 1.5.1中，必须在属性页上进行两个属性赋值：
[[具有类型：：记录]][[具有字段：：Page；Number；String]]
换句话说，所有“n-ary”属性现在都是新的数据类型记录，并且有关其字段的信息是独立声明的。此更改允许SMW中的许多改进，并使创建新的（更好的）扩展成为可能，以支持未来的复合属性值。
要升级，第一安装新版本的SMW，然后使用上面的内联查询有效地查找所有需要更改的属性。根据需要更新页面后，所有值都应该可以像以前一样访问（可能需要完成一些修复作业才能真正做到这一点；请检查作业队列）。如果在升级到SMW 1.5.1之前更改页面，则有必要启动SMW的修复周期，以确保所有受影响的页面都得到更新。
更改的配置选项[编辑]
一些配置选项（在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:
$smwgQFeatures=SMW_ANY_QUERY&~SMW_DISJUNCTION_QUERY；$smwgQConceptFeatures=SMW_ANY_QUERY&~SMW_DISJUNCTION_QUERY&~SMW_CONCEPT_QUERY；
- [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有关可用参数的更多文档。
