कुछ अच्छे स्फिंक्स अनुकूलन उदाहरण?

Question

मैंने sphinx-quickstart का उपयोग करके एक स्फिंक्स दस्तावेज़ बनाया है।

1. वहाँ किसी भी अच्छे उदाहरण/देखो अनुकूलित करने के बारे ट्यूटोरियल हैं? विशेष रूप से हेडर को संशोधित करने और लोगो जोड़ने के लिए।

2. क्या डाउनलोड करने योग्य स्पिंक्स डॉक्स के साथ कुछ परियोजनाएं हैं? मैं देखना चाहता हूं कि उन्होंने अपना स्वरूप कैसे अनुकूलित किया है।

अद्यतन: एक लोगो जोड़ना डिफ़ॉल्ट सेटअप में समर्थित है, न कि केवल विशेष रूप से अच्छी तरह से प्रलेखित। *_logo सेटिंग्स के लिए

Answer 1

these themes पर कुछ देखें। चूंकि परियोजनाएं खुले स्रोत हैं, इसलिए आप उन्हें बारीकी से जांचने में सक्षम होना चाहिए।

Answer 2

Matplotlib documentation मुझे लगता है कि एक उत्कृष्ट उदाहरण है। उनके पास documenting matplotlib पर विस्तृत विवरण भी है: dynamically generated figures और inheritance diagrams स्फिंक्स मुझे लगता है कि उनके कस्टम एक्सटेंशन हैं। उनके दस्तावेज में एक कस्टम लोगो भी है।

मुझे लगता है कि आप अधिकांश परियोजनाओं के लिए आरएसटी दस्तावेज़ स्रोत डाउनलोड करने में सक्षम होना चाहिए।

Answer 3

http://docs.djangoproject.com/en/1.1/ और http://ask.github.com/celery/ दो अच्छे उदाहरण हैं।

Answer 4

मुझे हमेशा SQLAlchemy दस्तावेज़ पसंद आया है। वे मानक स्फिंक्स विषयों से बहुत अलग दिखते हैं और अपनी साइट पर बहुत अच्छी तरह से फिट बैठते हैं।

Answer 5

blender.org की नई एपीआई डॉक्स सिर्फ एक बदलाव मिला स्फिंक्स विषय डाउनलोड करने योग्य है भी

साइट
http://www.blender.org/documentation/blender_python_api_2_59_release

मुख्य साइट (जो विषय पर आधारित है)
http://www.blender.org/

थीम फ़ाइलें
https://svn.blender.org/svnroot/bf-blender/trunk/blender/doc/python_api/blender-org/

मुझे पता है कि सिर्फ एक उदाहरण है, लेकिन यह देखना दिलचस्प है कि मैच कितना करीब है।

Answer 6

लिंक एकत्र करना शुरू करने का समय।

• https://github.com/coordt/ADCtheme - सेब की तरह
• https://github.com/mitsuhiko/flask-sphinx-themes - बोतल
• http://loose-bits.com/2012/11/19/sphinx-bootstrap-theme-updates.html - ट्विटर बूटस्ट्रैप
• https://github.com/snide/sphinx_rtd_theme - पढ़ें की थीम डॉक्स
• https://github.com/bitprophet/alabaster - बोतल के आधार पर

Answer 7

जाओ http://pypi.python.org पर और वहां sphinx template खोजें। यह कुछ दस टेम्पलेट्स की एक सूची देगा। फिर उनमें से प्रत्येक आप डाउनलोड और कोशिश कर सकते हैं।

Answer 8

मैं Kenneth Reitz के विषय के एक बड़े प्रशंसक वह requests पुस्तकालय के लिए उपयोग करता हूँ:

https://github.com/kennethreitz/kr-sphinx-themes