redtape เป็นเครื่องกำเนิดไฟฟ้าที่เน้นเอกสารที่ใช้ markdown รส GitHub เพื่อสร้างง่ายเอกสาร HTML ที่น่าสนใจ โดยจะทำงานร่วมกับบูต Twitter และมีง่าย, การออกแบบที่น่าสนใจ redtape เป็นแรงบันดาลใจง แต่ความพยายามที่จะมีอินเตอร์เฟซที่เรียบง่ายในขณะที่ยังช่วยให้ผู้ใช้รูปแบบและการควบคุมเอกสารการส่งออกของพวกเขาในระดับสูงของการปรับแต่ง
การติดตั้ง
ถ้าคุณอยู่ในลินุกซ์หรือ OSX คุณสามารถใช้จุดในการติดตั้ง:
> PIP ติดตั้ง redtape
ซึ่งจะติดตั้ง redtape และพึ่งพา
การใช้งาน
ที่จะใช้วิ่ง RT ในเอกสารหรือไดเรกทอรีเต็มรูปแบบของเอกสาร หากทำงานในไดเรกทอรี RT จะสร้างไฟล์ html สำหรับไฟล์ทุก markdown (.md, .mdown หรือนามสกุล .markdown):
> RT mydocument.md
> เอกสาร RT /
สินทรัพย์
โดยค่าเริ่มต้น RT จะถือว่าคุณได้ตั้งค่าสถานที่ที่จะให้บริการไฟล์ที่มีสินทรัพย์ที่ rt เชื่อมโยงลงในเอกสารเหล่านี้ รูปแบบเป็นสิ่งเดียวกับไดเรกทอรีสินทรัพย์ในพื้นที่เก็บข้อมูล redtape: / สินทรัพย์ / {CSS, img, JS} / .. สำหรับสินทรัพย์แต่ละประเภทที่คุณจะใช้ ถ้าคุณต้องการที่จะใช้สินทรัพย์ redtape เริ่มต้นของคุณสามารถสร้างไดเรกทอรีสินทรัพย์ที่เหมาะสมในไดเรกทอรีปัจจุบันโดยทำงาน:
> RT --create-สินทรัพย์
หากคุณกำลังทำงานในโหมดเอกสารเดียวหรือไม่ต้องการที่จะตั้งค่าไดเรกทอรีสินทรัพย์บนโฮสต์ที่สุดสำหรับเอกสาร HTML ของคุณคุณสามารถบอก redtape ฝังสินทรัพย์แต่ละประเภทที่ใช้ในเอกสารโดยใช้ --embed:
> RT --embed mydocument.md
จาวาสคริปต์
โดยค่าเริ่มต้น redtape ไม่จำเป็นต้องใช้งาน JavaScript ใด ๆ ในการทำงานและจะไม่ฝังใด ๆ ในโหมด --embed ถ้าตัวเลือก --prettify ถูกเลือกของ Google เสริมสวยห้องสมุดจะถูกใช้สำหรับแหล่งที่มาไฮไลต์แทน pygments และถ้า --prettify และ --embed มีทั้งที่ใช้ก็จะได้รับการฝังตัวโดยอัตโนมัติ
Redtape นี้ยังเหมาะสำหรับการสาธิตจาวาสคริปต์หน้าเดียวง่ายและถ้า --use-JS ถูกเปิดใช้งาน redtape จะรวมถึง jQuery และบูตห้องสมุด JavaScript
การปรับแต่งการแสดงผล
การปรับแต่งการแสดงผลเป็นเรื่องง่ายที่จะทำในหลายวิธี นอกจากนี้การเปลี่ยน CSS สินทรัพย์สำหรับเอกสารที่ไม่ฝังตัวคุณยังสามารถเพิ่มส่วนหัวและท้ายกระดาษหรือแม้กระทั่งการใช้แม่แบบเอกสารที่กำหนดเองขึ้นอยู่กับแม่แบบเริ่มต้นของ redtape
ส่วนหัวและท้ายกระดาษ
หากคุณมีส่วนหัวของเอกสารที่กำหนดเองหรือส่วนท้ายที่คุณต้องการเพิ่มลงในเอกสารของคุณคุณจะสามารถเพิ่ม header.html และเอกสาร footer.html ไปยังไดเรกทอรีพื้นฐานที่ท่านได้แสดงผลหรือตั้งค่าเริ่มต้นเส้นทางที่จะใช้ในการตั้งค่าเป็นส่วนหัวและท้าย โดยค่าเริ่มต้นเหล่านี้จะถูกวางไว้ที่ด้านบนและด้านล่างของเอกสารของคุณตามลำดับ
ชุดตัวอย่างของเอกสารที่อาจจะ:
> LS MyDocs /
MyDocs / index.md MyDocs / simple.md MyDocs / advanced.md
MyDocs / header.html MyDocs / footer.html
การแสดงผล MyDocs กับ MyDocs RT จะใช้ส่วนหัวและส่วนท้ายของเอกสารในแต่ละไดเรกทอรี
แม่แบบกำหนดเอง
หากคุณมีความต้องการที่เฉพาะเจาะจงมากคุณสามารถเขียนแม่แบบเอกสารของคุณเองและมีการควบคุมทั้งหมดของการส่งออก Redtape ใช้เครื่องยนต์ jinja2 templating ซึ่งเป็นระบบที่ใช้กันอย่างแพร่หลาย templating คล้ายกับ django แม่ เรียก redtape กับอาร์กิวเมนต์ --context ที่จะได้รับความคิดที่สั้น ๆ ของสิ่งตัวแปรที่มีอยู่กับแม่แบบ
นอกจากนี้คุณยังสามารถสืบทอดจาก basic.jinja ซึ่งเป็นชื่อของแม่แบบเริ่มต้นของ redtape แม่แบบนี้กำหนดสองบล็อกหัวและลำตัวซึ่งจะช่วยให้คุณสามารถฝีมือในขณะที่ร่างกายเอกสารที่แตกต่างกันเช่นการรักษา CSS ขั้นพื้นฐานและการทำงานของ JavaScript redtape เอาชนะทั้งสองจะทำให้คุณมีมาตรฐานโครงสร้างเอกสาร HTML5
คุณสามารถระบุแม่แบบกำหนดเองที่จะใช้กับ -t, --template หรือวางไว้ในไดเรกทอรีเอกสารเป็น custom.html หรือ custom.jinja
ต้องการ .
- หลาม
ความคิดเห็นที่ไม่พบ