Содержание
Вики-разметка в профессиональном вики-редакторе | Центр Интернет
Профессиональный вики-редактор использует движок MediaWiki (используется Википедией) для обработки вики-разметки. Поэтому, все стандартные правила MediaWiki поддерживаются и в Кампусе. Дополнительно движок MediaWiki расширен нестандартным форматированием, не совместимым с Википедией.
Содержание
- 1 Стандартное форматирование
- 2 Разметка форматирования текста
- 3 Абзацы
- 4 HTML теги
- 5 HTML символы
- 6 Ссылки
- 7 Таблицы
- 8 Математические формулы
- 9 Цитирование
- 9.1 Example
- 9.2 Многократное использование цитаты
- 10 Нестандартное форматирование
- 11 Рисунки
- 12 Исходный код
- 13 Вставка файлов
- 13.1 Пример вставки видео
- 13.2 Пример вставки рисунка с заданными размерами
- 14 Вставка контента с веб-сервисов
- 14.1 Поддерживаются следующие веб-сервисы
Стандартное форматирование[править]
Разметка форматирования текста[править]
Описание | Формат | Результат |
---|---|---|
форматирование символов — работает везде | ||
Наклонный текст | »Курсив» | курсив |
Полужирный текст | »’Полужирный»’ | полужирный |
Полужирный и наклонный текст | »»’Полужирный и курсив»»’ | Полужирный и курсив |
Отмена форматирования wiki | <nowiki>нет »курсива»</nowiki> | нет »курсива» |
оформление заголовков — работает только с новой строки | ||
Текст с отступом | :Текст с отступом |
|
Заголовки разных уровней | ==Уровень 1== В статьях с четырьмя и более заголовками автоматически создаётся таблица содержания. | Уровень 1 Уровень 2 Уровень 3 Уровень 4 Уровень 5 |
Горизонтальная линия | —- | |
Список с маркерами | * первый * второй * третий ** первый в третьем ** второй в третьем Оставляйте пустую строку между окончанием первого списка и началом следующего. |
|
Список с числами | # первый # второй<br />несколько строк<br />не нарушая нумерацию # третий ## первый в третьем ## второй в третьем |
|
Список определений | ;элемент 1 :определение 1 ;элемент 2 :определение 2-1 :определение 2-2 |
|
Применение возможностей оформления списка определений для отступов текста | :Первый отступ ::Второй отступ :::::Ещё несколько отступов Это применение может быть спорным с точки зрения удобства. |
|
Смесь списка с маркерами и списка с числами | # первый # второй #* первый во втором #* второй во втором # третий #; элемент определения в третьем #: определение элемента в третьем # четвёртый #: four item one #: это скорее похоже на продолжение # четыре #: и таким образом часто используемый вместо <br /> ;элемент 1 :* определение 1-1 :* определение 1-2 : ;элемент 2 :# определение 2-1 :# определение 2-2 Использование тегов #: и *: для разрыва строк в определениях может оказаться спорным. |
|
Предварительно отформатированный текст | частично неформатированный текст оформляется с помощью '''пробела''' в ''начале'' строки Этот способ частичной отмены форматирования действует только в отношении абзацного оформления; символьное форматирование продолжает применяться. | частично неформатированный тест оформляется с помощью пробела в начале строки |
Вики игнорирует обычные переносы строк. Для начала нового абзаца оставьте пустую строку. Новую строку также можно начать с HTML-тега <br />.
В вики по умолчанию включена поддержка только некоторых HTML-тэгов, как например <code>, <div>, <span> и <font>.
Описание | Формат | Результат |
---|---|---|
Фиксированная ширина символов | <tt>Фиксированная ширина символов</tt> | Фиксированная ширина символов |
Цитаты | текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст <blockquote> цитата цитата цитата цитата цитата цитата </blockquote> текст текст текст текст текст текст текст текст текст текст | текст текст текст текст текст текст текст текст текст текст
текст текст текст текст текст текст текст текст текст текст |
Комментарии | <!--Это комментарий--> | |
Полностью неформатированный текст | <pre>с помощью этого тега вся разметка '''игнорируется'''</pre> | с помощью этого тега вся разметка '''игнорируется''' |
HTML символы это набор символов, который обозначает один конкретный символ. Например, → обозначает стрелку вправо → и — обозначает тире —. HTML символы используются в основном в двух случаях: для добавления символов не доступных на клавиатуре:
- © → ©
- δ → δ
и обхода работы парсера при отображение HTML тегов и символов:
- &euro; → €
- € → €
- <span>Green</span> → <span>Green</span>
- <span>Green</span> → Green
Ниже приведен список символов, которые могут быть получены с использованием HTML символов. Символы не доступные в текущем шрифте будут отображаться пустыми квадратиками.
Таблица HTML Символов | |||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Á | á | Â | â | ´ | Æ | æ | À | à | ℵ | Α | α | & | ∧ | ∠ | Å | å | ≈ | Ã | ã | Ä | ä | „ | Β | β | ¦ | • | ∩ | Ç | ç | ¸ | ¢ |
Χ | χ | ˆ | ♣ | ≅ | © | ↵ | ∪ | ¤ | † | ‡ | ↓ | ⇓ | ° | Δ | δ | ♦ | ÷ | É | é | Ê | ê | È | è | ∅ | Ε | ε | ≡ | Η | η | ||
Ð | ð | Ë | ë | € | ∃ | ƒ | ∀ | ½ | ¼ | ¾ | ⁄ | Γ | γ | ≥ | > | ↔ | ⇔ | ♥ | … | Í | í | Î | î | ¡ | Ì | ì | ℑ | ∞ | ∫ | Ι | ι |
¿ | ∈ | Ï | ï | Κ | κ | Λ | λ | 〈 | « | ← | ⇐ | ⌈ | “ | ≤ | ⌊ | ∗ | ◊ | | ‹ | ‘ | < | ¯ | — | µ | · | − | Μ | μ | ∇ | – | |
≠ | ∋ | ¬ | ∉ | ⊄ | Ñ | ñ | Ν | ν | Ó | ó | Ô | ô | Œ | œ | Ò | ò | ‾ | Ω | ω | Ο | ο | ⊕ | ∨ | ª | º | Ø | ø | Õ | õ | ⊗ | Ö |
ö | ¶ | ∂ | ‰ | ⊥ | Φ | φ | Π | π | ϖ | ± | £ | ′ | ″ | ∏ | ∝ | Ψ | ψ | » | √ | 〉 | » | → | ⇒ | ⌉ | ” | ℜ | ® | ⌋ | Ρ | ρ | |
› | ’ | ‚ | Š | š | ⋅ | § | | Σ | σ | ς | ∼ | ♠ | ⊂ | ⊆ | ∑ | ⊃ | ¹ | ² | ³ | ⊇ | ß | Τ | τ | ∴ | Θ | θ | ϑ | Þ | þ | ˜ | |
× | ™ | Ú | ú | ↑ | ⇑ | Û | û | Ù | ù | ¨ | ϒ | Υ | υ | Ü | ü | ℘ | Ξ | ξ | Ý | ý | ¥ | ÿ | Ÿ | Ζ | ζ | | |
Описание | Формат | Результат | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Внешняя ссылка | http://mediawiki. 2</math> Вы можете заключать цитаты в тег <ref> по ходу статьи и вставить список цитат (обычно, в конце статьи) при помощи тега <references /> Example[править]
Многократное использование цитаты[править]Если на одну цитату надо сослаться несколько раз, то цитату надо проименовать при помощи атрибута name <ref name=»name»> и, при повторном цитировании, вставлять именованную цитату по имени: <ref name=»name» />. Пример многократного использования цитаты:
Нестандартное форматирование[править]Стандартная поставка MediaWiki не включает некоторого необходимого функционала или включает в неудобном для использования виде. Описанный ниже функционал является нестандартным и непереносимым из Кампуса на другие инсталляции MediaWiki. Вставка рисунка осуществляется простой ссылкой на него: https://user.files.psu.ru//ars/img/node/wifi-k2.png Ширина рисунка не будет превышать заданных в системе размеров и будет уменьшаться при уменьшении окна браузера. При необходимости задать точные размеры рисунка, следует использовать синтаксис вставки файла: {{файл:https://user.files.psu.ru//ars/img/node/wifi-k2.png | ширина=300 | описание=Покрытие Wi-Fi в ПГНИУ }} ‘.<div>Покрытие Wi-Fi в ПГНИУ</div>.’ Вставка исходного кода осуществляется нестандартным для MediaWiki способом путем заключения исходного кода в теги <code></code>. Язык кода определится автоматически. Если язык определился неправильно, его можно указать в виде дополнительного атрибута без значения. Список языков можно найти здесь. <code php>echo "hello world";</code> echo "hello world"; Вставка файлов[править]Для вставки некоторых типов файлов можно использовать разметку {{файл:URL | тип=Тип файла | ширина=640 | выравнивание=справа | описание=Описание файла | высота=480 }} Результат работы зависит от расширения в URL. Таким образом можно вставлять файлы по протоколу http и https с расширениями mp4, webm, ogv, ogg, mp3, wav, jpeg, jpg, png, svg, bmp. Возможно, в дальнейшем, будут добавлены другие расширения. Обязательным является указание URL, все остальные параметры являются не обязательными. Пример вставки видео[править]{{файл:http://212.192.64.195/sintel.2010.1080p-j98w1280h720.mp4| | ширина=640 | | описание=Sintel }} ‘.<div>Sintel</div>.’ Пример вставки рисунка с заданными размерами[править]{{файл:https://user.files.psu.ru//ars/img/node/wifi-k2.png | ширина=300 | описание=Покрытие Wi-Fi в ПГНИУ }} ‘.<div>Покрытие Wi-Fi в ПГНИУ</div>.’ Вставка контента с веб-сервисов[править]Поддерживается вставка контента с большого числа веб-сервисов путем простой публикации ссылки на материал. Из ссылки автоматически достается идентификатор ресурса и вставляется его Embed-код. Поддерживаются следующие веб-сервисы[править]
Примеры можно посмотреть на странице демонстрации Вики-разметка во Вконтакте для начинающих | Академия Лидогенерации | Официальный сайтС помощью вики-разметки можно оформить меню группы, аналитические статьи, кейсы, инструкции. Конечно, на это нужно будет потратить чуть больше времени, чем на оформление привычных постов на стене. Но чем больше вы заморочитесь с оформлением контента — тем благодарнее будет ваша аудитория. Как работает вики-разметка Вики-разметка — это язык, который используется для верстки страниц. Условно его можно назвать младшим братом HTML. На вики-страницах удобно писать и форматировать текст, вставлять иллюстрации, видео, ссылки, таблицы. Можно сверстать простую статью или составить целый интерактивный гайд с главами и подзаголовками. Ширина любой вики-страницы — 607px. Высота ограничивается только количеством знаков, всего их может быть около 16 000. Вся вики-разметка держится на тегах, как и HTML. Есть одиночные теги (например, <br/> — перенос строки) и парные (например, <b>жирный текст</b>). Как работают теги для текста в вики-разметке В некоторых случаях вики-разметка использует упрощенный синтаксис (теги заменены на типографские знаки). Например, для создания маркированного списка используются звездочки «*», а для нумерованного — решетки «#». Как работают типографские знаки в вики-разметке Все существующие теги и методы их использования собраны в официальном сообществе вики-разметки ВКонтакте. Используйте материалы этого сообщества как надежную шпаргалку. А в этой статье мы пройдемся по основным принципам работы с вики-разметкой и пошагово покажем, как с ее помощью создавать страницы и меню группы. В стандартном редакторе вики-страниц есть два режима: визуальный и режим вики-разметки (кнопка переключения выглядит так: <>). Так выглядит активный режим вики-разметки Примитивный текст с парой картинок можно сверстать в визуальном режиме. Это обычный редактор текста и не требует никаких знаний вики-разметки. Но если вам нужна аккуратная вики-страница с таблицами, ссылками и встроенными видео, это можно сделать только в режиме разметки — при помощи кода. Сами создатели ВКонтакте рекомендуют не переключать режимы редактирования туда-сюда во время работы. Говорят, это чревато ошибками на странице и съехавшей версткой. Как создать вики-страницу Кнопки «Создать новую страницу» в интерфейсе самого ВКонтакте не существует. Поэтому рассказываем о двух способах, стандартном и продвинутом (при помощи приложения). Стандартный Для группы. Зайдите в «Управление сообществом» → «Разделы» → «Материалы» и выберите пункт «Открытые» или «Ограниченные». Как включить «Материалы» в группе Теперь на главной странице группы появится раздел «Свежие новости». Это место для предполагаемого меню группы. Чтобы создать новую страницу, можно написать ее название прямо в режиме редактирования страницы «Свежие новости», заключить его в квадратные скобки, нажать на «Предпросмотр» и получить готовую ссылку на новую страницу. Как создать новую страницу через «Свежие новости» Для паблика. Чтобы создать новую страницу, нужно узнать id вашего паблика. Для этого зайдите в раздел «Статистика сообщества». В адресной строке браузера вы увидите примерно такой код:
Искомое id группы — это все цифры после «gid=». Теперь нужно ввести в адресную строку браузера такой код:
Вместо ХХХ подставляем id паблика, вместо «Нaзвание_страницы» — то название, которое вы придумали. В названии можно использовать кириллицу, латиницу и цифры. Специальные символы использовать не запрещено, но лучше не рисковать: из-за них у вас может пропасть возможность редактирования страницы. Вставляем все данные на нужные места, нажимаем Enter, и браузер откроет созданную страницу. С помощью приложения Разработчики ВКонтакте рекомендуют к использованию три приложения для работы с вики-разметкой: «Мобивик», «Исходный код» и «Вики Постер». В этом руководстве мы возьмем для примера приложение «Мобивик». В ноябре 2017 года оно получило второй приз в программе ВКонтакте по поддержке стартапов (Start Fellows). Работает без установки и дополнительной регистрации в десктопной, мобильной версии ВКонтакте и в приложении для телефона (разработчик рекомендует использовать версии не ранее Android 5.1, iOS 9 и Windows Phone 8.1). Чтобы создать новую страницу, на главном экране приложения выберите нужную группу и введите название новой страницы, а затем нажмите «Получить ссылку». Как создать новую страницу с помощью приложения «Мобивик» После этого вы получите 3 ссылки. Действуйте в зависимости от предпочтений: можно начать редактировать страницу в стандартном интерфейсе вики-разметки или в приложении «Мобивик». Ссылки на новую вики-страницу в приложении «Мобивик» А вот лайфхак для тех случаев, когда вы сделали сложную страницу с большим количеством элементов, и боитесь, что верстка поедет на маленьком экране. Скопируйте адрес из пункта «Код для вики-страницы». Зайдите в режим редактирования своей страницы и вставьте его в самое начало кода. Вы получите такое изображение: Когда пользователь нажмет на него, он попадет в приложение «Мобивик», которое покажет аккуратную мобильную версию вашей страницы. Слева — страница меню сообщества LIVE, открытая на мобильном, Как получить ссылку на вики-страницу Как найти страницу, созданную ранее? Самый простой и надежный метод — заранее скопировать все адреса вики-страниц в отдельный файл, например, в Google Таблицах. Другой способ — через любое приложение для работы с вики-страницами. Например, зайдите в «Мобивик», выберите название сообщества и нужную страницу, кликните «Получить ссылку» и скопируйте адрес из пункта «Ссылка на вики-страницу». Как получить ссылку на ранее созданную вики-страницу Как сделать пост со ссылкой на вики-страницу Скопируйте ссылку на вики-страницу и вставьте в новую запись на своей стене или на стене сообщества. Если все сделано правильно, сайт сгенерирует ссылочный блок под текстовым полем записи. Теперь удалите сам текст ссылки, прикрепите баннер и нажмите «Отправить». В десктопной версии баннер тоже станет ссылкой на вики-страницу, а в мобильной — будет открываться как обычная картинка. Прикрепленная к посту картинка станет частью ссылки на вики-страницу в десктопной версии Текст Возможности оформления текста в вики-разметке в целом не отличаются от возможностей рядового текстового редактора. При редактировании непосредственно текста (сделать жирным, выровнять по правому краю и т. д.) используем теги вики-разметки, не забываем их закрывать: <center>Текст по центру</center>. Для структурирования текста в вики-разметке предусмотрены сочетания типографских знаков. Например, такой код «—-» поставит в тексте горизонтальную разделяющую полосу, а такой «::» — двойной отступ перед абзацем. На одну страничку можно поместить около 16 тысяч знаков. Ссылки Ссылку можно прикрепить к тексту или изображению. Ссылаться можно на внешний сайт или внутренние страницы ВК (профиль пользователя, фотографии, альбомы, видео, группы, обсуждения, приложения). Внешние. Если мы ставим ссылку на внешний сайт, то пишем адрес целиком и заключаем его в одинарные квадратные скобки:
Чтобы вместо адреса был виден текст, добавляем название ссылки:
Если мы хотим сделать гиперссылкой картинку, используем такой код:
Внутренние (ссылки на какую-либо страницу сайта vk.com). Здесь используем не целый адрес страницы, а только id объекта. Например, вот ссылка на официальную группу Академии Лидогенерации ВКонтакте, оформленная в виде текста. После club — id сообщества, после вертикальной черты — текст, в который зашита ссылка.
А вот пример кода картинки со ссылкой на внутренние страницы (ХХХ заменить на соответствующее id).
Картинки Предельная ширина изображения, которое можно использовать в вики-разметке, — 607px, это и есть ширина самой вики-страницы. Высота практически не ограничена (помним, что высота самой страницы — 16 000 знаков). Изображения можно загрузить двумя способами. С помощью загрузчика в верхнем меню редактора. С помощью кода. Загружаем картинку в отдельный альбом группы, открываем ее, в адресной строке видим длинный код наподобие этого
Копируем из него id картинки (выделено жирным). Дальше обрамляем это двойными квадратными скобками и вставляем в нужные места на странице. Получается примерно так:
Что дальше? Отредактируйте выравнивание, обтекание текстом, размер, привяжите ссылку. Для этого напишите нужные параметры после вертикальной черты и через точку с запятой. Например, в таком коде мы задали для картинки размер 300x100px и обтекание текстом справа:
Видео Для начала нужно загрузить видео в видеозаписи сообщества. После загрузки открыть видео и скопировать из адресной строки его id (выделено жирным).
Обрамляем это квадратными скобками и получаем такой код:
Получаем небольшую картинку со значком ▶play, при нажатии на который разворачивается полноценный видеоплеер. Чтобы видео воспроизводилось на самой странице, разработчики ВК предлагают воспользоваться тегом
Но здесь мы получаем непропорциональную черную рамку вокруг видео: Чтобы ее убрать, нужно подогнать размер плеера под размер самого видео. Например, в нашем случае подошли такие параметры:
Мы получили видео без черных рамок, оно будет воспроизводиться прямо на странице Таблицы Если вы хотите красиво структурировать содержимое вики-страницы и обеспечить ей аккуратное отображение на мобильных устройствах, без таблицы не обойтись. Здесь вам понадобятся такие простые знаки: При работе с таблицами можно использовать 4 тега: Вот пример таблицы 2×2 без отступов сверху и снизу текста внутри ячеек: Ширина первого столбца — 200px, ширина второго — 300px. Вот что из этого получилось: В ячейки таблицы можно поместить текст, картинки, аудио- и видеозаписи. Как сделать вики-меню Меню группы ВК — это не какой-то отдельный функционал, а попросту вики-страница с несколькими картинками, в каждую из которых зашита ссылка на определенную страницу. На самом деле здесь все просто.
При подготовке картинки для меню помните, что ширина вики-страницы — 607 px, Ширина картинки не должна быть больше, иначе изображение ужмется и потеряет в качестве. Для примера мы взяли изображение размером 510х300 px.
При активном инструменте «Раскройка» кликаем правой кнопкой мыши по картинке и выбираем «Разделить фрагмент», указываем нужное количество фрагментов и нажимаем «ОК». Как разрезать картинку в Photoshop Чтобы сохранить все отдельные фрагменты, нажимаем «Файл» → «Экспортировать» → «Сохранить для Web». Полученные части картинки загружаем в отдельный альбом сообщества. Наше меню будет оформлено в виде таблицы из 6 ячеек: в три строки и два столбца. Для этого мы нарезали картинку для меню на 6 равных частей размером 255×100 px. Такой же размер нужно будет проставить для каждой ячейки.
Указываем фиксированную ширину ячеек —
Готовое меню группы в десктопной версии Готовое меню группы в мобильной версии Как закрепить меню сообщества Если вы делали меню для группы, то оно будет легко доступно по клику на «Свежие новости» (кстати, эту страничку можно переименовать на «Меню» в режиме редактирования). Если вы делали меню для паблика, то его можно поместить на видное место под названием сообщества при помощи закрепленной записи. Чтобы закрепить меню в группе, опубликуйте запись с баннером и ссылкой на вики-страницу от имени сообщества (если опубликовать от своего имени, закрепить страницу будет невозможно). В паблике проблем с закреплением не будет: там можно закрепить запись любого автора. Как сделать пост со ссылкой на меню в паблике Как закрепить меню сообщества Новый редактор статей ВКонтакте и вики-разметка Администрация ВКонтакте объявила о запуске редактора статей 22 декабря 2017 года и позиционирует его как инструмент для публикации лонгридов. Некоторые пользователи решили, что он создан взамен вики-разметки. Но пока такие выводы делать рано, ведь функционал редактора еще достаточно скудный. В нем нельзя редактировать медиафайлы (размер и выравнивание) и делать таблицы, а гиперссылки можно присвоить только тексту. Здесь нет тегов и кода, есть только визуальный режим, как в обычном текстовом редакторе. Из этого видно, что сделать удобное меню для сообщества или вики-лендинг по-прежнему можно только с помощью вики-разметки. Что будет дальше — время покажет. Так выглядит интерфейс нового редактора статей ВКонтакте Что запомнить о вики-разметке
Запоминать все теги необязательно, достаточно держать под рукой ссылку на шпаргалку в официальном сообществе вики-разметки ВКонтакте. Confluence Wiki Разметка | Центр обработки данных и сервер Confluence 8.2Да. Вы можете вводить вики-разметку прямо в редакторе, и Confluence будет преобразовывать ее по мере ввода. (Вы не можете редактировать вики-разметку после преобразования. ) Могу ли я вставить разметку?Confluence поддерживает вставку контента в уценке. Это часто используется в файлах ReadMe. Некоторые примеры синтаксиса уценки см. в руководстве по синтаксису Markdown. Чтобы вставить уценку в редакторе:
Как и в случае вики-разметки, Confluence преобразует вашу разметку в формат расширенного текстового редактора. Вы не сможете редактировать свой контент, используя уценку. ЗаголовкиЧтобы отформатировать строку как заголовок, введите «hn». в начале вашей строки, где n может быть числом от 1 до 6.
СпискиВики-разметка позволяет создавать маркированные или нумерованные списки и достаточно гибка, чтобы допускать комбинацию двух типов списков. Если вам нужно разделить текст в списках с помощью разрывов строк, обязательно используйте двойную косую черту (//). Пустые строки могут нарушить список. Простые спискиИспользуйте дефис (-) для создания простых списков с квадратными маркерами. Убедитесь, что между дефисом и вашим текстом есть пробел.
Списки с марками Используйте Asterisk (*) для создания пули. Для каждого последующего уровня добавляйте дополнительную звездочку.
Нумерованные списки Используйте решетку (#) для создания нумерованных списков.
Второй уровень хэшей создаст подсписок, такой как алфавитный подсписок показан ниже.
Вы можете использовать третий уровень хэшей для создания под-под-списка.
Примечание: В пронумерованных списках, как описано выше, формат «числа», отображаемого на каждом уровне списка, может отличаться в зависимости от вашего браузера и таблиц стилей, установленных в вашем экземпляре Confluence. Таким образом, в некоторых случаях вы можете увидеть буквы (A, B, C и т. д.; или a, b, c и т. д.) или римские цифры (i, ii, iii и т. д.) на разных уровнях списка. Смешанные списки
ТаблицыВы можете создать два типа таблиц. Тип таблицы 1Позволяет создать простую таблицу с дополнительной строкой заголовка. После того, как вы добавили этот тип таблицы, вы можете установить ширину столбцов, используя элементы управления таблицей на панели инструментов. Используйте двойные полосы для строки заголовка таблицы. Что нужно ввести:
Что вы получите:
Вы также можете использовать вертикальный заголовок. Что нужно ввести: ||заголовок 1|столбец A1|столбец A2|столбец A3| ||заголовок 2|столбец B1|столбец B2|столбец B3| Что вы получите:
Тип таблицы 2Этот метод использует макросы разделов и столбцов для создания таблицы и позволяет указать ширину столбцов в разметке. Что нужно ввести {section:border=true} {столбец: ширина = 30%} Текст для этого столбца находится здесь. Это меньший столбец шириной всего 30%. {столбец} {столбец: ширина = 70%} Текст для этого столбца находится здесь. Это больший столбец с шириной 70%. {столбец} {раздел} Что вы получите Здесь находится текст для этой колонки. Это меньший столбец шириной всего 30%. Здесь находится текст для этого столбца. Это больший столбец с шириной 70%. Для получения более подробной информации см. макрос столбца и макрос раздела. Расширенное форматированиеЦвет и другое форматирование Чтобы добавить цвет и другое форматирование к вашим таблицам, вы можете использовать макрос панели внутри столбцов. СпискиВот пример того, как вставлять списки в таблицу: Что нужно ввести ||Заголовок 1||Заголовок 2|| |* Пункт 1 * Пункт 2 * Пункт 3|# Пункт 1 # Пункт 2 # Пункт 3| Что вы получите? |
|
|
Текстовые эффекты
Для форматирования текста используйте разметку, показанную в примерах ниже.
Что нужно ввести | Что вы получите |
---|---|
сильный | |
*жирный текст* | полужирный текст |
_выделение_ | выделение |
_ italics_ | курсив Вещь{_}x_ дает следующее: Вещь x |
??цитирование?? | ссылка 9} дает вам это: кг/м 3 |
Текст с~подстрочным индексом~ | Текст с подстрочным индексом |
{{моноширинные}} | |
|
|
| смотрите, мама, красный текст! |
Разрывы текста
Разрыв абзаца
В вики-разметке абзац представляет собой непрерывную строку текста, заканчивающуюся двумя символами возврата каретки. Это эквивалентно непрерывной строке текста, за которой следует пустая строка.
При преобразовании в HTML результатом является строка текста, заключенная в набор
теги.
Разрыв строки
Confluence предоставляет два варианта принудительного разрыва строки внутри абзаца текста:
- Неявно, путем ввода одиночного возврата каретки в конце.
- В явном виде, путем ввода двух последовательных обратных косых черт: \\
При отображении в формате HTML получается абзац текста, разделенный на отдельные строки тегами
везде, где появляется принудительный разрыв строки.
В большинстве случаев явные разрывы строк не требуются, так как достаточно одного возврата каретки.
В приведенных ниже примерах показано, как использовать явные разрывы строк.
Что вам нужно ввести | Что вы получите |
---|---|
вот текст \\ разделить \\ с помощью линии \\\ разрывы \\ | вот какой-то текст разрывы |
Это краткий список: \\ \\ Текст к пункту 2 с разрывом | Это краткий список: |
9 0002 Если вы хотите использовать несколько последовательные разрывы строк, каждый из которых должен быть разделен пробелом. Например, используйте это для двух последовательных разрывов строк:
\\
\\
Горизонтальное правило
Чтобы создать горизонтальную линию по ширине страницы или блока контента, введите четыре дефиса (например, —-) в начале строки, затем нажмите клавишу ВВОД или пробел.
Убедитесь, что тире находятся на отдельной строке от остального текста.
Что вам нужно ввести | Что вы получите |
---|---|
вот текст разделить по горизонтальной линейке | вот какой-то текст разделить на горизонтальная линейка |
Вы можете использовать вики-разметку для добавления гиперссылок в текст.
Ссылка на файл, прикрепленный к странице в другом месте. | |
[/2004/01/12/blogposttitle] | Ссылка на сообщение в блоге. |
[spacekey:/2004/01/12/blogposttitle] | Ссылка на сообщение в блоге в другом пространстве. |
[/2004/01/12] | Ссылка на сообщения блога за весь день. |
[spacekey:/2004/01/12] | Ссылка на сообщения блога за весь день в другом месте. |
[пробел:] | Ссылка на домашнюю страницу пространства (или страницу со сводкой пространства. |
[~имя пользователя ] | Ссылка на профиль пользователя страница конкретного пользователя |
[phrase@shortcut] | Ссылка на указанный ярлык. Ярлыки настраиваются администратором сайта. |
[http://confluence.atlassian.com] | Ссылка на внешний ресурс. |
[mailto:[email protected]] | Ссылка на адрес электронной почты. |
[файл://z:/file/on/network/share.txt] | Ссылка на файл на вашем компьютере или в сетевой папке, которую вы сопоставили с диском. Работает только в Internet Explorer . |
[!http://external/image.png!|http://external/link.html] | Отображает внешнее изображение и ссылки на внешний URL. |
Обратите внимание, что Confluence рассматривает заголовки как якоря, поэтому вы можете ссылаться на заголовки, используя этот шаблон: [spacekey:pagename#headingname], где заголовок чувствителен к регистру и должен быть введен без пробелов.
Для каждой из этих форм ссылок:
- Вы можете добавить псевдоним ссылки, чтобы альтернативный текст отображался на странице. Пример: [псевдоним ссылки|название страницы#якорь]
- Вы можете добавить подсказку ссылки, которая появится в виде всплывающей подсказки. Пример: [pagetitle#anchor|подсказка для ссылки]
Изображения
Вы можете отображать изображения из прикрепленных файлов или удаленных источников.
Что нужно ввести | Что вы получите 9изображение. gif! | Отображается файл изображения, прикрепленный к сообщению в блоге. |
---|---|---|
!image.jpg|миниатюра! | Изображение отображается в виде эскиза на странице (работает только с изображениями, прикрепленными к странице). Пользователи могут нажать на миниатюру, чтобы увидеть полноразмерное изображение. Чтобы это работало, миниатюры должны быть включены администратором сайта. | |
!image.gif|align=right, vspace=4! | Для любого изображения можно указать атрибуты HTML-тега изображения в виде списка пар имя=значение, разделенных запятыми. |
Доступные теги изображений HTML включают:
Тег изображения | Детали |
---|---|
выравнивание | Доступные значения: «влево», «вправо», «вниз» , «центр», «верх». |
граница | Задает ширину границы (в пикселях). |
bordercolor | Используйте с тегом border. Укажите цвета по имени или шестнадцатеричному значению. |
hspace | Указывает количество пробелов, которые должны быть вставлены слева и справа от изображения (в пикселях). |
vspace | Задает количество пробелов, которые должны быть вставлены над и под изображением (в пикселях). |
ширина | Задает ширину изображения (в пикселях). Это переопределит естественную ширину изображения. |
высота | Задает высоту изображения (в пикселях). Это переопределит естественную высоту изображения. |
title | Указывает альтернативный текст для изображения, который отображается при наведении указателя на изображение. |
alt | Указывает альтернативный текст для изображения. Этот текст можно найти с помощью поиска, и он способствует доступности страницы для просмотра только текста. |
Макеты страниц
Нет представления вики-разметки для макетов страниц.
Макросы
Формат хранения и примеры вики-разметки включены в документацию для каждого макроса.
Синтаксис вики-разметки Confluence | Облако слияния
На этой странице описывается вики-разметка, используемая на некоторых экранах администрирования в Confluence Cloud.
Вики-разметка полезна, если вы хотите выполнить одно из следующих действий:
Создать ссылки, используя вкладку Дополнительно браузера ссылок.
Добавьте пользовательский контент в верхний или нижний колонтитул пространства.
Вставьте блок вики-разметки (или уценки) в редактор Legacy. (Выберите Вставьте > Разметка .) Примечание: новый редактор не поддерживает разметку. Узнайте больше о новой дорожной карте редактора.
Могу ли я вставить уценку?
Confluence Cloud поддерживает вставку контента в уценке. Это часто используется в файлах ReadMe. Некоторые примеры см. в разделе Сочетания клавиш и автозаполнение.
Чтобы вставить уценку в редакторе Legacy :
Выберите Вставить > Разметка .
Выберите Уценка .
Введите или вставьте свой текст — предварительный просмотр покажет вам, как он будет выглядеть на вашей странице.
Выберите Вставьте .
Как и в случае вики-разметки, Confluence Cloud преобразует вашу разметку в формат расширенного текстового редактора. Вы не сможете редактировать свой контент, используя уценку.
Заголовки
Существует шесть размеров заголовков, от h2 до h6. Чтобы отформатировать текст как заголовок, поставьте перед текстом название нужного заголовка, за которым следует точка:
Вход | Выход |
---|---|
ч 2. заголовок h2 | |
h3. Заголовок h3 | Заголовок h3 |
h4. Заголовок h4 | Заголовок h4 |
h5. Заголовок h5 | Заголовок h5 |
h5. H5 заголовок | H5 заголовок |
h6. Заголовок H6 | Заголовок H6 |
Списки
Вики-разметка позволяет создавать маркированные или нумерованные списки и достаточно гибка, чтобы допускать комбинацию двух типов списков.
Чтобы вставить разрыв строки в список, введите //. Пустые строки могут нарушить список.
Маркированные списки
Чтобы создать маркированный список, введите звездочку и пробел перед каждым элементом списка. Добавьте больше звездочек, чтобы создать подпункты. Каждая дополнительная звездочка добавляет еще один уровень.
Вход | Выход |
---|---|
|
|
Чтобы получить квадратные маркеры вместо круглых, используйте дефисы — вместо звездочек *.
Нумерованные списки
Чтобы создать нумерованный список, введите решетку # с пробелом перед каждым элементом в списке. Как и в случае с маркированными списками, количество хэшей определяет уровень элемента.
Вход | Выход |
---|---|
|
пронумерованная позиция |
Подпункты в нумерованных списках могут быть указаны заглавными буквами (A, B, C), строчными буквами (a, b, c), арабскими цифрами (1, 2, 3) или римскими цифрами (i, ii). , iii) в зависимости от вашего браузера и таблиц стилей, установленных на вашем сайте Confluence Cloud.
Смешанные списки
Вы можете комбинировать эти методы для создания смешанных нумерованных и маркированных списков, как показано ниже.
Вход | Выход |
---|---|
|
90 056 |
Таблицы
Вы можете создавать простые таблицы, используя вики-разметку Confluence, со столбцами разделены трубой | и строки, разделенные разрывами строк. Чтобы придать ячейке серый фон, добавьте вторую вертикальную черту.
Например, следующий ввод:
1
2
3
||заголовок 1||заголовок 2||заголовок 3||
|ячейка A1|ячейка A2|ячейка A3|
|ячейка B1|ячейка B2|ячейка B3|
Произведет этот вывод:
заголовок 1 | заголовок 2 9 0046 | заголовок 3 |
---|---|---|
ячейка A1 | ячейка A2 | ячейка A3 |
ячейка B1 | ячейка B2 | ячейка B3 |
Вы также можете создавать таблицы, используя макросы столбцов и разделов. Этот метод дает вам больший контроль над размером ячеек таблицы, но не создает выделенные ячейки. Для получения дополнительной информации см. Тип таблицы 2 в этом справочном документе.
Встроенные списки
Вы можете использовать вики-разметку Confluence для встраивания списков в таблицы, как показано в следующем примере:
1
2
3
4
5
6
||Заголовок 1||Заголовок 2||
|* Пункт 1
* Пункт 2
* Пункт 3|# Пункт 1
# Пункт 2
# Пункт 3|
Приведенный выше код создаст следующую таблицу:
Заголовок 1 | Заголовок 2 90 003 |
---|---|
|
|
Расширенное форматирование таблицы
Вы можете добавить цвет и другие параметры форматирования в свою таблицу с помощью макроса панели и некоторых сторонних приложений (если ваш администратор Confluence Cloud установил их на вашем сайте).
Текстовые эффекты
Ввод | Вывод | *жирный* | жирный |
---|---|
_italics_ | 90 577 курсив |
-зачеркнутый- | зачеркнутый |
+подчеркивание+ | текст верхний индекс |
текст~подстрочный~ | текст нижний индекс 90 003 |
{{моноширинный текст}} | моноширинный текст |
бк. blockquote |
|
Вы также можете установить цвет текста. Например, если вы наберете {color:red}ваш текст{color}, фраза «ваш текст» будет выделена красным цветом.
Разрывы
Вы можете добавлять разрывы абзацев, разрывы строк и горизонтальные линейки в вики-разметке Confluence.
Разрывы абзаца
В вики-разметке Confluence абзацы создаются из любой непрерывной строки текста. Чтобы создать разрыв абзаца, вставьте два символа возврата каретки после текста абзаца. Это эквивалент переноса текста в набор тегов
в HTML.
Разрыв строки
Существует два способа создания разрыва строки в тексте абзаца:
Неявно, путем ввода одного символа возврата каретки
Явно, путем ввода двух последовательных символов обратной косой черты \\
Эти методы эквивалентны разделению текста тегом
в HTML.
В большинстве случаев явные разрывы строк не требуются и достаточно одного возврата каретки. Однако они необходимы, когда вам нужно разбить текст в одном элементе списка, как в примере ниже:
Вход | Выход |
---|---|
|
|
Чтобы использовать более одного явного разрыва строки подряд, разделяйте их пробелом, например , \\ \\ для двух разрывов строк.
Горизонтальная линейка
Чтобы создать горизонтальную линию по ширине страницы или блока контента, введите четыре дефиса подряд —- в начале строки, затем нажмите клавишу ввода или пробел.
Убедитесь, что тире находятся на отдельной строке от остального текста.
Вход | Выход |
---|---|
| вот текст разделенный горизонтальной линейкой |
Вики-разметка Confluence позволяет добавлять гиперссылки к тексту на определенных экранах администрирования. В таблице ниже показан синтаксис добавления ссылок.
Метод | Результат | |
---|---|---|
9196 8 [#anchor] | Ссылка на якорную ссылку на текущей странице, где якорь — это имя якоря. 9attachment.ext] | Ссылка на файл, прикрепленный к странице в другом месте. |
[/2004/01/12/blogposttitle] | Ссылка на сообщение блога в текущем пространстве, где blogposttitle — это название блога, которое отображается на странице. | |
[пробел:/2004/01/12/blogposttitle] | Ссылка на сообщение в блоге в другом месте. | |
[пробел:] | Ссылка на обзор другого пространства. | |
[~username] | Ссылка на профиль конкретного пользователя. | |
[https://www.atlassian.com] | Ссылка на внешний веб-сайт. | |
[mailto:[email protected]] | Ссылка для отправки электронного письма на определенный адрес (замените [email protected] на соответствующий адрес электронной почты). | |
[file://z:/file/on/network/share. txt] | Ссылка на файл на вашем компьютере или в сетевой папке, которую вы сопоставили с диском. Работает только с Internet Explorer. | |
[! https://external/image.png!|https://external/link.html ] | Отображает внешнее изображение и ссылки на внешний веб-сайт. |
Confluence Cloud рассматривает заголовки как якоря, поэтому вы можете ссылаться на заголовки по следующему шаблону: [spacekey:pagename#headingname]
Название заголовка чувствительно к регистру и должно вводиться без пробелов.
Для каждой ссылки в таблице выше:
Вы можете добавить псевдоним ссылки, чтобы альтернативный текст отображался на странице. Например: [псевдоним ссылки|название страницы#якорь]
Вы можете добавить подсказку ссылки, которая появится в виде всплывающей подсказки. Например: [pagetitle#anchor|подсказка по ссылке]
Изображения
Вы можете отображать изображения из прикрепленных файлов или удаленных источников. 9изображение.gif!
Отображает файл изображения, прикрепленный к сообщению блога.
!image.jpg|миниатюра!
Отображает изображение, прикрепленное к текущей странице, в виде эскиза. Зрители могут нажать на миниатюру, чтобы увидеть полноразмерное изображение. Эта функция работает только с файлами изображений, прикрепленными к текущей странице, а миниатюры должны быть включены администратором сайта.
Для любого изображения можно указать атрибуты HTML-тега изображения в вики-разметке Confluence в списке, разделенном запятыми, добавленном к URL-адресу. В приведенном ниже примере изображение будет выровнено по правому краю страницы с пробелами в 4 пикселя сверху и снизу:
!image.gif|align=right, vspace=4!
Доступны следующие атрибуты тега изображения HTML:
Атрибут | Результат 9004 6 |
---|---|
align | Выравнивает изображение на странице. Возможные значения:
|
граница | Установите ширину границы (в пикселях). |
bordercolor | Установите цвет границы (имя или шестнадцатеричное значение). Используется с атрибутом границы. |
hspace | Установите количество пустого пространства по горизонтали вокруг изображения (в пикселях). |
vspace | Установите количество пробелов по вертикали вокруг изображения (в пикселях). |
ширина | Установка ширины изображения (в пикселях). Это переопределит естественную ширину изображения. |