Source

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.

Configuració d'eines

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:

  1. Baixeu i instal·leu Node.js , que fem servir per gestionar les nostres dependències.
  2. Navegueu al /bootstrapdirectori arrel i executeu -lo npm installper instal·lar les nostres dependències locals que figuren a package.json .
  3. Instal·leu Ruby , instal·leu Bundler amb gem install bundleri, finalment, executeu-lo bundle 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.

Ús de scripts NPM

El nostre package.json inclou les ordres i tasques següents:

Tasca Descripció
npm run dist npm run distcrea el /distdirectori amb fitxers compilats. Utilitza Sass , Autoprefixer i UglifyJS .
npm test Igual que a npm run distmé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 runper veure tots els scripts npm.

Prefixador automàtic

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. Vegeu /.browserslistrc per obtenir més informació.

Documentació local

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:

  1. Executeu la configuració d'eines anterior per instal·lar Jekyll (el creador de llocs) i altres dependències de Ruby amb bundle install.
  2. Des del directori arrel /bootstrap, executeu npm run docs-serve-lo a la línia d'ordres.
  3. Obriu http://localhost:9001al vostre navegador i voilà.

Obteniu més informació sobre l'ús de Jekyll llegint la seva documentació .

Resolució de problemes

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.