Добавление плагинов, изменение докуметаций "Основные команды", "Снятие Read Only с корневого раздела" и добавление новой документации "Команда ls"

2026-01-04 02:14:08 +03:00
parent 4b38dafdec
commit 8d1798adcb
9 changed files with 452 additions and 31 deletions
--- a/docs/docs/steam-deck/disable-read-only.md
+++ b/docs/docs/steam-deck/disable-read-only.md
@@ -1,39 +1,149 @@
---
-icon:
---
+## Для чего это нужно?
+??? info inline end "Важное замечание" 
+    В это делаете **на свой страх и риск**! 
+    
+    Valve не рекомендует изменять систему.

-## Для чего понадобаиться изменение корневого раздела системы?
+Изменение корневого раздела системы может понадобиться для:

-Вопрос хороший. 
+- Установка пакетов из репозитория ArchLinux:
+    - Java (для игр, включая Minecraft)
+    - Сетевые инструменты диагностики
+    - Пользовательские драйверы и библиотеки
+    - И другие
+- **Углубленная настройка** системы

-**Основная причина** - установка пакетов из репозитория **ArchLinux**. Это может быть **Java** для разных игр, считая **Minecraft**, сетевые инструменты для диагностики и так далее.
+!!! warning "Обратите внимание" 
+    После обновления SteamOS **все изменения будут утеряны**!

-Так же, можно произвести таким образом углубленную настройку системы.
+## Основные команды

-## Что нужно знать перед снятием защиты?
+```console title="Отключение защиты"
+# steamos-readonly disable
+```

-После обновления **SteamOS**, все изменения корневого раздела системы **пропадут**.
+```console title="Включение защиты"
+# steamos-readonly enable
+```
+## Пример 
+### Снятие защиты от изменения.

-**Не большая рекомендация**: Создайте **.sh** файл, где будут записаны все команды, которые производили в корневой системе. После обновления SteamOS, можно спокойно запустить с консоли данный файл и восстановить изменения.
+1. Откройте **Konsole**, если не открыт.
+2. Введите данную комманду:
+```console
+$ sudo steamos-readonly disable
+```
+3. Подтвердите личность, если запросит, введя пароль учетной записи **deck**.
+    - Если отсутствует, то просто нажите **Enter**.

-## Снятие защиты от изменения.
+**Готово** ✅

-1. Открываем **Konsole**.
-2. Вводим команду `sudo steamos-readonly disable` и нажмите **Enter**.
-3. Подтверждаем личность, введия пароль учетной записи `deck`.
-    - Вам придется создать пароль учетной записи `deck`, если еще не сделали.
-        - Введите для начала `passwd` да бы создать пароль.
-4. Выполните все что вам необходимо.
-    - Установить пакеты с помощью пакетного менеджера `pacman`.
-    - Изменение настроек системы в `/etc`.
-    - Запуск или остановка (отключение) системных служб `systemctl`.
-5. Как только закончите, **обязательно** пропишите команду `sudo steamos-readonly enable`.
-    - Конечно, если не восстановите защиту, ничего критичного не произойдет. Но старайтесь сохранять защиту от дурака.
-6. Повторно введите пароль пользователя, если система запросит.
+### Вернуть защиту

-![Steam Deck Console](/media/steamos-konsole-disable-readonly-system.png)
+!!! danger "Верните защиту как только закончите!"
+    Это защита от дурака. 

-## Важное замечание 
-Все что измените в системе **на свой страх и риск**. Об этом так же говорила компания **Valve**.
+    **Систему можно запросто сломать!**
+    

-**Лучший вариант** - создайте пополнительный каталог в домашнй диррективе, (К примеру `~/my-apps`) и загрузите библиотеки, приложения и прочее.
+1. Откройте **Konsole**, если не открыт.
+2. Введите данную комманду:
+```console
+$ sudo steamos-readonly enable
+```
+3. Подтвердите личность, если запросит, введя пароль учетной записи **deck**.
+    - Если отсутствует, то просто нажите **Enter**.
+
+**Готово** ✅
+
+## Пример с картинки
+
+![Steam Deck Console](/media/steamos-konsole-disable-readonly-system.png){ .gallery-item }
+
+
+## Альтернативное решение
+
+Как было упомянуто выше, такой вариант не рекомендованный и можно навредить систему.
+
+Расмотрим альтернативные варианты.
+
+### Flatpak
+
+[Оф. сайт Flatpak](https://flatpak.org)
+
+Это отличный вариант, который не сломает систему. 
+
+Основной и предустановленный репозиторий у Flatpak - FlatHub.
+
+Список приложений можно посмотреть на [данном сайте](https://flathub.org)
+
+Как устанавливать: 
+
+1. Через приложение **Discover**.
+2. С помощью **консоли**.
+
+Поиск:
+```console
+$ flatpak search <приложение>
+```
+
+Установка:
+```console
+$ flatpak install <ID Приложения>
+```
+
+|![Steam Deck Discover main page](/media/steamos-discover-main-page.png) | ![Steam Deck Konsole FlatPak](/media/steamos-konsole-flatpak-install-quake.png) |
+| - | - |
+| Рисунок 1 | Рисунок 2 | 
+
+### Appimage
+
+[Оф. Сайт Appimage](https://appimage.org/)
+
+Старый, проверенный временем, формат контейнерных приложений.
+
+Приложения упаковываються в единый файл **.appimage** со всеми зависимостями.
+
+Минусы:
+    
+- Нужно **находить** данный файл на сайте или репозиторий проекта разработчиков.
+- Хотя Appimage должен иметь все библиотеки для ПО, иногда разработчики таким пренебрегают.
+    - То есть, нужно докачивать зависимости.
+
+### Бинарные файлы, установщики и архивированное приложение tar.gz
+
+Для стабильной работы ПО - это лучший вариант, но можно надкнутьсяна необходимоссть предустанавки библиотек в систему.
+
+Для бинарных файлов проверьте, что все зависимости установлены.
+```console
+$ ldd <бинарный файл>
+```
+
+??? note "Установщики от GOG"
+    Однозначно сказать не могу, так как не проверял. Вероятнее всего, проблем не будет.
+
+??? note "Игры из торрентов"
+    Обещать отличной работы не могу. Если в описании пишут об установки необходимых зависимостей, проверьте для начала, устанавлены ли они:
+    ```console
+    $ pacman -Qs <название пакета>
+    ```
+    Проверку можно осуществлять без повышенных прав.
+
+
+Установка библиотек не в систему может решить вопрос с совместимостью, но можно попасть на зависомсть зависимости. Я проверял с Java.
+
+!!! warning "Внимание!"
+    Такой вариант не для новичков в Linux.
+
+1. Скачиваем библиотеку и распаковываем в любое доступное место
+    - Например: `~/my-apps/lib/`
+2. Открываем или создаем `~/.profile` в текстовом редакторе
+3. Добавляем в конец файла `set LD_LIBRARY_PATH=$LD_LIBRARY_PATH+"~/my-apps/lib/"`.
+4. Перезаходим.
+
+#### MultiMC или подобный
+
+С данным клиентом проще.
+
+1. При первом запуске MultiMC попросит выбрать Java по умолчанию из системы, которую он найдет. 
+2. Так как он ничего не сможет найти, выдаем путь до установленной Java вручную, нажав на кнопку **...** .