Обсуждение:AsciiDoc

Правки Bezik[править код]

Следующий текст желательно оставить:

Простые языки разметки, такие как AsciiDoc, позволяют быстро набирать на клавиатуре (в текстовом редакторе или даже в консоли) большие объёмы текста с простым форматированием. Эти текстовые файлы, размеченные условными символами форматирования, конвертируют в широко используемые форматы для публикации документов (такие как PDF, EPUB, HTML и т.п.).и передают конечным пользователям документации. (объясняет как и почему используется AsciiDoc)

Раздел с инструментами (обеспечивает практическую ценность статьи и удобство для пользователя)

Инструменты

Antora — генератор сайтов документации с несколькими репозиториями для технических писателей, использующий git.
AsciiBinder — (устаревшая) система документации, построенная на Asciidoctor, для людей, у которых есть много документов, которые нужно поддерживать и регулярно переиздавать.
awestruct — генератор статических сайтов, вдохновленный Jekyll.
Asciidoc FX — редактор книг AsciiDoc на основе JavaFX 8.
AsciiDocLIVE — AsciiDocLIVE — бесплатный онлайн-редактор AsciiDoc.
Asciidoctor^[1] — текстовый процессор с открытым исходным кодом и конвертер AsciiDoc в форматы HTML 5, DocBook 5, Man страницы, PDF, EPUB 3 и др

Если в какой-либо литературе документированию, опубликованной в независимых авторитетных источниках (журнальных статьях, книгах несамиздатных издательств), будет приведёт подобный перечень инструментов, то его со ссылкой на этот источник можно будет привести (разумеется, без шитых внешних ссылок). Статьи пишутся на основании опубликованного в независимых источниках, а не по нашим ощущениям от потенциальной полезности материала. В любом случае, простой перечень каких-то шитых внешних ссылок выглядит как раскрутка сайтов, такое недопустимо, bezik ° 10:24, 9 апреля 2023 (UTC)[ответить]