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

Материал из Куклопедии
Версия от 12:29, 24 августа 2011; Sofi (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

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

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

Описание Формат Результат
форматирование символов — работает везде
Наклонный текст ''Курсив'' курсив
Полужирный текст '''Полужирный''' полужирный
Полужирный и наклонный текст '''''Полужирный и курсив''''' Полужирный и курсив
Отмена форматирования wiki <nowiki>нет ''курсива''</nowiki> нет ''курсива''
оформление заголовков — работает только с новой строки
Текст с отступом :Текст с отступом

::Двойной отступ
:::::Многократный отступ

:Текст с отступом::Двойной отступ:::::Многократный отступ
Заголовки
разных уровней
=Уровень 1=

==Уровень 2==
===Уровень 3===
====Уровень 4====
======Уровень 5====== В статьях с четырьмя и более заголовками автоматически создаётся таблица содержания.

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

Уровень 1
Уровень 2
Уровень 3
Уровень 4
Уровень 5
Уровень 6
Горизонтальная линия ----
Список с маркерами
* первый
* второй
* третий
** первый в третьем
** второй в третьем

Оставляйте пустую строку между окончанием первого списка и началом следующего.

  • первый
  • второй
  • третий
    • первый в третьем
    • второй в третьем
Список с числами
# первый
# второй<br />
несколько строк<br />
не нарушая нумерацию
# третий
## первый в третьем
## второй в третьем
  1. первый
  2. второй

несколько строк
не нарушая нумерацию

  1. третий
    1. первый в третьем
    2. второй в третьем
Список определений
;элемент 1
:определение 1
;элемент  2
:определение 2-1
:определение 2-2
элемент 1
определение 1
элемент 2
определение 2-1
определение 2-2
Применение возможностей оформления списка определений для отступов текста
:Первый отступ
::Второй отступ
:::::Ещё несколько отступов

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

Первый отступ
Второй отступ
Ещё несколько отступов
Смесь списка с маркерами
и списка с числами
# первый 
# второй
#* первый во втором
#* второй во втором
# третий
#; элемент определения в третьем
#: определение элемента в третьем# четвёртый
#: four item one
#: это скорее похоже на продолжение 
# четыре
#: и таким образом часто используемый вместо <br />
;элемент 1
:* определение 1-1
:* определение 1-2
:;элемент  2
:# определение 2-1
:# определение 2-2

Использование тегов #: и *: для разрыва строк в определениях может оказаться спорным.

  1. первый
  2. второй
    • первый во втором
    • второй во втором
  3. третий
    элемент определения в третьем
    определение элемента в третьем
  4. четвёртый
    four item one
    это скорее похоже на продолжение
  5. четыре
    и таким образом часто используемый вместо
элемент 1
  • определение 1-1
  • определение 1-2
элемент 2
  1. определение 2-1
  2. определение 2-2
Предварительно отформатированный текст
 частично неформатированный текст 
 оформляется с помощью '''пробела''' 
 в ''начале'' строки 

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

частично неформатированный тест 
оформляется с помощью пробела 
в начале строки 


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

Вики игнорирует обычные переносы строк. Для начала нового абзаца оставьте пустую строку. Новую строку также можно начать с HTML-тега <br />.

HTML теги[править]

В вики по умолчанию включена поддержка только некоторых HTML-тэгов, как например <code>, <div>, <span> и <font>.

Описание Формат Результат
Фиксированная ширина символов

<tt>Фиксированная ширина символов</tt>

Фиксированная ширина символов

Цитаты
 
текст текст текст текст текст текст текст текст текст текст 
текст текст текст текст текст текст текст текст текст текст  
<blockquote>  цитата цитата цитата цитата цитата цитата </blockquote> 
текст текст текст текст текст текст текст текст текст текст  

текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст

цитата цитата цитата цитата цитата цитата

текст текст текст текст текст текст текст текст текст текст

Комментарии
<!--Это комментарий-->
Полностью неформатированный текст
<pre>с помощью этого тега вся разметка '''игнорируется'''</pre>
 с помощью этого тега вся разметка '''игнорируется'''

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

В Куклопедии существует два вида ссылок:

  1. внутренние ссылки на страницы того же вики-проекта
  2. внешние ссылки на веб-сайты

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

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

Как ссылаться[править]

Описание Формат Результат
Внутренняя ссылка [[Main Page]] Main Page
Ссылка с разделителем (piped link) [[Main Page|какой-то текст]] какой-то текст
Внешняя ссылка http://mediawiki.org
Внешняя ссылка,
с описанием (именованная)
[http://mediawiki.org MediaWiki] MediaWiki
Внешняя ссылка,

безымянная (нумерованная)

[http://mediawiki.org] [1]
Ссылка на раздел текущей страницы (anchor link) [[#См. также]] #См. также
Ссылка на раздел другой страницы (anchor link) [[Help:Links#See also]] Help:Links#See also
Ссылка на категорию [[:Category:Help]] Category:Help
Внутренняя ссылка на изображение [[media:example.jpg]] media:example.jpg
Интервики-ссылка [[Wikipedia:MediaWiki]] Wikipedia:MediaWiki
Ссылка на e-mail [mailto:info@example.org напиши мне] напиши мне
Перенаправление #REDIRECT [[Main Page]] Main Page

Как избежать автоматического создания внешней ссылки[править]

По умолчанию, если в тексте статьи встречается адрес в формате URL, он автоматически преобразуется во внешнюю ссылку. Чтобы избежать этого эффекта, поместите адрес URL между тэгами <nowiki>, как в этом примере: <nowiki>http://mediawiki.org</nowiki>

Изображения[править]

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

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

Полный синтаксис для отображения изображений: [[Файл:имя файла.расширение|параметр|заголовок]] раздел «параметры» может отсутствовать или содержать следующие значения, разделенные символом «|»:

  • Параметр формата: один из border and/or frameless, frame, thumb (или thumbnail);
    Управляют форматированием и встраиванием изображения в остальную часть страницы.
  • Параметр размера: один из
    • {ширина}px — Изменяет размер изображения в соответствии максимальной шириной в пикселях, не ограничивая его высоту;
    • x{высота}px — Изменяет размер изображения в соответствии максимальной высотой в пикселях, не ограничивая его ширину;
    • {ширина}x{высота}px — Изменяет размер изображения в соответствии в заданной шириной и высотой в пикселях;
    • upright — Изменяет размер изображения в соответствии с разумными размерами, в зависимости от предпочтений пользователя (подходит для изображений, высота которых больше ширины).
    Обратите внимание, что изображение всегда будет сохранять свои пропорции, и может быть уменьшено (не увеличено) в размере, только если находится в масштабируемом медиа-типе (растровые изображения не могут быть масштабированы).
    Стандартный максимальный размер зависит от формата, и внутренних размеров изображения (в зависимости от его медиа-типа).
  • Параметр горизонтального выравнивания: один из left, right, center, none;
    Управляют горизонтальным выравниванием (встроенными/блочными или плавающими стилями) изображения в тексте (по умолчанию пусто).
  • Параметр вертикального выравнивания: один из baseline, sub, super, top, text-top, middle, bottom, text-bottom;
    Управляют вертикальным выравниванием без плавающих встроенных изображений в тексте, до или после изображения, и в том же блоке (по умолчанию middle). * Параметр ссылки: один из
    • link={цель} — Позволяет изменять цель (к произвольной странице или URL) генерируемых ссылок, доступных для отображаемых изображений;
    • link= (без значения) — (Шаблон:Mediawiki) Отображение изображения без каких-либо ссылок, например, [[File:Example.jpg|20px|link=]] отобразится как .
    Обратите внимание, что параметр link не может быть использован в сочетании с thumb или thumbnail, так как thumb всегда ссылается на большую версию изображения.
    Вдобавок, параметр link не может быть использован в сочетании с frame.