Markowik เป็น app หลามที่แปลง Markdown จัดรูปแบบข้อความไปยัง Google รหัสวิกิพีเดีย
Markowik สามารถแปลงโครงสร้างส่วนใหญ่จะ Markdown รหัสของ Google วิกิพีเดีย (GCW) เทียบเท่า แทนรายการแปลงที่สนับสนุนทั้งหมดโปรดดูที่ชุดทดสอบ Markowik และกรณีการแสดงของตน
การติดตั้ง
เรียกใช้:
PIP ติดตั้ง markowik
หรือ:
easy_install markowik
นอกจากนี้คุณยังสามารถใช้ Markowik ไม่ต้องติดตั้งตามที่อธิบายไว้ภายใต้การมีส่วนร่วม
บรรทัดคำสั่งการใช้งาน
จากการส่งออกความช่วยเหลือ:
การใช้งาน: markowik [-h] [--mx [MX [MX ... ]]] [URL --image-baseUrl]
& nbsp; [- html ที่ภาพ] [--encoding เข้ารหัส] [เงียบ]
& nbsp; INFILE [OUTFILE]
แปลง Markdown ไปยัง Google รหัสวิกิพีเดีย
ข้อโต้แย้งตำแหน่ง:
& nbsp; INFILE ไฟล์ markdown
& nbsp; OUTFILE ไฟล์วิกิพีเดีย (ค่าเริ่มต้น: stdout)
อาร์กิวเมนต์ตัวเลือก:
& nbsp; -h, --help แสดงข้อความช่วยเหลือนี้และออกจาก
& nbsp; - MX [MX [MX ... ]] นามสกุล markdown เพื่อเปิดใช้งาน
& nbsp; - URL ภาพ baseUrl URL ฐาน prepend ไปยังสถานที่ภาพญาติ
& nbsp; - html ที่ภาพมักจะใช้ HTML สำหรับภาพ
& nbsp; - การเข้ารหัสการเข้ารหัสการเข้ารหัสของ input และ output (ค่าเริ่มต้น: UTF8)
& nbsp; - เงียบข้อความข้อมูลปิดการใช้งาน
นามสกุล Markdown อาจได้รับเป็นไปในทำนองเดียวกันหลาม Markdown (PyMD) เครื่องมือบรรทัดคำสั่งยกเว้นว่านามสกุลของแต่ละบุคคลจะต้องคั่นด้วยช่องว่าง:
markowik ตาราง INPUT --mx def_list
ได้รับการสนับสนุนในขณะนี้ (เช่นการทดสอบ) นามสกุล abbr ตารางและ def_list นามสกุลอื่น ๆ โดยทั่วไปควรทำงานมากเกินไป แต่อาจให้ผลลัพธ์ที่ไม่คาดคิดในข้อความที่วิกิพีเดียแปลง
เกี่ยวกับตัวเลือก --html ภาพโปรดดูคำอธิบายด้านล่างที่ข้อ จำกัด
โปรแกรมการใช้งาน
Markowik จะดำเนินการในหลาม โมดูล markowik มีฟังก์ชั่นแปลงชื่อ ความหมายมันคล้ายกับอินเตอร์เฟซบรรทัดคำสั่ง (ข้อโต้แย้งคำตรงกับคำสั่งตัวเลือกบรรทัด) นี่เป็นตัวอย่างการใช้งานระยะสั้น:
>>> นำเข้า markowik
>>> markowik.convert ("บาง markdown * * * * * * * * ข้อความ ... ", MX = ['ตาราง'])
ข้อความ u'Some _markdown_ ...
หน้า pragmas
GCW หน้า pragmas สามารถตั้งค่าในไฟล์ที่มา Markdown เป็นข้อมูลเมตาในรูปแบบที่กำหนดโดย PyMD ขยายเมตา:
>>> src = "" "สรุป: สรุปหน้า
... ป้ายกำกับ: บางป้าย
...
... ที่นี่หน้า * * * * * * * * เริ่มต้น ..
... "" "
>>> markowik.convert พิมพ์ (src, MX = ['เมตา'])
สรุปหน้า #summary
#labels บางป้าย
ที่นี่เริ่ม _page_ ..
โปรดทราบว่านามสกุลเมตาจะต้องมีการเปิดใช้งานอย่างชัดเจนเช่นโดยเริ่มต้น Markowik ไม่รู้จัก pragmas หน้า
มีอะไรใหม่ ในข่าวประชาสัมพันธ์ฉบับนี้.
< ul>
มีอะไรใหม่ ในรุ่น 0.1.1:.
- เอกสารที่ดีขึ้น
- แก้ไขไมเนอร์.
ต้องการ
- หลาม
ข้อ จำกัด
- GCW ไม่สามารถแสดงความเป็นไปได้ทั้งหมดมาร์กอัปใน Markdown ซึ่งหมายความว่าไฟล์ที่มา Markdown ควรจะเขียนต่อไปนี้มีข้อ จำกัด ในใจ.
- URL ที่ในการเชื่อมโยงและภาพ:
- URL ที่ใช้สำหรับการเชื่อมโยงหรือแหล่งที่มาของภาพจะต้องมีแน่นอนและต้องมีโปรโตคอลที่เฉพาะเจาะจงที่จะได้รับการยอมรับจาก GCW โดยเฉพาะอย่างยิ่ง URL ใด ๆ ที่จะต้องเริ่มต้นด้วย http: //, https: // หรือ ftp: // Markowik ยกเลิกการแปลงหากพบ URL ที่ไม่ตรงกับความต้องการเหล่านี้.
- Typefacing ในการเชื่อมโยงชื่อ:
- GCW ไม่สนับสนุน typefacing ในชื่อการเชื่อมโยง ยกตัวอย่างเช่น GCW ทำให้ชื่อของการเชื่อมโยงใน [http://foo.com _Foo_] แท้จริงเช่นเป็น _Foo_ อย่างไรก็ตาม GCW ตระหนัก typefacing ในการเชื่อมโยง HTML, th & lt; href = & quot; http: //foo.com" & gt; _Foo_ & lt; / & gt; จะเน้นอย่างถูกต้อง สำหรับการเชื่อมโยง Markdown เหตุผลนี้กับ typefacing ซ้อนกันเช่น [* ฟู *] (http://foo.com) จะถูกแปลงเป็น HTML การเชื่อมโยง เป็นผลให้ป้ายลิงค์กับตัวอักษรพิเศษบางอย่างที่จะต้องมีการหลบหนีใน GCW ใช้ backtick (`) เครื่องหมายยังจะส่งผลในการเชื่อมโยง HTML.
- ซ้อนย่อหน้า:
- GCW ไม่สนับสนุนจริงๆย่อหน้าที่ซ้อนกันหลาย ๆ (เช่นในรายการหรือ blockquotes) Markowik จำลองย่อหน้าที่ซ้อนกันหลายคนโดยแยกด้วย & lt; br / & gt; (ซึ่งสายตาวรรคเลียนแบบ แต่ไม่ทำลายสภาพแวดล้อมการทำรัง).
- รูปภาพ:
- Markdown ช่วยให้การแสดงความตำราทางเลือกและชื่อภาพ ไวยากรณ์ภาพ GCW ไม่สนับสนุนนี้ วิธีเดียวที่จะรักษาข้อความเหล่านี้คือการใช้ภาษา HTML ธรรมดา & lt; img & gt; แท็ก ตัวเลือก --html ภาพช่วยให้การแก้ปัญหานี้.
- ปัญหาก็คือว่า GCW คาดว่า URL ของภาพที่จะจบลงด้วยนามสกุลไฟล์รูปภาพชนิด Markowik เพิ่มส่วนขยายภาพเทียมในกรณีที่จำเป็นเช่น http://foo.bar/image จะเปลี่ยนเป็น http://foo.bar/image?x=x.png.
- ย่อ:
- GCW มีมาร์กอัปสำหรับตัวย่อไม่มีหรือไม่ก็สนับสนุนแท็ก & lt; abbr & gt ;. Markowik แปลงตัวย่อที่ & lt; ช่วง & gt; -elements ซึ่งชนิดของเลียนแบบตัวย่อ (ในแฟชั่น จำกัด ของหลักสูตร) .
- HTML
- ใด ๆ HTML ธรรมดาที่เกิดขึ้นในแหล่ง Markdown สิ้นสุดขึ้นอย่างแท้จริงใน GCW (ยกเว้นของเนื้อหาของแท็กช่วงระดับ) ซึ่งหมายความว่าแหล่ง Markdown เท่านั้นควรมีการสนับสนุนโดย HTML GCW ความหมายก็คือว่า URL ใช้ในแท็ก HTML ธรรมดาจะไม่ได้รับการตรวจสอบความเข้ากันได้ GCW ในคำอื่น ๆ : เมื่อใช้ HTML ดิบคุณเป็นตัวคุณเอง !
ความคิดเห็นที่ไม่พบ