Справка:Руководство
Ниже приведены только основные сведения и специфические технические вопросы работы с нашим сайтом. Руководствуйтесь Руководством «MediaWiki».
- Установленная версия «MediaWiki», список и версии установленных расширений приведены здесь: Служебная:Версия.
- Список имеющихся шаблонов приведен здесь: Служебная:Все_страницы (выберите «Шаблоны»).
Общие сведения
Wiki-сайт (или просто Wiki) это совокупность страниц, которые могут быть связаны друг с другом несколькими способами, среди которых важнейшие это Wiki-ссылки, включение файлов, шаблоны и категории, рассмотренные ниже.
Каждую страницу можно просматривать и (при наличии соответствующих полномочий) редактировать, а также выполнять с ней ряд других действий, включая удаление и переименования. Эти действия указаны на вкладках страницы (не путайте со вкладками своего браузера, если он таковые поддерживает). На нашем сайте вкладки выглядят примерно следующим образом:
За вкладкой «Еще▼» скрыто выпадающее меню, скрывающее в данном случае еще две вкладки: «Удалить» и «Переименовать». В зависимости от ширины экрана, скрыто в меню может быть больше или меньше вкладок. В теме «Timeless» дополнительные вкладки вынесены вместо вкладки «Еще▼» в отдельное боковое меню «Инструменты для страниц» справа от основного содержимого страницы.
- Перед выпадающим меню отображается знак закрашенной или незакрашенной звезды ☆ или ★, в зависимости от того, находится ли данная страница в вашем списке наблюдения. После выпадающего меню — поле текстового поиска по сайту. Слева от вкладок страницы расположены заголовки вкладок более высокого уровня: «Статья» (для страниц, расположенных в основном пространстве, см. ниже) и «Обсуждение».
Имена страниц и пространства имен
Каждая страница в Wiki имеет имя, представляющее собой последовательность символов. В именах запрещены символы «#», «<», «>», «[», «]», «{», «}» и «|», Специальное значение имеют символы «:» и «/». Символ подчеркивания «_» синонимичен пробелу « ». Если страница начинается со строчной буквы, эта буква преобразовывается в прописную.
Особое назначение символа «:» заключается в том, что он отделяет имя (под)пространства именования от собственно имени страницы. Если этот символ отсутствует, страница расположена в основном пространстве именования Wiki. Например, статья «Тверская герменевтическая школа» размещена в основном пространстве, «Обсуждение Справки:VisualEditor» размещена в пространстве «Обсуждение Справки», а статья «Семинарий2020:Оглавление» — в пространстве «Семинарий2020».
Это важно по двум причинам:
- От пространства, в котором размещена статья, зависит ее доступность на чтение и редактирование отдельным группам посетителей сайта. Зарегистрированных посетителей администратор может включать в те или иные группы, управляя, таким образом, доступностью статей для них.
- Кроме того, пространства используются для организации работ, в частности, по предложенной процедуре переноса статей материалов из «Семинария» 2020 г.
В данный момент:
- Пространства имен, открытые по умолчанию, открыты как незарегистрированным, так и зарегистрированным посетителям только на чтение.
- Группе «Наблюдатели» пространства имен, открытые для редактирования по умолчанию, открыты для чтения.
- Группе «Наблюдатели» пространства имен обсуждений, открытые для чтения по умолчанию, открыты для записи.
- Группе «Авторы» пространства имен, открытые для редактирования по умолчанию, открыты для редактирования.
- Группе «Авторы» пространство имен «Семинарий2020» открыто для чтения, а пространство имен «Семинарий2020:Обсуждения» — для чтения и редактирования.
- Группе «Авторы» пространства имен «Семинарий2021» и «Семинарий2020:Обсуждения» открыты для чтения и редактирования.
- Группе «Авторы» пространства имен «Школа» и «Школа:Обсуждения» открыты для чтения и редактирования.
- Группе «Наблюдатели» пространство имен «Семинарий2020» открыто для чтения, а пространство имен «Семинарий2020:Обсуждения» — для чтения и редактирования.
Подстраницы
- Особое назначение символа «/» в имени страницы заключается в том, что он отделяет имя подстраницы от имени страницы, которой он принадлежит. Но мы, скорее всего, не будем пользоваться подстраницами в рабочих пространствах нашего сайта.
Просмотр страниц
Просмотр Wiki-страницы ничем не отличается от просмотра любой Web-страницы на любом сайте. При просмотре имя страницы обычно (если у страницы не изменен или не исключен заголовок) отображается в виде ее заголовка крупным шрифтом непосредственно после строки вкладок страницы.
Кроме того, имя страницы определенным образом присутствует в URL в адресной строке браузера; чаще всего (например, на сайтах фонда «WikiMedia» или на нашем сайте) оно просто включается в URL после протокола, имени сайта и имени каталога «wiki»: имени страницы «Рефлексия» на нашем сайте будет соответствовать URL «https://ru.hermepedia.org/wiki/Рефлексия». Пробелы при этом преобразуются в знаки подчеркивания, например страница «Богин, Георгий Исаевич» в «Русской Википедии» имеет URL «https://ru.wikipedia.org/wiki/Богин,_Георгий_Исаевич». Собственно, именно в URL вы гарантированно (если Web-мастер не сошел с ума) видите при просмотре страницы ее имя в том виде, в котором оно известно Wiki.
При просмотре Wiki-страницы можно свободно перемещаться по гиперссылкам, и если они ведут на другие Wiki-страницы того же сайта, они точно так же будут открываться на просмотр в виде обычных Web-страниц.
Любую страницу в пределах своих полномочий можно редактировать (а также создавать отсутствующие в Wiki страницы). Для этого нужно щелкнуть на вкладке страницы «Править» или «Править код».
- Во вкладке «Править» текст открывается в WYSIWYG-редакторе «VisualEditor». Его возможности находятся за пределами данного Руководства, с ними и можно ознакомиться в этом недопереведенном и недоредактированном тексте: Справка:Визуальный редактор/Руководство пользователя. Если этот редактор окажется полезным нашему коллективу, мы будем допереводить, редактировать и адаптировать под свои нужды его руководство. На странице Справка:VisualEditor отражены текущие проблемы работы с «VisualEditor» на нашем сайте.
Редактирование страниц: базовая разметка
По щелчку на вкладке «Править код» Wiki-страница открывается для текстового редактирования. Кроме того, на редактирование можно открыть и отдельный раздел страницы, щелкнув по ссылке «Править код» в строке с заголовком этого раздела.
Wiki-страницы пишутся на особом формальном языке, который называется Wiki-текстом или Wiki-разметкой, точнее, в данном случае, на его диалекте, употребимом в системе «MediaWiki», на которой построен наш сайт. Wiki-текст представляет собой естественно сложившийся и неединообразный язык разметки, который может выглядеть весьма угрожающе, но в своей основе очень прост и, как показывает практика, с некоторыми оговорками достаточно удобен. По крайней мере, освоение основных возможностей оформления текста не должно занять более получаса.
Wiki-текст включает в себя буквальный текст страницы и элементы разметки, включающие скобочные конструкции (с использованием прямых, ломаных и фигурных скобок), парные цепочки апострофов и некоторые другие символы. На нашем сайте установлено расширение «CodeMirror», обеспечивающее подсветку формального синтаксиса Wiki-текста, так что при редактировании эти элементы выделены цветом.
Буквальный текст отображается буквально, одиночные концы строк игнорируются, абзацы выделяются двойными концами строк.
Структура текста определяется заголовками различных уровней, заголовок размещается в отдельной строке и обрамляется цепочками символов «=», количество которых соответствует уровню заголовка. В Wiki принято использовать заголовки, начиная со второго уровня. Материал, относящийся к одному заголовку этого уровня, называется разделом (к заголовку третьего уровня — подразделом, четвертого — подподразделом и т. п.).
Если страница содержит четыре или более заголовков (любого уровня), при ее отображении перед первым заголовком автоматически отображается оглавление страницы. (Наличие оглавления, место его размещения и глубину вложения отображаемых в нем заголовков при желании можно изменить.)
Звездочки «*» в начале строки задают пункты ненумерованного перечня, диезы «#» — нумерованного, точки с запятой — элементы ассоциативного перечня (перечня определений), двоеточия — отступы.
Обычное выделение (курсивом) задается парой апострофов «''», а сильное (полужирным) — тройкой апострофов «'''».
| Редактируем | Просматриваем |
|---|---|
|
== Это заголовок раздела == Текст можно выделять ''курсивом'' или '''полужирным'''. Но '''''полужирный курсив''''' выглядит страшновато. ===Это заголовок подраздела=== Вот ненумерованный перечень: * собаки * кошки ** ласковые ** кусачие А это нумерованный перечень: # Собаки. # Кошки. ## Ласковые. ## Кусачие. А это словарик: ; кошки, кусачие : кошки, которые кусаются ; кошки, ласковые : кошки, которые кусаются редко ; собаки : кусачесть собак науке неизвестна
|
Это заголовок раздела Текст можно выделять курсивом или полужирным. Но полужирный курсив выглядит страшновато. Это заголовок подраздела Вот ненумерованный перечень:
А это нумерованный перечень:
А это словарик:
|
Собственно, это и есть базовые элементы разметки, используемые для структурирования текста. Если выделение курсивом и полужирным шрифтом считать выделением важного и очень важного, соответственно, то всю эту разметку можно считать семантической, а не декоративной.
Более подробно о декоративной разметке можно услышать от мальчишек на улице.
Редактирование страниц: Wiki-ссылки и внешние гиперссылки
Один из механизмов обеспечения связности Wiki — Wiki-ссылки, то есть ссылки одной страницы на другую в том же Wiki. При просмотре Wiki-сайта они выглядят как обычный текст с гиперссылкой, ведущей на страницу того же сайта (если ее не существует, она выделяется красным), а вот при редактировании задаются совсем просто.
Если текст, которому, придается Wiki-ссылка, совпадает с именем страницы, на которую следует сослаться, он просто заключается в двойные прямые скобки. Если отличается — в двойные прямые скобки помещается конструкция из двух частей, разделенных вертикальной чертой «|», слева от которой помещается имя необходимой страницы, а справа — собственно текст. Если с именем статьи совпадает часть текста (что естественным образом бывает при некоторых, например, русских флексиях), можно поместить в скобочную конструкцию совпадающую часть. Все три Wiki-ссылки в примере ниже ссылаются на страницу «Деятельность».
Wiki-страницы могут содержать также ссылки на внешние ресурсы. Они помещаются в одиночные прямые скобки «[» и «]». Если скобочная конструкция содержит пробел, как URL ссылки интерпретируется часть до пробела, а то, что идет после — как текст. Если в прямые скобки помещен текст, не представляющий допустимого URL до пробела, весь этот текст, включая обрамляющие скобки, интерпретируется как буквальный. В примере ниже продемонстрировано и то, и другое, и третье.
| Редактируем | Просматриваем |
|---|---|
| См. статью «[[Деятельность]]». В ней говорится о [[Деятельность|деятельности]]. Необходимость такой статьи обусловлена всей нашей [[деятельность]]ю. А это ссылка на статью «Деятельность»[https://ru.wikipedia.org/wiki/Деятельность] в «[https://ru.wikipedia.org Русской Википедии]». А это просто [текст в прямых скобках]. | См. статью «Деятельность». В ней говорится о деятельности. Необходимость такой статьи обусловлена всей нашей деятельностью. А это ссылка на статью «Деятельность»[1] в «Русской Википедии». А это просто [текст в прямых скобках] |
Редактирование страниц: использование шаблонов
Еще один механизм обеспечения связности страниц в Wiki — это шаблоны. Шаблоны лишь немногим сложнее в использовании, чем ссылки, но намного интереснее. По сути, шаблоны являются душой любого развитого Wiki-проекта. Значимость шаблонов растет со временем.
Прежде всего, шаблоны экономят усилия при вводе однотипных текстов и (или) элементов оформления, обеспечивают единообразие оформления материала.
- Кроме этого, шаблоны могут обеспечивать не только синтаксическую и графическую, но и семантическую связность проекта, в том числе, замещая собой примитивную систему категоризации страниц, о которой будет сказано дальше. Но к этому мы придем лишь спустя некоторое время.
Попросту говоря, шаблон — это способ вставить одну страницу в другую; при этом то, что именно и как вставляется, может зависеть от параметров шаблона.
Вызов шаблона без параметров
Но в простейшем случае вызов шаблона осуществляется без параметров, и одна страница просто вставляется в другую в том виде, в котором она присутствует в Wiki. Например, при помещении на наш сайт материалов «Семинария» я проставил в конце каждой страницы вызов специально написанного шаблона Шаблон:РФФИ1901200393, который содержит просто плашку с упоминанием гранта, которым было поддержано исследование.
| Редактируем | Просматриваем | |
|---|---|---|
| {{РФФИ1901200393}} |
|
Как видно из этого примера, для вызова (простановки) шаблона достаточно заключить его имя в двойные фигурные скобки, и, в отличие от Wiki-ссылок, если пространство имен для страницы, используемой в качестве шаблона, явно не указано, шаблоны берутся из пространства «Шаблон», которое, собственно, для их размещения и предназначено.
Важно понимать, что содержимое шаблона не подставляется в страницу при ее сохранении после редактирования. В тексте страницы сохраняется лишь вызов шаблона, а его содержимое подставляется при просмотре страницы в своем актуальном состоянии, а не в состоянии на момент вставки. Поэтому, если в какой-то момент мы, допустим, заметим опечатку в тексте шаблона, или захотим поменять включенную в него иллюстрацию или цвет плашки с серый на голубой, или даже захотим сделать цвет плашки зависимым от темы оформления, применяемым каждым посетителям, нам достаточно будет отредактировать шаблон, а те десятки страниц, на которых он проставлен, трогать не потребуется.
Вызов шаблона с нумерованным параметром
Но более интересны параметризованные вызовы шаблонов. Параметры шаблонов в Wiki-разметке бывают нумерованные и именованные. Для примера рассмотрим несколько шаблонов, требующих указания строго одного параметра, которые я написал параллельно этому руководству. У них у всех однобуквенные имена и предназначены они для стилей оформления, отсутствующих в Wiki-разметке в ее первозданном виде, а именно — разрядки, подчеркивания, заглавных букв, капители. Всем им в качестве первого единственного параметра передается, собственно, текст, который предполагается оформить соответствующим образом. При вызове шаблона параметры отделяются от его имени (и друг от друга, если их несколько) вертикальной чертой «|». Все это должно быть понятно из примера, и обратите внимание на разницу между ссылкой на шаблон, которая проставляется, как и на любую другую страницу, в прямых скобках, и его вызовом в фигурных и сопровождающимся указанием параметров.
| Редактируем | Просматриваем |
|---|---|
| [[Шаблон:А]] позволяет {{а|выделить текст заглавными}}, [[Шаблон:К]] — {{к|выделить текст капителью}}, [[Шаблон:П]] — {{п|подчеркнуть текст}}, [[Шаблон:Р]] — {{р|дать текст вразрядку}}.
При применении {{п|вызовы шаблонов можно {{р|вкладывать}} самым странным {{а|образом}}}}. Вызовы этих шаблонов можно сочетать с {{р|апострофным ''форматированием'' '''текста'''}} также ''разнообразными {{р|способами}}, пока'' текст вовсе не потеряет читаемости. |
Шаблон:А позволяет выделить текст заглавными, Шаблон:К — выделить текст капителью, Шаблон:П — подчеркнуть текст, Шаблон:Р — дать текст вразрядку.
При применении вызовы шаблонов можно вкладывать самым странным образом. Вызовы этих шаблонов можно сочетать с апострофным форматированием текста также разнообразными способами, пока текст вовсе не потеряет читаемости. |
Вызов шаблона с переменным количеством нумерованных параметров
Шаблоны могут допускать или требовать указания более одного параметра. Я создал такой шаблон, который принимает от нуля до трех параметров и ведет себя по-разному в зависимости от их количества. Обратите внимание, что при указании более одного параметра они отделяются друг от друга такой же вертикальной чертой «|», которая отделяет параметр или параметры от имени вызываемого шаблона.
| Редактируем | Просматриваем |
|---|---|
| [[Шаблон:Ц]] с тремя параметрами позволяет отобразить текст, указанный в качестве первого параметра, цветом, указанным в качестве второго, на фоне цвета, указанного в качестве третьего: {{ц|красное на черном|red|black}}.
Если тот же шаблон вызывается с двумя параметрами, отобразится текст, указанный в качестве первого параметра, цветом, указанным в качестве второго, на фоне цвета, совпадающего с фоном страницы: {{ц|зеленое на обычном фоне|green}}. Если тот же шаблон вызывается с одним параметрами, отобразится текст, указанный в качестве параметра, красным цветом на фоне цвета, совпадающего с фоном страницы: {{ц|красное на обычном фоне}}. Если тот же шаблон вызывается без параметров, отобразится текст «Важно! » красным цветом на фоне цвета, совпадающего с фоном страницы: {{ц}} |
Шаблон:Ц с тремя параметрами позволяет отобразить текст, указанный в качестве первого параметра, цветом, указанным в качестве второго, на фоне цвета, указанного в качестве третьего: красное на черном.
Если тот же шаблон вызывается с двумя параметрами, отобразится текст, указанный в качестве первого параметра, цветом, указанным в качестве второго, на фоне цвета, совпадающего с фоном страницы: зеленое на обычном фоне. Если тот же шаблон вызывается с одним параметрами, отобразится текст, указанный в качестве параметра, красным цветом на фоне цвета, совпадающего с фоном страницы: красное на обычном фоне. Если тот же шаблон вызывается без параметров, отобразится текст «Важно! » красным цветом на фоне цвета, совпадающего с фоном страницы: Важно! |
Теперь вы знаете про вызовы шаблонов с нумерованными параметрами практически все. Обратите внимание, что если вы пройдете на страницу шаблона по ссылке, например, «Шаблон:Ц», и если его автор не слишком спешил, вы увидите какую-никакую документацию, из которой будет более или менее ясно, что он делает, сколько параметров принимает, и какие из них обязательны. Совершенно не очевидно, что список всех доступных на сайте шаблонов можно посмотреть вот так: https://ru.hermepedia.org/wiki/Служебная:Все_страницы?&namespace=10.
- А если вам интересно, как шаблон написан, откройте его страницу на редактирование.
Вызов шаблона с именованными параметрами
Шаблоны с нумерованными параметрами создаются обычно в случаях, когда таких параметров не больше трех или в инженерных целях (для использования в других шаблонах). Ведь даже для часто используемого шаблона запомнить семантику параметров и порядок их следования трудно. Поэтому для сильно параметризованных шаблонов используют обычно другой механизм: именованные параметры. Так же, как и в случае нумерованных, именованные параметры отделяются от имени вызываемого шаблона и друг от друга вертикальной чертой «|», но представляют собою пары из имени параметра и значения.
Рассмотрим это на примере полезного нам шаблона «Шаблон:Статья». В примерах ниже он вызывается с некоторым разумным минимумом параметров, а всего их у этого шаблона 27.
| Редактируем | Просматриваем |
|---|---|
| {{статья
| автор = {{автор|Лепский, Владимир Евгеньевич|Лепский В. Е.}} | заглавие = Рефлексия в работах Г. П. Щедровицкого и В. А. Лефевра | ссылка = | издание = Рефлексивный подход: от методологии к практике | издатель = Когито-центр | место = М. | год = 2009 | страниц = 447 | страницы = 27—38}} {{статья | автор = {{автор||Морозова Г. В.}} | заглавие = Взаимосвязь рефлексивности и созависимости как особенностей профессиональной рефлексии педагога | ссылка = http://www.fundamental-research.ru/ru/article/view?id=28583 | издание = Фундаментальные исследования | год = 2011 | номер = 8—3 | страницы = 572—575}} |
Лепский В. Е. Рефлексия в работах Г. П. Щедровицкого и В. А. Лефевра // Рефлексивный подход: от методологии к практике. — М., 2009. — С. 27—38.
Морозова Г. В. Взаимосвязь рефлексивности и созависимости как особенностей профессиональной рефлексии педагога // Фундаментальные исследования. — 2011. — № 8—3. — С. 572—575. |
Как видно из примеров, параметры можно указывать хоть в одной строке, хоть разбивая вызов шаблона на несколько строк, как удобно автору страницы. В качестве значений параметров можно передавать не только текстовые константы, но и вызовы других шаблонов, как это показано на примере очень полезного шаблона Шаблон:Автор. Впрочем, все это относится и к передаче нумерованных параметров.
На нашем сайте размещены два сильно параметризованных шаблона: Шаблон:Статья и Шаблон:Книга, адаптированных с некоторыми потерями из применяющихся в «Русской Википедии». Документация по ним заимствована оттуда же и понемногу приводится в порядок. Они должны быть полезны при оформлении библиографического материала.
- Вообще, я надеюсь, мы через некоторое время перейдем на семантические библиографические шаблоны. Если интересно, как это может выглядеть, можно почитать, например, эту статью: Semantic Cite Но простановка обычных шаблонов не будет лишней, так как их можно будет потом аккуратно преобразовать в автоматическом или полуавтоматическом режиме.
Проблемы
Специальные вопросы
Это интересно только для почтальонов:
| Это статья — часть Руководства проекта «Гермепедия». В терминах авторского права авторы бессрочно и безотзывно передают ее в общественное достояние. |
