docs: format custom containers [lunaria-ignore]

fix/4928
Divyansh Singh 3 weeks ago
parent dd29348466
commit 2e4978e3ad

@ -24,7 +24,7 @@ export default {
}
```
:::details Dynamic (Async) Config
::: details Dynamic (Async) Config
If you need to dynamically generate the config, you can also default export a function. For example:

@ -24,7 +24,7 @@ export default {
}
```
:::details Configuración dinámica (Assíncrona)
::: details Configuración dinámica (Assíncrona)
Si necesitas generar dinamicamente la configuración, también puedes exportar por defecto una función. Por ejemplo:
@ -594,7 +594,7 @@ export default {
`transformHead` es un enlace de compilación para transformar el encabezado antes de generar cada página. Esto le permite agregar entradas de encabezado que no se pueden agregar estáticamente a la configuración de VitePress. Sólo necesita devolver entradas adicionales, que se fusionarán automáticamente con las existentes.
:::warning
::: warning
No mutes ningún elemento dentro `context`.
:::
@ -662,7 +662,7 @@ export default {
- Tipo: `(code: string, id: string, context: TransformContext) => Awaitable<string | void>`
`transformHtml` es un gancho de compilación para transformar el contenido de cada página antes de guardarla en el disco.
:::warning
::: warning
No mute ningún elemento dentro del `context`. Además, modificar el contenido HTML puede provocar problemas de hidratación en tiempo de ejecución.
:::
@ -679,7 +679,7 @@ export default {
`transformPageData` es un gancho para transformar los datos de cada página. Puedes hacer mutaciones directamente en `pageData` o devolver valores modificados que se fusionarán con los datos de la página.
:::warning
::: warning
No mute ningún elemento dentro del `context` y tenga cuidado ya que esto puede afectar el rendimiento del servidor de desarrollo, especialmente si tiene algunas solicitudes de red o cálculos pesados (como generar imágenes) en el gancho. Puede consultar `process.env.NODE_ENV === 'production'` para ver la lógica condicional.
:::

@ -24,7 +24,7 @@ export default {
}
```
:::details تنظیمات پویا (غیرهمزمان)
::: details تنظیمات پویا (غیرهمزمان)
اگر نیاز دارید به طور پویا تنظیمات را تولید کنید، می‌توانید یک تابع صادر کنید. به عنوان مثال:
@ -354,7 +354,7 @@ export default {
وقتی تنظیم شود به `true`، ویت‌پرس `.html` انتهایی را از URL ها حذف می‌کند. همچنین ببینید [تولید URL تمیز](../guide/routing#generating-clean-url).
::: هشدار نیاز به پشتیبانی سرور
::: warning هشدار نیاز به پشتیبانی سرور
فعال کردن این ممکن است نیاز به پیکربندی اضافی در پلتفرم میزبان شما داشته باشد. برای اینکه کار کند، سرور شما باید بتواند `/foo.html` را زمانی که `/foo` بازدید می‌شود **بدون ریدایرکت** سرو کند.
:::

@ -24,7 +24,7 @@ export default {
}
```
:::details Configuração Dinâmica (Assíncrona)
::: details Configuração Dinâmica (Assíncrona)
Se você precisar gerar dinamicamente a configuração, também pode exportar por padrão uma função. Por exemplo:
@ -594,7 +594,7 @@ export default {
`transformHead` é um gancho de compilação para transformar o cabeçalho antes de gerar cada página. Isso permite adicionar entradas no cabeçalho que não podem ser adicionadas estaticamente à configuração VitePress. Você só precisa retornar entradas extras, que serão mescladas automaticamente com as existentes.
:::warning
::: warning
Não faça mutações em qualquer item dentro de `context`.
:::
@ -662,7 +662,7 @@ export default {
- Tipo: `(code: string, id: string, context: TransformContext) => Awaitable<string | void>`
`transformHtml` é um gancho de compilação para transformar o conteúdo de cada página antes de salvá-lo no disco.
:::warning
::: warning
Não faça mutações em qualquer item dentro de `context`. Além disso, modificar o conteúdo HTML pode causar problemas de hidratação em tempo de execução.
:::
@ -679,7 +679,7 @@ export default {
`transformPageData` é um gancho para transformar os dados de cada página. Você pode fazer mutações diretamente em `pageData` ou retornar valores alterados que serão mesclados nos dados da página.
:::warning
::: warning
Não faça mutações em qualquer item dentro de `context` e tenha cuidado pois isso pode impactar no desempenho do servidor de desenvolvimento, especialmente se você tiver algumas solicitações de rede ou computações pesadas (como gerar imagens) no gancho. Você pode verificar `process.env.NODE_ENV === 'production'` para lógica condicional.
:::

@ -24,7 +24,7 @@ export default {
}
```
:::details Динамическая (асинхронная) конфигурация
::: details Динамическая (асинхронная) конфигурация
Если вам нужно генерировать конфигурацию динамически, вы также можете экспортировать функцию по умолчанию. Например:

@ -14,7 +14,7 @@ VitePress 默认的主题已经针对文档进行了优化,并且可以进行
这些高级自定义配置将需要使用自定义主题来“拓展”默认主题。
:::tip
::: tip
在继续之前,请确保首先阅读[自定义主题](./custom-theme)以了解其工作原理。
:::

@ -69,7 +69,7 @@ $ bun vitepress init
<<< @/snippets/init.ansi
:::tip Vue 作为 peer dependency
::: tip Vue 作为 peer dependency
如果打算使用 Vue 组件或 API 进行自定义,还应该明确地将 `vue` 安装为 dependency。
:::
@ -92,7 +92,7 @@ $ bun vitepress init
`docs` 目录作为 VitePress 站点的项目**根目录**。`.vitepress` 目录是 VitePress 配置文件、开发服务器缓存、构建输出和可选主题自定义代码的位置。
:::tip
::: tip
默认情况下VitePress 将其开发服务器缓存存储在 `.vitepress/cache` 中,并将生产构建输出存储在 `.vitepress/dist` 中。如果使用 Git应该将它们添加到 `.gitignore` 文件中。也可以手动[配置](../reference/site-config#outdir)这些位置。
:::

@ -123,7 +123,7 @@ src/getting-started.md --> /getting-started.html
## 生成简洁的 URL {#generating-clean-url}
:::warning 需要服务器支持
::: warning 需要服务器支持
要使 VitePress 提供简洁 URL需要服务器端支持。
:::

@ -67,7 +67,7 @@ The count is: {{ count }}
</style>
```
:::warning 避免在 Markdown 中使用 `<style scoped>`
::: warning 避免在 Markdown 中使用 `<style scoped>`
在 Markdown 中使用时,`<style scoped>` 需要为当前页面的每个元素添加特殊属性,这将显著增加页面的大小。当我们需要局部范围的样式时 `<style module>` 是首选。
:::

@ -24,7 +24,7 @@ export default {
}
```
:::details 异步的动态配置
::: details 异步的动态配置
如果需要动态生成配置,也可以默认导出一个函数,例如:

Loading…
Cancel
Save