Merge branch 'main' into add-vagrant-version-1

Author: runningonsideprojects

.github/PULL_REQUEST_TEMPLATE.md

@@ -4,6 +4,8 @@ Please fill in the following checklist, removing items that do not apply.
 See also https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md
 -->
 
+#### If you are a new contributor to the project, do not use AI to generate pages. We will close any PR with a suspicion of AI usage.
+
 - [ ] The page(s) are in the correct platform directories: `common`, `linux`, `osx`, `windows`, `sunos`, `android`, etc.
 - [ ] The page description(s) have links to documentation or a homepage.
 - [ ] The page(s) follow the [content guidelines](/tldr-pages/tldr/blob/main/CONTRIBUTING.md#guidelines).

.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
         python-version: '3.12'
         cache: 'pip'
 
-    - uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5.0.0
+    - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
       with:
         node-version: 'lts/*'
         cache: 'npm'

contributing-guides/style-guide.md

@@ -456,7 +456,7 @@ Try to keep the following order:
 
 For example: `systemctl < input_file.txt status pipewire --user > output_file.txt`
 
-This is only a suggestion and should be disregarded when program functionality or readability dictates otherwise.
+This is only a suggestion and should be disregarded when program functionality or readability dictates otherwise. For example when a page is repeating arguments between commands try to to align them vertically.
 
 If the command does multiple things, try to keep the chronological order in which things happen.
 

contributing-guides/style-guide.ru.md

@@ -305,6 +305,8 @@ tldr --render путь/к/tldr_page.md
 
 Если для выполнения программы требуются права суперпользователя, и она не запрашивает пароль самостоятельно, добавьте в начало команды `sudo` (например, `sudo apt update`).
 
+Избегайте объяснения общих концепций UNIX, которые могут применяться к любой команде (т.е. относительные/абсолютные пути, glob-шаблоны/wildcards, экранирование спецсимволов, возвращаемые значения программ и т.д.).
+
 ### Стандартизированные термины
 
 Некоторые термины используются многократно на разных страницах и, следовательно, должны быть стандартизированы. К ним относятся:
@@ -383,6 +385,12 @@ tldr --render путь/к/tldr_page.md
 > Смотрите также: `date` для информации Unix, `uname` для системной информации и `umount` для размонтирования разделов.
 ```
 
+- Когда команда имеет подкоманды, на эти страницы можно сослаться следующей строкой. Обратите внимание, что указывается только имя подкоманды:
+
+```md
+> Некоторые подкоманды, такие как `commit`, `add`, `branch`, `switch`, `push` и др., имеют собственную документацию по использованию.
+```
+
 ## Описания примеров
 
 ### Мнемоники для коротких опций
@@ -420,11 +428,12 @@ tldr --render путь/к/tldr_page.md
 - Имя программы
 - Перенаправление ввода из файла
 - Все подкоманды
-- Опции/Флаги
 - Позиционные аргументы/Пакеты/Данные/...
+- Опции-флаги
+- Опции с аргументами
 - Перенаправление вывода в файл
 
-Например: `systemctl < входной_файл.txt status --user pipewire > выходной_файл.txt`
+Например: `systemctl < входной_файл.txt status pipewire --user > выходной_файл.txt`
 
 Это лишь рекомендация, и от нее следует отступать, если этого требует функциональность программы или читаемость.
 
@@ -482,8 +491,17 @@ tldr --render путь/к/tldr_page.md
 
 - Используйте `{{путь/к/источнику.ext}}` вместо `{{путь/к/источнику.tar[.gz|.bz2|.xz]}}`.
 
-> [!IMPORTANT]\
-> Не вставляйте плейсхолдеры внутрь других плейсхолдеров.
+#### Исключения
+
+- Не вставляйте плейсхолдеры внутрь других плейсхолдеров.
+
+- Не используйте плейсхолдеры, когда значение явно указано в описании команды. Например:
+
+```md
+- Обновлять вывод каждые 2 секунды:
+
+`free {{[-s|--seconds]}} 2`
+```
 
 ### Синтаксис для клавиш
 

contributing-guides/translation-templates/common-descriptions.md

@@ -31,7 +31,7 @@ Only the left-alignment of the header gets lost and has to be re-added again (`|
 | pt_BR | Mostra ajuda geral           | Mostra a versão                                      |
 | pt_PT |                              |                                                      |
 | ro    |                              |                                                      |
-| ru    |                              |                                                      |
+| ru    | Показать справку             | Показать версию                                      |
 | sh    |                              |                                                      |
 | sr    | Prikazuje opštu pomoć        | Proverava verziju                                    |
 | sv    |                              |                                                      |

pages.ar/common/newsboat.md

@@ -1,23 +1,23 @@
 # newsboat
 
 > هو قارئ خلاصة آر إس إس للطرفية أو الكونسول.
-> لمزيد من التفاصيل: <https://newsboat.org/>.
+> لمزيد من التفاصيل: <https://newsboat.org/releases/2.40/docs/newsboat.html#_first_steps>.
 
 - إستيراد روابط الخلاصات من ملف OPML:
 
-`newsboat -i {{my-feeds.xml}}`
+`newsboat {{[-i|--import-from-opml]}} {{my-feeds.xml}}`
 
 - إضافة روابط الخلاصات يدوياً:
 
 `echo {{http://example.com/path/to/feed}} >> "${HOME}/.newsboat/urls"`
 
 - إبدأ newsboat وقم بتحديث كل الخلاصات عند بدء التشغيل:
 
-`newsboat -r`
+`newsboat {{[-r|--refresh-on-start]}}`
 
 - نفذ أمر أو عدة أوامر مفصولة بمسافات بدون الحاجة إلي فتح newsboat:
 
-`newsboat -x {{reload print-unread ...}}`
+`newsboat {{[-x|--execute]}} {{reload print-unread ...}}`
 
 - انظر إختصارات لوحة المفاتيح (الإختصارت الأكثر شيوعاً مرئية في شريط الحالة):
 

pages.ar/common/pip.md

@@ -2,7 +2,7 @@
 
 > مدير الحزم الخاص بلغة بايثون.
 > بعض الأوامر الفرعية مثل `install` لديها توثيق خاص بها.
-> لمزيد من التفاصيل: <https://pip.pypa.io>.
+> لمزيد من التفاصيل: <https://pip.pypa.io/en/stable/cli/pip/>.
 
 - تثبيت حزمة (راجع `pip install` لمزيد من خيارات التثبيت):
 

pages.ar/common/tar.md

@@ -2,7 +2,7 @@
 
 > أداة أرشفة.
 > غالبًا ما تُستخدم مع طريقة ضغط، مثل `gzip` أو `bzip2`.
-> لمزيد من التفاصيل: <https://www.gnu.org/software/tar>.
+> لمزيد من التفاصيل: <https://www.gnu.org/software/tar/manual/tar.html>.
 
 - إنشاء أرشيف وكتابته إلى ملف:
 

pages.ar/common/yt-dlp.md

@@ -3,7 +3,7 @@
 > تّفرع من youtube-dl مع ميزات إضافية وتحسينات.
 > لتحميل الفيديوهات من Youtube ومواقع أخرى.
 > أنظر أيضاً: `ytfzf`.
-> لمزيد من التفاصيل: <https://github.com/yt-dlp/yt-dlp>.
+> لمزيد من التفاصيل: <https://github.com/yt-dlp/yt-dlp#usage-and-options>.
 
 - لتحميل فيديو أو قائمة تشغيل (مع الأعدادات الأفتراضية):
 

pages.ar/linux/hostnamectl.md

@@ -1,7 +1,7 @@
 # hostnamectl
 
 > الحصول على اسم المضيف أو تعيينه لجهاز الكمبيوتر.
-> لمزيد من التفاصيل: <https://manned.org/hostnamectl>.
+> لمزيد من التفاصيل: <https://www.freedesktop.org/software/systemd/man/hostnamectl.html>.
 
 - الحصول على اسم المضيف لجهاز الكمبيوتر: