Source

Costruisci strumenti

Scopri come utilizzare gli script npm inclusi in Bootstrap per creare la nostra documentazione, compilare il codice sorgente, eseguire test e altro ancora.

Configurazione degli utensili

Bootstrap utilizza gli script NPM per il suo sistema di compilazione. Il nostro package.json include metodi convenienti per lavorare con il framework, inclusa la compilazione del codice, l'esecuzione di test e altro ancora.

Per utilizzare il nostro sistema di compilazione ed eseguire la nostra documentazione in locale, avrai bisogno di una copia dei file sorgente e di Node di Bootstrap. Segui questi passaggi e dovresti essere pronto per il rock:

  1. Scarica e installa Node.js , che utilizziamo per gestire le nostre dipendenze.
  2. Passa alla /bootstrapdirectory principale ed esegui npm installper installare le nostre dipendenze locali elencate in package.json .
  3. Installa Ruby , installa Bundler con gem install bundlere infine esegui bundle install. Questo installerà tutte le dipendenze di Ruby, come Jekyll e plugin.
    • Utenti Windows: leggi questa guida per far funzionare Jekyll senza problemi.

Al termine, sarai in grado di eseguire i vari comandi forniti dalla riga di comando.

Utilizzo di script NPM

Il nostro package.json include i seguenti comandi e attività:

Compito Descrizione
npm run dist npm run distcrea la /distdirectory con i file compilati. Utilizza Sass , Autoprefixer e UglifyJS .
npm test Come in npm run distpiù, esegue i test localmente
npm run docs Costruisce e lascia CSS e JavaScript per i documenti. È quindi possibile eseguire la documentazione in locale tramite npm run docs-serve.

Esegui npm runper vedere tutti gli script npm.

Prefisso automatico

Bootstrap utilizza Autoprefixer (incluso nel nostro processo di compilazione) per aggiungere automaticamente i prefissi dei fornitori ad alcune proprietà CSS in fase di compilazione. Ciò ci consente di risparmiare tempo e codice consentendoci di scrivere parti chiave del nostro CSS una sola volta eliminando la necessità di mixin dei fornitori come quelli che si trovano nella v3.

Manteniamo l'elenco dei browser supportati tramite Autoprefixer in un file separato all'interno del nostro repository GitHub. Vedere /package.json per i dettagli.

Documentazione locale

L'esecuzione della nostra documentazione in locale richiede l'uso di Jekyll, un generatore di siti statici decentemente flessibile che ci fornisce: include di base, file basati su Markdown, modelli e altro ancora. Ecco come iniziare:

  1. Esegui la configurazione degli strumenti sopra per installare Jekyll (il costruttore di siti) e altre dipendenze di Ruby con bundle install.
  2. Dalla /bootstrapdirectory principale, esegui npm run docs-servenella riga di comando.
  3. Apri http://localhost:9001nel tuo browser e voilà.

Scopri di più sull'uso di Jekyll leggendo la sua documentazione .

Risoluzione dei problemi

In caso di problemi con l'installazione delle dipendenze, disinstallare tutte le versioni precedenti delle dipendenze (globale e locale). Quindi, riesegui npm install.