Move PX4 Guide source into /docs (#24490)

* Add vitepress tree * Update existing workflows so they dont trigger on changes in the docs path * Add nojekyll, package.json, LICENCE etc * Add crowdin docs upload/download scripts * Add docs flaw checker workflows * Used docs prefix for docs workflows * Crowdin obvious fixes * ci: docs move to self hosted runner runs on a beefy server for faster builds Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: don't run build action for docs or ci changes Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: update runners Signed-off-by: Ramon Roche <mrpollo@gmail.com> * Add docs/en * Add docs assets and scripts * Fix up editlinks to point to PX4 sources * Download just the translations that are supported * Add translation sources for zh, uk, ko * Update latest tranlsation and uorb graphs * update vitepress to latest --------- Signed-off-by: Ramon Roche <mrpollo@gmail.com> Co-authored-by: Ramon Roche <mrpollo@gmail.com>
2026-10-03 16:48:52 +08:00 · 2025-03-13 16:08:27 +11:00
parent 8e6d2ebe4a
commit 88d623bedb
5176 changed files with 558771 additions and 2 deletions
@@ -0,0 +1,99 @@
+# Середовище розробки CentOS
+
+:::warning
+This development environment is [community supported and maintained](../advanced/community_supported_dev_env.md).
+Це може працювати або не працювати з поточними версіями PX4.
+
+Дивіться [Встановлення інструментарію](../dev_setup/dev_env.md) для інформації про середовища та інструменти, що підтримуються основною командою розробників.
+:::
+
+Збірка потребує Python 2.7.5. Тому потрібно використовувати CentOS 7 на момент написання.
+(Для попередніх релізів CentOS можна встановити python v2.7.5 поряд із версією із дистрибутиву. Але це не рекомендується тому що можна зламати yum.)
+
+## Загальні залежності
+
+Репозиторії EPEL необхідні для пакетів openocd libftdi-devel libftdi-python
+
+```sh
+wget https://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-5.noarch.rpm
+sudo yum install epel-release-7-5.noarch.rpm
+yum update
+yum groupinstall “Development Tools”
+yum install python-setuptools python-numpy
+easy_install pyserial
+easy_install pexpect
+easy_install toml
+easy_install pyyaml
+easy_install cerberus
+yum install openocd libftdi-devel libftdi-python python-argparse flex bison-devel ncurses-devel ncurses-libs autoconf texinfo libtool zlib-devel cmake vim-common
+```
+
+:::info
+You may want to also install `python-pip` and `screen`.
+:::
+
+## Встановлення інструментарію GCC.
+
+<!-- GCC toolchain documentation used for all Linux platforms to build NuttX -->
+
+Виконайте скрипт нижче для встановлення GCC 7-2017-q4:
+
+:::warning
+This version of GCC is out of date.
+At time of writing the current version on Ubuntu is `9-2020-q2-update` (see [focal nuttx docker file](https://github.com/PX4/PX4-containers/blob/master/docker/Dockerfile_nuttx-focal#L28))
+:::
+
+```sh
+pushd .
+cd ~
+wget https://armkeil.blob.core.windows.net/developer/Files/downloads/gnu-rm/7-2017q4/gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2
+tar -jxf gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2
+exportline="export PATH=$HOME/gcc-arm-none-eabi-7-2017-q4-major/bin:\$PATH"
+if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi
+popd
+```
+
+Тепер перезавантажте комп'ютер.
+
+**Troubleshooting**
+
+Перевірте версію, ввівши наступну команду:
+
+```sh
+arm-none-eabi-gcc --version
+```
+
+Результат повинен бути схожий на:
+
+```sh
+arm-none-eabi-gcc (GNU Tools for Arm Embedded Processors 7-2017-q4-major) 7.2.1 20170904 (release) [ARM/embedded-7-branch revision 255204]
+Copyright (C) 2017 Free Software Foundation, Inc.
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+```
+
+<!-- import docs ninja build system -->
+
+## Система збірки Ninja
+
+[Ninja](https://ninja-build.org/) is a faster build system than _Make_ and the PX4 _CMake_ generators support it.
+
+На Ubuntu Linux ви можете встановити її автоматично зі звичайних репозиторіїв.
+
+```sh
+sudo apt-get install ninja-build -y
+```
+
+Інші системи можуть не включати Ninja в менеджер пакетів.
+В цьому випадку альтернатива - завантажити бінарний файл і додати його до вашого шляху:
+
+```sh
+mkdir -p $HOME/ninja
+cd $HOME/ninja
+wget https://github.com/martine/ninja/releases/download/v1.6.0/ninja-linux.zip
+unzip ninja-linux.zip
+rm ninja-linux.zip
+exportline="export PATH=$HOME/ninja:\$PATH"
+if grep -Fxq "$exportline" ~/.profile; then echo nothing to do ; else echo $exportline >> ~/.profile; fi
+. ~/.profile
+```