Help Встановлення

Якщо ж ви хочетеоновити SMW на більш свіжу версію, обов'язково ознайомтеся з відповідним розділом посібника. І так, зробіть цедопочатку апгрейду.

Перед встановленням SMW, перевірте. чи відповідає всі вимоги до системних вимог. Уважно дотримуйтесь інструкцій, наведених у посібнику користувача, але знайте, що Semantic MediaWiki не робить нічого непоправного з вашими файлами та базою даних. У процесі встановлення просто додаються кілька нових таблиць у БД, які можуть бути видалені. Зауважимо, однак, що зроблені семантичні інструкції в тексті сторінок залишаться на місці і вимагатимуть ручного видалення.

Disclaimer [ edit ]

Спочатку переконайтеся, що вірно зрозуміли умови використання, описані в документі COPYING.

Вимоги [ edit ]

  • MediaWiki 1.15.0 та вище (тестувалося на версіях аж до 1.18alpha (r88635)).
  • встановлене розширення Extension "Validator"
  • PHP 5.* або вище (крім версії 5.3.1)
  • MySQL >= 4.0.14 (крім версій 5.1.49 to 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, що дозволяє не давати вікікористувачі БД зайві права.
  • При використанні стандартного, встановленого за умовчанням сховища SMWSQLStore2, SMW створює та змінює часові таблиці для певних семантичних запитів. Щоб всі запити відпрацьовували коректно необхідно, щоб користувач Д мав права CREATE TEMPORARY TABLES. Однак, ви можете заборонити виконання таких запитів, дописавши наступне в Localsettings.php:
  • При використанні сховища SMWSparqlStore (RDF store connector), SMW використовує CURL-функції PHP. Не забудьте їх увімкнути.
Запуск SMW на старіших версіях MediaWiki

Загалом, не варто тримати у себе застарілі версії движка MediaWiki, тому що з кожним новим релізом усувається велика кількість уразливостей та дірок у системі безпеки. Якщо на вашому сайті використовується PHP4, SMW не почне працювати. Крім того, дуже складно адаптувати код до PHP4. Якщо у вас є PHP5, але версія MediaWiki застаріла, вам можуть знадобитися додаткові патчі. Можливо, в цьому випадку вам варто завантажити старішу версію SMW і дотримуватися інструкцій у файлі INSTALL.

Установка SMW складається з трьох простих кроків:

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

(2)[опціонально]Налаштуйте простори імен на вікі.Якщо на вікі ви додавали і використовували додаткові простори імен, вам потрібно встановити опцію $smwgNamespaceIndex перед тим, як включати SemanticMediaWiki.php . Semantic MediaWiki використовує додаткові індекси просторів імен, зі 102 по 109. Індекси 104 і 105 потрібні тільки якщо включена опція$smwgHistoricTypeNamespace. Індекси 106 і 107 зарезервовані для розширення Page Forms (Formerly Semantic Forms) і не використовуються SMW. Для подробиць зверніться до документації у файлі SMW_Settings.php. Якщо ви додасте простір імен після встановлення SMW, їх номери мають бути більшими за 109.

Зауваження:Semantic MediaWiki бере до уваги семантичні інструкції, розташовані тільки в межах деяких просторів імен. Наприклад, за умовчанням ігноруються семантичні інструкції на сторінках обговорень. Якщо вам хочеться змінити список просторів імен, у яких будуть доступні семантичні анотації, вам потрібно прочитати документацію про опцію $smwgNamespacesWithSemanticLinks та відповідним чином змінити файл LocalSettings.php.

(3) Підключіть розширення.Для цього слід додати наступні рядки до файлу LocalSettings.php:

(4) Оновіть базу даних.Залогіньтесь з привілеями адміністратора та пройдіть на сторінку "Special:SMWAdmin". Тут потрібно зробити дві операції.

  1. По-перше, запустіть скрипт автоматичного налаштування БД, натиснувши кнопку Ініціалізація або оновлення таблиць. Для цього вам потрібно мати права на створення та модифікацію таблиць.
  2. Потім запустіть обробку існуючих сторінок, натиснувши кнопку "Почати оновлення даних". Цей крок займе деякий час, можете стежити за прогресом, заходячи на сторінку Special:SMWAdmin

Перевірка встановленої Semantic MediaWiki [ edit ]

Якщо ви не впевнені, що установка пройшла гладко, ви можете перевірити це:

  1. По-перше, пройдіть на сторінку Special: Version. Якщо все гаразд, серед встановлених розширень там має з'явитися Semantic MediaWiki (номер версії) у верхній частині розділу"Семантичні розширення".
  2. Щоб перевірити, чи працює механізм семантичних властивостей, створіть сторінку TestSMW і введіть там наступний текст: and in it

Оновлення старішої версії [ edit ]

Зверніть увагу, щоSMW 1.6.0 тепер залежить від розширення Extension "Validator": вам доведеться встановити Validator перед початком встановлення Semantic MediaWiki, бо нічого не запрацює! Обов'язково переконайтеся, що ви увімкнули Validator у файлі LocalSettings.php і що рядок require_once("$IP/extensions/Validator/Validator.php") стоїть раніше за включення SMW. Потрібна версія Validator поставляється прямо у пакеті із SMW. Якщо ж ви качали код із svn, ставити Validator доведеться вручну.

Якщо ви оновлюєте SMW 1.5.0 і вище [edit]

Оновлювати вікі, що працюють на SMW 1.5.* досить просто - вам лише потрібно замінити старі файли та запустити оновлення БД (натиснувши кнопку на вікі-сторінці Special:SMWAdmin або запустивши скрипт SMW_setup.php з командного рядка). Також рекомендується запустити оновлення даних (друга кнопка на сторінці Special:SMWAdmin).

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

Сама SMW має працювати добре після оновлення, проте це не можна з усією певністю сказати про семантичні розширення, розраховані на старі версії Semantic MediaWiki. Тому обов'язково оновіть усі ваші розширення і, якщо потрібно, попросіть розробників зробити нові версії сумісними із SMW 1.6.

Якщо ви ще цього не зробили, змініть увімкнення файлу SMW_Settings.php на включення SemanticMediaWiki.php:

У майбутніх версіях SMW_Settings.php буде вимкнено!

Простір імен Type [edit]

Якщо ж ви все ж таки хочете використовувати простір має Type, ви повинні встановити змінну Configuration

перед тим, як увімкнути SMW у вашому файлі LocalSettings.php.

одиниці вимірювання [ edit ]

  1. Тип цих властивостей відтепер називається "Quantity" (а не сторінка "custom", як раніше)
  2. Коефіцієнти, що використовуються для конвертації одиниць виміру, тепер заповнюються прямо на сторінці властивості.

Type:Record [ edit ]

Тепер вам потрібно замінити це оголошення на щось подібне

де під "my page", "my number", and "my string" маються на увазі властивості типів Page, Number, String

Після того, як ви перетворите властивості типу Record, вам слід відновити пошкоджені таблиці, зайшовши в панель адміністрування SMW.

Оновлення версій SMW, менших за 1.4.3 [ edit ]

Користувачі, які оновлюються з версії 1.4.3 або раніше повинні пам'ятати про те, що відтепер n-арні властивості оголошуються за допомогою властивостей типу Type:Record а також про те, що в системі більше немає вбудованого типу географічних координат - для нього вам треба буде поставити розширення Semantic Maps. Якщо ви оновлюєтеся з дуже старою версією SMW, перегляньте інструкції до релізу 1.5.

Опції налаштувань

Деякі опції налаштування (змінні, які записуються в LocalSettings.php) змінилися в порівнянні з SMW 1.0. Всі налаштування докладно документовані у файлі SMW_Settings.php Нижче ми наводимо перелік опцій та версії, в яких вони з'явилися.

    [1.4]До версії 1.4 значення за промовчанням для опції $smwgQComparators дорівнювало s ' !'. Тепер за замовчуванням там використовується значення '!

', тобто за умовчанням доданий компаратор "like"