ГоБиблиотека: Синтаксис

Синтаксис


Оглавление документа


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

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


**полужирный**полужирный
//курсив//курсив
__подчеркнутый__подчеркнутый
--зачеркнутый--зачеркнутый
##моноширинный##моноширинный
>>центрированный<<
центрированный
!!Замечание!!Замечание
??Вопрос??Вопрос
;;Комментарий;;Комментарий
,,Все то же, но зеленым цветом,,Все то же, но зеленым цветом

Cсылки

[[http://forum.weiqi.ru]]
или ((http://forum.weiqi.ru))
http://forum.weiqi.ru
[[http://forum.weiqi.ru Форум]]
или ((http://forum.weiqi.ru Форум))
Форум
[[Вход]] или ((Вход))Вход
[[Вход Начальная страница]]
или ((Вход Начальная страница))
здесь все до первого пробела — Вики Имя,
после него — текст ссылки
Начальная страница
http://www.ya.ru подсвечивается автоматически.http://www.ya.ru
http://www.yandex.ru/logo1.gif
превратится в картинку.
((Вход http://www.yandex.ru/logo1.gif))
картинка, которая ссылка.
{{a name="test"}} или {{anchor name="test"}}
объявление якоря.
((#test)) и ((Вход#TOC_1))
ссылки на якорь.
#test и Вход#TOC_1

NB: слова в смешанном регистре (ВотТакие) выделять ссылками вообще не надо. Для прочих внутрисайтовых ссылок URL писать не нужно (иначе не возникает связи между двумя страницами). URL нужен лишь для внешних ссылок.

NB: чтобы ВотТакое слово не стало ссылкой, поставьте перед ним знак ~ (тильда).

Рисунки


Если полный адрес рисунка оканчивается на .gif, .jpg, .jpe, .jpeg или .png, то для отображения этого рисунка на странице достаточно указать его адрес (см. в предыдущем разделе пример с логотипом Яндекса).
В противном же случае (например, рисунок отдается скриптом) необходимо использовать экшн {{img src="ПолныйАдресРисунка"}}:
{{img src="http://www.yandex.ru/logo1.gif"}}

Если рисунок загружен в ГоБиблиотеку, то для его отображения на странице, к которой он прикреплен необходимо поставить конструкцию вида {{img src="file:ИмяФайлаРисунка"}}:
{{img src="file:logo1.gif"}}

Заголовки


Заголовки разных уровней набираются с помощью нескольких последовательных знаков "=" с обоих сторон.

== Большой заголовок ==

=== Заголовок поменьше ===

==== Средний заголовок ====

===== Маленький заголовок =====

====== Ну совсем маленький заголовок ======

======= Меньше некуда заголовок =======

Отступы и списки


Отступы делаются с помощью двух пробелов. Так же нужно выделять отступом списки.

  Отступ
    Двойной отступ
Отступ
Двойной отступ
  *ненумерованный список
  *ненумерованный список-2
  • ненумерованный список
  • ненумерованный список-2
  1. нумерованный список
  1. нумерованный список-2
  1. нумерованный список
  2. нумерованный список-2
  A. Верхний регистр
  A. Верхний регистр-2
  1. Верхний регистр
  2. Верхний регистр-2
  a. Нижний регистр
  a. Нижний регистр-2
  1. Нижний регистр
  2. Нижний регистр-2
  I. Римские цифры в верхнем регистре
  I. Римские цифры-2
  1. Римские цифры в верхнем регистре
  2. Римские цифры-2
  i. Римские цифры в нижнем регистре
  i. Римские цифры-2
  1. Римские цифры в нижнем регистре
  2. Римские цифры-2

Таблицы


Таблица с рамкой
#|
||cell11|cell12|cell13||
||cell21|cell22||
|#

cell11cell12cell13
cell21cell22

Таблица без рамок, шириной 100%
#||
||cell11|cell12|cell13||
||cell21|cell22||
||#

cell11cell12cell13
cell21cell22

Таблица без рамок
#|||
||cell11|cell12|cell13||
||cell21|cell22||
|||#

cell11cell12cell13
cell21cell22

Прочее


Разделитель:
---- (4 минусa)


Явный перевод строки:
тест---с разрывом
тест
с разрывом

Вывод текста как есть, без применения форматирования:
текст необходимо заключить в двойные-двойные кавычки.
""текст""

Вывод HTML как есть:
постарайтесь не злоупотреблять этой возможностью
<# <input type="text"> #>


Верхний индекс:
E=mc^^2^^
E=mc2
  • NB: между ^^ не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока. Если пробелы внутри блока необходимы, то см. описание форматтера sup.

Нижний индекс:
пробелы перед и после vv обязательны
H vv2vv O
2 O
  • NB: между vv не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока

Макросы


Макросы отличаются от остальной разметки тем, что при повторном редактировании документа вы увидите не вызов макроса, а результат его работы — они отрабатывают при сохранении текста.

Имя текущего пользователя:
::::
ПавелСтрибук

Имя текущего пользователя и дата:
::@:: или ::;::
ПавелСтрибук /29.02.2004 19:16/

Дата:
::+::
29.02.2004 19:16

Форматтеры


Вызов форматтеров (обработчиков текста) происходит с помощью выражений вида %%(name) текст%%.
Подробный список встроенных форматтеров можно найти на странице «Форматтеры».

Действия (Actions)

Вызов действий происходит с помощью выражений вида {{(name) параметры}}.
Подробный список поддерживаемых действий можно найти на странице «Действия»

Типографика


Присутствует специальный обработчик текста, который обрабатывает кавычки, тире, приклеивает пробелы и т.д.

Эвристики


Переводы строк
Эта эвристика заменяет переводы строк на <BR> (принудительный разрыв строки).

Предлоги и &nbsp;
Смелая эвристика предполагает, что короткие слова (1-3 символа) не должны отрываться от следующих за ними. Поэтому она заменяет идущие следом за коротким словом разделители на неразрывный пробел (&nbsp;).

Дефисы и &nbsp;
Заключение всех слов, разделённых дефисами в тэги <nobr>, не позволяющий броузеру поставить разрыв строки внутри.

Запятые и пробелы
Контроль небрежности автора. Удаляет случайные пробелы перед запятыми и точками.

Специальные символы


На входеНа выходе
"русский"«русский»
"english"“english”
-
(минус)

среднее тире
--
(2 минусa)

длинное тире
(c), (C),
англ/рус
©
(r), (R),
англ
®
(tm), (TM),
англ
(p), (P),
англ
§
+-±
^C,
англ/рус
°C
^F°F

NB: Минусы преобразуются в тире только если окружены разделителями (пробелами, переводами строк, табуляцией).

Диаграммы


Как оформлять диаграммы описано здесь.


Комментарии

  • SergeiPavlov /04.08.2004 09:11/ Надо бы термин «Действия» заменить. Что-то типа «операторы» подошло бы или «инструкции» (операторы в нек-х языках программиров.). Смысл по контексту аналогичен понятию «арифметическое действие», что есть операция или оператор, функция одной или двух переменных, у которой область определения и область значений совпадают (в этом отличие оператора от более общего понятия функции или отображения).