Source

Construir herramientas

Aprenda a usar los scripts npm incluidos de Bootstrap para crear nuestra documentación, compilar el código fuente, ejecutar pruebas y más.

Configuración de herramientas

Bootstrap usa scripts NPM para su sistema de compilación. Nuestro paquete.json incluye métodos convenientes para trabajar con el marco, incluida la compilación de código, la ejecución de pruebas y más.

Para usar nuestro sistema de compilación y ejecutar nuestra documentación localmente, necesitará una copia de los archivos fuente de Bootstrap y Node. Siga estos pasos y debería estar listo para rockear:

  1. Descargue e instale Node.js , que usamos para administrar nuestras dependencias.
  2. Navegue hasta el directorio raíz /bootstrapy ejecute npm installpara instalar nuestras dependencias locales enumeradas en package.json .
  3. Instale Ruby , instale Bundler con gem install bundlery finalmente ejecute bundle install. Esto instalará todas las dependencias de Ruby, como Jekyll y complementos.
    • Usuarios de Windows: lea esta guía para que Jekyll funcione sin problemas.

Cuando haya terminado, podrá ejecutar los diversos comandos proporcionados desde la línea de comandos.

Uso de secuencias de comandos de NPM

Nuestro paquete.json incluye los siguientes comandos y tareas:

Tarea Descripción
npm run dist npm run distcrea el /distdirectorio con archivos compilados. Utiliza Sass , Autoprefixer y UglifyJS .
npm test Igual que npm run distplus ejecuta pruebas localmente
npm run docs Crea y aplica CSS y JavaScript para documentos. A continuación, puede ejecutar la documentación localmente a través de npm run docs-serve.

Ejecute npm runpara ver todos los scripts de npm.

autoprefijador

Bootstrap usa Autoprefixer (incluido en nuestro proceso de compilación) para agregar automáticamente prefijos de proveedores a algunas propiedades de CSS en el momento de la compilación. Hacerlo nos ahorra tiempo y código al permitirnos escribir partes clave de nuestro CSS una sola vez y eliminar la necesidad de combinaciones de proveedores como las que se encuentran en v3.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /package.json for details.

Local documentation

Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  1. Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001 in your browser, and voilà.

Learn more about using Jekyll by reading its documentation.

Troubleshooting

Si encuentra problemas con la instalación de dependencias, desinstale todas las versiones de dependencia anteriores (globales y locales). Luego, vuelva a ejecutar npm install.