Lx4U-book/README.md
2021-12-25 13:33:08 +03:00

58 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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/.