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

также доступны в Deutsch, English, Español , Français, Polski, 简体中文


См. также: Действия (Аctions)


Форматирование текста в Wacko немного отличается от других вики. Поэтому стоит поглядеть на описание и примеры ниже.


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


источник отображаемый

1. Оглавление


{{toc numerate=1}}


Подробное описание...

2. Основы форматирования


**полужирный**
полужирный
//курсив//
курсив
__подчеркнутый__
подчеркнутый
##моноширинный##
(можно использовать также №№, но это неэстетично и не приветствуется)
моноширинный
++Мелкий текст++
Мелкий текст
--зачеркнутый--
зачеркнутый
NB Зачеркивание, как и все следующие разметки в данном разделе, работает на многострочных текстах, в отличие от предыдущих.
!!Замечание!!
(работает также ''Замечание'', но его лучше не использовать).
Замечание
!!(blue)Текст синего цвета!!
(поддерживаются три цвета: (red), (green), (blue)).
Текст синего цвета
??Вопрос??
Вопрос
??(blue)Вопрос??
Вопрос
??(red)Вопрос??
Вопрос
??(green)Вопрос??
Вопрос
%%код%%
int main(int arc,char **argv)
{
    printf("Hello, %s!\n", (argc>1) ? argv[1] : "World");
    return 0;
}	

3. Выравнивание

Выравнивание осуществляется при помощи вот такой сложной конструкции:

стандарт
слева
%%(wacko wrapper=text wrapper_align=center) По центру%%
По центру
%%(wacko wrapper=text wrapper_align=right) справа%%
справа
%%(wacko wrapper=text wrapper_align=justify) По ширине%%
По ширине

wrapper_align может быть center, right и justify.

4. Cсылки

Знаками разметки для создания ссылок являются круглые скобки ((, )) и квадратные скобки [[, ]]. Оба знака равноправны. Использовать квадратные скобки может быть полезно, если текст документа уже содержит простые круглые скобки, которые могут быть ошибочно расценены разметкой.

4.1. Внешние ссылки

[[https://wackowiki.org WackoWiki]]
или ((https://wackowiki.org WackoWiki))
WackoWiki
https://wackowiki.org подсвечивается автоматически.
https://wackowiki.org
PPR:OneMinuteWiki
Интервики
PPR:OneMinuteWiki
mailto:adresse@example.com
((adresse@example.com))
E-Mail.
mailto:adresse@example.com
adresse@example.com
xmpp:adresse@example.com
Jabber.
xmpp:adresse@example.com
((https://example.com/archive.zip Archiv (zip) ))
https://example.com/archive.zip
Archiv (zip)
https://example.com/archive.zip

4.2. Внутренние ссылки

[[Кластеры]] или ((Кластеры))
Кластеры
[[Кластеры Страница про кластеры]]
или ((Кластеры Страница про кластеры))
Страница про кластеры
https://wackowiki.org/wacko_logo.png
превратится в картинку.

((/HomePage https://wackowiki.org/wacko_logo.png))
картинка, которая ссылка.
https://wackowiki.org/wacko_logo.png
{{anchor href="test"}}
объявление якоря.

((#test)) и ((/HomePage#TOC_1))
ссылки на якорь.
test и /HomePage#TOC_1

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


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


NB: подробности простановки ссылок на документы, находящиеся не в корне, описаны в разделе Кластеры.


NB: Для изменения размера и выравнивания изображений из внешних источников можно использовать следующий синтаксис: ((http://example.com/image.png width=500 align=center)), доступные параметры width, height и align=[left, center, right].


5. Интеграция загруженные файлы

file:/mammut_mascot.jpg
проверяет только файлы, доступные всем посетителям
file:mammut_mascot.jpg
проверяет файлы, доступные только читателям данной страницы
file:/Subpage/archive.zip
чтобы отобразить файл, доступный только читателям данной страницы, на другой странице, указывается абсолютный путь этого файла
Файл должен быть загружен уже.


подробное описание...

mammut mascot
file:/Subpage/archive.zip

5.1. Медиа параметры

Параметры добавляются в синтаксис файла путем добавления вопросительного знака ? и дополнительных параметров с помощью амперсанда &.
например file:/lotus_flower.jpg?right&caption&400

Lotus Flower
Shinobazu Pond at Ueno Park at Ueno, Taito-ku in Tokyo
(Source:: Yoshikazu TAKADA /Some rights reserved)

  • Поведение при клике
    • direct - ссылки на файл
    • nolink - показывает только изображение
    • linkonly - показывает только ссылку
    • meta - ссылки на filemeta handler (default)
  • Выравнивание
    • right - справа
    • left - слева
    • center - посередине
  • Изменение размеров
    • 400x300 - ширина × высота
    • 0x700 - высота
    • 600 - ширина
  • другие
    • caption - подпись к рисунку шоу
    • clear - clears float

6. Заголовки


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

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

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

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

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

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

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

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

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

NB: В заголовках справа не обязательно должно быть такое же количество знаков "=", достаточно двух.
== Большой заголовок == обычно устанавливается вместе с заголовком страницы и по умолчанию не включается в оглавление.


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


Отступы делаются с помощью двух пробелов (можно использовать устаревший вариант - табуляцию).
Так же нужно выделять отступом списки.
Списки:
  Отступ
    Двойной отступ
----
  * ненумерованный список
  * ненумерованный список-2
----
  1. нумерованный список
  1. нумерованный список-2
  1.#8 нумерованный список-2, с пропуском
----
  A. Верхний регистр
  A. Верхний регистр-2
----
  a. Нижний регистр
  a. Нижний регистр-2
----
  i. Римские цифры
  i. Римские цифры-2
----
  1. список
    1. вложенный список
      * ещё более вложенный список
    1. вложенный список-2
  2. список-2	

Списки:

Отступ
Двойной отступ


  • ненумерованный список
  • ненумерованный список-2

  1. нумерованный список
  2. нумерованный список-2
  3. нумерованный список-2, с пропуском

  1. Верхний регистр
  2. Верхний регистр-2

  1. Нижний регистр
  2. Нижний регистр-2

  1. Римские цифры
  2. Римские цифры-2

  1. список
    1. вложенный список
      • ещё более вложенный список
    2. вложенный список-2
  2. список-2

8. Цитирование и определение

<[ Цитирование текста ]>
Цитирование текста,
длинного,
с переносами

>>Однострочное цитирование
>Да, это оно
А это обычный текст

А это обычный текст

(?Термин Некоторое определение?)

Термин
(?Термин с пробелами==Некоторое другое определение?)
NB: если вокруг '==' оставить пробелы, они так же останутся в тексте страницы
Термин с пробелами

9. Сноски (footnotes)

Текст, потом сноска[[*]] и вторая[[**]]
Текст, потом сноска* и вторая**
Текст, потом цифровая сноска[[*1]] и вторая[[*2]]
Текст, потом цифровая сноска1 и вторая2
[[#*]] Расшифровка первой сноски
[[#**]] Расшифровка второй сноски
[[#1]] Расшифровка цифровой сноски
[[#2]] Расшифровка второй цифровой сноски
* Расшифровка первой сноски
** Расшифровка второй сноски
1 Расшифровка цифровой сноски
2 Расшифровка второй цифровой сноски

Автоматически создаваемые сноски
[[^ Текст сноски здесь]]
Генерирует сноски в конце страницы, см. пример

10. Цитирование

Чтобы отметить текст как ответ или комментарий, вы можете использовать следующий синтаксис:
Привет!
> Да, это так.
>> Вы уверены?
> Конечно, да!
>> Правда?
>>> Что теперь?	

Привет!

11. Таблицы


Таблица с рамкой
#|
*|заголовок 1|заголовок 2|заголовок 3|*
||клетка 1-1|клетка 1-2|клетка 1-3||
||клетка 2-1|клетка 2-2||
|#


заголовок 1заголовок 2заголовок 3
клетка 1-1клетка 1-2клетка 1-3
клетка 2-1клетка 2-2

Таблица без рамок, шириной 100%
#||
||клетка 1-1|клетка 1-2|клетка 1-3||
||клетка 2-1|клетка 2-2||
||#


клетка 1-1клетка 1-2клетка 1-3
клетка 2-1клетка 2-2

NB: Сложные таблицы могут быть созданы с помощью встроенного HTML, если он разрешен в настройках сайта.
Чтобы включить знак вертикальная черта | в качестве содержимого внутри вашей ячейки следует заключить его в пару двойных кавычек: ""|""

12. Прочее


Разделитель:
----



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


Принудительную пустую строку:
---"" ""---


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


Вывод HTML как есть:
работает только если такую функциональность разрешил администратор сайта.
<# <input type="text"> #>
<# <input type="text"> #>
Если вы видите <input type="text"> вместо поля ввода -- значит, администратор сайта не разрешил данную функцию (параметр allow_rawhtml конфигурационного файла).


Верхний индекс:
E=mc^^2^^
E=mc2

  • NB: между ^^ не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока

Нижний индекс:
пробелы перед и после vv обязательны Если их требуется избежать, следует использовать вместо них конструкцию """"

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

13. Автокорректор

Автоматический корректор, встроенный в wiki, самостоятельно подгоняет сохраняемый текст под нормы форматирования, избавляя авторов от излишне детальной правки. Вот какие изменения он вносит:
Расстановка. Пробелов! И заглавий
Минус - превращает в тире
Два минуса -- в длинное тире
Спецсимволы (c), (r), (tm), (p), +-
Знаки градуса -15^C, +270^K
"Кавычки", "quotes"	
Расстановка. Пробелов! И заглавий
Минус - превращает в тире
Два минуса -- в длинное тире
Спецсимволы (c), (r), (tm), (p), +-
Знаки градуса -15^C, +270^K
"Кавычки", "quotes"

Если какой-то текст необходимо вывести "как есть", исключая его автоматическую корректуру, заключите его в двойные кавычки (заметьте: вся wiki-разметка внутри двойных кавычек также выводится на экран, а не форматирует текст).

14. Макросы


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


Имя текущего пользователя:
::::
RomanIvanov


Имя текущего пользователя и дата:
::@::
RomanIvanov /20.06.2003 18:13/


Дата:
::+::
20.06.2003 18:13

15. Расширения - дополнительные форматтеры

В WackoWiki можно легко добавлять новые обработчики текста. Их вызов происходит по синтаксису %%(name) текст%%.


В качестве символов разметки для форматирования текста можно использовать знаки процента %%, %% или диакритические знаки "гравис" (обычно на букве ё в латинской раскладке) ``, ``. Оба вида разметки эквивалентны. Грависы могут быть полезны, если текст уже содержит знаки процента, которые могут быть ошибочно приняты за разметку.
Кроме того, это позволяет обернуть один форматтер в другой форматтер, например, обернуть CSS с подсветкой в форматтер для отображения в виде раскрывающегося блока.


В стандартной поставке есть следующие форматтеры:


%%(wacko)текст как есть. [[/HomePage]]%%
Этот форматтер выводит текст так же, как если бы он был написан без форматера. Удобен для применения дополнительных оберток к тексту (выравнивание, боксы и тому подобное. См ниже.)
текст как есть. /HomePage
%%(php) PHP-код%%
Важно отметить, что код должен начинаться открывающим <?php и заканчиваться закрывающим ?>, так как для используемого встроенного в PHP модуля разметки синтаксиса именно эти разделители являются признаком php-кода.
<?
phpinfo();
$s = "Hello, World!\n";
echo $s;

%%(comment) Комментарий, не выводится%%

%%(details title="Краткое изложение" open=1)
Details info.
%%

Краткое изложение Элемент HTML Details (<details>) создает раскрывающийся виджет, в котором информация видна только тогда, когда виджет находится в состоянии «открыт». Краткое изложение или заголовок можно задать с помощью элемента <summary>.

%%(cl)zypper dup --no-recommends%%
zypper dup --no-recommends	

%%(chat [type="div|table"])
Логи chat
%%

Mike Hi altogether.
12:04
Alice Did you check out the link https://example.com/
12:05
Pete I did't read your message.
The images
you drawn
are awesome!
12:10

%%(email) Email%%
Hi!
RI>> Yes, it is.
>Are you sure?

Of course, yes!

Roman.	

%%(sql) SQL-code%%
SELECT * FROM sometable 
WHERE a = '12' AND b = 2 
ORDER BY c DESC --Comment;

Так же доступны форматтеры (ini), (html), (css), (pascal) и (java)
<html>
<a href="http://example.com" width="8">test</a>
</html>	


[Wiki]
BestEngine="WackoWiki"
Version=6	


body {margin: 0; padding: 5px;}
.class {background: url("http://example.com/");} 	


program megaprogramme; 
{ comment }
BEGIN
 if a = 15 then writeln('test');
END.	

15.1. Info box

%%(info type="note" title="Примечание" icon=0) content... %%


Типы: default, error, example, important, note, question, quote, success, warning
title заголовок коробки
icon показать иконку, значение по умолчанию 1

%%(info type="note")
content...
%%

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


%%(info type="warning")
content...
%%

У любого программного обеспечения, которое размещается в Интернете, могут быть обнаружены ошибки или проблемы с безопасностью. Не устанавливайте WackoWiki, если вы не намерены следить за обновлениями безопасности.

15.2. PEAR Text Highlighter

Пакет PEAR для подсветки синтаксиса


%%(hl [Форматер] numbers=1 start=2) пример кода %%


numbers тип нумерации строк: 1 -> ol, 2 -> таблица
start позволяет номерам строк начинаться с любого номера, а не только с 1


форматтеры: abap, cpp, css, diff, dtd, html, java, javascript, perl, php, ruby, python, sh, sql, vbscript, xml.

%%(hl css) CSS-Code%%
body {margin: 0; padding: 5px;}
.class {background: url("http://example.com");}


%%(hl javascript) Javascript-Code%%
var a = document.getElementById("test");
a.value = new Array(15, 31);
function echo (msg) {alert(msg)};


%%(hl php numbers=2) PHP-Code%%
1
2
3
4
<?php
phpinfo();
$s = "Hello, World!\n";
echo $s;


%%(hl xml) xml-Code%%
<config>
<section name="test">
  <var>Test</var>
  <val><![CDATA[..text...]]></val>
</section>
</config>

15.3. GeSHi

GeSHi Code Highlighting - Generic Syntax Highlighter


%%(geshi [Форматер] numbers=1 start=35 lines=37) source%%

%%(geshi css) CSS-Code%%
Formatter highlight/geshi not found

Если вы видите Форматтер highlight/geshi отсутствует, то GeSHi Форматтер не было добавлено на этот сайт.

16. Обёртки вокруг форматтеров


Имеется также Deutsch, English, Français, 简体中文.


Дополнительно каждому форматтеру можно назначить отдельный кадр %%(ФОРМАТТЕР) Text%% с параметром wrapper= .


%%(форматтер
[wrapper="box | shade | page | text"]
[wrapper_align= "left | center | right | justify"]
[wrapper_title="Заголовок"]
[wrapper_type="default | error | example | important | note | question | quote | success | warning"]
[wrapper_width="pixel"]
[col=1 | 2 | 3 | 4 | 5]
[clear])
Text
%%

box shade page text
type + + -
Заголовок + + -
Выравнивание + 1 2 +
clear + +
Задание ширины блока + 1 + 3
column + +
Окаймление + +
Автоматический перевод строк + + +

1 Опция не имеет смысла, т.к. ширина блока всегда равна ширине страницы.
2 Только влево.
3 Если самому переводы строк не ставить, ширина блока фиксирована движком приблизительно на уровне 90% от ширины страницы.


ОСТАЛЬНОЕ = [ФОРМАТТЕР | ОБЁРТКА_ФОРМАТТЕРА | ОПЦИЯ_ОБЁРТКИ_ФОРМАТТЕРА | КОММЕНТАРИЙ]


ФОРМАТТЕР [ cl | comment | css | email | hl * | html | info | ini | java | pascal | php | sql | wacko ]


ОБЁРТКА_ФОРМАТТЕРА: box, shade, page und text


КОММЕНТАРИЙ = всё остальное, что угодно.

16.1. box


Кроме того, любому форматтеру можно задать одну из "обёрток" указав ему параметр wrapper.
Доступны обёртки: box, shade, page и text.


%%(css wrapper=box wrapper_align=left wrapper_width=270)
.d { font-size: 70% }
%%


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

16.2. shade


%%(css wrapper=shade)
.d2 { font-size: 70% }
%%

.d2 { font-size: 70% } 	

shade -- это box без настроек.

16.3. text

%%(wacko wrapper=text wrapper_align=center) текст по центру %%
текст по центру

text выводит "плавающий" (float) блок текста.

16.4. page

%%(wacko wrapper=page wrapper_width=200) этот текст не может быть шире двухсот пикселей%%
этот текст не может быть шире двухсот пикселей

page позволяет регулировать ширину обычного блока текста.

16.5. Пример


%%(wacko wrapper=box wrapper_type="quote" wrapper_width=300 wrapper_title="Box")
«A hundred times every day I remind myself that my inner and outer life depend upon the labors of other men, living and dead, and that I must exert myself in order to give in the measure as I have received and am still receiving.» – Albert Einstein
%%