From 879f4b7a336694087f370caa7e0698ac07b688db Mon Sep 17 00:00:00 2001 From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com> Date: Mon, 11 Nov 2024 19:20:32 +0530 Subject: [PATCH] fix container blocks --- docs/en/reference/site-config.md | 2 +- docs/es/guide/deploy.md | 4 ++-- docs/es/guide/getting-started.md | 2 +- docs/es/reference/site-config.md | 10 +++++----- docs/pt/guide/markdown.md | 6 +++--- docs/pt/guide/routing.md | 4 ++-- docs/pt/reference/site-config.md | 10 +++++----- docs/ru/reference/site-config.md | 2 +- docs/zh/guide/extending-default-theme.md | 2 +- docs/zh/guide/getting-started.md | 4 ++-- docs/zh/guide/routing.md | 2 +- docs/zh/guide/using-vue.md | 2 +- docs/zh/reference/site-config.md | 2 +- 13 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/en/reference/site-config.md b/docs/en/reference/site-config.md index 8cf5e264..439b10f7 100644 --- a/docs/en/reference/site-config.md +++ b/docs/en/reference/site-config.md @@ -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: diff --git a/docs/es/guide/deploy.md b/docs/es/guide/deploy.md index 9df3cc47..d28fff04 100644 --- a/docs/es/guide/deploy.md +++ b/docs/es/guide/deploy.md @@ -65,7 +65,7 @@ Este hash `4f283b18` es generado a partir del contenido de este archivo. La mism Cache-Control: max-age=31536000,immutable ``` -::: detalles Ejemplo de archivo `_headers` do Netlify +::: details Ejemplo de archivo `_headers` do Netlify ``` /assets/* @@ -79,7 +79,7 @@ Nota: el archivo `_headers` debe ser colocado en [directorio public](./asset-han ::: -::: detalles de Ejemplo de configuración Vercel em `vercel.json` +::: details de Ejemplo de configuración Vercel em `vercel.json` ```json { diff --git a/docs/es/guide/getting-started.md b/docs/es/guide/getting-started.md index 8ffdd6dd..57900553 100644 --- a/docs/es/guide/getting-started.md +++ b/docs/es/guide/getting-started.md @@ -35,7 +35,7 @@ $ bun add -D vitepress ::: -::: detalles recibiendo avisos sobre dependencias ausentes? +::: details recibiendo avisos sobre dependencias ausentes? Si usa PNPM, percibirá un aviso de ausencia de `@docsearch/js`. Esto no evita que VitePress funcione. Si desea eliminar este aviso, adicione lo siguiente en su `package.json`: ```json diff --git a/docs/es/reference/site-config.md b/docs/es/reference/site-config.md index 16233ba6..4043fc9c 100644 --- a/docs/es/reference/site-config.md +++ b/docs/es/reference/site-config.md @@ -24,7 +24,7 @@ export default { } ``` -:::details Configuración dinámica (Asíncrona) +::: details Configuración dinámica (Asíncrona) Si necesitas generar dinamicamente la configuración, también puedes exportar por defecto una función. Por ejemplo: @@ -352,7 +352,7 @@ export default { Cuando se establece en `true`, VitePress eliminará el `.html` al final de las URLs. Consulte también [Generar URL Limpia](../guide/routing#generating-clean-url). -::: Alerta de Soporte de Servidor Requerido +::: warning Soporte de Servidor Requerido Habilitar esto puede requerir configurar adicional en su plataforma de alojamiento. Para funcionar, su servidor debe poder servir `/foo.html` cuando visite `/foo` **sin redirección**. ::: @@ -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` `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. ::: diff --git a/docs/pt/guide/markdown.md b/docs/pt/guide/markdown.md index cb2d3e22..28814466 100644 --- a/docs/pt/guide/markdown.md +++ b/docs/pt/guide/markdown.md @@ -625,7 +625,7 @@ Também suporta [destaque de linha](#line-highlighting-in-code-blocks): <<< @/snippets/snippet.js{2} -::: dica +::: tip O valor de `@` corresponde à raiz do código fonte. Por padrão, é a raiz do projeto VitePress, a menos que `srcDir` seja configurado. Alternativamente, você também pode importar de caminhos relativos: ```md @@ -758,7 +758,7 @@ Você também pode [importar _snippets_ de código](#import-code-snippets) em gr Você pode incluir um arquivo markdown em outro arquivo markdown, mesmo aninhado. -::: dica +::: tip Você também pode prefixar o caminho do markdown com `@`, ele atuará como a raiz de origem. Por padrão, é a raiz do projeto VitePress, a menos que `srcDir` seja configurado. ::: @@ -834,7 +834,7 @@ Pode ser criada usando `.foorc.json`. O formato do intervalo de linhas selecionado pode ser: `{3,}`, `{,10}`, `{1,10}` -::: aviso +::: info Observe que isso não gera erros se o arquivo não estiver presente. Portanto, ao usar esse recurso, certifique-se de que o conteúdo está sendo mostrado como esperado. ::: diff --git a/docs/pt/guide/routing.md b/docs/pt/guide/routing.md index 640f6656..6d898cef 100644 --- a/docs/pt/guide/routing.md +++ b/docs/pt/guide/routing.md @@ -109,7 +109,7 @@ Se você deseja vincular a uma página em seu site que não é gerada pelo ViteP [Link para pure.html](/pure.html){target="_self"} -::: dica Nota +::: tip Nota Nos links Markdown, a `base` é automaticamente adicionada à URL. Isso significa que, se você deseja vincular a uma página fora da sua base, será necessário algo como `../../pure.html` no link (resolvido em relação à página atual pelo navegador). @@ -123,7 +123,7 @@ Alternativamente, pode-se usar diretamente a sintaxe da tag âncora: ## Geração de URL Limpa {#generating-clean-url} -::: aviso Suporte do Servidor Necessário +::: info Suporte do Servidor Necessário Para servir URLs limpas com VitePress, é necessário suporte no lado do servidor. ::: diff --git a/docs/pt/reference/site-config.md b/docs/pt/reference/site-config.md index 922f698f..5061bd4d 100644 --- a/docs/pt/reference/site-config.md +++ b/docs/pt/reference/site-config.md @@ -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: @@ -352,7 +352,7 @@ export default { Quando definido como `true`, VitePress removerá o `.html` no final dos URLs. Veja também [Gerando URL Limpa](../guide/routing#generating-clean-url). -::: alerta Suporte do Servidor Necessário +::: warning Suporte do Servidor Necessário Ativar isso pode exigir configurações adicionais em sua plataforma de hospedagem. Para funcionar, seu servidor deve ser capaz de servir `/foo.html` ao visitar `/foo` **sem redirecionamento**. ::: @@ -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` `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. ::: diff --git a/docs/ru/reference/site-config.md b/docs/ru/reference/site-config.md index 8ba3a110..bc7366ac 100644 --- a/docs/ru/reference/site-config.md +++ b/docs/ru/reference/site-config.md @@ -24,7 +24,7 @@ export default { } ``` -:::details Динамическая (асинхронная) конфигурация +::: details Динамическая (асинхронная) конфигурация Если вам нужно генерировать конфигурацию динамически, вы также можете экспортировать функцию по умолчанию. Например: diff --git a/docs/zh/guide/extending-default-theme.md b/docs/zh/guide/extending-default-theme.md index 7521ed61..c9489da4 100644 --- a/docs/zh/guide/extending-default-theme.md +++ b/docs/zh/guide/extending-default-theme.md @@ -14,7 +14,7 @@ VitePress 默认的主题已经针对文档进行了优化，并且可以进行 这些高级自定义配置将需要使用自定义主题来“拓展”默认主题。 -:::tip +::: tip 在继续之前，请确保首先阅读[自定义主题](./custom-theme)以了解其工作原理。 ::: diff --git a/docs/zh/guide/getting-started.md b/docs/zh/guide/getting-started.md index 0e8b7564..dd5f1994 100644 --- a/docs/zh/guide/getting-started.md +++ b/docs/zh/guide/getting-started.md @@ -89,7 +89,7 @@ $ bun vitepress init <<< @/snippets/init.ansi -:::tip Vue 作为 peer dependency +::: tip Vue 作为 peer dependency 如果打算使用 Vue 组件或 API 进行自定义，还应该明确地将 `vue` 安装为 dependency。 ::: @@ -112,7 +112,7 @@ $ bun vitepress init `docs` 目录作为 VitePress 站点的项目**根目录**。`.vitepress` 目录是 VitePress 配置文件、开发服务器缓存、构建输出和可选主题自定义代码的位置。 -:::tip +::: tip 默认情况下，VitePress 将其开发服务器缓存存储在 `.vitepress/cache` 中，并将生产构建输出存储在 `.vitepress/dist` 中。如果使用 Git，应该将它们添加到 `.gitignore` 文件中。也可以手动[配置](../reference/site-config#outdir)这些位置。 ::: diff --git a/docs/zh/guide/routing.md b/docs/zh/guide/routing.md index 5df74a44..84eba978 100644 --- a/docs/zh/guide/routing.md +++ b/docs/zh/guide/routing.md @@ -123,7 +123,7 @@ src/getting-started.md --> /getting-started.html ## 生成简洁的 URL {#generating-clean-url} -:::warning 需要服务器支持 +::: warning 需要服务器支持 要使 VitePress 提供简洁 URL，需要服务器端支持。 ::: diff --git a/docs/zh/guide/using-vue.md b/docs/zh/guide/using-vue.md index be181fee..f9acaad4 100644 --- a/docs/zh/guide/using-vue.md +++ b/docs/zh/guide/using-vue.md @@ -67,7 +67,7 @@ The count is: {{ count }} ``` -:::warning 避免在 Markdown 中使用 `