KernelNewbies:

Покажчик

Contents

  1. Запитання з серії "Що таке Вікі?"
    1. Що таке ''Вікі''?
    2. Для чого підходить вікі?
    3. Які головні властивості Вікі?
    4. Як щодо безпеки у Вікі? Чи не вразлива Вікі для повного витирання чи спотворення саботажником?
  2. Загальні питання щодо МоінМоін
    1. MediaWiki більш відома система, розроблена на базі PHP, навіщо комусь замість неї використовувати МоінМоін?
    2. Які є "за" та "проти" використання MediaWiki та MoinMoin?
    3. Я бажаю, щоб деякі сторінки та їх підсторінки не були доступні кожному. МоінМоін це підтримує ?
  3. Питання щодо використання цього вікі
    1. Пошук та доступ до інформації у вікі
      1. Як можна виконувати пошук у вікі?
      2. Як побачити що було зроблено у вікі за останній час?
      3. Як отримати ОстанніЗміни за більш ранній період ніж виводиться зазвичай?
      4. Що це за дивні різнокольорові посилання, які я басу всюди?
      5. Як перейти до домашньої сторінки?
    2. Редагування вікі
      1. Як додати щось до вікі, або змінити некоректний зміст?
      2. Є якісь домовленості яких потрібно дотримуватися при додаванні інформації?
      3. Як можна додати не текстову інформацію до Вікі?
      4. Чи можна зробити текст кольоровим?
      5. Як можна уникнути використання <<BR>> та натомість використовувати звичайні символи переведення рядка?
      6. Як додати зображення до сторінки?
      7. Як створити нову сторінку шаблону?
      8. Додавання документів у інтранет
      9. Чи слід ''підписувати'' внесені мною зміни?
      10. Що буде, якщо я зітру елементи сторінки, а ви вважаєте, що вони потрібні? Вони витираються остаточно?
    3. Додавання документів у інших форматах до вікі
      1. Можна додавати HTML до вікі?
    4. Створення посилань у вікі
      1. Як зробити посилання на зовнішній відносну до вікі сторінку, as with an html a tag?
  4. Встановлення та налаштовування
    1. Як активувати параметр "DeletePage" / "RenamePage"?
    2. Як змінити стартову сторінку?
    3. Захист від хвиль
  5. Адміністрування Вікі
    1. Як адмініструвати Вікі?
    2. Як видалити користувача?
    3. Можу я повернути попередню версію сторінки?
    4. Як оновити вікі?
  6. Довідка для розробників
    1. З чого можна почати розробнику?
    2. З чого почати дизайнеру чи перекладачу?
    3. Діагностика МоінМіон

Запитання з серії "Що таке Вікі?"

Що таке ''Вікі''?

Термін Wiki - скорочена форма WikiWikiWeb. Вікі - це зібрання сторінок, які можна спільно редагувати використовуючи веб-переглядач. Вони відкриті та вільні для редагування будь-ким, хто цього забажає. Система автоматично створює перехресні гіперпосилання між сторінками. Докладнішу інформацію дивіться на сторінці ВікіВікіВеб.

МоінМоін - програма вікі, що написана на python.

Для чого підходить вікі?

Вікі підходить для будь-чого ви його використовуєте. На відміну від форумів та списків розсилки ВікіВікі дозволяє створювати зміст сайту. Внаслідок чого Вікі містять менше шуму та більше інформації. Інформація структурована та легко відшукується. Можна встановити вікі на внутрішньому веб-сайті з багатьма сторінками, на яких описуються різні проекти, архітектури, ідеї, тощо, для додавання коментарів людьми. Деякі сторінки просто доводять до відома інформацію. Інші сторінки є відкритими для обговорення. Також ви можете встановити вікі на у якості дуже простої бази даних.

Взагалі, вікі - здебільшого вільний у застосуванні засіб, чия цінність залежить від способу використання. Наприклад, сторінка у вікі може слугувати тій самій меті, що й гілка обговорення. Також можна використовувати вікі для спільної роботи над проектом.

Інші приклади використання дивіться на сторінці MoinMoinSuccessStories.

Які головні властивості Вікі?

Головні властивості вікі:

Як щодо безпеки у Вікі? Чи не вразлива Вікі для повного витирання чи спотворення саботажником?

Це - важливе питання. Взагалі, вікі НЕ забезпечує безпеки. (Це - правда!)

Для МоінМоін це змінено додаванням списків контролю доступу, дивіться ДовідкаСпискиКонтролюДоступу.

Але, припустімо ви не користуєтеся ACL, існує ймовірність випадкового чи навмисного пошкодження поточної сторінки у вікі.

Є два головних способи знецінення вікі. Перший - витирання, та другий - псування. Виправити витирання не складно, оскільки для кожної сторінки ведеться журнал змін (та резервні копії) і зміни можна досить просто повернути. Тож, при виявленні видалення чи значних витирань (що має бути досить швидким), сторінки можна швидко відновити до їх попереднього стану.

Явне та навмисне пошкодження усунути дещо складніше. Існує ймовірність, що хтось може ввести на сторінці некоректну інформацію, або змінити зміст сторінок, щоб інформація стала некоректною (наприклад, люди можуть змінити підписи сторінки, щоб надати їй вигляд ніби інша додала певний коментар, або хтось може змінити зміст абзацу і його сенс зміниться на діаметрально протилежний). У великій мірі цю проблему має будь-яка система для спільної роботи. На практиці, пошкодження вікі - дуже рідкісна подія, та той, хто слідкує за сторінкою (при потребі) може використовувати функцію стеження за сторінкою і відслідковувати додавання до неї нового матеріалу.

Іншими словами, філософія вікі - зміни вносяться вручну (відповідний термін для цього М'якаБезпека) з рідкими (винятковими) випадками саботажу, замість вбудовування функцій та додавання накладних витрат (як у реалізації так і при використанні) для запобігання пошкодженням спричинених саботажником.

Загальні питання щодо МоінМоін

MediaWiki більш відома система, розроблена на базі PHP, навіщо комусь замість неї використовувати МоінМоін?

Які є "за" та "проти" використання MediaWiki та MoinMoin?

Дивіться WikiEngineComparison.

Я бажаю, щоб деякі сторінки та їх підсторінки не були доступні кожному. МоінМоін це підтримує ?

Так, МоінМоін має гарну систему ACL, яка дозволяє вам вказувати які користувачі та групи користувачів керують певними сторінками. Докладнішу інформацію знайдете на сторінці ДовідкаСпискиКонтролюДоступу.

Питання щодо використання цього вікі

Пошук та доступ до інформації у вікі

Як можна виконувати пошук у вікі?

Наразі є багато способів пошуку та/або сканування вікі:

Як побачити що було зроблено у вікі за останній час?

Згори сторінки натисніть на посилання ОстанніЗміни.

Як отримати ОстанніЗміни за більш ранній період ніж виводиться зазвичай?

Увійдіть у вікі та виберіть термін до 90 днів. Цього досить?

Що це за дивні різнокольорові посилання, які я басу всюди?

Будь-які назви зі змішаними регістрами, для яких не створено сторінки відображатимуться у вигляді різнокольорових посилань.

Як перейти до домашньої сторінки?

У типовій темі, посилання на домашню сторінку користувача знаходиться згори сторінки, поблизу посилання ВашіНалаштування. У темі rightsidebar, це посилання знаходиться у бічній панелі "Користувач". Вам слід створити сторінку перший раз, коли ви відвідуєте її, сторінки користувачів є необов'язковими.

Редагування вікі

Як додати щось до вікі, або змінити некоректний зміст?

Якщо ви побачите щось, що ви захочете прокоментувати, доповнити чи змінити, просто натисніть на посиланні Правка або клацніть на значку згори сторінки. Сторінка відкриється у панелі редагування тексту у вашому веб-переглядачі, і ви просто вносите зміни. Модуль форматування вікі обробить введений вами текст. Якщо ви бажаєте надати тексту привабливого вигляду, можете використовувати більшість типів форматування, які дозволяє використовувати HTML. Підказки щодо форматування та приклади дивіться на сторінці ДовідкаФорматування.

Є якісь домовленості яких потрібно дотримуватися при додаванні інформації?

Їх небагато. Вони дозволяють зберігати в узгодженому стані певні види інформації. Одна важлива домовленість, що допомагає в узгодженні - це сторінки "Шаблонів".

Вікі підтримує "Шаблони", які використовуються при створенні нової сторінки. Якщо ви натиснете на одному з них при створенні сторінки, сторінка матиме структуру подібну до інших сторінок того ж типу. При створенні власної сторінки Вікі, слід використовувати сторінку ШаблонПерсональноїСторінки, яка доступна при створенні нової сторінки вікі.

Як можна додати не текстову інформацію до Вікі?

Якщо ця інформація вже існує на веб-сайті, просто додайте до вікі-сторінки посилання на неї. Виконайте наступні кроки:

Вікі автоматично створить гіпертекстове посилання з введеного тексту.

Посилання можна зробити "привабливішим" додавши опис до посилання у квадратних дужках. Опис буде виводитися на сторінці, але при натисканні на цьому відбудеться перехід за URL. Приклад:

  [http://your.domain.example/foo.html|Це буде текстове посилання]

виводить:

Це буде текстове посилання

Чи можна зробити текст кольоровим?

У таблиці це можливе без додаткових зусиль. У інших випадках треба встановити макрос Color2 який можна знайти на MacroMarket.

Як можна уникнути використання <<BR>> та натомість використовувати звичайні символи переведення рядка?

Використовуйте { { { та } } } для оформлення форматованого тексту у форматований абзац.

Як додати зображення до сторінки?

Можна додати до сторінки посилання на зображення. Приклад:

http://c2.com/sig/inter/wikibase.gif

виводить

http://c2.com/sig/inter/wikibase.gif

Як створити нову сторінку шаблону?

Шаблонами є сторінки які автоматично виводяться у списку варіантів при створенні нової сторінки. Будь-яка сторінка, що закінчується словом Template (дивіться page_template_regex) автоматично виводиться у цьому списку. Отже, якщо ви хочете , щоб сторінки певного типу мали подібний формат (подібні заголовки, структуру, тощо.), просто створіть сторінку, назва якої закінчується словом Template, та при створенні сторінок цього типу, обирайте цей шаблон та редагуйте його. Вікі заповнить для вас початковий зміст. Шаблони можна редагувати, як і будь-які інші сторінки вікі.

Для створення сторінки шаблону, просто створіть нову сторінку з назвою <щось>Template.

Додавання документів у інтранет

Якщо ви використовуєте МоінМоін у внутрішній мережі, може виявитися корисним створювати посилання на документи на спільних ресурсах, що доступні будь-кому, хто читає ваш вікі-сайт. Наприклад:

[file://///servername/sharename/full/path/to/file/filename.txt Натисніть, щоб прочитати filename.txt]

Ви також можете створювати посилання на файли з пробілами у назвах шляхом введення URL кодування пробілів(%20):

[file://///servername/sharename/full/path/to/file/filename%20with%20spaces.txt Натисніть, щоб прочитати файл з пробілами spaces.txt]

Додаткову важливу інформацію з цього питання можна переглянути на сторінці FileLinks.

Інший можливий варіант - скористатися дією ДодатиФайл.

Чи слід ''підписувати'' внесені мною зміни?

Якщо вони значущі, або ви хочете, щоб люди знали що їх внесли ви, тоді відповідь - так. Просто додайте @SIG@ після вашого коментарю. Не буде зайвим зробити відступ знизу від коментарю. Також можна оформити коментар курсивом, щоб він відрізнявся від основного змісту сторінки, яка коментується.

Проте, у деяких випадках можна просто вносити зміни анонімно. Прикладами замін, які не обов'язково (та навіть небажано) підписувати є виправлення орфографічних помилок, форматування, або тривіальна заміна слів.

Що буде, якщо я зітру елементи сторінки, а ви вважаєте, що вони потрібні? Вони витираються остаточно?

За необхідності, можна повернути попередню версію сторінки. Дивіться ЧомуВікіПрацює.

Додавання документів у інших форматах до вікі

Можна додавати HTML до вікі?

Якщо треба додати один рядок HTML, використовуйте макрос HTML. Це робиться додавання вашого тексту до параметрів макросу HTML, наприклад: <<HTML(<font size=+12>Великий шрифт</font>)>>

На сторінки це виглядатиме так: <<HTML(<font size=+12>Великий шрифт</font>)>>

Також можливо вставляти документ HTML у сторінку додаючи #format html до першого рядка сторінки. При цьому вся сторінка вважатиметься HTML (що ускладнює посилання на інші сторінки!) Впевніться, що ви додаєте лише зміст сторінки (а не заголовки HTML чи будь-які інші теги поза межами змісту, включаючи сам тег <BODY>).

Створення посилань у вікі

Як зробити посилання на зовнішній відносну до вікі сторінку, as with an html a tag?

Встановлення та налаштовування

Як активувати параметр "DeletePage" / "RenamePage"?

Щоб мати змогу видаляти та перейменовувати сторінки слід увійти у вікі (на сторінці ВашіНалаштування).

Як змінити стартову сторінку?

У файлі wikiconfig.py встановіть page_front_page = u'ІншаСтартоваСторінка'. Дивіться сторінку ДовідкаМови.

ДовідкаКонфігурування містить опис інших змінних, які можна змінити.

Захист від хвиль

MoinMoin має захист від надмірного використання, якщо ви змінюєте сторінки надто часто, або надто часто завантажуєте вкладення, ви можете побачити повідомлення: "You triggered the wiki's surge protection by doing too many requests in a short time". якщо ви хочете змінити цю поведінку, слід визначити surge_action_limits у файлі wikiconfig та змінити типові значення. Типові значення:

surge_action_limits = { # дозволяється макс. <число> <дія> запитів за <dt> секунд
        # дія: (число, dt)
        'all': (30, 30),
        'show': (30, 60),
        'recall': (5, 60),
        'raw': (20, 40),  # дехто використовує це для css
        'AttachFile': (90, 60),
        'diff': (30, 60),
        'fullsearch': (5, 60),
        'edit': (10, 120),
        'rss_rc': (1, 60),
        'default': (30, 60),
    }

Адміністрування Вікі

Як адмініструвати Вікі?

Багато адміністративної інформації наведено на сторінці СистемнаІнформація, включаючи кількість сторінок та, встановлені макроси та дії.

Ви можете встановити до !AdminPage, куди додати корисні макроси, а також інформацію про дійсне фізичне розташування сторінок, та макросів для одиноких сторінок чи іншого, чим може зацікавитись адміністратор вікі.

Докладніша інформація наведена на сторінці ДовідкаАдміністрування.

Як видалити користувача?

Найкращий спосіб (з версії 1.5.2) - це SuperUser, для переходу до ролі користувача, якого слід видалити, та у налаштуваннях обрати "Забути мене назавжди" та натиснути "Зберегти".

Можу я повернути попередню версію сторінки?

  1. натисніть на Info (або значку з маленькою літерою "i") у верхньому-правому куті.

  2. натисніть на посиланні revert у версії, яку треба повернути.

Щоб мати змогу повертати версію сторінки, слід увійти у вікі (через ВашіНалаштування).

Як оновити вікі?

Докладний опис на сторінці ДовідкаПоновлення

Довідка для розробників

З чого можна почати розробнику?

Якщо ви хочете допомогти нам у програмуванні, ви можете:

  1. Вивчити Python, якщо ви досі не знайомі з цією мовою: BeginnersGuide

  2. Вивчити основи МоінМоін на сторінці MoinDev

З чого почати дизайнеру чи перекладачу?

Якщо ви не програміст, але готові допомогти, погляньте на:

Діагностика МоінМіон

Якщо ви знайшли помилку чи виявили проблему, потрібно виконати деякі перевірки. Справжні помилки часто виводять повідомлення про помилку. Слід зберегти таку сторінку, відвідати MoinMoinBugs, пошукати чи є сторінка, що виглядає подібно, а потім створити нову сторінку помилки та вкласти стек виклику

Можете перевірити ваш вікі приєднанням ?action=test до стандартного URL. Потім ви попадаєте на сторінку з назвою "MoinMoin Diagnosis", на якій наведено багато інформації. Більшість якої має сенс лише для розробників, але якщо ви один з розробників чи знавець Python, вона може бути вам корисна.


Якщо тут немає відповіді на ваше питання, дивіться MoinMoinQuestions.