diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md index 124bd800..02175a63 100644 --- a/docs/en/SUMMARY.md +++ b/docs/en/SUMMARY.md @@ -91,6 +91,7 @@ * [Soldering safety](tb.md) * [LED strip (legacy)](leds_old.md) * [Contribution Guidelines](contributing.md) + * [COEX packages repository](packages.md) * [Migration to v0.20](migrate20.md) * [Migration to v0.22](migrate22.md) * [Events](events.md) diff --git a/docs/en/contributing.md b/docs/en/contributing.md index 5f56437e..d25f3124 100644 --- a/docs/en/contributing.md +++ b/docs/en/contributing.md @@ -96,3 +96,7 @@ Prepare your article and send it as a pull request to the [Clover repository](ht ## Easy way If the above instructions are too difficult for you, send your fixes and new articles by e-mail (okalachev@gmail.com) or in Telegram messenger (user @okalachev). + +## Publishing packages + +You also can publish a package, that extends Clover functionality, into the official [COEX Debian repository](packages.md). diff --git a/docs/en/packages.md b/docs/en/packages.md new file mode 100644 index 00000000..0e85bffb --- /dev/null +++ b/docs/en/packages.md @@ -0,0 +1,27 @@ +# COEX packages repository + +COEX provides an open [Debian-repository](https://wiki.debian.org/DebianRepository) with ROS Noetic related prebuilt binary pacakges for `armhf` architecture. + +> **Info** Repository URL: http://packages.coex.tech. + +The repository is already addedd in [RPi image](image.md) and may be used for simple installation of additional ROS packages. + +## Packages publishing + +You can make a Pull Request in a git repository with packages, adding or updating your package (a file with `.deb` extension), that relates to Clover or ROS. After merging your package will be available for installation with `apt` utility: + +```bash +sudo apt install ros-noetic-clover-some-feature +``` + +Packages, that extend Clover functionality are recommended to be named with `clover_` prefix, e. g. `clover_some_feature`. + +## Using on a normal Raspberry Pi OS + +On a normal Raspberry Pi OS, the repository may be added to the sources list, this way: + +```bash +wget -O - 'http://packages.coex.tech/key.asc' | apt-key add - +echo 'deb http://packages.coex.tech buster main' >> /etc/apt/sources.list +sudo apt update +``` diff --git a/docs/ru/SUMMARY.md b/docs/ru/SUMMARY.md index e53ce34a..559bfef2 100644 --- a/docs/ru/SUMMARY.md +++ b/docs/ru/SUMMARY.md @@ -96,6 +96,7 @@ * [Подключение регулятора 4 в 1](4in1.md) * [Светодиодная лента (legacy)](leds_old.md) * [Вклад в Клевер](contributing.md) + * [Репозиторий пакетов COEX](packages.md) * [Переход на версию 0.20](migrate20.md) * [Переход на версию 0.22](migrate22.md) * [COEX Duocam](duocam.md) diff --git a/docs/ru/contributing.md b/docs/ru/contributing.md index a183b74e..8b8657f4 100644 --- a/docs/ru/contributing.md +++ b/docs/ru/contributing.md @@ -96,3 +96,7 @@ ## Простой способ Если вышеприведенные инструкции для вас оказываются слишком сложными, отправляйте правки или новые статьи по e-mail (okalachev@gmail.com) или в Telegram (пользователь @okalachev). + +## Публикация пакетов + +Вы также можете опубликовать собственный пакет, расширяющий функциональность Клевера, в [Debian-репозитории COEX](packages.md). diff --git a/docs/ru/packages.md b/docs/ru/packages.md new file mode 100644 index 00000000..935b9568 --- /dev/null +++ b/docs/ru/packages.md @@ -0,0 +1,27 @@ +# Репозиторий пакетов COEX + +COEX предоставляет открытый [Debian-репозиторий](https://wiki.debian.org/ru/SourcesList) с предсобранными пакетами, относящимися к ROS Noetic, для архитектуры `armhf`. + +> **Info** Адрес репозитория: http://packages.coex.tech. + +Репозиторий подключен в [образе для RPi](image.md) и может быть использован для легкой установки дополнительных ROS-пакетов. + +## Публикация пакетов + +Вы можете прислать Pull Request в [git-репозиторий с пакетами](https://github.com/CopterExpress/packages), добавляющий или обновляющий ваш пакет (файл с расширением `.deb`), относящийся с Клеверу или ROS. После принятия ваш пакет будет доступен для установки с помощью утилиты `apt`: + +```bash +sudo apt install ros-noetic-clover-some-feature +``` + +Пакеты, расширяющие функциональность Клевера, рекомендуется называть с префиксом `clover_`, например `clover_some_feature`. + +## Использование на обычной Raspberry Pi OS + +На обычной Raspberry Pi OS репозиторий может быть добавлен в список источников пакетов следующими командами: + +```bash +wget -O - 'http://packages.coex.tech/key.asc' | apt-key add - +echo 'deb http://packages.coex.tech buster main' >> /etc/apt/sources.list +sudo apt update +```