LinuxMM:

Что такое вики?

Вики (также называемая ВикиВики или ВикиВикиСеть) — это коллекция веб-сайтов, которые посетители могут не только читать, но и изменять, быстро и просто. «Вики-вики» в переводе с гавайского означает «быстрый».

Первая ВикиВикиСеть был разработана и запущена Уордом Каннингэмом в 1995 году. Идея редактируемого содержимого во Всемирной Сети прослеживается ещё у изобретателя самого WWW, Тима Бёрнерса-Ли.

Особенности вики

  • Открытость: большое количество сайтов, где любой может править что угодно
  • Простота и быстрота: вы можете создавать и сохранить информацию, которая тут же становится доступна. Наполнение более важно, чем оформление.
  • Надёжность: МойнМойн сохраняет все версии страниц

  • Высокая связность: информация на страницах часто насыщена ссылками на другие страницы вики
  • Доступность: для доступа к вики необходимы только обозреватель и интернет-соединение
  • Гибкость: в вики можно сохранять различные виды информации: учебные курсы, лекции, результаты мозговых штурмов...

Что такое МойнМойн

МойнМойн — программное обеспечение для обеспечения работы вики-сайта.

МойнМойн доступен под лицензией GPL и реализован на языке программирования Python. Вклад участников также делается на Python под лицензией GPL.

Поиск информации

МойнМойн предоставляет ряд способов поиска информации на вики:

Поиск

  • Форма поиска в области навигации в верхней части страницы

    • Для поиска по заголовкам достаточно ввести ключевое слово и нашать «Enter» (или кликнуть по кнопке «Titles»)

    • Для полнотекстового поиска, введите ключевые слова и кликните по кнопке «Text»

  • Пункт меню «НайтиСтраницу»

    • Содержит индексы всех страниц, отсортированные по именам страниц и количеству слов в имени страницы
    • Расширенные возможности поиска

(!) Поиск по заголовкам может также использоваться для доступа к страницам, название которых Вы помните только приблизительно

Дополнительную информацию можно получить на странице КакИскать.

Навигация на вики

Быть в курсе событий

На вики многое может меняться за короткое время ввиду того, что каждый может править, добавлять или удалять страницы в любое время.

Вы можете с лёгкостью отслеживать все эти изменения на странице ПоследниеИзменения.

Для каждой записи, присутствующей на данной странице, доступны:

  • Ссылка на страницу с просмотром разницы между версиями
  • Ссылка на изменённую страницу (также, как и на информацию об этой странице)
  • Время изменения
  • Автор изменения
  • Комментарий, указанный при изменении

(!) Если вы представились вики, вы можете установить закладку, используя эту страницу. В этом случае вики запомнит, какие изменения Вы уже видели, и будет показывать только изменения, произошедшие после отмеченного момента.

Создание учётной записи

Использовать вики зачастую можно без создания учётной записи (это зависит от настроек прав доступа).

Тем не менее, использовать учётную запись в вики лучше и проще по следующим причинам:

  • можно устанавливать закладки на странице ПоследниеИзменения;

  • наличие учётной записи позволяет настроить область навигации;
  • в настройках учётной записи можно указать часовой поиск;
  • можно подписаться на страницы и получать уведомления при их изменении;
  • и многое другое.

Для создания учётной записи, нажмите ссылку «вы можете создать её сейчас» на странице входа в систему. После чего нужно указать:

  • имя учётной записи (предпочтителен вариант ИмяФамилия);

  • пароль (не стоит задавать его слишком простым);
  • повторить пароль (для предотвращения опечаток при наборе его в предыдущем поле);
  • почтовый адрес (для уведомлений или на случай забытого пароля).

/!\ После заполнения полей формы необходимо нажать на кнопку «Create Profile» /!\

Учётная запись будет создана и Вы сможете представиться вики используя указанные ранее имя и пароль.

(!) Если Вы представлены системе, то Ваше имя отображается в области навигации

Пользовательские настройки

После создания учётной записи и входа в вики, можно изменить пользовательские настройки и предпочтения (нажмите на ссылку «Settings» в верхней части страницы).

Значения по умолчанию обычно удовлетворяют большинству предпочтений, но Вы, возможно, захотите указать:

  • Часовой пояс (для преобразования времени по Гринвичу (или другого часового пояса по умолчанию на вики) в Ваше локальное время).
  • Размер поля ввода при редактировании (зависит от Ваших разрешения экрана и размера шрифта).
  • Возможно, предпочитаемый язык (необязательно для обозревателя с настроенным предпочитаемым языком).

После завершения процесса настройки нажмите на кнопку «Save» в нижней части страницы.

Собственная домашняя страница

После создания учётной записи и входа в систему в области навигации будет отображаться имя Вашей учётной записи, которое является ссылкой и ведёт на одноимённую страницу — Вашу персональную страницу.

При переходе по этой ссылке, вы сможете наблюдать одну из уникальных особенностей вики: вместо получения сообщения об ошибке «404 Страница не найдена», обычно возвращаемого в случае запроса несуществующих страниц, вики предложит Вам создать новую страницу.

После следования предложенным инструкциям, вики отобразит шаблон домашней страницы в форме редактирования.

Вы можете создать домашнюю страницу, отталкиваясь от этого шаблона, добавить необходимые комментарии и сохранить страницу, нажав на кнопку «Save Changes».

Текстовый редактор

В процессе создания домашней страницы использовался текстовый редактор МойнМойн. Конечно, он может использоваться для редактирования не только этой, но и любой страницы на вики. Вы можете начать редактирование нажатием на «Edit» или «Edit (Text)» в области навигации и МойнМойн отобразит текстовый редактор для изменения текущей страницы.

(!) Вы не можете ничего испортить, поскольку предыдущие версии страницы сохраняются и при необходимости могут быть восстановлены.

Важно часто использовать функцию «Preview» во время редактирования страницы, так как это (помимо предварительного просмотра изменённой страницы) позволяет МойнМойн создать резервную копию редактируемого варианта страницы.

По окончании редактирования, добавьте комментарий к изменению в соответствующее поле (он будет отображаться на странице «RecentChanges» и в истории правок страницы) и нажмите кнопку «Save».

В случае одновременного редактирования страницы несколькими людьми, у первого сохранившего свой вариант не возникнет никаких проблем. Все последующие редакторы получат предупреждение о том, что страница была изменена и должны будут объединить свои правки с уже внесёнными.

(!) Не следует возвращаться к редактору посредством истории посещённых страниц обозревателя, так как это может привести к непредсказуемым конфликтам редактирования. Вместо этого, используйте ссылку «Edit» повторно.

Если Вы не хотите сохранять свои изменения, используйте кнопку «Cancel» для оповещения МойнМойн о том, что вы закончили редактирование страницы.

Дополнительная информация по процессу редактирования доступна на странице КакРедактировать.

Сочетания клавиш

Часто используемые во время редактирования сочетания клавиш:

  • Shift + стрелки управления курсором — выделение

  • Ctrl + C — копировать в буфер обмена

  • Ctrl + X — вырезать в буфер обмена

  • Ctrl + V — вставить из буфера обмена

  • Ctrl + Z — отмена последних правки

  • Ctrl + Y — восстановление последних отменённых правок (доступно, только если не было других правок с момента отмены)

Мышь

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

  • (!) Linux и другие UNIX-подобные ОС / X11: При выделении мышью выделенные текст копируется в буфер, вставить его можно нажатием средней кнопки мыши в нужном месте.

Форматирование текста с использованием вики-разметки

В МойнМойн для форматирования текста используется не HTML (HyperText Markup Language, гипертекстовый язык разметки, используемый в web для представления страниц), а собственный, ориентированный на простоту чтения и редактирования, способ разметки текста — язык вики-разметки МойнМойн1.

Удобство использования специализированной разметки можно увидеть на следующем примере, демонстрирующем разметку одной и того же документа:

HTML

<h1>Заголовок</h1>
<p>Ссылка на мою домашнюю страницу: <a href="/ИмяФамилия">ИмяФамилия</a></p>
<p>Список:
<ul>
 <li>Первый</li>
 <li>Второй</li>
</ul>
</p>

Вики-разметка МойнМойн

= Заголовок =
Ссылка на мою домашнюю страницу: ИмяФамилия

Список:
 * Первый
 * Второй

(!) Вики-разметка МойнМойн подробно будет рассмотрена далее.


Абзацы

Простейший способ ввода текста на вики аналогичен тому, что необходимо делать в текстовых процессорах — просто начать писать. Единственное отличие — для начала нового абзаца требуется вставить два перевода строки, а не один.

Разметка

Первый абзац.
Всё ещё первый абзац.

Второй абзац.

Третий абзац.

Результат

Первый абзац. Всё ещё первый абзац.

Второй абзац.

Третий абзац.

Разделительные линии

Разметка

Первая часть.
----
Вторая часть.

Результат

Первая часть.


Вторая часть.

Заголовки

Разметка

= Заголовок первого уровня, содержащий символ = =
== Второй ==
=== Третий ===
... (и так далее, до пятого уровня)

Display

Заголовок первого уровня, содержащий символ =

Второй

Третий

... (и так далее, до пятого уровня)

(!) Если заголовок отображается некорректно, то чаще всего это происходит по следующим причинам:

  • После закрывающего символа «=» есть другие (невидимые) символы (их можно удалить как вручную, так и с помощью опции «Remove trailing whitespace from each line»).

  • Количоство открывающих закрывающих символов «=» не совпадает.

Списки

Ненумерованные

Разметка

Пункты:
 * Пункт
 * Ещё пункт
  * Подпункт

Результат

Пункты:

  • Пункт
  • Ещё пункт
    • Подпункт

Нумерованные

Разметка

Список дел:
 1. Дело
 1. Ещё дело
  1. Поддело

Результат

Список дел:

  1. Дело
  2. Ещё дело
    1. Поддело

(!) МойнМойн нумерует элементы списка самостоятельно.

(!) Количество пробелов определяет уровень иерархии в списке

Больше примеров возможностей можно найти в ПомощьПоСпискам.

Стили текста

Разметка

Результат

''курсив''

курсив

'''полужирное начертание'''

полужирное начертание

`моноширинный шрифт`

моноширинный шрифт

{{{код}}}

код

__подчёркивание__

подчёркивание

^верхний^индекс

верхнийиндекс

,,нижний,,индекс

нижнийиндекс

~-уменьшенный шрифт-~

уменьшенный шрифт

~+увеличенный шрифт+~

увеличенный шрифт

--(перечёркивание)--

перечёркивание

(!) Также см. КакРедактировать.

Таблицы

Простейшая таблица

 || один || два || три ||
 || четыре || пять || шесть ||
  • один

    два

    три

    четыре

    пять

    шесть

Управление размещением ячеек

 ||||||<tablewidth="80%">'''Заголовок'''||
 ||Ячейка 1||Ячейка 2||Ячейка 3||
 ||<rowspan=2> Ячейка, занимающая две строки||||<bgcolor="#AAAAFF"> Ячейка, занимающая два столбца||
 ||<rowbgcolor="#FFFFAA">Ячейка 2||Ячейка 3||
  • Заголовок

    Ячейка 1

    Ячейка 2

    Ячейка 3

    Ячейка, занимающая две строки

    Ячейка, занимающая два столбца

    Ячейка 2

    Ячейка 3

Ширина ячейки

 || Узкая ||<:99%> Широкая ||
  • Узкая

    Широкая

Распределение ячеек по нескольким строкам и столбцам

 ||<|2> 2 строки || строка 1 ||
 || строка 2 ||
 ||<-2> строка 3, 2 столбца шириной ||
  • 2 строки

    строка 1

    строка 2

    строка 3, 2 столбца шириной

Выравнивание

 ||<(50%> по левому краю ||<^|3> по верхней границе ||<v|3> по верхней границе ||
 ||<:> по центру ||
 ||<)> по правому краю ||
  • по левому краю

    по верхней границе

    по верхней границе

    по центру

    по правому краю

Цвета

 ||<#FF0000> красный ||<#00FF00> зелёный ||<#0000FF> синий ||
  • красный

    зелёный

    синий

Внутренние ссылки на вики

Одна из важнейших возможностей вики — добавление ссылок на другие вики-страницы, посему это достаточно просто.

ВикиИмена («верблюжий регистр»)

Если Вы пишете слова вместе, например, ИмяФамилия, ВерблюжийРегистр, МойнМойн — то есть, несколько слов, начинающихся с заглавных букв и содержащих строчные, написанные слитно, то МойнМойн автоматически создаст ссылку из этого слова на одноимённую страницу. Для предотвращения создания ссылки достаточно предварить слово восклицательным знаком.

Разметка

ВерблюжийРегистр !ВерблюжийРегистрНеПреобразованныйвСсылку

Результат

ВерблюжийРегистр ВерблюжийРегистрНеПреобразованныйвСсылку

Простота данного способа заключается в отсутствии необходимости дополнительной вики-разметки. Но данный способ не всегда приемлем (или возможен), посему существует альтернативный способ, так называемая «свободная ссылка».

Свободные ссылки

Если необходимо сослаться на страницу, имя которой не в верблюжьем регистре, то можно поступить следующим образом:

Разметка

[[Свободная ссылка]] на [[другая страница|другую страницу]].

Результат

Свободная ссылка на другую страницу.

Ссылки на данную страницу

Если кликнуть по имени страницу в области навигации, вики отобразит все страницы, ссылающиеся на данную.

Это может использоваться, например для отслеживания страниц, содержащих те или иные метки, например, категории. Другой пример:

НадоСделать: Позвонить родителям...

«НадоСделать» набрано в верблюжьем регистре, посему представляет из себя ссылку на страницу (которая, впрочем, не обязана существовать).

(!) Но это не мешает перейти по ссылке и кликнуть по имени страницы, чтобы найти страницы, содержащие «НадоСделать».

Внешние ссылки

Также можно давать ссылки на внещние интернет-ресурсы.

Пример

http://example.net/

[[http://moinmoin.in/|Вики МойнМойн]]

ftp://example.org/pub/

{{http://static.moinmo.in/logos/moinmoin.png}}

Результат

http://example.net/

Вики МойнМойн

ftp://example.org/pub/

http://static.moinmo.in/logos/moinmoin.png

(!) Можно заметить, что [[...]] создаёт ссылку на ресурс, а {{...}} включает его на страницу. Это особенно полезно для изображений.

Прикрепляемые файлы

В МойнМойн можно прикреплять файлы к вики-страницам.

Пример

[[attachment:letter.txt]]

{{attachment:photo.jpg}}

Результат

letter.txt

[ATTACH]

(!) Пока файлы не загружены:

  • Ссылки на них серые (как ссылки на несуществующие страницы)
  • Изображение скрепки отображается вместо вставленных по месту несуществующих изображений.

Можно кликнуть по этим ссылкам и загрузить локальный файл на вики, используя обозреватель. После чего ссылки на прикреплённые файлы станут синими, а изображения будут отображаться.

Дополнительная информация доступна на странице ПомощьПоДействиям/AttachFile.

Символы

МойнМойн также позволяет использовать различные предопределённые графические знаки и обозначения, например, смайлы:

Markup Display Markup Display Markup Display Markup Display
X-( X-( :D :D <:( <:( :o :o
:( :( :) :) B) B) :)) :))
;) ;) /!\ /!\ <!> <!> (!) (!)
:-? :-? :\ :\ >:> >:> |) |)
:-( :-( :-) :-) B-) B-) :-)) :-))
;-) ;-) |-) |-) (./) (./) {OK} {OK}
{X} {X} {i} {i} {1} {1} {2} {2}
{3} {3} {*} {*} {o} {o}    

Также см. КакУлыбаться.

(!) Следующие четыре слайда посвящены более глубоким темам. Если они Вам неинтересны, их можно пропустить.

Динамическое содержимое

МойнМойн построен по модульному принципу, и его функции могут расшираться путём добавления дополнений. Макрокоманды, парсеры, действия, и многое другое могут быть как встроенными, так и установленными как дополнение.

Макрокоманды

Макрокоманда является частью вики-разметки и вызывается с указанными параметрами для генерирования информации, отображаемой в месте указания марокоманды.

Парсеры

Парсер вызывается для обработки некоего текста и генерации на его основе информации, отображаемой в указанном месте.

Действия

Действия обычно вызываются посредством меню (или макрокоманды) и самостоятельно генерируют HTML-страницы.

Макрокоманды

Макрокоманда вызывается указанием в тексте разметки «<<Макрокоманда(параметр)>>». Набор допустимых параметров зависит от макрокоманды и иногда не используется.

Пример

Содержание:
<<TableOfContents>>
----
Текст со сноской.<<FootNote(Это — сноска.)>>

|| <<MonthCalendar>> || <<MonthCalendar(,2000,1)>> ||
----
Некоторый момент времени: <<DateTime(2006-01-26T23:03:25Z)>>

Результат

Содержание:


Текст со сноской.2

<< <  2024 / 11 >  >>
Mon Tue Wed Thu Fri Sat Sun
        1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30  

<< <  2000 / 1 >  >>
Mon Tue Wed Thu Fri Sat Sun
          1 2
3 4 5 6 7 8 9
10 11 12 13 14 15 16
17 18 19 20 21 22 23
24 25 26 27 28 29 30
31            


Некоторый момент времени: 2006-01-26 23:03:25

Парсеры

Пример

 {{{#!highlight python
 def hello(name):
     print "Hello %s" % name
 }}}

Результат

   1 def hello(name):
   2     print "Hello %s" % name

Действия

Некоторые примеры встроенных действий:

  • Информация о странице (в области навигации).

  • Часть функции поиска.
  • Прикреплённые файлы (действие «AttachFile»).

  • Все пункты, вызываемые через меню действий.

WYSIWYG-редактор

Как альтернативу вводу вики-разметки в текстовом редакторе, МойнМойн также предоставляет WYSIWYG (what you see is what you get, «что видишь, то и получишь») редактор, который похож на используемые для тектового процессинга.

Для его работы требуется современная ферсия Firefox, Safari или Internet Explorer с включенным JavaScript.

Вы можете укзаать предпочитаемый редактор в пользовательских настройках; кроме того, вы можете переключаться между WYSIWYG и текстовым редактором во время редактирования.

Преимущества WYSIWYG-редактора:

  • Он симпатичнее.
  • Он проще.

Недостатки:

  • Дольше загружается.
  • Не столь гибок.
  • Всё ещё содержит ошибки.

Создание новых страниц

Простейший и лучший способ создавать новые страницы:

  • Придумать хорошее имя страницы

  • Добавить ссылки на страницы, которые могут на неё ссылаться
  • Перейти по созданной ссылке
  • Подготовиться к редактированию используя:
    • Пустую страницу.
    • Шаблон страницы (список доступных шаблонов представлен в левой части страницы).
    • (!) Список страниц с похожим названием представлен справа на случай, если страница на аналогичную тему уже есть.

  • Начните редактирование, внесите информацию и сохраните её

(!) Данный метод гарантирует, что новые страницы доступны по ссылкам из существующих.

Этикет использования вики

На публичных вики, где многие люди работают вместе (и часто не знают друг друга), важно благожелательно относиться к другим.

Таким образом, если кто-то удалил что-то, что написали Вы, возможно, что это лишь потому, что Вы ошиблись иле не должны были вносить эти правки.

Аналогично, Вы должны, естественно, проявлять благожелательность по отношению к другим. В частности, не стоит изменять или удалять что-то, пока Вы не уверены в том, что делаете.

Персональная страница обычно считается «собственностью» определённого пользователя и не должна изменяться кроме как в целях оставления сообщений пользователю.

Примеры использования вики

Вики подходит для ряда приложений, так как при наличии описанных ранее особенностей её использования информация может быть любого характера. Вы можете использовать вики для всего, что представимо в виде связного набора страниц.

Примеры

  • Личные записки (вместо марания бумаги);
  • протоколы конференций;
  • списки задач;
  • новости на домашней странице вики, асинхронная коммуникация;
  • совместная разработка документации;
  • мозговые штурмы;
  • личные или совместные списки ссылок;
  • альтернатива почте или телефону;
  • … многое другое.

Организация структуры на вики

Уровни иерархии

Многие веб-сайты имеют разветвлённую структуру с многими уровнями иерархии.

В вики же активно используется связывание страниц посредством ссылок. Более плоская структура зачастую используется в целях упрощения:

  • Все важные темы имеют собственные странице в основном пространстве имён
  • Только в случае, если тема содержит множество подтем (которые, в свою очередь, не являются отдельными темами), используются вложенные страницы.

    (!) Вложенные страницы именуются как ОснованаяСтраница/ВложеннаяСтраница.

Соглашения

Вики даёт свободу выбора пользователям; в неё нет форматов ввода, как в клиентах баз данных, и Вы можете, в принципе, делать что угодно и как угодно.

Конечно, этого следует избегать для предотвращения создания полного хаоса.

Поэтому часто при создании новой вики обдумывают структуру и используемые соглашения, например:

  • Создание основной структуры страниц
  • Определение соглашений по именованию страниц
  • Решение об использовании «верблюжьего регистра» или ссылок произвольного вида
  • Определение набора основных категорий

Обычно старые вики просто опираются на использование существующих структур.

  1. МойнМойн позволяет также использовать другие языки разметки, например creole, HTML и др., подробнее см. ПомощьПоПарсерам (1)

  2. Это — сноска. (2)