gitbook: enable collapsible-menu (#270)

* gitbook: enable collapsible-menu * Collapse main menu (en) * Update events and supplementary materials articles * Fix collapsed items of main menu * Add Copter Hack 2021 article
2026-05-30 14:59:31 +00:00 · 2020-10-06 01:05:53 +03:00
parent 792352d072
commit 60755fa1b5
15 changed files with 112 additions and 37 deletions
--- a/book.json
+++ b/book.json
@@ -9,6 +9,7 @@
        "richquotes@https://github.com/okalachev/gitbook-plugin-richquotes.git",
        "yametrika",
        "anchors",
+        "collapsible-menu",
        "validate-links",
        "bulk-redirect@https://github.com/okalachev/gitbook-plugin-bulk-redirect.git",
        "sitemap@https://github.com/okalachev/plugin-sitemap.git",
--- a/docs/assets/versions/clover_2.jpg
+++ b/docs/assets/versions/clover_2.jpg
--- a/docs/assets/versions/clover_3.jpg
+++ b/docs/assets/versions/clover_3.jpg
--- a/docs/assets/versions/clover_4.jpg
+++ b/docs/assets/versions/clover_4.jpg
--- a/docs/clover.css
+++ b/docs/clover.css
@@ -66,6 +66,10 @@ footer img {
 	padding: 14px 20px;
 }

+table.versions td {
+	text-align: center;
+	background: white;
+
 .circle {
 	width: 0.8em;
 	height: 0.8em;
--- a/docs/en/SUMMARY.md
+++ b/docs/en/SUMMARY.md
@@ -3,24 +3,22 @@
 * [Introduction](README.md)
 * [Glossary](gloss.md)
 * [Safety tips](safety.md)
-* Assembly
+* [Assembly](assembly.md)
  * [Clover 4.2 assembly](assemble_4_2.md)
  * [Clover 4 assembly](assemble_4.md)
  * [Clover 3 assembly](assemble_3.md)
  * [Clover 2 assembly](assemble_2.md)
-* Configuration
-  * [Initial setup](setup.md)
+* [Configuration](setup.md)
  * [Sensor calibration](calibration.md)
  * [RC setup](radio.md)
    * [Using FS-A8S](rc_flysky_a8s.md)
  * [Flight modes](modes.md)
  * [Power setup](power.md)
  * [Failsafe configuration](failsafe.md)
-* Manual flight
+* [Manual flight](flight.md)
  * [Basics](flight.md)
  * [Exercises](flight_exercises.md)
-* Working with Raspberry Pi
-  * [Raspberry Pi](raspberry.md)
+* [Working with Raspberry Pi](raspberry.md)
  * [RPi Image](image.md)
  * [Wi-Fi connection](wifi.md)
  * [Connection to the Pixracer](connection.md)
@@ -29,11 +27,9 @@
  * [Command line interface](cli.md)
  * [Automated self-checks](selfcheck.md)
  * [Viewing images from cameras](web_video_server.md)
-* Programming
-  * [Overview](programming.md)
+* [Programming](programming.md)
  * [Camera setup](camera_setup.md)
-  * Fiducial markers (ArUco)
-    * [Overview](aruco.md)
+  * [Fiducial markers (ArUco)](aruco.md)
    * [Marker detection](aruco_marker.md)
    * [Map-based navigation](aruco_map.md)
  * [Optical Flow](optical_flow.md)
@@ -48,15 +44,14 @@
  * [Using rviz and rqt](rviz.md)
  * [Software autorun](autolaunch.md)
  * [Using JavaScript](javascript.md)
-  * [Blocks programmin](blocks.md)
-  * [ROS](ros.md)
-  * [MAVROS](mavros.md)
-  * Simulation
-    * [Overview](simulation.md)
+  * [Blocks programming](blocks.md)
+  * [Simulation](simulation.md)
    * [Native setup](simulation_native.md)
    * [VM setup](simulation_vm.md)
    * [Usage](simulation_usage.md)
-* Supplementary materials
+  * [ROS](ros.md)
+  * [MAVROS](mavros.md)
+* [Supplementary materials](supplementary.md)
  * [COEX Pix](coex_pix.md)
  * [Guide on autonomous flight](auto_setup.md)
  * [Hostname](hostname.md)
@@ -89,7 +84,7 @@
  * [LED strip (legacy)](leds_old.md)
  * [Contribution Guidelines](contributing.md)
  * [Migration to v0.20](migrate20.md)
-* Clover-based projects
+* [Clover-based projects](projects.md)
  * [Drone show](clever-show.md)
  * [Innopolis Open 2020 (L22_ÆRO)](innopolis_open_L22_AERO.md)
  * [Copter spheric guard](shield.md)
--- a/docs/en/assembly.md
+++ b/docs/en/assembly.md
@@ -0,0 +1,27 @@
+# Clover drone assembly
+
+This section contains articles describing the assembly of each version of Clover.
+
+<table class=versions>
+     <tr><th>Version</th><th>Image</th></tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Clover&nbsp;4.2</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Clover&nbsp;4.1</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Clover&nbsp;4</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Clover&nbsp;3</a></td>
+          <td><img src="../assets/versions/clover_3.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Clover&nbsp;2</a></td>
+          <td><img src="../assets/versions/clover_2.jpg" width=200></td>
+     </tr>
+</table>
--- a/docs/en/projects.md
+++ b/docs/en/projects.md
@@ -0,0 +1,3 @@
+# Clover-based projects
+
+Clover drone kit is widely used in design activities. This section contains user articles describing the implemented projects.
--- a/docs/en/supplementary.md
+++ b/docs/en/supplementary.md
@@ -0,0 +1,5 @@
+# Supplementary materials
+
+This section contains articles that are not included in the main sections, as well as articles by the users on various subjects related to UAV.
+
+To learn more about publishing text in this section, see the article "[Contributing to Clover](contributing.md)".
--- a/docs/ru/SUMMARY.md
+++ b/docs/ru/SUMMARY.md
@@ -3,25 +3,22 @@
 * [Введение](README.md)
 * [Глоссарий](gloss.md)
 * [Безопасность](safety.md)
-* Сборка
+* [Сборка](assembly.md)
  * [Клевер 4.2](assemble_4_2.md)
  * [Клевер 4.1](assemble_4_1.md)
  * [Клевер 4](assemble_4.md)
  * [Клевер 3](assemble_3.md)
  * [Клевер 2](assemble_2.md)
-* Настройка
-  * [Первоначальная настройка](setup.md)
+* [Настройка](setup.md)
  * [Калибровка датчиков](calibration.md)
  * [Настройка пульта](radio.md)
    * [Работа с FS-A8S](rc_flysky_a8s.md)
  * [Полетные режимы](modes.md)
  * [Настройка питания](power.md)
  * [Настройка failsafe](failsafe.md)
-* Ручной полет
-  * [Основы](flight.md)
+* [Ручной полет](flight.md)
  * [Упражнения](flight_exercises.md)
-* Работа с Raspberry Pi
-  * [Raspberry Pi](raspberry.md)
+* [Работа с Raspberry Pi](raspberry.md)
  * [Образ для RPi](image.md)
  * [Подключение по Wi-Fi](wifi.md)
  * [Подключение к Pixracer](connection.md)
@@ -30,11 +27,9 @@
  * [Командная строка](cli.md)
  * [Автоматическая проверка](selfcheck.md)
  * [Просмотр видеострима с камер](web_video_server.md)
-* Программирование
-  * [Общая информация](programming.md)
+* [Программирование](programming.md)
  * [Настройка камеры](camera_setup.md)
-  * Визуальные маркеры (ArUco)
-    * [Общая информация](aruco.md)
+  * [Визуальные маркеры (ArUco)](aruco.md)
    * [Распознавание маркеров](aruco_marker.md)
    * [Навигация по карте маркеров](aruco_map.md)
  * [Навигация по Optical Flow](optical_flow.md)
@@ -50,14 +45,13 @@
  * [Автозапуск ПО](autolaunch.md)
  * [Использование JavaScript](javascript.md)
  * [Блочное программирование](blocks.md)
-  * [ROS](ros.md)
-  * [MAVROS](mavros.md)
-  * Симулятор
-    * [Общая информация](simulation.md)
+  * [Симулятор](simulation.md)
    * [Сборка на собственной машине](simulation_native.md)
    * [Установка виртуальной машины](simulation_vm.md)
    * [Использование симулятора](simulation_usage.md)
-* Дополнительные материалы
+  * [ROS](ros.md)
+  * [MAVROS](mavros.md)
+* [Дополнительные материалы](supplementary.md)
  * [COEX Pix](coex_pix.md)
  * [Гид по автономному полету](auto_setup.md)
  * [Имя хоста](hostname.md)
@@ -94,14 +88,14 @@
  * [Светодиодная лента (legacy)](leds_old.md)
  * [Вклад в Клевер](contributing.md)
  * [Переход на версию 0.20](migrate20.md)
-* Мероприятия
+* [Мероприятия](events.md)
+  * [CopterHack-2021](copterhack2021.md)
  * [CopterHack-2019](copterhack2019.md)
  * [Олимпиада НТИ 2019](nti2019.md)
  * [Робокросс-2019](robocross2019.md)
  * [CopterHack-2018](copterhack2018.md)
  * [CopterHack-2017](copterhack2017.md)
-* Проекты на базе Клевера
-  * [Список проектов](projects.md)
+* [Проекты на базе Клевера](projects.md)
  * [Шоу коптеров](clever-show.md)
  * [Innopolis Open 2020 (L22_ÆRO)](innopolis_open_L22_AERO.md)
  * [Олимпиада НТИ 2020 (P4DF2)](nti2020_p4df2.md)
@@ -121,4 +115,4 @@

 * [Теория и видеоуроки](lessons.md)
 * [Учебно-методическое пособие](metod.md)
-* [Контрольные и проверочные материалы](tests.md)
+* [Контрольные материалы](tests.md)
--- a/docs/ru/assembly.md
+++ b/docs/ru/assembly.md
@@ -0,0 +1,27 @@
+# Сборка Клевера
+
+В этом разделе находится статьи, описывающие сборку каждой из версии Клевера.
+
+<table class=versions>
+     <tr><th>Версия</th><th>Изображение</th></tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Клевер&nbsp;4.2</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Клевер&nbsp;4.1</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Клевер&nbsp;4</a></td>
+          <td><img src="../assets/versions/clover_4.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Клевер&nbsp;3</a></td>
+          <td><img src="../assets/versions/clover_3.jpg" width=200></td>
+     </tr>
+     <tr>
+          <td><a href="assemble_4_2.md">Клевер&nbsp;2</a></td>
+          <td><img src="../assets/versions/clover_2.jpg" width=200></td>
+     </tr>
+</table>
--- a/docs/ru/copterhack2021.md
+++ b/docs/ru/copterhack2021.md
@@ -0,0 +1,5 @@
+# CopterHack 2021
+
+CopterHack 2021 – это командный конкурс по разработке проектов с открытым исходным кодом для платформы квадрокоптера "Клевер".
+
+Все информацию о мероприятии смотрите на официальном сайте: https://ru.coex.tech/copterhack.
--- a/docs/ru/events.md
+++ b/docs/ru/events.md
@@ -0,0 +1,5 @@
+# Мероприятия
+
+"Клевер" применяется в в большом количестве образовательных мероприятий и соревнований: WorldSkills, Олимпиада НТИ, Copter Hack, Всероссийская Робототехническая Олимпиада и других.
+
+Этот раздел содержит статьи, написанные специально к тому или иному мероприятию.
--- a/docs/ru/projects.md
+++ b/docs/ru/projects.md
@@ -1,5 +1,9 @@
 # Проекты на базе Клевера

+Конструктор "Клевер" широко используется в для проектной деятельности. В этом разделе приведены проектные идеи, а также статьи пользователей, рассказывающие о реализованных проектах.
+
+## Примеры
+
 Список возможных проектов для стажировок и практических работ в вузах и колледжах.

 |Проект/Идея|Примечания|
--- a/docs/ru/supplementary.md
+++ b/docs/ru/supplementary.md
@@ -0,0 +1,5 @@
+# Дополнительные материалы
+
+Этот раздел содержит статьи, не вошедшие в основные разделы, а так же статьи пользователей по той или иной проблематике, связанной с БПЛА.
+
+Чтобы узнать больше о публикации текста в этом разделе, смотрите статью "[Вклад в Клевер](contributing.md)".