diff --git a/CHANGELOG.md b/CHANGELOG.md index fcc9b9be..416d3095 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,22 @@ +# [1.4.0](https://github.com/vuejs/vitepress/compare/v1.3.4...v1.4.0) (2024-10-07) + +### Bug Fixes + +- `vueRE` conflicting with `lineNoRE` ([#4247](https://github.com/vuejs/vitepress/issues/4247)) ([2ac64b8](https://github.com/vuejs/vitepress/commit/2ac64b8d4180f2a7c54fda57df7f3a0a52488d62)) +- hmr not updating page data in rewritten paths and file path is wrong in mdit for dynamic routes ([c46e4b7](https://github.com/vuejs/vitepress/commit/c46e4b784ddb9ce3bd1cfcc3de1d1d676535cb5b)), closes [#4172](https://github.com/vuejs/vitepress/issues/4172) +- remove font synthesis in webfont mode, google fonts now support italic axis in inter ([1628918](https://github.com/vuejs/vitepress/commit/1628918f30b5602b83c51a2a8f4ec5e773cf7445)) +- **theme:** change the order of CSS rules of `VPFlyout` ([#4225](https://github.com/vuejs/vitepress/issues/4225)) ([68150a6](https://github.com/vuejs/vitepress/commit/68150a6f3349c1741ed5683e3010d9ecea02f3a8)), closes [#4224](https://github.com/vuejs/vitepress/issues/4224) +- **theme:** respect custom tag prop in VPButton component ([#4185](https://github.com/vuejs/vitepress/issues/4185)) ([9c5d348](https://github.com/vuejs/vitepress/commit/9c5d348c034eb6773562c93cad699d287051aa7b)) + +### Features + +- add `data-title` attribute for code group label tag ([#4152](https://github.com/vuejs/vitepress/issues/4152)) ([bc7271d](https://github.com/vuejs/vitepress/commit/bc7271d258047feb8a39c97ebc5e2a16bf899bb5)) +- allow ignoring certain headers and their subtrees completely in outline ([3e11b6a](https://github.com/vuejs/vitepress/commit/3e11b6abf5fbe80c2bc733f590ab57c7b2cc06f2)), closes [#4171](https://github.com/vuejs/vitepress/issues/4171) +- **client:** add `onAfterPageLoad` hook in router ([#4126](https://github.com/vuejs/vitepress/issues/4126)) ([315c220](https://github.com/vuejs/vitepress/commit/315c22004993f6f1cbdbb59178e46745d8e505a6)) +- support adding extra attributes to snippet imports (useful for twoslash) ([#4100](https://github.com/vuejs/vitepress/issues/4100)) ([e8f7dd1](https://github.com/vuejs/vitepress/commit/e8f7dd16f6139fdfd129b86caff4b6613dd1e887)) +- **theme:** expose theme default VPLink & VPSocialLink(s) component ([#4178](https://github.com/vuejs/vitepress/issues/4178)) ([615e33b](https://github.com/vuejs/vitepress/commit/615e33bb24d5005574af971ffcf1f41d751a855c)) +- trigger `onContentUpdated` on frontmatter-only changes too ([0db269a](https://github.com/vuejs/vitepress/commit/0db269a4c5d90ecf69f0219982cdf8f335e787ce)) + ## [1.3.4](https://github.com/vuejs/vitepress/compare/v1.3.3...v1.3.4) (2024-08-24) ### Bug Fixes diff --git a/docs/.vitepress/config/shared.ts b/docs/.vitepress/config/shared.ts index 65907247..b33ee9ae 100644 --- a/docs/.vitepress/config/shared.ts +++ b/docs/.vitepress/config/shared.ts @@ -60,7 +60,7 @@ export const shared = defineConfig({ provider: 'algolia', options: { appId: '8J64VVRP8K', - apiKey: 'a18e2f4cc5665f6602c5631fd868adfd', + apiKey: '52f578a92b88ad6abde815aae2b0ad7c', indexName: 'vitepress', locales: { ...zhSearch, diff --git a/docs/en/guide/routing.md b/docs/en/guide/routing.md index 945e63c0..55b3cd4c 100644 --- a/docs/en/guide/routing.md +++ b/docs/en/guide/routing.md @@ -156,22 +156,24 @@ You can customize the mapping between the source directory structure and the gen ``` . -├─ packages -│ ├─ pkg-a -│ │ └─ src -│ │ ├─ pkg-a-code.ts -│ │ └─ pkg-a-docs.md -│ └─ pkg-b -│ └─ src -│ ├─ pkg-b-code.ts -│ └─ pkg-b-docs.md +└─ packages + ├─ pkg-a + │ └─ src + │ ├─ foo.md + │ └─ index.md + └─ pkg-b + └─ src + ├─ bar.md + └─ index.md ``` And you want the VitePress pages to be generated like this: ``` -packages/pkg-a/src/pkg-a-docs.md --> /pkg-a/index.html -packages/pkg-b/src/pkg-b-docs.md --> /pkg-b/index.html +packages/pkg-a/src/index.md --> /pkg-a/index.html +packages/pkg-a/src/foo.md --> /pkg-a/foo.html +packages/pkg-b/src/index.md --> /pkg-b/index.html +packages/pkg-b/src/bar.md --> /pkg-b/bar.html ``` You can achieve this by configuring the [`rewrites`](../reference/site-config#rewrites) option like this: @@ -180,8 +182,10 @@ You can achieve this by configuring the [`rewrites`](../reference/site-config#re // .vitepress/config.js export default { rewrites: { - 'packages/pkg-a/src/pkg-a-docs.md': 'pkg-a/index.md', - 'packages/pkg-b/src/pkg-b-docs.md': 'pkg-b/index.md' + 'packages/pkg-a/src/index.md': 'pkg-a/index.md', + 'packages/pkg-a/src/foo.md': 'pkg-a/foo.md', + 'packages/pkg-b/src/index.md': 'pkg-b/index.md', + 'packages/pkg-b/src/bar.md': 'pkg-b/bar.md' } } ``` @@ -191,12 +195,22 @@ The `rewrites` option also supports dynamic route parameters. In the above examp ```ts export default { rewrites: { - 'packages/:pkg/src/(.*)': ':pkg/index.md' + 'packages/:pkg/src/:slug*': ':pkg/:slug*' } } ``` -The rewrite paths are compiled using the `path-to-regexp` package - consult [its documentation](https://github.com/pillarjs/path-to-regexp#parameters) for more advanced syntax. +The rewrite paths are compiled using the `path-to-regexp` package - consult [its documentation](https://github.com/pillarjs/path-to-regexp/tree/6.x#parameters) for more advanced syntax. + +`rewrites` can also be a function that receives the original path and returns the new path: + +```ts +export default { + rewrites(id) { + return id.replace(/^packages\/([^/]+)\/src\//, '$1/') + } +} +``` ::: warning Relative Links with Rewrites diff --git a/docs/en/reference/default-theme-search.md b/docs/en/reference/default-theme-search.md index 0ca3ac97..a83ae5ff 100644 --- a/docs/en/reference/default-theme-search.md +++ b/docs/en/reference/default-theme-search.md @@ -296,7 +296,7 @@ new Crawler({ lvl1: '.content h1', content: '.content p, .content li', lvl0: { - selectors: '', + selectors: 'section.has-active div h2', defaultValue: 'Documentation' }, lvl2: '.content h2', diff --git a/docs/en/reference/runtime-api.md b/docs/en/reference/runtime-api.md index 0f2e9ea0..5f7b5f80 100644 --- a/docs/en/reference/runtime-api.md +++ b/docs/en/reference/runtime-api.md @@ -103,8 +103,8 @@ interface Router { */ onBeforeRouteChange?: (to: string) => Awaitable /** - * Called before the page component is loaded (after the history state is - * updated). Return `false` to cancel the navigation. + * Called before the page component is loaded (after the history state is updated). + * Return `false` to cancel the navigation. */ onBeforePageLoad?: (to: string) => Awaitable /** diff --git a/docs/es/reference/default-theme-search.md b/docs/es/reference/default-theme-search.md index 10235382..5a654705 100644 --- a/docs/es/reference/default-theme-search.md +++ b/docs/es/reference/default-theme-search.md @@ -289,7 +289,7 @@ new Crawler({ lvl1: '.content h1', content: '.content p, .content li', lvl0: { - selectors: '', + selectors: 'section.has-active div h2', defaultValue: 'Documentation' }, lvl2: '.content h2', diff --git a/docs/ko/reference/default-theme-search.md b/docs/ko/reference/default-theme-search.md index 9d446a99..da1feb42 100644 --- a/docs/ko/reference/default-theme-search.md +++ b/docs/ko/reference/default-theme-search.md @@ -296,7 +296,7 @@ new Crawler({ lvl1: '.content h1', content: '.content p, .content li', lvl0: { - selectors: '', + selectors: 'section.has-active div h2', defaultValue: 'Documentation' }, lvl2: '.content h2', diff --git a/docs/pt/reference/default-theme-search.md b/docs/pt/reference/default-theme-search.md index 35b0d812..e7347afa 100644 --- a/docs/pt/reference/default-theme-search.md +++ b/docs/pt/reference/default-theme-search.md @@ -289,7 +289,7 @@ new Crawler({ lvl1: '.content h1', content: '.content p, .content li', lvl0: { - selectors: '', + selectors: 'section.has-active div h2', defaultValue: 'Documentation' }, lvl2: '.content h2', diff --git a/docs/ru/guide/asset-handling.md b/docs/ru/guide/asset-handling.md index c24bfa73..3b002e13 100644 --- a/docs/ru/guide/asset-handling.md +++ b/docs/ru/guide/asset-handling.md @@ -10,7 +10,7 @@ Вы можете ссылаться на статические ресурсы в ваших файлах разметки, компоненты `*.vue` в теме, стили и обычные файлы `.css`, используя абсолютные пути (основанные на корне проекта) или относительные пути (основанные на вашей файловой системе). Последнее похоже на поведение, к которому вы привыкли, если использовали Vite, Vue CLI или `file-loader` в webpack. -Распространенные типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически. +Распространённые типы файлов изображений, мультимедиа и шрифтов определяются и включаются в качестве ресурсов автоматически. ::: tip Связанные файлы не рассматриваются как ресурсы PDF-файлы или другие документы, на которые есть ссылки в файлах с разметкой, не рассматриваются автоматически как ресурсы. Чтобы сделать связанные файлы доступными, вы должны вручную поместить их в каталог [`public`](#the-public-directory) вашего проекта. diff --git a/docs/ru/guide/data-loading.md b/docs/ru/guide/data-loading.md index a611dc88..f7cfd26d 100644 --- a/docs/ru/guide/data-loading.md +++ b/docs/ru/guide/data-loading.md @@ -175,7 +175,7 @@ export default { } ``` -**Types** +**Типы** ```ts interface ContentOptions { @@ -226,7 +226,7 @@ interface ContentOptions { ## Загрузчики типизированных данных {#typed-data-loaders} -При использовании TypeScript вы можете ввести свой загрузчик и экспортировать `data` следующим образом: +При использовании TypeScript можно ввести свой загрузчик и экспортировать `data` следующим образом: ```ts import { defineLoader } from 'vitepress' diff --git a/docs/ru/guide/deploy.md b/docs/ru/guide/deploy.md index 11ee0c74..7825cbdd 100644 --- a/docs/ru/guide/deploy.md +++ b/docs/ru/guide/deploy.md @@ -4,7 +4,7 @@ outline: deep # Развёртывание вашего сайта VitePress {#deploy-your-vitepress-site} -Следующие руководства основаны на некоторых общих предположениях: +Следующие инструкции основаны на некоторых общих предположениях: - Сайт VitePress находится в директории `docs` вашего проекта. - Вы используете выходной каталог сборки по умолчанию (`.vitepress/dist`). @@ -19,7 +19,7 @@ outline: deep } ``` -## Создание и локальное тестирование {#build-and-test-locally} +## Сборка и локальное тестирование {#build-and-test-locally} 1. Выполните эту команду, чтобы собрать документацию: @@ -33,9 +33,9 @@ outline: deep $ npm run docs:preview ``` - Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать это, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство. + Команда `preview` загрузит локальный статический веб-сервер, который будет обслуживать выходной каталог `.vitepress/dist` по адресу `http://localhost:4173`. Вы можете использовать его для теста, чтобы убедиться, что всё выглядит хорошо, прежде чем отправлять в производство. -3. Вы можете настроить порт сервера, передав `--port` в качестве аргумента. +3. Можно указать порт сервера, передав `--port` в качестве аргумента. ```json { @@ -55,11 +55,11 @@ outline: deep ## Заголовки кэша HTTP {#http-cache-headers} -Если вы контролируете HTTP-заголовки на своем рабочем сервере, вы можете настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях. +Если вы контролируете HTTP-заголовки на своем рабочем сервере, можно настроить заголовки `cache-control` для достижения лучшей производительности при повторных посещениях. -В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью сетевой вкладки devtools вашего браузера, вы увидите файлы типа `app.4f283b18.js`. +В производственной сборке используются хэшированные имена файлов для статических ресурсов (JavaScript, CSS и другие импортированные ресурсы, не находящиеся в `public`). Если вы просмотрите предварительную версию с помощью вкладки «Network» («Сеть») инструментов разработчика вашего браузера, вы увидите файлы типа `app.4f283b18.js`. -Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что вы можете смело использовать самые сильные заголовки кэша для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок: +Этот хэш `4f283b18` генерируется из содержимого этого файла. Один и тот же хэшированный URL гарантированно обслуживает одно и то же содержимое файла — если содержимое меняется, то и URL тоже. Это означает, что можно смело использовать самые сильные настройки кэширования для этих файлов. Все такие файлы будут помещены в каталог `assets/` в выходном каталоге, поэтому вы можете настроить для них следующий заголовок: ``` Cache-Control: max-age=31536000,immutable @@ -198,7 +198,7 @@ Cache-Control: max-age=31536000,immutable ### GitLab Pages {#gitlab-pages} -1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы или если в GitLab включен параметр «Использовать уникальный домен». +1. Установите значение `../public` для параметра `outDir` в конфигурации VitePress. Настройте опцию `base` на `'/<репозиторий>/'`, если вы хотите развернуть ваш проект по адресу `https://<имя пользователя>.gitlab.io/<репозиторий>/`. Вам не нужна опция `base`, если вы выполняете развёртывание на личном домене, страницах пользователя или группы, или если в GitLab включен параметр «Использовать уникальный домен». 2. Создайте файл с именем `.gitlab-ci.yml` в корне вашего проекта с приведённым ниже содержимым. Это позволит создавать и развёртывать ваш сайт каждый раз, когда вы вносите изменения в его содержимое: diff --git a/docs/ru/guide/extending-default-theme.md b/docs/ru/guide/extending-default-theme.md index 2a8531bf..30308a7b 100644 --- a/docs/ru/guide/extending-default-theme.md +++ b/docs/ru/guide/extending-default-theme.md @@ -4,7 +4,7 @@ outline: deep # Расширение темы по умолчанию {#extending-the-default-theme} -Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по своему усмотрению. Полный список опций можно найти в главе [Настройки темы по умолчанию](../reference/default-theme-config). +Тема VitePress по умолчанию оптимизирована для документации и может быть настроена по вашему усмотрению. Полный список опций можно найти в главе [Настройки темы по умолчанию](../reference/default-theme-config). Однако есть ряд случаев, когда одной лишь конфигурации будет недостаточно. Например: @@ -12,7 +12,7 @@ outline: deep 2. Вам нужно изменить экземпляр приложения Vue, например, чтобы зарегистрировать глобальные компоненты; 3. Вам нужно внедрить пользовательский контент в тему через слоты макета. -Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тема по умолчанию. +Эти расширенные настройки потребуют использования пользовательской темы, которая «расширяет» тему по умолчанию. ::: tip СОВЕТ Прежде чем приступить к работе, обязательно прочитайте главу [Пользовательская тема](./custom-theme), чтобы понять, как работают пользовательские темы. @@ -124,7 +124,7 @@ export default { } satisfies Theme ``` -Поскольку мы используем Vite, вы также можете использовать [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов. +Поскольку мы используем Vite, можно применять [глобальную функцию импорта](https://vitejs.dev/guide/features.html#glob-import) Vite для автоматической регистрации каталога компонентов. ## Слоты макета {#layout-slots} diff --git a/docs/ru/guide/frontmatter.md b/docs/ru/guide/frontmatter.md index 967338f8..b09693f7 100644 --- a/docs/ru/guide/frontmatter.md +++ b/docs/ru/guide/frontmatter.md @@ -11,7 +11,7 @@ editLink: true --- ``` -Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить определённое поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config). +Многие параметры конфигурации сайта или темы по умолчанию имеют соответствующие опции в блоке метаданных. Вы можете использовать метаданные, чтобы переопределить заданное поведение только для текущей страницы. Подробности см. в [Справочнике по настройке метаданных](../reference/frontmatter-config). Вы также можете определить собственные метаданные, которые будут использоваться в динамических выражениях Vue на странице. diff --git a/docs/ru/guide/getting-started.md b/docs/ru/guide/getting-started.md index 515cb5a2..540f4278 100644 --- a/docs/ru/guide/getting-started.md +++ b/docs/ru/guide/getting-started.md @@ -63,7 +63,7 @@ VitePress — это пакет, предназначенный только д ### Мастер настройки {#setup-wizard} -VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, запустив его: +VitePress поставляется с мастером настройки командной строки, который поможет вам создать базовый проект. После установки запустите мастер, выполнив команду: ::: code-group @@ -133,13 +133,13 @@ export default { } ``` -Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Настройка сайта](../reference/site-config) для получения подробной информации обо всех параметрах конфигурации. +Вы также можете настроить поведение темы с помощью опции `themeConfig`. Загляните в главу [Конфигурация сайта](../reference/site-config) для получения подробной информации обо всех настраиваемых параметрах. ### Исходные файлы {#source-files} Файлы Markdown за пределами директории `.vitepress` считаются **исходными файлами**. -VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путем. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress. +VitePress использует **маршрутизацию на основе файлов**: Каждый файл `.md` компилируется в соответствующий файл `.html` с тем же путём. Например, `index.md` будет скомпилирован в `index.html`, и его можно будет посетить по корневому пути `/` результирующего сайта VitePress. VitePress также предоставляет возможность генерировать чистые URL-адреса, переписывать пути и динамически генерировать страницы. Всё это будет рассмотрено в [Руководстве по маршрутизации](./routing). @@ -159,7 +159,7 @@ VitePress также предоставляет возможность гене } ``` -Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Запустите его с помощью следующей команды: +Скрипт `docs:dev` запустит локальный dev-сервер с мгновенными горячими обновлениями. Выполните следующую команду: ::: code-group diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md index a021cd18..ffc66f51 100644 --- a/docs/ru/guide/markdown.md +++ b/docs/ru/guide/markdown.md @@ -210,7 +210,7 @@ console.log('Привет, VitePress!') ::: -Кроме того, вы можете установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке: +Кроме того, можно установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке: ```ts // config.ts @@ -269,7 +269,7 @@ export default defineConfig({ ## Оповещения в стиле GitHub {#github-flavored-alerts} -VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде призывов. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers). +VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде вставок. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers). ```md > [!NOTE] @@ -305,7 +305,7 @@ VitePress также поддерживает [Оповещения в стил ## Подсветка синтаксиса в блоках кода {#syntax-highlighting-in-code-blocks} -VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным значкам блока кода: +VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным обратным кавычкам блока кода: **Разметка** @@ -375,7 +375,7 @@ export default { } ``` -Помимо одной строки, вы можете указать несколько отдельных строк, диапазонов или и то, и другое: +Помимо одной строки, можно указать несколько отдельных строк, диапазонов или и то, и другое: - Диапазоны строк, например: `{5-8}`, `{3-10}`, `{10-17}` - Несколько одиночных строк, например: `{4,7,9}` @@ -477,7 +477,7 @@ export default { ## Подсветка различий в блоках кода {#colored-diffs-in-code-blocks} -Добавление в строку комментариев `// [!code --]` или `// [!code ++]` создаст diff этой строки, сохраняя цвета блока кода. +Добавление в строку комментариев `// [!code --]` или `// [!code ++]` подсветит различие этой строки от другой, сохраняя цвета блока кода. **Разметка** @@ -553,9 +553,9 @@ export default { Более подробную информацию см. в секции [`markdown`](../reference/site-config#markdown). -Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши ограждённые блоки кода, чтобы переопределить значение, установленное в конфиге. +Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши изолированные блоки кода, чтобы переопределить значение, установленное в конфиге. -Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что номера строк в блоках кода будут начинаться с `2`. +Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что нумерация строк в блоках кода будет начинаться с `2`. **Разметка** @@ -628,7 +628,7 @@ const line4 = 'Строка 4' <<< @/snippets/snippet.js{2} ::: tip СОВЕТ -Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен `srcDir`. Альтернативно вы также можете импортировать из относительных путей: +Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен параметр `srcDir`. Альтернативно вы также можете импортировать из относительных путей: ```md <<< ../snippets/snippet.js @@ -652,7 +652,7 @@ const line4 = 'Строка 4' <<< @/snippets/snippet-with-region.js#snippet{1} -Вы также можете указать язык внутри фигурных скобок (`{}`) следующим образом: +Кроме того, можно указать язык внутри фигурных скобок (`{}`) следующим образом: ```md <<< @/snippets/snippet.cs{c#} @@ -670,7 +670,7 @@ const line4 = 'Строка 4' ## Группы кодов {#code-groups} -Вы можете сгруппировать несколько блоков кода следующим образом: +Можно сгруппировать несколько блоков кода следующим образом: **Разметка** diff --git a/docs/ru/guide/mpa-mode.md b/docs/ru/guide/mpa-mode.md index 81843708..f3d32537 100644 --- a/docs/ru/guide/mpa-mode.md +++ b/docs/ru/guide/mpa-mode.md @@ -6,7 +6,7 @@ Однако из-за отсутствия навигации SPA межстраничные ссылки будут приводить к полной перезагрузке страницы. После загрузки навигация в режиме MPA будет не такой мгновенной, как в режиме SPA. -Также обратите внимание, что «no-JS-by-default» («без JS по умолчанию») означает, что вы используете Vue исключительно как серверный язык шаблонов. Никаких обработчиков событий в браузере не будет, поэтому интерактивности не будет. Чтобы загрузить JavaScript со стороны клиента, вам нужно использовать специальный тег `