Справка:Вики-разметка

Материал из Циклопедии
(перенаправлено с «Циклопедия:Справка»)
Перейти к навигации Перейти к поиску

Краткая справка по викиразметке.

Абзацы[править]

В викиразметке новый абзац текста создаётся с помощью двойного переноса строки. Одинарные переносы превращаются в пробелы.

код результат код результат HTML-аналог
текст
текст

текст текст

текст

текст

текст

текст

<p>текст</p><p>текст</p>

Переносы строки и их запрет[править]

В викиразметке однократный перенос строки преобразуется в пробел. Поэтому для создания явных переносов используют HTML-тег <br>. Этот тег с параметром <br clear="all"> также позволяет отменить обтекание текста возле плавающих элементов на странице. Однако в тексте викистатей тег <br> обычно не принято использовать, вместо этого отдельные абзацы разделяют двойным переносом строки, который работает аналогично тегу <p> — создаёт абзац с отбивкой сверху и снизу.

Для запрета переноса фрагмента текста используется неразрывный пробел &nbsp;, которым заменяют в тексте обычные пробелы. Также для этих целей применяют шаблон nobr, добавляющий стилевое CSS-свойство style="white-space:nowrap;". Этот стиль можно добавлять в любые HTML-теги с текстовым содержимым, в результате получается текст в одну строку.

Форматирование простого текста[править]

Cmbox notice.png Разметка текста[править]

  • ''курсив'' — двойные кавычки, курсив, аналог HTML-тегов <i></i>
  • '''жирный''' — тройные кавычки, жирный шрифт, аналог <b></b>

Двойные и тройные кавычки '''''можно сочетать вместе''''' — получится жирный курсив.

Примечание: Кавычки работают только в пределах одной строки, при переносе текста на новую строку их действие прерывается (у HTML-тегов такого ограничения нет).

Cmbox notice.png Применение тегов и шаблонов[править]

С помощью HTML-тегов на викистранице можно добавлять дополнительное форматирование для обычного текста, реализованное также через соответствующие шаблоны:

HTML-тег Шаблон Пример Описание
<i></i> Italics|­ (пример) курсив
<small></small> Small|­ (пример) маленький шрифт. В отличие от простого тега шаблон более продвинутый, так как уменьшает и высоту строки.
<big></big> Big|­ (пример) крупный шрифт.
<sup></sup> Sup|­ (пример) надстрочный текст, аналог для математической разметки — Exp|­
<sub></sub> Sub|­ (пример) подстрочный текст.
<u></u> (пример) подчёркнутый текст
<s></s> Перечёркнуто|­ (пример) зачёркнутый текст
Overline|­ (пример) надчёркнутый текст.
Дважды подчёркнуто|­ (пример) двойное подчёркивание.
Smallcaps|­ (пример) шрифт капителью
Razr|­ (пример) разряженный шрифт
Ряд шаблонов реализует сочетание разных тегов:
Smallsup|­ (пример) объединяет маленький и надстрочный шрифт
Sup sub|­| (примерпример) сочетает надстрочный и подстрочный шрифт. Применяется в математических, химических, физических обозначениях.
Текст с всплывающей подсказкой:
<abbr title=""></abbr> Abbr|­||0
Comment|­|
Tooltip|­|
(пример) аббревиатура со всплывающей подсказкой при наведении указателя мыши
Предусмотрены также специальные шаблоны, отменяющие жирный и курсив, обычно используемые в составе других шаблонов:
Без жирного|­ (жирный) делает из жирного шрифта обычный
Без курсива|­ (курсив) убирает из текста курсив

Списки[править]

  • * — маркированный список
  • # — нумерованный список
  • ; и : — список определений

Примечание: Викиразметка, формирующая списки, работает только с начала строки !

Примеры списков
Маркированный Нумерованный Список определений
Код викиразметки
* текст 1
* текст 2
* текст 3
# текст 1
# текст 2
# текст 3
;термин 1
:определение 1
;термин 2
:определение 2
;термин 3
:определение 3
Как выглядит список
  • текст 1
  • текст 2
  • текст 3
  1. текст 1
  2. текст 2
  3. текст 3
термин 1
определение 1
термин 2
определение 2
термин 3
определение 3
Аналоги в HTML
(тоже работают на викистраницах)
<ul><li></li></ul> <ol><li></li></ol> <dl><dt></dt><dd></dd></dl>

Создание ссылок[править]

Викиразметка поддерживает добавление двух видов ссылок:

  • внутренние ссылки — ссылки, ведущие на другие страницы википроекта. Служат для внутренней навигации между статьями.
  • внешние ссылки — ссылки на другие сайты в сети Интернет. Используются в основном для указания источников, подтверждающих информацию в статьях.

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

Предупреждение  Предупреждение: внутри любых викиссылок не допускаются переносы строки. Это ведёт к их поломке.

Cmbox notice.png Внутренние ссылки[править]

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

В виде ссылок можно выделять любые слова, термины или небольшие фрагменты текста, описывающие различные объекты или явления, о которых есть соответствующие статьи. Например, можно оформить ссылку на статью [[кошка]], если в тексте статьи упоминается кошка. Если требуется создать ссылку, отображаемый текст которой не совпадает с названием целевой статьи, применяется конструкция [[Название статьи|Отображаемый текст]], в которой название статьи и отображаемый текст разделены символом вертикальной черты «|». Например код [[Великая Отечественная война|ВОВ]] даёт ссылку ВОВ, по которой открывается статья «Великая Отечественная война». Также скобками можно выделять часть слова, при этом всё слово преобразуется в ссылку: код в [[Ленинград]]е даёт «в Ленинграде», в [[2000 год]]у даёт «в 2000 году». Такая запись более короткая, чем в [[Ленинград|Ленинграде]], в [[2000 год|2000 году]].

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

Примечание: допустимо произвольное количество пробелов между краями текста и квадратными скобками (вертикальной чертой): [[ лето | летний ]] → летний . Но недопустимы лишние пробелы между словами внутри текста.

Примечание: ссылка вида [[Циклопедия (вики)|]] отображается без текста в скобках: Циклопедия. Это позволяет сократить запись, в том числе в шаблонах.

Для создания ссылок на страницы из различных пространств имён, кроме основного, необходимо указывать полное имя страницы, включая пространство имён: [[Обсуждение:Название статьи]], [[Файл:Имя файла]] и т. д.

Примечание: ссылка на категорию [[Категория:Название категории]] не отображается на странице в месте, где она вставлена, а добавляет страницу в соответствующую категорию. Для создания простой текстовой ссылки на категорию нужно добавить перед пространством имён двоеточие: [[:Категория:Название категории]].

К отображаемому тексту внутри ссылки, идущему после вертикальной черты «|», можно применять разную разметку, добавлять теги, стили, шаблоны строкового форматирования: [[Циклопедия (вики)|'''Ци'''''кло''<big>педия</big>]] → Циклопедия. Внутри части ссылки до вертикальной черты разметка недопустима, однако можно вставлять неразрывный пробел &nbsp; вместо обычного.

Cmbox notice.png Внешние ссылки[править]

Для создания внешней ссылки используются одинарные квадратные скобки []. Внутри скобок указывается адрес веб-страницы (URL) и через пробел отображаемое название ссылки: [http://example.com Отображаемый текст] даёт Отображаемый текст — ссылку на сайт «example.com». Адрес можно также непосредственно вставлять на страницу, он преобразуется в голую ссылку: http://example.com

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

<span class="plainlinks">[https://example.com Пример домена]</span>

чтобы убрать опозновательный знак внешней ссылки (ОЗВС).

Примечание: в статьях голые ссылки выглядят неряшливо, их следует оформлять надлежащим образом, снабжая удобочитаемыми названиями.

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

Цветовое оформление текста и ссылок[править]

Текст викистраницы обычно чёрного цвета, ссылки раскрашены в синий и красный. Однако можно задавать и другие цвета с помощью HTML-тегов и шаблонов.

Для задания цвета текста можно использовать древний тег <font> с параметром color="", которому необходимо присвоить код или название цвета в формате HTML/CSS. Также для раскрашивания текста используются CSS-стили style="color:(цвет);", применимые к любым HTML-тегам с текстовым содержимым.

Разметка Цветной текст
<font color="brown">коричневый</font> коричневый
<span style="color:red;">красный</span> красный
<b style="color:green;">зелёный</b> зелёный
<i style="color:blue;">синий</i> синий
Викишаблоны цветового оформления текста
Шаблон Пример Описание
Универсальные шаблоны
Color|| Текст раскрашивает текст в любой указанный цвет
Background color|| Текст добавляет пользовательский цвет фона
Oncolor||| Текст одновременно раскрашивает фон и цвет текста
Специализированные
Bluebol|­ Текст текст голубого цвета жирным шрифтом
Grr|­ Текст текст зелёного цвета жирным шрифтом
Red|­ Текст красный текст
Green|­ Текст зелёный текст
Gray|­ Текст серый текст
Grstrike|­ Текст серый подчёркнутый
Слабо|­ Текст светло-серый, для частичного сокрытия текста
White|­ Текст белый цвет текста, для тёмного фона
Цветные ссылки
Универсальные шаблоны
Цветная ссылка||| Циклопедия создаёт цветную ссылку любого указанного цвета
Специализированные
Bluelink|­ Несуществующая статья делает красные ссылки синими
Masklink||| Циклопедия делает синюю ссылку чёрной, как и обычный текст