เอกสาร Obsidian ใช้แนวทางสไตล์ที่ระบุไว้ในหน้านี้ แนวทางเหล่านี้อิงจากแนวปฏิบัติที่ดีที่สุดในอุตสาหกรรม โดยเฉพาะ [คู่มือสไตล์เอกสารนักพัฒนาของ Google](<https://developers.google.com/style>) และ [คู่มือสไตล์ของ Microsoft](https://learn.microsoft.com/en-us/style-guide/) สำหรับกรณีที่ไม่ได้ครอบคลุมด้านล่าง ให้อ้างอิงจากคู่มือภายนอกเหล่านั้นเป็นแหล่งข้อมูลรอง > [!tip]- มีส่วนร่วม > เอกสารส่วนใหญ่มีอยู่ก่อนที่คู่มือสไตล์นี้จะถูกสร้างขึ้น > > หากคุณพบการละเมิดคู่มือสไตล์นี้ กรุณา[สร้าง issue](https://github.com/obsidianmd/obsidian-docs/issues/new) และส่ง pull request ไปที่ [obsidianmd/obsidian-docs](https://github.com/obsidianmd/obsidian-docs) ## คำศัพท์และไวยากรณ์ ### สไตล์ภาษา สำหรับเอกสารภาษาอังกฤษของเรา แนะนำให้ใช้ [Global English](https://docs.openedx.org/en/latest/documentors/references/doc_english_writing.html) เพื่อให้บริการผู้อ่านทั่วโลกได้ดียิ่งขึ้น และช่วยในเรื่อง[[#การแปลภาษา]] ซึ่งหมายความว่า: - หลีกเลี่ยงสำนวนและการแสดงออกเฉพาะวัฒนธรรม - ใช้ประโยคแบบ active voice และโครงสร้างประโยคตรงไปตรงมา - เลือกใช้คำที่ง่ายและพบได้ทั่วไปแทนคำศัพท์ที่ซับซ้อน - ระบุอย่างชัดเจนแทนที่จะสื่อโดยนัย - สำหรับข้อตกลงการสะกดคำ ให้ใช้ภาษาอังกฤษแบบอเมริกัน (เช่น 'organize' ไม่ใช่ 'organise') ### คำศัพท์ - เลือกใช้ "keyboard shortcut" แทน "hotkey" ใช้ Hotkey เมื่ออ้างอิงถึงฟีเจอร์เฉพาะ - เลือกใช้ "the Obsidian app" บนมือถือ และ "the Obsidian application" บนเดสก์ท็อป - เลือกใช้ "sync" หรือ "syncing" แทน "synchronise" หรือ "synchronising" - เลือกใช้ "search term" แทน "search query" - เลือกใช้ "heading" แทน "header" เมื่ออ้างอิงถึงข้อความที่แนะนำส่วนต่างๆ - เลือกใช้ "maximum" แทน "max" และ "minimum" แทน "min" ### ชื่อผลิตภัณฑ์ ชื่อผลิตภัณฑ์ของ Obsidian ขึ้นต้นด้วย "Obsidian" เช่น "Obsidian Publish" และ "Obsidian Sync" หากย่อหน้ามีการกล่าวซ้ำมากเกินไป คุณสามารถใช้รูปแบบย่อในการอ้างอิงครั้งต่อๆ ไปได้ ตัวอย่าง: _เพื่อให้สามารถตั้งค่าเฉพาะอุปกรณ์ได้ Obsidian Sync จะไม่ซิงค์การตั้งค่าของตัวเอง คุณจำเป็นต้องตั้งค่า Sync สำหรับอุปกรณ์แต่ละเครื่องของคุณ_ ### UI และการโต้ตอบ - ใช้**ตัวหนา**เพื่อระบุข้อความของปุ่ม - เลือกใช้ "select" แทน "tap" หรือ "click" - สำหรับคำแนะนำเฉพาะมือถือ "tap" สามารถใช้ได้เมื่ออธิบายการโต้ตอบแบบสัมผัส เนื่องจากไม่มี "click" - เลือกใช้ "sidebar" แทน "side bar" - เลือกใช้ "perform" แทน "invoke" และ "execute" เมื่ออ้างอิงถึงคำสั่งหรือการกระทำ เมื่ออ้างอิงถึงการโต้ตอบ UI หลายรายการตามลำดับ ให้ใช้สัญลักษณ์ → (U+2192) ตัวอย่าง: "**[[การตั้งค่า]] → ปลั๊กอินโดยชุมชน**" ### โน้ต ไฟล์ และโฟลเดอร์ - ใช้ "โน้ต" เมื่ออ้างอิงถึงไฟล์ Markdown ในห้องนิรภัย - ใช้ "ไฟล์" เมื่ออ้างอิงถึงนามสกุลไฟล์อื่นที่ไม่ใช่ Markdown - เลือกใช้ "ชื่อบันทึก" แทน "ชื่อเรื่องของโน้ต" - เลือกใช้ "โน้ตที่ใช้งานอยู่" แทน "โน้ตปัจจุบัน" - เลือกใช้ "โฟลเดอร์" แทน "ไดเรกทอรี" - เลือกใช้ "ประเภทไฟล์" แทน "รูปแบบไฟล์" เว้นแต่จะอ้างอิงถึงรูปแบบข้อมูลของเนื้อหาไฟล์โดยเฉพาะ เมื่อย้ายระหว่างโน้ต ให้ใช้ "เปิด" หากปลายทางถูกซ่อนอยู่ และ "สลับ" หากทั้งโน้ตต้นทางและปลายทางเปิดอยู่ในแถบแยกกัน ### เอกสารอ้างอิงสำหรับการตั้งค่า เมื่อเป็นไปได้ การตั้งค่าใดๆ ควรถูกบันทึกไว้ภายใน Obsidian โดยใช้ข้อความอธิบาย หลีกเลี่ยงการบันทึกการตั้งค่าเฉพาะใน Obsidian Help เว้นแต่: - ต้องการความรู้เชิงลึกเพิ่มเติมเกี่ยวกับวิธีใช้และเวลาที่ควรใช้ - มักถูกใช้ผิดหรือถูกถามบ่อย - เปลี่ยนแปลงประสบการณ์ผู้ใช้_อย่างมาก_ พิจารณาใช้บล็อกเน้นแบบเคล็ดลับหากคุณต้องการดึงความสนใจไปที่การตั้งค่าเฉพาะ ### คำที่ระบุทิศทาง ใส่ขีดกลางในคำที่ระบุทิศทางเมื่อใช้เป็นคำคุณศัพท์ หลีกเลี่ยงการใส่ขีดกลางเมื่อทิศทางถูกใช้เป็นคำนาม **แนะนำ:** - เลือก **[[การตั้งค่า]]** ที่มุมล่างซ้าย (bottom-left corner) - เลือก **[[การตั้งค่า]]** ที่ด้านล่างซ้าย (bottom left) **ไม่แนะนำ:** - เลือก **[[การตั้งค่า]]** ที่มุมล่าง ซ้าย (bottom left corner) - เลือก **[[การตั้งค่า]]** ที่ด้าน bottom-left เลือกใช้ "upper-left" และ "upper-right" แทน "top-left" และ "top-right" อย่าระบุทิศทางเมื่ออ้างอิงถึงการตั้งค่า ตำแหน่งของตัวควบคุมการตั้งค่าขึ้นอยู่กับอุปกรณ์ **แนะนำ:** - ถัดจาก **Pick remote vault** เลือก **Choose** **ไม่แนะนำ:** - ทางด้านขวาของ **Pick remote vault** เลือก **Choose** เมื่ออธิบายทิศทางแนวตั้งในองค์ประกอบ UI ให้ใช้ "ด้านบน" และ "ด้านล่าง" สำหรับความสัมพันธ์เชิงพื้นที่ หลีกเลี่ยง "ขึ้น" และ "ลง" เนื่องจากอาจคลุมเครือในบริบทต่างๆ **แนะนำ:** - ช่องค้นหาปรากฏอยู่ด้านบนของรายการไฟล์ - ตัวเลือกเพิ่มเติมอยู่ด้านล่าง **ไม่แนะนำ:** - ช่องค้นหาอยู่ขึ้นไปจากรายการไฟล์ - ตัวเลือกเพิ่มเติมอยู่ข้างล่างไป ### คำแนะนำ ใช้ประโยคคำสั่งสำหรับชื่อคู่มือ หัวเรื่องของส่วนต่างๆ และคำแนะนำแบบทีละขั้นตอน ประโยคคำสั่งมีความกระชับและมุ่งเน้นการกระทำ ซึ่งตรงไปตรงมามากกว่าสำหรับผู้ใช้ที่ทำตามคำแนะนำ - เลือกใช้ "ตั้งค่า" แทน "การตั้งค่า" - เลือกใช้ "ย้ายไฟล์" แทน "การย้ายไฟล์" - เลือกใช้ "นำเข้าโน้ตของคุณ" แทน "การนำเข้าโน้ตของคุณ" ### การใช้ตัวพิมพ์แบบประโยค เลือกใช้*ตัวพิมพ์แบบประโยค*แทน*ตัวพิมพ์แบบชื่อเรื่อง*สำหรับหัวเรื่อง ปุ่ม และชื่อเรื่อง เมื่ออ้างอิงองค์ประกอบ UI ให้ใช้ตัวพิมพ์ตรงกับข้อความใน UI เสมอ **แนะนำ:** - How Obsidian stores data **ไม่แนะนำ:** - How Obsidian Stores Data ### ตัวอย่าง เลือกใช้ตัวอย่างที่สมจริงแทนคำที่ไม่มีความหมาย **แนะนำ:** - `task:(call OR schedule)` **ไม่แนะนำ:** - `task:(foo OR bar)` ### ชื่อปุ่มและแป้นพิมพ์ลัด เมื่ออ้างอิงถึงปุ่มแป้นพิมพ์และแป้นพิมพ์ลัด ให้ใช้สัญลักษณ์ที่สอดคล้องกัน **ชื่อปุ่มเดี่ยว:** เมื่ออ้างอิงถึงตัวอักษรบนแป้นพิมพ์โดยใช้ชื่อ ให้เพิ่มตัวอักษรไว้ในวงเล็บหลังชื่อ **แนะนำ:** - กดปุ่มขีดกลาง (-) เพื่อเพิ่มเส้นขีด - ใช้เครื่องหมายคำถาม (?) เพื่อค้นหา **ไม่แนะนำ:** - กดปุ่มขีดกลางเพื่อเพิ่มเส้นขีด - ใช้ ? เพื่อค้นหา - เพิ่ม `-` ด้านหน้าคำ **แป้นพิมพ์ลัด:** จัดรูปแบบแป้นพิมพ์ลัดโดยไม่มีช่องว่างรอบเครื่องหมายบวก เมื่อแป้นพิมพ์ลัดแตกต่างกันระหว่างระบบปฏิบัติการ ให้ระบุทั้งสอง **แนะนำ:** - กด `Ctrl+Z` (Windows) หรือ `Command+Z` (macOS) เพื่อ undo - กด `Escape` เพื่อปิดหน้าต่างนี้ - ใช้ `Tab` เพื่อย้ายระหว่างฟิลด์ **ไม่แนะนำ:** - กด `Cmd+Z` เพื่อ undo - กด `Ctrl + Z` (มีช่องว่าง) เพื่อ undo - กด `Ctrl/Cmd+Z` เพื่อ undo สำหรับแป้นพิมพ์ลัดที่เหมือนกันทุกแพลตฟอร์ม ไม่จำเป็นต้องระบุระบบปฏิบัติการ หากคุณไม่แน่ใจว่าแป้นพิมพ์ลัดแตกต่างกันตามแพลตฟอร์มหรือไม่ ให้ระบุระบบปฏิบัติการเพื่อความปลอดภัย Windows และ Linux มักใช้แป้นพิมพ์ลัดเดียวกัน ### Markdown ใช้บรรทัดว่างระหว่างบล็อก Markdown: **แนะนำ:** ```md # หัวเรื่อง 1 นี่คือส่วนหนึ่ง 1. รายการแรก 2. รายการที่สอง 3. รายการที่สาม ``` **ไม่แนะนำ:** ```md # หัวเรื่อง 1 นี่คือส่วนหนึ่ง 1. รายการแรก 2. รายการที่สอง 3. รายการที่สาม ``` **ขีดยาวในรายการ:** ใช้ขีดยาว (—) เพื่อแยกคำที่เป็นตัวหนาจากคำอธิบายในรายการสัญลักษณ์แสดงหัวข้อย่อย อย่าใช้ขีดยาวในรายการสัญลักษณ์แสดงหัวข้อย่อยแบบซ้อนธรรมดาที่มีลิงก์ **แนะนำ:** - **เมนู View** — สร้าง แก้ไข และสลับมุมมอง - **คำนวณค่า** — เพิ่มราคา คำนวณยอดรวม หรือดำเนินการทางคณิตศาสตร์ **ไม่แนะนำ:** - [[สร้างฐาน]] — เรียนรู้วิธีสร้างและฝังฐาน ### รูปภาพ ใช้ "**ความกว้าง** x **ความสูง** พิกเซล" สำหรับการอธิบายขนาดรูปภาพหรือหน้าจอ **ตัวอย่าง:** ขนาดรูปภาพที่แนะนำ: 1920 x 1080 พิกเซล ## โครงสร้างข้อมูล ### ประเภทบล็อกเน้น ใช้บล็อกเน้นอย่างมีกลยุทธ์เพื่อเน้นข้อมูลประเภทเฉพาะ: **เคล็ดลับ** (`[!tip]-`) - คำแนะนำเชิงปฏิบัติหรือแนวปฏิบัติที่ดีที่สุดที่ช่วยยกระดับเวิร์กโฟลว์ของผู้ใช้ ใช้สำหรับทางลัด วิธีแก้ปัญหาเฉพาะหน้า หรือข้อมูลที่ไม่จำเป็นแต่มีประโยชน์ บล็อกเน้นเหล่านี้เริ่มต้นในสถานะยุบ **ข้อมูล** (`[!info]+`) - บริบทเพิ่มเติม ข้อมูลพื้นหลัง หรือคำชี้แจง ใช้เมื่อข้อมูลเพิ่มความเข้าใจแต่ไม่จำเป็นสำหรับการทำงานให้เสร็จ บล็อกเน้นเหล่านี้เริ่มต้นในสถานะเปิด **คำเตือน** (`[!warning]+`) - ข้อควรระวังสำคัญที่ป้องกันการสูญหายของข้อมูล ข้อผิดพลาด หรือผลที่ไม่ตั้งใจ ใช้อย่างระมัดระวังสำหรับสถานการณ์ที่มีความเสี่ยงจริงๆ บล็อกเน้นเหล่านี้ไม่ควรถูกยุบ **ตัวอย่าง** (`[!example]-`) - หมายเหตุทั่วไปหรือรายละเอียดเสริม ใช้สำหรับข้อมูลที่เกี่ยวข้องทางอ้อมซึ่งผู้ใช้บางคนอาจพบว่ามีประโยชน์ บล็อกเน้นเหล่านี้เริ่มต้นในสถานะยุบ **ตัวอย่าง:** ```md > [!tip]- ใช้แป้นพิมพ์ลัด > คุณสามารถเร่งเวิร์กโฟลว์ของคุณได้โดยจดจำแป้นพิมพ์ลัดที่ใช้บ่อยที่สุด > [!info]+ นี่เป็นส่วนเสริมแบบเสียเงิน > ฟีเจอร์นี้ต้องมีการสมัครสมาชิกแบบเสียเงินเพื่อใช้งาน > [!warning]+ การดำเนินการนี้ไม่สามารถย้อนกลับได้ > การลบห้องนิรภัยเป็นการถาวร พิจารณาส่งออกโน้ตของคุณก่อน > [!example]- การใช้งานขั้นสูง > คุณยังสามารถตั้งค่านี้ผ่านเมนูกราฟได้ด้วย ``` ### รายการ vs. ร้อยแก้ว ใช้รายการเมื่อนำเสนอรายการแยกส่วนที่ไม่มีความสัมพันธ์เชิงลำดับหรือเชิงเหตุผลที่แข็งแกร่ง ใช้ร้อยแก้วและย่อหน้าเมื่อรายการต่อยอดจากกัน ต้องการคำอธิบาย หรือได้ประโยชน์จากการเล่าเรื่อง **ใช้รายการสำหรับ:** - ชุดฟีเจอร์ที่ไม่เกี่ยวข้องกัน - ข้อกำหนดการติดตั้ง - ตัวเลือกการตั้งค่า - ขั้นตอนการแก้ไขปัญหา **ใช้ร้อยแก้วสำหรับ:** - คำอธิบายว่าบางสิ่งทำงานอย่างไร - เวิร์กโฟลว์ที่มีการพึ่งพากัน - ภาพรวมเชิงแนวคิด - คำแนะนำที่ต้องการบริบท ### ตาราง ใช้ตารางเพื่อเปรียบเทียบฟีเจอร์ เวอร์ชั่น หรือจุดข้อมูลที่เกี่ยวข้องซึ่งการจัดแนวช่วยให้เข้าใจได้ง่ายขึ้น หลีกเลี่ยงตารางสำหรับรายการธรรมดาหรือข้อมูลคอลัมน์เดียว **กรณีใช้งานที่ดี:** | ฟีเจอร์ | มือถือ | เดสก์ท็อป | |---------|--------|---------| | ซิงค์ | ใช่ | ใช่ | | ปลั๊กอิน | ไม่ | ใช่ | | ธีม | จำกัด | เต็ม | ### การอ้างอิงข้าม ใช้ลิงก์วิกิภายใน (`[[ชื่อโน้ต]]`) อย่างเสรีเพื่อช่วยให้ผู้ใช้นำทางไปยังหัวข้อที่เกี่ยวข้อง อย่างไรก็ตาม หลีกเลี่ยงการใส่ลิงก์มากเกินไป: - อย่าลิงก์คำเดียวกันหลายครั้งในหน้าเดียว - ลิงก์เฉพาะเมื่อหน้าที่อ้างอิงให้บริบทเพิ่มเติมที่สำคัญ - ใช้ข้อความลิงก์ที่มีคำอธิบายเมื่อเป็นประโยชน์: `[[ชื่อโน้ต#ส่วน|ข้อความอธิบาย]]` **ตัวอย่าง:** การกล่าวถึงครั้งแรก: "เรียนรู้เกี่ยวกับ [[แนะนำ Obsidian Sync|Obsidian Sync]] เพื่อรักษาห้องนิรภัยของคุณให้อัปเดตข้ามอุปกรณ์" การกล่าวถึงครั้งต่อมา: "คุณสามารถตั้งค่า Sync สำหรับอุปกรณ์แต่ละเครื่องแยกกันได้" ### เนื้อหาเฉพาะแพลตฟอร์ม เมื่อบันทึกฟีเจอร์ที่แตกต่างกันระหว่างแพลตฟอร์ม ให้ใช้หัวเรื่องของส่วนเพื่อจัดระเบียบเนื้อหา ใช้ `เดสก์ท็อป` และ `มือถือ` เป็นหัวเรื่องย่อยเพื่อแยกคำแนะนำหรือฟีเจอร์เฉพาะแพลตฟอร์ม **แนะนำ:** ```md ## ปรับแต่งริบบอน ### เดสก์ท็อป ในเวอร์ชั่นเดสก์ท็อป คุณสามารถปรับแต่งริบบอนได้ดังนี้: - จัดเรียงลำดับการกระทำในริบบอนโดยการลากและวางไอคอน - เพื่อซ่อนการกระทำเฉพาะ ให้คลิกขวาที่พื้นที่ว่างและยกเลิกการเลือกการกระทำที่คุณต้องการซ่อน ### มือถือ ในเวอร์ชั่นมือถือ คุณสามารถปรับแต่งริบบอนผ่านการตั้งค่า: 1. เปิด **[[การตั้งค่า]]** 2. ไปที่ **หน้าตา** 3. คลิก **จัดการ** ภายใต้ **Ribbon Configuration** ``` > [!info]+ เมื่อไหร่ควรสร้างส่วนแยก? > สร้างส่วนแยกเฉพาะเมื่อเนื้อหาแตกต่างกันอย่างมีนัยสำคัญ หากคำแนะนำส่วนใหญ่เหมือนกันโดยมีความแตกต่างเล็กน้อย ให้ใช้หมายเหตุในบรรทัดแทน ## ไอคอนและรูปภาพ รวมไอคอนและรูปภาพเมื่อช่วยให้อธิบายสิ่งที่ยากจะอธิบายด้วยคำพูดได้ง่ายขึ้น หรือเมื่อคุณต้องการแสดงส่วนสำคัญของแอป Obsidian คุณสามารถบันทึกรูปภาพในโฟลเดอร์ `Attachments` - รูปภาพควรทำให้ข้อความที่มาพร้อมกับมันเข้าใจง่ายขึ้น **ตัวอย่าง**: เมื่อเปิดใช้งานแล้ว ปลั๊กอิน[[การนับคำ]]จะสร้างรายการใหม่บนแถบสถานะด้านล่างของคุณ ![[Style-guide-zoomed-example.png#interface|300]] - รูปภาพควรอยู่ในรูปแบบ `.png` หรือ `.svg` - หากรูปภาพดูใหญ่เกินไปในโน้ต ให้ปรับขนาดให้เล็กลงนอก Obsidian หรือปรับขนาดตามที่อธิบายไว้ใน[[ฝังไฟล์#ฝังรูปภาพในโน้ต|การฝังรูปภาพในโน้ต]] - ในกรณีที่หายาก คุณอาจต้องการวางรูปภาพขนาดใหญ่หรือซับซ้อนเป็นพิเศษใน[[บล็อกเน้น#บล็อกเน้นที่พับได้|บล็อกเน้นที่พับได้]] - สำหรับหน้าต่างป๊อปอัพหรือโมดอล รูปภาพควรแสดงหน้าต่างแอป Obsidian ทั้งหมด ![[Style-guide-modal-example.png#interface]] ### ไอคอน ไอคอน [Lucide](https://lucide.dev/icons/) และไอคอน Obsidian กำหนดเองสามารถใช้ร่วมกับองค์ประกอบรายละเอียดเพื่อให้การแสดงผลภาพของฟีเจอร์ **ตัวอย่าง:** ในริบบอนด้านซ้าย เลือก **สร้างผืนผ้าใบใหม่** ![[lucide-layout-dashboard.svg#icon]] เพื่อสร้างผืนผ้าใบในโฟลเดอร์เดียวกับไฟล์ที่ใช้งานอยู่ **แนวทางสำหรับไอคอน** - เก็บไอคอนไว้ในโฟลเดอร์ `Attachments/icons` - เพิ่มคำนำหน้า `lucide-` ก่อนชื่อไอคอน Lucide - เพิ่มคำนำหน้า `obsidian-icon-` ก่อนชื่อไอคอน Obsidian **ตัวอย่าง:** ไอคอนสำหรับสร้างผืนผ้าใบใหม่ควรตั้งชื่อเป็น `lucide-layout-dashboard` - ใช้เวอร์ชั่น SVG ของไอคอนที่มีอยู่ - ไอคอนควรมีความกว้าง `18` พิกเซล ความสูง `18` พิกเซล และมี stroke width เป็น `1.5` คุณสามารถปรับการตั้งค่าเหล่านี้ในข้อมูล SVG > [!info]- ปรับขนาดและ stroke ใน SVG > ```html > <svg xmlns="http://www.w3.org/2000/svg" width="WIDTH" height="HEIGHT" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="STROKE-WIDTH" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-layout-dashboard"><rect width="7" height="9" x="3" y="3" rx="1"/><rect width="7" height="5" x="14" y="3" rx="1"/><rect width="7" height="9" x="14" y="12" rx="1"/><rect width="7" height="5" x="3" y="16" rx="1"/></svg> >``` - ใช้ anchor `icon` ในรูปภาพที่ฝัง เพื่อปรับระยะห่างรอบไอคอนให้จัดแนวอย่างเรียบร้อยกับข้อความในบริเวณใกล้เคียง - ไอคอนควรล้อมรอบด้วยวงเล็บ ![[lucide-cog.svg#icon]] **ตัวอย่าง**: `![[lucide-cog.svg#icon]]` ### แท็ก anchor ของรูปภาพ แท็ก anchor ของรูปภาพพร้อมใช้งานเพื่อเพิ่มการเปลี่ยนแปลงเชิงตกแต่งให้กับรูปภาพที่ฝัง > [!warning] คำเตือนเกี่ยวกับแสดงตัวอย่างแบบสด > แท็ก anchor ของไอคอนจะไม่แสดงผลอย่างถูกต้องใน**แสดงตัวอย่างแบบสด** ใช้**มุมมองการอ่าน**เพื่อยืนยันว่าแท็ก anchor ถูกนำไปใช้แล้ว **ไอคอน** `![[lucide-menu.svg#icon]]` แท็ก anchor ไอคอนช่วยให้การจัดแนวในแนวตั้งถูกต้องสำหรับไอคอนที่ใช้ระบุองค์ประกอบอินเทอร์เฟซ ไอคอนเมนูแรกใช้แท็ก anchor ![[lucide-menu.svg#icon]] ในขณะที่ไอคอนเมนูที่สอง ( ![[lucide-menu.svg]] ) ไม่ได้ใช้ **อินเทอร์เฟซ** `![[Vault picker.png#interface]]` แท็ก anchor อินเทอร์เฟซจะเพิ่มเงาตกแต่งรอบรูปภาพ ในรูปภาพแรก แท็ก anchor อินเทอร์เฟซถูกนำไปใช้ ![[Vault picker.png#interface]] ในทางตรงกันข้าม รูปภาพที่สองไม่มีการใช้ anchor อินเทอร์เฟซ ![[Vault picker.png]] **เส้นขอบ** `![[Backlinks.png#outline]]` แท็ก anchor เส้นขอบจะเพิ่มขอบที่ละเอียดอ่อนรอบรูปภาพ ในรูปภาพแรก แท็ก anchor เส้นขอบถูกนำไปใช้ > [!tip] สังเกตมุมล่างซ้ายของรูปภาพเพื่อดูความแตกต่าง ![[Backlinks.png#outline]] รูปภาพที่สองไม่มีแท็ก anchor เส้นขอบ ![[Backlinks.png]] ### การปรับปรุงประสิทธิภาพ รูปภาพทำให้เวลาในการโหลดหน้าช้าลง และใช้พื้นที่จัดเก็บ [[แนะนำ Obsidian Publish|Publish]] ที่มีค่า การปรับปรุงประสิทธิภาพรูปภาพช่วยลดขนาดไฟล์ แต่ยังคงรักษาความสมบูรณ์ทางภาพของรูปภาพ ทั้งรูปภาพและไอคอนควรได้รับการปรับปรุงประสิทธิภาพ > [!info] เครื่องมือสำหรับปรับปรุงประสิทธิภาพรูปภาพ > นี่คือโปรแกรมแนะนำบางส่วนสำหรับลดขนาดรูปภาพของคุณ > - **Windows:** [FileOptimizer](https://sourceforge.net/projects/nikkhokkho/) > - **macOS:** [ImageOptim](https://imageoptim.com/) > - **Linux/Unix** [Trimage](https://trimage.org) > > เราแนะนำอัตราการปรับปรุงประสิทธิภาพ 65-75% ## เลย์เอาต์ ### ลิงก์เสีย ก่อนส่ง Pull Request ของคุณ กรุณาตรวจสอบลิงก์เสียในเอกสารของการแปลที่คุณกำลังทำอยู่ และแก้ไขให้ถูกต้อง ลิงก์เสียสามารถเกิดขึ้นได้ตามธรรมชาติเมื่อเวลาผ่านไป ดังนั้นการตรวจสอบความถูกต้องจะช่วยรักษาคุณภาพของเอกสาร คุณสามารถตรวจสอบลิงก์เสียโดยใช้[[ปลั๊กอินโดยชุมชน]]หรือเครื่องมือที่มีอยู่ใน IDE ของคุณ ### คำอธิบาย เอกสารนี้ถูกแก้ไขบน GitHub และโฮสต์ออนไลน์ผ่าน [[แนะนำ Obsidian Publish|Obsidian Publish]] ซึ่งรวมถึง[[พรีวิวลิงค์สื่อสังคม#คำอธิบาย|คำอธิบาย]]สำหรับ social card และองค์ประกอบ [[SEO]] อื่นๆ หากหน้าที่คุณกำลังทำอยู่ไม่มี[[คุณสมบัติ|คุณสมบัติ]] `description` กรุณาเพิ่มเข้าไป คำอธิบายควรมี 150 ตัวอักษรหรือน้อยกว่า และให้สรุปเนื้อหาของหน้าอย่างเป็นกลาง **ดี**: Learn to create templates that capture and organize web page metadata automatically with Web Clipper. **ควรปรับปรุง**: Learn how to create templates that automatically capture and organize metadata from web pages with Web Clipper. ### ทิศทาง เมื่อเขียนหรือเขียนใหม่[[#คำแนะนำ]]เกี่ยวกับวิธีดำเนินการภายในแอป ให้แน่ใจว่ารวมขั้นตอนสำหรับทั้งเวอร์ชั่นมือถือและเดสก์ท็อป หากคุณไม่มีอุปกรณ์มือถือหรือเดสก์ท็อป กรุณาแจ้งเรื่องนี้เมื่อส่ง Pull Request ของคุณ ## การแปลภาษา แปลเนื้อหาทั้งหมดเมื่อทำการแปล ซึ่งรวมถึงแต่ไม่จำกัดเพียง: - ชื่อโน้ต - ชื่อโฟลเดอร์ - นามแฝง - ชื่อไฟล์แนบ - ข้อความลิงก์ทางเลือก