سؤال

متابعة بلدي العام الماضي السؤال على وثائق أريد الآن أن تبدأ ومحاولة الخروج القائم على الثعبان أبو الهول لوضع معا المطور وثائق PHP CMS لقد تم العمل على.

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

الآن ليس لدي أي معرفة الثعبان - الحصول على أبو الهول أن العمل سيكون أول اتصال لي مع ذلك - و القليل جدا من الوقت.بقدر ما أفهم, منصة الثعبان المكتبات التطبيق يوفر محرك هي متوافقة جدا على مستوى مكتبة بايثون ولكن ليس متطابقة.

لذا سؤالي هو:

  • يمكن أن أبو الهول تشغيل على محرك التطبيق ؟

  • هو تثبيت أبو الهول على محرك التطبيق مباشرة كما لو كنت تثبيته على أعلى من العادي الثعبان التثبيت ؟ أو التطبيق محرك بيئة تتطلب التغيير والتبديل من التعليمات البرمجية المصدر التي أنا لا يمكن أن تؤدي في وقت معقول مع المستوى الحالي من الثعبان ؟

  • يجب أن يكون تثبيت أبو الهول على الخادم المحلي و "طبيعية" الثعبان مكدس بدلا أولا ؟

  • لا أحد يعرف أي من المفيد كيف ل ، أو دروس أو غيرها من الموارد من أجل هذا ؟

هل كانت مفيدة؟

المحلول

مشروع مثير للاهتمام! المشكلة الرئيسية التي ستعمل عليها هي الوصول إلى نظام الملفات: نظام الملفات على محرك التطبيق هو للقراءة فقط ، واستنادًا إلى النظر إلى المصدر ، يتم ترميز SPHINX إلى حد ما لاستخدام نظام الملفات للإخراج. كما تتوقع قراءة ملف التكوين وملفات الإدخال من نظام الملفات المحلي ، مما سيجعل بناء مستندات لأي شيء آخر غير المشاريع المجمعة مع التطبيق الصعب.

هو - هي هو من الممكن أن تدور حول هذا ، لكنه يتطلب كتابة نظام ملفات افتراضي بسيط يستخدم مخزن بيانات محرك التطبيق ، واستخدام monkeypatching لجعلها تعمل مع واجهة ملف Python العادية. هذا متقدم إلى حد ما لمشروع "جديد إلى بيثون"!

شيء آخر قد ترغب في مراعاته إذا كنت تفكر في السماح للمستخدمين بتوثيق مشاريع: ملف تكوين SPHINX في Python ، لذلك قد يكون تنفيذها خطيرًا - يمكن للمستخدم القيام بأشياء سيئة مع تطبيق تكوين ضار !

نصائح أخرى

أنت لا تحتاج إلى تثبيت أبو الهول على جي على الإطلاق.

يمكنك استخدام الهول إلى إنشاء دليل ثابت HTML, CSS و JS.عند هذه الخطوة الانتهاء, يمكنك ببساطة تحميل الإخراج من أبو الهول-في مجملها.

الإخراج من أبو الهول (HTML, CSS و JS) هو مجرد خدم من مكان واحد.يمكنك تحميل الوثائق من حيث قمت بإنشائه إلى GAE ثابتة الملفات وخدمتهم.القيام به.

لا يوجد "تثبيت على ملقم ويب" إلى جانب تمثال أبو الهول في كل شيء.أبو الهول هو ليس تطبيق ويب;أنه لا يعمل على خادم الويب الخاص بك.يمكنك تشغيله في التنمية لفترة وجيزة نشر وثائق HTML ، اللاتكس أو أيا كان.بمجرد إنشاء HTML ثابتة الملفات التي لم تعد بحاجة إلى أي جزء من تمثال أبو الهول في أي مكان.

يمكن أن أبو الهول تشغيل على محرك التطبيق ؟

أعتقد أنه يمكن ، ولكن أنت لا تحتاج إلى.

هو تثبيت أبو الهول على App Engine بالبساطة...

لا يهم لأنك لا تثبيته من هناك.يمكنك تثبيته على جهاز الكمبيوتر الخاص بك واستخدامها على محطة العمل الخاصة بك.

يجب أن يكون تثبيت أبو الهول على الخادم المحلي و "طبيعية" بايثون مكدس بدلا أولا ؟

لا تثبيت على ملقم.تثبيته على جهاز الكمبيوتر الخاص بك.

لا أحد يعرف أي من المفيد كيف ل ، دروس أو الموارد الأخرى ، من أجل هذا ؟

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

إذا كان "هذا" لا يعني "إنشاء الوثائق مع أبو الهول" ، ثم الجواب هو "ما هو الخطأ مع http://sphinx.pocoo.org?ما تفتقر ؟


وأود أبو الهول هو "المحرك" الذي يتحول الإدخال (تتكون من الراحة الملفات) إلى HTML/CSS/JS أن يكون يمكن الوصول إليها من أي مكان لجعل لي (و ممكن المساهمين الآخرين) مستقلة من معين محطة العمل.

أبو الهول هو مثل مترجم.كل شخص لديه نسخة خاصة بهم على محطة العمل الخاصة بهم.تحميل المستند المصدر في إجراء تغييرات ، لارتكاب المصدر التغييرات و تحميل الوثيقة الناتجة.

خدمة إنشاء وثائق من نفس المكان.

الصحيح.بعد تحميل المصدر إجراء تغييرات تجديد الوثيقة التغييرات ، يمكنك تحميل الوثيقة الناتجة لذلك سوف يكون من واحد-واحد فقط-مكان.

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

الفرق بين النشر محليا عبر dev_appserver وبعد عن طريق appcfg لقد كان - في تجربتي - يقتصر على أي من الأمرين اللذين أقوم بتنفيذه. ومع ذلك ، ليس لدي خبرة مع أبو الهول.

يقوم Sphinx بتجميع الوثائق ، وتشغيله على خادم الويب ، أمر منطقي مثل تشغيل GCC على خادم الويب.

مرخصة بموجب: CC-BY-SA مع الإسناد
لا تنتمي إلى StackOverflow
scroll top