feat: add comprehensive NixOS configuration documentation and structure

- Introduced `08-structure.md` detailing project structure, main files, and versioning.
- Created `README.md` for documentation overview and quick start guide.
- Added user-specific configurations for Alacritty, Vim, Micro, Git, Zsh, Tmux, and tools.
- Implemented system modules for desktop environment (KDE Plasma), audio (PipeWire), networking, and services (OpenSSH, GnuPG).
- Configured Nix settings with flakes support and garbage collection.
- Established user management for `ada` with necessary groups and shell settings.
- Enabled VirtualBox guest additions for improved VM experience.
This commit is contained in:
Dmitry
2026-03-10 13:10:52 +03:00
parent a7ba016de4
commit 17b0cdfbac
31 changed files with 3327 additions and 164 deletions
+39
View File
@@ -0,0 +1,39 @@
# 📚 Документация NixOS конфигурации
Каждый файл в этой папке - это небольшой гайд по конкретной задаче.
## 📖 Гайды
- **[01-install-packages.md](01-install-packages.md)** — Добавление и удаление пакетов
- **[02-shell-environment.md](02-shell-environment.md)** — Shell alias, переменные окружения
- **[03-networking.md](03-networking.md)** — SSH, firewall, сетевые настройки
- **[04-devshell.md](04-devshell.md)** — Работа с devShell для разработки
- **[05-git-config.md](05-git-config.md)** — Git конфигурация и алиасы
- **[06-adding-modules.md](06-adding-modules.md)** — Создание новых модулей
- **[07-troubleshooting.md](07-troubleshooting.md)** — Отладка проблем
- **[08-structure.md](08-structure.md)** — Структура проекта
## ⚡ Быстрый старт
```bash
cd /home/ada/.dotfiles/nixos
# Собрать конфигурацию
sudo nixos-rebuild switch --flake .
# Или с nh (проще):
nh os switch
```
## 🔍 Найти нужное
| Задача | Файл |
|--------|------|
| Добавить пакет | 01-install-packages.md |
| Добавить shell alias | 02-shell-environment.md |
| Конфигурировать SSH | 03-networking.md |
| Использовать devShell | 04-devshell.md |
| Настроить Git | 05-git-config.md |
| Создать новый модуль | 06-adding-modules.md |
| Что-то не работает | 07-troubleshooting.md |
| Как всё устроено | 08-structure.md |