Основные правила разметки

Пожалуйста, экспериментируйте в песочнице!

Страницы на этом сайте -- это WikiWikiWeb страницы. Это означает, что они могут быть созданы и изменены несколькими авторами. И вы тоже можете стать соавтором нажав на ссылку Edit, часто расположенную где-то на заголовке или в конце страницы. Часто не все страницы открыты для свободного изменения. Некоторые особо важные могут быть защищены паролем.

Во время редактирования вы видите "текст разметки", который описывает содержимое страницы. Основные правила разметки страницы очень просты:

  1. Lingvo переводит "bulleted list" как "список (текст) с буллитами". ужас! Для разделения параграфов используется пустая строка;
  2. Для разметки нумерованных списков начинайте строки с символа '#'(диез), а для маркированных списков -- с символа '*'(звезда); Подсписки начинаются с '##', '###'... или '**', '***'.. и т.д;
  3. Строки заголовков начинаются с '!'; Подзаголовков с '!!'; Подподзаголовков с '!!!';
  4. Выделеный курсивом текст заключают между двойными одиночными кавычками ''text'', а для жирного тройными -- '''text''';
  5. Для ссылки на другую страницу её имя окружают двойными квадратными скобками; Например [[Basic Editing]] укажет на эту страницу; Ссылки на несозданные страницы? так, чтобы попросить её создать;
  6. Для ссылки на другой сайт просто наберите его адрес: http://www.yandex.ru ;

Если вам захочется поэкспериментировать с редактированием странички, то WikiSandbox как раз для этого. Изменение WikiSandbox ничего не испортит. Однако, когда вы что-то правите на других страницах, то будет правильно подписаться под своими исправлениями. "~~~" автоматически заменяется на ваше имя, указанное в поле "Author" на странице редактирования.

Примеры

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

Общее применение

Как выглядит

Как сделано

Простой перевод строки не разбивает абзац. Но ''(к несчастью) изменяет'' разметку.

Простой ''перевод'' строки
не разбивает абзац.
Но ''(к несчастью)
изменяет'' разметку.

Автор должен

использовать пустую строку для начала нового параграфа. А для переноса
строки -- две обратные дробные черты.

Автор должен

использовать пустую строку для начала
нового параграфа. А для переноса\\
строки -- две обратные дробные черты.
  • Списки делаются используя звёздочки
    • Больше звёздочек -- дальше отступ
      • Список заканчивается

первой строкой не из списка

  1. Нумерованные списки
  2. также возможны
    • как и смешаные
* Списки делаются используя звёздочки
** Больше звёздочек -- дальше отступ
*** Список заканчивается
первой строкой не из списка

# Нумерованные списки
# также возможны
** как и смешанные
  • Обратная дробная черта в конце строки присоединяет следующую строку и сохраняет разметку.
  • Две обратные дробные черты
    создают перенос в параграфе.
  • Три такие черты делают

    два переноса.
* Обратная дробная черта в \
конце строки присоединяет \
следующую строку и '''сохраняет \
разметку'''.
* Две обратные дробные черты\\
создают перенос в параграфе.
* Три такие черты делают\\\
два переноса.
Стрелка (->) включает отступ
Для продолжения отступа выравнивайте текст
Более длинные стрелки (-->) дают больший отступ
Обратная стрелка (-<) делает первую строку подвешенной относительно остальных строк абзаца.
Также, длиннее обратная стрела (--<) больше отступ тела параграфа.
-> Стрелка (->) включает отступ

   Для продолжения отступа выравнивайте текст

--> Более длинные стрелки (-->) дают \
больший отступ

-<Обратная стрелка (-<) делает \
первую строку подвешенной \
относительно остальных строк \
абзаца.
--< Также, длиннее обратная стрела (--<) \
больше отступ тела параграфа.
Определения
список определений
элемент
определение элемента
другой элемент
ещё определение
: Определения : список определений
: элемент : определение элемента
: другой элемент : ещё определение
 Строки  начинающиеся
 с пробела  выводятся
 моноширинным шрифтом.

Отметьте, что очень длинные строки такого текста могут увеличить ширину всей страницы.

 Строки  начинающиеся
 с пробела  выводятся
 моноширинным шрифтом.

Этот текст отцентрован.

А этот прижат вправо.

%center% Этот текст отцентрован.

%right% А этот прижат вправо.

Четыре или больше минусов в начале строки


образуют горизонтальное отчёркивание.

Четыре или больше минусов
в начале строки
----
образуют горизонтальное отчёркивание.

Ссылки

Как выглядит

Как сделано

Практика редактирования в wiki sandbox.

  • Текст в двойных прямоугольных скобках образует ссылку на другие страницы.
  • В заголовках слова ссылок автоматом делаются с большой буквы.
Практика редактирования
в [[Main/wiki sandbox]].

Практика редактирования в WikiSandbox.

Которая? О, в Main.WikiSandbox.

  • Когда ссылаетесь на страницу в другой викигруппе, указывайте имя группы перед дробной чертой.
  • Если разделителем служит дробная черта, то видно только имя страницы.
  • Если разделитель точка, то будет ссылка будет видна целиком.
Практика редактирования
в [[Main/WikiSandbox]].

Которая?
О, в [[Main.WikiSandbox]].

Практика редактирования на тренировочной площадке.

Практика редактирования на тренировочной площадке.

Практика редактирования на тренировочной площадке.

  • Текст после палки (|) становится текстом ссылки; его ещё можно задать по другому (возможно так понятнее): перед стрелкой (текст -> ссылка).
Практика редактирования на 
[[WikiSandbox | тренировочной площадке]].

Практика редактирования на 
[[Main.WikiSandbox | тренировочной площадке]].

Практика редактирования на 
[[тренировочной площадке -> WikiSandbox]].

Практика редактирования на wiki sandboxes.

Практика редактирования на sandbox.

  • Окончание становится частью текста ссылки, но не адреса.
  • Скобки скрывают часть имени ссылки.
Практика редактирования на 
[[wiki sandbox]]es.

Практика редактирования на 
[[(wiki) sandbox]].

Это aardvark, не так ли?

  • Pmwiki поддерживает InterMap префиксы которые имеют особое значение.
  • В этом случае скобки так же прячут фрагменты адреса.
Это [[(Wikipedia:)aardvark]], не так ли?

Ссылки на внешние ресурсы можно ввести так:

  1. просто путь: http://google.com
  2. с текстом: Google
  3. как сноска: [1]
Ссылки на внешние ресурсы можно ввести так:
# просто путь:  http://google.com
# с текстом: [[http://google.com | Google]]
# как сноска: [[http://google.com |#]]

Ссылки открывающиеся в новом окне оформляются так: http://www.pmwiki.org .

Ссылки открывающиеся в новом окне
оформляются так: %newwin% http://www.pmwiki.org .

Строковое форматирование

Выделено, сильнее, особо сильно.

''Выделено'', '''сильнее''', 
'''''особо сильно'''''.

Моноширинный текст

этот участок
  предформатированый
    текстовый блок
@@Моноширинный текст@@ 
 
[@этот участок
  предформатированый
    текстовый блок@]
  • Индекс надстрочный
  • Индекс подстрочный
  • удалённый зачёркнутый текст
  • вставленный подчёркнутый текст
  • большой, ещё больше текст
  • мелкий, ещё меньше текст
* Индекс '^надстрочный^'
* Индекс '_подстрочный_'
* удалённый {-зачёркнутый-} текст
* вставленный {+подчёркнутый+} текст
* [+большой+], [++ещё больше++] текст
* [-мелкий-], [--ещё меньше--] текст

Вики стили позволяют раскрашивать текст в разные цвета.

  • Используйте символы нижнего регистра для задания RGB цветов (#ff7f00, а не #FF7F00).
[[PmWiki.WikiStyles|Вики стили]] %red% позволяют 
%blue% раскрашивать %green% текст 
%color=#ff7f00% в разные %%цвета.

Заглавия и блоки

Старший Подзаголовок

Старший Подзаголовок Написанный Меньшим Шрифтом

Младший Подзаголовок

И ещё

Подзаголовок
  • Заглавия нужны для подготовки "хорошо структурированных" страниц,
 и это не просто строки крупным шрифтом.
!! Старший Подзаголовок
!! [-Старший Подзаголовок Написанный Меньшим Шрифтом-]
!!! Младший Подзаголовок
!!!! И ещё
!!!!! Подзаголовок
Заголовок страницы

не показан

  • Директива (:title:) изменяет заголовок страницы на что-то отличное от её служебного имени.
(:title Основы Разметки:)
Стили блоков

Весь текст в этом блоке сиреневый.

  • Сиреневые коровы и сиреневые цветы
  • Сиреневые сливы вкуснее
  • А теперь строка красная
  • а эта отцентрована
  • а эта выровнена вправо
  • а это снова обычная
>>purple<<
Весь текст в этом блоке
сиреневый.
* Сиреневые коровы и сиреневые цветы
* Сиреневые сливы вкуснее
>>red<<
* А теперь строка красная
>>center<<
* а эта отцентрована
>>right<<
* а эта выровнена вправо
>><<
* а это снова обычная

<< | Документация | Создание новых страниц >>

Перевод страницы PmWiki.BasicEditing - Оригинал перевода PmWikiRu.BasicEditing - Backlinks
PmWikiRu.BasicEditing: редакция от April 30, 2017, at 08:21 AM
PmWiki.BasicEditing: редакция от October 12, 2024, at 09:03 PM