Учебник VuePress

# Ссылки

# Внутренние ссылки

Внутренние ссылки преобразуются в <router-link> для навигации SPA (Single Page Application - одностраничного приложения). Кроме того, каждый README.md или index.md, содержащийся в каждом подкаталоге, будет автоматически преобразован в index.html с соответствующим URL /.

Учитывая следующую структуру каталогов:

.
├─ README.md
├─ foo
│  ├─ README.md
│  ├─ one.md
│  └─ two.md
└─ bar
   ├─ README.md
   ├─ three.md
   └─ four.md
1
2
3
4
5
6
7
8
9
10

И если вы находитесь в foo/one.md:

[Home](/)       <!-- Отправляет в корень README.md  -->
[foo](/foo/)    <!-- отправляет в index.html каталога foo -->
[foo heading](./#heading)   <!-- Привязывает к заголовку в файле foo README.md -->
[bar - three](../bar/three.md)  <!-- добавить ссылку на *.md (рекомендуется) -->
[bar - four](../bar/four.html)  <!-- добавить ссылку на *.html -->
1
2
3
4
5

# Направление для URLs

VuePress поддерживает перенаправление на чистые ссылки. Если ссылка /foo не найдена, VuePress будет искать существующий /foo/ или /foo.html. И наоборот, когда один из /foo/ или /foo.html не найден, VuePress также попытается использовать другой. С помощью этой функции мы можем настроить URL вашего сайта с помощью официального плагина vuepress-plugin-clean-urls.

TIP

Независимо от того, используются ли постоянные и чистые плагины, ваш относительный путь должен определяться текущей файловой структурой. В приведенном выше примере, даже если вы указали путь к /foo/one.md в /foo/one/, вы все равно должны получить доступ к /foo/two.md через ./two.md.

# Внешние ссылки

Исходящие ссылки автоматически получают target="_blank" rel="noopener noreferrer":

Пример:

* [vuejs.org](https://vuejs.org/)
* [VuePress on GitHub](https://github.com/vuejs/vuepress)
1
2

Результат:

Вы можете настроить атрибуты, добавленные к внешним ссылкам, установив config.markdown.externalLinks.

← Форматирование текста →