Налаштування MediaWiki за допомогою файлу

Пропозиція від 8host.com

налаштування

MediaWiki – це програма для створення вікі-сайтів та керування ними. Спочатку розроблялося компанією WikiMedia Foundation обслуговування проекту Wikipedia. На сьогоднішній день цей додаток доступний і для підтримки менших проектів.

Примітка : Для виконання цього посібника потрібно попередньо встановити MediaWiki на віртуальний виділений сервер. Усі необхідні інструкції можна знайти у цьому посібнику.

У цьому посібнику йдеться про базове налаштування MediaWiki, яке можна виконати за допомогою файлу LocalSettings.php.

Чи можна змінити налаштування через веб-інтерфейс?

Загалом більшість налаштувань і завдань з управління доступні у звичайному веб-інтерфейсі вікі, проте існує деякі налаштування, які вимагають редагування текстових файлів сервера.

Файл LocalSettings.php недоступний із веб-інтерфейсу з міркувань безпеки. Щоб відредагувати файл вручну, потрібно підключитися до сервера SSH.

Де зберігаються стандартні установки MediaWiki?

Параметри за замовчуванням зберігаються у файлі під назвою DefaultSettings.php.

Щоб змінити будь-яке значення, запишіть його, а потім внесіть зміни до файлу LocalSettings.php.

Як змінити параметри MediaWiki?

Усі налаштування користувача слід вносити в файл LocalSettings.php. Він дуже схожий на DefaultSettings.php, але він трохи коротший. Введіть наступну команду, щоб відкрити файл для редагування:

sudo nano /etc/mediawiki/LocalSettings.php

Цей файл написаний на PHP, але синтаксис досить простий і зрозумілий. Здебільшого він має такий вигляд:

Цей файлмістить велику кількість налаштувань, але в ньому визначено далеко не всі доступні налаштування. Як правило, в ньому знаходяться налаштування, значення яких суперечать стандартним параметрам файлу DefaultSettings.php.

Щоб змінити налаштування DefaultSettings.php, потрібно знайти відповідний параметр LocalSettings.php і змінити його. Якщо такого параметра немає, потрібно просто додати його до кінця файлу.

Загальні настройки

Перед зміною будь-яких налаштувань рекомендується створити резервну копію конфігураційних файлів (на випадок, якщо щось не спрацює):

sudo cp /etc/mediawiki/LocalSettings.php /etc/mediawiki/LocalSettings.php.bak

Відкрийте файл LocalSettings.php для редагування:

sudo nano /etc/mediawiki/LocalSettings.php

Зміна назви сайту

Назва сайту вказується під час початкового настроювання mediawiki. Щоб змінити назву сайту, відредагуйте змінні wgSitename та wgMetaNamespace.

$wgSitename = "New Site Name"; $wgMetaNamespace = "New_Site_Name";

Друга змінна встановлює простір імен сторінок, які стосуються вікі. Зверніть увагу: вона не дозволяє використовувати пробіли.

Зміна мови сайту

Щоб змінити мовне кодування сайту, змініть значення змінної wgLanguageCode:

Фраза language_code у цьому прикладі замінює будь-яке значення, що міститься у файлі:

Змінивши мову, запустіть скрипт, який активує зміни:

cd /etc/mediawiki/maintenance sudo php rebuildmessages.php --rebuild

Як дозволити завантаження зображень

Перш ніж дозволити завантаження зображень на вікі, потрібно встановити деякі додаткові програми для обробки зображень із набору imagemagick:

sudo apt-getinstall imagemagick

Знову відкрийте файл LocalSettings.php:

sudo nano /etc/mediawiki/LocalSettings.php

Щоб користувачі вікі могли підвантажувати зображення, змініть значення змінної wgEnableUploads на true:

$wgUseImageMagick = true; $wgImageMagickConvertCommand = "/usr/bin/convert";

Ці налаштування дозволяють використовувати згорнуті зображення.

За замовчуванням підтримуються формати png, gif та jpeg/jpg. Щоб налаштувати підтримку інших форматів, додайте змінну wgFileExtensions:

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'pdf', 'additional_format', '. ')

Примітка : Будь-який веб-сайт, який приймає контент від користувачів, наражається на певний рівень ризику! Дозволяючи користувачам завантажувати зображення, усвідомлюйте наслідки такої активності та вживіть відповідних заходів безпеки.

Роздільна здатність зображень WikiCommons

Наступна важлива змінна зветься wgUseInstantCommons. Вона дозволяє вікі-сайту автоматично налаштовувати доступ до контенту Wikimedia Commons. Його можна вбудувати у сторінки сайту.

Щоб використовувати зображення Wikimedia Commons, знайдіть тут потрібне зображення:

Скопіюйте його URL, а потім відкрийте або відредагуйте сторінку і просто вставте скопійоване посилання в подвійних дужках:

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

Щоб замість цього використовувати мініатюру зображення, додайте після імені файлу прямий слеш (символ ) та thumb:

Зміна логотипу

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

Для початку потрібноскопіюйте файл логотипу у відповідний каталог на віртуальному сервері:

scp /path/to/local/image.png username@server_ip:/etc/mediawiki/skins/common/images/

Потім змініть шлях у wgLogo, вказавши шлях до файлу логотипу:

Стандартний логотип буде змінено щойно підвантаженим зображенням.

Налаштування електронної пошти

Щоб отримати повідомлення електронної пошти, у тому числі звіти про помилки, вкажіть свою електронну пошту в змінній wgEmergencyContact.

Висновок

Тепер ви знаєте основу використання файлу LocalSettings.php.

Насправді, у MediaWiki існує величезна кількість налаштувань, не включених до LocalSettings.php за промовчанням. Не забувайте звертатись до /etc/mediawiki/includes/DefaultSettings.php.

Детальну інформацію про конкретні змінні можна знайти тут.