Упоминания и вложения

Две строчные формы связывают объекты платформы из текста: @handle ссылается на человека, :attach[...] – на файл, загруженный к публикации.

Упоминания

Пишется @ и хэндл:

Конструкция следует идее @emmynoether.

Упоминание рендерится ссылкой на профиль. Правила:

  • Ссылками становятся только хэндлы, которые на момент публикации разрешаются в реальный профиль; остальное остаётся простым текстом. Переименование не ломает ссылку: если человек позже сменит хэндл, существующие упоминания последуют за ним.
  • Хэндл – 3-30 символов: строчные латинские буквы, цифры и одиночные подчёркивания между сегментами (ada_lovelace). Регистр не важен: @Ada_Lovelace упоминает ada_lovelace.
  • @ внутри адреса почты (ada@example.org) упоминанием не считается.
  • Чтобы показать буквальный @handle без ссылки, оберните его в `строчный код`.

Упоминания указывают читателю на человека: соавторы, благодарности. Авторство и формальная атрибуция задаются полями авторов публикации, а не упоминаниями в тексте.

Ссылки на вложения

Файлы, загруженные к публикации (данные, слайды, PDF), можно ссылать в тексте чипом:

Полный вывод -- в :attach[приложении]{#0198a3f2-7c41-7000-8000-1f2e3d4c5b6a}.
  • [метка] – видимый текст ссылки; {#...} – идентификатор вложения.
  • Чип открывается в новой вкладке: браузер показывает то, что умеет (изображения, PDF), и скачивает остальное. Доступ следует видимости публикации: кто видит страницу, тот может открыть её вложения.
  • Идентификатор должен принадлежать вложению этой публикации. На практике этот синтаксис не набирают руками: редактор вставляет чип при загрузке или выборе файла и сам ведёт идентификатор.

Для изображений, которые должны показываться на странице, а не быть ссылкой, есть синтаксис изображений и иллюстрации.