Инструменты пользователя

Инструменты сайта


Боковая панель

Если вам не пришло письмо с регистрационными данными, проверьте папку «Спам»

Новости:

11 декабря
* Новая версия DataExpress



Обратная связь

Wiki-синтаксис
Как написать хорошую статью
Полигон

wiki:syntax

Основные конструкции форматирования

DataExpress Wiki поддерживает выделение текста жирным шрифтом, курсивом, подчёркнутый текст и вывод текста моноширинным шрифтом. Все эти конструкции можно объединить.

DataExpress Wiki поддерживает выделение текста **жирным шрифтом**, //курсивом//, 
__подчёркнутый текст__ и вывод текста ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**. 

Также можно использовать подстрочный и надстрочный индексы.

Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

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

Просто текст с разрывом строк
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Просто текст с разрывом строк\\ Обратите внимание,
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

Ссылки

Ссылки в DataExpress Wiki бывают разные и создавать их можно тоже по-разному.

Внешние

Внешние ссылки распознаются автоматически: http://mydataexpress.ru или просто www.mydataexpress.ru — также можно указывать текст ссылки: Это ссылка на DX Wiki. Адреса электронной почты тоже распознаются: mail@dataexpress.wiki.

Внешние ссылки распознаются автоматически: http://mydataexpress.ru или
просто www.mydataexpress.ru --- также можно указывать текст ссылки:
[[http://www.mydataexpress.ru|Это ссылка на DX Wiki]]. Адреса электронной почты
тоже распознаются: <mail@dataexpress.wiki>.

Внутренние

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

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[wiki:kak_pisat_wiki_stati]], либо
дополнительно прописать [[wiki:kak_pisat_wiki_stati|ссылка на эту статью]]. Имена
вики-статей автоматически  переводятся в нижний регистр,
спецсимволы использовать нельзя.

Можно использовать в ссылке пространства имён через двоеточие.

Можно использовать в ссылке [[videouroki:|пространства имён]] через двоеточие.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку (#) имя раздела, так же, как это делается в HTML. Ссылка на этот раздел.

Ссылка на [[#внутренние|этот раздел]].

Примечания:

  • Ссылки на существующие статьи отображаются иначе, чем ссылки на несуществующие.
  • DataExpress Wiki по умолчанию не использует CamelCase (ВерблюжийРегистр) для автоматического создания ссылок, но эту возможность можно включить в файле config. Проверка: если DokuWiki — ссылка, значит эта возможность включена.
  • Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.
  • Ссылки на разделы делаются именно на разделы.

Интервики

DaraExpress Wiki поддерживает интервики-ссылки. Это короткие ссылки на другие вики. Например, вот ссылка на статью Википедии о вики: Wiki.

DataExpress Wiki поддерживает интервики-ссылки. Это короткие ссылки
на другие вики. Например, вот ссылка на статью Википедии о вики: [[wp>Wiki]].

Картинки-ссылки

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]

Учтите: форматирование картинок — это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Сноски

С помощью двойных скобок можно добавить сноску1).

С помощью двойных скобок можно добавить сноску((Сноска —
помещаемые внизу страницы примечание, ссылка, перевод.)).

Разбивка на разделы

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

Заголовок 3 уровня

Заголовок 4 уровня

Заголовок 5 уровня
==== Заголовок 3 уровня ====
=== Заголовок 4 уровня ===
== Заголовок 5 уровня ==

Четыре и более тире преобразуются в горизонтальную черту:


Картинки и другие файлы

С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

Нормальный размер:                        {{wiki:logo.png}}
Отмасштабированная до заданной ширины:    {{wiki:logo.png?50}}
Отмасштабированная до заданных размеров:  {{wiki:logo.png?200x50}}
Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}

Поставив слева или справа пробел, можно задать выравнивание картинки:

{{wiki:logo.png }} — картинка слева
{{ wiki:logo.png }} — посередине
{{ wiki:logo.png}} — справа

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

Логотип DataExpress Wiki

{{ wiki:logo.png |Логотип DataExpress Wiki}}

Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif, jpeg, png), оно будет отображаться в виде ссылки.

Узнать, как вставить картинку со ссылкой можно в разделе выше.

Списки

DataExpress Wiki поддерживает нумерованные и маркированные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом звёздочку (*) в случае маркированного списка, или дефис (-) — в случае нумерованного.

  • Первый элемент маркированного списка
    • Второй элемент списка
      • Можно сделать вложенный список
    • Ещё один элемент
  1. Тот же список, только нумерованный
    1. Ещё элемент
      1. Чем больше пробелов в начале, тем глубже вложенность
    2. Всё просто
  * Первый элемент маркированного списка
    * Второй элемент списка
      * Можно сделать вложенный список
    * Ещё один элемент

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
  - Всё просто

Смайлики

DataExpress Wiki переделывает наиболее употребляемые смайлики в их графические эквиваленты. Вот смайлики, которые есть:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Типографские символы

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

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ® …
«Александр Сергеевич™ — это наше всё © не я»

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r) ...
"Александр Сергеевич(tm) --- это наше всё (c) не я"

Таблицы

DataExpress Wiki поддерживает упрощённый синтаксис создания таблиц.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Ряд 2 Колонка 1 Объединение колонок (обратите внимание на двойную вертикальную черту)
Ряд 3 Колонка 1 Ряд 2 Колонка 2 Ряд 2 Колонка 3

Нормальные ряды должны начинаться и заканчиваться вертикальной чертой — |, а заголовки «крышечкой» — ^.

^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |

Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым.

Вертикальные заголовки тоже можно сделать:

Заголовок 1 Заголовок 2
Заголовок 3 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Заголовок 4 Объединения нет
Заголовок 5 Ряд 2 Колонка 2 Ряд 2 Колонка 3

Как легко увидеть, разделитель, стоящий перед клеткой, определяет форматирование:

|              ^ Заголовок 1       ^ Заголовок 2      ^
^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
^ Заголовок 4  | Объединения нет   |                  |
^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 эта ячейка объединена вертикально Ряд 1 Колонка 3
Ряд 2 Колонка 1 Ряд 2 Колонка 3
Ряд 3 Колонка 1 Ряд 2 Колонка 3

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
| Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.

Таблица с выравниванием
вправо по центру влево
влево вправо по центру
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx
^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Примечание: вертикальное выравнивание не поддерживается.

Неформатируемые блоки

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code> или <file>.

Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.
В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.

Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги nowiki, либо ещё проще — в двойные знаки процента %%.

Это просто текст, в котором есть адрес http://mydataexpress.ru/ и **форматирование** — но ничего не происходит.

Это просто текст, в котором есть адрес %%http://mydataexpress.ru/%%
и %%**форматирование**%% --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код статьи.

Подсветка синтаксиса

DataExpress Wiki может подсвечивать программный код, чтобы его было проще читать. Синтаксис такой же, как и в блоке code в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например <code delphi>.

Procedure ButtonClick(Sender: TObject);
Begin
  MsgBox('DataExpress', 'Привет, МИР!!!');
End;
 
Procedure Form_Create;
Begin
  dxButton1.OnClick := @ButtonClick;
End;

Скачиваемые блоки кода

Используя тэги <code> или <file>, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:

myexample.pas
Procedure MyFieldChange(Sender, Control: TObject; const FieldName: String);
Begin
 If (FieldName = 'Количество') or (FieldName = 'Цена') then
 Self['Сумма'] := Self.AsI['Количество'] * Self.AsF('Цена')
  Else if Control = dxComboBox1 then
  Begin
   ...
  End;
End;
 
Procedure Form_Create;
Begin
 Self.OnFieldChange := @MyFieldChange;
End;

Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-) на месте кода языка: <code - myexample.pas>.

myexample.pas
Procedure Form_Create;
Begin
 Self.OnFieldChange := @MyFieldChange;
End;

Особенность: при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например «Мой Пример.pas».

Вставка HTML

Чистый HTML-код можно вставлять в документ с помощью тэгов html 2):

<html>
Тут вставлен <font color="red" size="+1">HTML-код</font>
</html>

Тут вставлен HTML-код

1)
Сноска — помещаемые внизу страницы примечание, ссылка, перевод.
2)
html — для строчного кода; HTML — для блочного кода
wiki/syntax.txt · Последние изменения: 2018/10/12 16:22 — jurist23rus