in English

ئامرازەکان دروست بکە

فێربە چۆن سکریپتەکانی npm ی لەخۆگرتووی Bootstrap بەکاربهێنیت بۆ دروستکردنی بەڵگەنامەکانمان، کۆکردنەوەی کۆدی سەرچاوە، جێبەجێکردنی تاقیکردنەوەکان و زۆر شتی تر.

ڕێکخستنی ئامرازەکان

بووتستراپ سکریپتی npm بەکاردەهێنێت بۆ سیستەمی دروستکردنی. package.json ی ئێمە ڕێگەی گونجاوی لەخۆگرتووە بۆ کارکردن لەگەڵ چوارچێوەکە، لەوانە کۆکردنەوەی کۆدەکان، جێبەجێکردنی تاقیکردنەوەکان و زۆر شتی تر.

بۆ بەکارهێنانی سیستەمی دروستکردنمان و بەڕێوەبردنی بەڵگەنامەکانمان بە شێوەیەکی ناوخۆیی، پێویستت بە کۆپییەکی فایلە سەرچاوەییەکانی Bootstrap و Node دەبێت. ئەم هەنگاوانە پەیڕەو بکە و پێویستە ئامادە بیت بۆ ڕۆککردن:

  1. Node.js دابەزێنە و دایبمەزرێنە ، کە ئێمە بەکاری دەهێنین بۆ بەڕێوەبردنی وابەستەییەکانمان.
  2. یان سەرچاوەکانی Bootstrap دابەزێنە یان کۆگای Bootstrap بکە .
  3. بچۆ بۆ /bootstrapبەڕێوەبەرایەتی ڕەگ و ڕابکە npm installبۆ دامەزراندنی وابەستە ناوخۆییەکانمان کە لە package.json دا هاتووە .

کاتێک تەواو بوویت، دەتوانیت ئەو فرمانە جۆراوجۆرانە جێبەجێ بکەیت کە لە هێڵی فەرمانەکەوە پێشکەش کراون.

بەکارهێنانی سکریپتی npm

package.json ی ئێمە ئەم فرمان و ئەرکانەی خوارەوە لەخۆدەگرێت:

ئەرک وەسف
npm run dist npm run dist/dist/بەڕێوەبەرایەتییەکە بە فایلە کۆکراوەکان دروست دەکات . Sass و Autoprefixer و terser بەکاردەهێنێت .
npm test دوای ڕاکردن تاقیکردنەوەکان بە شێوەی ناوخۆیی ئەنجام دەداتnpm run dist
npm run docs-serve بەڵگەنامەکان بە شێوەیەکی ناوخۆیی دروست دەکات و بەڕێوەی دەبات.

ڕاکردن npm runبۆ بینینی هەموو سکریپتەکانی npm.

دەست بکە بە Bootstrap لە ڕێگەی npm لەگەڵ پڕۆژەی دەستپێکەکەمان! سەردانی کۆگای قاڵبی twbs/bootstrap-npm-starter بکە بۆ ئەوەی بزانیت چۆن Bootstrap لە پرۆژەی npm ی خۆتدا دروست بکەیت و خۆکارانە بکەیت. کۆمپایەری Sass و Autoprefixer و Stylelint و PurgeCSS و Bootstrap Icons لەخۆدەگرێت.

ساس

Bootstrap v4 Node Sass بەکاردەهێنێت بۆ کۆکردنەوەی فایلە سەرچاوەییەکانی Sass ی ئێمە بۆ ناو فایلەکانی CSS (لە پرۆسەی دروستکردنماندا هەیە). بۆ ئەوەی کۆتایی بە هەمان CSS دروستکراو بیت لەکاتی کۆمپایڵکردنی Sass بە بەکارهێنانی بۆری سەروەت و سامانی خۆت، پێویستە کۆمپایەرێکی Sass بەکاربهێنیت کە لانیکەم پشتگیری لەو تایبەتمەندیانە بکات کە Node Sass دەیکات. ئەمە گرنگە ئاماژەی پێبدەین چونکە لە ٢٦ی تشرینی یەکەمی ٢٠٢٠ەوە، LibSass و ئەو پاکێجانەی کە لەسەری دروستکراون-لەوانەش Node Sass- بەکارنەهاتوون .

ئەگەر پێویستت بە تایبەتمەندی نوێتری Sass یان گونجان لەگەڵ ستانداردە نوێیەکانی CSS هەیە، ئێستا Dart Sass جێبەجێکردنی سەرەکی Sass ە و پشتگیری لە API ی جاڤاسکڕێپت دەکات کە بە تەواوی لەگەڵ Node Sass دەگونجێت (بە چەند جگەیەک کە لە لاپەڕەی GitHub ی Dart Sass دا هاتووە ).

ئێمە وردی وردکردنی Sass زیاد دەکەین بۆ 6 (بە شێوازی پێشوەختە، لە Node Sass 5 یە) بۆ ڕێگریکردن لە کێشە لە وردکردنی وێبگەڕ. ئەگەر Dart Sass بەکاربهێنیت ئەمە شتێک نابێت کە پێویستە ڕێکبخەیت، چونکە ئەو کۆمپایلەرە وردبینی 10 بەکاردەهێنێت و لەبەر هۆکاری کارایی ڕێگە نادات ڕێکبخرێت.

پێشگرێکی خۆکار

Bootstrap Autoprefixer بەکاردەهێنێت (لە پرۆسەی دروستکردنەکەماندا هەیە) بۆ زیادکردنی پێشگرەکانی فرۆشیار بە شێوەیەکی ئۆتۆماتیکی بۆ هەندێک تایبەتمەندی CSS لە کاتی دروستکردندا. بەم کارە کات و کۆدمان بۆ پاشەکەوت دەکات بە ڕێگەمان پێدەدات بەشە سەرەکییەکانی CSS ـمان یەک جار بنووسین لە هەمان کاتدا پێویستی بە میکسینەکانی فرۆشیار وەک ئەوانەی لە v3 دا دەبینرێن نامێنێت.

ئێمە لیستی ئەو وێبگەڕانەی کە لە ڕێگەی Autoprefixer پشتگیری دەکرێن لە فایلێکی جیاوازدا لەناو کۆگای GitHub ـماندا دەپارێزین. بۆ زانیاری زیاتر سەیری .browserslistrc بکە.

بەڵگەنامەی ناوخۆیی

بەڕێوەبردنی بەڵگەنامەکانمان بە شێوەیەکی ناوخۆیی پێویستی بە بەکارهێنانی Hugo هەیە، کە لە ڕێگەی پاکێجی hugo-bin npm دامەزراوە. هوگۆ مۆلیدەی سایتی ئیستاتیکی خێرا و تەواو فراوانترە کە ئێمە دابین دەکات: بنەڕەتی لەخۆدەگرێت، فایلەکانی بنەمای مارکداون، قاڵبەکان و زۆر شتی تر. لێرەدا چۆنێتی دەستپێکردنی دەخەینەڕوو:

  1. بۆ دامەزراندنی هەموو وابەستەییەکان لە ڕێگەی ڕێکخستنی ئامرازەکانی سەرەوەدا جێبەجێ بکە.
  2. /bootstrapلە ناوەڕۆکی ڕەگەوە npm run docs-serveلە هێڵی فەرمانەکاندا جێبەجێ بکە.
  3. http://localhost:9001/لە وێبگەڕەکەتدا بکەرەوە، و voilà .

زیاتر بزانە دەربارەی بەکارهێنانی هوگۆ بە خوێندنەوەی بەڵگەنامەکانی .

به‌ده‌رخستنی هه‌ڵه‌و چاككردنه‌وه‌ی

ئەگەر تووشی کێشە بوویت لە دامەزراندنی وابەستەییەکان، هەموو وەشانی وابەستەیی پێشوو (جیهانی و ناوخۆیی) هەڵبگرە. پاشان، دووبارە جێبەجێکردنەوە npm install.