ວິທີແກ້ໄຂໄຟລ໌ເທິງສ່ວນຕິດຕໍ່ຜູ້ໃຊ້ເວັບ Pagure

Hanku Lee Version F33 and newer Last review: 2023-04-18
Many of the repositories have now been migrated to Fedora Forge. See the updated Edit a single page in Forge guide.

ພາກສ່ວນນີ້ອະທິບາຍວິທີການປະກອບສ່ວນເຂົ້າໃນເອກະສານທີ່ມີຢູ່ແລ້ວ - ນັ້ນຄື ເອກະສານທີ່ໄດ້ຖືກເຜີຍແຜ່ລົງໃນເວັບໄຊແລ້ວ. ກ່ອນທີ່ທ່ານຈະເລີ່ມປະຕິບັດຕາມຂັ້ນຕອນນີ້, ໃຫ້ແນ່ໃຈວ່າທ່ານໄດ້ປະຕິບັດຕາມຂໍ້ກຳນົດທັງໝົດທີ່ລະບຸໄວ້ໃນ ສິ່ງທີ່ຕ້ອງມີກ່ອນ.

ຖ້າທ່ານສົນໃຈທີ່ຈະປະກອບສ່ວນເຂົ້າໃນ ບັນທຶກການປ່ອຍ (Release Notes), ໃຫ້ເບິ່ງ ໜ້າທີ່ກ່ຽວຂ້ອງ.

ແຕ່ລະໜ້າຂອງ Fedora Docs ຈະມີລິ້ງ "ແກ້ໄຂໜ້ານີ້" ຢູ່ທາງດ້ານເທິງ. ສຳລັບການອັບເດດແບບງ່າຍໆ, ການປ່ຽນແປງສາມາດສົ່ງໄດ້ໂດຍກົງຈາກເວັບອິນເຕີເຟສຂອງ Pagure. ສຳລັບການແກ້ໄຂທີ່ໃຫຍ່ ຫຼື ຊັບຊ້ອນກວ່າ, ທ່ານຄວນກຽມ ແລະ ທົດສອບການປ່ຽນແປງຂອງທ່ານແບບອອບໄລນ໌ກ່ອນທີ່ຈະສົ່ງ.

ການແກ້ໄຂແບບອອນໄລນ໌ໃນ Pagure

  1. ຄລິກທີ່ລິ້ງ "ແກ້ໄຂໜ້ານີ້" ເພື່ອໂຫລດຊອດໂຄດ (source) ຂອງເອກະສານ. ທ່ານຈະຖືກນຳໄປຫາຄັງເກັບເນື້ອຫາທີ່ກ່ຽວຂ້ອງໃນ Pagure.

  2. ຢູ່ເທິງລາຍການຊອດໂຄດທາງດ້ານຂວາມື, ໃຫ້ຄລິກ "Fork and Edit". (ຖ້າທ່ານໄດ້ທຳການ fork ຄັງເກັບໄວ້ແລ້ວ, ປຸ່ມນີ້ຈະສະແດງຂໍ້ຄວາມວ່າ "Edit in your fork" ແລະ ທ່ານສາມາດຂ້າມໄປຂັ້ນຕອນຕໍ່ໄປໄດ້ເລີຍ.)

    1. ຖ້າທ່ານຍັງບໍ່ໄດ້ເຂົ້າສູ່ລະບົບ Pagure, ທ່ານຈະຖືກຖາມຫາຂໍ້ມູນປະຈຳຕົວຂອງທ່ານ.

    2. ລໍຖ້າໃຫ້ການດຳເນີນການສິ້ນສຸດລົງ. ທ່ານອາດຈະຕ້ອງໄດ້ໂຫລດໜ້າເວັບຄືນໃໝ່ (refresh) ເນື່ອງຈາກມັນບໍ່ໄດ້ອັບເດດໂດຍອັດຕະໂນມັດສະເໝີໄປເມື່ອຂະບວນການສຳເລັດ.

  3. ເມື່ອໄຟລ໌ຖືກໂຫລດເຂົ້າໃນ fork ຂອງທ່ານແລ້ວ, ໃຫ້ທຳການປ່ຽນແປງເນື້ອຫາທີ່ຈຳເປັນ, ຄອມມິດ (commit) ພວກມັນເຂົ້າໃນ fork ຂອງທ່ານ, ແລະ ກຽມຄຳຮ້ອງຂໍດຶງຂໍ້ມູນ (pull request - PR).

    1. ແຕ່ລະ PR ຄວນຖືກສົ່ງມາຈາກບຣານ (branch) ຂອງມັນເອງໃນຄັງເກັບຂອງທ່ານ. ພາຍໃຕ້ຫົວຂໍ້ "Branch" ຂອງອິນເຕີເຟສການຄອມມິດ, ໃຫ້ເລືອກ "New branch" ແລະ ຕັ້ງຊື່ບຣານໃຫ້ສັ້ນ ແລະ ບໍ່ຊໍ້າໃຜ.

    2. ຕື່ມແບບຟອມຂໍ້ຄວາມຄອມມິດ (commit message).

    3. ຄລິກ "Commit changes" ເພື່ອສ້າງບຣານ ແລະ ບັນທຶກການປ່ຽນແປງເຫຼົ່ານີ້ເຂົ້າໃນ fork ຂອງທ່ານ.

  4. ເມື່ອການຄອມມິດຖືກບັນທຶກແລ້ວ, ໜ້າເວັບຈະໂຫລດຄືນໃໝ່ໄປຫາລາຍການ Commits ສຳລັບ fork ຂອງທ່ານ.

  5. ເພື່ອເພີ່ມການປ່ຽນແປງອື່ນໆທີ່ກ່ຽວຂ້ອງ, ໃຫ້ເຮັດຄືນຂັ້ນຕອນນີ້ ແລະ ຄອມມິດພວກມັນລົງໃນບຣານດຽວກັນ.

  6. ເມື່ອທ່ານພ້ອມແລ້ວ, ໃຫ້ຄລິກ "Create pull request" ແລະ ຕື່ມແບບຟອມ PR ເພື່ອສົ່ງບຣານຂອງທ່ານໄປຫາຄັງເກັບຕົ້ນທາງ (upstream).

ເຄັດລັບການຄອມມິດ Git

  • ເມື່ອຕັ້ງຊື່ບຣານຂອງທ່ານ, ໃຫ້ໃຊ້ສະເພາະຕົວອັກສອນ ASCII, ຕົວເລກ, ເຄື່ອງໝາຍຂີດຕໍ່ (-) ແລະ ເຄື່ອງໝາຍຂີດກ້ອງ (_). ຊື່ ອາດຈະ ມີເຄື່ອງໝາຍຈໍ້າ (.) ພຽງອັນດຽວໄດ້, ແຕ່ຫ້າມຂຶ້ນຕົ້ນ ຫຼື ລົງທ້າຍດ້ວຍຈໍ້າ. ຫ້າມໃຊ້ຍະຫວ່າງ, ຈໍ້າສອງອັນ (..), ແລະ ເຄື່ອງໝາຍວັກຕອນສ່ວນໃຫຍ່ອື່ນໆ.

  • ຫົວຂໍ້ການຄອມມິດແມ່ນວິທີທີ່ການແກ້ໄຂຂອງທ່ານຈະຖືກລະບຸໃນບັນທຶກ (log) ຂອງຄັງເກັບສຳລັບໜ້ານັ້ນ. ຫົວຂໍ້ທີ່ແນະນຳ, "Update pathname", ແມ່ນພຽງພໍແລ້ວສຳລັບການແກ້ໄຂເລັກນ້ອຍ. ສຳລັບຄຳແນະນຳກ່ຽວກັບການຂຽນຂໍ້ຄວາມຄອມມິດທີ່ດີ, ໃຫ້ເບິ່ງ commit.style ໂດຍ Tim Pope (ຜູ້ສ້າງ vim).

  • ໃຊ້ຊ່ອງ "Commit Description" ເພື່ອໃຫ້ລາຍລະອຽດເພີ່ມເຕີມຖ້າຈຳເປັນ, ແຕ່ໃຫ້ຂຽນສັ້ນໆ. ທ່ານຈະມີໂອກາດອະທິບາຍ ຫຼື ສົນທະນາກ່ຽວກັບການປ່ຽນແປງຂອງທ່ານເມື່ອທ່ານສົ່ງ PR.

ການແກ້ໄຂແບບອອບໄລນ໌

  1. ຄລິກທີ່ລິ້ງ "ແກ້ໄຂໜ້ານີ້" ເພື່ອໂຫລດຊອດໂຄດຂອງເອກະສານ. ທ່ານຈະຖືກນຳໄປຫາຄັງເກັບເນື້ອຫາທີ່ກ່ຽວຂ້ອງໃນ Pagure. ເມື່ອທ່ານພົບຄັງເກັບທີ່ຖືກຕ້ອງແລ້ວ, ໃຫ້ເຮັດການ fork ຖ້າທ່ານຍັງບໍ່ມີ fork ຂອງມັນເທື່ອ:

    1. ຢູ່ມຸມຂວາເທິງ, ໃຫ້ຄລິກ Fork.

    2. ຖ້າທ່ານຍັງບໍ່ໄດ້ເຂົ້າສູ່ລະບົບ Pagure, ທ່ານຈະຖືກຖາມຫາຂໍ້ມູນປະຈຳຕົວຂອງທ່ານ.

    3. ລໍຖ້າໃຫ້ການດຳເນີນການສິ້ນສຸດລົງ. ທ່ານອາດຈະຕ້ອງໄດ້ໂຫລດໜ້າເວັບຄືນໃໝ່ ເນື່ອງຈາກມັນບໍ່ໄດ້ອັບເດດໂດຍອັດຕະໂນມັດສະເໝີໄປເມື່ອຂະບວນການສຳເລັດ.

    4. ໂຄລນ (Clone) fork ຂອງທ່ານ.

  2. ເຊັກເອົາ (Check out) ບຣານໃໝ່, ແລະ ເພີ່ມການປະກອບສ່ວນຂອງທ່ານ.

  3. ຖ້າທ່ານເພີ່ມໄຟລ໌ໃໝ່ໃດໆ, ໃຫ້ແນ່ໃຈວ່າພວກມັນຖືກລວມເຂົ້າໃນຕຳແໜ່ງທີ່ເໝາະສົມໃນໄຟລ໌ກຳນົດຄ່າ nav.adoc ຂອງຄັງເກັບ.

  4. ບິວລ໌ (Build) ຢູ່ໃນເຄື່ອງຂອງທ່ານເອງ ແລະ ກວດເບິ່ງໃຫ້ແນ່ໃຈວ່າທຸກຢ່າງເບິ່ງຄືກັບທີ່ທ່ານຄາດຫວັງ. ເບິ່ງ ການບິວລ໌ຕົວຢ່າງພາຍໃນເຄື່ອງ ສຳລັບຄຳແນະນຳ.

  5. ເມື່ອທ່ານເຮັດສຳເລັດແລ້ວ, ໃຫ້ຄອມມິດການປ່ຽນແປງຂອງທ່ານ ແລະ ພຸຊ (push) ພວກມັນໄປຫາ fork ຂອງທ່ານ.

  6. ໃຊ້ Pagure ເພື່ອສ້າງຄຳຮ້ອງຂໍດຶງຂໍ້ມູນ (pull request) ຈາກ fork ຂອງທ່ານໄປຫາບຣານ master ຂອງຄັງເກັບຫຼັກ.

ການຈັດການຄຳຮ້ອງຂໍດຶງຂໍ້ມູນຂອງທ່ານ

ຈະມີຄົນເຫັນຄຳຮ້ອງຂໍດຶງຂໍ້ມູນຂອງທ່ານ ແລະ ຈະທຳການລວມ (merge) ມັນ ຫຼື ໃຫ້ຄຳຄິດເຫັນຖ້າມີບາງຢ່າງທີ່ທ່ານຄວນປ່ຽນແປງ. ໃຫ້ປະສານງານກັບຜູ້ທີ່ໃຫ້ຄຳເຫັນເພື່ອໃຫ້ແນ່ໃຈວ່າການປະກອບສ່ວນຂອງທ່ານໄດ້ມາດຕະຖານ.

ຖ້າບໍ່ມີໃຜຕອບຮັບຄຳຮ້ອງຂໍດຶງຂໍ້ມູນຂອງທ່ານພາຍໃນຫຼາຍມື້, ໃຫ້ລອງຍົກເລື່ອງນີ້ຂຶ້ນໃນ ການປະຊຸມປະຈຳອາທິດ, ຊ່ອງ Matrix (#docs ໃນ Fedora Chat), ຫຼື ຟໍຣຳ.

ການປ່ຽນແປງຂອງທ່ານຈະປາກົດຂຶ້ນທາງອອນລາຍ ຫຼັງຈາກທີ່ຄຳຮ້ອງຂໍດຶງຂໍ້ມູນ (pull request) ຖືກຮວມເຂົ້າກັນແລ້ວ. ເວັບໄຊນີ້ແມ່ນໄດ້ຮັບການປັບປຸງໃໝ່ໃນທຸກໆຊົ່ວໂມງ.ຖ້າຫາກການປ່ຽນແປງຂອງທ່ານບໍ່ປາກົດຂຶ້ນທາງອອນລາຍພາຍໃນ 24 ຊົ່ວໂມງ ຫຼັງຈາກທີ່ PR ຂອງທ່ານຖືກຮວມເຂົ້າກັນແລ້ວ, ໃຫ້ສົ່ງຂໍ້ຄວາມຫາ asamalik (Adam Šamalík) ຜ່ານຊ່ອງທາງ IRC ແລະ ສອບຖາມລາວກ່ຽວກັບເລື່ອງນີ້.

Want to help? Learn how to contribute to Fedora Docs ›