Source

Construír ferramentas

Aprende a usar os scripts npm incluídos de Bootstrap para crear a nosa documentación, compilar código fonte, realizar probas e moito máis.

Configuración de ferramentas

Bootstrap usa scripts npm para o seu sistema de compilación. O noso package.json inclúe métodos cómodos para traballar co cadro, incluíndo a compilación de código, a realización de probas e moito máis.

Para usar o noso sistema de compilación e executar a nosa documentación localmente, necesitarás unha copia dos ficheiros fonte de Bootstrap e de Node. Sigue estes pasos e deberías estar preparado para xogar:

  1. Descarga e instala Node.js , que usamos para xestionar as nosas dependencias.
  2. Navegue ata o directorio raíz /bootstrape execute npm installpara instalar as nosas dependencias locais listadas en package.json .
  3. Instale Ruby , instale Bundler con gem install bundlere, finalmente, execute bundle install. Isto instalará todas as dependencias de Ruby, como Jekyll e complementos.
    • Usuarios de Windows: le esta guía para que Jekyll funcione sen problemas.

Cando remate, poderás executar os distintos comandos proporcionados desde a liña de comandos.

Usando scripts npm

O noso package.json inclúe os seguintes comandos e tarefas:

Tarefa Descrición
npm run dist npm run distcrea o /dist/directorio con ficheiros compilados. Usa Sass , Autoprefixer e UglifyJS .
npm test Igual que npm run distademais, realiza probas localmente
npm run docs Crea e linta CSS e JavaScript para documentos. Despois pode executar a documentación localmente a través de npm run docs-serve.

Executar npm runpara ver todos os scripts npm.

Autoprefixador

Bootstrap usa Autoprefixer (incluído no noso proceso de compilación) para engadir automaticamente prefixos de provedores a algunhas propiedades CSS no momento da compilación. Facelo afórranos tempo e código ao permitirnos escribir partes clave do noso CSS unha soa vez ao tempo que eliminamos a necesidade de mesturas de provedores como as que se atopan na versión 3.

Mantemos a lista de navegadores compatibles con Autoprefixer nun ficheiro separado dentro do noso repositorio de GitHub. Consulte .browserslistrc para obter máis información.

Documentación local

A execución da nosa documentación localmente require o uso de Jekyll, un xerador de sitios estáticos decentemente flexible que nos proporciona: inclusións básicas, ficheiros baseados en Markdown, modelos e moito máis. Aquí tes como comezalo:

  1. Execute a configuración de ferramentas anterior para instalar Jekyll (o creador de sitios) e outras dependencias de Ruby con bundle install.
  2. Desde o directorio raíz /bootstrap, executa npm run docs-servena liña de comandos.
  3. Abre http://localhost:9001no teu navegador e listo.

Obtén máis información sobre o uso de Jekyll lendo a súa documentación .

Solución de problemas

Se atopas problemas coa instalación de dependencias, desinstala todas as versións anteriores de dependencias (globais e locais). Despois, volve executar npm install.