استخدام sphinx لكتابة مواقع ويب ومدونات شخصية

Question

أبو الهول هي مكتبة Python لإنشاء وثائق لطيفة من مجموعة من راحة ملفات نصية منسقة.

أتساءل عما إذا كان أي شخص قد كتب مكونات SPHINX لجعلها إنشاء مواقع ويب ومدونات شخصية.

خاصة بالنسبة للمدونات ، يجب أن تكون هناك وسيلة لإدراج المنشورات تلقائيًا من الناحية الزمنية وإنشاء موجز RSS. يحتاج المرء إلى كتابة مكون إضافي لـ sphinx للقيام بمثل هذا الجيل الخاص بالصفحة/XML.

هل جرب أحد هذا من قبل؟

Answer 1

لقد فعلت ذلك في http://reinout.vanrees.org/weblog. الحيلة الرئيسية هي إضافة خطوة قبل المعالج. لقد حصلت على إدخالات مدونتي في weblog/yyyy/mm/dd/ هيكل المجلد.

يكرر البرنامج النصي من خلال بنية المجلد ، وخلق index.txt الملفات في كل دليل ، وسرد العناصر الفرعية. عملية sphinx العادية ثم تجعل هؤلاء index.txt الملفات.

أضفت معالج sphinx مخصص للعلامات. لذا ".. العلامات :: python ، buildout" في مكان ما في الجزء العلوي من إدخال مدونة الويب الخاص بي يولد العلامات. ويجمع المعالج المسبق هذه الإدخالات مرة أخرى ويكتب أ weblog/tags/TAGNAME.txt ملف الذي يعرض sphinx مرة أخرى بشكل طبيعي.

المعالج المسبق يخلق الجذر أيضًا weblog/index.txt مع أحدث 10 إدخالات. و weblog/atom.xml في (المتشددين) دليل الإخراج لتغذية RSS.

لذلك: أنت بحاجة إلى بعض الأشياء المخصصة ، لكنها نص عادي إلى حد كبير ، لذلك بالنسبة لي كان تمرينًا رائعًا. وتحصل على كتابة بعض البرامج النصية المساعد لجعل الحياة سهلة ، على سبيل المثال واحد ينسخ نصًا من مكان ما إلى دليل مدونة الويب اليوم (بما في ذلك إنشاء الدلائل المفقودة و "إضافة SVN").

Answer 2

اعتبارًا من الآن (فبراير 2012) ، هناك موارد مختلفة متاحة لفعل ما تريد:

محرك مدونة يعتمد على sphinx: http://tinkerer.me/

مدونة Reinout Van Rees: https://github.com/reinout/reinout.vanrees.org

تمديد Contrib التغذية: https://bitbucket.org/birkenfeld/sphinx-contrib/src/tip/feed/readme

Answer 3

دوغ هيلمان ، مؤلف كتاب "وحدة بيثون للأسبوع" يقوم بموقعه باستخدام أبو الهول.

http://www.doughellmann.com/pymotw/

لديه العديد من المنشورات التي تغطي مواضيع أبو الهول التي يمكن أن تساعدك في طريقك:

http://blog.doughellmann.com

Answer 4

إذا كنت بحاجة إلى الكتابة في إعادة هيكلة النص , ، يجب أن تحاول البجع.

Pelican هو مولد موقع ثابت ، مكتوب في بيثون. ستتمكن من كتابة إدخالات المدونة الخاصة بك مباشرة في نص ReterructuredText أو Markdown.

Answer 5

تجدر الإشارة sphinxcontrib.feedوالكثير من الأشياء المرح الأخرى التي تعيش فيها الأشياء http://bitbucket.org/birkenfeld/sphinx-contrib/

(إخلاء المسئولية: كتبت امتداد التغذية.)

Answer 6

الدفع ABLOG لأوبو الهول

أنا بصدد بدء تشغيل مدونة بنفسي باستخدامها.

لقد تعثرت عبره أثناء مرور خلاصاتي في التغذية. لقد بحثت عن ذلك ووجدته مثيرًا للاهتمام. كما أنه يحتوي على تكامل Disqus ، ويمكن أن يولد خلاصات الذرة (غير متأكد تمامًا مما هو عليه في الوقت الحالي ، أنا جديد على الويب)

لم أحسب بعد كيفية نشر مدونة الاختبار الخاصة بي ، وسوف تحديث عندما أجد شيئًا.

Answer 7

ليس sphinx ، ولكن العديد من المواقع في http://codespeak.net/ يتم القيام به باستخدام البرامج النصية التي تأخذ نص REST ، وإنشاء HTML وتحميلها على الموقع. لم أكتب تلك البرامج النصية ، لكنني استخدمتها.

إنها طريقة معقولة لإنشاء مواقع إذا كانت المواقع بحاجة إلى احتواء الكثير من ملفات REST على أي حال ، مثل عند إنشاء وثائق لوحدات Python ، والتي بالطبع هذه المواقع تدور حولها. من الجيد أيضًا أن يتم التحكم في الموقع ، لأنه يمكنك الاحتفاظ بالرمز المصدر في SVN أو HG ، أو شيء من هذا القبيل.

ولكن إذا بدأت في كتابة الكثير من الرجال التلقائيين وغيرهم من الامتدادات ، فإن ما ستنتهي به في النهاية هو نظام إدارة المحتوى. وهناك الكثير من من حولهم بالفعل ، لذلك قد ترغب في النظر إليهم أولاً.

مثال آخر هو الحزم الجديدة .phethon.org. هناك يمكنك إنشاء الوثائق الخاصة بك على أي حال تريدها ، ثم من خلال PYPI قم بتحميل ملف zip-efile مع المستندات. لقد فعل هذا التوزيع مع sphinx: http://packages.python.org/distribute . ولكن لا يلزم وجود نص معين ، وهذا مجرد توليد HTML من وثائق sphinx.

لكن...

يجب أن أقول إنني أجد فكرة كتابة برنامج التدوين على أنه امتداد sphinx مضحك بعض الشيء ، خاصة وأن هناك الكثير من برامج التدوين الممتازة بالفعل. ولم يكن هناك شيء سوف يتغلب على WordPress على أي حال ، وكان WordPress.com تجربة تدوين رائعة بالنسبة لي. ولكن كتمرين في مقدار ما يمكنك إساءة استخدام أبو الهول ، لماذا لا! :-)

Answer 8

أنا أعيد موقع الويب الخاص بي (http://homepage.mac.com/s_lott/steve/) في أبو الهول. إنه يعمل بشكل جيد. للأسف ، فإن مانجليس العلامات _ في عنوان URL الخاص بي.

أنا أيضا إعادة كتابة كامل مقدمة في البرمجة لغير المبرمجين (http://homepage.mac.com/s_lott/books/nonprog/html/index.html) كتاب في أبو الهول. أنا بصدد إعادة كتابة مقدمة إلى بيثون في أبو الهول.

أنا لا أستخدم sphinx للمدونات - إنها ليست مريحة تمامًا ، لكنها ستعمل. أنا أستعمل Blogspot للتدوين المنخفضة/النص العالي والتدوين عالي السرعة نسبيا. أنا استخدم iweb (http://web.me.com/s_lott/travel/welcome.html) للتدوين الرسم العالي والمنخفضة نسبيا.