Source

ສ້າງເຄື່ອງມື

ຮຽນຮູ້ວິທີການໃຊ້ສະຄຣິບ npm ທີ່ລວມຢູ່ຂອງ Bootstrap ເພື່ອສ້າງເອກະສານຂອງພວກເຮົາ, ລວບລວມລະຫັດແຫຼ່ງ, ການທົດສອບ, ແລະອື່ນໆ.

ການ​ຕັ້ງ​ຄ່າ​ເຄື່ອງ​ມື​

Bootstrap ໃຊ້ NPM scripts ສໍາລັບລະບົບການກໍ່ສ້າງຂອງມັນ. package.json ຂອງພວກເຮົາ ປະກອບມີວິທີການທີ່ສະດວກໃນການເຮັດວຽກກັບກອບ, ລວມທັງການລວບລວມລະຫັດ, ການທົດສອບແລ່ນ, ແລະອື່ນໆ.

ເພື່ອນໍາໃຊ້ລະບົບການກໍ່ສ້າງຂອງພວກເຮົາແລະດໍາເນີນການເອກະສານຂອງພວກເຮົາຢູ່ໃນທ້ອງຖິ່ນ, ທ່ານຈະຕ້ອງການສໍາເນົາຂອງໄຟລ໌ຕົ້ນສະບັບຂອງ Bootstrap ແລະ Node. ປະຕິບັດຕາມຂັ້ນຕອນເຫຼົ່ານີ້ແລະທ່ານຄວນກຽມພ້ອມທີ່ຈະ rock:

  1. ດາວໂຫຼດ ແລະຕິດຕັ້ງ Node.js , ທີ່ພວກເຮົາໃຊ້ເພື່ອຈັດການການຂຶ້ນກັບຂອງພວກເຮົາ.
  2. ທ່ອງໄປຫາໄດເລກະທໍລີຮາກ /bootstrapແລະແລ່ນ npm installເພື່ອຕິດຕັ້ງການຂື້ນກັບທ້ອງຖິ່ນຂອງພວກເຮົາທີ່ລະບຸໄວ້ໃນ package.json .
  3. ຕິດຕັ້ງ Ruby , ຕິດຕັ້ງ Bundler ກັບ gem install bundler, ແລະສຸດທ້າຍດໍາເນີນການ bundle install. ນີ້ຈະຕິດຕັ້ງການຂຶ້ນກັບ Ruby ທັງຫມົດ, ເຊັ່ນ Jekyll ແລະ plugins.
    • ຜູ້​ໃຊ້ Windows​: ອ່ານ ​ຄູ່​ມື​ນີ້ ​ເພື່ອ​ໃຫ້ Jekyll ຂຶ້ນ​ແລະ​ແລ່ນ​ໂດຍ​ບໍ່​ມີ​ບັນ​ຫາ​.

ເມື່ອສໍາເລັດ, ທ່ານຈະສາມາດດໍາເນີນການຄໍາສັ່ງຕ່າງໆທີ່ສະຫນອງໃຫ້ຈາກເສັ້ນຄໍາສັ່ງ.

ໃຊ້ NPM scripts

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 ໃຊ້ Autoprefixer (ລວມຢູ່ໃນຂະບວນການສ້າງຂອງພວກເຮົາ) ເພື່ອເພີ່ມຄໍານໍາຫນ້າຂອງຜູ້ຂາຍໂດຍອັດຕະໂນມັດກັບບາງຄຸນສົມບັດ CSS ໃນເວລາສ້າງ. ການເຮັດດັ່ງນັ້ນຊ່ວຍປະຢັດເວລາແລະລະຫັດຂອງພວກເຮົາໂດຍການອະນຸຍາດໃຫ້ພວກເຮົາຂຽນສ່ວນທີ່ສໍາຄັນຂອງ CSS ຂອງພວກເຮົາໃນເວລາດຽວໃນຂະນະທີ່ກໍາຈັດຄວາມຕ້ອງການຂອງຜູ້ຈໍາຫນ່າຍ mixins ຄືກັບທີ່ພົບໃນ v3.

ພວກເຮົາຮັກສາບັນຊີລາຍຊື່ຂອງຕົວທ່ອງເວັບທີ່ສະຫນັບສະຫນູນໂດຍຜ່ານ Autoprefixer ໃນໄຟລ໌ແຍກຕ່າງຫາກພາຍໃນບ່ອນເກັບມ້ຽນ GitHub ຂອງພວກເຮົາ. ເບິ່ງ /package.json ສໍາລັບລາຍລະອຽດ.

ເອກະສານທ້ອງຖິ່ນ

ການດໍາເນີນການເອກະສານຂອງພວກເຮົາຢູ່ໃນທ້ອງຖິ່ນຮຽກຮ້ອງໃຫ້ມີການນໍາໃຊ້ຂອງ Jekyll, ເປັນຕົວສ້າງເວັບໄຊທ໌ຄົງທີ່ທີ່ມີຄວາມຍືດຫຍຸ່ນທີ່ເຫມາະສົມທີ່ສະຫນອງໃຫ້ພວກເຮົາ: ພື້ນຖານປະກອບມີ, ໄຟລ໌ທີ່ອີງໃສ່ Markdown, ແມ່ແບບ, ແລະອື່ນໆ. ນີ້ແມ່ນວິທີການເລີ່ມຕົ້ນມັນ:

  1. ດໍາເນີນການຜ່ານການ ຕິດຕັ້ງເຄື່ອງມື ຂ້າງເທິງເພື່ອຕິດຕັ້ງ Jekyll (ຕົວສ້າງເວັບໄຊທ໌) ແລະການຂຶ້ນກັບ Ruby ອື່ນໆທີ່ມີ bundle install.
  2. /bootstrapຈາກໄດເລກະ ທໍລີ ຮາກ , ດໍາເນີນການ npm run docs-serveໃນເສັ້ນຄໍາສັ່ງ.
  3. ເປີດ http://localhost:9001ໃນຕົວທ່ອງເວັບຂອງທ່ານ, ແລະvoilà.

ຮຽນຮູ້ເພີ່ມເຕີມກ່ຽວກັບການໃຊ້ Jekyll ໂດຍການອ່ານ ເອກະສານ ຂອງມັນ .

ການແກ້ໄຂບັນຫາ

ຖ້າເຈົ້າພົບບັນຫາກັບການຕິດຕັ້ງ dependency, ຖອນການຕິດຕັ້ງທຸກລຸ້ນທີ່ຂຶ້ນກັບກ່ອນໜ້ານີ້ (ທົ່ວໂລກ ແລະທ້ອງຖິ່ນ). ຫຼັງ​ຈາກ​ນັ້ນ​, rerun npm install.