Форматирование текста
также доступны в Deutsch[link1], English[link2], Español[link3] , Français[link4], Polski[link5], 简体中文[link6]См. также: Действия (Аctions)[link7]
Форматирование текста в Wacko[link8] немного отличается от других вики. Поэтому стоит поглядеть на описание и примеры ниже.
Поэкспериментировать с форматированием вы можете в разделе Песочница[link9].
Текст, заключенный в две двойные кавычки слева и справа, не форматируется, и выводится так же, как был напечатан.
источник | отображаемый |
1. Оглавление
{{toc numerate=1}} Подробное описание...[link10] |
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[link11] |
https://wackowiki.org подсвечивается автоматически. | https://wackowiki.org |
PPR:OneMinuteWiki Интервики[link12] | PPR:OneMinuteWiki[link13] |
mailto:adresse@example.com ((adresse@example.com)) E-Mail. | mailto:adresse@example.com adresse@example.com[link14] |
xmpp:adresse@example.com Jabber. | xmpp:adresse@example.com |
((https://example.com/archive.zip Archiv (zip) )) https://example.com/archive.zip | Archiv (zip)[link15] https://example.com/archive.zip |
4.2. Внутренние ссылки
[[Кластеры]] или ((Кластеры)) | Кластеры[link16] |
[[Кластеры Страница про кластеры]] или ((Кластеры Страница про кластеры)) | Страница про кластеры[link16] |
https://wackowiki.org/wacko_logo.png превратится в картинку. | |
((/HomePage https://wackowiki.org/wacko_logo.png)) картинка, которая ссылка. | [link17] |
{{anchor href="test"}} объявление якоря. |
|
((#test)) и ((/HomePage#TOC_1)) ссылки на якорь. | test и /HomePage#TOC_1[link18] |
NB: слова в смешанном регистре (ВотТакие) выделять ссылками вообще не надо (если разрешено автоматическое создание WikiLinks[link19]). Для прочих внутрисайтовых ссылок URL писать не нужно (иначе не возникает связи между двумя страницами). URL нужен лишь для внешних ссылок.
NB: чтобы ВотТакое слово не стало ссылкой, поставьте перед ним знак ~
(тильда).
NB: подробности простановки ссылок на документы, находящиеся не в корне, описаны в разделе Кластеры[link16].
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 чтобы отобразить файл, доступный только читателям данной страницы, на другой странице, указывается абсолютный путь этого файла Файл должен быть загружен уже. подробное описание...[link20] | file:/Subpage/archive.zip[link21] |
5.1. Медиа параметры
Параметры добавляются в синтаксис файла путем добавления вопросительного знака?
и дополнительных параметров с помощью амперсанда &
.например
file:/lotus_flower.jpg?right&caption&400
- Поведение при клике
-
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 | Списки: Отступ
Двойной отступ
|
8. Цитирование и определение
9. Сноски (footnotes)
Текст, потом сноска[[*]] и вторая[[**]] | Текст, потом сноска* и вторая** |
Текст, потом цифровая сноска[[*1]] и вторая[[*2]] | Текст, потом цифровая сноска1 и вторая2 |
[[#*]] Расшифровка первой сноски[[#**]] Расшифровка второй сноски[[#1]] Расшифровка цифровой сноски[[#2]] Расшифровка второй цифровой сноски | * Расшифровка первой сноски ** Расшифровка второй сноски 1 Расшифровка цифровой сноски 2 Расшифровка второй цифровой сноски |
Автоматически создаваемые сноски [[^ Текст сноски здесь]] | Генерирует сноски в конце страницы, см. пример[link22] |
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[link23]
Имя текущего пользователя и дата:
::@::
RomanIvanov[link23] /20.06.2003 18:13/
Дата:
::+::
20.06.2003 18:13
15. Расширения - дополнительные форматтеры
В WackoWiki можно легко добавлять новые обработчики текста. Их вызов происходит по синтаксису%%(name) текст%%
.В качестве символов разметки для форматирования текста можно использовать знаки процента
%%, %%
или диакритические знаки "гравис" (обычно на букве ё в латинской раскладке) ``, ``
. Оба вида разметки эквивалентны. Грависы могут быть полезны, если текст уже содержит знаки процента, которые могут быть ошибочно приняты за разметку.Кроме того, это позволяет обернуть один форматтер в другой форматтер, например, обернуть CSS с подсветкой в форматтер для отображения в виде раскрывающегося блока.
В стандартной поставке есть следующие форматтеры:
%%(wacko)текст как есть. [[/HomePage]]%% Этот форматтер выводит текст так же, как если бы он был написан без форматера. Удобен для применения дополнительных оберток к тексту (выравнивание, боксы и тому подобное. См ниже.) | текст как есть. /HomePage[link17]
| |||||||||
%%(php) PHP-код%% Важно отметить, что код должен начинаться открывающим <?php и заканчиваться закрывающим ?> , так как для используемого встроенного в PHP модуля разметки синтаксиса именно эти разделители являются признаком php-кода. |
| |||||||||
%%(comment) Комментарий, не выводится%% | ||||||||||
%%(details title="Краткое изложение" open=1) |
Краткое изложениеЭлемент HTML Details (<details> ) создает раскрывающийся виджет, в котором информация видна только тогда, когда виджет находится в состоянии «открыт». Краткое изложение или заголовок можно задать с помощью элемента <summary> .
| |||||||||
%%(cl)zypper dup --no-recommends%% |
zypper dup --no-recommends | |||||||||
%%(chat [type="div|table"]) |
| |||||||||
%%(email) Email%% |
Hi! RI>> Yes, it is. >Are you sure? Of course, yes! Roman. | |||||||||
%%(sql) SQL-code%% |
SELECT * FROM sometable | |||||||||
Так же доступны форматтеры (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
Типы: default , error , example , important , note , question , quote , success , warning title заголовок коробкиicon показать иконку, значение по умолчанию 1 | ||||||||||
%%(info type="note")
|
Вики - это веб-сайт, на котором пользователи могут добавлять, удалять и редактировать любую страницу с помощью веб-браузера. Людям настолько легко начать работу и редактировать страницы, что вики-сайты становятся популярным инструментом для крупных проектов со множеством участников.
| |||||||||
%%(info type="warning")
|
У любого программного обеспечения, которое размещается в Интернете, могут быть обнаружены ошибки или проблемы с безопасностью. Не устанавливайте WackoWiki, если вы не намерены следить за обновлениями безопасности.
| |||||||||
15.2. PEAR Text HighlighterПакет PEAR для подсветки синтаксиса
форматтеры: 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%%
|
| |||||||||
%%(hl xml) xml-Code%%
|
<config> <section name="test"> <var>Test</var> <val><![CDATA[..text...]]></val> </section> </config> | |||||||||
15.3. GeSHiGeSHi Code Highlighting[link24] - Generic Syntax Highlighter %%(geshi [Форматер] numbers=1 start=35 lines=37) source%% | ||||||||||
%%(geshi css) CSS-Code%%
| Formatter
highlight/geshi not found | |||||||||
Если вы видите Форматтер highlight/geshi отсутствует, то GeSHi Форматтер[link24] не было добавлено на этот сайт. | ||||||||||
16. Обёртки вокруг форматтеров
Имеется также Deutsch[link25], English[link26], Français[link27], 简体中文[link28].
Дополнительно каждому форматтеру можно назначить отдельный кадр %%(ФОРМАТТЕР) 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
.
- [link1] https://wackowiki.org/doc/Doc/Deutsch/Formatierung
- [link2] https://wackowiki.org/doc/Doc/English/Formatting
- [link3] https://wackowiki.org/doc/Doc/Español/ReglasFormato
- [link4] https://wackowiki.org/doc/Doc/Français/MiseEnForme
- [link5] https://wackowiki.org/doc/Doc/Polski/FormatowanieTekstu
- [link6] https://wackowiki.org/doc/Doc/简体中文/格式化
- [link7] https://wackowiki.org/doc/Doc/Русский/Действия
- [link8] https://wackowiki.org/doc/Doc/Русский/Разметка
- [link9] https://wackowiki.org/doc/Doc/Русский/Песочница
- [link10] https://wackowiki.org/doc/Doc/Русский/Действия/АвтоОглавление
- [link11] https://wackowiki.org
- [link12] https://wackowiki.org/doc/Doc/Русский/Интервики
- [link13] http://wiki.c2.com/?OneMinuteWiki
- [link14] mailto:adresse@example.com
- [link15] https://example.com/archive.zip
- [link16] https://wackowiki.org/doc/Doc/Русский/Кластеры
- [link17] https://wackowiki.org/doc/HomePage
- [link18] https://wackowiki.org/doc/HomePage#TOC_1
- [link19] https://wackowiki.org/doc/Doc/Русский/ВикиИмя
- [link20] https://wackowiki.org/doc/Doc/Русский/Действия/Uploads
- [link21] https://wackowiki.org/doc/Subpage/file?get=archive.zip
- [link22] https://wackowiki.org/doc/Doc/Русский/WackoСинтаксис/Сноски
- [link23] https://wackowiki.org/doc/Users?profile=RomanIvanov
- [link24] https://wackowiki.org/doc/Dev/PatchesHacks/GeSHi
- [link25] https://wackowiki.org/doc/Doc/Deutsch/Formatierung/Wrapper
- [link26] https://wackowiki.org/doc/Doc/English/Formatting/Wrapper
- [link27] https://wackowiki.org/doc/Doc/Français/MiseEnForme/CadreFormatage
- [link28] https://wackowiki.org/doc/Doc/简体中文/格式化/Wrapper