Справка:Руководство: различия между версиями

Материал из Гермепедии
Строка 106: Строка 106:
<nowiki>А это словарик:</nowiki>
<nowiki>А это словарик:</nowiki>


<nowiki>; кусачие кошки</nowiki>
<nowiki>; кошки, кусачие</nowiki>


<nowiki>: кошки, которые кусаются</nowiki>
<nowiki>: кошки, которые кусаются</nowiki>


<nowiki>; ласковые кошки</nowiki>
<nowiki>; кошки, ласковые </nowiki>


<nowiki>: кошки, которые кусаются редко</nowiki>
<nowiki>: кошки, которые кусаются редко</nowiki>
<nowiki>; собаки </nowiki>
<nowiki>: кусачесть собак науке неизвестна</nowiki>
||
||


Строка 134: Строка 141:
## Кусачие.
## Кусачие.
А это словарик:
А это словарик:
; кусачие кошки
; кошки, кусачие
: кошки, которые кусаются
: кошки, которые кусаются
; ласковые кошки
; кошки, ласковые
: кошки, которые кусаются редко
: кошки, которые кусаются редко
; собаки
: кусачесть собак науке неизвестна
|}
|}



Версия 11:16, 15 августа 2021

Ниже приведены только основные сведения и специфические технические вопросы работы с нашим сайтом. Руководствуйтесь Руководством «MediaWiki».

Общие сведения

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

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

Читать | Править | Править код | История | Еще▼

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

Перед выпадающим меню отображается знак закрашенной или незакрашенной звезды ☆ или ★, в зависимости от того, находится ли данная страница в вашем списке наблюдения. После выпадающего меню — поле текстового поиска по сайту. Слева от вкладок страницы расположены заголовки вкладок более высокого уровня: «Статья» (для страниц, расположенных в основном пространстве, см. ниже) и «Обсуждение».

Имена страниц и пространства имен

Каждая страница в Wiki имеет имя, представляющее собой последовательность символов. В именах запрещены символы «#», «<», «>», «[», «]», «{», «}» и «|», Специальное значение имеют символы «:» и «/». Символ подчеркивания «_» синонимичен пробелу « ». Если страница начинается со строчной буквы, эта буква преобразовывается в прописную.

Особое назначение символа «:» заключается в том, что он отделяет имя (под)пространства именования от собственно имени страницы. Если этот символ отсутствует, страница расположена в основном пространстве именования Wiki. Например, статья «Тверская герменевтическая школа» размещена в основном пространстве, «Обсуждение Справки:VisualEditor» размещена в пространстве «Обсуждение Справки», а статья «Семинарий2020:Оглавление» — в пространстве «Семинарий2020».

Это важно по двум причинам:

  1. От пространства, в котором размещена статья, зависит ее доступность на чтение и редактирование отдельным группам посетителей сайта. Зарегистрированных посетителей администратор может включать в те или иные группы, управляя, таким образом, доступностью статей для них.
  2. Кроме того, пространства используются для организации работ, в частности, по предложенной процедуре переноса статей материалов из «Семинария» 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 принято использовать заголовки, начиная со второго уровня. Материал, относящийся к одному заголовку этого уровня, называется разделом (к заголовку третьего уровня — подразделом, четвертого — подподразделом и т. п.).

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

Звездочки «*» в начале строки задают пункты ненумерованного перечня, диезы «#» — нумерованного, точки с запятой — элементы ассоциативного перечня (перечня определений), двоеточия — отступы.

Обычное выделение (курсивом) задается парой апострофов «''», а сильное (полужирным) — тройкой апострофов «'''».

Редактируем Просматриваем

== Это заголовок раздела ==

Текст можно выделять ''курсивом'' или '''полужирным'''. Но '''''полужирный курсив''''' выглядит страшновато.

===Это заголовок подраздела===

Вот ненумерованный перечень:

* собаки

* кошки

** ласковые

** кусачие

А это нумерованный перечень:

# Собаки.

# Кошки.

## Ласковые.

## Кусачие.

А это словарик:

; кошки, кусачие

: кошки, которые кусаются

; кошки, ласковые

: кошки, которые кусаются редко

; собаки

: кусачесть собак науке неизвестна


Это заголовок раздела

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

Это заголовок подраздела

Вот ненумерованный перечень:

  • собаки
  • кошки
    • ласковые
    • кусачие

А это нумерованный перечень:

  1. Собаки.
  2. Кошки.
    1. Ласковые.
    2. Кусачие.

А это словарик:

кошки, кусачие
кошки, которые кусаются
кошки, ласковые
кошки, которые кусаются редко
собаки
кусачесть собак науке неизвестна

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

Более подробно о декоративной разметке можно услышать от мальчишек на улице.

Редактирование страниц: 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}}
В статье использованы результаты исследования, выполненного при поддержке гранта Российского фонда фундаментальных исследований (РФФИ) 19-012-00393 «Категориальный строй и понятийный аппарат филологической герменевтики и лингводидактики».

РФФИ и его правопреемники не несут и не разделяют ответственность за проект «Гермепедия» или содержание страниц его сайта.

Как видно из этого примера, для вызова (простановки) шаблона достаточно заключить его имя в двойные фигурные скобки, и, в отличие от Wiki-ссылок, если пространство имен для страницы, используемой в качестве шаблона, явно не указано, шаблоны берутся из пространства «Шаблон», которое, собственно, для их размещения и предназначено.

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

Но более интересны параметризованные вызовы шаблонов. Параметры шаблонов в Wiki-разметке бывают нумерованные и именованные. Для примера рассмотрим несколько шаблонов, требующих указания строго одного параметра, которые я написал параллельно этому руководству. У них у всех однобуквенные имена и предназначены они для стилей оформления, отсутствующих в Wiki-разметке в ее первозданном виде, а именно — разрядки, подчеркивания, заглавных букв, капители. Всем им в качестве первого единственного параметра передается, собственно, текст, который предполагается оформить соответствующим образом. При вызове шаблона параметры отделяются от его имени (и друг от друга, если их несколько) вертикальной чертой «|». Все это должно быть понятно из примера, и обратите внимание на разницу между ссылкой на шаблон, которая проставляется, как и на любую другую страницу, в прямых скобках, и его вызовом в фигурных и сопровождающимся указанием параметров.

Редактируем Просматриваем
[[Шаблон:А]] позволяет {{а|выделить текст заглавными}}, [[Шаблон:К]] — {{к|выделить текст капителью}}, [[Шаблон:П]] — {{п|подчеркнуть текст}}, [[Шаблон:Р]] — {{р|дать текст вразрядку}}.

При применении {{п|вызовы шаблонов можно {{р|вкладывать}} самым странным {{а|образом}}}}.

Вызовы этих шаблонов можно сочетать с {{р|апострофным ''форматированием'' '''текста'''}} также ''разнообразными {{р|способами}}, пока'' текст вовсе не потеряет читаемости.

Шаблон:А позволяет выделить текст заглавными, Шаблон:Квыделить текст капителью, Шаблон:Пподчеркнуть текст, Шаблон:Рдать текст вразрядку.

При применении вызовы шаблонов можно вкладывать самым странным образом.

Вызовы этих шаблонов можно сочетать с апострофным форматированием текста также разнообразными способами, пока текст вовсе не потеряет читаемости.




Проблемы

Специальные вопросы

Это интересно только для почтальонов:

Это статья — часть Руководства проекта «Гермепедия». В терминах авторского права авторы бессрочно и безотзывно передают ее в общественное достояние.