CLI

Docusaurus fornece um conjunto de scripts para ajudá-lo a gerar, servir e implantar seu site.

Assim que seu site for inicializado, a fonte do site conterá os scripts Docusaurus que você pode invocar com seu gerenciador de pacotes:

package.json

{  // ...  "scripts": {    "docusaurus": "docusaurus",    "start": "docusaurus start",    "build": "docusaurus build",    "swizzle": "docusaurus swizzle",    "deploy": "docusaurus deploy",    "clear": "docusaurus clear",    "serve": "docusaurus serve",    "write-translations": "docusaurus write-translations",    "write-heading-ids": "docusaurus write-heading-ids"  }}

Index

• docusaurus start [siteDir]
• docusaurus build [siteDir]
• docusaurus swizzle [siteDir]
• docusaurus deploy [siteDir]
• docusaurus serve [siteDir]
• docusaurus clear [siteDir]
• docusaurus write-translations [siteDir]
• docusaurus write-heading-ids [siteDir]

Comandos do Docusaurus CLI

Abaixo está uma lista dos comandos do Docusaurus CLI e seus usos:

docusaurus start [siteDir]

Constrói e fornece uma visualização de seu site localmente com o Webpack Dev Server.

Opções

Nome	Padrão	Descrição
--port	3000	Especifica a porta do servidor de desenvolvimento.
--host	localhost	Especifique um host a ser usado. Por exemplo, se você quer que seu servidor seja acessível externamente, você pode usar --host 0.0.0.0.
--hot-only	false	Habilita Substituição de Módulos Quentes sem atualizar a página como recurso em caso de falhas de construção. Mais informações aqui.
--no-open	false	Não abrir automaticamente a página no navegador.
--config	undefined	Caminho para o arquivo de configuração do docusaurus, padrão para [siteDir]/docusaurus.config.js
--poll [optionalIntervalMs]	false	Use a pesquisa de arquivos em vez de observar a recarga ao vivo como uma alternativa em ambientes onde a vigilância não funciona. Mais informações aqui.

important

Por favor note que algumas funcionalidades (por exemplo, links de ancoragem) não funcionarão em desenvolvimento. A funcionalidade irá se comportar conforme o esperado em produção.

Habilitando HTTPS

Existem várias maneiras de obter um certificado. Vamos usar o mkcert como um exemplo.

1. Execute mkcert localhost para gerar localhost.pem + localhost-key.pem

2. Execute mkcert -install para instalar o certificado em seu armazenamento confiável e reinicie seu navegador

3. Inicie o aplicativo com variáveis de ambiente Docusaurus HTTPS:

HTTPS=true SSL_CRT_FILE=localhost.pem SSL_KEY_FILE=localhost-key.pem yarn start

4. Abra https://localhost:3000/

docusaurus build [siteDir]

Compila seu local para produção.

Opções

Nome	Padrão	Descrição
--bundle-analyzer	false	Analise seu pacote com o analisador de pacote webpack.
--out-dir	build	O caminho completo para o novo diretório de saída, relativo ao espaço de trabalho atual.
--config	undefined	Caminho para o arquivo de configuração do docusaurus, padrão para [siteDir]/docusaurus.config.js
--no-minify	false	Crie um site sem minimizar os pacotes JS/CSS.

info

Para a minimização avançada do pacote CSS, usamos a predefinição cssnano avançada (junto com vários plug-ins PostCSS adicionais) e otimização de nível 2 do clean-css. Se, como resultado dessa minimização CSS avançada, você encontrar CSS quebrado, construa seu site com a variável de ambiente USE_SIMPLE_CSS_MINIFIER=true para reduzir CSS com o predefinição cssnano padrão. Por favor preencha uma issue se você tiver experimentado bugs de minificação CSS.

docusaurus swizzle [siteDir]

caution

Nós desencorajamos o swizzling de componentes durante a fase beta do Docusaurus 2. É provável que as APIs dos componentes do tema evoluam e tenham alterações significativas. Se possível, mantenha a aparência padrão por enquanto.

Mude qualquer componente do tema Docusaurus ao seu gosto com o npm run swizzle.

npm

npm run swizzle [themeName] [componentName] [siteDir]
# Example (leaving out the siteDir to indicate this directory)npm run swizzle @docusaurus/theme-classic DocSidebar

Yarn

yarn run swizzle [themeName] [componentName] [siteDir]
# Example (leaving out the siteDir to indicate this directory)yarn run swizzle @docusaurus/theme-classic DocSidebar

Executar o comando irá copiar os arquivos de temas relevantes para a pasta do site. Você pode então fazer qualquer alterações nele e o Docusaurus irá usá-lo em vez do fornecido no tema.

npm run swizzle sem themeName lista todos os temas disponíveis para swizzling; Da mesma forma, npm run swizzle <themeName> sem componentName lista todos os componentes disponíveis para deslizar o dispositivo.

Opções

Nome	Descrição
themeName	O nome do tema que você está usando.
swizzleComponent	O nome do componente a ser varrido.
--danger	Permitir swizzling de componentes instáveis
--typescript	Componentes Swizzle TypeScript

Um exemplo para usar a flag --danger vamos considerar o código abaixo:

npm

npm run swizzle @docusaurus/theme-classic Logo -- --danger

Yarn

yarn run swizzle @docusaurus/theme-classic Logo -- --danger

caution

Componentes instáveis: componentes que têm um risco maior de quebra de alterações devido a refatorações internas.

Para unswizzle um componente, simplesmente apague os arquivos do componente swizzled.

docusaurus deploy [siteDir]

Faça deploy do seu site com o GitHub Pages. Confira a documentação em deployment para mais detalhes.

Opções

Nome	Padrão	Descrição
--out-dir	build	O caminho completo para o novo diretório de saída, relativo ao espaço de trabalho atual.
--skip-build	false	Implante o site sem construí-lo. Isso pode ser útil ao usar o script de implantação customizado.
--config	undefined	Caminho para o arquivo de configuração do docusaurus, padrão para [siteDir]/docusaurus.config.js

docusaurus serve [siteDir]

Disponibilize o site construído localmente.

Nome	Padrão	Descrição
--port	3000	Usar porta especificada
--dir	build	O caminho completo para o diretório de saída, relativo ao espaço de trabalho atual
--build	false	Crie um site antes de servir
--config	undefined	Caminho para o arquivo de configuração do docusaurus, padrão para [siteDir]/docusaurus.config.js
--host	localhost	Especifique um host a ser usado. Por exemplo, se você quer que seu servidor seja acessível externamente, você pode usar --host 0.0.0.0.

docusaurus clear [siteDir]

Limpe os assets gerados pelo site do Docusaurus. Caches e artefatos de construção.

Recomendamos executar esse comando antes de relatar bugs, depois de atualizar versões ou a qualquer momento que você tenha problemas com o seu site Docusaurus.

docusaurus write-translations [siteDir]

Escreva os arquivos de tradução JSON que você terá que traduzir.

Por padrão, os arquivos são escritos em website/i18n/<defaultLocale>/....

Nome	Padrão	Descrição
--locale	<defaultLocale>	Defina em qual pasta de localização você deseja escrever as traduções dos arquivos JSON
--override	false	Substituir as mensagens de tradução existentes
--config	undefined	Caminho para o arquivo de configuração do docusaurus, padrão para [siteDir]/docusaurus.config.js
--messagePrefix	''	Permite adicionar um prefixo a cada mensagem de tradução, para ajudá-lo a destacar frases não traduzidas

docusaurus write-heading-ids [siteDir]

Adicione Ids de título explícitos aos documentos Markdown do seu site.