1

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

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

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

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

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

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

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

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

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

Поиск

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Мышь

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

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

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

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

HTML

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

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

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

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

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


Абзацы

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

Разметка

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

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

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

Результат

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

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

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

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

Разметка

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

Результат

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


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

Заголовки

Разметка

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

Display

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

Второй

Третий

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

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

Списки

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

Разметка

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

Результат

Пункты:

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

Разметка

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

Результат

Список дел:

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

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

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

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

Стили текста

Разметка

Результат

''курсив''

курсив

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

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

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

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

{{{код}}}

код

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

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

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

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

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

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

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

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

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

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

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

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

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

Таблицы

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

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

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

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

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

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

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

 ||<|2> 2 строки || строка 1 ||
 || строка 2 ||
 ||<-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 / 4 >  >>
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

Действия

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

WYSIWYG-редактор

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

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

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

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

Недостатки:

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

Соглашения

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

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

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

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