Форматирование текста
также доступны в Deutsch[link1], English[link2], Español[link3] , Français[link4], Polski[link5], 简体中文[link6]См. также: Действия (Аctions)[link7]
Форматирование текста в Wacko[link8] немного отличается от других вики. Поэтому стоит поглядеть на описание и примеры ниже.
Поэкспериментировать с форматированием вы можете в разделе Песочница[link9].
Текст, заключенный в две двойные кавычки слева и справа, не форматируется, и выводится так же, как был напечатан.
| источник | отображаемый |
Оглавление
{{toc numerate=1}}Подробное описание...[link10] |
Основы форматирования
**полужирный** | полужирный |
//курсив// | курсив |
__подчеркнутый__ | подчеркнутый |
##моноширинный##(можно использовать также №№, но это неэстетично и не приветствуется) | моноширинный |
++Мелкий текст++ | Мелкий текст |
--зачеркнутый-- | |
| 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;
}
|
Выравнивание
Выравнивание осуществляется при помощи вот такой сложной конструкции:| стандарт |
слева
|
%%(wacko wrapper=text wrapper_align=center) По центру%% |
По центру
|
%%(wacko wrapper=text wrapper_align=right) справа%% |
справа
|
%%(wacko wrapper=text wrapper_align=justify) По ширине%% |
По ширине
|
wrapper_align может быть center, right и justify.Cсылки
Знаками разметки для создания ссылок являются круглые скобки ((, )) и квадратные скобки [[, ]]. Оба знака равноправны. Использовать квадратные скобки может быть полезно, если текст документа уже содержит простые круглые скобки, которые могут быть ошибочно расценены разметкой.
Внешние ссылки
[[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.comJabber. | xmpp:adresse@example.com |
((tel:+1-234-567-890 +1-234-567-890))Номер телефона | +1-234-567-890[link15] |
((geo:-3.075833,37.353333 Килиманджаро))Географическое положение | Килиманджаро[link16] |
((https://example.com/archive.zip Archiv (zip) ))https://example.com/archive.zip | Archiv (zip)[link17] https://example.com/archive.zip |
Внутренние ссылки
[[Кластеры]] или ((Кластеры)) | Кластеры[link18] |
[[Кластеры Страница про кластеры]] или ((Кластеры Страница про кластеры)) | Страница про кластеры[link18] |
https://wackowiki.org/wacko_logo.png превратится в картинку. | ![]() |
((/HomePage https://wackowiki.org/wacko_logo.png)) картинка, которая ссылка. | [link19] |
{{anchor href="test"}} объявление якоря. |
|
((#test)) и ((/HomePage#TOC_1)) ссылки на якорь. | test и /HomePage#TOC_1[link20] |
NB: слова в смешанном регистре (ВотТакие) выделять ссылками вообще не надо (если разрешено автоматическое создание WikiLinks[link21]). Для прочих внутрисайтовых ссылок URL писать не нужно (иначе не возникает связи между двумя страницами). URL нужен лишь для внешних ссылок.
NB: чтобы ВотТакое слово не стало ссылкой, поставьте перед ним знак ~ (тильда).
NB: подробности простановки ссылок на документы, находящиеся не в корне, описаны в разделе Кластеры[link18].
NB: Для изменения размера и выравнивания изображений из внешних источников можно использовать следующий синтаксис: ((http://example.com/image.png width=500 align=center)), доступные параметры width, height и align=[left, center, right].
Интеграция загруженные файлы
file:/mammut_mascot.jpgпроверяет только файлы, доступные всем посетителям file:mammut_mascot.jpgпроверяет файлы, доступные только читателям данной страницы file:/Subpage/archive.zipчтобы отобразить файл, доступный только читателям данной страницы, на другой странице, указывается абсолютный путь этого файла Файл должен быть загружен уже. подробное описание...[link22] | ![]() file:/Subpage/archive.zip[link23] |
Медиа параметры
Параметры добавляются в синтаксис файла путем добавления вопросительного знака? и дополнительных параметров с помощью амперсанда &.например
file:/lotus_flower.webp?right&caption&400
(Source:: Yoshikazu TAKADA /Some rights reserved)
- Поведение при клике
-
direct- ссылки на файл -
nolink- показывает только изображение -
linkonly- показывает только ссылку -
meta- ссылки на filemeta handler (default)
-
- Выравнивание
-
right- справа -
left- слева -
center- посередине
-
- Изменение размеров
-
400x300- ширина × высота -
0x700- высота -
600- ширина
-
- другие
-
caption- подпись к рисунку шоу -
clear- clears float
-
Заголовки
NB: В заголовках справа не обязательно должно быть такое же количество знаков "=", достаточно двух.
== Большой заголовок == обычно устанавливается вместе с заголовком страницы и по умолчанию не включается в оглавление.
Отступы и списки
Отступы делаются с помощью двух пробелов (можно использовать устаревший вариант - табуляцию).
Так же нужно выделять отступом списки.
Списки:
Отступ
Двойной отступ
----
* ненумерованный список
* ненумерованный список-2
----
1. нумерованный список
1. нумерованный список-2
1.#8 нумерованный список-2, с пропуском
----
A. Верхний регистр
A. Верхний регистр-2
----
a. Нижний регистр
a. Нижний регистр-2
----
i. Римские цифры
i. Римские цифры-2
----
1. список
1. вложенный список
* ещё более вложенный список
1. вложенный список-2
2. список-2
| Списки: Отступ
Двойной отступ
|
Цитирование и определение
Сноски (footnotes)
Текст, потом сноска[[*]] и вторая[[**]] | Текст, потом сноска* и вторая** |
Текст, потом цифровая сноска[[*1]] и вторая[[*2]] | Текст, потом цифровая сноска1 и вторая2 |
[[#*]] Расшифровка первой сноски[[#**]] Расшифровка второй сноски[[#1]] Расшифровка цифровой сноски[[#2]] Расшифровка второй цифровой сноски | * Расшифровка первой сноски ** Расшифровка второй сноски 1 Расшифровка цифровой сноски 2 Расшифровка второй цифровой сноски |
Автоматически создаваемые сноски [[^ Текст сноски здесь]] | Генерирует сноски в конце страницы, см. пример[link24] |
Цитирование
Чтобы отметить текст как ответ или комментарий, вы можете использовать следующий синтаксис:
Привет! > Да, это так. >> Вы уверены? > Конечно, да! >> Правда? >>> Что теперь? | Привет! > Да, это так. >> Вы уверены? > Конечно, да! >> Правда? >>> Что теперь? |
Таблицы
Таблица с рамкой
#|
*|заголовок 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, если он разрешен в настройках сайта.
Чтобы включить знак вертикальная черта
| в качестве содержимого внутри вашей ячейки следует заключить его в пару двойных кавычек: ""|""Прочее
Разделитель:
----Явный перевод строки:
тест---шместтест
шмест
Принудительную пустую строку:
---"" ""---Вывод текста как есть, без применения форматирования:
текст необходимо заключить в двойные кавычки. В качестве примера можете изучить исходный текст данной страницы.
Кроме того, для экранирования любого вида разметки, можно использовать
~ (тильду).Вывод 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 не должно быть пробелов. Эта разметка создана для математики и ради компактности и совместимости не допускает наличия пробелов внутри размеченного блока
Автокорректор
Автоматический корректор, встроенный в wiki, самостоятельно подгоняет сохраняемый текст под нормы форматирования, избавляя авторов от излишне детальной правки. Вот какие изменения он вносит:
Расстановка. Пробелов! И заглавий Минус - превращает в тире Два минуса -- в длинное тире Спецсимволы (c), (r), (tm), (p), +- Знаки градуса -15^C, +270^K "Кавычки", "quotes" | Расстановка. Пробелов! И заглавий Минус - превращает в тире Два минуса -- в длинное тире Спецсимволы (c), (r), (tm), (p), +- Знаки градуса -15^C, +270^K "Кавычки", "quotes" |
Если какой-то текст необходимо вывести "как есть", исключая его автоматическую корректуру, заключите его в двойные кавычки (заметьте: вся wiki-разметка внутри двойных кавычек также выводится на экран, а не форматирует текст).
Макросы
Макросы отличаются от остальной разметки тем, что при повторном редактировании документа вы увидите не вызов макроса, а результат его работы -- они отрабатывают при сохранении текста.
Имя текущего пользователя:
::::RomanIvanov[link25]
Имя текущего пользователя и дата:
::@::RomanIvanov[link25] /20.06.2003 18:13/
Дата:
::+::20.06.2003 18:13
Расширения - дополнительные форматтеры
В WackoWiki можно легко добавлять новые обработчики текста. Их вызов происходит по синтаксису%%(name) текст%%.В качестве символов разметки для форматирования текста можно использовать знаки процента
%%, %% или диакритические знаки "гравис" (обычно на букве ё в латинской раскладке) ``, ``. Оба вида разметки эквивалентны. Грависы могут быть полезны, если текст уже содержит знаки процента, которые могут быть ошибочно приняты за разметку.Кроме того, это позволяет обернуть один форматтер в другой форматтер, например, обернуть CSS с подсветкой в форматтер для отображения в виде раскрывающегося блока.
В стандартной поставке есть следующие форматтеры:
%%(wacko)текст как есть. [[/HomePage]]%%Этот форматтер выводит текст так же, как если бы он был написан без форматера. Удобен для применения дополнительных оберток к тексту (выравнивание, боксы и тому подобное. См ниже.) | текст как есть. /HomePage[link19]
| |||||||||
%%(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. | |||||||||
Info box
Типы: default, error, example, important, note, question, quote, success, warningtitle заголовок коробкиicon показать иконку, значение по умолчанию 1 | ||||||||||
%%(info type="note")
|
Вики - это веб-сайт, на котором пользователи могут добавлять, удалять и редактировать любую страницу с помощью веб-браузера. Людям настолько легко начать работу и редактировать страницы, что вики-сайты становятся популярным инструментом для крупных проектов со множеством участников.
| |||||||||
%%(info type="warning")
|
У любого программного обеспечения, которое размещается в Интернете, могут быть обнаружены ошибки или проблемы с безопасностью. Не устанавливайте WackoWiki, если вы не намерены следить за обновлениями безопасности.
| |||||||||
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> | |||||||||
GeSHiGeSHi Code Highlighting[link26] - Generic Syntax Highlighter %%(geshi [Форматер] numbers=1 start=35 lines=37) source%% | ||||||||||
%%(geshi css) CSS-Code%%
| Formatter
highlight/geshi not found | |||||||||
Если вы видите Форматтер highlight/geshi отсутствует, то GeSHi Форматтер[link26] не было добавлено на этот сайт. | ||||||||||
Обёртки вокруг форматтеров
Имеется также Deutsch[link27], English[link28], Français[link29], 简体中文[link30].
Дополнительно каждому форматтеру можно назначить отдельный кадр %%(ФОРМАТТЕР) 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
КОММЕНТАРИЙ = всё остальное, что угодно.
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] https://wiki.c2.com/?OneMinuteWiki
- [link14] mailto:adresse@example.com
- [link15] tel:+1-234-567-890
- [link16] geo:-3.075833,37.353333
- [link17] https://example.com/archive.zip
- [link18] https://wackowiki.org/doc/Doc/Русский/Кластеры
- [link19] https://wackowiki.org/doc/HomePage
- [link20] https://wackowiki.org/doc/HomePage#TOC_1
- [link21] https://wackowiki.org/doc/Doc/Русский/ВикиИмя
- [link22] https://wackowiki.org/doc/Doc/Русский/Действия/Uploads
- [link23] https://wackowiki.org/doc/Subpage/file?get=archive.zip
- [link24] https://wackowiki.org/doc/Doc/Русский/WackoСинтаксис/Сноски
- [link25] https://wackowiki.org/doc/Users?profile=RomanIvanov
- [link26] https://wackowiki.org/doc/Dev/PatchesHacks/GeSHi
- [link27] https://wackowiki.org/doc/Doc/Deutsch/Formatierung/Wrapper
- [link28] https://wackowiki.org/doc/Doc/English/Formatting/Wrapper
- [link29] https://wackowiki.org/doc/Doc/Français/MiseEnForme/CadreFormatage
- [link30] https://wackowiki.org/doc/Doc/简体中文/格式化/Wrapper

