عبد العزيز: بوت: تحديث استخدام القالب

2023-10-20T04:05:09Z

بوت: تحديث استخدام القالب

→ نسخة أقدم		نسخة 08:05، 20 أكتوبر 2023
(لا فرق)

عبد العزيز: بوت: تحديث استخدام القالب

2023-10-20T04:05:09Z

بوت: تحديث استخدام القالب

صفحة جديدة

{{صفحة توثيق فرعية}}
{{استخدام واسع|{{Bots/شرح/عداد}}}}
{{Lua|Module:String}}
{{ميز|قالب:بوت}}
هذا القالب يوضح [[أرابيكا:بوت|للبوت]] أو أي أداة تحرير آلية أنه يجب ألا يقوم بتحرير الصفحة التي تحتوي هذا القالب. يُستخدم القالب لمنع مُعظم البوتات (كل البوتات التي تستخدم هذه الخاصية) أو تمنع بوتات محددة بالاسم أو تمنع وظيفة محددة. على سبيل المثال، يمكن استخدامه للسماح أو لمنع رسائل البوت أو لجعل بوتات الصيانة تتخطى صفحةٍ ما. هذا القالب يجب استخدامه بعناية خارج صفحات المستخدمين لكي لا نفقد تعديدلات مهمة للبوتات.

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

== ملاحظات مهمة ==

معظم البوتات لن تفهم هذه القوالب عندما يتم تضمينها بشكل غير مباشر.

معظم البوتات لن تتجاهل القالب إذا كان داخل علامات '''<nowiki><now</nowiki><nowiki>iki> ... </now</nowiki><nowiki>iki></nowiki>'''. على سبيل المثال، إذا كنت تناقش القوالب مع محرر آخر، يُرجى استخدام القالب {{قا|قا}}، مثل <code><nowiki>{{قا|Bots}}</nowiki></code>، الذي سيعرض {{قا|Bots}}، بدلاً من <code><nowiki><no</nowiki><nowiki>wiki>{{Bots}}</now></nowiki><nowiki>iki></nowiki></code>، الذي قد يُعامل على أنه محاولة لحظر البوتات من الصفحة.

== استخدام القالب ==
{| class="wikitable"
! الاستخدام !! النتيجة
|-
|'''<nowiki>{{nobots}}</nowiki>''' || منع جميع البوتات (اختصار)
|-
|'''<nowiki>{{bots}}</nowiki>''' || السماح لجميع البوتات (اختصار)
|}

{| class="wikitable"
! الاستخدام !! النتيجة
|-
|'''{{نص يسار}}<nowiki>{{bots|allow=<botlist>}}</nowiki>''' || منع جميع البوتات غير الموجودة في القائمة
|-
| '''{{نص يسار}}<nowiki>{{bots|deny=<botlist>}}</nowiki>''' || منع جميع البوتات الموجودة في القائمة
|}

يتم فصل أسماء البوتات في بفاصلة <botlist> مثل:
* '''<nowiki>{{bots|allow=HagermanBot,Werdnabot}}</nowiki>'''
* '''<nowiki>{{bots|deny=AWB}}</nowiki>'''

''<botlist> يكون أيضًا أن تكون قيمة الوسيط "none" أو "all" كما في الأمثلة التالية:''
{| class="wikitable"
! الاستخدام !! النتيجة
|-
| '''<nowiki>{{bots|allow=all}}</nowiki>''' || السماح لجميع البوتات
|-
| '''<nowiki>{{bots|allow=none}}</nowiki>''' || منع جميع البوتات
|-
| '''<nowiki>{{bots|deny=all}}</nowiki>''' || منع جميع البوتات
|-
| '''<nowiki>{{bots|deny=none}}</nowiki>''' || السماح لجميع البوتات
|}

البوتات غير ملزمة بمراعاة قالب "nobots"؛ سيعتمد ذلك على وظيفتها ومالكيها وشروط موافقتها. البوتات التي تدعم حالياً استبعاد القوالب مدرجة في [[:تصنيف:بوتات أرابيكا تقبل الاستثناء|بوتات يمكن استبعادها]].

== صيغة غير صحيحة ==

تبدو هذه الصيغة صحيحة، ولكن قد لا تكون لها التأثير المقصود تبعًا للبوت الفردي. قد تمنع هذه البيانات كل من بوت1 وبوت2، أو قد تمنع أحد البوتين فقط، أو تمنع كلا البوتين كما هو المقصود.

'''<nowiki>{{Bots|deny=Bot1|deny=Bot2}}</nowiki>''' خاطئ

بدلاً من ذلك، اكتب:

'''<nowiki>{{Bots|deny=Bot1,Bot2}}</nowiki>''' صحيح

== الاختيار بعدم الإشعار بالرسائل ==
{{صندوق رسالة أخرى| النص = نظام الرسائل هذا غير مُستخدم حاليًا في أرابيكا العربية!}}
خيار آخر هو الاختيار بعدم الاشعار بأنواع محددة من الرسائل للمستخدمين الذين يرغبون في التلقي إشعارات ببعض المشكلات ولكن ليس كلها. يجب على المستخدمين أن يكونوا على علم بأنه من خلال عدم التوجيه لرسائل الإشعار الخاصة، فإنهم لن يتلقوا إشعارات بالأمور المتعلقة بالمواد التي قاموا بتحريرها أو تحميلها، والتي تم وسمها وفقًا للسياسة. يمكن تنفيذ أعمال (مثل الحذف) دون أن تتلقى إشعارًا نتيجة لذلك. من خلال تطبيق هذا على صفحة نقاش المستخدم الخاصة بك، فإنك توافق على هذا العواقب. سيتم اعتبار تطبيق هذا على صفحة نقاش مستخدم آخر بخرق للقوانين. يشجع على جميع البوتات والنصوص التي تترك رسائل على صفحة نقاش المستخدم على إضافة هذه القدرة.

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

'''<nowiki>{{Bots|optout=all}}</nowiki>''' الاختيار بعدم الاشعار بجميع الرسائل (انظر القيود أدناه).

'''<nowiki>{{Bots|optout=nosource}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:مصدر الملف|عدم وجود مصدر]].
'''<nowiki>{{Bots|optout=nolicense}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:حقوق الصورة|عدم وجود ترخيص]].
'''<nowiki>{{Bots|optout=orfud}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:Di-orphaned fair use-notice|صور غير مألوفة يتيمة]].
'''<nowiki>{{Bots|optout=npd}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:Di-no permission-notice|بدون إذن]].
'''<nowiki>{{Bots|optout=norationale}}</nowiki>''' اختيار عدم استلام رسائل {{Ill-WD2|بدون تفسير|id=Q10994777}}.
'''<nowiki>{{Bots|optout=replaceable}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:Di-replaceable fair use-notice|صور قابلة للاستبدال]].
'''<nowiki>{{Bots|optout=bettersource}}</nowiki>''' اختيار عدم استلام رسائل {{Ill-WD2|طلبات الحصول على مصدر أفضل|id=Q14090247}}.
'''<nowiki>{{Bots|optout=afd}}</nowiki>''' اختيار عدم استلام رسائل [[قالب:تنبيه حذف|مقالات للحذف]] أو [[قالب:تنبيه حذف|أشكال]] [[قالب:تنبيه حذف|بديلة]].
'''<nowiki>{{Bots|optout=ifd}}</nowiki>''' اختيار عدم استلام رسائل {{Ill-WD2|صور للحذف|id=Q10819381}} أو [[قالب:Idw-multi|بدائلها]].
'''<nowiki>{{Bots|optout=prod}}</nowiki>''' اختيار عدم استلام رسائل {{Ill-WD2|تحذيرات الحذف السريع|id=Q7926194}}.
'''<nowiki>{{Bots|optout=MassMessage}}</nowiki>''' اختيار عدم استلام رسائل {{Ill-WD2|الرسائل الجماعية|id=Q22975870}}.

يمكن دمج الخيارات عن طريق وضع فاصلة بينها
'''<nowiki>{{Bots|optout=nosource,nolicense}}</nowiki>''' الاختيار بعدم الاشعار برسائل عدم وجود مصدر وعدم وجود ترخيص.
'''<nowiki>{{Bots|optout=orfud,norationale,replaceable}}</nowiki>''' الاختيار بعدم الاشعار برسائل استخدام عدم الترخيص للمحتوى المعني.

=== قيود الرسائل التي يمكن اختيار عدم استلامها ===
بعض إشعارات الرسائل غير مسموح بها أن تختار عدم استلامها. تشمل هذه:
# إشعارات انتهاك حقوق النشر
# تحذيرات التخريب (وغيرها)
# إشعارات [[مستخدم:SineBot|SineBot]] بشأن عدم توقيع المشاركات
# أي علامة رسالة غير مدرجة كوسيلة للاختيار عدم استلامها أعلاه. (هل هناك واحدة يجب تضمينها؟ اترك رسالة على صفحة النقاش.)
# الرسائل الجماعية لا يمكن اختيار عدم استلامها باستخدام <nowiki>{{Bots|optout=all}}</nowiki>; يجب على المستخدمين اختيار عدم استلامها بشكل صريح باستخدام <nowiki>{{Bots|optout=MassMessage}}</nowiki>

== التنفيذ ==
*[[mw:Pywikibot|باي ويكي بوت]] يدعم القالب، ويمكن تجاهل القالب من الخيارات!.
*منذ الإصدار 3.2.0.0 [[أرابيكا:أوتوويكي براوزر|أوتوويكي براوزر]] يدعم بشكل كامل <nowiki>{{bots}} و {{nobots}}</nowiki>. بالإضافة إلى ذلك، يمكن تحديد اسم مستخدم زائف "AWB" ({{وسيط|bots|deny|AWB}}) لحظر جميع الروبوتات المعتمدة على AWB من الصفحة. ومع ذلك، يحتوي AWB على خيار لتجاهل هذه القوالب.

=== أمثلة على التنفيذ ===

==== PHP ====
<syntaxhighlight lang="php">
function allowBots( $text, $user ) {
if (preg_match('/\{\{(nobots|bots\|allow=none|bots\|deny=all|bots\|optout=all|bots\|deny=.*?'.preg_quote($user,'/').'.*?)}}/iS',$text))
return false;
if (preg_match('/\{\{(bots\|allow=all|bots\|allow=.*?'.preg_quote($user,'/').'.*?)}}/iS', $text))
return true;
if (preg_match('/\{\{(bots\|allow=.*?)}}/iS', $text))
return false;
return true;
}
</syntaxhighlight>

==== Perl ====

<syntaxhighlight lang="perl">
sub allow_bots {
my($text, $user, $opt) = @_;
return 0 if $text =~ /{{[nN]obots}}/;
return 1 if $text =~ /{{[bB]ots}}/;
if($text =~ /\{\{[bB]ots\s*\|\s*allow\s*=\s*(.*?)\s*}}/s){
return 1 if $1 eq 'all';
return 0 if $1 eq 'none';
my @bots = split(/\s*,\s*/, $1);
return (grep $_ eq $user, @bots) ? 1 : 0;
}
if($text =~ /\{\{[bB]ots\s*\|\s*deny\s*=\s*(.*?)\s*}}/s){
return 0 if $1 eq 'all';
return 1 if $1 eq 'none';
my @bots = split(/\s*,\s*/, $1);
return (grep $_ eq $user, @bots) ? 0 : 1;
}
if(defined($opt) && $text =~ /\{\{[bB]ots\s*\|\s*optout\s*=\s*(.*?)\s*}}/s){
return 0 if $1 eq 'all';
my @opt = split(/\s*,\s*/, $1);
return (grep $_ eq $opt, @opt) ? 0 : 1;
}
return 1;
}
</syntaxhighlight>

==== VB.NET ====
<syntaxhighlight lang="vbnet">
Public Shared Function AllowBots(ByVal text As String, ByVal user As String) As Boolean
Return Not Regex.IsMatch(text, "\{\{(nobots|bots\|(allow=none|deny=(?!none).*(" & user.Normalize() & "|all)|optout=all))\}\}", RegexOptions.IgnoreCase)
End Function
</syntaxhighlight>

==== C# ====
<syntaxhighlight lang="csharp">
public static bool AllowBots(string text, string user)
{
return !Regex.IsMatch(text, @"\{\{(nobots|bots\|(allow=none|deny=(?!none).*(" + user.Normalize() + @".*|all)|optout=all))\}\}", RegexOptions.IgnoreCase);
}
</syntaxhighlight>

==== Java ====
<syntaxhighlight lang="java">
public static boolean allowBots(String text, String user)
{
return !text.matches("(?si).*\\{\\{(nobots|bots\\|(allow=none|deny=([^\\}]*?" + user + "[^\\}]*?|all)|optout=all))\\}\\}.*");
}
</syntaxhighlight>

==== JavaScript ====
<syntaxhighlight lang="javascript">
function allowBots(text, user){
if (!new RegExp("\\{\\{\\s*(nobots|bots[^}]*)\\s*\\}\\}", "i").test(text)) return true;
return (new RegExp("\\{\\{\\s*bots\\s*\\|\\s*deny\\s*=\\s*([^}]*,\\s*)*" + user.replace(/([\*\+\?\.\-\:\!\=\/\^\$])/g, "\\$1") + "\\s*(?=[,\\}])[^}]*\\s*\\}\\}", "i").test(text)) ? false : new RegExp("\\{\\{\\s*((?!nobots)|bots(\\s*\\|\\s*allow\\s*=\\s*((?!none)|([^}]*,\\s*)*" + user.replace(/([\*\+\?\.\-\:\!\=\/\^\$])/g, "\\$1") + "\\s*(?=[,\\}])[^}]*|all))?|bots\\s*\\|\\s*deny\\s*=\\s*(?!all)[^}]*|bots\\s*\\|\\s*optout=(?!all)[^}]*)\\s*\\}\\}", "i").test(text);
}
</syntaxhighlight>

==== Python ====
يفترض هذا الكود أن مكتبة [http://pypi.python.org/pypi/mwparserfromhell/ mwparserfromhell] مُثبتة ومستوردة في البرنامج النصي.

<syntaxhighlight lang="python">
def allow_bots(text, user):
user = user.lower().strip()
text = mwparserfromhell.parse(text)
for tl in text.filter_templates():
if tl.name.matches(['bots', 'nobots']):
break
else:
return True
for param in tl.params:
bots = [x.lower().strip() for x in param.value.split(",")]
if param.name == 'allow':
if ''.join(bots) == 'none': return False
for bot in bots:
if bot in (user, 'all'):
return True
elif param.name == 'deny':
if ''.join(bots) == 'none': return True
for bot in bots:
if bot in (user, 'all'):
return False
if (tl.name.matches('nobots') and len(tl.params) == 0):
return False
return True
</syntaxhighlight>

== انظر أيضًا ==
* {{قا|بوت}}
* [[m:Template:Bots|Template:Bots]] في Meta-Wiki

<includeonly>{{ملعب آخر||

[[تصنيف:قوالب مفيدة في أرابيكا]]
[[تصنيف:قوالب أرابيكا تتعلق بالبوتات]]
[[تصنيف:قوالب بأسماء أجنبية]]
}}</includeonly>

قالب:Bots/شرح - تاريخ المراجعة

عبد العزيز: بوت: تحديث استخدام القالب

عبد العزيز: بوت: تحديث استخدام القالب