Помощ: Инсталация

Ако искаш актуализирайте SMW до по-нова версия, не забравяйте да прочетете съответната глава от ръководството. И да, направете го преди начало на надстройката.

Преди да инсталирате SMW, моля, проверете дали са изпълнени всички системни изисквания. Следвайте внимателно инструкциите в ръководството за инсталиране, но имайте предвид, че Semantic MediaWiki не прави нищо непоправимо с вашите файлове и база данни. Инсталационният процес просто добавя няколко нови таблици към базата данни, които могат лесно да бъдат изтрити. Имайте предвид обаче, че семантичните пояснения, направени в текста на страниците, ще останат на място и ще изискват ръчно премахване.

Отказ от отговорност [редактиране]

Първо се уверете, че разбирате правилно условията за използване, описани в документа КОПИРАНЕ.

Изисквания [редактиране]

  • MediaWiki 1.15.0 и по-нова версия (тествана до 1.18alpha (r88635)).
  • инсталирано разширение "Валидатор"
  • PHP 5. * или по-нова версия (с изключение на версия 5.3.1)
  • MySQL> = 4.0.14 (с изключение на версии 5.1.49 до 5.1.52)
или PostgreSQL> = 8.3 (имайте предвид, че изборът на PostgreSQL ще изисква няколко допълнителни стъпки за инсталиране (вижте страницата PostgreSQL)
  • SMW използва PHP многобайтови функции mb _ * (), като mb_strpos в php_mbstring.dll. Понякога тази библиотека не е включена в стандартния PHP пакет, вижте съответната глава на ръководството за подробности.
  • За да инсталирате и актуализирате, трябва да имате разрешение за създаване и модифициране на таблици в базата данни (CREATE TABLE, ALTER TABLE). След като инсталирате SMW, можете да премахнете тези привилегии и всичко трябва да работи нормално. Когато използвате скрипта SMW_setup.php, се използват настройките за достъп от AdminSettings.php, което ви позволява да не давате на потребителите на wiki на базата данни допълнителни права.
  • Използвайки стандартното хранилище по подразбиране SMWSQLStore2, SMW създава и модифицира временни таблици за конкретни семантични заявки. За да бъдат обработени правилно всички заявки, е необходимо потребителят D да има права СЪЗДАВАНЕ НА ВРЕМЕННИ ТАБЛИЦИ. Можете обаче да предотвратите изпълнението на такива заявки, като добавите следното към Localsettings.php:
  • Когато се използва SMWSparqlStore (RDF конектор за съхранение), SMW използва PHP CURL функции. Не забравяйте да ги включите.
Стартиране на SMW на по-стари версии на MediaWiki

По принцип не трябва да съхранявате остарели версии на механизма на MediaWiki, тъй като с всяко ново издание се отстраняват голям брой уязвимости и дупки в сигурността. Ако вашият сайт използва PHP4, SMW няма да работи. Също така ще бъде много трудно да адаптирате кода към PHP4. Ако имате PHP5, но MediaWiki е остарял, може да се нуждаете от допълнителни корекции. Може би в този случай трябва да изтеглите по-стара версия на SMW и да следвате инструкциите във файла INSTALL.

Инсталирането на SMW се състои от три прости стъпки:

(1) Копиране на файлове. Разопаковайте архивите на разширенията Validator и Semantic MediaWiki и копирайте съответните директории в папката "[wikipath]/extensions /".

(2) [по избор] Настройте пространства от имена в wiki. Ако сте добавили и използвали допълнителни пространства от имена във вашата wiki, трябва да зададете опцията $ smwgNamespaceIndex, преди да включите SemanticMediaWiki.php. Semantic MediaWiki използва допълнителни индекси на пространство от имена, от 102 до 109. Индекси 104 и 105 са необходими само ако е активирана опцията $ smwgHistoricTypeNamespace. Индекси 106 и 107 са запазени за разширението Page Forms (по-рано Semantic Forms) и не се използват от самата SMW. За подробности вижте документацията във файла SMW_Settings.php. Ако добавите пространства от имена след инсталиране на SMW, броят им трябва да е по-голям от 109.

Коментар: Semantic MediaWiki взема предвид семантичните анотации, разположени само в определени пространства от имена. Например семантичните анотации на дискусионните страници се игнорират по подразбиране. Ако искате да промените списъка с пространства от имена, в които ще бъдат налични семантични анотации, трябва да прочетете документацията за опцията $ smwgNamespacesWithSemanticLinks и съответно да промените файла LocalSettings.php.

(3) Свържете разширенията. За да направите това, добавете следните редове към файла LocalSettings.php:

(4) Актуализирайте базата данни. Влезте с администраторски права и отидете на страницата „Специално: SMWAdmin“. Това изисква две операции.

  1. Първо стартирайте скрипта за автоматично конфигуриране на база данни, като щракнете върху бутона Инициализиране или актуализиране на таблици. За да направите това, трябва да имате разрешение за създаване и модифициране на таблици.
  2. След това започнете да обработвате съществуващите страници, като кликнете върху бутона „Стартиране на актуализацията на данните“. Тази стъпка ще отнеме известно време, можете да проследите напредъка, като посетите специалната страница: SMWAdmin

Проверка на инсталирана Semantic MediaWiki [редактиране]

Ако не сте сигурни дали инсталацията е преминала гладко, можете да проверите това:

  1. Първо отидете на страницата Special: Version. Ако всичко е наред, инсталираните разширения трябва да включват Semantic MediaWiki (номер на версията) в самия връх на раздела "Semantic Extensions".
  2. За да проверите дали механизмът на семантичните свойства работи, създайте страница "TestSMW" и въведете следния текст там: и в него

Надстройка от по-стара версия [редактиране]

отбележи, че SMW 1.6.0 вече зависи от разширението "Validator": ще трябва да инсталирате Validator преди да инсталирате Semantic MediaWiki, в противен случай нищо няма да работи! Уверете се, че сте активирали Validator във вашия файл LocalSettings.php и че редът require_once ("$ IP/extensions/Validator/Validator.php") идва преди SMW да бъде активиран. Правилната версия на Validator се изпраща директно в пакета SMW. Ако сте изтеглили кода от svn, ще трябва да инсталирате Validator ръчно.

Ако надстройвате SMW 1.5.0 или по-нова версия [редактиране]

Актуализиране на уикита, работещи на SMW 1.5. * Доста е просто - просто трябва да замените старите файлове и да започнете да актуализирате базата данни (щракнете върху бутона на специалната: SMWAdmin wiki страница или стартирайте скрипта SMW_setup.php от командния ред). Също така е силно препоръчително да стартирате опресняване на данни (втори бутон на страницата Special: SMWAdmin).

Както бе споменато по-горе, не забравяйте да инсталирате разширението Validator и да го включите в LocalSettings.php преди реда, който включва SMW:

Самата SMW трябва да работи добре след актуализацията, но това не може да се каже със сигурност за семантични разширения, предназначени за по-стари версии на Semantic MediaWiki. Затова не забравяйте да актуализирате всичките си разширения и, ако е необходимо, помолете разработчиците да направят нови версии съвместими със SMW 1.6.

Ако още не сте го направили, променете включването на файла SMW_Settings.php, за да включите SemanticMediaWiki.php:

В бъдещи версии SMW_Settings.php ще бъде деактивиран!

Тип пространство на имената [редактиране]

Ако все пак искате да използвате пространството тип, трябва да зададете променливата за конфигуриране

преди да активирате SMW във вашия файл LocalSettings.php.

Персонализирани единици [редактиране]

  1. Типът на тези свойства сега се нарича "Количество" (а не "персонализирана" страница, както преди)
  2. Коефициентите, използвани за преобразуване на мерни единици, вече се попълват директно на страницата на имота.

Тип: Запис [редактиране]

Сега трябва да замените тази декларация с нещо подобно

където "моята страница", "моят номер" и "моят низ" означават свойства на типове Page, Number, String

След като преобразувате свойствата на типа Record, трябва да поправите повредените таблици, като отидете на [[SMW администраторски панел.

Надстройка на версиите на SMW преди 1.4.3 [редактиране]

Потребителите, надстрояващи от версия 1.4.3 или по-стара, трябва да помнят, че отсега нататък n-ary свойства се декларират с помощта на Type: Record свойства и че системата вече няма вграден тип географски координати - трябва да доставите разширението Semantic Maps. Ако надстройвате от много стара версия на SMW, вижте инструкциите за издание 1.5.

Опции за настройки [редактиране]

Някои от опциите за конфигуриране (променливи, написани в LocalSettings.php) са се променили от SMW 1.0. Всички настройки са документирани подробно във файла SMW_Settings.php По-долу предоставяме списък с опции и версиите, в които са се появили.

    [1.4] Преди 1.4 по подразбиране за опцията $ smwgQComparators беше s '|!'. Сега по подразбиране е '|! |

', тоест сравнението "като" се добавя по подразбиране