diff --git a/docs/blog/2026/ai-and-me.md b/docs/blog/2026/ai-and-me.md index 1a6e8e5..5b63bb9 100644 --- a/docs/blog/2026/ai-and-me.md +++ b/docs/blog/2026/ai-and-me.md @@ -12,13 +12,15 @@ Я как раз хотел обновить свой сервер, докупив серверные плашки **DDR3** на али. Но цена меня растроила. -![Ali DDR3 card](/media/ali-ddr3-card.png) +![Ali DDR3 card](/media/ali-ddr3-card.png) +[Ссылка на товар](https://aliexpress.ru/item/1005007836124329.html?sku_id=5000000915963465&spm=a2g2w.productlist.search_results.0.727b2059jahshr) Несколько месяцев назад можно было купить по приемлемой цене. Теперь, никому не нужный модуль оперативной памяти стоит **9.5 тыс.** И это одна плашка **32ГБ**. Да и не только оперативная память мне нужна. Но и диски, которые нужны для замены моих пулов на моем самосборочном NAS. Мои пулы, как можно заметить, имеют тип **Sprite**. Если один из дисков превратиться в кирпич, то все данные я потеряю. А на этом NAS храняться фильмы и сервиалы для Jellyfin и Emby. -![Dns shop 1tb hdd](/media/dns-hdd-1tb.png) +![Dns shop 1tb hdd](/media/dns-hdd-1tb.png) +[Ссылка на список товартов DNS](https://www.dns-shop.ru/catalog/17a8914916404e77/zhestkie-diski-35/?f[1c]=d5) ## Что же тогда делать? diff --git a/docs/docs/linux/base-commands.md b/docs/docs/linux/base-commands.md index 21b543b..76bf8eb 100644 --- a/docs/docs/linux/base-commands.md +++ b/docs/docs/linux/base-commands.md @@ -2,13 +2,21 @@ Не большая шпаргалка для использования консоли Linux. -Не забывайте, что в большинствах дистрибутивов имеется комманда **man** для справки - `main <команда>`. +Список комманд будет пополняться. + +!!! info "Не забудьте" + Команда **man** выведет информацию о нужной вам команды. + ```command + $ man <команда> + ``` + + Если данной комманды нет, его можно установить пакетом из репоитория вашего дистрибутива. ## Уравление файлами и изменение активного каталога | Команда | Описание | Базовые аргументы | Пример | | ------- | -------- | ----------------- | ------ | -| ls | Просмотр элементов в каталоге | `-l` Вывод элементов подробным списком
`-a` Вывести скрытые элементы | `ls -la /` | +| [ls](../command-ls/) | Просмотр элементов в каталоге | `-l` Вывод элементов подробным списком
`-a` Вывести скрытые элементы | `ls -la /` | | mv | Перенести или перемновать каталог или файл | `-f` Принудительный перенос файлов (полезно для слияния каталогов) | `mv file.txt file.md` | | rm | Удаление каталога или файла | `-r` Рекурсивное удаление. Обязательно для каталогов. | `rm file.txt` | | cp | Копирование каталогов и файлов | `-r` Рекурсивное копирование. Обязательно для каталогов. | `cp file.txt /home/user/file.txt` | @@ -21,3 +29,4 @@ | Команда | Описание | Базовые аргументы | Пример | | ------- | -------- | ----------------- | ------ | | uname | Информация о ядре | `-a` выводит полную информацию о ядре | `uname -a` | +| lsblk | Просмотр подключенных носителей | | `lsblk /dev/sda` | diff --git a/docs/docs/linux/command-ls.md b/docs/docs/linux/command-ls.md new file mode 100644 index 0000000..e82aaf8 --- /dev/null +++ b/docs/docs/linux/command-ls.md @@ -0,0 +1,188 @@ +## Что делает данная команда? + +Команда **LS** (List Files and Directories) - выводит список директорий и файлов в активном каталоге. + +## Возможности + +- Вывод в подробном (списком) или в краце (строчном) формате +- Сортировка по алфавиту, дате, размеру и типу +- Отображение скытых файлов +- Рекрусивый обход каталогов + +## Базовые примеры + +### Команда без аргументов +Попробуем сначала вывести просто `ls` без аргументов. +```console title="Просто ls" +[cher@k-des test0]$ ls +dirrectory hello-world.txt +``` +Мы видим, что было выведено 2 элемента: **hello-world.txt** и **dirrectory**. + +### Вывод элементов вне активном каталоге +Так же, список можно вывести и не в активном каталоге. Пропишем любой путь. +```console title="Вывод содержимого вне активного каталога" +[cher@k-des test0]$ ls /srv +ftp http nfs4 +``` +В каталоге, **srv**, который находиться в корневом каталоге системы `/`, видим 3 элемента: **ftp**, **http** и **nfs4**. + +### Вывод всех элементов в каталоге +Теперь посмотрим, имеються ли скрытые файлы с помощью аргумента `-a`. +```console title="Вывести все что есть" +[cher@k-des test0]$ ls -a +. .. dirrectory hello-world.txt .hide-file.txt +``` +!!! info "Скрытые файлы и каталоги" + Скрытые файлы и каталоги обозначаються точкой перед названием. + + Пример: `.FileName.md` + +Мы видим, что в нашем каталоге имееться скрытый файл **.hide-file.txt**. Но вместе с этим мы получили еще 2 элемента: `.` и `..`. Что они обозначают? + +1. `.` обозначает наш активный каталог. +2. `..` ссылкаеться на предыдущий каталог. + +Прямо сейчас, они нам не нужны. Можно такие элементы не выводить, и аргумент `-A` нам поможет. +```console title="Вывести все скрытые файлы и каталоги" +[cher@k-des test0]$ ls -A +dirrectory hello-world.txt .hide-file.txt +``` + +### Вывод подробного, строчного списка +Теперь попробуем вывести списком. Для этого нам понадобиться аргумент `-l`. Попробуем ввести с дополнительным аргументом `-A`. +```console title="Подробный список" +[cher@k-des test0]$ ls -lA +итого 12 +drwxr-xr-x 2 cher cher 4096 янв 3 20:03 dirrectory +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt +-rw-r--r-- 1 cher cher 10 янв 3 19:38 .hide-file.txt +``` +Здесь нужно остановиться и разобраться, что здесь написано. + +| Параметр | Описание | +| -------- | -------- | +| **итого 12** | Обозначаеться общий размер всех файлов в каталоге в килобайтах. Но считает не размерами файлов, а блоками. | +| **-rw-r--r--** | Права на файл или каталог. *Данная тема очень обширная и ее следует рассматривать отдельно*.
Мы можем увидеть, что у каталога в начале прав вместо `-` установлена `d`. Это обозначение каталога.
*Данная тема очень обширная и ее следует рассматривать отдельно*.| +| Первый параметр **cher** | Имя пользователя, который владеет каталогом или файлом.
Данный владелец присвоился от создателя. | +| Второй параметр **cher** | Группа, которая владеет каталога или файла.
Данная группа присвоилась от создателя. | +| **4096**, **16** и **10** | Размер файла и каталога в байтах.
Каталоги, как и все в Linux - файл. Обычный пустой каталог весит **4096** байтов, то есть **4** КБ. | +| **Янв 3 19:38** | Дата и время создания или измения каталога. | + +## Завершение базовой части +Мы прошлись по базовым аргументам, которые должны знать уверенные пользователи GNU/Linux. +!!! info "Не большая рекомендация" + Попробуйте на своей машине с GNU/Linux попрактиковаться. + +## Расширенные примеры + +Посмотрим другие параметры. + +### Перевернуть список +Попробуем перевернуть список, используя аргумент `-r` `--reverse`. +```console title="Вверх ногами" +[cher@k-des test0]$ ls -lr +итого 8 +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt +drwxr-xr-x 2 cher cher 4096 янв 3 20:03 dirrectory +``` + +### Сортировать по размеру +Теперь посмотрим, какие файлы самые большие, использовав аргумент `-S`. +```console title="Сортировка по размеру" +[cher@k-des test0]$ ls -lS +итого 8 +drwxr-xr-x 2 cher cher 4096 янв 3 20:03 dirrectory +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt +``` + +Ничего не изменилось. Да же, если выведем и скрытые файлы, то ничего не измениться. Потому что обычная и по размеру сортировка совпадает. Попробуем тогда вывести с другого каталога. + +Возьмем для примера каталог `/etc/ssh`, где присутствют файлы конфигурации ssh. +```console title="Сортировка по размеру №2" +[cher@k-des test0]$ ls -l /etc/ssh +итого 608 +-rw-r--r-- 1 root root 581349 окт 25 11:36 moduli +-rw-r--r-- 1 root root 1558 дек 4 02:47 ssh_config +drwxr-xr-x 2 root root 4096 дек 7 15:46 ssh_config.d +-rw-r--r-- 1 root root 3528 ноя 30 01:22 sshd_config +drwxr-xr-x 2 root root 4096 ноя 17 19:57 sshd_config.d +-rw------- 1 root root 505 окт 2 02:26 ssh_host_ecdsa_key +-rw-r--r-- 1 root root 172 окт 2 02:26 ssh_host_ecdsa_key.pub +-rw------- 1 root root 399 окт 2 02:26 ssh_host_ed25519_key +-rw-r--r-- 1 root root 92 окт 2 02:26 ssh_host_ed25519_key.pub +-rw------- 1 root root 2590 окт 2 02:26 ssh_host_rsa_key +-rw-r--r-- 1 root root 564 окт 2 02:26 ssh_host_rsa_key.pub +[cher@k-des test0]$ ls -lS /etc/ssh +итого 608 +-rw-r--r-- 1 root root 581349 окт 25 11:36 moduli +drwxr-xr-x 2 root root 4096 дек 7 15:46 ssh_config.d +drwxr-xr-x 2 root root 4096 ноя 17 19:57 sshd_config.d +-rw-r--r-- 1 root root 3528 ноя 30 01:22 sshd_config +-rw------- 1 root root 2590 окт 2 02:26 ssh_host_rsa_key +-rw-r--r-- 1 root root 1558 дек 4 02:47 ssh_config +-rw-r--r-- 1 root root 564 окт 2 02:26 ssh_host_rsa_key.pub +-rw------- 1 root root 505 окт 2 02:26 ssh_host_ecdsa_key +-rw------- 1 root root 399 окт 2 02:26 ssh_host_ed25519_key +-rw-r--r-- 1 root root 172 окт 2 02:26 ssh_host_ecdsa_key.pub +-rw-r--r-- 1 root root 92 окт 2 02:26 ssh_host_ed25519_key.pub +``` +Здесь уже достаточно хорошо видно различие между обычной сортировки и сортировки по размеру. + +Обратная сортировка осуществляеться таким образом: `ls -lSr`. + +### Рекурсивый просмотр каталогов +Попробуем вывести сразу список в активном каталоге и тех, которые находяться в нем. Добавим аргумент `-R` к `-l`. +```console title="Вевести ВСЕ!" +[cher@k-des test0]$ ls -lR +.: +итого 8 +drwxr-xr-x 3 cher cher 4096 янв 3 21:52 dirrectory +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt + +./dirrectory: +итого 8 +drwxr-xr-x 2 cher cher 4096 янв 3 21:53 dirrectory0 +-rw-r--r-- 1 cher cher 5 янв 3 21:49 gift.txt + +./dirrectory/dirrectory0: +итого 4 +-rw-r--r-- 1 cher cher 10 янв 3 21:53 trap.txt +``` +Теперь мы сразу увидели что находиться в каталогах **./dirrectory** и **./dirrectory/dirrectory0**. + +### Сотрировка по времени +Аргумент `-t` или `--time` поможет сортировать по времени. +```console title="Временной калаж" +[cher@k-des test0]$ ls -ltA +итого 12 +drwxr-xr-x 3 cher cher 4096 янв 3 21:52 dirrectory +-rw-r--r-- 1 cher cher 10 янв 3 19:38 .hide-file.txt +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt +``` + +### Вывод элементов по строчно без дополнительной информации +Аргумент `-1` работает также, как и `-l`, но без лишней информации, только название элементов. +```console title="Строчный список имен" +[cher@k-des test0]$ ls -1A +dirrectory +hello-world.txt +.hide-file.txt +``` + +## Аргументы + +| Аргумент | Описание | +| -------- | -------- | +| `-l` | Выводит подробный список. | +| `-a`, `--all`| Выводит дополнительно скрытые файлы и каталоги, начинающиеся с точки. | +| `-A` `--almost-all` | То же, что и `-a`, `-all`, но без основного каталога `.` и каталога выше `..`.| +| `-o` | То же, что и `-l`, но без групп. | +| `-g` | То же, что и `-l`, но без владельцев. | +| `--full-time` | Выведет время в полном варианте.
Будет использоваться формат **full-iso**. | +| `-S` | Сортировка элементов по размеру. | +| `-s` | Отобразить блочно размер файлов. | +| `-r` | Перевернуть список. | +| `-R` | Рекурсивный список каталогов и файлов.
Отобразит содержимое основного каталого и и тех, которые присутствуют в нем. | +| `-1` | Работает так же, как и `-l`, но выводит только название файлов и каталогов. | +| `-t`, `--time` | Сортировка по времени | diff --git a/docs/docs/linux/command-ls.md.bk b/docs/docs/linux/command-ls.md.bk new file mode 100644 index 0000000..6a4ab9a --- /dev/null +++ b/docs/docs/linux/command-ls.md.bk @@ -0,0 +1,82 @@ +## Что делает данная команда? + +Команда **LS** (List Files and Directories) - выводит список директорий и файлов в активном каталоге. + +## Что она может делать? + +- Выводить как списоком, то есть подробно, так и в строку. +- Сортировать вывод по алфавиту, дате и типу. + +## Примеры + +Попробуем сначала вывести просто `ls` без аргументов: +```bash +[cher@k-des test0]$ + ls +dirrectory hello-world.txt +``` +Мы видим, что было выведено 2 элемента: `hello-world.txt` и `dirrectory`. + +Теперь посмотрим, имеються ли скрытые файлы: +```bash +[cher@k-des test0]$ + ls -a +. .. dirrectory hello-world.txt .hide-file.txt +``` +> Да бы скрыть файл или каталог, его название должно иметь в начле точку `.`. + +Мы видим, что в нашем каталоге имееться скрыты файл `.hide-file.txt`. Но вместе с этим мы получили еще 2 элемента: `.` и `..`. Что они обозначают? + +- `.` обозначает наш активный каталог. +- `..` ссылкаеться на предыдущий каталог. + +Они нам особо не нужны. Можно их не выводить. Аргумент `-A` не выводит данные обозначения: +```bash +[cher@k-des test0]$ + ls -A +dirrectory hello-world.txt .hide-file.txt +``` + +Теперь попробуем вывести списком. Для этого нам понадобиться аргумент `-l`. Попробуем снова посмотрет с дополнительны аргументом `-A`: +```bash +[cher@k-des test0]$ + ls -lA +итого 12 +drwxr-xr-x 2 cher cher 4096 янв 3 20:03 dirrectory +-rw-r--r-- 1 cher cher 16 янв 3 19:35 hello-world.txt +-rw-r--r-- 1 cher cher 10 янв 3 19:38 .hide-file.txt +``` +Здесь нужно остановиться и разобраться, что здесь написано. + +- **итого 12** - Так обозначаеться общий размер всех файлов в каталоге в килобайтах. Но считает не размерами файлов, а блоками. +- **-rw-r--r--** - Права на файл или каталог. *Данная тема очень обширная и ее следует рассматривать отдельно*. + - Мы можем увидеть, что у каталога в начале прав вместо `-` установлена `d`. Это обозначение каталога. +- **Первый столбец с обозначением cher** - Имя пользователя, который владеет каталогом или файлом. +- **Второй столбец с обозначением cher** - Группа, которая владеет каталога или файла. + - Почему имя пользователя и группа одинакова? При создании какого либо элемета, владельцем становиться создатель, а так же, присваиваеться его группа. +- **4096**, **16** и **10** - Размер файла и каталога в байтах. +> Каталоги, как и все в Linux - файл. Обычный пустой каталог весит **4096** байтов, то есть **4** КБ. +- **Янв 3 19:38** - Дата и время создания или измения каталога. + +| Параметр | Описание | +| -------- | -------- | +| **итого 12** | Обозначаеться общий размер всех файлов в каталоге в килобайтах. Но считает не размерами файлов, а блоками. | +| **-rw-r--r--** | Права на файл или каталог. *Данная тема очень обширная и ее следует рассматривать отдельно*.
Мы можем увидеть, что у каталога в начале прав вместо `-` установлена `d`. Это обозначение каталога. | +| Первый параметр **cher** | Имя пользователя, который владеет каталогом или файлом. | +| Второй параметр **cher** | Группа, которая владеет каталога или файла. | +| **4096**, **16** и **10** | Размер файла и каталога в байтах.
Каталоги, как и все в Linux - файл. Обычный пустой каталог весит **4096** байтов, то есть **4** КБ. | +| **Янв 3 19:38** | Дата и время создания или измения каталога. | + +Это базовые аргументы, которые должны знать пользователи GNU/Linux. Теперь посмотрим и другие парамерты. + +## Аргументы + +| Аргумент | Описание | +| -------- | -------- | +| `-l` | Выводит подробный список. | +| `-a`, `--all`| Выводит дополнительно скрытые файлы и каталоги, начинающиеся с точки. | +| `-A` `--almost-all` | Выведет все файлы в каталоге. Без активного каталога `.` и каталога выше `..`.| +| `-o` | То же, что и `-l`, но без групп. | +| `-g` | То же, что и `-l`, но без владельцев. | +| `--full-time` | Выведет время в полном варианте. Будет использоваться формат **full-iso** | + diff --git a/docs/docs/steam-deck/disable-read-only.md b/docs/docs/steam-deck/disable-read-only.md index 48ecb25..ef4c2b9 100644 --- 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 +``` + +|![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 вручную, нажав на кнопку **...** . diff --git a/docs/media/steamos-discover-main-page.png b/docs/media/steamos-discover-main-page.png new file mode 100644 index 0000000..33a3ad0 Binary files /dev/null and b/docs/media/steamos-discover-main-page.png differ diff --git a/docs/media/steamos-konsole-flatpak-install-quake.png b/docs/media/steamos-konsole-flatpak-install-quake.png new file mode 100644 index 0000000..2991c3c Binary files /dev/null and b/docs/media/steamos-konsole-flatpak-install-quake.png differ diff --git a/mkdocs.yml b/mkdocs.yml index e3736d2..d20cfe2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -12,6 +12,8 @@ theme: - navigation.instant - navigation.trcking - toc.integrate + - content.code.copy + - content.code.annotate palette: # Светлая тема - scheme: default @@ -31,6 +33,8 @@ theme: plugins: - search - git-revision-date-localized + - glightbox + nav: - Главная: index.md @@ -38,6 +42,7 @@ nav: - "GNU/Linux & UNIX": - 'Базовые команды': - Основные команды: docs/linux/base-commands.md + - "Команда ls": docs/linux/command-ls.md - 'Steam Deck': - "Снятие Read Only с корневого раздела": docs/steam-deck/disable-read-only.md - Сервисы: services.md @@ -60,3 +65,25 @@ extra: - icon: fontawesome/brands/steam link: https://steamcommunity.com/id/KURNESAY/ +markdown_extensions: + - admonition + - pymdownx.details + - pymdownx.superfences + - attr_list + - md_in_html + - toc: + permalink: true + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + pygments_lang_class: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences: + custom_fences: + - name: mermaid + class: mermaid + format: !!python/name:pymdownx.superfences.fence_code_format diff --git a/requirements.txt b/requirements.txt index 446c403..fd96d12 100644 --- a/requirements.txt +++ b/requirements.txt @@ -2,3 +2,6 @@ mkdocs>=1.6 mkdocs-material>=9.7 mkdocs-git-revision-date-localized-plugin>=1.2 mkdocs-rss-plugin>=1.7 +mkdocs-glightbox +pymdown-extensions +