commit b054874cafec30c7b140f7a70ce90221bc13db5c Author: Alexander Zhirov Date: Sat Oct 23 01:45:06 2021 +0300 Solus Project first commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..103c0e6 --- /dev/null +++ b/README.md @@ -0,0 +1,5 @@ +# Documentation + +В данном репозитории хранятся инструкции, мануалы и прочие документы, относящиеся к настройке и использованию программного обеспечения. + +- [Solus Project](SolusProject) \ No newline at end of file diff --git a/SolusProject/README.md b/SolusProject/README.md new file mode 100644 index 0000000..91eb14b --- /dev/null +++ b/SolusProject/README.md @@ -0,0 +1,7 @@ +# Solus Project + +[Solus](https://getsol.us/home/) — независимый Linux дистрибутив, использующий [Budgie](https://getsol.us/solus/experiences/) в качестве окружения рабочего стола и eopkg для управления пакетами. + +![Image of Yaktocat](img/budgie_desktop.png) + +- [Сборка eopkg пакета](doc/build_eopkg.md) diff --git a/SolusProject/doc/build_eopkg.md b/SolusProject/doc/build_eopkg.md new file mode 100644 index 0000000..9b9141c --- /dev/null +++ b/SolusProject/doc/build_eopkg.md @@ -0,0 +1,87 @@ +# Сборка eopkg пакета + +[Официальная документация](https://getsol.us/articles/packaging/) по сборке пакетов **eopkg** для последующего размещения в официальном репозитории. + +## Процесс сборки + +* [Предварительная подготовка](#предварительная-подготовка) +* [Подготовка сборки пакета](#подготовка-сборки-пакета) + +## Предварительная подготовка + +Для начала необходимо сконфигурировать файл `packager`, который используется для упаковщика в результирующем двоичном пакете. Для этого в домашней директории необходимо создать каталог `.solus` с содержащим внутри себя файлом `packager`: + +```shell +mkdir ~/.solus +nano ~/.solus/packager +``` + +Внутри файла необходимо указать два ключа, идентифицирующие собирающего пакеты: + +``` +[Packager] +Name=Your Name Here +Email=your.email@address +``` + +Следующим действием необхоимо произвести установку [базового инструмента разработки](https://getsol.us/articles/package-management/basics/en/#base-development-tools) `system.devel`: + +```shell +sudo eopkg install -c system.devel +``` + +Для сборки `eopkg` пакетов необходимо использовать инструмент `solbuild`: + +```shell +sudo eopkg it solbuild +``` + +Так же можно (желательно) установить `solbuild-config-unstable` для сборки нестабильной версии пакета: + +```shell +sudo eopkg it solbuild-config-unstable +``` + +После установки необходимо инициализировать `solbuild`: + +```shell +sudo solbuild init +``` + +Это займет некоторое время, так как будет производиться загрузка и подготовка образа. Рекомендуется обновлять `solbuild`, в противном случае обновления будут применяться при каждой сборке: + +```shell +sudo solbuild update +``` + +Следующим шагом необходимо создать каталог для разработки, в котором будет находиться все конфигурационные файлы для сборки пакетов. К примеру, в домашней директории создать каталог `building`: + +```shell +mkdir ~/building +``` + +Далее внутри каталога `building` произвести настройку инструментов для сборки. Нужно настроить `common` (набор сценариев создания), который позволяет более легко управлять, создавать, проверять и публиковать пакеты. Для этого нужно клонировать общий репозиторий с помощью `git`: + +```shell +cd ~/building +git clone https://dev.getsol.us/source/common.git +``` + +Далее нужно настроить символические ссылки: + +```shell +ln -sv common/Makefile.common . +ln -sv common/Makefile.toplevel Makefile +ln -sv common/Makefile.iso . +``` + +В результате выполненных действий каталог `building` примет следующий вид: + +``` +├── common +├── Makefile +├── Makefile.common +└── Makefile.iso +``` + +## Подготовка сборки пакета diff --git a/SolusProject/img/budgie_desktop.png b/SolusProject/img/budgie_desktop.png new file mode 100644 index 0000000..a04bad7 Binary files /dev/null and b/SolusProject/img/budgie_desktop.png differ