ikiwiki - عبر الإنترنت في السحابة

برنامج:

اسم

ikiwiki - مترجم ويكي

موجز

ikiwiki [خيارات] وجهة المصدر

ikiwiki - ملف إعداد الإعداد [خيارات]

الوصف

ikiwiki مترجم wiki. يقوم بإنشاء صفحات HTML ثابتة لموقع wiki ، من المصدر في ملف
لغة ikiwiki / Markdown (أو غيرها) ، وتقوم بكتابتها إلى الوجهة.

لاحظ أنه يمكن تقصير معظم الخيارات إلى أحرف مفردة ، وأعلام منطقية مثل - overbose
يمكن إبطالها باستخدام - no-verbose ، وخيارات مثل --verbose يمكن أيضًا تهجئتها مثل
-إفراط.

MODE OPTIONS

تتحكم هذه الخيارات في الوضع الذي يعمل فيه ikiwiki.

--تحديث
قم بتحديث الويكي ، وتحديث أي صفحات تم تغييرها. هذا هو السلوك الافتراضي إذا لم يكن كذلك
تم تحديد إجراء وضع آخر (ولكن لاحظ أن - الإعداد هو إجراء وضع ، ولديه
سلوك افتراضي مختلف).

--إعادة بناء
فرض إعادة بناء جميع الصفحات.

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

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

على سبيل المثال ، لتمكين بعض المكونات الإضافية:

ikiwiki - تغيير الإعداد ~ / ikiwiki.setup --plugin goodstuff - تقويم التوصيل

--ملف إعداد التفريغ
يتسبب في قيام ikiwiki بالكتابة إلى ملف الإعداد المحدد ، مما يؤدي إلى التخلص من ملفه الحالي
ترتيب.

- مغلفة
إذا تم استخدامه مع --setup --refresh ، فهذا يجعله يقوم أيضًا بتحديث أي برامج تضمين تم تكوينها.

--ينظف
هذا يجعل ikiwiki ينظف عن طريق إزالة أي ملفات تم إنشاؤها في الوجهة
الدليل ، بالإضافة إلى أي برامج تضمين تم تكوينها ، ودليل حالة .ikiwiki.
هذا مفيد في الغالب إذا كنت تقوم بتشغيل ikiwiki في ملف Makefile للبناء
الوثائق وتريد هدفًا نظيفًا مطابقًا.

--cgi تمكين وضع CGI. في وضع CGI ، يعمل ikiwiki كبرنامج نصي CGI ، ويدعم التحرير
الصفحات وتسجيل الدخول والتسجيل.

لاستخدام ikiwiki كبرنامج CGI ، تحتاج إلى استخدام --wrapper أو --setup لإنشاء ملف
غلاف. سيحتاج الغلاف بشكل عام إلى تشغيل suid 6755 للمستخدم الذي يمتلك ملف
دلائل المصدر والوجهة.

- غلاف [ملف]
قم بإنشاء غلاف ثنائي مشفر بشكل ثابت للقيام بالإجراء المحدد من قبل الآخر
خيارات ، باستخدام ملفات الإدخال المحددة ودليل الوجهة. اسم الملف إلى
استخدام الغلاف اختياري.

تم تصميم الغلاف ليكون suid بأمان ويتم تشغيله بواسطة مستخدمين غير موثوق بهم ، كملف
خطاف ما بعد الالتزام ، أو باعتباره CGI.

لاحظ أن الغلاف الذي تم إنشاؤه سيتجاهل كافة معلمات سطر الأوامر.

--إجمالي
إذا تم تمكين الإضافات / البرنامج المساعد التجميعي ، فهذا يجعل استطلاع ikiwiki مهيأ
يغذي ويحفظ المشاركات الجديدة في srcdir.

لاحظ أنه لإعادة إنشاء المنشورات المجمعة مسبقًا ، استخدم خيار إعادة البناء معًا
مع هذا الشخص. - ستجبر إعادة البناء أيضًا على استطلاع الأعلاف حتى لو كانت كذلك
استطلعت آراؤهم مؤخرا.

- ملف render
يجسد ملفًا واحدًا ، ويخرج HTML الناتج. لا يحفظ الدولة ، لذلك هذا
لا يمكن استخدامها لبناء مواقع ويكي كاملة ، لكنها مفيدة لمعاينة محرر
ملف في سطر الأوامر. تستخدم بشكل عام مع - الإعداد للتحميل في ملف
إعداد الويكي:

ikiwiki - الإعداد ~ / ikiwiki.setup - عرض foo.mdwn

- ما بعد الالتزام
قم بالتشغيل في وضع ما بعد الالتزام ، كما لو تم استدعاؤه بواسطة خطاف ما بعد الالتزام. هذا هو
ربما يكون مفيدًا فقط عند استخدام ikiwiki مع خادم ويب على مضيف واحد وملف
المستودع على آخر ، للسماح لربط ما بعد الالتزام الحقيقي للمستودع بـ ssh إلى
مضيف خادم الويب وتشغيل ikiwiki يدويًا لتحديث موقع الويب.

--الإصدار
اطبع رقم إصدار ikiwiki.

تكوين OPTIONS

تعمل هذه الخيارات على تكوين الويكي. لاحظ أن الإضافات يمكن أن تضيف تكوينًا إضافيًا
خيارات خاصة بهم. يمكن أيضًا تكوين كل هذه الخيارات والمزيد غير ذلك باستخدام ملف
ملف الإعداد.

- اسم اسم وويكين
اسم موقع wiki ، الافتراضي هو "wiki".

--templatedir دير
حدد الدليل الذي يتم تخزين القوالب فيه. الافتراضي هو
/ usr / share / ikiwiki / Templates ، أو أي موقع آخر تم تكوينه في وقت الإنشاء. لو
تم تغيير Templatedir ، وسيظل البحث عن القوالب المفقودة في ملف
الموقع الافتراضي كإجراء احتياطي. يمكن أيضًا وضع القوالب في "القوالب /"
دليل فرعي من srcdir.

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

--underlaydir دير
حدد الدليل الذي يتم استخدامه لتركيب الدليل المصدر. ملفات المصدر
سيتم أخذها من هنا ما لم يتم تجاوزها بواسطة ملف في دليل المصدر.
الافتراضي هو / usr / share / ikiwiki / basewiki أو موقع آخر تم تكوينه في build
مرة.

- وضع الالتفاف
حدد وضع chmod للغلاف بعد إنشائه.

- مجموعة ورابيرجروب
حدد مجموعة unix التي يجب أن يمتلكها الغلاف. يمكن أن يكون هذا مفيدًا إذا كان ملف
يجب أن يكون برنامج التضمين مملوكًا لمجموعة أخرى غير المجموعة الافتراضية. على سبيل المثال ، إذا كان ملف
يحتوي المشروع على مستودع به ملتزمون متعددون مع إمكانية الوصول التي يتحكم فيها ملف
المجموعة ، فمن المنطقي أن تقوم أغلفة ikiwiki بتشغيل setgid لتلك المجموعة.

--rcs = svn | git | .. ، - no-rcs
تمكين أو تعطيل استخدام revision_control_system.

يُفترض أن يكون دليل المصدر نسخة عاملة ، أو نسخة ، أو أيًا كان
يستخدم نظام التحكم في المراجعة الذي تختاره.

في وضع CGI ، مع تمكين نظام التحكم في المراجعة ، سيتم تحرير الصفحات عبر الويب
أن تلتزم.

لا يتم تمكين التحكم في المراجعة بشكل افتراضي.

--svnrepo / svn / wiki
حدد موقع مستودع svn الخاص بـ wiki.

--svnpath الجذع
حدد المسار داخل مستودع svn الخاص بك حيث يوجد wiki. هذا
الافتراضات على الجذع. قم بتغييره إذا كان موقع wiki الخاص بك في مسار آخر داخل ملف
مخزن. إذا كان موقع wiki الخاص بك متجذرًا في أعلى المستودع ، فاضبط svnpath على "".

--rss، - norss
إذا تم تعيين rss ، فسيقوم ikiwiki افتراضيًا بتوليد موجزات RSS للصفحات المضمنة
بلوق.

--الورص
إذا تم تعيين allowrss ولم يتم تعيين rss ، فلن يقوم ikiwiki افتراضيًا بإنشاء RSS
feeds ، ولكن تعيين rss = نعم في التوجيه المضمَّن يمكن أن يتجاوز هذا الإعداد الافتراضي و
توليد تغذية.

- ذرة ، - نواتوم
إذا تم تعيين atom ، فسيقوم ikiwiki افتراضيًا بتوليد موجز Atom للصفحات المضمنة
بلوق.

--الوواتوم
إذا تم تعيين allowatom ، ولم يتم تعيين rss ، فلن يتم إنشاء ikiwiki بشكل افتراضي
خلاصات Atom ، ولكن تعيين atom = نعم في التوجيه المضمن يمكن أن يتجاوز هذا الإعداد الافتراضي
وتوليد موجز.

--pingurl URL
قم بتعيين هذا إلى عنوان URL لخدمة XML-RPC على ping عند تحديث موجز RSS. ل
على سبيل المثال ، لـ ping Technorati ، استخدم عنوان URL http://rpc.technorati.com/rpc/ping

يمكن تحديد هذه المعلمة عدة مرات لتحديد أكثر من عنوان URL
بينغ.

- URL URL
يحدد عنوان URL الخاص بـ wiki. هذه معلمة مطلوبة في وضع CGI.

- cgiurl http://example.org/ikiwiki.cgi
يحدد عنوان URL لغلاف البرنامج النصي ikiwiki CGI. مطلوب عند بناء
ويكي للروابط إلى نص CGI الذي سيتم إنشاؤه.

--historyurl URL
يحدد عنوان URL للارتباط به لاستعراض محفوظات الصفحة. في عنوان URL ، يكون "[[ملف]]"
استبداله بالملف للتصفح. من الشائع استخدام ViewVC لهذا الغرض.

- adminemail [البريد الإلكتروني محمي]
يحدد عنوان البريد الإلكتروني الذي يجب أن يستخدمه ikiwiki لإرسال البريد الإلكتروني.

--عنوان URL مختلف
يحدد عنوان URL للارتباط بمختلف التغييرات التي تطرأ على الصفحة. في عنوان URL ،
تم استبدال "[[file]]" بالملف المراد استعراضه ، "[[r1]] هي النسخة السابقة من
الصفحة ، و "[[r2]]" هي المراجعة الجديدة. من الشائع استخدام ViewVC لهذا الغرض.

- استبعاد التعبير العادي
يحدد rexexp للملفات المصدر لاستبعادها من المعالجة. قد تكون محددة
عدة مرات لإضافتها إلى قائمة الاستبعاد.

- بما في ذلك التعبير العادي
يحدد rexexp للملفات المصدر ، التي عادة ما يتم استثناؤها ، ولكنك
ترغب في تضمينها في المعالجة. يمكن تحديدها عدة مرات لإضافتها لتضمينها
قائمة.

- اسم المشرف
يحدد اسم مستخدم لمستخدم (أو ، إذا تم تمكين openid ، معرف مفتوح) الذي لديه الامتداد
صلاحيات مشرف الويكي. يسمح حاليًا بقفل أي صفحة ، وحظر المستخدمين ، مثل
بالإضافة إلى الصلاحيات الممنوحة بواسطة المكونات الإضافية الممكّنة (مثل [[moderating
التعليقات | المكونات الإضافية / التعليقات الوسيطة]] والمكونات الإضافية / مجموعة الويب. قد تكون محددة
عدة مرات لعدة مدراء.

بالنسبة لمستخدم مفتوح ، حدد عنوان URL الكامل لتسجيل الدخول ، بما في ذلك "http: //".

- اسم التوصيل
لتمكين استخدام المكون الإضافي المحدد في الويكي. لاحظ أن أسماء المكونات الإضافية هي
حساسية الموضوع.

--تعطيل اسم البرنامج المساعد
تعطيل استخدام البرنامج المساعد. على سبيل المثال "--disable-plugin htmlscrubber" للتخلص منه
مع تنقية HTML.

- دليل بدير
يجعل ikiwiki يبحث في الدليل المحدد أولاً ، قبل المواقع العادية
عند تحميل ملفات المكتبة والمكونات الإضافية. على سبيل المثال ، إذا قمت بتعيين libdir على
"/home/you/.ikiwiki/" ، يمكنك تثبيت مكون إضافي foo.pm بتنسيق
"/home/you/.ikiwiki/IkiWiki/Plugin/foo.pm".

- مناقشة ، - لا مناقشة
لتمكين أو تعطيل روابط "المناقشة" من إضافتها إلى رأس كل ملف
صفحة. الروابط ممكّنة بشكل افتراضي.

- روابط خفية n
يتحكم في عدد الروابط الخلفية التي يجب عرضها أسفل الصفحة. إفراط
سيتم إخفاء الروابط الخلفية في نافذة منبثقة. الافتراضي هو 10. اضبط على 0 لتعطيل هذا
ميزة.

--سديردير سوبدير
اختياريًا ، يسمح للروابط لمستخدمي wiki بالارتباط بصفحات داخل ملف
دليل فرعي للويكي. الإعداد الافتراضي هو الارتباط بالصفحات الموجودة في دليل المستوى الأعلى
من الويكي.

- html
تكوين الامتداد المستخدم لملفات html المُنشأة. الافتراضي هو "html".

- تنسيق الوقت
حدد كيفية عرض الوقت أو التاريخ. يتم تمرير سلسلة التنسيق إلى
com.strftime(3) وظيفة.

- الإسراف ، - لا مطول
كن واسعا بشأن ما يتم القيام به.

--syslog ، - no-syslog
تسجيل الدخول إلى سيسلوغ(3).

- مستعملون ، - غير مستعملون
بدّل إنشاء ملفات الإخراج المسماة page / index.html (افتراضي) بدلاً من page.html.

- توجيهات - بادئة - توجيهات - بدون بادئة
تبديل "!" الجديد - بناء جملة مسبوق لتوجيهات المعالج المسبق. ikiwiki حاليا
الافتراضي إلى - تعليمات - بادئة.

--w3mmode ، - no-w3mmode
قم بتمكين w3mmode ، والذي يسمح لـ w3m باستخدام ikiwiki كنص CGI محلي ، بدون ملف
قاعدة بيانات للانترنت.

--sslcookie
إرسال ملفات تعريف الارتباط عبر اتصال SSL فقط. هذا يجب أن يمنعهم من أن يكونوا
اعترضت. إذا قمت بتمكين هذا الخيار ، فيجب عليك تشغيل جزء CGI على الأقل
من ikiwiki عبر SSL.

- الوقت المناسب ، - لا وقت
استخراج أوقات الإنشاء والتعديل لكل صفحة جديدة من المراجعة
سجل التحكم. يتم ذلك تلقائيًا عند إنشاء موقع wiki لأول مرة ،
لذلك عادة لا تحتاج إلى استخدام هذا الخيار.

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

- ضبط- yaml var = القيمة
هذا يشبه --set ، لكنه يسمح بتعيين متغيرات التكوين التي تستخدم معقدة
هياكل البيانات ، عن طريق تمرير وثيقة YAML.

أمثلة

ikiwiki - إعداد my.setup

بالكامل (إعادة) بناء الويكي باستخدام ملف الإعداد المحدد.

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

ikiwiki - إعداد my.setup - تحديث - أغلفة
قم بتحديث موقع wiki ، بما في ذلك إعادة إنشاء كافة برامج التضمين ، لكن لا تقم بإعادة الإنشاء
كل الصفحات. مفيد إذا قمت بتغيير شيء ما في ملف الإعداد لا
تحتاج إلى إعادة بناء wiki كاملة لتحديث جميع الصفحات ، ولكنك تريد أن تأخذها على الفور
تأثير.

ikiwiki - إعادة بناء srcdir destdir
استخدم srcdir كمصدر وأنشئ HTML في destdir ، دون استخدام ملف إعداد.

ikiwiki srcdir destdir
استخدم srcdir كمصدر لتحديث HTML للصفحات التي تم تغييرها في destdir ، دون استخدام ملف
ملف الإعداد.

البيئة

CC

يتحكم هذا في استخدام مترجم C لبناء أغلفة. الافتراضي هو "cc".

CFLAGS يمكن استخدام هذا لتمرير الخيارات إلى مترجم C عند بناء الأغلفة.

استخدم ikiwiki عبر الإنترنت باستخدام خدمات onworks.net