Sphinx 7.1.2__py3-none-any.whl → 7.2.0__py3-none-any.whl

sphinx/locale/ar/LC_MESSAGES/sphinx.po

@@ -9,7 +9,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Sphinx\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2023-07-24 12:38+0000\n"
+"POT-Creation-Date: 2023-08-17 03:12+0000\n"
 "PO-Revision-Date: 2013-04-02 08:44+0000\n"
 "Last-Translator: Abdullah ahmed <Alhadab@hotmail.co.uk>, 2020\n"
 "Language-Team: Arabic (http://app.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n"
@@ -20,123 +20,123 @@ msgstr ""
 "Language: ar\n"
 "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n"
 
-#: sphinx/application.py:153
+#: sphinx/application.py:156
 #, python-format
 msgid "Cannot find source directory (%s)"
 msgstr "لا يمكن العثور على المجلد المصدر (%s)"
 
-#: sphinx/application.py:157
+#: sphinx/application.py:160
 #, python-format
 msgid "Output directory (%s) is not a directory"
 msgstr ""
 
-#: sphinx/application.py:161
+#: sphinx/application.py:164
 msgid "Source directory and destination directory cannot be identical"
 msgstr "لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين"
 
-#: sphinx/application.py:193
+#: sphinx/application.py:196
 #, python-format
 msgid "Running Sphinx v%s"
 msgstr "تشغيل Sphinx v%s"
 
-#: sphinx/application.py:219
+#: sphinx/application.py:222
 #, python-format
 msgid ""
 "This project needs at least Sphinx v%s and therefore cannot be built with "
 "this version."
 msgstr "يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي"
 
-#: sphinx/application.py:235
+#: sphinx/application.py:238
 msgid "making output directory"
 msgstr ""
 
-#: sphinx/application.py:240 sphinx/registry.py:438
+#: sphinx/application.py:243 sphinx/registry.py:444
 #, python-format
 msgid "while setting up extension %s:"
 msgstr ""
 
-#: sphinx/application.py:246
+#: sphinx/application.py:249
 msgid ""
 "'setup' as currently defined in conf.py isn't a Python callable. Please "
 "modify its definition to make it a callable function. This is needed for "
 "conf.py to behave as a Sphinx extension."
 msgstr ""
 
-#: sphinx/application.py:277
+#: sphinx/application.py:280
 #, python-format
 msgid "loading translations [%s]... "
 msgstr "تحميل الترجمات [ %s ]"
 
-#: sphinx/application.py:294 sphinx/util/display.py:83
+#: sphinx/application.py:297 sphinx/util/display.py:84
 msgid "done"
 msgstr "تم"
 
-#: sphinx/application.py:296
+#: sphinx/application.py:299
 msgid "not available for built-in messages"
 msgstr "غير متوفرة للرسائل الافتراضية المدمجة"
 
-#: sphinx/application.py:312
+#: sphinx/application.py:313
 msgid "loading pickled environment"
 msgstr ""
 
-#: sphinx/application.py:318
+#: sphinx/application.py:321
 #, python-format
 msgid "failed: %s"
 msgstr "فشل: %s"
 
-#: sphinx/application.py:332
+#: sphinx/application.py:335
 msgid "No builder selected, using default: html"
 msgstr "لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html"
 
-#: sphinx/application.py:365
+#: sphinx/application.py:368
 msgid "succeeded"
 msgstr "نجح"
 
-#: sphinx/application.py:366
+#: sphinx/application.py:369
 msgid "finished with problems"
 msgstr "انتهى مع وجود مشاكل"
 
-#: sphinx/application.py:370
+#: sphinx/application.py:373
 #, python-format
 msgid "build %s, %s warning (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:372
+#: sphinx/application.py:375
 #, python-format
 msgid "build %s, %s warnings (with warnings treated as errors)."
 msgstr ""
 
-#: sphinx/application.py:375
+#: sphinx/application.py:378
 #, python-format
 msgid "build %s, %s warning."
 msgstr "بناء %s، %sتحذير."
 
-#: sphinx/application.py:377
+#: sphinx/application.py:380
 #, python-format
 msgid "build %s, %s warnings."
 msgstr ""
 
-#: sphinx/application.py:381
+#: sphinx/application.py:384
 #, python-format
 msgid "build %s."
 msgstr "بناء %s."
 
-#: sphinx/application.py:611
+#: sphinx/application.py:615
 #, python-format
 msgid "node class %r is already registered, its visitors will be overridden"
 msgstr ""
 
-#: sphinx/application.py:690
+#: sphinx/application.py:694
 #, python-format
 msgid "directive %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:712 sphinx/application.py:734
+#: sphinx/application.py:716 sphinx/application.py:738
 #, python-format
 msgid "role %r is already registered, it will be overridden"
 msgstr ""
 
-#: sphinx/application.py:1280
+#: sphinx/application.py:1279
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel reading, "
@@ -144,12 +144,12 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1284
+#: sphinx/application.py:1283
 #, python-format
 msgid "the %s extension is not safe for parallel reading"
 msgstr ""
 
-#: sphinx/application.py:1287
+#: sphinx/application.py:1286
 #, python-format
 msgid ""
 "the %s extension does not declare if it is safe for parallel writing, "
@@ -157,70 +157,70 @@ msgid ""
 "explicit"
 msgstr ""
 
-#: sphinx/application.py:1291
+#: sphinx/application.py:1290
 #, python-format
 msgid "the %s extension is not safe for parallel writing"
 msgstr ""
 
-#: sphinx/application.py:1299 sphinx/application.py:1303
+#: sphinx/application.py:1298 sphinx/application.py:1302
 #, python-format
 msgid "doing serial %s"
 msgstr ""
 
-#: sphinx/config.py:175
+#: sphinx/config.py:179
 #, python-format
 msgid "config directory doesn't contain a conf.py file (%s)"
 msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)"
 
-#: sphinx/config.py:184
+#: sphinx/config.py:188
 msgid ""
 "Invalid configuration value found: 'language = None'. Update your "
 "configuration to a valid language code. Falling back to 'en' (English)."
 msgstr ""
 
-#: sphinx/config.py:213
+#: sphinx/config.py:217
 #, python-format
 msgid ""
 "cannot override dictionary config setting %r, ignoring (use %r to set "
 "individual elements)"
 msgstr ""
 
-#: sphinx/config.py:222
+#: sphinx/config.py:226
 #, python-format
 msgid "invalid number %r for config value %r, ignoring"
 msgstr ""
 
-#: sphinx/config.py:227
+#: sphinx/config.py:231
 #, python-format
 msgid "cannot override config setting %r with unsupported type, ignoring"
 msgstr ""
 
-#: sphinx/config.py:256
+#: sphinx/config.py:260
 #, python-format
 msgid "unknown config value %r in override, ignoring"
 msgstr ""
 
-#: sphinx/config.py:284
+#: sphinx/config.py:288
 #, python-format
 msgid "No such config value: %s"
 msgstr ""
 
-#: sphinx/config.py:308
+#: sphinx/config.py:312
 #, python-format
 msgid "Config value %r already present"
 msgstr ""
 
-#: sphinx/config.py:356
+#: sphinx/config.py:360
 #, python-format
 msgid "There is a syntax error in your configuration file: %s\n"
 msgstr ""
 
-#: sphinx/config.py:359
+#: sphinx/config.py:363
 msgid ""
 "The configuration file (or one of the modules it imports) called sys.exit()"
 msgstr ""
 
-#: sphinx/config.py:366
+#: sphinx/config.py:370
 #, python-format
 msgid ""
 "There is a programmable error in your configuration file:\n"
@@ -228,68 +228,68 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/config.py:389
+#: sphinx/config.py:393
 #, python-format
 msgid ""
 "The config value `source_suffix' expects a string, list of strings, or "
 "dictionary. But `%r' is given."
 msgstr ""
 
-#: sphinx/config.py:408
+#: sphinx/config.py:413
 #, python-format
 msgid "Section %s"
 msgstr "قسم %s"
 
-#: sphinx/config.py:409
+#: sphinx/config.py:414
 #, python-format
 msgid "Fig. %s"
 msgstr ""
 
-#: sphinx/config.py:410
+#: sphinx/config.py:415
 #, python-format
 msgid "Table %s"
 msgstr "جدول %s"
 
-#: sphinx/config.py:411
+#: sphinx/config.py:416
 #, python-format
 msgid "Listing %s"
 msgstr ""
 
-#: sphinx/config.py:448
+#: sphinx/config.py:488
 msgid ""
 "The config value `{name}` has to be a one of {candidates}, but `{current}` "
 "is given."
 msgstr ""
 
-#: sphinx/config.py:466
+#: sphinx/config.py:506
 msgid ""
 "The config value `{name}' has type `{current.__name__}'; expected "
 "{permitted}."
 msgstr ""
 
-#: sphinx/config.py:478
+#: sphinx/config.py:518
 msgid ""
 "The config value `{name}' has type `{current.__name__}', defaults to "
 "`{default.__name__}'."
 msgstr ""
 
-#: sphinx/config.py:488
+#: sphinx/config.py:528
 #, python-format
 msgid "primary_domain %r not found, ignored."
 msgstr "primary_domain %r لتم يتم العثور عليه، لهذا تم تجاهلة"
 
-#: sphinx/config.py:500
+#: sphinx/config.py:540
 msgid ""
 "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add "
 "\"root_doc = 'contents'\" to your conf.py."
 msgstr ""
 
-#: sphinx/events.py:62
+#: sphinx/events.py:63
 #, python-format
 msgid "Event %r already present"
 msgstr ""
 
-#: sphinx/events.py:68
+#: sphinx/events.py:69
 #, python-format
 msgid "Unknown event name: %s"
 msgstr "حدث غير معروف: %s"
@@ -313,917 +313,920 @@ msgid ""
 "cannot be built with the loaded version (%s)."
 msgstr ""
 
-#: sphinx/highlighting.py:147
+#: sphinx/highlighting.py:149
 #, python-format
 msgid "Pygments lexer name %r is not known"
 msgstr ""
 
-#: sphinx/highlighting.py:173
+#: sphinx/highlighting.py:176
 #, python-format
-msgid "Could not lex literal_block %r as \"%s\". Highlighting skipped."
+msgid ""
+"Lexing literal_block %r as \"%s\" resulted in an error at token: %r. "
+"Retrying in relaxed mode."
 msgstr ""
 
-#: sphinx/project.py:51
+#: sphinx/project.py:65
 #, python-format
 msgid ""
 "multiple files found for the document \"%s\": %r\n"
 "Use %r for the build."
 msgstr ""
 
-#: sphinx/project.py:57
-msgid "document not readable. Ignored."
-msgstr "المستند غير قابل للقراءة. تجاهل."
+#: sphinx/project.py:74
+#, python-format
+msgid "Ignored unreadable document %r."
+msgstr ""
 
-#: sphinx/registry.py:132
+#: sphinx/registry.py:136
 #, python-format
 msgid "Builder class %s has no \"name\" attribute"
 msgstr ""
 
-#: sphinx/registry.py:134
+#: sphinx/registry.py:138
 #, python-format
 msgid "Builder %r already exists (in module %s)"
 msgstr ""
 
-#: sphinx/registry.py:147
+#: sphinx/registry.py:151
 #, python-format
 msgid "Builder name %s not registered or available through entry point"
 msgstr ""
 
-#: sphinx/registry.py:155
+#: sphinx/registry.py:158
 #, python-format
 msgid "Builder name %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:162
+#: sphinx/registry.py:165
 #, python-format
 msgid "domain %s already registered"
 msgstr ""
 
-#: sphinx/registry.py:185 sphinx/registry.py:198 sphinx/registry.py:209
+#: sphinx/registry.py:188 sphinx/registry.py:201 sphinx/registry.py:212
 #, python-format
 msgid "domain %s not yet registered"
 msgstr ""
 
-#: sphinx/registry.py:189
+#: sphinx/registry.py:192
 #, python-format
 msgid "The %r directive is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:201
+#: sphinx/registry.py:204
 #, python-format
 msgid "The %r role is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:212
+#: sphinx/registry.py:215
 #, python-format
 msgid "The %r index is already registered to domain %s"
 msgstr ""
 
-#: sphinx/registry.py:243
+#: sphinx/registry.py:246
 #, python-format
 msgid "The %r object_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:269
+#: sphinx/registry.py:272
 #, python-format
 msgid "The %r crossref_type is already registered"
 msgstr ""
 
-#: sphinx/registry.py:276
+#: sphinx/registry.py:279
 #, python-format
 msgid "source_suffix %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:285
+#: sphinx/registry.py:288
 #, python-format
 msgid "source_parser for %r is already registered"
 msgstr ""
 
-#: sphinx/registry.py:293
+#: sphinx/registry.py:296
 #, python-format
 msgid "Source parser for %s not registered"
 msgstr ""
 
-#: sphinx/registry.py:309
+#: sphinx/registry.py:312
 #, python-format
 msgid "Translator for %r already exists"
 msgstr ""
 
-#: sphinx/registry.py:325
+#: sphinx/registry.py:328
 #, python-format
 msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r"
 msgstr ""
 
-#: sphinx/registry.py:407
+#: sphinx/registry.py:411
 #, python-format
 msgid "enumerable_node %r already registered"
 msgstr ""
 
-#: sphinx/registry.py:419
+#: sphinx/registry.py:423
 #, python-format
 msgid "math renderer %s is already registered"
 msgstr ""
 
-#: sphinx/registry.py:432
+#: sphinx/registry.py:438
 #, python-format
 msgid ""
 "the extension %r was already merged with Sphinx since version %s; this "
 "extension is ignored."
 msgstr ""
 
-#: sphinx/registry.py:443
+#: sphinx/registry.py:449
 msgid "Original exception:\n"
 msgstr ""
 
-#: sphinx/registry.py:444
+#: sphinx/registry.py:450
 #, python-format
 msgid "Could not import extension %s"
 msgstr ""
 
-#: sphinx/registry.py:449
+#: sphinx/registry.py:455
 #, python-format
 msgid ""
 "extension %r has no setup() function; is it really a Sphinx extension "
 "module?"
 msgstr ""
 
-#: sphinx/registry.py:458
+#: sphinx/registry.py:464
 #, python-format
 msgid ""
 "The %s extension used by this project needs at least Sphinx v%s; it "
 "therefore cannot be built with this version."
 msgstr ""
 
-#: sphinx/registry.py:466
+#: sphinx/registry.py:472
 #, python-format
 msgid ""
 "extension %r returned an unsupported object from its setup() function; it "
 "should return None or a metadata dictionary"
 msgstr ""
 
-#: sphinx/roles.py:175
+#: sphinx/roles.py:178
 #, python-format
 msgid "Python Enhancement Proposals; PEP %s"
 msgstr ""
 
-#: sphinx/roles.py:191
+#: sphinx/roles.py:194
 #, python-format
 msgid "invalid PEP number %s"
 msgstr ""
 
-#: sphinx/roles.py:225
+#: sphinx/roles.py:228
 #, python-format
 msgid "invalid RFC number %s"
 msgstr ""
 
-#: sphinx/theming.py:75
+#: sphinx/theming.py:77
 #, python-format
 msgid "theme %r doesn't have \"theme\" setting"
 msgstr "التصميم %r "
 
-#: sphinx/theming.py:77
+#: sphinx/theming.py:79
 #, python-format
 msgid "theme %r doesn't have \"inherit\" setting"
 msgstr ""
 
-#: sphinx/theming.py:83
+#: sphinx/theming.py:85
 #, python-format
 msgid "no theme named %r found, inherited by %r"
 msgstr ""
 
-#: sphinx/theming.py:106
+#: sphinx/theming.py:108
 #, python-format
 msgid "setting %s.%s occurs in none of the searched theme configs"
 msgstr ""
 
-#: sphinx/theming.py:124
+#: sphinx/theming.py:127
 #, python-format
 msgid "unsupported theme option %r given"
 msgstr ""
 
-#: sphinx/theming.py:214
+#: sphinx/theming.py:216
 #, python-format
 msgid "file %r on theme path is not a valid zipfile or contains no theme"
 msgstr ""
 
-#: sphinx/theming.py:228
+#: sphinx/theming.py:230
 #, python-format
 msgid "no theme named %r found (missing theme.conf?)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:180
+#: sphinx/builders/__init__.py:183
 #, python-format
 msgid "a suitable image for %s builder not found: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/__init__.py:184
+#: sphinx/builders/__init__.py:187
 #, python-format
 msgid "a suitable image for %s builder not found: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:204
+#: sphinx/builders/__init__.py:207
 msgid "building [mo]: "
 msgstr "بناء [mo]:"
 
-#: sphinx/builders/__init__.py:205 sphinx/builders/__init__.py:571
-#: sphinx/builders/__init__.py:598
+#: sphinx/builders/__init__.py:208 sphinx/builders/__init__.py:575
+#: sphinx/builders/__init__.py:602
 msgid "writing output... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:214
+#: sphinx/builders/__init__.py:217
 #, python-format
 msgid "all of %d po files"
 msgstr ""
 
-#: sphinx/builders/__init__.py:232
+#: sphinx/builders/__init__.py:235
 #, python-format
 msgid "targets for %d po files that are specified"
 msgstr ""
 
-#: sphinx/builders/__init__.py:240
+#: sphinx/builders/__init__.py:243
 #, python-format
 msgid "targets for %d po files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:249
+#: sphinx/builders/__init__.py:252
 msgid "all source files"
 msgstr "جميع ملفات المصدر"
 
-#: sphinx/builders/__init__.py:259
+#: sphinx/builders/__init__.py:262
 #, python-format
 msgid "file %r given on command line does not exist, "
 msgstr ""
 
-#: sphinx/builders/__init__.py:264
+#: sphinx/builders/__init__.py:267
 #, python-format
 msgid ""
 "file %r given on command line is not under the source directory, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:270
+#: sphinx/builders/__init__.py:273
 #, python-format
 msgid "file %r given on command line is not a valid document, ignoring"
 msgstr ""
 
-#: sphinx/builders/__init__.py:279
+#: sphinx/builders/__init__.py:282
 #, python-format
 msgid "%d source files given on command line"
 msgstr ""
 
-#: sphinx/builders/__init__.py:291
+#: sphinx/builders/__init__.py:294
 #, python-format
 msgid "targets for %d source files that are out of date"
 msgstr ""
 
-#: sphinx/builders/__init__.py:306 sphinx/builders/gettext.py:240
+#: sphinx/builders/__init__.py:309 sphinx/builders/gettext.py:236
 #, python-format
 msgid "building [%s]: "
 msgstr "بناء [%s]"
 
-#: sphinx/builders/__init__.py:313
+#: sphinx/builders/__init__.py:316
 msgid "looking for now-outdated files... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:318
+#: sphinx/builders/__init__.py:321
 #, python-format
 msgid "%d found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:320
+#: sphinx/builders/__init__.py:323
 msgid "none found"
 msgstr ""
 
-#: sphinx/builders/__init__.py:325
+#: sphinx/builders/__init__.py:328
 msgid "pickling environment"
 msgstr ""
 
-#: sphinx/builders/__init__.py:331
+#: sphinx/builders/__init__.py:334
 msgid "checking consistency"
 msgstr "التحقق من التوافق"
 
-#: sphinx/builders/__init__.py:335
+#: sphinx/builders/__init__.py:338
 msgid "no targets are out of date."
 msgstr ""
 
-#: sphinx/builders/__init__.py:374
+#: sphinx/builders/__init__.py:377
 msgid "updating environment: "
 msgstr "تحديث البيئة:"
 
-#: sphinx/builders/__init__.py:395
+#: sphinx/builders/__init__.py:398
 #, python-format
 msgid "%s added, %s changed, %s removed"
 msgstr ""
 
-#: sphinx/builders/__init__.py:433 sphinx/builders/__init__.py:445
+#: sphinx/builders/__init__.py:436 sphinx/builders/__init__.py:448
 msgid "reading sources... "
 msgstr ""
 
-#: sphinx/builders/__init__.py:546
+#: sphinx/builders/__init__.py:550
 #, python-format
 msgid "docnames to write: %s"
 msgstr ""
 
-#: sphinx/builders/__init__.py:555 sphinx/builders/singlehtml.py:148
+#: sphinx/builders/__init__.py:559 sphinx/builders/singlehtml.py:155
 msgid "preparing documents"
 msgstr "تجهيز المستندات"
 
-#: sphinx/builders/__init__.py:558
+#: sphinx/builders/__init__.py:562
 msgid "copying assets"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:214
+#: sphinx/builders/_epub_base.py:215
 #, python-format
 msgid "duplicated ToC entry found: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:402 sphinx/builders/html/__init__.py:770
-#: sphinx/builders/latex/__init__.py:420 sphinx/builders/texinfo.py:178
+#: sphinx/builders/_epub_base.py:403 sphinx/builders/html/__init__.py:748
+#: sphinx/builders/latex/__init__.py:425 sphinx/builders/texinfo.py:183
 msgid "copying images... "
 msgstr "نسخ الصور..."
 
-#: sphinx/builders/_epub_base.py:409
+#: sphinx/builders/_epub_base.py:410
 #, python-format
 msgid "cannot read image file %r: copying it instead"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:415 sphinx/builders/html/__init__.py:778
-#: sphinx/builders/latex/__init__.py:428 sphinx/builders/texinfo.py:188
+#: sphinx/builders/_epub_base.py:416 sphinx/builders/html/__init__.py:756
+#: sphinx/builders/latex/__init__.py:433 sphinx/builders/texinfo.py:193
 #, python-format
 msgid "cannot copy image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:432
+#: sphinx/builders/_epub_base.py:433
 #, python-format
 msgid "cannot write image file %r: %s"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:442
+#: sphinx/builders/_epub_base.py:443
 msgid "Pillow not found - copying image files"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:468
+#: sphinx/builders/_epub_base.py:469
 msgid "writing mimetype file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:473
+#: sphinx/builders/_epub_base.py:474
 msgid "writing META-INF/container.xml file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:501
+#: sphinx/builders/_epub_base.py:508
 msgid "writing content.opf file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:527
+#: sphinx/builders/_epub_base.py:531
 #, python-format
 msgid "unknown mimetype for %s, ignoring"
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:674
+#: sphinx/builders/_epub_base.py:678
 msgid "writing toc.ncx file..."
 msgstr ""
 
-#: sphinx/builders/_epub_base.py:699
+#: sphinx/builders/_epub_base.py:703
 #, python-format
 msgid "writing %s file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:28
+#: sphinx/builders/changes.py:30
 #, python-format
 msgid "The overview file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/changes.py:54
+#: sphinx/builders/changes.py:56
 #, python-format
 msgid "no changes in version %s."
 msgstr ""
 
-#: sphinx/builders/changes.py:56
+#: sphinx/builders/changes.py:58
 msgid "writing summary file..."
 msgstr ""
 
-#: sphinx/builders/changes.py:71
+#: sphinx/builders/changes.py:73
 msgid "Builtins"
 msgstr ""
 
-#: sphinx/builders/changes.py:73
+#: sphinx/builders/changes.py:75
 msgid "Module level"
 msgstr ""
 
-#: sphinx/builders/changes.py:116
+#: sphinx/builders/changes.py:118
 msgid "copying source files..."
 msgstr ""
 
-#: sphinx/builders/changes.py:123
+#: sphinx/builders/changes.py:125
 #, python-format
 msgid "could not read %r for changelog creation"
 msgstr ""
 
-#: sphinx/builders/dummy.py:16
+#: sphinx/builders/dummy.py:18
 msgid "The dummy builder generates no files."
 msgstr ""
 
-#: sphinx/builders/epub3.py:77
+#: sphinx/builders/epub3.py:79
 #, python-format
 msgid "The ePub file is in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/epub3.py:175
+#: sphinx/builders/epub3.py:183
 msgid "writing nav.xhtml file..."
 msgstr ""
 
-#: sphinx/builders/epub3.py:201
+#: sphinx/builders/epub3.py:209
 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:205
+#: sphinx/builders/epub3.py:213
 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:208
+#: sphinx/builders/epub3.py:216
 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:212
+#: sphinx/builders/epub3.py:220
 msgid "conf value \"epub_author\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:215
+#: sphinx/builders/epub3.py:223
 msgid "conf value \"epub_contributor\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:218
+#: sphinx/builders/epub3.py:226
 msgid "conf value \"epub_description\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:221
+#: sphinx/builders/epub3.py:229
 msgid "conf value \"epub_publisher\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:224
+#: sphinx/builders/epub3.py:232
 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:228
+#: sphinx/builders/epub3.py:236
 msgid "conf value \"epub_identifier\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:231
+#: sphinx/builders/epub3.py:239
 msgid "conf value \"version\" should not be empty for EPUB3"
 msgstr ""
 
-#: sphinx/builders/epub3.py:245 sphinx/builders/html/__init__.py:1164
+#: sphinx/builders/epub3.py:253 sphinx/builders/html/__init__.py:1187
 #, python-format
 msgid "invalid css_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/gettext.py:219
+#: sphinx/builders/gettext.py:215
 #, python-format
 msgid "The message catalogs are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/gettext.py:241
+#: sphinx/builders/gettext.py:237
 #, python-format
 msgid "targets for %d template files"
 msgstr ""
 
-#: sphinx/builders/gettext.py:245
+#: sphinx/builders/gettext.py:241
 msgid "reading templates... "
 msgstr "قراءة القوالب"
 
-#: sphinx/builders/gettext.py:278
+#: sphinx/builders/gettext.py:275
 msgid "writing message catalogs... "
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:53
+#: sphinx/builders/linkcheck.py:60
 #, python-format
 msgid "Look for any errors in the above output or in %(outdir)s/output.txt"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:102
+#: sphinx/builders/linkcheck.py:109
 #, python-format
 msgid "broken link: %s (%s)"
 msgstr ""
 
-#: sphinx/builders/linkcheck.py:598
+#: sphinx/builders/linkcheck.py:606
 #, python-format
 msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s"
 msgstr ""
 
-#: sphinx/builders/manpage.py:33
+#: sphinx/builders/manpage.py:35
 #, python-format
 msgid "The manual pages are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/manpage.py:40
+#: sphinx/builders/manpage.py:42
 msgid "no \"man_pages\" config value found; no manual pages will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:304 sphinx/builders/manpage.py:49
-#: sphinx/builders/singlehtml.py:156 sphinx/builders/texinfo.py:105
+#: sphinx/builders/latex/__init__.py:309 sphinx/builders/manpage.py:51
+#: sphinx/builders/singlehtml.py:163 sphinx/builders/texinfo.py:110
 msgid "writing"
 msgstr ""
 
-#: sphinx/builders/manpage.py:64
+#: sphinx/builders/manpage.py:66
 #, python-format
 msgid "\"man_pages\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:29
+#: sphinx/builders/singlehtml.py:32
 #, python-format
 msgid "The HTML page is in %(outdir)s."
 msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/singlehtml.py:151
+#: sphinx/builders/singlehtml.py:158
 msgid "assembling single document"
 msgstr ""
 
-#: sphinx/builders/singlehtml.py:169
+#: sphinx/builders/singlehtml.py:176
 msgid "writing additional files"
 msgstr "كتابة ملفات إضافية"
 
-#: sphinx/builders/texinfo.py:41
+#: sphinx/builders/texinfo.py:46
 #, python-format
 msgid "The Texinfo files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:43
+#: sphinx/builders/texinfo.py:48
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through makeinfo\n"
 "(use 'make info' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/texinfo.py:70
+#: sphinx/builders/texinfo.py:75
 msgid "no \"texinfo_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:78
+#: sphinx/builders/texinfo.py:83
 #, python-format
 msgid "\"texinfo_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:286 sphinx/builders/texinfo.py:101
+#: sphinx/builders/latex/__init__.py:291 sphinx/builders/texinfo.py:106
 #, python-format
 msgid "processing %s"
 msgstr "معالجة %s"
 
-#: sphinx/builders/latex/__init__.py:359 sphinx/builders/texinfo.py:154
+#: sphinx/builders/latex/__init__.py:364 sphinx/builders/texinfo.py:159
 msgid "resolving references..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:369 sphinx/builders/texinfo.py:163
+#: sphinx/builders/latex/__init__.py:374 sphinx/builders/texinfo.py:168
 msgid " (in "
 msgstr ""
 
-#: sphinx/builders/texinfo.py:193
+#: sphinx/builders/texinfo.py:198
 msgid "copying Texinfo support files"
 msgstr ""
 
-#: sphinx/builders/texinfo.py:197
+#: sphinx/builders/texinfo.py:202
 #, python-format
 msgid "error writing file Makefile: %s"
 msgstr ""
 
-#: sphinx/builders/text.py:24
+#: sphinx/builders/text.py:29
 #, python-format
 msgid "The text files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1117 sphinx/builders/text.py:71
-#: sphinx/builders/xml.py:89
+#: sphinx/builders/html/__init__.py:1138 sphinx/builders/text.py:76
+#: sphinx/builders/xml.py:94
 #, python-format
 msgid "error writing file %s: %s"
 msgstr ""
 
-#: sphinx/builders/xml.py:29
+#: sphinx/builders/xml.py:34
 #, python-format
 msgid "The XML files are in %(outdir)s."
 msgstr "ملفات الXML موجودة في %(outdir)s"
 
-#: sphinx/builders/xml.py:101
+#: sphinx/builders/xml.py:106
 #, python-format
 msgid "The pseudo-XML files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:160
+#: sphinx/builders/html/__init__.py:122
 #, python-format
 msgid "build info file is broken: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:197
+#: sphinx/builders/html/__init__.py:159
 #, python-format
 msgid "The HTML pages are in %(outdir)s."
 msgstr "صفحة الHTML موجودة في  %(outdir)s"
 
-#: sphinx/builders/html/__init__.py:409
+#: sphinx/builders/html/__init__.py:383
 #, python-format
 msgid "Failed to read build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:503 sphinx/builders/latex/__init__.py:182
-#: sphinx/transforms/__init__.py:109 sphinx/writers/manpage.py:96
-#: sphinx/writers/texinfo.py:223
+#: sphinx/builders/html/__init__.py:476 sphinx/builders/latex/__init__.py:187
+#: sphinx/transforms/__init__.py:117 sphinx/writers/manpage.py:100
+#: sphinx/writers/texinfo.py:225
 #, python-format
 msgid "%b %d, %Y"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:522 sphinx/themes/basic/defindex.html:30
+#: sphinx/builders/html/__init__.py:495 sphinx/themes/basic/defindex.html:30
 msgid "General Index"
 msgstr "الفهرس العام"
 
-#: sphinx/builders/html/__init__.py:522
+#: sphinx/builders/html/__init__.py:495
 msgid "index"
 msgstr "الفهرس"
 
-#: sphinx/builders/html/__init__.py:588
+#: sphinx/builders/html/__init__.py:567
 msgid "next"
 msgstr "التالي"
 
-#: sphinx/builders/html/__init__.py:597
+#: sphinx/builders/html/__init__.py:576
 msgid "previous"
 msgstr "السابق"
 
-#: sphinx/builders/html/__init__.py:694
+#: sphinx/builders/html/__init__.py:672
 msgid "generating indices"
 msgstr "إنشاء الفهرس"
 
-#: sphinx/builders/html/__init__.py:709
+#: sphinx/builders/html/__init__.py:687
 msgid "writing additional pages"
 msgstr "كتابة صفحات إضافية "
 
-#: sphinx/builders/html/__init__.py:788
+#: sphinx/builders/html/__init__.py:766
 msgid "copying downloadable files... "
 msgstr "نسخ الملفات القابلة للتحميل للنسخ..."
 
-#: sphinx/builders/html/__init__.py:796
+#: sphinx/builders/html/__init__.py:774
 #, python-format
 msgid "cannot copy downloadable file %r: %s"
 msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s"
 
-#: sphinx/builders/html/__init__.py:829 sphinx/builders/html/__init__.py:841
+#: sphinx/builders/html/__init__.py:807 sphinx/builders/html/__init__.py:819
 #, python-format
 msgid "Failed to copy a file in html_static_file: %s: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:862
+#: sphinx/builders/html/__init__.py:840
 msgid "copying static files"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:878
+#: sphinx/builders/html/__init__.py:856
 #, python-format
 msgid "cannot copy static file %r"
 msgstr "غير قادر على نسخ الملف الثابت %r"
 
-#: sphinx/builders/html/__init__.py:883
+#: sphinx/builders/html/__init__.py:861
 msgid "copying extra files"
 msgstr "نسخ ملفات إضافية"
 
-#: sphinx/builders/html/__init__.py:889
+#: sphinx/builders/html/__init__.py:867
 #, python-format
 msgid "cannot copy extra file %r"
 msgstr "غير قادر على نسخ المف الإضافي %r"
 
-#: sphinx/builders/html/__init__.py:896
+#: sphinx/builders/html/__init__.py:874
 #, python-format
 msgid "Failed to write build info file: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:944
+#: sphinx/builders/html/__init__.py:923
 msgid ""
 "search index couldn't be loaded, but not all documents will be built: the "
 "index will be incomplete."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1005
+#: sphinx/builders/html/__init__.py:984
 #, python-format
 msgid "page %s matches two patterns in html_sidebars: %r and %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1100
+#: sphinx/builders/html/__init__.py:1121
 #, python-format
 msgid ""
 "a Unicode error occurred when rendering the page %s. Please make sure all "
 "config values that contain non-ASCII content are Unicode strings."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1105
+#: sphinx/builders/html/__init__.py:1126
 #, python-format
 msgid ""
 "An error happened in rendering the page %s.\n"
 "Reason: %r"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1134
+#: sphinx/builders/html/__init__.py:1154
 msgid "dumping object inventory"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1139
+#: sphinx/builders/html/__init__.py:1162
 #, python-format
 msgid "dumping search index in %s"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1181
+#: sphinx/builders/html/__init__.py:1210
 #, python-format
 msgid "invalid js_file: %r, ignored"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1285
+#: sphinx/builders/html/__init__.py:1238
 msgid "Many math_renderers are registered. But no math_renderer is selected."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1288
+#: sphinx/builders/html/__init__.py:1241
 #, python-format
 msgid "Unknown math_renderer %r is given."
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1296
+#: sphinx/builders/html/__init__.py:1249
 #, python-format
 msgid "html_extra_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1300
+#: sphinx/builders/html/__init__.py:1253
 #, python-format
 msgid "html_extra_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1309
+#: sphinx/builders/html/__init__.py:1262
 #, python-format
 msgid "html_static_path entry %r does not exist"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1313
+#: sphinx/builders/html/__init__.py:1266
 #, python-format
 msgid "html_static_path entry %r is placed inside outdir"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1322 sphinx/builders/latex/__init__.py:432
+#: sphinx/builders/html/__init__.py:1275 sphinx/builders/latex/__init__.py:437
 #, python-format
 msgid "logo file %r does not exist"
 msgstr "ملف الشعار %r غير موجود"
 
-#: sphinx/builders/html/__init__.py:1331
+#: sphinx/builders/html/__init__.py:1284
 #, python-format
 msgid "favicon file %r does not exist"
 msgstr "ملف الايقونة %r غير موجود"
 
-#: sphinx/builders/html/__init__.py:1338
+#: sphinx/builders/html/__init__.py:1291
 msgid ""
 "HTML 4 is no longer supported by Sphinx. (\"html4_writer=True\" detected in "
 "configuration options)"
 msgstr ""
 
-#: sphinx/builders/html/__init__.py:1353
+#: sphinx/builders/html/__init__.py:1306
 #, python-format
 msgid "%s %s documentation"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:108
+#: sphinx/builders/latex/__init__.py:113
 #, python-format
 msgid "The LaTeX files are in %(outdir)s."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:110
+#: sphinx/builders/latex/__init__.py:115
 msgid ""
 "\n"
 "Run 'make' in that directory to run these through (pdf)latex\n"
 "(use `make latexpdf' here to do that automatically)."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:145
+#: sphinx/builders/latex/__init__.py:150
 msgid "no \"latex_documents\" config value found; no documents will be written"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:153
+#: sphinx/builders/latex/__init__.py:158
 #, python-format
 msgid "\"latex_documents\" config value references unknown document %s"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:189 sphinx/domains/std.py:553
-#: sphinx/domains/std.py:565 sphinx/templates/latex/latex.tex_t:106
+#: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:557
+#: sphinx/domains/std.py:569 sphinx/templates/latex/latex.tex_t:106
 #: sphinx/themes/basic/genindex-single.html:30
 #: sphinx/themes/basic/genindex-single.html:55
 #: sphinx/themes/basic/genindex-split.html:11
 #: sphinx/themes/basic/genindex-split.html:14
 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34
 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:138
-#: sphinx/writers/texinfo.py:491
+#: sphinx/writers/texinfo.py:493
 msgid "Index"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:192 sphinx/templates/latex/latex.tex_t:91
+#: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:91
 msgid "Release"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:206 sphinx/writers/latex.py:366
+#: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:370
 #, python-format
 msgid "no Babel option known for language %r"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:382
+#: sphinx/builders/latex/__init__.py:387
 msgid "copying TeX support files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:398
+#: sphinx/builders/latex/__init__.py:403
 msgid "copying TeX support files..."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:411
+#: sphinx/builders/latex/__init__.py:416
 msgid "copying additional files"
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:454
+#: sphinx/builders/latex/__init__.py:459
 #, python-format
 msgid "Unknown configure key: latex_elements[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/__init__.py:462
+#: sphinx/builders/latex/__init__.py:467
 #, python-format
 msgid "Unknown theme option: latex_theme_options[%r], ignored."
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:84
+#: sphinx/builders/latex/theming.py:87
 #, python-format
 msgid "%r doesn't have \"theme\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/theming.py:87
+#: sphinx/builders/latex/theming.py:90
 #, python-format
 msgid "%r doesn't have \"%s\" setting"
 msgstr ""
 
-#: sphinx/builders/latex/transforms.py:114
+#: sphinx/builders/latex/transforms.py:117
 msgid "Failed to get a docname!"
 msgstr ""
 
-#: sphinx/builders/latex/transforms.py:115
+#: sphinx/builders/latex/transforms.py:118
 msgid "Failed to get a docname for source {source!r}!"
 msgstr ""
 
-#: sphinx/builders/latex/transforms.py:476
+#: sphinx/builders/latex/transforms.py:479
 #, python-format
 msgid "No footnote was found for given reference node %r"
 msgstr ""
 
-#: sphinx/cmd/build.py:37
+#: sphinx/cmd/build.py:46
 msgid "Exception occurred while building, starting debugger:"
 msgstr ""
 
-#: sphinx/cmd/build.py:52
+#: sphinx/cmd/build.py:61
 msgid "Interrupted!"
 msgstr ""
 
-#: sphinx/cmd/build.py:54
+#: sphinx/cmd/build.py:63
 msgid "reST markup error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:60
+#: sphinx/cmd/build.py:69
 msgid "Encoding error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:63 sphinx/cmd/build.py:78
+#: sphinx/cmd/build.py:72 sphinx/cmd/build.py:87
 #, python-format
 msgid ""
 "The full traceback has been saved in %s, if you want to report the issue to "
 "the developers."
 msgstr ""
 
-#: sphinx/cmd/build.py:67
+#: sphinx/cmd/build.py:76
 msgid "Recursion error:"
 msgstr ""
 
-#: sphinx/cmd/build.py:70
+#: sphinx/cmd/build.py:79
 msgid ""
 "This can happen with very large or deeply nested source files. You can "
 "carefully increase the default Python recursion limit of 1000 in conf.py "
 "with e.g.:"
 msgstr ""
 
-#: sphinx/cmd/build.py:75
+#: sphinx/cmd/build.py:84
 msgid "Exception occurred:"
 msgstr ""
 
-#: sphinx/cmd/build.py:81
+#: sphinx/cmd/build.py:90
 msgid ""
 "Please also report this if it was a user error, so that a better error "
 "message can be provided next time."
 msgstr ""
 
-#: sphinx/cmd/build.py:84
+#: sphinx/cmd/build.py:93
 msgid ""
 "A bug report can be filed in the tracker at <https://github.com/sphinx-"
 "doc/sphinx/issues>. Thanks!"
 msgstr ""
 
-#: sphinx/cmd/build.py:100
+#: sphinx/cmd/build.py:109
 msgid "job number should be a positive number"
 msgstr ""
 
-#: sphinx/cmd/build.py:108 sphinx/cmd/quickstart.py:468
-#: sphinx/ext/apidoc.py:300 sphinx/ext/autosummary/generate.py:641
+#: sphinx/cmd/build.py:117 sphinx/cmd/quickstart.py:477
+#: sphinx/ext/apidoc.py:319 sphinx/ext/autosummary/generate.py:689
 msgid "For more information, visit <https://www.sphinx-doc.org/>."
 msgstr ""
 
-#: sphinx/cmd/build.py:109
+#: sphinx/cmd/build.py:118
 msgid ""
 "\n"
 "Generate documentation from source files.\n"
@@ -1242,266 +1245,266 @@ msgid ""
 "files can be built by specifying individual filenames.\n"
 msgstr ""
 
-#: sphinx/cmd/build.py:130
+#: sphinx/cmd/build.py:139
 msgid "path to documentation source files"
 msgstr ""
 
-#: sphinx/cmd/build.py:132
+#: sphinx/cmd/build.py:141
 msgid "path to output directory"
 msgstr ""
 
-#: sphinx/cmd/build.py:134
+#: sphinx/cmd/build.py:143
 msgid "a list of specific files to rebuild. Ignored if -a is specified"
 msgstr ""
 
-#: sphinx/cmd/build.py:137
+#: sphinx/cmd/build.py:146
 msgid "general options"
 msgstr ""
 
-#: sphinx/cmd/build.py:140
+#: sphinx/cmd/build.py:149
 msgid "builder to use (default: html)"
 msgstr ""
 
-#: sphinx/cmd/build.py:142
+#: sphinx/cmd/build.py:151
 msgid "write all files (default: only write new and changed files)"
 msgstr ""
 
-#: sphinx/cmd/build.py:145
+#: sphinx/cmd/build.py:154
 msgid "don't use a saved environment, always read all files"
 msgstr ""
 
-#: sphinx/cmd/build.py:148
+#: sphinx/cmd/build.py:157
 msgid ""
 "path for the cached environment and doctree files (default: "
 "OUTPUTDIR/.doctrees)"
 msgstr ""
 
-#: sphinx/cmd/build.py:152
+#: sphinx/cmd/build.py:161
 msgid ""
 "build in parallel with N processes where possible (special value \"auto\" "
 "will set N to cpu-count)"
 msgstr ""
 
-#: sphinx/cmd/build.py:156
+#: sphinx/cmd/build.py:165
 msgid ""
 "path where configuration file (conf.py) is located (default: same as "
 "SOURCEDIR)"
 msgstr ""
 
-#: sphinx/cmd/build.py:159
+#: sphinx/cmd/build.py:168
 msgid "use no config file at all, only -D options"
 msgstr ""
 
-#: sphinx/cmd/build.py:162
+#: sphinx/cmd/build.py:171
 msgid "override a setting in configuration file"
 msgstr ""
 
-#: sphinx/cmd/build.py:165
+#: sphinx/cmd/build.py:174
 msgid "pass a value into HTML templates"
 msgstr ""
 
-#: sphinx/cmd/build.py:168
+#: sphinx/cmd/build.py:177
 msgid "define tag: include \"only\" blocks with TAG"
 msgstr ""
 
-#: sphinx/cmd/build.py:170
+#: sphinx/cmd/build.py:179
 msgid "nit-picky mode, warn about all missing references"
 msgstr ""
 
-#: sphinx/cmd/build.py:173
+#: sphinx/cmd/build.py:182
 msgid "console output options"
 msgstr ""
 
-#: sphinx/cmd/build.py:175
+#: sphinx/cmd/build.py:184
 msgid "increase verbosity (can be repeated)"
 msgstr ""
 
-#: sphinx/cmd/build.py:177 sphinx/ext/apidoc.py:323
+#: sphinx/cmd/build.py:186 sphinx/ext/apidoc.py:342
 msgid "no output on stdout, just warnings on stderr"
 msgstr ""
 
-#: sphinx/cmd/build.py:179
+#: sphinx/cmd/build.py:188
 msgid "no output at all, not even warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:182
+#: sphinx/cmd/build.py:191
 msgid "do emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:185
+#: sphinx/cmd/build.py:194
 msgid "do not emit colored output (default: auto-detect)"
 msgstr ""
 
-#: sphinx/cmd/build.py:188
+#: sphinx/cmd/build.py:197
 msgid "write warnings (and errors) to given file"
 msgstr ""
 
-#: sphinx/cmd/build.py:190
+#: sphinx/cmd/build.py:199
 msgid "turn warnings into errors"
 msgstr ""
 
-#: sphinx/cmd/build.py:192
+#: sphinx/cmd/build.py:201
 msgid "with -W, keep going when getting warnings"
 msgstr ""
 
-#: sphinx/cmd/build.py:194
+#: sphinx/cmd/build.py:203
 msgid "show full traceback on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:196
+#: sphinx/cmd/build.py:205
 msgid "run Pdb on exception"
 msgstr ""
 
-#: sphinx/cmd/build.py:220
+#: sphinx/cmd/build.py:229
 msgid "cannot combine -a option and filenames"
 msgstr ""
 
-#: sphinx/cmd/build.py:241
+#: sphinx/cmd/build.py:250
 #, python-format
 msgid "cannot open warning file %r: %s"
 msgstr ""
 
-#: sphinx/cmd/build.py:255
+#: sphinx/cmd/build.py:264
 msgid "-D option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/build.py:262
+#: sphinx/cmd/build.py:271
 msgid "-A option argument must be in the form name=value"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:39
+#: sphinx/cmd/quickstart.py:48
 msgid "automatically insert docstrings from modules"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:40
+#: sphinx/cmd/quickstart.py:49
 msgid "automatically test code snippets in doctest blocks"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:41
+#: sphinx/cmd/quickstart.py:50
 msgid "link between Sphinx documentation of different projects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:42
+#: sphinx/cmd/quickstart.py:51
 msgid "write \"todo\" entries that can be shown or hidden on build"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:43
+#: sphinx/cmd/quickstart.py:52
 msgid "checks for documentation coverage"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:44
+#: sphinx/cmd/quickstart.py:53
 msgid "include math, rendered as PNG or SVG images"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:45
+#: sphinx/cmd/quickstart.py:54
 msgid "include math, rendered in the browser by MathJax"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:46
+#: sphinx/cmd/quickstart.py:55
 msgid "conditional inclusion of content based on config values"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:47
+#: sphinx/cmd/quickstart.py:56
 msgid "include links to the source code of documented Python objects"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:48
+#: sphinx/cmd/quickstart.py:57
 msgid "create .nojekyll file to publish the document on GitHub pages"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:90
+#: sphinx/cmd/quickstart.py:99
 msgid "Please enter a valid path name."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:106
+#: sphinx/cmd/quickstart.py:115
 msgid "Please enter some text."
 msgstr "الرجاء ادخال بعض النصوص"
 
-#: sphinx/cmd/quickstart.py:113
+#: sphinx/cmd/quickstart.py:122
 #, python-format
 msgid "Please enter one of %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:120
+#: sphinx/cmd/quickstart.py:129
 msgid "Please enter either 'y' or 'n'."
 msgstr "أدخل إما 'نعم' أو'لا'"
 
-#: sphinx/cmd/quickstart.py:126
+#: sphinx/cmd/quickstart.py:135
 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'."
 msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'"
 
-#: sphinx/cmd/quickstart.py:206
+#: sphinx/cmd/quickstart.py:215
 #, python-format
 msgid "Welcome to the Sphinx %s quickstart utility."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:208
+#: sphinx/cmd/quickstart.py:217
 msgid ""
 "Please enter values for the following settings (just press Enter to\n"
 "accept a default value, if one is given in brackets)."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:213
+#: sphinx/cmd/quickstart.py:222
 #, python-format
 msgid "Selected root path: %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:216
+#: sphinx/cmd/quickstart.py:225
 msgid "Enter the root path for documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:217
+#: sphinx/cmd/quickstart.py:226
 msgid "Root path for the documentation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:222
+#: sphinx/cmd/quickstart.py:231
 msgid "Error: an existing conf.py has been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:224
+#: sphinx/cmd/quickstart.py:233
 msgid "sphinx-quickstart will not overwrite existing Sphinx projects."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:226
+#: sphinx/cmd/quickstart.py:235
 msgid "Please enter a new root path (or just Enter to exit)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:233
+#: sphinx/cmd/quickstart.py:242
 msgid ""
 "You have two options for placing the build directory for Sphinx output.\n"
 "Either, you use a directory \"_build\" within the root path, or you separate\n"
 "\"source\" and \"build\" directories within the root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:236
+#: sphinx/cmd/quickstart.py:245
 msgid "Separate source and build directories (y/n)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:240
+#: sphinx/cmd/quickstart.py:249
 msgid ""
 "Inside the root directory, two more directories will be created; \"_templates\"\n"
 "for custom HTML templates and \"_static\" for custom stylesheets and other static\n"
 "files. You can enter another prefix (such as \".\") to replace the underscore."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:243
+#: sphinx/cmd/quickstart.py:252
 msgid "Name prefix for templates and static dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:247
+#: sphinx/cmd/quickstart.py:256
 msgid ""
 "The project name will occur in several places in the built documentation."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:248
+#: sphinx/cmd/quickstart.py:257
 msgid "Project name"
 msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:250
+#: sphinx/cmd/quickstart.py:259
 msgid "Author name(s)"
 msgstr "اسم المؤلف(ون)"
 
-#: sphinx/cmd/quickstart.py:254
+#: sphinx/cmd/quickstart.py:263
 msgid ""
 "Sphinx has the notion of a \"version\" and a \"release\" for the\n"
 "software. Each version can have multiple releases. For example, for\n"
@@ -1510,15 +1513,15 @@ msgid ""
 "just set both to the same value."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:259
+#: sphinx/cmd/quickstart.py:268
 msgid "Project version"
 msgstr "نسخة المشروع"
 
-#: sphinx/cmd/quickstart.py:261
+#: sphinx/cmd/quickstart.py:270
 msgid "Project release"
 msgstr "إصدار المشروع"
 
-#: sphinx/cmd/quickstart.py:265
+#: sphinx/cmd/quickstart.py:274
 msgid ""
 "If the documents are to be written in a language other than English,\n"
 "you can select a language here by its language code. Sphinx will then\n"
@@ -1528,21 +1531,21 @@ msgid ""
 "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:273
+#: sphinx/cmd/quickstart.py:282
 msgid "Project language"
 msgstr "لغة المشروع"
 
-#: sphinx/cmd/quickstart.py:279
+#: sphinx/cmd/quickstart.py:288
 msgid ""
 "The file name suffix for source files. Commonly, this is either \".txt\"\n"
 "or \".rst\". Only files with this suffix are considered documents."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:281
+#: sphinx/cmd/quickstart.py:290
 msgid "Source file suffix"
 msgstr "امتداد ملف المصدر"
 
-#: sphinx/cmd/quickstart.py:285
+#: sphinx/cmd/quickstart.py:294
 msgid ""
 "One document is special in that it is considered the top node of the\n"
 "\"contents tree\", that is, it is the root of the hierarchical structure\n"
@@ -1550,91 +1553,91 @@ msgid ""
 "document is a custom template, you can also set this to another filename."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:289
+#: sphinx/cmd/quickstart.py:298
 msgid "Name of your master document (without suffix)"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:294
+#: sphinx/cmd/quickstart.py:303
 #, python-format
 msgid ""
 "Error: the master file %s has already been found in the selected root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:296
+#: sphinx/cmd/quickstart.py:305
 msgid "sphinx-quickstart will not overwrite the existing file."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:298
+#: sphinx/cmd/quickstart.py:307
 msgid ""
 "Please enter a new file name, or rename the existing file and press Enter"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:302
+#: sphinx/cmd/quickstart.py:311
 msgid "Indicate which of the following Sphinx extensions should be enabled:"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:310
+#: sphinx/cmd/quickstart.py:319
 msgid ""
 "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has "
 "been deselected."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:316
+#: sphinx/cmd/quickstart.py:325
 msgid ""
 "A Makefile and a Windows command file can be generated for you so that you\n"
 "only have to run e.g. `make html' instead of invoking sphinx-build\n"
 "directly."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:319
+#: sphinx/cmd/quickstart.py:328
 msgid "Create Makefile? (y/n)"
 msgstr "إنشاء Makefile ؟ (نعم / لا)"
 
-#: sphinx/cmd/quickstart.py:322
+#: sphinx/cmd/quickstart.py:331
 msgid "Create Windows command file? (y/n)"
 msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)"
 
-#: sphinx/cmd/quickstart.py:366 sphinx/ext/apidoc.py:86
+#: sphinx/cmd/quickstart.py:375 sphinx/ext/apidoc.py:93
 #, python-format
 msgid "Creating file %s."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:371 sphinx/ext/apidoc.py:83
+#: sphinx/cmd/quickstart.py:380 sphinx/ext/apidoc.py:90
 #, python-format
 msgid "File %s already exists, skipping."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:413
+#: sphinx/cmd/quickstart.py:422
 msgid "Finished: An initial directory structure has been created."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:415
+#: sphinx/cmd/quickstart.py:424
 #, python-format
 msgid ""
 "You should now populate your master file %s and create other documentation\n"
 "source files. "
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:418
+#: sphinx/cmd/quickstart.py:427
 msgid ""
 "Use the Makefile to build the docs, like so:\n"
 "   make builder"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:421
+#: sphinx/cmd/quickstart.py:430
 #, python-format
 msgid ""
 "Use the sphinx-build command to build the docs, like so:\n"
 "   sphinx-build -b builder %s %s"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:423
+#: sphinx/cmd/quickstart.py:432
 msgid ""
 "where \"builder\" is one of the supported builders, e.g. html, latex or "
 "linkcheck."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:458
+#: sphinx/cmd/quickstart.py:467
 msgid ""
 "\n"
 "Generate required files for a Sphinx project.\n"
@@ -1644,226 +1647,226 @@ msgid ""
 "Makefile to be used with sphinx-build.\n"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:473
+#: sphinx/cmd/quickstart.py:482
 msgid "quiet mode"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:478
+#: sphinx/cmd/quickstart.py:487
 msgid "project root"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:480
+#: sphinx/cmd/quickstart.py:489
 msgid "Structure options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:482
+#: sphinx/cmd/quickstart.py:491
 msgid "if specified, separate source and build dirs"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:484
+#: sphinx/cmd/quickstart.py:493
 msgid "if specified, create build dir under source dir"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:486
+#: sphinx/cmd/quickstart.py:495
 msgid "replacement for dot in _templates etc."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:488
+#: sphinx/cmd/quickstart.py:497
 msgid "Project basic options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:490
+#: sphinx/cmd/quickstart.py:499
 msgid "project name"
 msgstr "اسم المشروع"
 
-#: sphinx/cmd/quickstart.py:492
+#: sphinx/cmd/quickstart.py:501
 msgid "author names"
 msgstr "أسماء المؤلفين"
 
-#: sphinx/cmd/quickstart.py:494
+#: sphinx/cmd/quickstart.py:503
 msgid "version of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:496
+#: sphinx/cmd/quickstart.py:505
 msgid "release of project"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:498
+#: sphinx/cmd/quickstart.py:507
 msgid "document language"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:500
+#: sphinx/cmd/quickstart.py:509
 msgid "source file suffix"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:502
+#: sphinx/cmd/quickstart.py:511
 msgid "master document name"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:504
+#: sphinx/cmd/quickstart.py:513
 msgid "use epub"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:506
+#: sphinx/cmd/quickstart.py:515
 msgid "Extension options"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:510 sphinx/ext/apidoc.py:383
+#: sphinx/cmd/quickstart.py:519 sphinx/ext/apidoc.py:402
 #, python-format
 msgid "enable %s extension"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:379
+#: sphinx/cmd/quickstart.py:521 sphinx/ext/apidoc.py:398
 msgid "enable arbitrary extensions"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:514
+#: sphinx/cmd/quickstart.py:523
 msgid "Makefile and Batchfile creation"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:516
+#: sphinx/cmd/quickstart.py:525
 msgid "create makefile"
 msgstr "إنشاء Makefile"
 
-#: sphinx/cmd/quickstart.py:518
+#: sphinx/cmd/quickstart.py:527
 msgid "do not create makefile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:520
+#: sphinx/cmd/quickstart.py:529
 msgid "create batchfile"
 msgstr "إنشاء Batchfile ؟"
 
-#: sphinx/cmd/quickstart.py:523
+#: sphinx/cmd/quickstart.py:532
 msgid "do not create batchfile"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:526
+#: sphinx/cmd/quickstart.py:535
 msgid "use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:529
+#: sphinx/cmd/quickstart.py:538
 msgid "do not use make-mode for Makefile/make.bat"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:531 sphinx/ext/apidoc.py:385
+#: sphinx/cmd/quickstart.py:540 sphinx/ext/apidoc.py:404
 msgid "Project templating"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:534 sphinx/ext/apidoc.py:388
+#: sphinx/cmd/quickstart.py:543 sphinx/ext/apidoc.py:407
 msgid "template directory for template files"
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:537
+#: sphinx/cmd/quickstart.py:546
 msgid "define a template variable"
 msgstr "عرف متغير للقالب"
 
-#: sphinx/cmd/quickstart.py:570
+#: sphinx/cmd/quickstart.py:579
 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:584
+#: sphinx/cmd/quickstart.py:593
 msgid ""
 "Error: specified path is not a directory, or sphinx files already exist."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:586
+#: sphinx/cmd/quickstart.py:595
 msgid ""
 "sphinx-quickstart only generate into a empty directory. Please specify a new"
 " root path."
 msgstr ""
 
-#: sphinx/cmd/quickstart.py:601
+#: sphinx/cmd/quickstart.py:610
 #, python-format
 msgid "Invalid template variable: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:60
+#: sphinx/directives/code.py:61
 msgid "non-whitespace stripped by dedent"
 msgstr ""
 
-#: sphinx/directives/code.py:81
+#: sphinx/directives/code.py:82
 #, python-format
 msgid "Invalid caption: %s"
 msgstr ""
 
-#: sphinx/directives/code.py:126 sphinx/directives/code.py:276
-#: sphinx/directives/code.py:452
+#: sphinx/directives/code.py:127 sphinx/directives/code.py:277
+#: sphinx/directives/code.py:453
 #, python-format
 msgid "line number spec is out of range(1-%d): %r"
 msgstr ""
 
-#: sphinx/directives/code.py:205
+#: sphinx/directives/code.py:206
 #, python-format
 msgid "Cannot use both \"%s\" and \"%s\" options"
 msgstr ""
 
-#: sphinx/directives/code.py:219
+#: sphinx/directives/code.py:220
 #, python-format
 msgid "Include file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/directives/code.py:222
+#: sphinx/directives/code.py:223
 #, python-format
 msgid ""
 "Encoding %r used for reading included file %r seems to be wrong, try giving "
 "an :encoding: option"
 msgstr ""
 
-#: sphinx/directives/code.py:259
+#: sphinx/directives/code.py:260
 #, python-format
 msgid "Object named %r not found in include file %r"
 msgstr ""
 
-#: sphinx/directives/code.py:285
+#: sphinx/directives/code.py:286
 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\""
 msgstr ""
 
-#: sphinx/directives/code.py:290
+#: sphinx/directives/code.py:291
 #, python-format
 msgid "Line spec %r: no lines pulled from include file %r"
 msgstr ""
 
-#: sphinx/directives/other.py:108
+#: sphinx/directives/other.py:116
 #, python-format
 msgid "toctree glob pattern %r didn't match any documents"
 msgstr ""
 
-#: sphinx/directives/other.py:129 sphinx/environment/adapters/toctree.py:183
+#: sphinx/directives/other.py:142 sphinx/environment/adapters/toctree.py:323
 #, python-format
 msgid "toctree contains reference to excluded document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:132 sphinx/environment/adapters/toctree.py:187
+#: sphinx/directives/other.py:145 sphinx/environment/adapters/toctree.py:327
 #, python-format
 msgid "toctree contains reference to nonexisting document %r"
 msgstr ""
 
-#: sphinx/directives/other.py:142
+#: sphinx/directives/other.py:156
 #, python-format
 msgid "duplicated entry found in toctree: %s"
 msgstr ""
 
-#: sphinx/directives/other.py:174
+#: sphinx/directives/other.py:188
 msgid "Section author: "
 msgstr "مؤلف القسم:"
 
-#: sphinx/directives/other.py:176
+#: sphinx/directives/other.py:190
 msgid "Module author: "
 msgstr ""
 
-#: sphinx/directives/other.py:178
+#: sphinx/directives/other.py:192
 msgid "Code author: "
 msgstr "كاتب الكود:"
 
-#: sphinx/directives/other.py:180
+#: sphinx/directives/other.py:194
 msgid "Author: "
 msgstr "المؤلف"
 
-#: sphinx/directives/other.py:252
+#: sphinx/directives/other.py:266
 msgid ".. acks content is not a list"
 msgstr ""
 
-#: sphinx/directives/other.py:277
+#: sphinx/directives/other.py:291
 msgid ".. hlist content is not a list"
 msgstr ""
 
@@ -1873,549 +1876,549 @@ msgid ""
 " a relative path from source directory. Please update your document."
 msgstr ""
 
-#: sphinx/domains/__init__.py:394
+#: sphinx/domains/__init__.py:397
 #, python-format
 msgid "%s %s"
 msgstr ""
 
-#: sphinx/domains/c.py:2036 sphinx/domains/c.py:3308
+#: sphinx/domains/c.py:2043 sphinx/domains/c.py:3318
 #, python-format
 msgid ""
 "Duplicate C declaration, also defined at %s:%s.\n"
 "Declaration is '.. c:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/c.py:3247
+#: sphinx/domains/c.py:3257
 #, python-format
 msgid "%s (C %s)"
 msgstr ""
 
-#: sphinx/domains/c.py:3346 sphinx/domains/cpp.py:7453
-#: sphinx/domains/python.py:674 sphinx/ext/napoleon/docstring.py:755
+#: sphinx/domains/c.py:3356 sphinx/domains/cpp.py:7496
+#: sphinx/domains/python.py:682 sphinx/ext/napoleon/docstring.py:760
 msgid "Parameters"
 msgstr ""
 
-#: sphinx/domains/c.py:3349 sphinx/domains/cpp.py:7459
+#: sphinx/domains/c.py:3359 sphinx/domains/cpp.py:7502
 msgid "Return values"
 msgstr ""
 
-#: sphinx/domains/c.py:3352 sphinx/domains/cpp.py:7462
-#: sphinx/domains/javascript.py:250 sphinx/domains/python.py:686
+#: sphinx/domains/c.py:3362 sphinx/domains/cpp.py:7505
+#: sphinx/domains/javascript.py:259 sphinx/domains/python.py:694
 msgid "Returns"
 msgstr ""
 
-#: sphinx/domains/c.py:3354 sphinx/domains/javascript.py:252
-#: sphinx/domains/python.py:688
+#: sphinx/domains/c.py:3364 sphinx/domains/javascript.py:261
+#: sphinx/domains/python.py:696
 msgid "Return type"
 msgstr ""
 
-#: sphinx/domains/c.py:3720 sphinx/domains/cpp.py:7866
+#: sphinx/domains/c.py:3730 sphinx/domains/cpp.py:7909
 msgid "member"
 msgstr ""
 
-#: sphinx/domains/c.py:3721
+#: sphinx/domains/c.py:3731
 msgid "variable"
 msgstr "متغير"
 
-#: sphinx/domains/c.py:3722 sphinx/domains/cpp.py:7865
-#: sphinx/domains/javascript.py:352 sphinx/domains/python.py:1442
+#: sphinx/domains/c.py:3732 sphinx/domains/cpp.py:7908
+#: sphinx/domains/javascript.py:365 sphinx/domains/python.py:1454
 msgid "function"
 msgstr ""
 
-#: sphinx/domains/c.py:3723
+#: sphinx/domains/c.py:3733
 msgid "macro"
 msgstr ""
 
-#: sphinx/domains/c.py:3724
+#: sphinx/domains/c.py:3734
 msgid "struct"
 msgstr ""
 
-#: sphinx/domains/c.py:3725 sphinx/domains/cpp.py:7864
+#: sphinx/domains/c.py:3735 sphinx/domains/cpp.py:7907
 msgid "union"
 msgstr ""
 
-#: sphinx/domains/c.py:3726 sphinx/domains/cpp.py:7869
+#: sphinx/domains/c.py:3736 sphinx/domains/cpp.py:7912
 msgid "enum"
 msgstr ""
 
-#: sphinx/domains/c.py:3727 sphinx/domains/cpp.py:7870
+#: sphinx/domains/c.py:3737 sphinx/domains/cpp.py:7913
 msgid "enumerator"
 msgstr ""
 
-#: sphinx/domains/c.py:3728 sphinx/domains/cpp.py:7867
+#: sphinx/domains/c.py:3738 sphinx/domains/cpp.py:7910
 msgid "type"
 msgstr "نوع"
 
-#: sphinx/domains/c.py:3730 sphinx/domains/cpp.py:7872
+#: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7915
 msgid "function parameter"
 msgstr ""
 
-#: sphinx/domains/changeset.py:22
+#: sphinx/domains/changeset.py:23
 #, python-format
 msgid "New in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:23
+#: sphinx/domains/changeset.py:24
 #, python-format
 msgid "Changed in version %s"
 msgstr ""
 
-#: sphinx/domains/changeset.py:24
+#: sphinx/domains/changeset.py:25
 #, python-format
 msgid "Deprecated since version %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:69
+#: sphinx/domains/citation.py:70
 #, python-format
 msgid "duplicate citation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/citation.py:80
+#: sphinx/domains/citation.py:81
 #, python-format
 msgid "Citation [%s] is not referenced."
 msgstr ""
 
-#: sphinx/domains/cpp.py:4918 sphinx/domains/cpp.py:7408
+#: sphinx/domains/cpp.py:4929 sphinx/domains/cpp.py:7423
 #, python-format
 msgid ""
 "Duplicate C++ declaration, also defined at %s:%s.\n"
 "Declaration is '.. cpp:%s:: %s'."
 msgstr ""
 
-#: sphinx/domains/cpp.py:7206
+#: sphinx/domains/cpp.py:7218
 msgid "Template Parameters"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7325
+#: sphinx/domains/cpp.py:7340
 #, python-format
 msgid "%s (C++ %s)"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7456 sphinx/domains/javascript.py:247
+#: sphinx/domains/cpp.py:7499 sphinx/domains/javascript.py:256
 msgid "Throws"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7863 sphinx/domains/javascript.py:354
-#: sphinx/domains/python.py:1444
+#: sphinx/domains/cpp.py:7906 sphinx/domains/javascript.py:367
+#: sphinx/domains/python.py:1456
 msgid "class"
 msgstr "كائن"
 
-#: sphinx/domains/cpp.py:7868
+#: sphinx/domains/cpp.py:7911
 msgid "concept"
 msgstr ""
 
-#: sphinx/domains/cpp.py:7873
+#: sphinx/domains/cpp.py:7916
 msgid "template parameter"
 msgstr ""
 
-#: sphinx/domains/javascript.py:154
+#: sphinx/domains/javascript.py:164
 #, python-format
 msgid "%s() (built-in function)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:155 sphinx/domains/python.py:1113
+#: sphinx/domains/javascript.py:165 sphinx/domains/python.py:1121
 #, python-format
 msgid "%s() (%s method)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:157
+#: sphinx/domains/javascript.py:167
 #, python-format
 msgid "%s() (class)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:159
+#: sphinx/domains/javascript.py:169
 #, python-format
 msgid "%s (global variable or constant)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:161 sphinx/domains/python.py:1198
+#: sphinx/domains/javascript.py:171 sphinx/domains/python.py:1206
 #, python-format
 msgid "%s (%s attribute)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:244
+#: sphinx/domains/javascript.py:253
 msgid "Arguments"
 msgstr ""
 
-#: sphinx/domains/javascript.py:319
+#: sphinx/domains/javascript.py:329
 #, python-format
 msgid "%s (module)"
 msgstr ""
 
-#: sphinx/domains/javascript.py:353 sphinx/domains/python.py:1446
+#: sphinx/domains/javascript.py:366 sphinx/domains/python.py:1458
 msgid "method"
 msgstr ""
 
-#: sphinx/domains/javascript.py:355 sphinx/domains/python.py:1443
+#: sphinx/domains/javascript.py:368 sphinx/domains/python.py:1455
 msgid "data"
 msgstr ""
 
-#: sphinx/domains/javascript.py:356 sphinx/domains/python.py:1449
+#: sphinx/domains/javascript.py:369 sphinx/domains/python.py:1461
 msgid "attribute"
 msgstr ""
 
-#: sphinx/domains/javascript.py:357 sphinx/domains/python.py:1451
+#: sphinx/domains/javascript.py:370 sphinx/domains/python.py:1463
 msgid "module"
 msgstr ""
 
-#: sphinx/domains/javascript.py:388
+#: sphinx/domains/javascript.py:401
 #, python-format
 msgid "duplicate %s description of %s, other %s in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:59
+#: sphinx/domains/math.py:61
 #, python-format
 msgid "duplicate label of equation %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/math.py:114 sphinx/writers/latex.py:2238
+#: sphinx/domains/math.py:116 sphinx/writers/latex.py:2252
 #, python-format
 msgid "Invalid math_eqref_format: %r"
 msgstr ""
 
-#: sphinx/domains/python.py:679
+#: sphinx/domains/python.py:687
 msgid "Variables"
 msgstr "متغيرات"
 
-#: sphinx/domains/python.py:683
+#: sphinx/domains/python.py:691
 msgid "Raises"
 msgstr ""
 
-#: sphinx/domains/python.py:967 sphinx/domains/python.py:1104
+#: sphinx/domains/python.py:975 sphinx/domains/python.py:1112
 #, python-format
 msgid "%s() (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:1027 sphinx/domains/python.py:1194
-#: sphinx/domains/python.py:1245
+#: sphinx/domains/python.py:1035 sphinx/domains/python.py:1202
+#: sphinx/domains/python.py:1253
 #, python-format
 msgid "%s (in module %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:1029
+#: sphinx/domains/python.py:1037
 #, python-format
 msgid "%s (built-in variable)"
 msgstr ""
 
-#: sphinx/domains/python.py:1054
+#: sphinx/domains/python.py:1062
 #, python-format
 msgid "%s (built-in class)"
 msgstr ""
 
-#: sphinx/domains/python.py:1055
+#: sphinx/domains/python.py:1063
 #, python-format
 msgid "%s (class in %s)"
 msgstr ""
 
-#: sphinx/domains/python.py:1109
+#: sphinx/domains/python.py:1117
 #, python-format
 msgid "%s() (%s class method)"
 msgstr ""
 
-#: sphinx/domains/python.py:1111
+#: sphinx/domains/python.py:1119
 #, python-format
 msgid "%s() (%s static method)"
 msgstr ""
 
-#: sphinx/domains/python.py:1249
+#: sphinx/domains/python.py:1257
 #, python-format
 msgid "%s (%s property)"
 msgstr ""
 
-#: sphinx/domains/python.py:1371
+#: sphinx/domains/python.py:1383
 msgid "Python Module Index"
 msgstr ""
 
-#: sphinx/domains/python.py:1372
+#: sphinx/domains/python.py:1384
 msgid "modules"
 msgstr ""
 
-#: sphinx/domains/python.py:1421
+#: sphinx/domains/python.py:1433
 msgid "Deprecated"
 msgstr ""
 
-#: sphinx/domains/python.py:1445
+#: sphinx/domains/python.py:1457
 msgid "exception"
 msgstr ""
 
-#: sphinx/domains/python.py:1447
+#: sphinx/domains/python.py:1459
 msgid "class method"
 msgstr ""
 
-#: sphinx/domains/python.py:1448
+#: sphinx/domains/python.py:1460
 msgid "static method"
 msgstr ""
 
-#: sphinx/domains/python.py:1450
+#: sphinx/domains/python.py:1462
 msgid "property"
 msgstr ""
 
-#: sphinx/domains/python.py:1508
+#: sphinx/domains/python.py:1520
 #, python-format
 msgid ""
-"duplicate object description of %s, other instance in %s, use :noindex: for "
-"one of them"
+"duplicate object description of %s, other instance in %s, use :no-index: for"
+" one of them"
 msgstr ""
 
-#: sphinx/domains/python.py:1628
+#: sphinx/domains/python.py:1640
 #, python-format
 msgid "more than one target found for cross-reference %r: %s"
 msgstr ""
 
-#: sphinx/domains/python.py:1689
+#: sphinx/domains/python.py:1701
 msgid " (deprecated)"
 msgstr ""
 
-#: sphinx/domains/rst.py:116 sphinx/domains/rst.py:172
+#: sphinx/domains/rst.py:125 sphinx/domains/rst.py:181
 #, python-format
 msgid "%s (directive)"
 msgstr ""
 
-#: sphinx/domains/rst.py:173 sphinx/domains/rst.py:177
+#: sphinx/domains/rst.py:182 sphinx/domains/rst.py:186
 #, python-format
 msgid ":%s: (directive option)"
 msgstr ""
 
-#: sphinx/domains/rst.py:200
+#: sphinx/domains/rst.py:209
 #, python-format
 msgid "%s (role)"
 msgstr ""
 
-#: sphinx/domains/rst.py:209
+#: sphinx/domains/rst.py:218
 msgid "directive"
 msgstr ""
 
-#: sphinx/domains/rst.py:210
+#: sphinx/domains/rst.py:219
 msgid "directive-option"
 msgstr ""
 
-#: sphinx/domains/rst.py:211
+#: sphinx/domains/rst.py:220
 msgid "role"
 msgstr "متغير بيئة العمل"
 
-#: sphinx/domains/rst.py:233
+#: sphinx/domains/rst.py:242
 #, python-format
 msgid "duplicate description of %s %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:77 sphinx/domains/std.py:94
+#: sphinx/domains/std.py:79 sphinx/domains/std.py:96
 #, python-format
 msgid "environment variable; %s"
 msgstr ""
 
-#: sphinx/domains/std.py:153
+#: sphinx/domains/std.py:155
 #, python-format
 msgid ""
 "Malformed option description %r, should look like \"opt\", \"-opt args\", \""
 "--opt args\", \"/opt args\" or \"+opt args\""
 msgstr ""
 
-#: sphinx/domains/std.py:224
+#: sphinx/domains/std.py:226
 #, python-format
 msgid "%s command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:226
+#: sphinx/domains/std.py:228
 msgid "command line option"
 msgstr ""
 
-#: sphinx/domains/std.py:344
+#: sphinx/domains/std.py:346
 msgid "glossary term must be preceded by empty line"
 msgstr ""
 
-#: sphinx/domains/std.py:352
+#: sphinx/domains/std.py:354
 msgid "glossary terms must not be separated by empty lines"
 msgstr ""
 
-#: sphinx/domains/std.py:358 sphinx/domains/std.py:371
+#: sphinx/domains/std.py:360 sphinx/domains/std.py:373
 msgid "glossary seems to be misformatted, check indentation"
 msgstr ""
 
-#: sphinx/domains/std.py:512
+#: sphinx/domains/std.py:516
 msgid "glossary term"
 msgstr ""
 
-#: sphinx/domains/std.py:513
+#: sphinx/domains/std.py:517
 msgid "grammar token"
 msgstr ""
 
-#: sphinx/domains/std.py:514
+#: sphinx/domains/std.py:518
 msgid "reference label"
 msgstr ""
 
-#: sphinx/domains/std.py:516
+#: sphinx/domains/std.py:520
 msgid "environment variable"
 msgstr ""
 
-#: sphinx/domains/std.py:517
+#: sphinx/domains/std.py:521
 msgid "program option"
 msgstr ""
 
-#: sphinx/domains/std.py:518
+#: sphinx/domains/std.py:522
 msgid "document"
 msgstr ""
 
-#: sphinx/domains/std.py:554 sphinx/domains/std.py:566
+#: sphinx/domains/std.py:558 sphinx/domains/std.py:570
 msgid "Module Index"
 msgstr ""
 
-#: sphinx/domains/std.py:555 sphinx/domains/std.py:567
+#: sphinx/domains/std.py:559 sphinx/domains/std.py:571
 #: sphinx/themes/basic/defindex.html:25
 msgid "Search Page"
 msgstr "صفحة البحث"
 
-#: sphinx/domains/std.py:610 sphinx/domains/std.py:716
-#: sphinx/ext/autosectionlabel.py:49
+#: sphinx/domains/std.py:614 sphinx/domains/std.py:720
+#: sphinx/ext/autosectionlabel.py:52
 #, python-format
 msgid "duplicate label %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:629
+#: sphinx/domains/std.py:633
 #, python-format
 msgid "duplicate %s description of %s, other instance in %s"
 msgstr ""
 
-#: sphinx/domains/std.py:833
+#: sphinx/domains/std.py:839
 msgid "numfig is disabled. :numref: is ignored."
 msgstr ""
 
-#: sphinx/domains/std.py:841
+#: sphinx/domains/std.py:847
 #, python-format
 msgid "Failed to create a cross reference. Any number is not assigned: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:853
+#: sphinx/domains/std.py:859
 #, python-format
 msgid "the link has no caption: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:867
+#: sphinx/domains/std.py:873
 #, python-format
 msgid "invalid numfig_format: %s (%r)"
 msgstr ""
 
-#: sphinx/domains/std.py:870
+#: sphinx/domains/std.py:876
 #, python-format
 msgid "invalid numfig_format: %s"
 msgstr ""
 
-#: sphinx/domains/std.py:1100
+#: sphinx/domains/std.py:1106
 #, python-format
 msgid "undefined label: %r"
 msgstr ""
 
-#: sphinx/domains/std.py:1102
+#: sphinx/domains/std.py:1108
 #, python-format
 msgid "Failed to create a cross reference. A title or caption not found: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:67
+#: sphinx/environment/__init__.py:71
 msgid "new config"
 msgstr ""
 
-#: sphinx/environment/__init__.py:68
+#: sphinx/environment/__init__.py:72
 msgid "config changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:69
+#: sphinx/environment/__init__.py:73
 msgid "extensions changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:271
+#: sphinx/environment/__init__.py:276
 msgid "build environment version not current"
 msgstr ""
 
-#: sphinx/environment/__init__.py:273
+#: sphinx/environment/__init__.py:278
 msgid "source directory has changed"
 msgstr ""
 
-#: sphinx/environment/__init__.py:352
+#: sphinx/environment/__init__.py:357
 msgid ""
 "This environment is incompatible with the selected builder, please choose "
 "another doctree directory."
 msgstr ""
 
-#: sphinx/environment/__init__.py:451
+#: sphinx/environment/__init__.py:456
 #, python-format
 msgid "Failed to scan documents in %s: %r"
 msgstr ""
 
-#: sphinx/environment/__init__.py:582
+#: sphinx/environment/__init__.py:593
 #, python-format
 msgid "Domain %r is not registered"
 msgstr ""
 
-#: sphinx/environment/__init__.py:684
-msgid "self referenced toctree found. Ignored."
+#: sphinx/environment/__init__.py:727
+msgid "document isn't included in any toctree"
 msgstr ""
 
-#: sphinx/environment/__init__.py:726
-msgid "document isn't included in any toctree"
+#: sphinx/environment/__init__.py:764
+msgid "self referenced toctree found. Ignored."
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:66
+#: sphinx/environment/adapters/indexentries.py:69
 #, python-format
 msgid "see %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:70
+#: sphinx/environment/adapters/indexentries.py:73
 #, python-format
 msgid "see also %s"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:73
+#: sphinx/environment/adapters/indexentries.py:76
 #, python-format
 msgid "unknown index entry type %r"
 msgstr ""
 
-#: sphinx/environment/adapters/indexentries.py:184
+#: sphinx/environment/adapters/indexentries.py:187
 #: sphinx/templates/latex/sphinxmessages.sty_t:11
 msgid "Symbols"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:156
+#: sphinx/environment/adapters/toctree.py:296
 #, python-format
 msgid "circular toctree references detected, ignoring: %s <- %s"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:177
+#: sphinx/environment/adapters/toctree.py:316
 #, python-format
 msgid ""
 "toctree contains reference to document %r that doesn't have a title: no link"
 " will be generated"
 msgstr ""
 
-#: sphinx/environment/adapters/toctree.py:185
+#: sphinx/environment/adapters/toctree.py:325
 #, python-format
 msgid "toctree contains reference to non-included document %r"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:82
+#: sphinx/environment/collectors/asset.py:88
 #, python-format
 msgid "image file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:101
+#: sphinx/environment/collectors/asset.py:107
 #, python-format
 msgid "image file %s not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/asset.py:127
+#: sphinx/environment/collectors/asset.py:133
 #, python-format
 msgid "download file not readable: %s"
 msgstr ""
 
-#: sphinx/environment/collectors/toctree.py:219
+#: sphinx/environment/collectors/toctree.py:224
 #, python-format
 msgid "%s is already assigned section numbers (nested numbered toctree?)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:79
+#: sphinx/ext/apidoc.py:86
 #, python-format
 msgid "Would create file %s."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:301
+#: sphinx/ext/apidoc.py:320
 msgid ""
 "\n"
 "Look recursively in <MODULE_PATH> for Python modules and packages and create\n"
@@ -2427,231 +2430,226 @@ msgid ""
 "Note: By default this script will not overwrite already created files."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:314
+#: sphinx/ext/apidoc.py:333
 msgid "path to module to document"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:316
+#: sphinx/ext/apidoc.py:335
 msgid ""
 "fnmatch-style file and/or directory patterns to exclude from generation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:321
+#: sphinx/ext/apidoc.py:340
 msgid "directory to place all output"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:326
+#: sphinx/ext/apidoc.py:345
 msgid "maximum depth of submodules to show in the TOC (default: 4)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:329
+#: sphinx/ext/apidoc.py:348
 msgid "overwrite existing files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:332
+#: sphinx/ext/apidoc.py:351
 msgid ""
 "follow symbolic links. Powerful when combined with "
 "collective.recipe.omelette."
 msgstr ""
 
-#: sphinx/ext/apidoc.py:335
+#: sphinx/ext/apidoc.py:354
 msgid "run the script without creating files"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:338
+#: sphinx/ext/apidoc.py:357
 msgid "put documentation for each module on its own page"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:341
+#: sphinx/ext/apidoc.py:360
 msgid "include \"_private\" modules"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:343
+#: sphinx/ext/apidoc.py:362
 msgid "filename of table of contents (default: modules)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:345
+#: sphinx/ext/apidoc.py:364
 msgid "don't create a table of contents file"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:348
+#: sphinx/ext/apidoc.py:367
 msgid ""
 "don't create headings for the module/package packages (e.g. when the "
 "docstrings already contain them)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:353
+#: sphinx/ext/apidoc.py:372
 msgid "put module documentation before submodule documentation"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:357
+#: sphinx/ext/apidoc.py:376
 msgid ""
 "interpret module paths according to PEP-0420 implicit namespaces "
 "specification"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:361
+#: sphinx/ext/apidoc.py:380
 msgid "file suffix (default: rst)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:363
+#: sphinx/ext/apidoc.py:382
 msgid "generate a full project with sphinx-quickstart"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:366
+#: sphinx/ext/apidoc.py:385
 msgid "append module_path to sys.path, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:368
+#: sphinx/ext/apidoc.py:387
 msgid "project name (default: root module name)"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:370
+#: sphinx/ext/apidoc.py:389
 msgid "project author(s), used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:372
+#: sphinx/ext/apidoc.py:391
 msgid "project version, used when --full is given"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:374
+#: sphinx/ext/apidoc.py:393
 msgid "project release, used when --full is given, defaults to --doc-version"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:377
+#: sphinx/ext/apidoc.py:396
 msgid "extension options"
 msgstr ""
 
-#: sphinx/ext/apidoc.py:410
+#: sphinx/ext/apidoc.py:429
 #, python-format
 msgid "%s is not a directory."
 msgstr "%s ليس مجلد."
 
-#: sphinx/ext/autosectionlabel.py:45
+#: sphinx/ext/autosectionlabel.py:48
 #, python-format
 msgid "section \"%s\" gets labeled as \"%s\""
 msgstr ""
 
-#: sphinx/ext/coverage.py:40
+#: sphinx/ext/coverage.py:45
 #, python-format
 msgid "invalid regex %r in %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:49
+#: sphinx/ext/coverage.py:73
 #, python-format
 msgid ""
 "Testing of coverage in the sources finished, look at the results in "
 "%(outdir)spython.txt."
 msgstr ""
 
-#: sphinx/ext/coverage.py:63
+#: sphinx/ext/coverage.py:87
 #, python-format
 msgid "invalid regex %r in coverage_c_regexes"
 msgstr ""
 
-#: sphinx/ext/coverage.py:124
+#: sphinx/ext/coverage.py:155
 #, python-format
 msgid "undocumented c api: %s [%s] in file %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:156
+#: sphinx/ext/coverage.py:187
 #, python-format
 msgid "module %s could not be imported: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:252
+#: sphinx/ext/coverage.py:334
 #, python-format
 msgid "undocumented python function: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:268
+#: sphinx/ext/coverage.py:350
 #, python-format
 msgid "undocumented python class: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/coverage.py:281
+#: sphinx/ext/coverage.py:363
 #, python-format
 msgid "undocumented python method: %s :: %s :: %s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:112
+#: sphinx/ext/doctest.py:115
 #, python-format
 msgid "missing '+' or '-' in '%s' option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:117
+#: sphinx/ext/doctest.py:120
 #, python-format
 msgid "'%s' is not a valid option."
 msgstr ""
 
-#: sphinx/ext/doctest.py:131
+#: sphinx/ext/doctest.py:134
 #, python-format
 msgid "'%s' is not a valid pyversion option"
 msgstr ""
 
-#: sphinx/ext/doctest.py:217
+#: sphinx/ext/doctest.py:220
 msgid "invalid TestCode type"
 msgstr ""
 
-#: sphinx/ext/doctest.py:275
+#: sphinx/ext/doctest.py:280
 #, python-format
 msgid ""
 "Testing of doctests in the sources finished, look at the results in "
 "%(outdir)s/output.txt."
 msgstr ""
 
-#: sphinx/ext/doctest.py:425
+#: sphinx/ext/doctest.py:431
 #, python-format
 msgid "no code/output in %s block at %s:%s"
 msgstr ""
 
-#: sphinx/ext/doctest.py:511
+#: sphinx/ext/doctest.py:521
 #, python-format
 msgid "ignoring invalid doctest code: %r"
 msgstr ""
 
-#: sphinx/ext/duration.py:74
+#: sphinx/ext/duration.py:76
 msgid ""
 "====================== slowest reading durations ======================="
 msgstr ""
 
-#: sphinx/ext/extlinks.py:77
+#: sphinx/ext/extlinks.py:82
 #, python-format
 msgid ""
 "hardcoded link %r could be replaced by an extlink (try using %r instead)"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:128
+#: sphinx/ext/graphviz.py:133
 msgid "Graphviz directive cannot have both content and a filename argument"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:138
+#: sphinx/ext/graphviz.py:143
 #, python-format
 msgid "External Graphviz file %r not found or reading it failed"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:145
+#: sphinx/ext/graphviz.py:150
 msgid "Ignoring \"graphviz\" directive without content."
 msgstr ""
 
-#: sphinx/ext/graphviz.py:254
+#: sphinx/ext/graphviz.py:259
 #, python-format
-msgid ""
-"dot did not produce an output file:\n"
-"[stderr]\n"
-"%r\n"
-"[stdout]\n"
-"%r"
+msgid "graphviz_dot executable path must be set! %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:258
+#: sphinx/ext/graphviz.py:294
 #, python-format
 msgid ""
 "dot command %r cannot be run (needed for graphviz output), check the "
 "graphviz_dot setting"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:265
+#: sphinx/ext/graphviz.py:301
 #, python-format
 msgid ""
 "dot exited with error:\n"
@@ -2661,27 +2659,37 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:276
+#: sphinx/ext/graphviz.py:304
+#, python-format
+msgid ""
+"dot did not produce an output file:\n"
+"[stderr]\n"
+"%r\n"
+"[stdout]\n"
+"%r"
+msgstr ""
+
+#: sphinx/ext/graphviz.py:320
 #, python-format
 msgid "graphviz_output_format must be one of 'png', 'svg', but is %r"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:280 sphinx/ext/graphviz.py:333
-#: sphinx/ext/graphviz.py:370
+#: sphinx/ext/graphviz.py:324 sphinx/ext/graphviz.py:377
+#: sphinx/ext/graphviz.py:414
 #, python-format
 msgid "dot code %r: %s"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:383 sphinx/ext/graphviz.py:391
+#: sphinx/ext/graphviz.py:427 sphinx/ext/graphviz.py:435
 #, python-format
 msgid "[graph: %s]"
 msgstr ""
 
-#: sphinx/ext/graphviz.py:385 sphinx/ext/graphviz.py:393
+#: sphinx/ext/graphviz.py:429 sphinx/ext/graphviz.py:437
 msgid "[graph]"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:36
+#: sphinx/ext/imgconverter.py:38
 #, python-format
 msgid ""
 "Unable to run the image conversion command %r. 'sphinx.ext.imgconverter' requires ImageMagick by default. Ensure it is installed, or set the 'image_converter' option to a custom conversion command.\n"
@@ -2689,7 +2697,7 @@ msgid ""
 "Traceback: %s"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:45 sphinx/ext/imgconverter.py:69
+#: sphinx/ext/imgconverter.py:47 sphinx/ext/imgconverter.py:71
 #, python-format
 msgid ""
 "convert exited with error:\n"
@@ -2699,161 +2707,161 @@ msgid ""
 "%r"
 msgstr ""
 
-#: sphinx/ext/imgconverter.py:64
+#: sphinx/ext/imgconverter.py:66
 #, python-format
 msgid "convert command %r cannot be run, check the image_converter setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:150
+#: sphinx/ext/imgmath.py:157
 #, python-format
 msgid ""
 "LaTeX command %r cannot be run (needed for math display), check the "
 "imgmath_latex setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:164
+#: sphinx/ext/imgmath.py:172
 #, python-format
 msgid ""
 "%s command %r cannot be run (needed for math display), check the imgmath_%s "
 "setting"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:320
+#: sphinx/ext/imgmath.py:326
 #, python-format
 msgid "display latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:354
+#: sphinx/ext/imgmath.py:360
 #, python-format
 msgid "inline latex %r: %s"
 msgstr ""
 
-#: sphinx/ext/imgmath.py:361 sphinx/ext/mathjax.py:49
-msgid "Permalink to this equation"
-msgstr "رابط دائم لهذه المعادلة"
+#: sphinx/ext/imgmath.py:367 sphinx/ext/mathjax.py:52
+msgid "Link to this equation"
+msgstr ""
 
 #: sphinx/ext/intersphinx.py:194
 #, python-format
 msgid "intersphinx inventory has moved: %s -> %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:230
+#: sphinx/ext/intersphinx.py:229
 #, python-format
 msgid "loading intersphinx inventory from %s..."
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:244
+#: sphinx/ext/intersphinx.py:243
 msgid ""
 "encountered some issues with some of the inventories, but they had working "
 "alternatives:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:250
+#: sphinx/ext/intersphinx.py:249
 msgid "failed to reach any of the inventories with the following issues:"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:303
+#: sphinx/ext/intersphinx.py:302
 #, python-format
 msgid "(in %s v%s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:305
+#: sphinx/ext/intersphinx.py:304
 #, python-format
 msgid "(in %s)"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:537
+#: sphinx/ext/intersphinx.py:536
 #, python-format
 msgid "inventory for external cross-reference not found: %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:543
+#: sphinx/ext/intersphinx.py:542
 #, python-format
 msgid "role for external cross-reference not found: %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:627
+#: sphinx/ext/intersphinx.py:633
 #, python-format
 msgid "external %s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:652
+#: sphinx/ext/intersphinx.py:658
 #, python-format
 msgid "intersphinx identifier %r is not string. Ignored"
 msgstr ""
 
-#: sphinx/ext/intersphinx.py:674
+#: sphinx/ext/intersphinx.py:680
 #, python-format
 msgid "Failed to read intersphinx_mapping[%s], ignored: %r"
 msgstr ""
 
-#: sphinx/ext/linkcode.py:65 sphinx/ext/viewcode.py:180
+#: sphinx/ext/linkcode.py:68 sphinx/ext/viewcode.py:198
 msgid "[source]"
 msgstr "[المصدر]"
 
-#: sphinx/ext/todo.py:64
+#: sphinx/ext/todo.py:67
 msgid "Todo"
 msgstr ""
 
-#: sphinx/ext/todo.py:97
+#: sphinx/ext/todo.py:100
 #, python-format
 msgid "TODO entry found: %s"
 msgstr ""
 
-#: sphinx/ext/todo.py:155
+#: sphinx/ext/todo.py:158
 msgid "<<original entry>>"
 msgstr ""
 
-#: sphinx/ext/todo.py:157
+#: sphinx/ext/todo.py:160
 #, python-format
 msgid "(The <<original entry>> is located in %s, line %d.)"
 msgstr ""
 
-#: sphinx/ext/todo.py:167
+#: sphinx/ext/todo.py:170
 msgid "original entry"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:237
+#: sphinx/ext/viewcode.py:255
 msgid "highlighting module code... "
 msgstr ""
 
-#: sphinx/ext/viewcode.py:269
+#: sphinx/ext/viewcode.py:283
 msgid "[docs]"
 msgstr "[المستندات]"
 
-#: sphinx/ext/viewcode.py:283
+#: sphinx/ext/viewcode.py:303
 msgid "Module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:289
+#: sphinx/ext/viewcode.py:309
 #, python-format
 msgid "<h1>Source code for %s</h1>"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:315
+#: sphinx/ext/viewcode.py:335
 msgid "Overview: module code"
 msgstr ""
 
-#: sphinx/ext/viewcode.py:316
+#: sphinx/ext/viewcode.py:336
 msgid "<h1>All modules for which code is available</h1>"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:134
+#: sphinx/ext/autodoc/__init__.py:127
 #, python-format
 msgid "invalid value for member-order option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:142
+#: sphinx/ext/autodoc/__init__.py:135
 #, python-format
 msgid "invalid value for class-doc-from option: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:394
+#: sphinx/ext/autodoc/__init__.py:391
 #, python-format
 msgid "invalid signature for auto%s (%r)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:510
+#: sphinx/ext/autodoc/__init__.py:508
 #, python-format
 msgid "error while formatting arguments for %s: %s"
 msgstr ""
@@ -2883,102 +2891,102 @@ msgstr ""
 msgid "error while formatting signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:995
+#: sphinx/ext/autodoc/__init__.py:996
 msgid "\"::\" in automodule name doesn't make sense"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1002
+#: sphinx/ext/autodoc/__init__.py:1003
 #, python-format
 msgid "signature arguments or return annotation given for automodule %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1015
+#: sphinx/ext/autodoc/__init__.py:1016
 #, python-format
 msgid ""
 "__all__ should be a list of strings, not %r (in module %s) -- ignoring "
 "__all__"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1081
+#: sphinx/ext/autodoc/__init__.py:1082
 #, python-format
 msgid ""
 "missing attribute mentioned in :members: option: module %s, attribute %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1285 sphinx/ext/autodoc/__init__.py:1362
-#: sphinx/ext/autodoc/__init__.py:2750
+#: sphinx/ext/autodoc/__init__.py:1298 sphinx/ext/autodoc/__init__.py:1375
+#: sphinx/ext/autodoc/__init__.py:2768
 #, python-format
 msgid "Failed to get a function signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1571
+#: sphinx/ext/autodoc/__init__.py:1586
 #, python-format
 msgid "Failed to get a constructor signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1697
+#: sphinx/ext/autodoc/__init__.py:1713
 #, python-format
 msgid "Bases: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1711
+#: sphinx/ext/autodoc/__init__.py:1727
 #, python-format
 msgid "missing attribute %s in object %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1811 sphinx/ext/autodoc/__init__.py:1848
-#: sphinx/ext/autodoc/__init__.py:1931
+#: sphinx/ext/autodoc/__init__.py:1826 sphinx/ext/autodoc/__init__.py:1863
+#: sphinx/ext/autodoc/__init__.py:1946
 #, python-format
 msgid "alias of %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:1831
+#: sphinx/ext/autodoc/__init__.py:1846
 #, python-format
 msgid "alias of TypeVar(%s)"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2152 sphinx/ext/autodoc/__init__.py:2249
+#: sphinx/ext/autodoc/__init__.py:2167 sphinx/ext/autodoc/__init__.py:2264
 #, python-format
 msgid "Failed to get a method signature for %s: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/__init__.py:2377
+#: sphinx/ext/autodoc/__init__.py:2395
 #, python-format
 msgid "Invalid __slots__ found on %s. Ignored."
 msgstr ""
 
-#: sphinx/ext/autodoc/preserve_defaults.py:115
+#: sphinx/ext/autodoc/preserve_defaults.py:183
 #, python-format
 msgid "Failed to parse a default argument value for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:127
+#: sphinx/ext/autodoc/type_comment.py:131
 #, python-format
 msgid "Failed to update signature for %r: parameter not found: %s"
 msgstr ""
 
-#: sphinx/ext/autodoc/type_comment.py:130
+#: sphinx/ext/autodoc/type_comment.py:134
 #, python-format
 msgid "Failed to parse type_comment for %r: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:244
+#: sphinx/ext/autosummary/__init__.py:249
 #, python-format
 msgid "autosummary references excluded document %r. Ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:246
+#: sphinx/ext/autosummary/__init__.py:251
 #, python-format
 msgid ""
 "autosummary: stub file not found %r. Check your autosummary_generate "
 "setting."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:265
+#: sphinx/ext/autosummary/__init__.py:270
 msgid "A captioned autosummary requires :toctree: option. ignored."
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:318
+#: sphinx/ext/autosummary/__init__.py:323
 #, python-format
 msgid ""
 "autosummary: failed to import %s.\n"
@@ -2986,46 +2994,46 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:332
+#: sphinx/ext/autosummary/__init__.py:337
 #, python-format
 msgid "failed to parse name %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:337
+#: sphinx/ext/autosummary/__init__.py:342
 #, python-format
 msgid "failed to import object %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:792
+#: sphinx/ext/autosummary/__init__.py:798
 #, python-format
 msgid "autosummary_generate: file not found: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/__init__.py:800
+#: sphinx/ext/autosummary/__init__.py:806
 msgid ""
 "autosummary generats .rst files internally. But your source_suffix does not "
 "contain .rst. Skipped."
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:165
-#: sphinx/ext/autosummary/generate.py:238
+#: sphinx/ext/autosummary/generate.py:200
+#: sphinx/ext/autosummary/generate.py:358
 #, python-format
 msgid ""
 "autosummary: failed to determine %r to be documented, the following exception was raised:\n"
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:422
+#: sphinx/ext/autosummary/generate.py:470
 #, python-format
 msgid "[autosummary] generating autosummary for: %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:426
+#: sphinx/ext/autosummary/generate.py:474
 #, python-format
 msgid "[autosummary] writing to %s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:469
+#: sphinx/ext/autosummary/generate.py:517
 #, python-format
 msgid ""
 "[autosummary] failed to import %s.\n"
@@ -3033,7 +3041,7 @@ msgid ""
 "%s"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:642
+#: sphinx/ext/autosummary/generate.py:690
 msgid ""
 "\n"
 "Generate ReStructuredText using autosummary directives.\n"
@@ -3048,129 +3056,129 @@ msgid ""
 "  pydoc sphinx.ext.autosummary\n"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:659
+#: sphinx/ext/autosummary/generate.py:707
 msgid "source files to generate rST files for"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:663
+#: sphinx/ext/autosummary/generate.py:711
 msgid "directory to place all output in"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:666
+#: sphinx/ext/autosummary/generate.py:714
 #, python-format
 msgid "default suffix for files (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:670
+#: sphinx/ext/autosummary/generate.py:718
 #, python-format
 msgid "custom template directory (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:674
+#: sphinx/ext/autosummary/generate.py:722
 #, python-format
 msgid "document imported members (default: %(default)s)"
 msgstr ""
 
-#: sphinx/ext/autosummary/generate.py:678
+#: sphinx/ext/autosummary/generate.py:726
 #, python-format
 msgid ""
 "document exactly the members in module __all__ attribute. (default: "
 "%(default)s)"
 msgstr ""
 
-#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:722
+#: sphinx/ext/napoleon/__init__.py:336 sphinx/ext/napoleon/docstring.py:726
 msgid "Keyword Arguments"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:676
+#: sphinx/ext/napoleon/docstring.py:680
 msgid "Example"
 msgstr "مثال"
 
-#: sphinx/ext/napoleon/docstring.py:677
+#: sphinx/ext/napoleon/docstring.py:681
 msgid "Examples"
 msgstr "أمثلة"
 
-#: sphinx/ext/napoleon/docstring.py:737
+#: sphinx/ext/napoleon/docstring.py:742
 msgid "Notes"
 msgstr "ملاحظات"
 
-#: sphinx/ext/napoleon/docstring.py:746
+#: sphinx/ext/napoleon/docstring.py:751
 msgid "Other Parameters"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:782
+#: sphinx/ext/napoleon/docstring.py:787
 msgid "Receives"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:786
+#: sphinx/ext/napoleon/docstring.py:791
 msgid "References"
 msgstr "مراجع"
 
-#: sphinx/ext/napoleon/docstring.py:818
+#: sphinx/ext/napoleon/docstring.py:823
 msgid "Warns"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:822
+#: sphinx/ext/napoleon/docstring.py:827
 msgid "Yields"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:980
+#: sphinx/ext/napoleon/docstring.py:985
 #, python-format
 msgid "invalid value set (missing closing brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:987
+#: sphinx/ext/napoleon/docstring.py:992
 #, python-format
 msgid "invalid value set (missing opening brace): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:994
+#: sphinx/ext/napoleon/docstring.py:999
 #, python-format
 msgid "malformed string literal (missing closing quote): %s"
 msgstr ""
 
-#: sphinx/ext/napoleon/docstring.py:1001
+#: sphinx/ext/napoleon/docstring.py:1006
 #, python-format
 msgid "malformed string literal (missing opening quote): %s"
 msgstr ""
 
-#: sphinx/locale/__init__.py:215
+#: sphinx/locale/__init__.py:221
 msgid "Attention"
 msgstr "تنبيه"
 
-#: sphinx/locale/__init__.py:216
+#: sphinx/locale/__init__.py:222
 msgid "Caution"
 msgstr "احتياط"
 
-#: sphinx/locale/__init__.py:217
+#: sphinx/locale/__init__.py:223
 msgid "Danger"
 msgstr "خطر"
 
-#: sphinx/locale/__init__.py:218
+#: sphinx/locale/__init__.py:224
 msgid "Error"
 msgstr "خطأ"
 
-#: sphinx/locale/__init__.py:219
+#: sphinx/locale/__init__.py:225
 msgid "Hint"
 msgstr "تلميح"
 
-#: sphinx/locale/__init__.py:220
+#: sphinx/locale/__init__.py:226
 msgid "Important"
 msgstr "مهم"
 
-#: sphinx/locale/__init__.py:221
+#: sphinx/locale/__init__.py:227
 msgid "Note"
 msgstr "ملاحظة"
 
-#: sphinx/locale/__init__.py:222
+#: sphinx/locale/__init__.py:228
 msgid "See also"
 msgstr "شاهد أيضا"
 
-#: sphinx/locale/__init__.py:223
+#: sphinx/locale/__init__.py:229
 msgid "Tip"
 msgstr "نصيحة"
 
-#: sphinx/locale/__init__.py:224
+#: sphinx/locale/__init__.py:230
 msgid "Warning"
 msgstr "تحذير"
 
@@ -3352,12 +3360,12 @@ msgid "search"
 msgstr "بحث"
 
 #: sphinx/themes/basic/search.html:48
-#: sphinx/themes/basic/static/searchtools.js:105
+#: sphinx/themes/basic/static/searchtools.js:112
 msgid "Search Results"
 msgstr "نتائج البحث"
 
 #: sphinx/themes/basic/search.html:50
-#: sphinx/themes/basic/static/searchtools.js:107
+#: sphinx/themes/basic/static/searchtools.js:114
 msgid ""
 "Your search did not match any documents. Please make sure that all words are"
 " spelled correctly and that you've selected enough categories."
@@ -3399,24 +3407,24 @@ msgstr ""
 msgid "Other changes"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:111
+#: sphinx/themes/basic/static/searchtools.js:118
 msgid ""
 "Search finished, found ${resultCount} page(s) matching the search query."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:209
+#: sphinx/themes/basic/static/searchtools.js:217
 msgid "Searching"
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:225
+#: sphinx/themes/basic/static/searchtools.js:233
 msgid "Preparing search..."
 msgstr ""
 
-#: sphinx/themes/basic/static/searchtools.js:413
+#: sphinx/themes/basic/static/searchtools.js:421
 msgid ", in "
 msgstr ""
 
-#: sphinx/themes/basic/static/sphinx_highlight.js:107
+#: sphinx/themes/basic/static/sphinx_highlight.js:112
 msgid "Hide Search Matches"
 msgstr ""
 
@@ -3433,248 +3441,256 @@ msgstr ""
 msgid "Contents"
 msgstr "المحتوى"
 
-#: sphinx/transforms/__init__.py:217
+#: sphinx/transforms/__init__.py:126
+msgid "could not calculate translation progress!"
+msgstr ""
+
+#: sphinx/transforms/__init__.py:131
+msgid "no translated elements!"
+msgstr ""
+
+#: sphinx/transforms/__init__.py:238
 #, python-format
 msgid ""
 "4 column based index found. It might be a bug of extensions you use: %r"
 msgstr ""
 
-#: sphinx/transforms/__init__.py:256
+#: sphinx/transforms/__init__.py:277
 #, python-format
 msgid "Footnote [%s] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/__init__.py:262
+#: sphinx/transforms/__init__.py:283
 msgid "Footnote [#] is not referenced."
 msgstr ""
 
-#: sphinx/transforms/i18n.py:201 sphinx/transforms/i18n.py:268
+#: sphinx/transforms/i18n.py:205 sphinx/transforms/i18n.py:272
 msgid ""
 "inconsistent footnote references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:241
+#: sphinx/transforms/i18n.py:245
 msgid ""
 "inconsistent references in translated message. original: {0}, translated: "
 "{1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:283
+#: sphinx/transforms/i18n.py:287
 msgid ""
 "inconsistent citation references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/i18n.py:300
+#: sphinx/transforms/i18n.py:304
 msgid ""
 "inconsistent term references in translated message. original: {0}, "
 "translated: {1}"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:112
+#: sphinx/transforms/post_transforms/__init__.py:116
 msgid ""
 "Could not determine the fallback text for the cross-reference. Might be a "
 "bug."
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:154
+#: sphinx/transforms/post_transforms/__init__.py:158
 #, python-format
 msgid "more than one target found for 'any' cross-reference %r: could be %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:205
+#: sphinx/transforms/post_transforms/__init__.py:209
 #, python-format
 msgid "%s:%s reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/__init__.py:208
+#: sphinx/transforms/post_transforms/__init__.py:212
 #, python-format
 msgid "%r reference target not found: %s"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:77
+#: sphinx/transforms/post_transforms/images.py:80
 #, python-format
 msgid "Could not fetch remote image: %s [%d]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:105
+#: sphinx/transforms/post_transforms/images.py:108
 #, python-format
 msgid "Could not fetch remote image: %s [%s]"
 msgstr ""
 
-#: sphinx/transforms/post_transforms/images.py:123
+#: sphinx/transforms/post_transforms/images.py:126
 #, python-format
 msgid "Unknown image format: %s..."
 msgstr ""
 
-#: sphinx/util/__init__.py:191
+#: sphinx/util/__init__.py:167
 #, python-format
 msgid "undecodable source characters, replacing with \"?\": %r"
 msgstr ""
 
-#: sphinx/util/display.py:76
+#: sphinx/util/display.py:77
 msgid "skipped"
 msgstr ""
 
-#: sphinx/util/display.py:81
+#: sphinx/util/display.py:82
 msgid "failed"
 msgstr "فشل"
 
-#: sphinx/util/docfields.py:87
+#: sphinx/util/docfields.py:88
 #, python-format
 msgid ""
 "Problem in %s domain: field is supposed to use role '%s', but that role is "
 "not in the domain."
 msgstr ""
 
-#: sphinx/util/docutils.py:307
+#: sphinx/util/docutils.py:311
 #, python-format
 msgid "unknown directive or role name: %s:%s"
 msgstr ""
 
-#: sphinx/util/docutils.py:595
+#: sphinx/util/docutils.py:605
 #, python-format
 msgid "unknown node type: %r"
 msgstr ""
 
-#: sphinx/util/i18n.py:61
+#: sphinx/util/i18n.py:63
 #, python-format
 msgid "reading error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:68
+#: sphinx/util/i18n.py:70
 #, python-format
 msgid "writing error: %s, %s"
 msgstr ""
 
-#: sphinx/util/i18n.py:92
+#: sphinx/util/i18n.py:94
 #, python-format
-msgid "locale_dir %s does not exists"
+msgid "locale_dir %s does not exist"
 msgstr ""
 
-#: sphinx/util/i18n.py:183
+#: sphinx/util/i18n.py:185
 #, python-format
 msgid ""
 "Invalid date format. Quote the string by single quote if you want to output "
 "it directly: %s"
 msgstr ""
 
-#: sphinx/util/nodes.py:372
+#: sphinx/util/nodes.py:378
 #, python-format
 msgid ""
 "%r is deprecated for index entries (from entry %r). Use 'pair: %s' instead."
 msgstr ""
 
-#: sphinx/util/nodes.py:420
+#: sphinx/util/nodes.py:426
 #, python-format
 msgid "toctree contains ref to nonexisting file %r"
 msgstr ""
 
-#: sphinx/util/nodes.py:607
+#: sphinx/util/nodes.py:627
 #, python-format
 msgid "exception while evaluating only directive expression: %s"
 msgstr ""
 
-#: sphinx/util/rst.py:66
+#: sphinx/util/rst.py:70
 #, python-format
 msgid "default role %s not found"
 msgstr ""
 
-#: sphinx/writers/html5.py:98 sphinx/writers/html5.py:107
-msgid "Permalink to this definition"
+#: sphinx/writers/html5.py:100 sphinx/writers/html5.py:109
+msgid "Link to this definition"
 msgstr ""
 
-#: sphinx/writers/html5.py:395
+#: sphinx/writers/html5.py:397
 #, python-format
 msgid "numfig_format is not defined for %s"
 msgstr ""
 
-#: sphinx/writers/html5.py:405
+#: sphinx/writers/html5.py:407
 #, python-format
 msgid "Any IDs not assigned for %s node"
 msgstr ""
 
-#: sphinx/writers/html5.py:459
-msgid "Permalink to this term"
+#: sphinx/writers/html5.py:462
+msgid "Link to this term"
 msgstr ""
 
-#: sphinx/writers/html5.py:482 sphinx/writers/html5.py:487
-msgid "Permalink to this heading"
+#: sphinx/writers/html5.py:485 sphinx/writers/html5.py:490
+msgid "Link to this heading"
 msgstr ""
 
-#: sphinx/writers/html5.py:491
-msgid "Permalink to this table"
+#: sphinx/writers/html5.py:494
+msgid "Link to this table"
 msgstr ""
 
-#: sphinx/writers/html5.py:534
-msgid "Permalink to this code"
+#: sphinx/writers/html5.py:537
+msgid "Link to this code"
 msgstr ""
 
-#: sphinx/writers/html5.py:536
-msgid "Permalink to this image"
+#: sphinx/writers/html5.py:539
+msgid "Link to this image"
 msgstr ""
 
-#: sphinx/writers/html5.py:538
-msgid "Permalink to this toctree"
+#: sphinx/writers/html5.py:541
+msgid "Link to this toctree"
 msgstr ""
 
-#: sphinx/writers/html5.py:675
+#: sphinx/writers/html5.py:679
 msgid "Could not obtain image size. :scale: option is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:331
+#: sphinx/writers/latex.py:335
 #, python-format
 msgid "unknown %r toplevel_sectioning for class %r"
 msgstr ""
 
-#: sphinx/writers/latex.py:382
+#: sphinx/writers/latex.py:386
 msgid "too large :maxdepth:, ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:621
+#: sphinx/writers/latex.py:625
 msgid "document title is not a single Text node"
 msgstr ""
 
-#: sphinx/writers/latex.py:652 sphinx/writers/texinfo.py:620
+#: sphinx/writers/latex.py:656 sphinx/writers/texinfo.py:622
 msgid ""
 "encountered title node not in section, topic, table, admonition or sidebar"
 msgstr ""
 
-#: sphinx/writers/latex.py:954 sphinx/writers/manpage.py:254
-#: sphinx/writers/texinfo.py:635
+#: sphinx/writers/latex.py:959 sphinx/writers/manpage.py:258
+#: sphinx/writers/texinfo.py:637
 msgid "Footnotes"
 msgstr ""
 
-#: sphinx/writers/latex.py:1021
+#: sphinx/writers/latex.py:1028
 msgid ""
 "both tabularcolumns and :widths: option are given. :widths: is ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1370
+#: sphinx/writers/latex.py:1388
 #, python-format
 msgid "dimension unit %s is invalid. Ignored."
 msgstr ""
 
-#: sphinx/writers/latex.py:1708
+#: sphinx/writers/latex.py:1722
 #, python-format
 msgid "unknown index entry type %s found"
 msgstr ""
 
-#: sphinx/writers/manpage.py:302 sphinx/writers/text.py:912
+#: sphinx/writers/manpage.py:306 sphinx/writers/text.py:917
 #, python-format
 msgid "[image: %s]"
 msgstr ""
 
-#: sphinx/writers/manpage.py:303 sphinx/writers/text.py:913
+#: sphinx/writers/manpage.py:307 sphinx/writers/text.py:918
 msgid "[image]"
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1191
+#: sphinx/writers/texinfo.py:1193
 msgid "caption not inside a figure."
 msgstr ""
 
-#: sphinx/writers/texinfo.py:1278
+#: sphinx/writers/texinfo.py:1280
 #, python-format
 msgid "unimplemented node type: %r"
 msgstr ""