Құралдар құрастыру
Құжаттаманы құру, бастапқы кодты құрастыру, сынақтарды іске қосу және т.б. үшін Bootstrap қосылған npm сценарийлерін қалай пайдалану керектігін біліңіз.
Bootstrap құрастыру жүйесі үшін NPM сценарийлерін пайдаланады. Біздің package.json құрылыммен жұмыс істеуге ыңғайлы әдістерді қамтиды, соның ішінде кодты құрастыру, сынақтарды орындау және т.б.
Құрастыру жүйесін пайдалану және құжаттаманы жергілікті түрде іске қосу үшін сізге Bootstrap бастапқы файлдарының және Түйіннің көшірмесі қажет. Мына қадамдарды орындаңыз және сіз шайқауға дайын болуыңыз керек:
- Node.js жүктеп алыңыз және орнатыңыз , біз оны тәуелділіктерімізді басқару үшін қолданамыз.
- Түбірлік
/bootstrapкаталогқа өтіп, package.jsonnpm installішінде тізімделген жергілікті тәуелділіктерімізді орнату үшін іске қосыңыз . - Ruby орнатыңыз , Bundler көмегімен орнатыңыз
gem install bundlerжәне соңында іске қосыңызbundle install. Бұл Jekyll және плагиндер сияқты барлық Ruby тәуелділіктерін орнатады.- Windows пайдаланушылары: Jekyll бағдарламасын еш қиындықсыз іске қосу үшін осы нұсқаулықты оқыңыз .
Аяқтағаннан кейін пәрмен жолынан берілген әртүрлі пәрмендерді іске қоса аласыз.
Біздің 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 репозиторийінде бөлек файлда сақтаймыз. Мәліметтерді /package.json қараңыз.
Құжаттамамызды жергілікті түрде іске қосу үшін Jekyll, лайықты икемді статикалық сайт генераторын пайдалану қажет, ол бізге мыналарды ұсынады: негізгі қамтиды, Markdown негізіндегі файлдар, үлгілер және т.б. Оны қалай бастау керек:
- Jekyll (сайт құрастырушы) және басқа Ruby тәуелділіктерін орнату үшін жоғарыдағы құралдарды орнату арқылы іске қосыңыз
bundle install. - Түбірлік
/bootstrapкаталогтанnpm run docs-serveпәрмен жолында іске қосыңыз. http://localhost:9001Браузеріңізде ашыңыз және voilà.
Құжаттарын оқу арқылы Jekyll пайдалану туралы көбірек біліңіз .
Тәуелділіктерді орнату кезінде қиындықтар туындаса, барлық алдыңғы тәуелділік нұсқаларын (жаһандық және жергілікті) жойыңыз. Содан кейін қайта іске қосыңыз npm install.