[Руководство редактора] Разметка markdown. Ссылки на языки, диалекты, реализации, версии.

[Sergey Dimchenko]

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

В качестве языка разметки для статей в Прогопедии используется
markdown: http://daringfireball.net/projects/markdown/

Для вставки ссылки на язык (диалект, реализацию, версию) в тексте
статьи, непосредственно перед названием языка указывается слово
language в квадратных скобках (или dialect, implementation, version
соответственно). Если название состоит из нескольких слов или входит в
составное слово, его нужно заключать в кавычки.

Например: [language]Java, [language]"C"-подобный синтаксис,
[version]"Objective Caml 2.00".

Такая форма записи имеет несколько преимуществ перед указанием прямой
ссылки на URL:
- при смене slug (части URL) ссылка автоматически обновится и
продолжит нормально работать
- можно ссылаться на языки и т.д., еще не описанные в Прогопедии;
после их добавления, автоматически появится активная ссылка
- быстрее и проще набирать.

[Crosspath]

Таки решили оставить схему язык-диалект-реализация-версия вместо новой
язык-реализация-версия?

[Sergey Dimchenko]

Диалекты сейчас есть, но они вне иерархии и необязательны.

[Sergey Dimchenko]

Дополнение про Markdown.

В целях обеспечения безопасности все HTML-теги в текстах статей
экранируются.
Для разметки следует использовать только синтаксис Markdown.
Единственное исключение в данный момент сделано для тега верхнего
индекса <sup> (без атрибутов), т.к. периодически возникает потребность
его использовать, а соответствующего эквивалента в Markdown нет.

[Sergey Dimchenko]

Также теперь можно использовать тег <sub> (без атрибутов) для нижних
индексов.

[Max Avanov]

А каким образом правится описание редакторов/IDE? Например, в описании Python есть такой.

[Sergey Dymchenko]

Описания редакторов/IDE скоро будут вообще убраны, т.к. смысла в них
нет - для большинства редакторов есть дополнительные модули поддержки
языков и т.д.
В английской версии http://progopedia.com редакторов/IDE нет.
В общем, добавлять/править их не надо.