Source

Құралдар құрастыру

Құжаттаманы құру, бастапқы кодты құрастыру, сынақтарды іске қосу және т.б. үшін Bootstrap қосылған npm сценарийлерін қалай пайдалану керектігін біліңіз.

Құралдарды орнату

Bootstrap құрастыру жүйесі үшін npm сценарийлерін пайдаланады. Біздің package.json құрылыммен жұмыс істеуге ыңғайлы әдістерді қамтиды, соның ішінде кодты құрастыру, сынақтарды орындау және т.б.

Құрастыру жүйесін пайдалану және құжаттаманы жергілікті түрде іске қосу үшін сізге Bootstrap бастапқы файлдарының және Түйіннің көшірмесі қажет. Мына қадамдарды орындаңыз және сіз шайқауға дайын болуыңыз керек:

  1. Node.js жүктеп алыңыз және орнатыңыз , біз оны тәуелділіктерімізді басқару үшін қолданамыз.
  2. Түбірлік /bootstrapкаталогқа өтіп, package.jsonnpm install ішінде тізімделген жергілікті тәуелділіктерімізді орнату үшін іске қосыңыз .
  3. Ruby орнатыңыз , Bundler көмегімен орнатыңыз gem install bundlerжәне соңында іске қосыңыз bundle install. Бұл Jekyll және плагиндер сияқты барлық Ruby тәуелділіктерін орнатады.
    • Windows пайдаланушылары: Jekyll бағдарламасын еш қиындықсыз іске қосу үшін осы нұсқаулықты оқыңыз .

Аяқтағаннан кейін пәрмен жолынан берілген әртүрлі пәрмендерді іске қоса аласыз.

npm сценарийлерін пайдалану

Біздің package.json келесі пәрмендер мен тапсырмаларды қамтиды:

Тапсырма Сипаттама
npm run dist npm run dist/dist/компиляцияланған файлдармен каталог жасайды . Sass , Autoprefixer және UglifyJS пайдаланады .
npm test Плюс сияқты npm run distол жергілікті сынақтарды жүргізеді
npm run docs Құжаттар үшін CSS және JavaScript құрастырады және сызады. Содан кейін құжаттаманы арқылы жергілікті түрде іске қосуға болады npm run docs-serve.

npm runБарлық npm сценарийлерін көру үшін іске қосыңыз .

Автопрефиксер

Bootstrap құрастыру уақытында кейбір CSS сипаттарына жеткізуші префикстерін автоматты түрде қосу үшін Autoprefixer (құру процесіне кіреді) пайдаланады. Бұл бізге CSS-тің негізгі бөліктерін бір рет жазуға мүмкіндік беру арқылы уақыт пен кодты үнемдейді, сонымен бірге v3-де табылған жеткізушілер миксиндерінің қажеттілігін болдырмайды.

Autoprefixer арқылы қолдау көрсетілетін шолғыштардың тізімін GitHub репозиторийінде бөлек файлда сақтаймыз. Мәліметтерді .browserlistrc қараңыз.

Жергілікті құжаттама

Құжаттамамызды жергілікті түрде іске қосу үшін Jekyll, лайықты икемді статикалық сайт генераторын пайдалану қажет, ол бізге мыналарды ұсынады: негізгі қамтиды, Markdown негізіндегі файлдар, үлгілер және т.б. Оны қалай бастау керек:

  1. Jekyll (сайт құрастырушы) және басқа Ruby тәуелділіктерін орнату үшін жоғарыдағы құралдарды орнату арқылы іске қосыңыз bundle install.
  2. Түбірлік /bootstrapкаталогтан npm run docs-serveпәрмен жолында іске қосыңыз.
  3. http://localhost:9001Браузеріңізде ашыңыз және voilà.

Құжаттарын оқу арқылы Jekyll пайдалану туралы көбірек біліңіз .

Ақаулық себебін іздеу және түзету

Тәуелділіктерді орнату кезінде қиындықтар туындаса, барлық алдыңғы тәуелділік нұсқаларын (жаһандық және жергілікті) жойыңыз. Содан кейін қайта іске қосыңыз npm install.