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

66 views
Skip to first unread message

Sergey Dimchenko

unread,
Sep 30, 2009, 2:54:31 PM9/30/09
to progopedia.ru
Начинаю публиковать кусочки, которые в будущем войдут в руководство
для редакторов Прогопедии. Комментарии и дополнения приветствуются.

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

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

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

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

Crosspath

unread,
Oct 24, 2009, 5:08:59 AM10/24/09
to progopedia.ru
Таки решили оставить схему язык-диалект-реализация-версия вместо новой
язык-реализация-версия?

Sergey Dimchenko

unread,
Oct 24, 2009, 2:10:58 PM10/24/09
to progopedia.ru
Диалекты сейчас есть, но они вне иерархии и необязательны.

Sergey Dimchenko

unread,
Oct 27, 2009, 10:51:37 PM10/27/09
to progopedia.ru
Дополнение про Markdown.

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

Sergey Dimchenko

unread,
Nov 1, 2009, 1:08:50 PM11/1/09
to progopedia.ru
Также теперь можно использовать тег <sub> (без атрибутов) для нижних
индексов.

Max Avanov

unread,
May 17, 2011, 3:12:56 PM5/17/11
to progop...@googlegroups.com
А каким образом правится описание редакторов/IDE? Например, в описании Python есть такой.

Sergey Dymchenko

unread,
May 17, 2011, 3:18:15 PM5/17/11
to progopedia.ru
Описания редакторов/IDE скоро будут вообще убраны, т.к. смысла в них
нет - для большинства редакторов есть дополнительные модули поддержки
языков и т.д.
В английской версии http://progopedia.com редакторов/IDE нет.
В общем, добавлять/править их не надо.
Reply all
Reply to author
Forward
0 new messages