Ссылки, изображения и выноски

Ссылки#

Выделите текст и нажмите ⌘K (Вставить ▸ Ссылка…). Начните вводить название страницы или заголовка — или вставьте веб-адрес — и нажмите Return.

• Без выделения ⌘K вставляет ссылку, текстом которой станет название страницы или заголовка.
• Наберите [[ прямо в тексте — откроется тот же поиск.
• Ссылки записываются путями относительно страницы, с #якорем для заголовка, например [Откат](../engineering/release-checklist.md#on-release-day). Якоря следуют правилам GitHub, поэтому ссылки работают и на GitHub.
• ⌘K с курсором в ссылке показывает ее карточку: Открыть, Изменить адрес…, Изменить текст и Удалить ссылку.

Клик по ссылке ставит курсор — так можно править ее текст. ⌘-клик переходит по ней. Задержите указатель на ссылке на полсекунды — появится ее карточка: куда она ведет и кнопки Открыть, Изменить ссылку, Скопировать (адрес как он записан) и Убрать ссылку. Ссылки на сайты отмечены ↗ и открываются в браузере. На странице «Только чтение» и в режиме «Просмотр» клик переходит по ссылке, ⌘-клик открывает ее в новой вкладке, ⌥-клик — в новом окне.

Веб-адрес, вставленный поверх выделенного текста, превращает текст в ссылку; вставленный отдельно, он становится ссылкой с адресом в качестве текста.

Ссылка на страницу, которой больше нет, подчеркнута красным пунктиром, а в ее карточке есть Выбрать новый адрес…. Когда вы переименовываете или перемещаете страницу в Kirbon, ссылки на нее обновляются сами.

Изображения и файлы#

Перетащите изображения или файлы из Finder на страницу, вставьте их из буфера обмена или выберите Вставить ▸ Изображение… или Вставить ▸ Файл…. Kirbon копирует каждый файл в assets/<страница>/ рядом со страницами — оригиналы никогда не перемещаются — и показывает ход копирования. Изображения появляются как изображения, остальные файлы — как плашки с типом и размером.

Кликните изображение, чтобы выделить его. На его панели:

• Размер — «По ширине», 75 %, 50 % или «Исходный»; можно и потянуть за угол — шаг 5 %;
• Замещающий текст… — его читает VoiceOver, и он виден, если изображение не загрузилось;
• Подпись — строка текста под изображением;
• Заменить…, Открыть оригинал и «⋯»: убрать со страницы, показать в Finder, скопировать изображение.

Space на выделенном изображении или файле показывает его в Quick Look, двойной клик по файлу открывает его в своей программе. ⌫ убирает его со страницы, ⌘C копирует его Markdown.

Если убрать изображение со страницы, его файл останется в assets/ — отмена вернет все обратно. Пропавшее изображение показывает свое имя и кнопку Найти….

Если среди вложений страницы уже есть файл с таким именем, Kirbon спросит: Оставить обе, Использовать существующий или Заменить….

Выноски#

Выноски — цветные блоки для примечаний и предупреждений. Kirbon сохраняет их как GitHub alerts, поэтому на GitHub они выглядят так же.

Вставьте выноску из меню «/» или через Вставить ▸ Выноска. Кнопка типа в углу выноски меняет ее тип, а еще умеет убрать оформление выноски, оставив текст, или удалить выноску вместе с текстом.