Source

Ferramentas de construção

Aprenda a usar os scripts npm incluídos no Bootstrap para criar nossa documentação, compilar código-fonte, executar testes e muito mais.

Configuração de ferramentas

Bootstrap usa scripts NPM para seu sistema de compilação. Nosso package.json inclui métodos convenientes para trabalhar com a estrutura, incluindo compilação de código, execução de testes e muito mais.

Para usar nosso sistema de compilação e executar nossa documentação localmente, você precisará de uma cópia dos arquivos de origem do Bootstrap e do Node. Siga estes passos e você deve estar pronto para arrasar:

  1. Baixe e instale o Node.js , que usamos para gerenciar nossas dependências.
  2. Navegue até o diretório raiz /bootstrape execute npm installpara instalar nossas dependências locais listadas em package.json .
  3. Instale o Ruby , instale o Bundler com gem install bundlere finalmente execute o bundle install. Isso instalará todas as dependências do Ruby, como Jekyll e plugins.
    • Usuários do Windows: Leia este guia para colocar o Jekyll em funcionamento sem problemas.

Quando concluído, você poderá executar os vários comandos fornecidos na linha de comando.

Usando scripts NPM

Nosso package.json inclui os seguintes comandos e tarefas:

Tarefa Descrição
npm run dist npm run distcria o /distdiretório com arquivos compilados. Usa Sass , Autoprefixer e UglifyJS .
npm test O mesmo que npm run distmais ele executa testes localmente
npm run docs Constrói e lints CSS e JavaScript para documentos. Você pode então executar a documentação localmente via npm run docs-serve.

Corra npm runpara ver todos os scripts npm.

Prefixador automático

O Bootstrap usa o Autoprefixer (incluído em nosso processo de compilação) para adicionar automaticamente prefixos de fornecedor a algumas propriedades CSS no momento da compilação. Isso nos economiza tempo e código, permitindo que escrevamos partes-chave do nosso CSS uma única vez, eliminando a necessidade de mixins de fornecedores como os encontrados na v3.

Mantemos a lista de navegadores suportados pelo Autoprefixer em um arquivo separado em nosso repositório GitHub. Consulte /.browserslistrc para obter detalhes.

Documentação local

Executar nossa documentação localmente requer o uso do Jekyll, um gerador de site estático decentemente flexível que nos fornece: inclui básicos, arquivos baseados em Markdown, modelos e muito mais. Veja como começar:

  1. Execute a configuração de ferramentas acima para instalar o Jekyll (o construtor de sites) e outras dependências do Ruby com bundle install.
  2. No diretório raiz /bootstrap, execute npm run docs-servena linha de comando.
  3. Abra http://localhost:9001no seu navegador e voilà.

Saiba mais sobre como usar o Jekyll lendo sua documentação .

Solução de problemas

Se você encontrar problemas com a instalação de dependências, desinstale todas as versões anteriores de dependência (global e local). Em seguida, execute novamente npm install.