การสร้างไฟล์ช่วยเหลือสำหรับเป็นกลุ่ม


8

ปัจจุบันฉันเขียนเอกสารของฉันโดยตรงเป็นไฟล์ช่วยเหลือเป็นกลุ่ม บางครั้งฉันต้องสร้างรูปแบบอื่น ๆ (เช่น PDF) กระบวนการทำงานของฉันคือการคัดลอกเนื้อหาของไฟล์ช่วยเหลือและแปลงเป็นสิ่งที่ฉันต้องการ นี่เป็นงานที่ค่อนข้างน่าเบื่อเพราะส่วนใหญ่ฉันต้องเพิ่มมาร์กอัปเพิ่มเติม

ฉันชอบวิธีการของ Markdown ซึ่งสามารถเปลี่ยน (เช่นการใช้ Pandoc) เป็นรูปแบบผลลัพธ์ที่หลากหลาย น่าเสียดายที่ไม่ได้เป็นกลุ่มไฟล์ช่วยเหลือ ฉันกำลังมองหาตัวแปลงที่ใช้รูปแบบอินพุตมาตรฐาน (เช่น XML, Markdown, reStructed Text, ข้อความธรรมดา, ... ) และส่งออกไฟล์วิธีใช้ vim หรือมีวิธีอื่นใดในการสร้างไฟล์วิธีใช้ vim โดยอัตโนมัติโดยไม่ต้องเขียนตัวแปลงไฟล์เอง?


คุณอาจจะรวมสไตล์ชีท XSLT เข้าด้วยกันในเวลาไม่กี่ชั่วโมง
Ignacio Vazquez-Abrams

คำตอบ:


11

ขออภัยสำหรับการคืนค่าเธรดที่เก่ามากอีกครั้ง ฉันเป็นผู้เขียนmkd2vimdocสคริปต์หลังลิงก์แรกที่แนะนำโดยlornixก่อนหน้านี้ ฉันเพิ่งเขียนmkd2vimdocจากพื้นดินขึ้นเป็นhtml2vimdoc มันยังรองรับ Markdown เป็นรูปแบบอินพุต มันจะแปลง Markdown เป็น HTML แล้วแปลง HTML นั้นเป็นไฟล์ช่วยเหลือ Vim โฟกัสในระหว่างการเขียนซ้ำได้รับการสนับสนุนสำหรับช่วงกว้างของเอกสารอินพุต

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


3
ยินดีต้อนรับสู่ SuperUser! การตอบคำถามเก่า ๆ นั้นน่าชื่นชมที่นี่บางคนอาจยังคงมองหาคำตอบเกี่ยวกับสิ่งเหล่านั้นและมันก็ดีในการปรับปรุงคำถามเก่า ๆ
gronostaj

4

ฉันพบสคริปต์นี้ซึ่งผู้เขียนสร้างขึ้นเพื่อแปลง markdown เป็น vim document ฟังดูใกล้เคียงกับสิ่งที่คุณกำลังมองหา

ในขณะที่สคริปต์ vim.org นี้ ( github repo ) จะแปลง markdown เป็นสิ่งที่ดูเหมือนว่าเกือบทุกอย่าง แต่ vimdoc (ถอนหายใจ) ใกล้แล้ว ... อาจจะมีการดัดแปลงเล็กน้อย?


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

ฉันอยากรู้ว่ามันอาจเกี่ยวข้องกับการสร้างตัวแปลงจาก markdown ถึง vimdoc เนื่องจาก vimdoc ส่วนใหญ่กำลังจัดรูปแบบและอักขระเครื่องหมายพิเศษขณะที่เวทมนตร์ทำโดยคำสั่ง helptags และตัวช่วยดู vim แน่นอนฉันจะใส่เท้าของฉันในปากของฉัน (อีกครั้ง!) ... บางทีมันอาจจะขึ้นอยู่กับความซับซ้อนของการมาร์คครั้งแรกของคุณ
lornix

วิธีแก้ไขปัญหาแบบสมาร์ทที่แนะนำในรายการส่งเมลคือการสร้าง vimhelp ซึ่งเป็น markdown ที่ถูกต้องเช่นกัน ข้อเสียเปรียบคือ markdown มีความยุ่งเหยิงเล็กน้อยกับไวยากรณ์ vim และไฟล์ vimhelp ไม่เป็นไปตามข้อกำหนดการจัดรูปแบบ แต่นอกเหนือจากนั้นมันใช้งานได้
Marco
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.