ติดตั้งเครื่องมือการเขียนเนื้อหา

บทความนี้อธิบายขั้นตอนการติดตั้งเครื่องมือการ Git Client และ Visual Studio Code

ข้อสำคัญ

ถ้าคุณเปลี่ยนแปลงบทความเพียงเล็กน้อยเท่านั้น คุณไม่ต้องทำตามขั้นตอนในบทความนี้และสามารถไปยังเวิร์กโฟลว์การเปลี่ยนแปลงด่วนได้เลยโดยตรง

ผู้สนับสนุนที่จะเปลี่ยนแปลงหลักจะสนับสนุนให้เสร็จสิ้นขั้นตอนเหล่านี้ ซึ่งช่วยให้คุณสามารถใช้เวิร์กโฟลว์ การเปลี่ยนแปลงหลัก/รันเป็นเวลานานได้ แม้ว่าคุณมีสิทธิ์เขียนลงในที่เก็บหลักเราขอแนะนำให้คุณ (และคู่มือนี้สรุปว่าคุณ) ทำสำเนาและลอกแบบที่เก็บเพื่อให้คุณมีสิทธิ์อ่าน/เขียนเพื่อเก็บการเปลี่ยนแปลงเนื้อหาไว้ในสำเนา

ติดตั้งเครื่องมือ Git Client บน Windows

การติดตั้งนี้รวมถึงระบบควบคุมเวอร์ชันเครื่องมือ Git และ Git Bash ซึ่งเป็นแอปแบบบรรทัดคำสั่งที่คุณใช้ในการโต้ตอบกับพื้นที่เก็บเครื่องมือ Git แบบโลคัลของคุณ

ติดตั้งเครื่องมือ Git Client for Windows

หมายเหตุ

  • ถ้าคุณชอบอินเทอร์เฟซผู้ใช้แบบกราฟิก (GUI) มากกว่าอินเทอร์เฟซแบบบรรทัดเดียว (CLI), Visual Studio Code, หน้า GUI Clients ที่พร้อมใช้งานของSoftware Freedom ConservancyและGitHub ของ GitHub Desktopมีฟังก์ชันการแม้ว่าคุณ
  1. ดาวน์โหลดเครื่องมือ Git Windows

  2. เรียกใช้ไฟล์ปฏิบัติการ (.EXE) ที่ดาวน์โหลดมา และตามพร้อมท์เพื่อติดตั้ง เลือก ถัดไป ที่พรอมต์แต่ละรายการเพื่อยอมรับการตั้งค่าเริ่มต้นทั้งหมด

    หน้าการตั้งค่า Git เลือกคอมโพเนนต์

  3. เลือก เสร็จสิ้น เพื่อจบการติดตั้ง

    หน้าการตั้งค่า Git เพื่อเสร็จสิ้นการตั้งค่า

หลังจากติดตั้ง Git Windowsคุณจะต้องกําหนดค่าชื่อ Git และอีเมลของคุณก่อนติดตั้ง Visual Studio Code

คำเตือน

Git บน Windows: เปิดใช้งานชื่อเส้นทางแบบยาว ตามค่าเริ่มต้น Git Windowsปิดใช้งานการสนับสนุน filepaths ยาว ซึ่งป้องกันไฟล์ใด ๆ ที่มีเส้นทางปลายทางยาวกว่า 255 อักขระจากการถูกลอกแบบ เปิดใช้งาน filepaths ที่ยาว เพื่อหลีกเลี่ยงปัญหานี้ โดยการเรียกใช้สั่ง ต่อไปนี้ในฐานะผู้ดูแลระบบ:
git config --global core.longpaths true

ติดตั้งเครื่องมือ Git Client for Mac และ Linux

  • เครื่องมือ Git สำหรับ Mac นั้นมีส่วนของเครื่องมือบรรทัดคำสั่ง Xcode เรียกใช้ง่ายๆ git จากบรรทัดคำสั่ง คุณจะได้รับการแจ้งเตือนให้ติดตั้งเครื่องมือบรรทัดคำสั่งหากจำเป็น คุณยังสามารถดาวน์โหลด เครื่องมือ Git สำหรับ Mac จาก Software Freedom Conservancy
  • เครื่องมือ Git สำหรับ Linux และ Unix

ใช้ client ที่คุณเลือกตามคำแนะนำในเรื่องการติดตั้งและการตั้งค่าคอนฟิก

ในบทความถัดไป คุณจะติดตั้งที่เก็บ Git ท้องถิ่น

ทรัพยากร Git เพิ่มเติมมีอยู่ที่นี่: คำศัพท์ Gitพื้นฐาน Gitการเรียนรู้ Git และ GitHub

ติดตั้งVisual Studioรหัส

Visual Studio Code หรือที่เรียกว่า VS Code เป็นตัวแก้ไขเล็กๆ ตัวหนึ่งที่ทำงานบน Windows, Linux และ Mac ซึ่งประกอบด้วย การรวม git และการสนับสนุนส่วนขยาย

เคล็ดลับ

เมื่อเปิดใช้ VS Code และเปิดโฟลเดอร์ปัจจุบัน เรียกใช้คำสั่งcode .ในบรรทัดคำสั่งหรือ bash shell ถ้าโฟลเดอร์ปัจจุบันเป็นส่วนหนึ่งของที่เก็บ git ภายในเครื่อง ระบบการรวม GitHub จะปรากฏใน Visual Studio Code โดยอัตโนมัติ

ติดตั้งVisual Studio Code for Window, mac และ Linux

  • Windows. โฮมเพจของ VS Code ควรตรวจพบระบบปฏิบัติการของคุณได้อย่างถูกต้อง
  • Mac
  • Linux

ติดตั้งVisual Studio Code

หากต้องการติดตั้งส่วนขยาย:

  1. เริ่มVisual Studioสร้างรหัส

  2. เลือกไอคอน ส่วนขยายสี่เหลี่ยม จัตุรัสที่ด้านซ้ายมือ ส่วนขยาย: บานหน้าต่างMarketplace ปรากฏขึ้น

  3. ในกล่อง ค้นหาส่วนขยายในกล่อง ค้นหา Marketplace พิมพ์ชื่อของส่วนขยายที่คุณต้องการค้นหา

    สกรีนช็อตที่แสดงไอคอนส่วนขยายและชี้ไปยังส่วนขยายการค้นหาในแถบการค้นหา Marketplace บน VS code

  4. ในผลลัพธ์ที่ปรากฏขึ้น ค้นหาส่วนขยายที่คุณต้องการ แล้วเลือกติดตั้ง

ติดตั้ง Docs Authoring Pack

ข้อสำคัญ

ชุดการเขียนแก้เอกสาร (Docs Authoring Pack for Visual Studio Code) ประกอบด้วยความช่วยเหลือของการเขียน Markdown พื้นฐาน การแสดงตัวอย่างหน้า การสนับสนุนเทมเพลต Markdown Markdownlint และ Code Spell Checker คุณลักษณะเหล่านี้ช่วยง่ายและเพิ่มประสิทธิภาพของกระบวนการร่วมสร้าง ดังนั้น เราพิจารณาส่วนขยายของ Docs Authoring Pack เป็น ส่วนขยายที่ต้องมีผู้ร่วมสร้างเอกสาร

เมื่อต้องการติดตั้ง Docs Authoring Pack ให้เลือกติดตั้ง จาก หน้า Docs Authoring Pack ใน VS Code Marketplace

เมื่อต้องการใช้ฟังก์ชัน Docs Authoring Pack ให้กด Alt+M Visual Studio Code ในการกําหนดค่าแถบเครื่องมือเพื่อแสดงฟังก์ชันที่พร้อมใช้งาน แก้ไขการตั้งค่าVisual Studio Code (ตัวควบคุม + จุลภาค) และเพิ่มการตั้งค่า "markdown.showToolbar": true ผู้ใช้

โปรดดูที่ชุดการเขียนแก้เอกสาร(Docs Authoring Pack Visual Studio Code)

เข้าใจตัวแก้ไข Markdown

Markdown เป็นภาษามาร์กอัปเบาที่ใช้ในการเขียนเนื้อหา Visual Studio Codeเป็นเครื่องมือสำหรับการแก้ไข Markdown ที่ Microsoft Atomเป็นเครื่องมือที่ได้รับความนิยมอีกเครื่องมือหนึ่งสำหรับการแก้ไข Markdown พื้นฐานของ Markdown และคุณลักษณะที่ได้รับการสนับสนุนโดยส่วนขยาย Markdown แบบเองของ Open Publishing Services (OPS) มีครอบคลุมอยู่ในบทความการอ้างอิง Markdown

ขั้นตอนถัดไป

ขณะนี้ คุณพร้อมที่จะติดตั้งพื้นที่เก็บ Git ภายในเครื่อง