ลอย-mdown ให้เครื่องมือและตัวกรองสำหรับชั้นลอยที่ช่วยให้ผู้ดูแลระบบการจัดรูปแบบการใช้ markdown ในการสร้างเนื้อหาในเว็บไซต์ของพวกเขามากกว่าการใช้โปรแกรมแก้ไข TinyMCE เพื่อสร้าง html ที่ใช้ในประเภทเนื้อหาหลากหลายเช่นหน้าเว็บที่อุดมสมบูรณ์และบล็อกโพสต์
การติดตั้ง
รับแพคเกจ
pip:
ผู้ใช้ @ บ้าน: ~ $ pip ติดตั้งชั้นลอย-mdown
easy_install:
ผู้ใช้ @ บ้าน: ~ $ easy_install ลอย-mdown
เตรียมสื่อแบบคงที่
ใช้ app staticfiles ที่ยอดเยี่ยมไฟล์คง mdown ควรได้รับเลือกขึ้นโดยอัตโนมัติ
หากแอพพลิเค staticfiles ไม่ได้รูปแบบของคุณคุณจะต้องค้นหาสถานที่ติดตั้งสำหรับแพคเกจ mdown (ปกติไดเรกทอรีล่ามหลามของแพคเกจที่เดียวกัน) และคัดลอก / symlink mdown / แบบคงที่ / mdown ลงในไดเรกทอรี site_media โครงการของคุณ
การตั้งค่า
ก่อนปิด mdown เพิ่มรายชื่อของ INSTALLED_APPS ของคุณในการตั้งค่าโครงการโมดูลของคุณ
กับ app ที่ติดตั้งคุณต้องให้ทางเลือกคู่ คุณจะต้องระบุ RICHTEXT_WIDGET_CLASS และค่า RICHTEXT_FILTER โมดูลในการตั้งค่า
RICHTEXT_WIDGET_CLASS
แพคเกจนี้มี 2 ตัวเลือกสำหรับการตั้งค่านี้
mdown.forms.WmdWidget
& nbsp; เปิดใช้งานโปรแกรมแก้ไขข้อความที่อุดมไปด้วย WMD (แนะนำ)
mdown.forms.PlainWidget
& nbsp; ใช้ textarea ธรรมดา (ไม่มีการแก้ไขข้อความที่อุดมไปด้วย)
RICHTEXT_FILTER
อีกครั้งมี 2 ตัวเลือกสำหรับการตั้งค่านี้
mdown.filters.codehilite
& nbsp; Renders เนื้อหาโดยใช้ markdown มีนามสกุล codehilite ทำงาน
mdown.filters.plain
& nbsp; แสดงผลเนื้อหาโดยใช้การจัดรูปแบบ markdown วานิลลา
ขั้นตอนพิเศษ
ลักษณะ Pygments
การใช้คำสั่งการจัดการ pygments_styles คุณสามารถสร้าง CSS เพื่อ colorize บล็อกรหัสแยกวิเคราะห์โดยตัวกรอง codehilite
หมายเหตุ: pygments นี้ต้องมีการติดตั้ง (PIP ใช้ติดตั้ง pygments หรือ pygments easy_install จะใช้คุณลักษณะนี้)
เรียกใช้คำสั่งที่มี args ไม่มีที่จะเห็นข้อความการใช้งานและรายชื่อของโทนสีที่มีอยู่ในระบบของคุณ .:
ผู้ใช้ @ บ้าน: ~ / mysite $ ./manage.py pygments_styles
การใช้งาน: ./manage.py pygments_styles
โทนสีที่มีจำหน่าย:
& nbsp; Borland
& nbsp; bw
& nbsp; ที่มีสีสัน
& nbsp; เริ่มต้น
& nbsp; ... [snip] ...
เรียกด้วยชื่อโครงการเป็นอาร์กิวเมนต์จะพิมพ์และ CSS ที่ stdout ซึ่งคุณสามารถเปลี่ยนเส้นทางไปยังไฟล์ที่ต้องการเพื่อ:
ผู้ใช้ @ บ้าน: ~ / mysite $ ./manage.py pygment_styles ที่มีสีสัน> site_media css / / pygments.css
ใน additon นี้วิธีการรูปแบบเดียวคำสั่งยังยอมรับ --all ธงซึ่งจะสร้างรูปแบบสำหรับที่มีอยู่ทั้งหมด แต่มีความแตกต่างที่สำคัญอย่างหนึ่งแต่ละโครงการจะนำหน้าด้วยชื่อที่เป็นชื่อชั้นและ CSS นี้จะมีประโยชน์ในการพัฒนารูปแบบที่คุณสามารถสลับแผนการ pygments เพียงโดยการตั้งค่าระดับบนแท็กร่างกายที่คุณเลือกของโครงการโดยไม่ต้องมีการงอกใหม่ไฟล์ css ที่อย่างต่อเนื่อง
เมื่อคุณได้ไฟล์ css ที่สร้างขึ้นเพียงแค่เพิ่มไปยังฐานแม่แบบของเว็บไซต์ของคุณจะได้รับรหัสของคุณ "สวย" พิมพ์
การปรับปรุงรูปแบบแม่แบบ
รูปแบบที่อยู่บนพื้นฐานของรูปแบบเริ่มต้นและถูกสร้างขึ้นก่อนที่จะมีการเปิดตัวชั้นลอย 0.11.3 ส่วนใหญ่อาจจะไม่ได้ richtext_filter นำไปใช้กับเนื้อหาที่หลากหลาย การแก้ไขปัญหานี้คุณก็ต้องปรับปรุงแม่แบบสำหรับชนิดเนื้อหาเหล่านี้เพื่อให้ตัวกรองที่ถูกนำมาใช้
ยกตัวอย่างเช่นในรูปแบบเริ่มต้นที่แม่ / บล็อก / blog_post_detail.html มีสายที่ได้รับการปรับปรุงจาก ::
{{blog_post.content | ปลอดภัย}}
ไป ::
{{blog_post.content | richtext_filter | ปลอดภัย}}
. เพียงให้แน่ใจว่าตัวกรองความปลอดภัยมาหลังจาก richtext_filter
ต้องการ
- งูใหญ่
ความคิดเห็นที่ไม่พบ