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"
  }
}

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.
--locale		Specify site locale to be used.
--hot-only	false	Enables Hot Module Replacement without page refresh as a fallback in case of build failures. Mais informações aqui.
--no-open	false	Do not open the page automatically in the browser.
--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.
--no-minify	false	Crie um site sem minimizar os pacotes JS/CSS.

info

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.

Development over network

When forwarding port 3000 from a remote server or VM (e.g. GitHub Codespaces), you can run the dev server on 0.0.0.0 to make it listen on the local IP.

npm

npm run start -- --host 0.0.0.0

Yarn

yarn run start --host 0.0.0.0

pnpm

pnpm run start --host 0.0.0.0

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
--dev		Builds the website in dev mode, including full React error messages.
--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
--locale		Build the site in the specified locale. If not specified, all known locales are built.
--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.

You can skip the HTML minification with the environment variable SKIP_HTML_MINIFICATION=true.

docusaurus swizzle [themeName] [componentName] [siteDir]

Swizzle a theme component to customize it.

npm

npm run swizzle [themeName] [componentName] [siteDir]

# Example (leaving out the siteDir to indicate this directory)
npm run swizzle @docusaurus/theme-classic Footer -- --eject

Yarn

yarn swizzle [themeName] [componentName] [siteDir]

# Example (leaving out the siteDir to indicate this directory)
yarn swizzle @docusaurus/theme-classic Footer --eject

pnpm

pnpm run swizzle [themeName] [componentName] [siteDir]

# Example (leaving out the siteDir to indicate this directory)
pnpm run swizzle @docusaurus/theme-classic Footer --eject

The swizzle CLI is interactive and will guide you through the whole swizzle process.

Opções

Nome	Descrição
themeName	The name of the theme to swizzle from.
componentName	The name of the theme component to swizzle.
--list	Display components available for swizzling
--eject	Eject the theme component
--wrap	Wrap the theme component
--danger	Allow immediate swizzling of unsafe components
--typescript	Swizzle the TypeScript variant component
--config	Path to docusaurus config file, default to [siteDir]/docusaurus.config.js

warning

Unsafe components have a higher risk of breaking changes due to internal refactorings.

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
--locale		Deploy the site in the specified locale. If not specified, all known locales are deployed.
--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. This may be useful when using a custom deploy script.
--target-dir	.	Path to the target directory to deploy to.
--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.
--no-open	false locally, true in CI	Do not open a browser window to the server location.

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 para cada mensagem de tradução, para ajudar a destacar strings não traduzidas

docusaurus write-heading-ids [siteDir] [files]

Add explicit heading IDs to the Markdown documents of your site.

Nome	Padrão	Descrição
files	All MD files used by plugins	The files that you want heading IDs to be written to.
--maintain-case	false	Keep the headings' casing, otherwise make all lowercase.
--overwrite	false	Overwrite existing heading IDs.