Construir eines
Apreneu a utilitzar els scripts npm inclosos de Bootstrap per crear la nostra documentació, compilar el codi font, executar proves i molt més.
Bootstrap utilitza scripts NPM per al seu sistema de compilació. El nostre package.json inclou mètodes convenients per treballar amb el marc, com ara compilar codi, executar proves i molt més.
Per utilitzar el nostre sistema de compilació i executar la nostra documentació localment, necessitareu una còpia dels fitxers font de Bootstrap i del Node. Seguiu aquests passos i hauríeu d'estar a punt per fer-ho:
- Baixeu i instal·leu Node.js , que fem servir per gestionar les nostres dependències.
- Navegueu al
/bootstrap
directori arrel i executeu -lonpm install
per instal·lar les nostres dependències locals que figuren a package.json . - Instal·leu Ruby , instal·leu Bundler amb
gem install bundler
i, finalment, executeu-lobundle install
. Això instal·larà totes les dependències de Ruby, com ara Jekyll i connectors.- Usuaris de Windows: llegiu aquesta guia per posar Jekyll en funcionament sense problemes.
Quan s'hagi completat, podreu executar les diferents ordres proporcionades des de la línia d'ordres.
El nostre package.json inclou les ordres i tasques següents:
Tasca | Descripció |
---|---|
npm run dist |
npm run dist crea el /dist directori amb fitxers compilats. Utilitza Sass , Autoprefixer i UglifyJS . |
npm test |
Igual que a npm run dist més, fa proves localment |
npm run docs |
Construeix i linta CSS i JavaScript per a documents. A continuació, podeu executar la documentació localment mitjançant npm run docs-serve . |
Executeu npm run
per veure tots els scripts npm.
Bootstrap utilitza Autoprefixer (inclòs al nostre procés de creació) per afegir automàticament prefixos de proveïdor a algunes propietats CSS en el moment de la creació. Fer-ho ens estalvia temps i codi, ja que ens permet escriure parts clau del nostre CSS una sola vegada, alhora que elimina la necessitat de mixins de proveïdors com els que es troben a la v3.
Mantenim la llista de navegadors compatibles amb Autoprefixer en un fitxer separat dins del nostre repositori GitHub. Consulteu /package.json per obtenir més informació.
L'execució de la nostra documentació a nivell local requereix l'ús de Jekyll, un generador de llocs estàtics decentment flexible que ens proporciona: inclou bàsiques, fitxers basats en Markdown, plantilles i molt més. A continuació s'explica com començar-ho:
- Executeu la configuració d'eines anterior per instal·lar Jekyll (el creador de llocs) i altres dependències de Ruby amb
bundle install
. - Des del directori arrel
/bootstrap
, executeunpm run docs-serve
-lo a la línia d'ordres. - Obriu
http://localhost:9001
al vostre navegador i voilà.
Obteniu més informació sobre l'ús de Jekyll llegint la seva documentació .
Si teniu problemes amb la instal·lació de dependències, desinstal·leu totes les versions anteriors de dependències (globals i locals). Després, torna a executar npm install
.