وثائق Jekyll إلى PDF مع TOC

Question

أود أن أكتب الوثائق باستخدام جيكل مع مخرجات HTML و PDF. يمكن أن يكون لدى HTML تنقل ولكن يجب أن يكون لدى PDF جدول المحتويات. هل هناك طريقة مجانية وسهلة للقيام بذلك؟

جزء HTML سهل ، لكنني أرغب في استخدام Media Print CSS لصنع ملف PDF.

لدي بعض الأفكار كيفية القيام بذلك.

1. يستخدم Princexml, ، لسوء الحظ ، هذا منتج تجاري بسعر سيء ~ 500 دولار
2. يستخدم wkhtmltopdf
3. يستخدم ماروكو, ، لأنه من الممكن إجراء تحويل PDF باستخدامه

أرغب في الحصول على صفحات متعددة HTML و pdf صفحة واحدة مع TOC. أي اقتراحات؟

بالمناسبة. بناء لقد حلت هذه المشكلة باستخدام Princexml.

Answer 1

إذا كان "Free" هو المعيار الأكثر أهمية ، فهو WKHTMLTOPDF هو أفضل رهان لك. وهو يدعم أشياء مثل الأغطية ، TOC ، الرؤوس ، تذييلات وأقسام. اعتمادًا على مدى غرابة تخطيط المستند الخاص بك ، فمن المحتمل أن تواجه بعض مشكلات تكسير الصفحات ، ولكن مع القليل من العبث ، يجب أن تكون على ما يرام.

لقد كنت أستخدم WKHTMLTOPDF الآن قليلاً ، مع بعض المستندات المعقدة للغاية (مع مخططات JavaScript ، والجداول ، وصور SVG ، وما إلى ذلك) ولم تواجه الكثير من المشكلات.

تأكد من استخدام الإصدار الثابت من WKHTMLTOPDF ، لأنه الإصدار الوحيد الذي يدعم تقديم صفحة TOC.

Answer 2

• لإنشاء جدول محتويات باستخدام Jekyll ، يمكنك استخدم ال {:toc} دقيق المقدمة عن طريق Markdown ، أو اكتب خاصة بك مرشح جدول المحتويات من النسيج إذا كنت تفضل استخدام النسيج ..
• لتوليد PDF من HTML و CSS ، لقد وجدت WeasyPrint أن تكون حلاً جيدًا. نظرًا لأنهم لا يعتمدون على محرك خارجي لتقديمه ، فإنهم لا يعتمدون على خرائط طريق المشروع الأجنبية لتنفيذ الميزات ذات الصلة مثل المحتوى الذي تم إنشاؤه CSS أو @page CSS-Declarations. (ولكن على عكس WKHTMLTOPDF ، لا يحلل WeasyPrint JavaScript).

Answer 3

يمكنك استعمال ال pdfkit جوهرة ، والتي تستخدم wkhtmltopdf وراء الكواليس. ثم يمكنك وضع منطق PDF في مكون إضافي Jekyll كمولد أو محول.