Справка:Синтаксис

Материал из Tiarum
Перейти к: навигация, поиск

Вики-разметка

Ниже приведены справочные таблицы по редактированию. Прежде чем применять эти «инструменты» на «живом теле» Tiarum, поэкспериментируйте, пожалуйста, в «личной Песочнице».


Разделы, абзацы, списки и строки


Разделы, абзацы, списки и строки
Как это выглядит: Что нужно набрать:
Начните раздел со строки заголовка:

Новый раздел


Подраздел

Под-подраздел

Начните раздел со строки заголовка:

== Новый раздел ==

=== Подраздел ===

==== Под-подраздел ====

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

Но пустая строка начинает новый абзац.

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

Но пустая строка
начинает новый абзац.

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

С помощью тега «br» можно разрывать строки,<br>
не начиная новый абзац.

Сделать список очень просто:

  • каждая строка начинается со звездочки;
    • чем больше звёздочек — тем глубже уровень;
      отступ внутри можно делать и с помощью двоеточия.
Сделать список очень просто:
* каждая строка начинается со звёздочки;
** чем больше звёздочек — тем глубже уровень;
**: отступ внутри можно делать и с помощью двоеточия.
  1. Нумерованные списки тоже хороши:
    1. очень организованные;
    2. легко читаются.
# Нумерованные списки тоже хороши:
## очень организованные;
## легко читаются.

Продолжить нумерованный список после обычного текста или пустой строчки можно с помощью HTML-тега li c параметром value.

  1. Первый элемент первого уровня.
  2. Второй элемент первого уровня.
    1. Первый подэлемент второго элемента.

Промежуточный обычный текст с последующей пустой строчкой.

Пустую строчку можно и не вводить.

  1. Третий элемент первого уровня.
  2. Четвёртый элемент первого уровня.
# Первый элемент первого уровня.
# Второй элемент первого уровня.
## Первый подэлемент второго элемента.
Промежуточный обычный текст с последующей пустой строчкой.

Пустую строчку можно и не вводить.
# <li value="3">Третий элемент первого уровня.
#Четвёртый элемент первого уровня.
  • Можно также делать смешанные списки:
    1. и вкладывать их
      • как, например,
    2. здесь.
* Можно также делать смешанные списки:
*# и вкладывать их
*#* как, например,
*# здесь.
Tочка с запятой в начале строки
и затем двоеточие
создают
двухуровневый список.
;Tочка с запятой в начале строки: и затем двоеточие
;создают: двухуровневый список.
Двоеточие в начале строки делает отступ абзаца.

Простой перенос строки при этом начинает новый абзац.

Примечание: это применяется в основном на страницах обсуждения.

:Двоеточие в начале строки делает отступ абзаца.
Простой перенос строки при этом начинает новый абзац. 
ЕСЛИ строка начинается с пробела, ТОГДА
  она будет отформатирована так же,  
    как и набрана;
  шрифтом фиксированной ширины;
  без переноса строк;
КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ASC II Art (создание изображений при помощи 
    текстовых символов).

ВНИМАНИЕ! Если вы сделаете такую строку длинной, вы сделаете всю страницу широкой и из-за этого менее читабельной. Никогда не начинайте обычные строки с пробела.

 ЕСЛИ строка начинается с пробела, ТОГДА
   она будет отформатирована так же, 
     как и набрана;
   шрифтом фиксированной ширины;
   без переноса строк;
 КОНЕЦЕСЛИ
Это можно применять для:
  * вставки преформатированного текста;
  * описания алгоритмов;
  * исходного кода программ
  * ASC II Art (создание изображений
    при помощи текстовых символов);
Центрированный текст.
<center>Центрированный текст.</center>

Выравнивание по вертикали.

TEX и LATEX

Допустимые параметры vertical-align

  • baseline - Выравнивает базовую линию текущего элемента по базовой линии родителя. Если родительский элемент не имеет базовой линии, то за нее принимается нижняя граница элемента.
  • bottom - Выравнивает основание текущего элемента по нижней части элемента строки, расположенного ниже всех.
  • middle - Выравнивание средней точки элемента по базовой линии родителя плюс половина высоты родительского элемента.
  • sub - Элемент изображается как подстрочный, в виде нижнего индекса. Размер шрифта при этом не меняется.
  • super - Элемент изображается как надстрочный, в виде верхнего индекса. Размер шрифта остается прежним.
  • text-bottom - Нижняя граница элемента выравнивается по самому нижнему краю текущей строки.
  • text-top - Верхняя граница элемента выравнивается по самому высокому текстовому элементу текущей строки.
  • top - Выравнивание верхнего края элемента по верху самого высокого элемента строки.
  • inherit - Наследует значение родителя.
<div style="font-size: 1em">
T<span style="vertical-align: text-bottom">E</span>X и L<span style="vertical-align: 5px; 
font-size: 0.8em">A</span>T<span style="vertical-align: sub">E</span>X
</div>

Выравнивание текста с буквицей по нижнему краю

B letter.pngсю свою жизнь я посвятил изучению двемеров, ...

<div style="font-size: 1em">[[file:B_letter.png|40px]]<span style="vertical-align: bottom">сю свою жизнь я посвятил изучению двемеров, ...</span></div>

Горизонтальная разделительная линия:


четыре пунктира подряд

Горизонтальная разделительная линия: 
----
четыре пунктира подряд 

Этот абзац отцентрирован. Вы можете управлять выравниванием текста абзаца, используя тег <p> с параметром align, со значением center для выравнивания по центру.

Этот абзац выровнен по ширине. Вы можете управлять выравниванием текста абзаца, используя тег <p> с параметром align, со значением justify для выравнивания по ширине.

Этот абзац выровнен по левому краю. Вы можете управлять выравниванием текста абзаца, используя тег <p> с параметром align, со значением left для выравнивания по левому краю.

Этот абзац выровнен по правому краю. Вы можете управлять выравниванием текста абзаца, используя тег <p> с параметром align, со значением right для выравнивания по правому краю.

<p align=center> Этот абзац '''отцентрирован'''. </p>

Вы можете управлять выравниванием текста абзаца, используя тег <p> с параметром align, со значением center для выравнивания по центру, justify для выравнивания по ширине, left для выравнивания по левому краю, right для выравнивания по правому краю.

По умолчанию принято выравнивание по левому краю.

Например, для выравнивания по ширине используйте такую конструкцию:

<p align=justify>Текст абзаца </p>

Ссылки, URL


Ссылки, URL
Как это выглядит Что нужно набрать

Пример:

Зачаровывать свои предметы, даже если вы не являетесь членом Университета Таинств,

вы можете с помощью Камней Сигил, которые описаны в статье Oblivion:Камни Сигил (Sigil Stone).

Пояснения:

  • Первая буква точки назначения автоматически делается большой.
  • Внутренние пробелы автоматически представляются как подчёркивания
(набор подчёркивания имеет тот же эффект, что и набор пробела, но не рекомендуется).
  • Таким образом, приведённая выше ссылка ведёт на http://tiarum.com/wiki/Oblivion:Камни Сигил (Sigil Stone), которая является статьёй с названием «Oblivion:Камни Сигил (Sigil Stone)».

Внимание:

  • Если падеж ссылающегося слова или словосочетания не совпадает с именительным, то следует в двойных квадратных скобках ставить вертикальную черту и слева от неё писать именительный падеж, а справа — соответствующий грамматике предложения, в которое вставлена ссылка.

Пример:

Если вы не являетесь членом Университета Таинств Сиродиила, вы все равно можете зачаровывать свои предметы с помощью Камней Сигил

Зачаровывать свои предметы, даже если вы не являетесь членом Университета Таинств, вы можете с помощью Камней Сигил, которые описаны в статье [[Oblivion:Камни Сигил (Sigil Stone)]].

Если вы не являетесь членом Университета Таинств Сиродиила, вы все равно можете зачаровывать свои предметы с помощью [[Oblivion:Камни Сигил (Sigil Stone)|Камней Сигил]]

Окончания сливаются со ссылкой:

  • Я привык работать с GIMPом.
  • При изучении вики-разметки начинающие пользуются Песочницами.
Окончания сливаются со ссылкой:
* Я привык работать с [[Modding:GIMP|GIMP]]ом.
* При изучении вики-разметки начинающие пользуются [[Служебная:Mypage/sandbox|Песочница]]ми.

Автоматически скрывается заключённое в круглых скобках: Вивек.


Автоматически скрывается пространство имён: Квесты Брумы.

  • Пользоваться вертикальной чертой полезно еще по одной причине - на Tiarum в названии статей принято использовать префиксные слова - отвечающие за пространство имен, например, "Oblivion:...", "Morrowind:...", "Category:Oblivion_..." и т.п.
  • Префиксные слова необходимы для того, чтобы указать целевую принадлежность данной статьи и отнести ее в нужное пространство имен.
  • В качестве примера можно привести, например, скриптовые функции, которые имеют одинаковые названия в обеих играх, но имеют разный синтаксис и по-разному работают.


Сервер заполняет часть после | в момент сохранения страницы.

Автоматически скрывается заключённое в круглых скобках: [[TES Lore:Вивек (город)|]].


Автоматически скрывается [[Справка:Пространство имен|пространство имён]]: [[Oblivion:Квесты Брумы|Квесты Брумы]].

Можно ссылаться на подраздел в самой статье, указав его после «решётки»: Две Стороны Одной Медали (Two Sides of a Coin)

Можно ссылаться на подраздел в самой статье, указав его после «решётки»:

[[Oblivion:Квесты Брумы#Две Стороны Одной Медали (Two Sides of a Coin)|Две Стороны Одной Медали (Two Sides of a Coin)]].

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

Не забывайте добавлять символ двоеточия (":") в начало ссылки!

Например, строка [[:Category:Oblivion:Официальные плагины|Официальные плагины]]

даст такой результат: Официальные плагины

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

в неё текущую страницу, используйте ссылки следующего вида:

[[:Category:Программы|Программы]].

При добавлении комментариев к странице обсуждения следует их подписать.
Это можно сделать, добавив три тильды для получения имени пользователя:

Garin

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

Garin 04:07, 1 марта 2011 (MSK)

При добавлении комментариев к странице обсуждения,
следует их подписать. Это можно сделать, добавив
три тильды для получения имени пользователя:
: ~~~
или четыре для получения имени пользователя плюс дата/время:
: ~~~~
Именно вариант с датой и временем является предпочтительным.

Драконы в Балморе — это страница, которая ещё не создана.

Вы можете создать её, кликнув на ссылке. Подробнее см. руководство Как создать статью.

[[Morrowind:Драконы в Балморе|Драконы в Балморе]] — это страница, которая ещё не создана.

Внешняя ссылка: Nupedia Внешняя ссылка: [http://www.nupedia.com Nupedia]

Или просто укажите URL: http://www.nupedia.com.

  • В URL все символы должны находиться в диапазонах: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF.
  • Если URL содержит другие символы, их следует преобразовать: например, ^ следует записывать как %5E (чтобы можно было просматривать в ASCII).

Или просто укажите URL: http://www.nupedia.com.

Указать e-mail можно так: name@example.com

  • Этот адрес приведён для примера, не используйте его.

Указать e-mail можно так: [mailto:name@example.com name@example.com]

Для того, чтобы включить ссылки на загруженные объекты, не являющиеся изображениями, такие как архивы, звуковые файлы или на изображения, заданные ссылкой, но не отображаемые на странице, используйте «медиа»-ссылку:

* '''Скачать''': [[media:OSFM v1.2.0.7z|'''OSFM v1.2.0 Том 1. Базовый курс скриптинга TES 4 Oblivion''']] (1,4 МВ). * '''Лого''' [[Медиа:3DRipperDX.gif|'''3DRipperDX''']].

Для ссылок на книги используйте ссылки ISBN:

ISBN 0123456789X

ISBN 0123456789X

Для ссылки на RFC используйте:

RFC 1234

RFC 1234

Изображение в качестве внутренней ссылки:

Avatar Maik.jpg

[[image:Avatar Maik.jpg|100px|link=User:MaikCG]]

Форматирование текста


Форматирование текста
Как это выглядит: Что нужно набрать:

Полужирное и курсивное начертания используются в следующих случаях:

  • логическое ударение
  • структурное выделение
  • логическое ударение в структурном выделении (или наоборот)

Прим.: Это двойные и тройные апострофы, а не кавычки!


  • ''логическое ударение''
  • '''структурное выделение'''
  • '''''логическое ударение в структурном выделении (или наоборот)'''''
Выделение цветом отдельного слова Выделение цветом <span style="color:#FF00FF"> отдельного </span> слова
Выделение цветом абзаца или произвольного участка очень длинного текста.
<div style="color:#33CC66">Выделение цветом абзаца или произвольного участка очень длинного текста.</div>

Вы также можете писать курсивом и жирным, если вас интересует определенный стиль шрифта, а не логическое выделение, например, в математических формулах:

F = ma

Прим.: Тем не менее, разница между этими двумя методами не очень важна для графических браузеров, и многие люди просто игнорируют её.

Вы также можете писать курсивом и жирным, если вас интересует определенный стиль шрифта, а не логическое выделение, например, в математических формулах:

: '''F''' = ''m'''''a'''

Моноширинный шрифт для технических терминов.

Моноширинный шрифт для <tt>технических терминов</tt>.

Специальное форматирование для фрагментов исходного кода.

Специальное форматирование для фрагментов <code>исходного кода</code>.

Вы можете использовать маленький текст для заголовков. Вы можете использовать <small>маленький текст</small> для заголовков.
Вы можете перечёркивать удалённый материал

и подчёркивать новый материал.

Вы можете <strike>перечёркивать удалённый материал</strike> и <u>подчёркивать новый материал</u>.
Вы можете вставлять специальные символы См. Специальные символы
x2   ≥   0 true

Для разделения пробелами используйте знак пробела: &nbsp;. Это также предотвращает переносы строк посреди текста, что полезно в формулах.

''x''<sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

Нижний индекс: x2
Верхний индекс: x2 или x²

Второй метод не может использоваться в общем случае, но при возможности (например, для единиц измерения) следует использовать именно его, поскольку большинство браузеров при этом лучше форматируют строки:

ε0 = 8.85 × 10−12 C² / J m.

Нижний индекс: x<sub>2</sub>

Верхний индекс: x<sup>2</sup> or x&sup2;

&epsilon;<sub>0</sub> = 8.85 &times; 10<sup>&minus;12</sup> C&sup2; / J m.

Сложные формулы:
  <math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

<math>\sum_{n=0}^\infty \frac{x^n}{n!}</math>

Подавление интерпретации разметки:
Link → (''to'') the [[Википедия:Справка]]

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

<nowiki>Link &rarr; (''to'') the [[Википедия:Справка]]</nowiki>

Комментарий в исходном тексте страницы:
не отображается на странице

Используется для внесения в исходный текст страницы комментария для последующих редакторов.

<!-- комментарий -->

Содержание статьи


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

  • Если вы хотите, чтобы «Содержание» появилось в каком-либо другом месте статьи (а не там, где оно появляется по умолчанию), то поместите ключевое слово __TOC__ в этом месте.
  • А для того, чтобы «Содержание» вообще нигде не появлялось, достаточно поместить ключевое слово __NOTOC__ где угодно на странице.
  • В некоторых случаях требуется, чтобы слишком большое «Содержание» не загромождало страницу. В таком случае вы можете поместить его в правой стороне страницы. Для этого используйте шаблон {{TOC right}}. При этом обеспечивается обтекаемость его текстом.

Вставка изображений

См. статью Как добавить изображения

Вставка таблиц

См. статью Как создать таблицу

Вставка видео

См. статью Как добавить видеоролики

Дополнительная информация по вики-разметке


Потренироваться вы можете в личной Песочнице.