صفحات متعددة HTML إخراج من وثيقة .RST في Django

Question

أنا أكتب تطبيق Django لخدمة بعض الوثائق المكتوبة في RepructuredText. لدي العديد من المستندات المكتوبة بـ *.rst ، كل منها طويل جدًا مع العديد من الأقسام ، القسم الفرعي وما إلى ذلك.

عرض المستند بأكمله في صفحة واحدة ليس مشكلة باستخدام مرشحات Django ، لكنني أفضل فقط أن يكون لديك فهرس الموضوع في الصفحة الأولى ، يرتبط بعنوان URL حيث يمكنني عرض قسم / قسم فرعي واحد (والذي سيحتاج إلى بعض "السابق | UP | Home | Next" رابط أعتقد ...). بطريقة تشبه "إخراج صفحة HTML المتعددة" كما هو الحال في تحويل DOCBOOK / XML لتحويل HTML.

هل يمكن لأي شخص أن يوجهني إلى بعض الاتجاه لإنشاء شجرة مستندات من A *.RST وثيقة تحليل واحد منه ، أو اقتراح طريقة ذكية للحصول على نتيجة مماثلة؟

Answer 1

الاختيار 1. قم بتضمين روابط عنوان URL للأجزاء الأخرى من المستند.

يمكنك كتابة index.rst ، part1.rst ، part2.rst ، وما إلى ذلك ، و index.rst لديه روابط للأجزاء الأخرى. هذا لا يتطلب أي عمل تقريبًا ، باستثناء التخطيط الدقيق للتأكد من صحة روابط HTML الخاصة بك.

لا يوجد "تحليل". يمكنك فقط تقسيم المستند إلى أقسام. يدويًا.

هذا يبدو واضحًا جدًا ، أخشى أن أذكر ذلك.

الاختيار 2. الاستخدام أبو الهول. إنه يدير جدول المحاميات واتصالات الحوليات بشكل جيد للغاية.

ومع ذلك ، لا يتم التعامل مع امتدادات sphinx إلى RST مباشرة بواسطة Django ، لذلك ستحتاج إلى حفظ إخراج sphinx ثم عرض ذلك في Django. نستخدم منشئ JSON HTML (http://sphinx.pocoo.org/builders.html؟highlight=json#sphinx.builders.html.jsonhtmlbuilder) الإخراج من أبو الهول. ثم نقدم هذه المستندات من خلال قالب.