Saltar para o conteúdo
Blume is now publicly available.
Blume
Português
Esc
navegarabrir⌘Jpré-visualizar
Nesta página

Início rápido

Instale o Blume, crie a estrutura de um novo projeto e publique a sua primeira página de documentação em minutos — depois faça-a crescer até um site completo ao seu próprio ritmo.

Passe de uma pasta vazia a um site de documentação em funcionamento com apenas alguns comandos. O Blume precisa de Node.js 22.12 ou superior e de uma pasta docs/ com pelo menos um ficheiro .md ou .mdx — não há mais nada para configurar.

Instalar e executar

Install Blume

Adicione o pacote a um projeto novo ou já existente.

npm install blume
pnpm add blume
yarn add blume
bun add blume

Scaffold a project

O blume init faz algumas perguntas — onde criar o projeto, qual o nome do seu site de documentação, que modelo usar e onde reside o seu conteúdo — e depois gera a estrutura mínima: uma pasta de conteúdo e um ficheiro de configuração. Passe --yes para saltar as perguntas e aceitar as predefinições.

blume init
docs/
  index.mdx
blume.config.ts

Start the dev server

O Blume gera o runtime e serve a sua documentação com recarregamento automático.

blume dev

Build for production

O HTML estático é escrito em dist/, com um índice de pesquisa local construído sobre ele.

blume build

Escrever a sua primeira página

Cada página é Markdown ou MDX com um pouco de frontmatter — o title e a description são apresentados automaticamente como o cabeçalho e a introdução da página. Coloque isto em docs/index.mdx:

---
title: Introduction
description: Welcome to my docs.
---

Welcome! Use **Markdown** and built-in components — no imports required:

:::note
Blume ships callouts, cards, tabs, steps, and more.
:::

Guarde o ficheiro e o servidor de desenvolvimento recarrega de imediato. A navegação, a pesquisa e os metadados das páginas são inferidos a partir dos seus ficheiros à medida que os adiciona — continue a escrever, que o site acompanha.

Próximos passos

Esta página foi útil?