Jump to content

Викитекст

From mediawiki.org
This page is a translated version of the page Wikitext and the translation is 100% complete.

Викитекст, также известный как вики-разметка — это язык разметки, который состоит из синтаксиса и ключевых слов и используется интерфейсом MediaWiki для форматирования страниц. Он описан шире в Справка:Редактирование и Справка:Форматирование . Викитекст представляет собой смесь содержимого, разметки, макросов и метаданных. Содержимое текущих и предыдущих версий вики-страницы хранится в базе данных в таблице text , как правило, в форме вики-текста, хотя некоторые типы страниц, такие как объекты Wikidata , хранятся в других форматах содержимого.

Пользовательская документация

Документация для разработчиков

  • Specs/wikitext/1.0.0 – по состоянию на август 2016 года, URI, используемый Parsoid для идентификации версии Викитекста, которую он предполагает

Реализация

  • Парсер PHP — генерируемая документация из комментариев, встроенных в исходный код. Резюме того, что такое PHP-парсер, такое, как описано на этой странице: "Обрабатывает вики-разметку (которая использует более дружелюбный к пользователю синтакс, например "[[Ссылка]]" для создания ссылок) и предоставляет одностороннюю трансформацию эттой вики-разметки в вывод/разметку (X)HTML (которую, в свою очередь, понимает и может отображать браузер)."
  • Parsoid — инструмент перевода для MediaWiki, который переводит между HTML5 DOM с RDFa и викитекстом MediaWiki.

Тестирование

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

  • Parser tests - Наши тесты в ядре MediaWiki содержат авторитетный источник для тестирования совместимости разметки Викитекста.
  • Варианты теста Parsoid (parserTests.txt на Diffusion) – выделенная версия основных тестов MediaWiki, используемая Parsoid. Помимо режима wt2html, который поддерживает PHP-парсер, исполнитель тестов парсера Parsoid также позволяет несколько других режимов тестирования, не поддерживаемых PHP-парасером (wt2wt, html2wt, HTML2html, рандомизированные редактирования для тестирования селективной сериализации, ручные редактирования контролируемого тестирования сериализации). Эти тесты синхронизируются вручную с помощью скриптов в базе кодов Parsoid.

Обсуждения с 2015 года и позже

  • Architecture focus 2015 – дискуссия 2015 года на Лионском Хакатоне о будущем MediaWiki, включающая представление и трансклюзию контента.
  • Requests for comment/A Spec For Wikitext – RFC определивший структуру для написания спецификации викитекста, если мы решим её написать (обсуждалось в Phab:E259 в августе 2016 года)
  • Handling wiki content beyond plaintext – дискуссии, запланированные на WikiDev17

Обсуждения до 2015 года

См. также