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

https://wackowiki.org/doc     Version: 119 (25.11.2022 14:37)

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

также доступны в 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))
картинка, которая ссылка.
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]
mammut mascot
file:/Subpage/archive.zip[link21]

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)

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 Расшифровка второй цифровой сноски

Автоматически создаваемые сноски
[[^ Текст сноски здесь]]
Генерирует сноски в конце страницы, см. пример[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

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

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-кода.
<?
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[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.


%%(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
%%