WikiFormatting Проект Trac

WikiФорматирование.

Содержание.

Плагины для настройки установки индекса Обновление конфигурации Администрирование Резервное копирование Разрешения на ведение журнала Wiki Wiki Форматирование Хронология Репозиторий Журнал изменений Браузер Наборы изменений Тикеты Рабочий процесс Дорожная карта Запросы по заявкам Пакетное изменение отчетов Уведомление о поддержке RSS.

Языки:

Deutsch English Русский 简体 中文.

Разметка вики — это ключевая функция Trac, которая тесно интегрирует все другие части Trac в гибкое и унифицированное целое..

Trac имеет мощный движок рендеринга вики, который реализует подмножество команд из других популярных вики, таких как MoinMoin и WikiCreole..

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

На следующих вики-страницах более подробно представлены расширенные функции разметки вики-страницы Trac:

TracLinks охватывает все возможные способы ссылки на любой ресурс Trac или его части. WikiPageNames охватывает различные имена, которые может принимать страница вики, будь то CamelCase или нет. WikiMacros перечисляет макросы, доступные для создания динамического содержимого. WikiProcessors и WikiHtml подробно описывают, как части текста вики могут быть обработаны особым образом. AdvancedWikiOperations предоставляет некоторые операции в необычных или административных сценариях..

Общая разметка вики.

Уровень 2.

Уровень 3 (примечание)

Первый абзац на нескольких строках.

если есть начальный пробел, текст цитируется.

Разрыв строки Разрыв строки.

Стили шрифтов.

Вики-сайт Trac поддерживает следующие стили шрифтов:

>> и `. Команды `не только выбирают моноширинный шрифт, но и обрабатывают их содержимое как дословный текст, что означает, что дальнейшая обработка этого текста в вики не производится. ! указывает синтаксическому анализатору вики не принимать следующие символы в качестве формата вики, поэтому обратите внимание на то, чтобы после них был пробел! , например при окончании жирным шрифтом. все метки стилей шрифта должны использоваться в парах открытия / закрытия, и они должны быть правильно вложены; в частности, курсив нельзя сочетать с // единицей, а » ‘нельзя сочетать с ** .

Заголовки.

Вы можете создать заголовок, начав строку с одного до шести одинаковых символов (=), за которым следует один пробел и текст заголовка..

За текстом заголовка может следовать такое же количество символов =, но это не обязательно. То есть === Section3 === идентичен === Section3 .

Наконец, за заголовком может дополнительно следовать явный идентификатор. В противном случае будет сгенерирован неявный, но, тем не менее, читаемый идентификатор..

Заголовок.

Подзаголовок.

Об этом.

Явный идентификатор.

Подзаголовок.

Абзацы.

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

Также можно вставить принудительный разрыв строки, используя:

Списки.

Вики поддерживает как упорядоченные / нумерованные, так и неупорядоченные списки..

это начнёт новый абзац …

Пункт 1 Пункт 1.a Пункт 1.b Пункт 1.b.i Пункт 1.b.ii Пункт 2.

Нумерованные списки также можно перезапустить с явным номером:

Списки определений.

Вики также поддерживает списки определений.

Вики-разметка Отображение ламы, какого-то млекопитающего, с шерстью, ppython, какой-то рептилии, без волос (вы можете заметить опечатку?)

Обратите внимание, что вам нужен пробел перед определенным термином.

Предварительно отформатированный текст.

Блок, содержащий предварительно отформатированный текст, подходит для фрагментов исходного кода, заметок и примеров. Используйте три фигурные скобки, обернутые вокруг текста, чтобы определить цитату блока. Фигурные скобки должны быть на отдельной строке..

Отображение разметки вики.

Обратите внимание, что этот тип блока также используется для выбора строк, которые должны обрабатываться через WikiProcessors..

Цитаты.

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

Этот текст — чужая цитата.

Цитаты для обсуждения.

Чтобы выделить цитату в текущей цепочке обсуждения, например, в области комментариев к тикету, отметки цитирования, похожие на электронные письма ( > , >> , и т. д.) могут быть использованы.

Чужой текст ответа.

которая может быть любой разметкой Wiki.

Столы.

Простые таблицы.

Можно создавать простые таблицы:

Заголовки ячеек можно указать, заключив содержимое в пару символов =. Обратите внимание, что символы = должны стоять на разделителях ячеек:

Наконец, указание пустой ячейки означает, что следующая непустая ячейка будет охватывать пустые ячейки:

Обратите внимание, что если содержимое ячейки прилипает к одной стороне ячейки и только к одной, то текст будет выровнен по этой стороне:

Если, в отличие от приведенного выше примера, ячейки в вашей таблице содержат больше текста, может быть удобно распределить строку таблицы по нескольким строкам разметки. Символ \, помещенный в конце строки после разделителя ячеек, указывает Trac не начинать новую строку для ячеек в следующей строке:

Комплексные таблицы.

Если возможностей, предлагаемых простой разметкой на основе конвейера (||) для таблиц, описанных выше, недостаточно для ваших нужд, вы можете создать более сложные таблицы, используя таблицы на основе WikiProcessor..

Ссылки.

Гиперссылки автоматически создаются для WikiPageNames и URL-адресов. Ссылки WikiPageLink можно отключить, поставив перед ними восклицательный знак (!), Например! WikiPageLink .

Ссылки можно дать более информативный заголовок, написав ссылку, за которой следует пробел и заголовок, и все это внутри квадратных скобок. Если описательный заголовок опущен, явный префикс отбрасывается, если только ссылка не является внешней ссылкой. Это может быть полезно для вики-страниц, не соблюдающих соглашение WikiPageNames..

Следуя тенденции WikiCreole, описательный заголовок также можно указать, написав ссылку, за которой следует вертикальная черта (|) и заголовок, и все это внутри двойных квадратных скобок..

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

Ссылки Trac.

Вики-страницы могут напрямую ссылаться на другие части системы Trac. Страницы могут ссылаться на заявки, отчеты, наборы изменений, вехи, исходные файлы и другие страницы Wiki, используя следующие обозначения:

Есть еще много разновидностей ссылок Trac, см. TracLinks для получения более подробной информации и справочника для всех преобразователей ссылок по умолчанию..

Установка якорей.

Якорь, или, точнее говоря, имя якоря можно явно добавить в любое место на странице Wiki, чтобы однозначно идентифицировать позицию в документе:

Этот синтаксис был выбран для соответствия формату явного обозначения идентификатора заголовка, описанному выше:

Он также очень близок к синтаксису соответствующей ссылки на этот якорь:

При желании якорю можно присвоить метку:

Для более сложных привязок (например, когда требуется настраиваемый заголовок) вы можете использовать макрос Span: [[span (id = point2, title = Point 2, ^ (2) ^)]] .

Экранирование ссылок, WikiPageNames и другой разметки.

Вы можете избежать создания гиперссылок из TracLinks, поставив перед выражением один восклицательный знак (!).

NoHyperLink # 42 не является ссылкой.

Различные формы экранирования для разметки списка:

— экранированный знак минус 1. экранированный номер * экранированный знак звездочки.

Изображений.

URL-адреса, заканчивающиеся на .png, .gif или .jpg, больше не интерпретируются автоматически как ссылки на изображения и преобразуются в теги..

Теперь вам нужно использовать макрос [[Image]]. Самый простой способ добавить изображение — загрузить его как вложение на текущую страницу и указать имя файла в вызове макроса, например [[Image (picture.gif)]] .

Помимо текущей страницы, можно ссылаться на другие ресурсы:

См. Дополнительную документацию по макросу [[Image ()]] в WikiMacros, который имеет несколько полезных опций (title =, link = и т. Д.)

Макросы.

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

24 мар. 2021 г.

17 мар. 2021 г.

26 февр. 2021 г.

См. WikiMacros для получения дополнительной информации и список установленных макросов..

Подробную справку по конкретному макросу можно получить напрямую, добавив? к имени макроса.

[[MacroList]]

Показать список всех установленных макросов Wiki, включая документацию, если таковая имеется.

При желании в качестве аргумента можно указать имя конкретного макроса. В этом случае будет отображена только документация для этого макроса..

Обратите внимание, что этот макрос не сможет отображать документацию макросов, если для mod_python включена опция PythonOptimize.!

Процессоров.

Trac поддерживает альтернативные форматы разметки с помощью WikiProcessors. Например, процессоры используются для записи страниц в reStructuredText или HTML..

HTML тест.

С процессорами #td и #th ячейки таблицы могут содержать любое содержимое:

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

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

См. WikiProcessors для получения дополнительной информации..

Комментарии.

Комментарии могут быть добавлены к обычному тексту. Они не будут отображаться и не будут отображаться в любом другом формате, кроме обычного текста..

Разное.

Четыре или более дефиса будут заменены горизонтальной линией ()

Похожие статьи