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.
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:
- Descargue e instale Node.js , que usamos para administrar nuestras dependencias.
- Navegue hasta el directorio raíz
/bootstrap
y ejecutenpm install
para instalar nuestras dependencias locales enumeradas en package.json . - Instale Ruby , instale Bundler con
gem install bundler
y finalmente ejecutebundle 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.
Nuestro paquete.json incluye los siguientes comandos y tareas:
Tarea | Descripción |
---|---|
npm run dist |
npm run dist crea el /dist directorio con archivos compilados. Utiliza Sass , Autoprefixer y UglifyJS . |
npm test |
Igual que npm run dist plus 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 run
para ver todos los scripts de npm.
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.
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:
- Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with
bundle install
. - From the root
/bootstrap
directory, runnpm run docs-serve
in the command line. - Open
http://localhost:9001
in your browser, and voilà.
Learn more about using Jekyll by reading its documentation.
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
.