Mandehana any amin'ny votoaty fototra Mandehana any amin'ny docs navigation
in English

Mandray anjara

Ampio amin'ny fampivoarana Bootstrap amin'ny alàlan'ny fandrafetana ny antontan-taratasy sy ny fitsapana.

Amin'ity pejy ity

Fanamboarana fitaovana

Bootstrap dia mampiasa script npm hanamboarana ny antontan-taratasy sy hanangonana rakitra loharano. Ny package.json dia mametraka ireto script ireto mba hanangonana kaody, fanaovana fitiliana, sy ny maro hafa. Ireo dia tsy natao hampiasaina ivelan'ny fitahirizanay sy ny antontan-taratasy.

Raha hampiasa ny rafitra fananganana sy hampandehanana ny antontan-taratasintsika eo an-toerana ianao dia mila dika mitovy amin'ny rakitra loharanon'i Bootstrap sy ny Node. Araho ireto dingana ireto ary tokony ho vonona amin'ny rock ianao:

  1. Ampidino ary apetraho ny Node.js , izay ampiasainay hitantana ny fiankinanay.
  2. Na alao ny loharanon'i Bootstrap na ny fitehirizan'i Bootstrap .
  3. Mankanesa any amin'ny /bootstraplahatahiry fototra ary mihazakazaka npm installhametraka ny fiankinana eo an-toerana voatanisa ao amin'ny package.json .

Rehefa vita ianao dia afaka manatanteraka ireo baiko isan-karazany omena avy amin'ny tsipika baiko.

Mampiasa script npm

Ny package.json dia ahitana asa maro amin'ny famolavolana ny tetikasa. Mihazakazaha npm runhijery ny script npm rehetra ao amin'ny terminal anao. Ny asa voalohany dia ahitana:

ASA Description
npm start Manangona CSS sy JavaScript, manorina ny antontan-taratasy, ary manomboka mpizara eo an-toerana.
npm run dist Mamorona ny dist/lahatahiry misy rakitra natambatra. Mitaky Sass , Autoprefixer , ary terser .
npm test Manatanteraka fitsapana eo an-toerana aorian'ny fandehanananpm run dist
npm run docs-serve Manorina sy mitantana ny antontan-taratasy eo an-toerana.
Manomboha amin'ny Bootstrap amin'ny alàlan'ny npm miaraka amin'ny tetikasa fanombohana! Mankanesa any amin'ny tranokala môdely twbs/bootstrap-npm-starter mba hahitana ny fomba fananganana sy fanamboarana Bootstrap amin'ny tetikasa npm anao manokana. Ahitana Sass compiler, Autoprefixer, Stylelint, PurgeCSS, ary kisary Bootstrap.

Sass

Bootstrap dia mampiasa Dart Sass amin'ny fanangonana ny rakitra loharano Sass ho rakitra CSS (tafiditra ao anatin'ny dingana fananganana), ary manoro hevitra anao izahay mba hanao toy izany koa raha manangona Sass amin'ny alàlan'ny fantsom-panananao manokana ianao. Nampiasa Node Sass ho an'ny Bootstrap v4 izahay teo aloha, fa ny LibSass sy ny fonosana naorina teo amboniny, anisan'izany ny Node Sass, dia tsy ampiasaina intsony .

Dart Sass dia mampiasa tsipika boribory 10 ary noho ny antony mahomby dia tsy mamela ny fanitsiana an'io sanda io. Tsy ampidininay io fahitsiana io mandritra ny fanodinana bebe kokoa ny CSS novokarinay, toy ny mandritra ny fampihenana, fa raha nisafidy ny hanao izany ianao dia manoro hevitra ny hitazona ny mari-pamantarana farafahakeliny 6 mba hisorohana ny olana amin'ny famandrihana ny navigateur.

Autoprefixer

Bootstrap dia mampiasa Autoprefixer (tafiditra ao anatin'ny dingan'ny fananganana) mba hampidirana tovan'ny mpivarotra ho azy amin'ny fananana CSS sasany amin'ny fotoana fananganana. Ny fanaovana izany dia mitsitsy fotoana sy kaody amin'ny alàlan'ny famelana antsika hanoratra ampahany manan-danja amin'ny CSS-tsika indray mandeha ary manafoana ny filàna mixins mpivarotra toa an'ireo hita ao amin'ny v3.

Izahay dia mitazona ny lisitry ny navigateur tohanana amin'ny alàlan'ny Autoprefixer ao anaty rakitra misaraka ao anatin'ny tahiry GitHub. Jereo ny .browserslistrc raha mila fanazavana fanampiny.

RTLCSS

Bootstrap uses RTLCSS to process compiled CSS and convert them to RTL – basically replacing horizontal direction aware properties (eg. padding-left) with their opposite. It allows us only write our CSS a single time and make minor tweaks using RTLCSS control and value directives.

Local documentation

Running our documentation locally requires the use of Hugo, which gets installed via the hugo-bin npm package. Hugo is a blazingly fast and quite extensible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  1. Run through the tooling setup above to install all dependencies.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001/ in your browser, and voilà.

Learn more about using Hugo by reading its documentation.

Troubleshooting

Should you encounter problems with installing dependencies, uninstall all previous dependency versions (global and local). Then, rerun npm install.