Как упомянуть человека и приложить файл

Как сослаться на профиль коллеги из текста через @хэндл, приложить к работе набор данных или слайды и сослаться на файл из нужного предложения.

Два вида ссылок ведут из вашего текста не в веб, а к объектам на LibreTimes: упоминание ссылается на профиль человека, а ссылка на вложение открывает файл, принадлежащий вашей работе. Это руководство пишет обе.

Упомянуть человека

  1. Найдите хэндл человека: это часть после @ в адресе его профиля, например @emmy_noether.
  2. Наберите @ и хэндл там, где в предложении стоит имя:
Конструкция следует идее @emmy_noether, а доказательство упростил
@emil_artin.

Когда работа сохраняется, каждый хэндл, принадлежащий профилю, становится ссылкой на него. Хэндл, который никому не принадлежит, остаётся простым текстом, так что опечатка видна как @имя без ссылки, а не как ссылка на незнакомца. Если человек позже сменит хэндл, упоминание последует за ним, потому что оно привязано к человеку, а не к написанию.

Что считается упоминанием, решают несколько правил:

  • Хэндл — от 3 до 30 латинских букв и цифр с одиночными подчёркиваниями между ними. Регистр не важен: @Emmy_Noether — это @emmy_noether.
  • @ внутри адреса, например emmy@example.org, упоминанием никогда не считается.
  • Подчёркивание на конце относится к предложению: @emmy_ упоминает @emmy.
  • Чтобы написать хэндл без ссылки, оберните его в строчный код: `@emmy`.

Упоминания указывают читателю на человека: соавтора, того, кого вы благодарите, автора идеи. Кто написал работу, определяет её список авторов, который задаётся в сведениях о работе, а не упоминаниями в тексте.

Приложить файл к работе

Данные, слайды, код или иллюстрация в высоком разрешении могут идти вместе с работой как вложения, перечисленные под её текстом.

  1. Закройте редактор и откройте вкладку Вложения в форме работы.
  2. Выберите файлы или перетащите их. Каждый — до 100 МБ.
  3. Дайте каждому файлу описание: что это и стоит ли его скачивать.

Вложения следуют видимости работы: читатель, который видит работу, может открыть её файлы, а больше никто. О форматах, которые откроются и через десять лет, смотрите Вложения.

Сослаться на файл из текста

Файл в списке под работой легко пропустить. Если предложение опирается на него, сошлитесь на файл прямо оттуда.

  1. В редакторе выберите Визуально и поставьте курсор туда, где будет ссылка.
  2. На панели инструментов откройте More blocks (кнопка …) и выберите Attachment.
  3. Выберите один из файлов работы или Upload a file, чтобы добавить новый.
  4. В поле Label напишите слова, по которым читатель будет щёлкать, и выберите Insert.

Ссылка появится в предложении маленьким чипом со значком файла. В режиме Код она выглядит так:

Исходные измерения — в :attach[наборе данных]{#0198a3f2-7c41-7000-8000-1f2e3d4c5b6a}.

Слова в скобках — метка; часть в фигурных скобках — идентификатор файла, который подставляет редактор. Набирать идентификатор самому не нужно, а скопированный из другой работы здесь не сработает: файл должен быть приложен к этой работе.

Результат

В предпросмотре каждое упоминание существующего человека — ссылка на его профиль. После сохранения каждый чип вложения открывает свой файл в новой вкладке: браузер показывает то, что умеет, например изображение или PDF, а остальное скачивает. Страница работы перечисляет под текстом все приложенные файлы с описаниями.

Комментарии принимают упоминания, но не ссылки на вложения, потому что у комментария нет своих файлов. Для изображения, которое должно стоять в тексте, а не открываться, используйте изображение или рисунок.