มีส่วนร่วมโดยใช้ GitHub Codespaces

GitHub มีฟีเจอร์ที่เรียกว่า Codespaces ที่คุณสามารถใช้สนับสนุนเอกสาร PowerShell โดยไม่ต้องติดตั้งหรือกำหนดค่าซอฟต์แวร์ใดๆ ในเครื่อง เมื่อคุณใช้โค้ดสเปซ คุณจะได้รับเครื่องมือการเขียนแบบเดียวกับที่ทีมใช้สำหรับการเขียนและการแก้ไข

คุณสามารถใช้โค้ดสเปซในเบราว์เซอร์ของคุณ โดยให้การสนับสนุนใน VS Code ที่โฮสต์ผ่านอินเทอร์เน็ต หากคุณได้ติดตั้ง VS Code ไว้ในเครื่องแล้ว คุณสามารถเชื่อมต่อกับ Codespace ที่นั่นได้เช่นกัน

เครื่องมือที่มีอยู่

เมื่อคุณใช้โค้ดสเปซเพื่อสนับสนุนเอกสาร PowerShell ตัวแก้ไขของคุณจะมีเครื่องมือเหล่านี้พร้อมให้คุณใช้งานแล้ว:

• Markdownlint สำหรับตรวจสอบไวยากรณ์ Markdown ของคุณ
• cSpell สำหรับตรวจสอบการสะกดของคุณ
• Vale สำหรับตรวจสอบร้อยแก้วของคุณ
• ชุดการเรียนรู้การเขียนสำหรับการแทรกไวยากรณ์เฉพาะแพลตฟอร์ม ดูตัวอย่างการมีส่วนร่วมของคุณ และอื่นๆ อีกมากมาย
• ส่วนขยาย Reflow Markdown สำหรับการรวม Markdown ของคุณตามต้องการ ทำให้การอ่านและแก้ไขง่ายขึ้น
• ส่วนขยายตัวจัดรูปแบบตารางเพื่อทำให้ตารางของคุณอ่านง่ายขึ้นโดยไม่ต้องจัดแนวคอลัมน์ด้วยตนเอง
• ส่วนขยายกรณีการเปลี่ยนแปลงสำหรับการแปลงส่วนหัวและร้อยแก้วของคุณ
• ส่วนขยาย GitLens สำหรับตรวจสอบการเปลี่ยนแปลงไฟล์ในอดีต
• ส่วนขยาย PowerShell สำหรับการโต้ตอบการเขียนตัวอย่าง PowerShell
• ตัวติดตาม Gremlins สำหรับ Visual Studio Code สำหรับค้นหาอักขระที่มีปัญหาใน Markdown ของคุณ

ค่าใช้จ่าย

GitHub Codespaces สามารถใช้งานได้ฟรีสูงสุด 120 ชั่วโมงคอร์ต่อเดือน ด้วยการกำหนดค่าที่เราแนะนำในบทความนี้ นั่นหมายถึงการใช้งานฟรีสูงสุด 60 ชั่วโมงต่อเดือน การใช้งานรายเดือนจะถูกคำนวณจากที่เก็บข้อมูลทั้งหมดของคุณ ไม่ใช่แค่เอกสารประกอบ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับราคา โปรดดูเกี่ยวกับการเรียกเก็บเงินสำหรับ GitHub Codespaces

การสร้างโค้ดสเปซ GitHub ของคุณ

หากต้องการสร้าง GitHub Codespace ของคุณเพื่อสนับสนุนเอกสาร PowerShell ให้ทำตามขั้นตอนเหล่านี้:

1. เปิด https://github.com/codespaces ในเบราว์เซอร์ของคุณ
2. เลือกปุ่ม "พื้นที่โค้ดใหม่" ที่ด้านบนขวาของหน้า
3. ในหน้า "สร้างโค้ดสเปซใหม่" ให้เลือกปุ่ม "เลือกที่เก็บ" และพิมพ์ชื่อของที่เก็บที่คุณต้องการมีส่วนร่วม เช่น MicrosoftDocs/PowerShell-Docs
4. ปล่อยให้การตั้งค่าอื่นๆ ทั้งหมดเป็นค่าเริ่มต้น
5. เลือกปุ่ม "สร้างโค้ดสเปซ"

หลังจากทำตามขั้นตอนเหล่านี้ GitHub จะสร้างโค้ดสเปซใหม่สำหรับพื้นที่เก็บข้อมูลนั้นและตั้งค่าให้กับคุณ เมื่อโค้ดสเปซพร้อม เพจจะรีเฟรชและแสดง UI ของโปรแกรมแก้ไขเว็บสำหรับโค้ดสเปซ UI นั้นใช้ VS Code และทำงานในลักษณะเดียวกัน

กำลังเปิด Codespace ของ GitHub

หากต้องการเปิด GitHub Codespace ในเบราว์เซอร์ ให้ทำตามขั้นตอนเหล่านี้:

1. เปิด https://github.com/codespaces ในเบราว์เซอร์ของคุณ
2. หน้านี้แสดงรายการโค้ดสเปซของคุณ ค้นหาโค้ดสเปซที่สร้างขึ้นสำหรับที่เก็บที่คุณต้องการมีส่วนร่วมและเลือก

หลังจากที่คุณเลือกโค้ดสเปซแล้ว GitHub จะเปิดขึ้นมาในหน้าต่างเดียวกัน จากที่นี่ คุณก็พร้อมที่จะมีส่วนร่วมแล้ว

หากต้องการเปิด GitHub Codespace ใน VS Code ให้ทำตามขั้นตอนใน การใช้ GitHub Codespaces ใน Visual Studio Code

การเขียนใน GitHub Codespace ของคุณ

เมื่อคุณเปิด GitHub Codespace ในเบราว์เซอร์หรือ VS Code แล้ว การมีส่วนร่วมในเอกสารจะเป็นไปตามกระบวนการเดียวกัน

ส่วนที่เหลือของบทความนี้จะอธิบายงานต่างๆ ที่คุณสามารถทำได้ใน GitHub Codespace ขณะเขียนหรือแก้ไขการสนับสนุนของคุณ

แยกลิงก์อ้างอิง

เมื่อคุณต้องการเปลี่ยนลิงก์แบบอินไลน์ เช่น [ข้อความบางส่วน](destination.md) ให้เป็นลิงก์อ้างอิง เช่น [ข้อความบางส่วน][01] ให้เลือกลิงก์ ปลายทางในตัวแก้ไข จากนั้นคุณสามารถ:

1. คลิกขวาที่ปลายทางของลิงก์และเลือก "Refactor..." ในเมนูบริบท
2. กด Ctrl+Shift+R

การดำเนินการอย่างใดอย่างหนึ่งจะเพิ่มเมนูบริบทการปรับโครงสร้างใหม่ เลือก "แยกเป็นคำจำกัดความของลิงก์" ในเมนูบริบท ซึ่งจะแทนที่ (destination.md) ในลิงก์ด้วย [def] คุณสามารถเปลี่ยนชื่อคำจำกัดความได้โดยการพิมพ์ชื่อลงไป

สำหรับเอกสาร PowerShell เราใช้คำจำกัดความของลิงก์อ้างอิงที่เป็นตัวเลขสองหลัก เช่น [01] หรือ [31] ใช้เฉพาะคำจำกัดความลิงก์อ้างอิงในหัวข้อและเอกสารเชิงแนวคิดเท่านั้น อย่าใช้ข้อกำหนดลิงก์อ้างอิงในเอกสารอ้างอิง cmdlet

แก้ไขการละเมิดสไตล์ร้อยแก้ว

เมื่อคุณตรวจสอบบทความในโค้ดสเปซของคุณ Vale จะตรวจสอบบทความโดยอัตโนมัติเมื่อคุณเปิดครั้งแรกและทุกครั้งที่คุณบันทึก หาก Vale พบการละเมิดสไตล์ใดๆ ระบบจะไฮไลต์สิ่งเหล่านั้นในเอกสารด้วยเส้นหยักสี

วางเมาส์เหนือการละเมิดเพื่อดูข้อมูลเพิ่มเติม

เลือกชื่อกฎในข้อมูลโฮเวอร์เพื่อเปิดหน้าเว็บที่อธิบายกฎ เลือกชื่อไฟล์ของกฎ (ลงท้ายด้วย .yml) เพื่อเปิดกฎและตรวจสอบการใช้งาน

หากกฎรองรับการแก้ไขด่วน คุณสามารถเลือก "แก้ไขด่วน..." ในข้อมูลโฮเวอร์สำหรับการละเมิด และใช้การแก้ไขที่แนะนำอย่างใดอย่างหนึ่งโดยเลือกจากเมนูบริบท คุณยังสามารถกด Ctrl+. เมื่อเคอร์เซอร์อยู่บนปัญหาที่ไฮไลต์เพื่อใช้การแก้ไขด่วนหากกฎรองรับ

หากกฎไม่รองรับการแก้ไขด่วน โปรดอ่านข้อความของกฎและแก้ไขหากทำได้ หากคุณไม่แน่ใจว่าจะแก้ไขอย่างไร บรรณาธิการสามารถให้คำแนะนำเมื่อตรวจสอบ PR ของคุณได้

แก้ไขปัญหาไวยากรณ์

เมื่อคุณตรวจสอบบทความในโค้ดสเปซของคุณ Markdownlint จะตรวจสอบบทความโดยอัตโนมัติเมื่อคุณเปิดและขณะที่คุณพิมพ์ หาก Markdownlint พบปัญหาทางไวยากรณ์ ระบบจะไฮไลต์ปัญหาเหล่านั้นในเอกสารด้วยเส้นหยักสี

วางเมาส์เหนือการละเมิดเพื่อดูข้อมูลเพิ่มเติม

เลือกรหัสของกฎในข้อมูลโฮเวอร์เพื่อเปิดหน้าเว็บที่อธิบายกฎ

หากกฎรองรับการแก้ไขด่วน คุณสามารถเลือก "แก้ไขด่วน..." ในข้อมูลโฮเวอร์สำหรับการละเมิด และใช้การแก้ไขที่แนะนำอย่างใดอย่างหนึ่งโดยเลือกจากเมนูบริบท คุณยังสามารถกด Ctrl+. เมื่อเคอร์เซอร์อยู่บนปัญหาที่ไฮไลต์เพื่อใช้การแก้ไขด่วนหากกฎรองรับ

หากกฎไม่รองรับการแก้ไขด่วน โปรดอ่านข้อความของกฎและแก้ไขหากทำได้ หากคุณไม่แน่ใจว่าจะแก้ไขอย่างไร บรรณาธิการสามารถให้คำแนะนำเมื่อตรวจสอบ PR ของคุณได้

คุณยังสามารถใช้การแก้ไขกับการละเมิดไวยากรณ์ทั้งหมดในบทความได้ โดยเปิดแผงคำสั่งแล้วพิมพ์ แก้ไขการละเมิด markdownlint ที่รองรับทั้งหมดในเอกสาร ขณะที่คุณพิมพ์ แผงคำสั่งจะกรองคำสั่งที่มีอยู่ เลือกคำสั่ง "แก้ไขการละเมิด markdownlint ที่รองรับทั้งหมดในเอกสาร" เมื่อคุณดำเนินการดังกล่าว Markdownlint จะอัปเดตเอกสารเพื่อแก้ไขการละเมิดใดๆ ที่มีการแก้ไขด่วน

จัดรูปแบบตาราง

หากต้องการจัดรูปแบบตาราง Markdown ให้วางเคอร์เซอร์ในหรือบนโต๊ะใน Markdown ของคุณ เปิด Command Palette และค้นหาคำสั่ง Table: Format Current เมื่อคุณเลือกคำสั่งนั้น คำสั่งนั้นจะอัปเดต Markdown สำหรับตารางของคุณเพื่อจัดแนวและแพดตารางเพื่อให้อ่านง่ายขึ้น

มันจะแปลงตารางที่กำหนดดังนี้:

| foo | bar | baz |
|:--:|:--|-:|
| a | b | c |

เป็นสิ่งนี้:

|  foo  | bar  | baz  |
| :---: | :--- | ---: |
|   a   | b    |    c |

ใส่การแจ้งเตือน

เอกสารประกอบใช้การแจ้งเตือนเพื่อทำให้ข้อมูลโดดเด่นยิ่งขึ้นสำหรับผู้อ่าน

หากต้องการแทรกการแจ้งเตือน คุณสามารถเปิด Command Palette และค้นหาคำสั่ง Learn: Alert เมื่อคุณเลือกคำสั่งนั้น เมนูบริบทจะเปิดขึ้นมา เลือกประเภทการแจ้งเตือนที่คุณต้องการเพิ่ม เมื่อคุณดำเนินการ คำสั่งจะแทรก Markdown ของการแจ้งเตือนที่เคอร์เซอร์ของคุณในเอกสาร

สร้างประโยคที่ใช้ใส่หัวเรื่อง

หากต้องการแปลงส่วนหัวให้เน้นข้อความของส่วนหัว ยกเว้นสัญลักษณ์ # นำหน้า ซึ่งกำหนดระดับส่วนหัว เมื่อคุณไฮไลต์ข้อความแล้ว ให้เปิด Command Palette และค้นหาคำสั่ง Change case allowance เมื่อคุณเลือกคำสั่งนั้น คำสั่งนั้นจะแปลงตัวพิมพ์ของข้อความที่ไฮไลท์

คุณยังสามารถใช้คำสั่งตัวพิมพ์สำหรับข้อความใดๆ ในเอกสารได้

เปิดแผงคำสั่ง

คุณสามารถใช้ Command Palette ของ VS Code เพื่อรันคำสั่งที่เป็นประโยชน์มากมายได้

หากต้องการเปิด Command Palette ใน UI ให้เลือก "มุมมอง" ในแถบเมนูด้านบน จากนั้นเลือก "Command Palette..." ในเมนูบริบท

หากต้องการเปิด Command Palette ด้วยแป้นพิมพ์ ให้กดคีย์ผสมสำหรับระบบปฏิบัติการของคุณ:

• Windows และ Linux: Ctrl+Shift+P
• macOS: Cmd+กะ+P

ดูตัวอย่างการมีส่วนร่วมของคุณ

หากต้องการดูตัวอย่างการมีส่วนร่วมของคุณ ให้เปิด Command Palette และค้นหาคำสั่ง Markdown: Open Preview เมื่อคุณเลือกคำสั่งนั้น VS Code จะเปิดดูตัวอย่างเอกสารที่ใช้งานอยู่ รูปแบบของการแสดงตัวอย่างตรงกับแพลตฟอร์มการเรียนรู้

ปรับเปลี่ยนเนื้อหาของคุณ

หากต้องการจำกัดความยาวบรรทัดของย่อหน้าในเอกสาร ให้วางเคอร์เซอร์บนย่อหน้า จากนั้นเปิด Command Palette และค้นหาคำสั่ง Reflow Markdown เมื่อคุณเลือกคำสั่ง คำสั่งจะอัพเดตความยาวบรรทัดของย่อหน้าปัจจุบันเป็นความยาวที่กำหนดค่าไว้ สำหรับที่เก็บของเรา ความยาวนั้นคือ 99 อักขระ

เมื่อใช้คำสั่งนี้สำหรับเครื่องหมายคำพูดแบบบล็อก ตรวจสอบให้แน่ใจว่าย่อหน้าในเครื่องหมายคำพูดแบบบล็อกที่คุณกำลังจัดเรียงใหม่นั้นล้อมรอบด้วยบรรทัดว่าง มิฉะนั้น คำสั่งจะจัดเรียงทุกย่อหน้าใหม่พร้อมกัน

ตรวจสอบปัญหาทั้งหมดในเอกสาร

หากต้องการตรวจสอบการละเมิดกฎไวยากรณ์และลักษณะทั้งหมดในเอกสาร ให้เปิดมุมมองปัญหา

หากต้องการเปิดมุมมองปัญหาใน UI ให้เลือก "มุมมอง" ในแถบเมนูด้านบน จากนั้นเลือก "ปัญหา" ในเมนูบริบท

หากต้องการเปิดมุมมองปัญหาด้วยแป้นพิมพ์ ให้กดคีย์ผสมสำหรับระบบปฏิบัติการของคุณ:

• Windows และ Linux: Ctrl+Shift+M
• macOS: Cmd+กะ+M

มุมมองปัญหาจะแสดงข้อผิดพลาด คำเตือน และคำแนะนำทั้งหมดสำหรับเอกสารที่เปิดอยู่ เลือกปัญหาเพื่อเลื่อนดูในเอกสาร

คุณสามารถกรองปัญหาตามประเภทหรือการจับคู่ข้อความ

กำลังอัปเดตข้อมูลเมตา ms.date

หากต้องการอัปเดตข้อมูลเมตา ms.date สำหรับบทความ ให้เปิด Command Palette และค้นหาคำสั่ง เรียนรู้: อัปเดต "ms.date" Metadata Value เมื่อคุณเลือกคำสั่ง ระบบจะอัปเดตข้อมูลเมตาเป็นวันที่ปัจจุบัน

แหล่งข้อมูลเพิ่มเติม

งานและคำสั่งที่อธิบายในบทความนี้ไม่ครอบคลุมทุกสิ่งที่คุณทำได้ด้วย VS Code หรือส่วนขยายที่ติดตั้งไว้

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้ VS Code โปรดดูบทความเหล่านี้:

• เคล็ดลับและเทคนิคโค้ด Visual Studio
• การแก้ไขขั้นพื้นฐาน
• การใช้การควบคุมแหล่งที่มา Git ในรหัส VS
• รหัส Markdown และ Visual Studio

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับส่วนขยายที่ติดตั้ง โปรดดูเอกสารประกอบ:

• เปลี่ยนกรณี
• GitLens
• ตัวติดตาม Gremlins สำหรับ Visual Studio Code
• เรียนรู้ชุดการเขียน
• มาร์คดาวน์ลินท์
• มาร์กดาวน์รีโฟลว์
• ตัวจัดรูปแบบตาราง