Source

Konstruu ilojn

Lernu kiel uzi la npm-skriptojn de Bootstrap por konstrui nian dokumentaron, kompili fontkodon, ruli testojn kaj pli.

Ilara aranĝo

Bootstrap uzas npm-skriptojn por sia konstrusistemo. Nia package.json inkluzivas oportunajn metodojn por labori kun la kadro, inkluzive de kompili kodon, ruli testojn kaj pli.

Por uzi nian konstrusistemon kaj ruli nian dokumentaron loke, vi bezonos kopion de la fontdosieroj kaj Node de Bootstrap. Sekvu ĉi tiujn paŝojn kaj vi devus esti preta skui:

  1. Elŝutu kaj instalu Node.js , kiun ni uzas por administri niajn dependecojn.
  2. Navigu al la radika /bootstrapdosierujo kaj rulu npm installpor instali niajn lokajn dependecojn listigitajn en package.json .
  3. Instalu Ruby , instalu Bundler kun gem install bundler, kaj fine rulu bundle install. Ĉi tio instalos ĉiujn Ruby-dependaĵojn, kiel Jekyll kaj kromaĵojn.

Kiam vi komplete, vi povos ruli la diversajn komandojn provizitajn de la komandlinio.

Uzante npm-skriptojn

Nia package.json inkluzivas la jenajn komandojn kaj taskojn:

Tasko Priskribo
npm run dist npm run distkreas la /dist/dosierujon kun kompilitaj dosieroj. Uzas Sass , Autoprefixer , kaj UglifyJS .
npm test Same kiel npm run distplus ĝi funkcias testojn loke
npm run docs Konstruas kaj lintigas CSS kaj JavaScript por dokumentoj. Vi povas tiam ruli la dokumentaron loke per npm run docs-serve.

Kuru npm runpor vidi ĉiujn npm-skriptojn.

Aŭtomata prefiksilo

Bootstrap uzas Autoprefixer (inkluzivita en nia konstruprocezo) por aŭtomate aldoni vendistajn prefiksojn al iuj CSS-ecoj je konstrua tempo. Fari tion ŝparas al ni tempon kaj kodon permesante al ni skribi ŝlosilajn partojn de nia CSS unufoje dum vi forigas la bezonon de vendistaj miksaĵoj kiel tiuj trovitaj en v3.

Ni konservas la liston de retumiloj subtenataj per Autoprefixer en aparta dosiero ene de nia GitHub-deponejo. Vidu .browserslistrc por detaloj.

Loka dokumentaro

Prizorgi nian dokumentaron loke postulas la uzon de Jekyll, dece fleksebla senmova generatoro, kiu provizas nin: bazajn inkludojn, Markdown-bazitajn dosierojn, ŝablonojn kaj pli. Jen kiel komenci ĝin:

  1. Trairu la ilan agordon supre por instali Jekyll (la retejo-konstruanto) kaj aliajn Ruby-dependaĵojn kun bundle install.
  2. El la radika /bootstrapdosierujo, rulu npm run docs-serveen la komandlinio.
  3. Malfermu http://localhost:9001en via retumilo, kaj voilà.

Lernu pli pri uzado de Jekyll legante ĝian dokumentadon .

Solvado de problemoj

Se vi renkontas problemojn pri instalado de dependecoj, malinstalu ĉiujn antaŭajn dependecajn versiojn (tutmondajn kaj lokajn). Poste, rerulu npm install.