Deploying to gh-pages from @ f89eae7 🚀

Author: github-actions[bot]

ar/assets/javascripts/copy_button.js

@@ -24,9 +24,9 @@ function filterText(target, exclusions) {
     clone.querySelectorAll(exclusions).forEach(node => node.remove());
     // The space between the venv name and the prompt is not tagged, so it is included
     // in the copied content. The newlines present in code output in codeblocks also
-    // isn't tagged, and therefore is also included in the copied content. Managing
+    // aren't tagged, and therefore are also included in the copied content. Managing
     // both of these issues is the purpose of the following.
-    return clone.innerText.replace(/^ /gm, "").trim();
+    return clone.innerText.trim();
 }
 
 function handleCopyClick(event) {

ar/assets/stylesheets/beeware_theme.css

@@ -54,10 +54,15 @@ body {
     font-family: var(--brand-font);
 }
 
-nav.md-tabs, .md-header {
+.md-header {
     background-color: var(--md-primary-fg-color);
 }
 
+/* Resolves header tabs color issue with search overlay */
+.md-tabs {
+    background-color: unset;
+}
+
 .md-header__title {
     font-size: 1.24rem;
     line-height: 3.3rem;
@@ -103,6 +108,7 @@ nav.md-tabs, .md-header {
 /* Search */
 .md-search {
     margin-left: 1rem;
+    margin-right: 1rem;
 }
 
 input.md-search__input,
@@ -126,12 +132,50 @@ input.md-search__input,
     height: 2.5rem;
 }
 
+input.md-search__input, .md-search__suggest, .md-search-result__meta {
+    font-family: var(--brand-font);
+}
+
+.md-search__suggest {
+    padding-top: 1px;
+}
+
+.md-search-result .md-typeset h1 {
+    font-size: 1.6rem;
+}
+
+.md-search-result .md-typeset h2,
+.md-search-result .md-typeset {
+    font-size: 1rem;
+}
+
+/* The widths in the rest of this section are to correct rendering of the search input */
 @media screen and (min-width: 60em) {
-  .md-search__inner {
-      width: unset;
-  }
+    .md-search {
+      max-width: 30rem;
+      width: 100%;
+    }
+}
+
+@media screen and (min-width: 60em) and (max-width: 76.2344em) {
+    .md-search__scrollwrap,
+    [data-md-toggle="search"]:checked ~ .md-header .md-search__inner {
+        width: 100%;
+    }
 }
 
+@media screen and (min-width: 76.25em) {
+    .md-search__scrollwrap,
+    [data-md-toggle="search"]:checked ~ .md-header .md-search__inner {
+        width: 100%;
+    }
+}
+
+.md-search__inner {
+    width: 100%;
+}
+
+
 /* Link colors */
 /* Remove link color from section headers that are not links */
 .md-nav__link[for]:focus,
@@ -554,7 +598,7 @@ readthedocs-docdiff {
 }
 
 /* Forces only highlighting the important bits of codeblocks */
-.highlight .gp, .highlight .go, .highlight .w {
+.highlight .gp, .highlight .go {
     user-select: none;
     -webkit-user-select: none;
 }
@@ -587,24 +631,6 @@ svg.copy-icon {
     padding-left: 8px;
 }
 
-/* Search */
-input.md-search__input, .md-search__suggest, .md-search-result__meta {
-    font-family: var(--brand-font);
-}
-
-.md-search__suggest {
-    padding-top: 1px;
-}
-
-.md-search-result .md-typeset h1 {
-    font-size: 1.6rem;
-}
-
-.md-search-result .md-typeset h2,
-.md-search-result .md-typeset {
-    font-size: 1rem;
-}
-
 /* Footer and footer navigation color */
 .md-footer, .md-footer-meta {
     background-color: light-dark(#f5f5f5, #343A40);

ar/contributing/guide/how/dev-environment/index.html

@@ -2356,6 +2356,17 @@
 
           <li class="md-nav__item">
   <a href="#_2" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        تعيين مستودع أعلى
+      
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_3" class="md-nav__link">
     <span class="md-ellipsis">
 
         إنشاء بيئة افتراضية
@@ -2377,7 +2388,7 @@
 </li>
 
           <li class="md-nav__item">
-  <a href="#_3" class="md-nav__link">
+  <a href="#_4" class="md-nav__link">
     <span class="md-ellipsis">
 
         تمكين الالتزام المسبق
@@ -4743,6 +4754,17 @@
 
           <li class="md-nav__item">
   <a href="#_2" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        تعيين مستودع أعلى
+      
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#_3" class="md-nav__link">
     <span class="md-ellipsis">
 
         إنشاء بيئة افتراضية
@@ -4764,7 +4786,7 @@
 </li>
 
           <li class="md-nav__item">
-  <a href="#_3" class="md-nav__link">
+  <a href="#_4" class="md-nav__link">
     <span class="md-ellipsis">
 
         تمكين الالتزام المسبق
@@ -4981,11 +5003,41 @@ <h4 id="beeware">نسخ مستودع BeeWare<a class="headerlink" href="#beeware
 </div>
 </div>
 </div>
-<h4 id="_2">إنشاء بيئة افتراضية<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h4>
-<p>لإعداد بيئة افتراضية وترقية <code>pip</code>، قم بتشغيل:</p>
+<h4 id="_2">تعيين مستودع أعلى<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h4>
+<p>بعد استنساخ الفرع الخاص بك، أضف مستودع BeeWare كمرجع بعيد <code>upstream</code>. هذا يمنح
+النسخة المستنسخة المحلية مرجعًا إلى المستودع الأصلي، مما يسهل مزامنة التحديثات
+بمرور الوقت.</p>
+<p>ستحتاج أيضًا إلى علامات من <code>upstream</code> حتى تتمكن أدوات مثل Toga و Briefcase من
+تحديد أرقام الإصدارات بدقة:</p>
 <div class="tabbed-set tabbed-alternate" data-tabs="3:3"><input checked="checked" id="__tabbed_3_1" name="__tabbed_3" type="radio" /><input id="__tabbed_3_2" name="__tabbed_3" type="radio" /><input id="__tabbed_3_3" name="__tabbed_3" type="radio" /><div class="tabbed-labels"><label for="__tabbed_3_1">macOS</label><label for="__tabbed_3_2">Linux</label><label for="__tabbed_3_3">Windows</label></div>
 <div class="tabbed-content">
 <div class="tabbed-block">
+<div class="highlight"><pre><span></span><code><span class="gp">$ </span>git<span class="w"> </span>remote<span class="w"> </span>add<span class="w"> </span>upstream<span class="w"> </span>https://github.com/beeware/beeware.git
+<span class="gp">$ </span>git<span class="w"> </span>fetch<span class="w"> </span>--tags<span class="w"> </span>upstream
+</code></pre></div>
+</div>
+<div class="tabbed-block">
+<div class="highlight"><pre><span></span><code><span class="gp">$ </span>git<span class="w"> </span>remote<span class="w"> </span>add<span class="w"> </span>upstream<span class="w"> </span>https://github.com/beeware/beeware.git
+<span class="gp">$ </span>git<span class="w"> </span>fetch<span class="w"> </span>--tags<span class="w"> </span>upstream
+</code></pre></div>
+</div>
+<div class="tabbed-block">
+<div class="highlight"><pre><span></span><code><span class="gp">C:\...&gt;</span>git remote add upstream https://github.com/beeware/beeware.git
+<span class="gp">C:\...&gt;</span>git fetch --tags upstream
+</code></pre></div>
+</div>
+</div>
+</div>
+<p>إذا كنت تريد أن تتضمن شوكتك هذه العلامات أيضًا، يمكنك دفعها:</p>
+<div class="highlight"><pre><span></span><code><span class="gp">$ </span>git<span class="w"> </span>push<span class="w"> </span>--tags
+</code></pre></div>
+<p>قد يكون هذا مفيدًا إذا قمت بعمل نسخة جديدة لاحقًا وأردت أن تكون العلامات متاحة
+من شوكتك.</p>
+<h4 id="_3">إنشاء بيئة افتراضية<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h4>
+<p>لإعداد بيئة افتراضية وترقية <code>pip</code>، قم بتشغيل:</p>
+<div class="tabbed-set tabbed-alternate" data-tabs="4:3"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio" /><input id="__tabbed_4_2" name="__tabbed_4" type="radio" /><input id="__tabbed_4_3" name="__tabbed_4" type="radio" /><div class="tabbed-labels"><label for="__tabbed_4_1">macOS</label><label for="__tabbed_4_2">Linux</label><label for="__tabbed_4_3">Windows</label></div>
+<div class="tabbed-content">
+<div class="tabbed-block">
 <div class="highlight"><pre><span></span><code><span class="gp">$ </span><span class="nb">cd</span><span class="w"> </span>beeware
 <span class="gp">$ </span>python3<span class="w"> </span>-m<span class="w"> </span>venv<span class="w"> </span>.venv
 <span class="gp">$ </span><span class="nb">source</span><span class="w"> </span>.venv/bin/activate
@@ -5013,7 +5065,7 @@ <h4 id="beeware_1">تثبيت BeeWare<a class="headerlink" href="#beeware_1" tit
 <p>الآن بعد أن أصبح لديك شفرة المصدر، يمكنك إجراء <a href="https://setuptools.pypa.io/en/latest/userguide/development_mode.html">تثبيت قابل
 للتحرير</a>
 لـ BeeWare في بيئة التطوير الخاصة بك. قم بتشغيل الأمر التالي:</p>
-<div class="tabbed-set tabbed-alternate" data-tabs="4:3"><input checked="checked" id="__tabbed_4_1" name="__tabbed_4" type="radio" /><input id="__tabbed_4_2" name="__tabbed_4" type="radio" /><input id="__tabbed_4_3" name="__tabbed_4" type="radio" /><div class="tabbed-labels"><label for="__tabbed_4_1">macOS</label><label for="__tabbed_4_2">Linux</label><label for="__tabbed_4_3">Windows</label></div>
+<div class="tabbed-set tabbed-alternate" data-tabs="5:3"><input checked="checked" id="__tabbed_5_1" name="__tabbed_5" type="radio" /><input id="__tabbed_5_2" name="__tabbed_5" type="radio" /><input id="__tabbed_5_3" name="__tabbed_5" type="radio" /><div class="tabbed-labels"><label for="__tabbed_5_1">macOS</label><label for="__tabbed_5_2">Linux</label><label for="__tabbed_5_3">Windows</label></div>
 <div class="tabbed-content">
 <div class="tabbed-block">
 <div class="highlight"><pre><span></span><code><span class="gp gp-VirtualEnv">(.venv)</span> <span class="gp">$ </span>python<span class="w"> </span>-m<span class="w"> </span>pip<span class="w"> </span>install<span class="w"> </span>-U<span class="w"> </span>-e<span class="w"> </span>.<span class="w"> </span>--group<span class="w"> </span>dev
@@ -5029,12 +5081,12 @@ <h4 id="beeware_1">تثبيت BeeWare<a class="headerlink" href="#beeware_1" tit
 </div>
 </div>
 </div>
-<h4 id="_3">تمكين الالتزام المسبق<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h4>
+<h4 id="_4">تمكين الالتزام المسبق<a class="headerlink" href="#_4" title="Permanent link">&para;</a></h4>
 <p>BeeWare يستخدم أداة تسمى <a href="https://pre-commit.com">pre-commit</a> لتحديد
 المشكلات البسيطة وتوحيد تنسيق الكود. ويقوم بذلك عن طريق تثبيت git hook الذي يقوم
 تلقائيًا بتشغيل سلسلة من أدوات فحص الكود قبل إنهاء أي git commit. لتمكين
 pre-commit، قم بتشغيل:</p>
-<div class="tabbed-set tabbed-alternate" data-tabs="5:3"><input checked="checked" id="__tabbed_5_1" name="__tabbed_5" type="radio" /><input id="__tabbed_5_2" name="__tabbed_5" type="radio" /><input id="__tabbed_5_3" name="__tabbed_5" type="radio" /><div class="tabbed-labels"><label for="__tabbed_5_1">macOS</label><label for="__tabbed_5_2">Linux</label><label for="__tabbed_5_3">Windows</label></div>
+<div class="tabbed-set tabbed-alternate" data-tabs="6:3"><input checked="checked" id="__tabbed_6_1" name="__tabbed_6" type="radio" /><input id="__tabbed_6_2" name="__tabbed_6" type="radio" /><input id="__tabbed_6_3" name="__tabbed_6" type="radio" /><div class="tabbed-labels"><label for="__tabbed_6_1">macOS</label><label for="__tabbed_6_2">Linux</label><label for="__tabbed_6_3">Windows</label></div>
 <div class="tabbed-content">
 <div class="tabbed-block">
 <div class="highlight"><pre><span></span><code><span class="gp gp-VirtualEnv">(.venv)</span> <span class="gp">$ </span>pre-commit<span class="w"> </span>install

ar/contributing/guide/how/new-issue/index.html

@@ -4973,6 +4973,17 @@ <h3 id="_6">تقديم التقرير<a class="headerlink" href="#_6" title="Per
 <span class="p">&lt;/</span><span class="nt">details</span><span class="p">&gt;</span>
 </code></pre></div>
 <p>بعد تقديم أكبر قدر ممكن من المعلومات، انقر على "إنشاء" لإرسال التقرير.</p>
+<div class="admonition warning">
+<p class="admonition-title">استخدام واجهة سطر الأوامر لـ GitHub لإنشاء مشكلة</p>
+<p>يؤدي استخدام واجهة سطر الأوامر في GitHub (<code>gh</code>) مباشرةً إلى تجاوز القوالب التي
+أنشأناها. وقد تم إنشاء هذه القوالب لضمان حصولنا في النهاية على المعلومات اللازمة
+للتعامل مع المشكلة.</p>
+<p><strong>إذا كنت تنوي استخدام <code>gh</code> لإنشاء مشكلة جديدة، فيرجى استخدام ما يلي:</strong></p>
+<div class="highlight"><pre><span></span><code><span class="go">gh issue create --web</span>
+</code></pre></div>
+<p>يؤدي استخدام <code>--web</code> إلى فتح المتصفح على صفحة قوالب المشكلات، ويتيح لك إنشاء
+مشكلة باستخدام القالب المناسب.</p>
+</div>