วิธีเพิ่มบันทึกย่อในหัวข้อวิธีใช้ cmdlet
บันทึก
การเขียนวิธีใช้ XML ด้วยตนเองเป็นเรื่องยากมาก โมดูล PlatyPS ช่วยให้คุณสามารถเขียนความช่วยเหลือใน Markdown แล้วแปลงเป็นความช่วยเหลือแบบ XML ทำให้เขียนและดูแลรักษาความช่วยเหลือได้ง่ายขึ้นมาก PlatyPS ยังสามารถสร้างแพ็คเกจความช่วยเหลือที่อัปเดตได้ให้กับคุณอีกด้วย สำหรับข้อมูลเพิ่มเติม โปรดดูสร้างวิธีใช้แบบ XML โดยใช้ PlatyPS
ส่วนนี้อธิบายวิธีการเพิ่มส่วนหมายเหตุในหัวข้อวิธีใช้ PowerShell cmdlet ส่วน หมายเหตุ ใช้เพื่ออธิบายรายละเอียดที่ไม่เข้ากับส่วนที่มีโครงสร้างอื่นๆ ได้ง่าย เช่น คำอธิบายพารามิเตอร์โดยละเอียดเพิ่มเติม เนื้อหานี้อาจรวมถึงความคิดเห็นเกี่ยวกับวิธีการทำงานของ cmdlet กับผู้ให้บริการเฉพาะ การใช้ cmdlet ที่ไม่ซ้ำใครแต่มีความสำคัญ หรือวิธีการหลีกเลี่ยงเงื่อนไขข้อผิดพลาดที่อาจเกิดขึ้น
ส่วน NOTES ถูกกำหนดโดยใช้โหนด <maml:alertset> เดียว ไม่มีการจำกัดจำนวนบันทึกที่คุณสามารถเพิ่มลงในส่วนบันทึกย่อได้ สำหรับบันทึกแต่ละรายการ ให้เพิ่มแท็ก <maml:alert> คู่หนึ่งลงในโหนด <maml:alertset> เนื้อหาของแต่ละบันทึกจะถูกเพิ่มภายในชุดแท็ก <maml:para> ใช้แท็ก <maml:para> ว่างเพื่อเว้นวรรค
<maml:alertSet>
<maml:title>Optional title for Note</maml:title>
<maml:alert>
<maml:para>Note 1</maml:para>
<maml:para>Note a</maml:para>
</maml:alert>
<maml:alert>
<maml:para>Note 2</maml:para>
</maml:alert>
</maml:alertSet>