Lx4U-book/README.md

# Linux для себя

<div style="text-align:center; margin: 30px 0">
	<a href="http://lx4u.ru">
		<img alt="lx4u" src="https://raw.githubusercontent.com/Linux4Yourself/Linux4Yourself.Design/main/misc/cover.svg" />
	</a>
</div>

Lx4U или “Linux для себя” - подробное руководство по созданию Linux-системы, используя исходные тексты необходимого программного обеспечения. 

Это руководство - самостоятельное ответвление от проекта [Linux From Scratch](https://linuxfromscratch.org).

На ваш выбор предлагается использование multilib системы, поддержка EFI и набор дополнительного программного обеспечения для организации комфортной работы. Кроме того, существует расширенное руководство, в котором содержится информация о настройке окружения рабочего стола и программного обеспечения, охватывающего различные области применения.

Но главная идея остаётся - вы в центре всего, и вы решаете, какой должна быть Ваша собственная система. А мы просто протягиваем Вам руку помощи.

Начните собственное путешествие в мир Linux прямо сейчас!

## Чтобы изучить руководство локально

### Требования

* `python3` для работы генератора документации и сервера;
* `pip3` для установки зависимостей.

### Установка зависимостей

```bash
pip install mkdocs-material mkdocs
pip install git+https://github.com/RedisLabs/mkdocs-include.git
```

### Сборка в Linux

```bash
mkdocs build # Сборка
mkdocs serve # Запуск
```

### Сборка в Windows

Могут возникнуть проблемы со сборкой в Windows из-за кодировки.
Чтобы исправить эту проблему, можно выставить переменную окружения PYTHONUTF8 со значением 1

Например 

```bash
export PYTHONUTF8=1
```


```bash
python -m mkdocs build # Сборка
python -m mkdocs serve # Запуск
```

В результате будет сгенерирован каталог `site`. Руководство будет доступно по адресу http://127.0.0.1:8000/mkdocs/.