Правила разметки текста

Эта страница документации взята с pmwiki.org.
Чтобы улучшить перевод, отредактируйте оригинал на pmwiki.org.
Изменения со временем появятся здесь.

Кстати, в песочнице pmwiki.org можно экспериментировать.

Эта страница содержит более полный список возможных в PmWiki способов разметки. Заметьте, что просто добавлять и изменять страницы вообще не пользуясь какой-либо разметкой, но если она всё же понадобится, то загляните сюда.

Напомню - для пробы пера используйте песочницу.


Параграфы

  • Для добавления параграфа просто наберите его текст.
  • Если понадобится смело переносите слова и выравнивайте строки. Автоматическое заполнение строк можно выключить директивой (:linebreaks:) вставленой выше параграфа.
  • В качестве разделителей используйте пустые строки.
  • Для соединения текущей строки и следующей используйте \ (обратная дробная черта).
  • Для закрепления перевода строки поставьте \\ (двойная обратная дробная черта) в её конце, при этом следующая станет продолжением текущего параграфа (или строки списка).

Отступ (Цитирование)

Стрелка (->) в начале параграфа включает отступ. Больше минусов (--->) даёт больший отступ.

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

Развёрнутая стрелка (-<) делает параграф с висячей первой строкой. Добавление минусов (---<) увеличивает отступ параграфа целиком.

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

Маркированные и Нумерованные списки

Строки маркированных списков начинаются с символа "звёздочка" (*), а строки нумерованных с символа "диез" (#). Несколько символов звезда/решётка увеличивают глубину вложенности списка:

* Строка списка первого уровня
** Строка списка второго уровня
### Пронумеруем строку
#### Эту тоже (вероятно)
### Тогда эту
** Ещё строка второго уровня
* Первый уровень: Готовка
## Начнём эксперимент
### Берём нарезанный хлеб
### Вставляем ломтик в тостер
## Начинаем готовить тосты
## Ждём
  • Строка списка первого уровня
    • Строка списка второго уровня
      1. Пронумеруем строку
        1. Эту тоже (вероятно)
      2. Тогда эту
    • Ещё строка второго уровня
  • Первый уровень: Готовка
    1. Начнём эксперимент
      1. Берём нарезанный хлеб
      2. Вставляем ломтик в тостер
    2. Начинаем готовить тосты
    3. Ждём

Также смотри: Cookbook:OutlineLists и Cookbook:NumberedHeaders


Списки определений

Строки списков определений начинаются с двоеточия:

:термин:определение термина
::термин второго уровня: определение термина
термин
определение термина
термин второго уровня
определение термина

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

Четыре и более знаков "минус" (----), расположенные в начале строки преобразовывается в горизонтальную черту.


Средства, используемые для выделения

  • Заключение текста в двойные одиночные кавычки (''текст''), т.е., два апострофа, для простого выделения (в основном курсив)
  • Заключение текста в тройные одиночные кавычки ('''text'''), т.е. три апострофа, для сильного выделения (в основном жирно)
  • Заключение текста в пятерные одиночные кавычки ('''''text'''''), или тройные и двойные (пять апострофов), для особого выделения (в основном жирный курсив)
  • Заключение текста в двойные плюшки (@) (@@text@@) для моноширинного текста
  • Используйте [+крупный+] для крупного текста, [++крупнее++] для текста крупнее, [-мелкий-] для мелкого, и [--мельче--] для совсем мелкого шрифта.
  • Выделения в пределах строки можно применять неоднократно, но нельзя провести через пределы строки разметки (т.е. нельзя разбить параграф посреди жирного выделения).

Другие стили

'+крупно+', '-мелко-', '^верхний индекс^', '_нижний индекс_', 

{+вставлено или подчёркнуто+}, 

{-удалено или зачёркнуто или вычеркнуто-}

крупно, мелко, верхний индекс, нижний индекс,

вставлено или подчёркнуто,

удалено или зачёркнуто или вычеркнуто

  • `WikiWord подавление WikiWord

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


Ссылки

  • Слова и фразы заключительные в двойные прямоугольные скобки (подобно [[text formating rules]]) образуют ссылки на страницы этой вики.
  • На некоторых PmWiki слова, начинающиеся с заглавной буквы и соединённые вместе (как ВикиСлова) тоже работают ссылками, и без необходимости окружения скобками.
  • Начинайте URL с "http:", "ftp:", "gopher:", "mailto:" или "news:" для образования ссылки автоматически, как например http://www.pmichaud.com/toast.
  • URL заканчивающиеся на .gif, .jpg или .png показываются на странице как изображения.
  • Ссылки с произвольным текстом могут сделаны либо так - [[адрес | текст]], либо так - [[текст -> адрес]]. текст может быть адресом изображения. В таком случае изображение станет работать как ссылка.
  • Якорь именует место на странице (#-links) и может быть образован с помощью [[#target]].

Озаглавливание

Заглавная строка начинается одним или несколькими знаками восклицания (!). Больше восклицательных знаков - глубже уровень заглавия. Например:

! Уровень заглавия 1
!! Уровень заглавия 2
!!! Уровень заглавия 3
!!!! Уровень заглавия 4

Уровень заглавия 1

Уровень заглавия 2

Уровень заглавия 3

Уровень заглавия 4


Управляющие последовательности

Всё, что расположено между [= и =] не интерпретируется PmWiki. С помощью этих последовательностей можно отключить интерпретацию разметки и нейтрализовать WikiWords, не являющиеся ссылками (хотя, для этого проще поставить перед словом обратный апостроф, как в 'WikiWord).

Коды [= и =] можно применять к нескольким строкам, включая пустые. Это делает их полезными для окружения строк кода, который должен быть показан моноширинным шрифтом и не анализироваться PmWiki.
Просто поставьте пробел перед открывающей скобкой [=. Если среди кодов встретятся последовательности символов [=..=], то после каждой =] поставьте =][=. Пример:

 [=
Код вроде [[PmWiki.PmWiki]] написан здесь
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]=][='; #просто некий код
=]
 
Код вроде [[PmWiki.PmWiki]] написан здесь
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]'; #просто некий код


Особые символы


Таблицы

Таблицы собираются из ячеек, окруженных '||'. Текст ячейки, начинающийся и заканчивающийся пробелами будет выведен по центру ячейки; если пробелы есть только в начале, то текст прижмётся к правому краю ячейки; остальные варианты считаются выравнивающимися по левому краю. Пустая ячейка расширяет предыдущую. (Пока нет способа объединять ячейки по вертикали.) Строка, начинающаяся с '||' описывает атрибуты для следующих таблиц. Восклицательный знак в начале ячейки делает её выделенной, что можно использовать для определения заголовков таблиц.

||border=1 width=50%
||!Таблица||!Заголовок||!Пример||
||!Лево   || Центр  || Право||
||A       ||!  a B  ||     C||
||        || ячейка ||      ||
||        || объединение  ||||
ТаблицаЗаголовокПример
ЛевоЦентрПраво
Aa BC
 ячейка 
 объединение

Что-то не нашлось?

Смотри Главный индекс разметки, Таблицы, Директивы таблиц или Ссылки.

<< Иллюстрации | Документация | Закачка файлов >>

Перевод страницы PmWiki.TextFormattingRules -
Оригинал перевода PmWikiRu.TextFormattingRules -
Ссылаются

PmWikiRu.TextFormattingRules: редакция от 2011-09-10, 22:48

PmWiki.TextFormattingRules: редакция от 2020-05-24, 11:07