Jekyll टीओसी

Question

साथ पीडीएफ करने के लिए प्रलेखन मैं चाहूँगा HTML और PDF आउटपुट के साथ Jekyll का उपयोग करके दस्तावेज़ लिखने के लिए। एचटीएमएल में नेविगेशन हो सकता है लेकिन पीडीएफ में सामग्री की सारणी होनी चाहिए। क्या ऐसा करने का एक स्वतंत्र और आसान तरीका है?

एचटीएमएल हिस्सा आसान है, लेकिन मैं पीडीएफ फाइल बनाने के लिए @media प्रिंट सीएसएस का उपयोग करना चाहते हैं।

मैं कैसे यह करने के लिए कुछ विचार है।

1. उपयोग PrinceXML, दुर्भाग्य से यह एक बुरा कीमत ~ $ 500
2. उपयोग WKHTMLTOPDF
3. उपयोग Maruku के साथ वाणिज्यिक उत्पाद है, क्योंकि यह इसे का उपयोग

मैं एक पीडीएफ रूपांतरण के लिए संभव है एक टीओसी के साथ कई पेज एचटीएमएल और एकल पेज पीडीएफ चाहते हैं। कोई सुझाव?

बीटीडब्ल्यू। Buildr ने PrinceXML का उपयोग करके इस समस्या को हल किया है।

Answer 1

यदि 'मुक्त' अपने सबसे महत्वपूर्ण कसौटी है, wkhtmltopdf से आपका सर्वश्रेष्ठ दांव है। यह कवर, टोक, हेडर, पाद लेख और अनुभागों जैसी चीजों का समर्थन करता है। इस पर निर्भर करते हुए कि आपके दस्तावेज़ का लेआउट कितना विदेशी होगा, आप शायद कुछ पेज-ब्रेक मुद्दों में भाग लेंगे, लेकिन थोड़ी सी झुकाव के साथ आपको ठीक होना चाहिए।

मैं कुछ जटिल दस्तावेजों (जावास्क्रिप्ट चार्ट, टेबल, एसवीजी छवियों, आदि के साथ) के साथ wkhtmltopdf का उपयोग कर रहा हूं, और बहुत से मुद्दों में नहीं चला है।

आप, wkhtmltopdf के स्थिर संस्करण का उपयोग के रूप में यह केवल संस्करण है जो एक टीओसी पृष्ठ की प्रस्तुति का समर्थन करता है सुनिश्चित करें।

Answer 2

आप PDFKit मणि, जो पर्दे के पीछे wkhtmltopdf का उपयोग करता है का उपयोग कर सकते हैं। फिर आप जनरेटर या कनवर्टर के रूप में अपने पीडीएफ तर्क को जेकिल प्लगइन में डाल सकते हैं।

Answer 3

• Jekyll का उपयोग कर सामग्री तालिका पैदा करने के लिए, आप use the {:toc} macro markdown द्वारा की पेशकश कर सकते हैं, या अपने स्वयं textile table of contents filter आप .. कपड़ा उपयोग करने के लिए
• HTML और सीएसएस से एक पीडीएफ पैदा करने के लिए पसंद करते हैं, मैं पाया है लिखना weasyprint एक अच्छा समाधान होने के लिए। चूंकि वे प्रतिपादन के लिए बाहरी इंजन पर भरोसा नहीं करते हैं, इसलिए वे सीएसएस जेनरेट की गई सामग्री या @page सीएसएस-घोषणाओं जैसी प्रासंगिक विशेषताओं को लागू करने के लिए विदेशी परियोजना के रोडमैप पर निर्भर नहीं हैं। (लेकिन wkhtmltopdf के विपरीत, weasyprint जावास्क्रिप्ट का विश्लेषण नहीं करता है)।