Pular para o conteúdo
understanding astro

Introdução

Criando um novo projeto

Starlight é um tema de documentação cheio de funcionalidades construído em cima do framework Astro.

Você pode criar um novo projeto Astro + Starlight usando o seguinte comando:

# cria um novo projeto com npm
npm create astro@latest -- --template starlight

Isso irá criar um novo diretório de projeto com todos os arquivos e configurações necessárias para o seu site.

Criando conteúdo com Starlight

Starlight está pronto para você adicionar novo conteúdo, ou trazer seus arquivos existentes!

Formatos de arquivo

Starlight suporta escrever conteúdo em Markdown e MDX. (Você pode adicionar suporte para Markdoc instalando a integração experimental Astro Markdoc.)

Adicione páginas

Adicione novas páginas ao seu site automaticamente ao criar arquivos .md ou .mdx em src/content/docs/. Adicione subdiretórios para organizar seus arquivos, e para criar múltiplos segmentos de caminho:

src/content/docs/ola-mundo.md => seu-site.com/ola-mundo
src/content/docs/guias/faq.md => seu-site.com/guias/faq

Frontmatter com segurança de tipos

Todas as páginas do Starlight compartilham um conjunto comum de propriedades frontmatter para controlar como a página aparece:

---
title: Olá, Mundo!
description: Essa é uma página no meu site com Starlight
---

Se você esquecer de algo importante, Starlight vai te informar.

Fazendo deploy do seu website Starlight

Assim que você tiver criado e customizado seu website Starlight, você pode fazer deploy dele para um servidor web ou plataforma de hospedagem de sua escolha, incluindo Netlify, Vercel, GitHub Pages e vários outros.

Aprenda sobre como fazer deploy de um site Astro na documentação do Astro.

Atualizando Starlight

Starlight é uma integração Astro, e é atualizado como qualquer outra integração @astrojs/*:

# atualiza Starlight com npm
npm install @astrojs/starlight@latest

Você pode ver uma lista completa das mudanças feitas para cada versão no histórico de mudanças do Starlight.

Solucionando Problemas no Starlight

Informação sobre tanto a configuração de projeto e configuração de frotmatter individual de página do Starlight estão disponíveis na seção Referência deste site. Use essas páginas para garantir que seu site Starlight está configurado e funcionando de acordo.

Veja a lista crescente de guias na navegação lateral para conseguir ajuda em adicionar conteúdo e customizar seu site Starlight.

Se a sua resposta não pôde ser encontrada nessa documentação, por favor visite a documentação do Astro para uma documentação mais completa sobre o Astro. Sua pergunta pode ser respondida ao entender como o Astro funciona no geral, por debaixo do tema Starlight.

Você também pode conseguir ajuda no Discord do Astro da nossa ativa e amigável comunidade! Você pode postar perguntas em nosso fórum #support ou visitar nosso canal dedicado #starlight para discutir o desenvolvimento atual e mais!