From 3cd6c43767c485bcd7044af8bb46fcaed2ca5515 Mon Sep 17 00:00:00 2001 From: Savio Nascimento Date: Mon, 5 Feb 2024 13:26:05 -0400 Subject: [PATCH] docs(pt) i18n: Create and translate `docs/pt/reference/default-theme-layout.md` --- docs/pt/reference/default-theme-layout.md | 63 +++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 docs/pt/reference/default-theme-layout.md diff --git a/docs/pt/reference/default-theme-layout.md b/docs/pt/reference/default-theme-layout.md new file mode 100644 index 00000000..befbce59 --- /dev/null +++ b/docs/pt/reference/default-theme-layout.md @@ -0,0 +1,63 @@ +# Layout + +Você pode escolher o layout da página definindo a opção de `layout` para o [frontmatter](./frontmatter-config) da página. Há três opções de layout: `doc`, `page` e `home`. Se nada for especificado, a página será tratada como página de documento. + + +```yaml +--- +layout: doc +--- +``` + +## Layout do documento + +A opção `doc` é o layout padrão e estiliza todo o conteúdo do Markdown com a aparência de "documentação". Funciona agrupando todo o conteúdo na classe css `vp-doc` e aplicando os estilos aos elementos abaixo dela. + +Quase todos os elementos genéricos, como `p` ou `h2`, recebem um estilo especial. Portanto, lembre-se de que se você adicionar qualquer HTML personalizado dentro de um conteúdo Markdown, ele também será afetado por esses estilos. + +Ele também fornece recursos específicos de documentação listados abaixo. Esses recursos estão habilitados apenas neste layout. + +- Editar link +- Links Anterior e Próximo +- Contorno +- [Carbon Ads](./default-theme-carbon-ads) + +## Layout da Página + +A página de opções `page` é tratada como "página em branco". O Markdown ainda será analisado e todas as [Extensões de Markdown](../guide/markdown) funcionarão da mesma forma que o layout `doc`, mas não receberá nenhum estilo padrão. + +O layout da página permitirá que você estilize tudo sem que o tema VitePress afete a marcação. Isso é útil quando você deseja criar sua própria página personalizada. + +Observe que mesmo neste layout, a barra lateral ainda aparecerá se a página tiver uma configuração de barra lateral correspondente. + +## Layout da Home + +A opção `home` gerará um modelo de _"Homepage"_. Nesse layout, você pode definir opções extras, como `hero` e `features`, para personalizar ainda mais o conteúdo. Visite o [Tema padrão: Página Inicial](./default-theme-home-page) para obter mais detalhes. + +## Sem Layout + +Se você não quiser nenhum layout, você pode passar `layout:` false pelo frontmatter. Esta opção é útil se você deseja uma página de destino totalmente personalizável (sem barra lateral, barra de navegação ou rodapé por padrão). + +## Layout Personalizado + +Você também pode usar um layout personalizado: + +```md +--- +layout: foo +--- +``` + +Isto irá procurar um componente chamado `foo` registrado no contexto. Por exemplo, você pode registrar seu componente globalmente em `.vitepress/theme/index.ts`: + +```ts +import DefaultTheme from 'vitepress/theme' +import Foo from './Foo.vue' + +export default { + extends: DefaultTheme, + enhanceApp({ app }) { + app.component('foo', Foo) + } +} +```