Расширения

Как описано в стандартном синтаксисе, управляющие макросы включающие плагины имеют такой синтаксис:

Базовый синтаксис расширений:

~~ИМЯ_ПЛАГИНА:параметр_плагина&еще_один_параметр~~

Пишите их в любом месте документа, лучше в начале или конце.

Дискуссии

Первым делом установлены обсуждения. Включил по умолчанию для всех страниц. На главной, и еще для некоторых страниц отключил с помощью ~~DISCUSSION:off~~. Если обсуждение себя исчерпало его можно закрыть.

Доступные макросы включения, выключения и закрытия:

~~DISCUSSION~~
~~DISCUSSION:off~~
~~DISCUSSION:closed~~

Заметка

Если вы хотите обратить на какой то элемент дополнительное внимание читетателя, вы можете использовать, вот такие напоминалки.

Прилепленный листок

<note>Просто заметка</note>

Просто заметка

Важное напоминание

<note important>Очень важная заметка</note>

Очень важная заметка

То о чем нужно просто знать

<note tip>Подсказка</note>

Подсказка

Критически важно, не забывайте

<note warning>Осторожно, не забывайте, это важно</note>

Осторожно, не забывайте, это важно

Теги

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

Синтаксис таков:

{{tag>[список тегов]}}

к примеру в статье про razer DA:

{{tag>мышка razer 3G DeathAdder}}
Внизу этой страницы справа, можно увидеть теги этой страницы.

В дальненйшем можно построить список статей содержащих к примеру тег 'синтаксис':

Использование тегов:

Еще о синтаксисе:
{{topic>синтаксис}}

И будут показаны все статьи содержащие этот тег.

Еще о синтаксисе:

Расширения 2009/03/05 18:05 Zefir
Рекомендации для пишущих и исправляющих 2009/02/28 00:36 Zefir
Синтаксис форматирования    

Включения

Include - это плагин позволяющий включить на страницу другой документ или часть его.

Общий синтаксис таков:

{{page>название#секция&флаги}}
{{section>название#секция&флаги}}
Различие page от section состоит в способе включения.

  • page - пытаеться включить страницу с родным форматированием как отдельный блок.
  • section - попытка интегрировать секцию с другой страницы в текущий текст.

Вот пример включения раздела «Типографские символы» со страницы общего синтаксиса

Пример использования page:

{{page>wiki:syntax#Типографские символы}}

Пример использования section:

{{section>wiki:syntax#Типографские символы}}

Пример использования можно глянуть на странице Экономика в CS. Там я включил секцию с базовыми суммами с предыдущей страницы.

Исходники и код

Если нужно показать содержимое файла или синтаксис вики, используються теги <code> и <file>. Появилась возможность добавить заголовок такому элементу. Это применено для показа кода вики на этой странице.

Пример тега file

<file | userconfig.cfg>
bind MOUSE1 kill
bind MOUSE2 quit
</file>
будет выгядеть вот так:

userconfig.cfg

bind MOUSE1 kill
bind MOUSE2 quit

Голосования

Пример голосования

<poll Голосование по поводу расширения wiki синтаксиса>
  Нужны ли все эти улучшения и расширения?

  * Да
  * Нет
  * Не знаю
</poll>
Самое главное в голосовании, чтобы строка которая идет в названии, сразу за словом poll, была абсолютно уникальной, иначе система потом не сможет различить результаты различных голосований. Поэтому плиз называйте их подлиннее, и попонятнее.

Голосование по поводу расширения wiki синтаксиса
Нужны ли все эти улучшения и расширения?

FAQ

Составление списка вопросов и ответов сделано аналогично заголовкам, и их можно комбинировать в любом сочетании. Вместо символа '=' используеться знак вопроса '?'. Имеются также 5 уровней от '??????' до '??'. Также как и заголовки, 3 первых уровня попадут в содержание страницы.

Отличие в оформлении текста, и в том что вопросы имеют более сильные отступы чем аналогичные заголовки. При этом ответы имеют отступ основного текста не зависимо от вопросов.

Пример FAQ

??? Что такое bunnyhop? ???
Распрыжка - прыжки выполняемы с ускорением с помощью особой техники, позволяет быстрее добраться до места назначения и огорчить противника. 

Что такое bunnyhop?

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

Диаграмма

Есть много разной формы и красоты диаграмм, круговые, объемные, анимированные. Но я пока выбрал самую простую и понятную.

Пример простой диаграммы

<barchart>2048|1994 год:33.600, 1998 год:57.600, 2003 год:128, 2006 год:512, 2008 год:1024, 2009 год:2048</barchart>
Первый параметр максимальное значение на графике. Потом идут столбцы разделенные запятыми. В них идут пары название столбца и его значение, через двоеточие.

Скорость инета в Кб

33.6

1994 год
57.6

1998 год
128

2003 год
512

2006 год
1024

2008 год
2048

2009 год

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

Списки понятий и их объяснение чем-то похоже на faq, но как правило редко имеют вложенность, и предназначены для создания словарей и глоссариев:

общий синтаксис словаря

? понятие
! определение
начинаються с начала строки, вложенные определения поддерживаються дополнительными отступами без переводов строк. Пустая строка означает конец определений.

определений может быть несколько для одного понятия

? LOL 
! Стандартная расшифровка: laughing out loud, то бишь - "громко ржать"
! Нестандартная: Lamer OnLine

определение может быть одно для нескольких понятий

? rofl
! rolling on the floor laughing - "смеяться катаясь на полу" - аналог "lol"
? roflmao
? lmao
! rolling on the floor laughing my ass out - тоже что и rofl, только более изыскано :)

LOL
Стандартная расшифровка: laughing out loud, то бишь - «громко ржать»
Нестандартная: Lamer OnLine
rofl
rolling on the floor laughing - «смеяться катаясь на полу» - аналог «lol»
roflmao
lmao
rolling on the floor laughing my ass out - тоже что и rofl, только более изыскано :)

Блоки и дополнительное оформление

Доступные блоки:

  • <quote> - расширенное цитирование;
  • <epigraph> - епиграфы;
  • <verse> - форматирование стихов;
  • <style> - базовый блок.

Эти атрибуты можно использовать с любым из блоков:

  • left - выравнивание текста влево;
  • right - выравнивание текста вправо;
  • center - выравнивание текста по центру;
  • justify - выравнивание текста по ширине страницы;
  • float-left - создание плавающего блока слева от основного текста;
  • float-right - создание плавающего блока справа от основного текста;
  • box - рисование рамки вокруг блока;
  • background - заполнение блока фоновым цветом.

Расширение: StylerPlus

Дополнительно, можно задать атрибуты выбора цвета фона и рамки. Может быть задана ширина блока и вложенность блоков.

Светлые цвета фона

  • background - светло-серый
  • background-lwhite - белый
  • background-lyellow - желтый
  • background-lorange - оранжевый
  • background-lgreen - зеленый
  • background-lblue - голубой
  • background-lbrown - коричневый
  • background-lpink - розовый
  • background-lred - красный

Пример

<style background-lgreen>Текст на светло-зеленом фоне</style>

Текст на светлозеленом фоне

Темные цвета фона

  • background-d - темно-серый
  • background-dblack - черный
  • background-dyellow - желтый
  • background-dorange - оранжевый
  • background-dgreen - зеленый
  • background-dblue - синий
  • background-dbrown - коричневый
  • background-dpink - розовый
  • background-dred - красный

Пример

<style background-dorange>Текст на темно-оранжевом фоне</style>

Текст на темно-оранжевом фоне

Цвет рамки

  • box - серый
  • box-dblack - черный
  • box-dyellow - желтый
  • box-dorange - оранжевый
  • box-dgreen - зеленый
  • box-dblue - синий
  • box-dbrown - коричневый
  • box-dpink - розовый
  • box-dred - красный

Пример

<style background-lorange box-dorange>Текст на светло-оранжевом фоне, в темно-оранжевой рамке</style>

Текст на светло-оранжевом фоне, в темно-оранжевой рамке

Размеры

  • s25 - 25% от ширины родительского блока
  • s50 - 50% от ширины родительского блока
  • s75 - 75% от ширины родительского блока

Рисование 2 блоков в одной строке с помощью плавающего выравнивания влево

<style background-lorange box-dorange float-left s50>Блок один</style>
<style background-lorange box-dorange float-left s50>Блок два</style>

Блок один

Блок два

Рисование 3 блоков в одной строке с помощью плавающего выравнивания влево

<style background-lorange box-dorange float-left s50>Блок один</style>
<style background-lorange box-dorange float-left s25>Блок два</style>
<style background-lorange box-dorange float-left s25>Блок три</style>

Блок один

Блок два

Блок три

Запрет обтекания

  • clear-left
  • clear-right
  • clear-both

Вложенные блоки

Создание вложенного блока как заголовка

<style background-lorange box-dorange float-left s50>
<style background-dgreen center>**Жирный заголовок во внутреннем блоке**</style>
Внутренний текст внешнего блока
</style>

Жирный заголовок во внутреннем блоке

Внутренний текст внешнего блока

Дискуссия

Введите ваш комментарий (доступен синтаксис wiki):
If you can't read the letters on the image, download this .wav file to get them read to you.

 
wiki/extend_syntax.txt · Последние изменения: 2009/03/18 05:27 От zefir
 
За исключением случаев, когда указано иное, содержимое этой вики предоставляется на условиях следующей лицензии:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki


Linux coutner EOMY TOP 100Game's TOP-100 Counter