maxpress

MaxPress: MarkDown+Python ตระหนักถึงเค้าโครงบัญชีสาธารณะ WeChat เพียงคลิกเดียว

---

อัปเดตบทช่วยสอนมือใหม่สำหรับผู้ที่ไม่มีความรู้ทางเทคนิค:

[ตอนที่ 1: หลักการพื้นฐาน] "ข่าวดีสำหรับคนขี้เกียจ: จะเป็นบรรณาธิการ WeChat ที่ไม่เคยเรียงพิมพ์ได้อย่างไร" -

[บทความถัดไป: คู่มือไวยากรณ์] "คำแนะนำฉบับสมบูรณ์สำหรับการเรียงพิมพ์ MarkDown สำหรับบัญชีทางการของ WeChat"

---

ฟังก์ชั่นพื้นฐาน

1. ชุดแปลงเอกสาร MarkDown เป็นไฟล์ HTML เหมาะสำหรับวางลงในโปรแกรมแก้ไข WeChat
2. รองรับการปรับแต่ง: ขนาดข้อความ สีข้อความ (สีข้อความ สีของธีม สีอ้างอิง) ระยะห่างระหว่างบรรทัด ระยะห่างย่อหน้า การจัดตำแหน่งแนวนอนของชื่อเรื่อง อัตราส่วนช่องว่างทั้งสองด้านของเนื้อหา และรูปภาพด้านล่าง
3. เอกสาร MarkDown ที่แปลงแล้วสามารถย้ายและเก็บถาวรได้โดยอัตโนมัติ

เริ่มต้นเลย

ดาวน์โหลด

ดาวน์โหลดเวอร์ชันเสถียรล่าสุด: เวอร์ชัน Windows/เวอร์ชัน Mac

การใช้โปรแกรมปฏิบัติการเวอร์ชัน Windows/Mac

การเรียงพิมพ์ในคลิกเดียว

1. ใช้ Markdown เพื่อสร้างเนื้อหาของคุณ บันทึกเป็นไฟล์ .md และวางไว้ในไดเร็กทอรี temp
2. ดับเบิลคลิกเพื่อรันโปรแกรม maxpress จากนั้นไฟล์ .html ที่มีชื่อเดียวกันจะถูกสร้างขึ้นในไดเร็กทอรี result／html
3. เปิดไฟล์ .html ที่สร้างขึ้นด้วยเบราว์เซอร์ เลือกทั้งหมด คัดลอก และวางลงในโปรแกรมแก้ไข WeChat
4. ตรวจสอบ ดูตัวอย่าง ปรับเปลี่ยน

【หมายเหตุ】

1. โปรดตรวจสอบให้แน่ใจว่าได้ส่งไปยังโทรศัพท์มือถือของคุณเพื่อดูตัวอย่างก่อนที่จะผลักดันผู้เขียนไม่รับประกันว่ารูปแบบสุดท้ายจะถูกต้องอย่างแน่นอน
2. โปรดตรวจสอบให้แน่ใจว่าได้เก็บสำเนาของเอกสารต้นฉบับไว้นอกไดเร็กทอรีซอฟต์แวร์ก่อนการแปลง ผู้เขียนจะไม่รับผิดชอบต่อการสูญหายของข้อมูลโดยไม่ตั้งใจ
3. ขณะนี้เราได้ทดสอบเบราว์เซอร์ Chrome บน Win/Mac เท่านั้น หากการจัดรูปแบบสูญหาย/เสียหายในระหว่างขั้นตอนนี้ โปรดให้ข้อเสนอแนะในปัญหาและอธิบาย ปัญหาที่คุณพบ ระบบและเบราว์เซอร์ที่คุณใช้
4. รองรับการแปลงไฟล์ .md หลายไฟล์และไดเร็กทอรีย่อยหลายรายการเป็นชุด (รวมถึงไดเร็กทอรีย่อยที่ซ้อนกัน)
5. การเก็บถาวรอัตโนมัติจะดำเนินการตามค่าเริ่มต้น นั่นคือ ไฟล์ .md ต้นฉบับทั้งหมดจะถูกย้ายไปยังไดเร็กทอรี result／archive หลังจากการแปลง ฟังก์ชั่นนี้สามารถปิดใช้งานได้โดยการแก้ไขไฟล์การกำหนดค่า (auto_archive)
6. หากชื่อไฟล์ขัดแย้งกัน ชื่อไฟล์เริ่มต้นจะถูกเขียนทับโดยอัตโนมัติ คุณสามารถแก้ไขไฟล์การกำหนดค่า (auto_rename) เพื่อทำการเปลี่ยนชื่ออัตโนมัติได้

การปรับรูปแบบ

ก่อนที่จะรันโปรแกรมแปลง ให้แก้ไขไฟล์ config.json เพื่อปรับแต่งตัวแปรรูปแบบทั่วไป

รวม:

ชื่อตัวแปร	ค่าเริ่มต้น	แสดงให้เห็น
main_size	16px	ขนาดข้อความหลัก
ธีม_สี	#349971	สีของธีม ใช้สำหรับสีข้อความ เช่น ชื่อเรื่อง องค์ประกอบเน้น ฯลฯ
text_color	#555	สีข้อความเนื้อหา
quote_color	#999	สีข้อความในกล่องอ้างอิงและกล่องรหัส
line_height	2em	ความสูงของบรรทัดข้อความ
para_spacing	1.5ม	ระยะห่างย่อหน้าข้อความ
จัดตำแหน่ง	หลายรายการ	แนะนำให้จัดตำแหน่งแนวนอนของแต่ละส่วนไป left หรือ center ( h1 ~ h6 แสดงถึงชื่อ 1 ~ ชื่อ 6 content แสดงถึงข้อความหลัก)
main_margin	3%	สัดส่วนของพื้นที่สีขาวทั้งสองด้านของเนื้อหา
แบนเนอร์_url	-	URL ของรูปภาพในส่วนหัวของบทความที่ดึงดูดความสนใจ
poster_url	-	QR code/ที่อยู่ของภาพโปสเตอร์ด้านล่าง
แปลง_รายการ	จริง	แปลงรายการในข้อความเป็นย่อหน้าธรรมดาเพื่อแก้ไขปัญหาที่ WeChat ไม่สามารถแสดงรูปแบบหมายเลขลำดับรายการได้อย่างถูกต้อง (สำหรับ WeChat เท่านั้น)
ul_style	""	การระบุสัญลักษณ์ก่อนแต่ละรายการหลังจากแปลงรายการที่ไม่เรียงลำดับเป็นย่อหน้าปกติ (เปิดใช้งานเฉพาะเมื่อ convert_list เป็น true )
auto_archive	-	ไม่ว่าจะเก็บถาวรโดยอัตโนมัติ (ย้ายไฟล์ . .md ต้นฉบับไปยังไดเร็กทอรี result／archive หลังการแปลง)
เปลี่ยนชื่ออัตโนมัติ	เท็จ	การจัดการชื่อไฟล์ที่ขัดแย้งกัน: true เปลี่ยนชื่อโดยอัตโนมัติ false เพื่อเขียนทับไฟล์ก่อนหน้า

หมายเหตุ:

• หากข้อกำหนดการปรับแต่งไม่สูง แนะนำให้เปลี่ยน theme_color และส่วนที่เหลือสามารถใช้การกำหนดค่าเริ่มต้นได้
• ดูเหมือนว่า WeChat UI เวอร์ชันปัจจุบันจะแสดงเฉพาะสไตล์เริ่มต้นสำหรับหมายเลขรายการทั้งหมด แม้ว่าสไตล์จะถูกเขียนลงในองค์ประกอบระดับบน แต่สไตล์นั้นจะถูก "ล้างออก" เมื่อวางลงในตัวแก้ไข ขณะนี้ยังไม่มีวิธีใด ข้ามข้อจำกัดนี้ ดังนั้นให้เพิ่มตัวเลือก convert_list เป็นวิธีแก้ไขปัญหาชั่วคราว เมื่อตัวเลือกนี้เป็น true รายการทั้งหมดในเนื้อหา (ไม่รวมเนื้อหาในบล็อคโค้ด) จะถูกแปลงเป็นย่อหน้าธรรมดาโดยมีหมายเลขซีเรียลอยู่ที่ตอนต้นของย่อหน้า โปรดทราบว่าในกรณีนี้ สไตล์ที่ตั้งค่าไว้สำหรับรายการใน styles.less โดยเฉพาะจะไม่ถูกต้อง หากคุณมีวิธีที่ดีกว่า โปรดเปิดปัญหาและแจ้งให้เราทราบ

การปรับแต่งเพิ่มเติม

หากคุณต้องการแทนที่แต่ละสไตล์ในสไตล์เริ่มต้น คุณสามารถเขียน custom.css ด้วยตัวเอง ซึ่งจะถูกนำเข้าหลังจาก default.css

ตัวอย่าง

example.md -> example.html (โปรดดาวน์โหลด html และเปิดในเบราว์เซอร์)

ตัวอย่างบทความบัญชีสาธารณะ: คำแนะนำฉบับสมบูรณ์เกี่ยวกับการจัดรูปแบบ MarkDown สำหรับบัญชีสาธารณะ WeChat

ใช้สคริปต์ Python [แนะนำ]

หากคุณมีสภาพแวดล้อม Python ติดตั้งอยู่ในคอมพิวเตอร์ของคุณ คุณสามารถเรียกใช้สคริปต์ได้โดยตรง ขอแนะนำให้รับเวอร์ชันเสถียรล่าสุดจากสาขา Master

สภาพแวดล้อมการพัฒนา

พัฒนาโดยใช้ Python 3.5.2 สไตล์ชีต CSS ได้รับการคอมไพล์โดยใช้ LESS ขอแนะนำให้ใช้ในสภาพแวดล้อม Python 3

แพ็คเกจที่ต้องพึ่งพา: Mistune, Premailer, Lescpy

ติดตั้งการอ้างอิงอย่างรวดเร็ว: pip install -r requirements.txt

วิ่ง

เรียกใช้โดยตรง: python maxpress.py

หรือนำเข้าเป็นโมดูล:

 import maxpress

maxpress.convert_all(archive=True, styles=None)

หากคุณต้องการละทิ้งสไตล์เริ่มต้นโดยสิ้นเชิงและเปิดใช้งานสไตล์ชีต CSS ที่กำหนดเอง คุณสามารถส่งผ่านเส้นทางไฟล์ CSS ที่กำหนดเองผ่านพารามิเตอร์ styles (รองรับการส่งผ่านหลายรายการ) จากนั้นจึงส่งพารามิเตอร์ที่ใช้กำหนดสไตล์ใน config.json จะล้มเหลว custom.css จะถูกนำเข้าหลังจากสไตล์ชีตที่คุณกำหนดเองทั้งหมด

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

ตัวอย่าง

example.md -> example.html (โปรดดาวน์โหลด html และเปิดในเบราว์เซอร์)

แผนพัฒนาติดตามผล

• ตัวเลือกในการเพิ่มแบนเนอร์ติดตามที่จุดเริ่มต้นของบทความโดยอัตโนมัติ
• ลดความซับซ้อนของโค้ดและการสร้างใหม่ (ไม่ส่งผลต่อฟังก์ชันการทำงาน)
• รองรับการกำหนดค่าโหมดคำบรรยายที่หลากหลายมากขึ้นในข้อความ
• รองรับการแปลงโพสต์บล็อก Hexo โดยตรง
• ลดความซับซ้อนของกระบวนการปรับแต่ง HTML และ CSS

อ้างอิง

สำหรับแนวคิดการออกแบบและสไตล์เริ่มต้นบางส่วน โปรดดูที่:

• อาจจะ. บทความเกี่ยวกับบัญชีสาธารณะมีรูปแบบอย่างไร?
• หลี่ เซียวไหล markdownhere.css
• เอ็มดีผับ

ใบอนุญาต

เอ็มไอที