Source

Paghimo og mga himan

Hibal-i kung giunsa paggamit ang gilakip nga mga script sa npm sa Bootstrap aron matukod ang among dokumentasyon, pag-compile sa source code, pagpadagan sa mga pagsulay, ug uban pa.

Pag-setup sa gamit

Gigamit sa Bootstrap ang mga script sa NPM alang sa sistema sa pagtukod niini. Ang among package.json naglakip sa kombenyente nga mga pamaagi sa pagtrabaho kauban ang framework, lakip ang pag-compile sa code, pagpadagan sa mga pagsulay, ug uban pa.

Aron magamit ang among sistema sa pagtukod ug ipadagan ang among dokumentasyon sa lokal, kinahanglan nimo ang usa ka kopya sa mga gigikanan nga file sa Bootstrap ug Node. Sunda kini nga mga lakang ug kinahanglan nga andam ka sa pag-rock:

  1. I-download ug i-install ang Node.js , nga among gigamit sa pagdumala sa among mga dependency.
  2. Pagdala ngadto sa root /bootstrapdirectory ug pagdagan npm installaron i-install ang among mga lokal nga dependency nga gilista sa package.json .
  3. I-install ang Ruby , i-install ang Bundler gamit ang gem install bundler, ug sa katapusan pagdagan bundle install. Kini mag-install sa tanan nga mga dependency sa Ruby, sama sa Jekyll ug mga plugins.
    • Mga tiggamit sa Windows: Basaha kini nga giya aron mapaandar si Jekyll nga walay mga problema.

Kung nahuman na, mahimo nimong ipadagan ang lainlaing mga mando nga gihatag gikan sa linya sa mando.

Paggamit sa mga script sa NPM

Ang among package.json naglakip sa mosunod nga mga sugo ug mga buluhaton:

Buluhaton Deskripsyon
npm run dist npm run distnaghimo sa /distdirektoryo nga adunay mga gihugpong nga mga file. Gigamit ang Sass , Autoprefixer , ug UglifyJS .
npm test Sama sa npm run distplus kini nagpadagan sa mga pagsulay sa lokal
npm run docs Nagtukod ug naglinya sa CSS ug JavaScript para sa mga doc. Mahimo nimong ipadagan ang dokumentasyon sa lokal pinaagi sa npm run docs-serve.

Pagdagan npm runaron makita ang tanan nga mga script sa npm.

Autoprefixer

Gigamit sa Bootstrap ang Autoprefixer (apil sa among proseso sa pagtukod) aron awtomatikong idugang ang mga prefix sa vendor sa pipila ka mga kabtangan sa CSS sa oras sa pagtukod. Ang pagbuhat sa ingon makadaginot kanamo sa oras ug code pinaagi sa pagtugot kanamo sa pagsulat sa hinungdanon nga mga bahin sa among CSS sa usa ka higayon samtang giwagtang ang panginahanglan alang sa mga mixin sa vendor sama sa nakit-an sa v3.

Gipadayon namo ang listahan sa mga browser nga gisuportahan pinaagi sa Autoprefixer sa usa ka bulag nga file sulod sa among GitHub repository. Tan-awa ang /.browserslistrc para sa mga detalye.

Lokal nga dokumentasyon

Ang pagpadagan sa among lokal nga dokumentasyon nanginahanglan sa paggamit sa Jekyll, usa ka desente nga flexible static nga generator sa site nga naghatag kanamo: sukaranan nga naglakip, mga file nga nakabase sa Markdown, template, ug uban pa. Ania kung giunsa kini pagsugod:

  1. Pagdalagan pinaagi sa pag-setup sa tooling sa ibabaw aron i-install ang Jekyll (ang tigtukod sa site) ug uban pang mga dependency sa Ruby nga adunay bundle install.
  2. Gikan sa root /bootstrapdirectory, pagdagan npm run docs-servesa command line.
  3. Ablihi http://localhost:9001sa imong browser, ug voilà.

Pagkat-on og dugang mahitungod sa paggamit sa Jekyll pinaagi sa pagbasa sa dokumentasyon niini .

Pag-troubleshoot

Kung makasugat ka ug mga problema sa pag-install sa mga dependency, i-uninstall ang tanan nga mga naunang bersyon sa dependency (global ug lokal). Unya, ipadayon pag-usab npm install.