Source

Rakenna työkaluja

Opi käyttämään Bootstrapin mukana tulevia npm-skriptejä dokumentaation rakentamiseen, lähdekoodin kääntämiseen, testien suorittamiseen ja muuhun.

Työkalujen asennus

Bootstrap käyttää NPM-skriptejä rakennusjärjestelmässään. Meidän package.json sisältää käteviä menetelmiä kehyksen kanssa työskentelyyn, mukaan lukien koodin kääntäminen, testien suorittaminen ja paljon muuta.

Tarvitset kopion Bootstrapin lähdetiedostoista ja Nodesta, jotta voit käyttää rakennusjärjestelmäämme ja suorittaa dokumentaatiomme paikallisesti. Noudata näitä ohjeita ja sinun pitäisi olla valmis rokkaamaan:

  1. Lataa ja asenna Node.js , jota käytämme riippuvuutemme hallintaan.
  2. Siirry juurihakemistoon /bootstrapja suorita npm installasentaaksesi paketti.jsonissa luetellut paikalliset riippuvuutemme .
  3. Asenna Ruby , asenna Bundler ja gem install bundlersuorita lopuksi bundle install. Tämä asentaa kaikki Ruby-riippuvuudet, kuten Jekyll ja laajennukset.
    • Windows-käyttäjät: Lue tämä opas saadaksesi Jekyllin käyttöön ilman ongelmia.

Kun olet valmis, voit suorittaa erilaisia ​​komentoriviltä annettuja komentoja.

NPM-skriptien käyttö

Meidän package.json sisältää seuraavat komennot ja tehtävät:

Tehtävä Kuvaus
npm run dist npm run distluo /disthakemiston käännetyillä tiedostoilla. Käyttää Sassia , Autoprefixeria ja UglifyJS :ää .
npm test Sama kuin npm run distplus se suorittaa testejä paikallisesti
npm run docs Rakentaa ja yhdistää CSS:n ja JavaScriptin asiakirjoille. Voit sitten suorittaa dokumentaation paikallisesti npm run docs-serve.

Suorita npm runnähdäksesi kaikki npm-skriptit.

Automaattinen etuliite

Bootstrap käyttää Autoprefixeria (sisältyy rakennusprosessiimme) lisätäkseen automaattisesti toimittajan etuliitteet joihinkin CSS-ominaisuuksiin rakennusvaiheessa. Näin säästämme aikaa ja koodia, koska voimme kirjoittaa CSS:n tärkeimmät osat yhdellä kertaa, samalla kun v3:n kaltaisia ​​toimittajasekoituksia ei tarvita.

Ylläpidämme luetteloa Autoprefixerin kautta tuetuista selaimista erillisessä tiedostossa GitHub-arkistossamme. Katso lisätietoja osoitteesta /package.json .

Paikallinen dokumentaatio

Dokumentaation suorittaminen paikallisesti edellyttää Jekyllin käyttöä, kohtuullisen joustavaa staattista sivustogeneraattoria, joka tarjoaa meille: perussisällöt, Markdown-pohjaiset tiedostot, mallit ja paljon muuta. Näin pääset alkuun:

  1. Suorita yllä olevat työkaluasetukset ja asenna Jekyll (sivuston rakentaja) ja muut Ruby-riippuvuudet bundle install.
  2. /bootstrapSuorita juurihakemistosta npm run docs-servekomentorivillä.
  3. Avaa http://localhost:9001selaimessasi ja voilà.

Lue lisää Jekyllin käytöstä lukemalla sen dokumentaatio .

Ongelmien karttoittaminen

Jos sinulla on ongelmia riippuvuuksien asennuksessa, poista kaikki aiemmat riippuvuusversiot (globaalit ja paikalliset). Suorita sitten uudelleen npm install.