docs: translate settings editor config-file reference (26 languages)

Translate the new OpenMV Cam Settings Editor reference pages (index,
containers, value-controls, display, example) and the Viewer overview's
settings-editor note into all 26 locales.

Markup was preserved and audited with docutils: inline literals, roles,
and links are structure-checked (a role's visible text may be translated
while its target is kept), and a CJK/RTL delimiter-adjacency pass keeps
closing markup from abutting non-Latin characters. All 26 locales build
warning-free under the CI toolchain (Sphinx 9.0.4 / docutils 0.22.4);
zero untranslated and zero build-breaking strings remain in these files.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: kwagyeman

docs/locale/ar/LC_MESSAGES/openmvcam/tutorial/tools/ide/settings-editor/containers.po

@@ -0,0 +1,172 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) The OpenMV MicroPython Documentation is Copyright ©
+# 2014-2026 by OpenMV, Damien P. George, and others.
+# This file is distributed under the same license as the OpenMV MicroPython
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: OpenMV MicroPython 1.28\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-07 11:18-0700\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: ar <LL@li.org>\n"
+"Language: ar\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=0 && n%100<=2 ? 4 : 5);\n"
+"Generated-By: Babel 2.17.0\n"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:2
+msgid "Containers"
+msgstr "الحاويات"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:4
+msgid ""
+"Containers do not hold a value of their own -- they organise other controls."
+" Each spans the full width of the form, and the controls listed inside it "
+"are built as a form of their own. There are two: *group* draws a labelled "
+"box, and *tabs* draws a tab strip."
+msgstr ""
+"لا تحمل الحاويات قيمة خاصة بها -- بل تنظّم عناصر التحكم الأخرى. تمتد كل "
+"واحدة على كامل عرض النموذج، وتُبنى عناصر التحكم المدرجة داخلها كنموذج مستقل "
+"بذاته. وهناك نوعان: *group* يرسم صندوقًا بعنوان، و*tabs* يرسم شريط علامات "
+"تبويب."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:10
+msgid ""
+"All controls also accept the common keys (*name*, *label*, *tooltip*, "
+"*enabled*); see the :doc:`overview <index>`."
+msgstr ""
+"تقبل جميع عناصر التحكم أيضاً المفاتيح المشتركة ( *name* ، *label* ، "
+"*tooltip* ، *enabled* )؛ انظر :doc:`نظرة عامة <index>` ."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:15
+msgid "group"
+msgstr "group"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:17
+msgid ""
+"A labelled box around a set of controls. Optionally *checkable*, which turns"
+" the heading into a switch for everything inside it."
+msgstr ""
+"صندوق بعنوان يحيط بمجموعة من عناصر التحكم. ويمكن اختياريًا جعله *checkable*،"
+" مما يحوّل العنوان إلى مفتاح تبديل لكل ما بداخله."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:35
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:82
+msgid "Arguments:"
+msgstr "الوسائط:"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:37
+msgid "*title* (string) -- the heading shown on the box."
+msgstr "*title* (سلسلة نصية) -- العنوان المعروض على الصندوق."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:38
+msgid ""
+"*checkable* (boolean, default ``false``) -- when ``true``, the heading "
+"carries a checkbox that enables or disables every control inside the box, "
+"and whose own on/off state is saved."
+msgstr ""
+"*checkable* (قيمة منطقية، الافتراضي ``false``) -- عندما تكون ``true``، يحمل "
+"العنوان مربع اختيار يُفعّل أو يُعطّل كل عنصر تحكم داخل الصندوق، وتُحفظ حالته"
+" الخاصة (تشغيل/إيقاف)."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:42
+msgid ""
+"*value* (boolean, default ``true``) -- the initial state of that heading "
+"checkbox. Only meaningful when *checkable* is ``true``."
+msgstr ""
+"*value* (قيمة منطقية، الافتراضي ``true``) -- الحالة الأولية لمربع اختيار "
+"العنوان ذاك. وله معنى فقط عندما تكون *checkable* بقيمة ``true``."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:45
+msgid "*controls* (array) -- the controls shown inside the box."
+msgstr "*controls* (مصفوفة) -- عناصر التحكم المعروضة داخل الصندوق."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:48
+msgid ""
+"Saves: a **boolean** (the heading checkbox) when *checkable* is ``true``; a "
+"plain group saves nothing of its own -- only the controls inside it save "
+"their values."
+msgstr ""
+"يحفظ: قيمة **منطقية** (مربع اختيار العنوان) عندما تكون *checkable* بقيمة "
+"``true``؛ أما المجموعة العادية فلا تحفظ شيئًا خاصًا بها -- إذ تحفظ فقط عناصر"
+" التحكم بداخلها قيمها."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:54
+msgid "tabs"
+msgstr "tabs"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:56
+msgid ""
+"A tab strip. Each tab is a page with its own list of controls, so a long "
+"form can be split across *Camera*, *Network*, *System*, and so on."
+msgstr ""
+"شريط علامات تبويب. كل علامة تبويب هي صفحة لها قائمتها الخاصة من عناصر "
+"التحكم، لذا يمكن تقسيم نموذج طويل عبر *Camera* و*Network* و*System* وهكذا."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:84
+msgid ""
+"*tab_position* (string, default ``\"north\"``) -- which edge the tab bar "
+"sits on: ``\"north\"``, ``\"south\"``, ``\"west\"``, or ``\"east\"``."
+msgstr ""
+"*tab_position* (سلسلة نصية، الافتراضي ``\"north\"``) -- الحافة التي يقع "
+"عليها شريط علامات التبويب: ``\"north\"`` أو ``\"south\"`` أو ``\"west\"`` أو"
+" ``\"east\"``."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:87
+msgid ""
+"*tabs* (array) -- the tab pages, in order. Each page is an object with:"
+msgstr ""
+"*tabs* (مصفوفة) -- صفحات علامات التبويب، بالترتيب. كل صفحة كائن يحتوي على:"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:90
+msgid "*title* (string) -- the tab's label."
+msgstr "*title* (سلسلة نصية) -- تسمية علامة التبويب."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:91
+msgid "*tooltip* (string) -- hover text for the tab."
+msgstr ""
+"*tooltip* (سلسلة نصية) -- نص التلميح عند تمرير المؤشر فوق علامة التبويب."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:92
+msgid "*controls* (array) -- the controls shown on that page."
+msgstr "*controls* (مصفوفة) -- عناصر التحكم المعروضة على تلك الصفحة."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:95
+msgid ""
+"Saves: nothing of its own; the controls on each page save their own values."
+msgstr "يحفظ: لا شيء خاص به؛ تحفظ عناصر التحكم على كل صفحة قيمها الخاصة."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:99
+msgid "Nesting"
+msgstr "التداخل"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:101
+msgid ""
+"Any control can go inside any container, to any depth. A *group* can contain"
+" a *tabs*, a tab page can contain *group* boxes, groups can nest inside "
+"groups. Every *controls* array -- the top-level one, a group's, and a tab "
+"page's -- takes the same control objects, so the rules on these pages apply "
+"the same at every level."
+msgstr ""
+"يمكن وضع أي عنصر تحكم داخل أي حاوية، وإلى أي عمق. يمكن أن يحتوي *group* على "
+"*tabs*، ويمكن أن تحتوي صفحة علامة تبويب على صناديق *group*، ويمكن تداخل "
+"المجموعات داخل المجموعات. تأخذ كل مصفوفة *controls* -- سواء أكانت في المستوى"
+" الأعلى، أم في مجموعة، أم في صفحة علامة تبويب -- كائنات التحكم نفسها، لذا "
+"تنطبق القواعد الواردة في هذه الصفحات بالطريقة نفسها على كل مستوى."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/containers.rst:108
+msgid ""
+"A checkable *group* nested inside a tab is a common shape: the tab holds a "
+"feature, the group's checkbox turns the feature on or off, and the controls "
+"inside configure it."
+msgstr ""
+"من الترتيبات الشائعة وجود *group* قابل للتحديد متداخل داخل علامة تبويب: تحمل"
+" علامة التبويب ميزة، ويشغّل مربع اختيار المجموعة الميزة أو يوقفها، وتضبطها "
+"عناصر التحكم بداخلها."

docs/locale/ar/LC_MESSAGES/openmvcam/tutorial/tools/ide/settings-editor/display.po

@@ -0,0 +1,70 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) The OpenMV MicroPython Documentation is Copyright ©
+# 2014-2026 by OpenMV, Damien P. George, and others.
+# This file is distributed under the same license as the OpenMV MicroPython
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: OpenMV MicroPython 1.28\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-07 11:18-0700\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: ar <LL@li.org>\n"
+"Language: ar\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=0 && n%100<=2 ? 4 : 5);\n"
+"Generated-By: Babel 2.17.0\n"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:2
+msgid "Display"
+msgstr "العرض"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:5
+msgid "label"
+msgstr "label"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:7
+msgid ""
+"A block of static text -- a heading, a note, or a link. A *label* holds no "
+"value and is never saved; it is there to explain the controls around it."
+msgstr ""
+"كتلة من النص الثابت -- عنوان أو ملاحظة أو رابط. لا يحمل *label* أي قيمة ولا "
+"يُحفظ أبدًا؛ فهو موجود لشرح عناصر التحكم من حوله."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:19
+msgid "Arguments:"
+msgstr "الوسائط:"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:21
+msgid ""
+"*text* (string) -- the text to show. Rich text: HTML tags such as ``<b>`` "
+"and ``<br/>``, and ``<a href>`` links (which open in a browser), all work."
+msgstr ""
+"*text* (سلسلة نصية) -- النص المراد عرضه. نص منسّق: تعمل جميع وسوم HTML مثل "
+"``<b>`` و``<br/>``، وروابط ``<a href>`` (التي تُفتح في المتصفح)."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:24
+msgid ""
+"*align* (string, default left) -- ``\"center\"`` or ``\"right\"`` to align "
+"the text; any other value is left-aligned."
+msgstr ""
+"*align* (سلسلة نصية، الافتراضي محاذاة لليسار) -- ``\"center\"`` أو "
+"``\"right\"`` لمحاذاة النص؛ وأي قيمة أخرى تُحاذى لليسار."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:28
+msgid "Saves: nothing -- a *label* is display only."
+msgstr "يحفظ: لا شيء -- فـ*label* للعرض فقط."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/display.rst:30
+msgid ""
+"A *label* also accepts the common keys (*tooltip*, *enabled*); see the "
+":doc:`overview <index>`."
+msgstr ""
+"يقبل *label* أيضاً المفاتيح المشتركة ( *tooltip* ، *enabled* )؛ انظر "
+":doc:`نظرة عامة <index>` ."

docs/locale/ar/LC_MESSAGES/openmvcam/tutorial/tools/ide/settings-editor/example.po

@@ -0,0 +1,81 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) The OpenMV MicroPython Documentation is Copyright ©
+# 2014-2026 by OpenMV, Damien P. George, and others.
+# This file is distributed under the same license as the OpenMV MicroPython
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: OpenMV MicroPython 1.28\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-07-07 11:18-0700\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: ar <LL@li.org>\n"
+"Language: ar\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=0 && n%100<=2 ? 4 : 5);\n"
+"Generated-By: Babel 2.17.0\n"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:2
+msgid "Full example"
+msgstr "مثال كامل"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:4
+msgid ""
+"*Create Default Config* writes the file below and opens it. It is a demo -- "
+"not a real device config -- built to exercise every control type at once: "
+"labels, both kinds of container, all seven value controls, the "
+"*options*/*values* mapping, a tristate checkbox, a hex spinbox, an input "
+"mask, a regex, a password field, and a disabled field. Read it alongside the"
+" reference pages to see each key in context, then strip it down to the "
+"settings your own application needs."
+msgstr ""
+"يكتب *Create Default Config* الملف أدناه ويفتحه. وهو عرض توضيحي -- وليس "
+"إعداد جهاز حقيقي -- بُني ليجرّب كل نوع من عناصر التحكم دفعة واحدة: التسميات،"
+" ونوعي الحاوية كليهما، وجميع عناصر التحكم القيمية السبعة، وتعيين "
+"*options*/*values*، ومربع اختيار ثلاثي الحالات، و spinbox بالنظام الست عشري،"
+" وقناع إدخال، وتعبير نمطي، وحقل كلمة مرور، وحقل معطّل. اقرأه إلى جانب "
+"الصفحات المرجعية لترى كل مفتاح في سياقه، ثم اختصره إلى الإعدادات التي "
+"يحتاجها تطبيقك الخاص."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:151
+msgid "Reading it back"
+msgstr "قراءته مرة أخرى"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:153
+msgid ""
+"You authored this layout, so you know the path to each value. With the "
+"``find`` helper from the :doc:`overview <index>`, name the tab and the "
+"control -- ``find`` steps through the tab strip and any unnamed group in "
+"between:"
+msgstr ""
+"لقد أنشأت هذا التخطيط، لذا فأنت تعرف المسار إلى كل قيمة. باستخدام المساعد "
+"``find`` من :doc:`نظرة عامة <index>` ، حدّد اسم علامة التبويب وعنصر التحكم "
+"-- ``find`` يتنقل عبر شريط علامات التبويب وأي مجموعة غير مسماة بينهما:"
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:165
+msgid ""
+"The *Manual Exposure* group has a *name*, so it is a step in the path -- and"
+" ``find(config, \"Camera\", \"manual_exposure\")`` reads its checkbox. The "
+"*Format* group has no *name*, so it is transparent: ``resolution`` is "
+"reached straight from the *Camera* tab."
+msgstr ""
+"تحمل مجموعة *Manual Exposure* اسمًا *name*، لذا فهي خطوة في المسار -- ويقرأ "
+"``find(config, \"Camera\", \"manual_exposure\")`` مربع اختيارها. أما مجموعة "
+"*Format* فليس لها *name*، لذا فهي شفافة: يُوصل إلى ``resolution`` مباشرة من "
+"علامة التبويب *Camera*."
+
+#: ../../openmvcam/tutorial/tools/ide/settings-editor/example.rst:171
+msgid ""
+"Note how the *combobox* with a *values* array returns the stored value "
+"(``\"qvga\"``), not the label the user picked (``\"QVGA\"``) -- exactly what"
+" a script wants to branch on."
+msgstr ""
+"لاحظ كيف يُرجع *combobox* المزوّد بمصفوفة *values* القيمة المخزَّنة "
+"(``\"qvga\"``)، وليس التسمية التي اختارها المستخدم (``\"QVGA\"``) -- وهو "
+"تمامًا ما يريد النص البرمجي أن يبني عليه قراره."