Source Button

Source button связывает видимый markdown с исходным кодом. Во время render exporter оборачивает участки с известным SourceRef в DocFragmentSource.

Где появляется

У page кнопка src стоит рядом с заголовком и ведёт к её page.ts.

У вставленного JSDoc-фрагмента кнопка src стоит рядом с текстом, который пришёл из includeDoc().

Что делает

Кнопка src поддерживает два режима. Если задан VITE_EDITOR_ROOT, обычный клик открывает исходник в редакторе. В общем опубликованном сайте кнопка ведёт к исходнику в GitLab на ref, из которого собран соответствующий doc-space. Без этих настроек обычный клик копирует путь к файлу.

Ctrl+click всегда копирует docId: page id для page или fragment id для JSDoc-фрагмента.

Примеры .env:

VITE_EDITOR_ROOT=vscode://file/C:/Users/dev/workspace-meta
VITE_EDITOR_ROOT=cursor://file/C:/Users/dev/workspace-meta

Mentioned In

• Как doc_id попадает на сайт
• JSDoc Annotations