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 npm

Nuestro paquete.json incluye los siguientes comandos y tareas:

Tarea Descripción
npm run dist npm run distcrea el /dist/directorio 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.

Mantenemos la lista de navegadores admitidos a través de Autoprefixer en un archivo separado dentro de nuestro repositorio de GitHub. Ver .browserslistrc para más detalles.

Documentación local

Ejecutar nuestra documentación localmente requiere el uso de Jekyll, un generador de sitios estáticos decentemente flexible que nos proporciona: inclusiones básicas, archivos basados ​​en Markdown, plantillas y más. Así es como se pone en marcha:

  1. Ejecute la configuración de herramientas anterior para instalar Jekyll (el creador de sitios) y otras dependencias de Ruby con bundle install.
  2. Desde el directorio raíz /bootstrap, ejecute npm run docs-serveen la línea de comando.
  3. Ábrelo http://localhost:9001en tu navegador y listo.

Obtenga más información sobre el uso de Jekyll leyendo su documentación .

Solución de problemas

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.