Repository navigation
Expand file tree
/
Copy pathmkdocs.yml
More file actions
434 lines (418 loc) · 19.4 KB
/
Copy pathmkdocs.yml
File metadata and controls
434 lines (418 loc) · 19.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
site_name: PAROL6
site_description: Documentation for the PAROL6 desktop robotic arm by Source Robotics.
# Where the site is published: the organisation's docs domain, this repository's path. Search engines take each
# page's address from here, and the sitemap is built from it. mike adds the version under it (/PAROL-docs/1/).
site_url: https://docs.source-robotics.com/PAROL-docs/
# The docs repository: the "edit this page" target. The header card points at the product repositories instead
# (extra.repos below, overrides/partials/source.html).
repo_url: https://github.com/Source-Robotics/PAROL-docs
repo_name: Source-Robotics/PAROL-docs
edit_uri: edit/main/docs/
copyright: |
© 2026 <a href="https://source-robotics.com" target="_blank" rel="noopener">Source Robotics d.o.o.</a> ·
Text and images <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank" rel="noopener">CC BY-SA 4.0</a> ·
Code examples <a href="https://github.com/Source-Robotics/PAROL-docs/blob/main/LICENSE-CODE" target="_blank" rel="noopener">MIT</a> ·
Robot models and pictures made from them: <a href="https://github.com/Source-Robotics/robot_descriptions" target="_blank" rel="noopener">robot_descriptions</a>,
<a href="https://creativecommons.org/licenses/by/4.0/" target="_blank" rel="noopener">CC BY 4.0</a>
theme:
name: material
custom_dir: overrides
logo: assets/logo_new_2.png
favicon: assets/favicon.png
language: en
font: false # Roboto is served from the site: docs/stylesheets/fonts.css
icon:
repo: fontawesome/brands/github
edit: material/pencil
view: material/eye
features:
- navigation.instant # pages load without a full reload: faster, the scroll of the sidebar is kept
- navigation.instant.prefetch # a page is fetched while the pointer hovers its link
- navigation.instant.progress # a progress bar when a page takes long
- navigation.prune # the sidebar carries only the visible part of the navigation: smaller pages
- navigation.tabs # one tab per document: Robot Manual, Control Board, Programming, API reference, Support
- navigation.tabs.sticky
- navigation.sections # the bold sidebar groups
- navigation.indexes # a chapter is a folder with its own page
- navigation.footer # Previous / Next
- navigation.top
- navigation.path
- toc.follow
- search.suggest
- search.highlight
- search.share
- content.tabs.link
- content.code.copy
- content.code.annotate
- content.action.view
- content.action.edit
- content.tooltips # title="..." on links and abbreviations become tooltips
- content.footnote.tooltips
palette: # the same as the PAR6 docs
- scheme: slate # dark by default
primary: black
accent: green
toggle:
icon: material/weather-night
name: Switch to light mode
- scheme: default
primary: black
accent: green
toggle:
icon: material/weather-sunny
name: Switch to dark mode
plugins:
- search
- glightbox # click any image to zoom
- git-revision-date-localized: # "Last update" under every page, from its last commit
type: date
fallback_to_build_date: true # a shallow checkout or a file git does not know yet
exclude:
- includes/*
- social:
cards_layout: default
enabled: !ENV [ENABLE_SOCIAL, false] # social cards only in CI (ENABLE_SOCIAL=true; they need Cairo + Pillow)
# The addresses of the pages of the old site keep working.
- redirects:
redirect_maps:
page2_2.md: 03-technical-data/specifications.md
page3_1.md: board/index.md
page3_2.md: quick-start/index.md
page4.md: programming/index.md
page4_1.md: gui/commander/the-gui.md
page5.md: 06-peripherals/index.md
page6.md: 02-safety/index.md
page7.md: theory/index.md
# One page with the whole manual (print_page/), for the PDF: hooks/pdf.py prints it with Chrome when DOCS_PDF is
# set. Must stay the last plugin.
- print-site:
add_to_navigation: false
print_page_title: "PAROL6, the whole documentation"
add_table_of_contents: true
toc_depth: 2
enumerate_headings: false
enumerate_figures: false
add_cover_page: true
add_print_site_banner: false
# The version facts of versions.yml written into the pages (the version box and the list of documents), and the
# API reference built from the Python API's source at its release tag (docs/includes/generated/api_facts.json,
# written by tools/sync_api.py).
hooks:
- hooks/versions.py
- hooks/api_pages.py
- hooks/known_issues.py # the known issues table from known_issues.yml
- hooks/llms.py # the Markdown twins, llms.txt and llms-full.txt from the content hooks' output
- hooks/figures.py # captions: standalone pictures become numbered figures (after llms.py: twins keep plain pictures)
- hooks/pdf.py # the PDF of the manual, from the print-site page, when DOCS_PDF is set
markdown_extensions:
- admonition
- attr_list
- md_in_html
- tables
- def_list
- footnotes
- abbr
- toc:
permalink: true
- pymdownx.details
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tabbed:
alternate_style: true
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.keys
- pymdownx.snippets:
base_path:
- docs/includes
check_paths: true
auto_append:
- abbreviations.md # site-wide abbreviations -> tooltips on every page
- pymdownx.arithmatex:
generic: true
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.smartsymbols
extra:
# Google Analytics 4 (one property for every docs site, the shared domain) and "Was this page helpful?" at the
# end of every page: Material's integration records the page views and sends the votes as events named
# "feedback". Both load only after the reader accepts the cookie banner (consent below).
analytics:
provider: google
property: G-1DFG9VZDEB
feedback:
title: Was this page helpful?
ratings:
- icon: material/thumb-up-outline
name: This page was helpful
data: 1
note: Thanks for your feedback!
- icon: material/thumb-down-outline
name: This page could be improved
data: 0
note: >-
Thanks for your feedback! Tell us what is missing in
<a href="https://github.com/Source-Robotics/PAROL-docs/issues/new" target="_blank" rel="noopener">an issue</a>,
or on Discord.
# The cookie banner the EU requires for Google Analytics; the analytics load only after "Accept".
consent:
title: Cookie consent
description: >-
We use cookies to see which pages are read and whether readers find what they look for.
With your consent, you help us make this documentation better.
actions:
- accept
- reject
- manage
# Comments under every page, through Giscus. All the docs sites share one Discussions home, the
# organisation's Discussions (https://github.com/orgs/Source-Robotics/discussions, source repository
# Source-Robotics/discussions), category "Manual comments": one thread per site and page, created when
# the first reader comments, answered where the questions are. The IDs are the source repository's and
# the category's; giscus.app shows them. Empty IDs: no comments are rendered. A page opts out with
# `comments: false` in its front matter. The giscus app must have access to Source-Robotics/discussions.
comments:
repo: Source-Robotics/discussions
repo_id: "R_kgDOVipxrA"
category: Manual comments
category_id: "DIC_kwDOVipxrM4DKcet"
# The published version the Markdown twins and llms.txt link to (mike publishes each build under its version).
# Markdown exports use the release from versions.yml, including on archived versions.
# The PDF of the manual (hooks/pdf.py): the file under site/, written when DOCS_PDF is set.
pdf:
file: assets/PAROL6-manual.pdf
# The version selector in the header (built by mike: one entry per published PAROL6 release + "latest").
version:
provider: mike
default: latest
alias: true
# The header's repository card per section (overrides/partials/source.html): page-URL prefix -> repository.
# A longer prefix listed later overrides a shorter one listed earlier.
repos:
- prefix: ""
name: Source-Robotics/PAROL6-Desktop-robot-arm
url: https://github.com/Source-Robotics/PAROL6-Desktop-robot-arm
- prefix: programming/
name: PCrnjak/PAROL6-python-API
url: https://github.com/PCrnjak/PAROL6-python-API
- prefix: gui/commander/
name: Source-Robotics/PAROL-commander-software
url: https://github.com/Source-Robotics/PAROL-commander-software
- prefix: reference/
name: PCrnjak/PAROL6-python-API
url: https://github.com/PCrnjak/PAROL6-python-API
social:
- icon: fontawesome/brands/github
link: https://github.com/Source-Robotics
- icon: fontawesome/brands/youtube
link: https://www.youtube.com/@source-robotics
- icon: fontawesome/brands/instagram
link: https://www.instagram.com/source_robotics/
- icon: fontawesome/brands/x-twitter
link: https://twitter.com/SourceRobotics
- icon: fontawesome/brands/linkedin
link: https://www.linkedin.com/company/source-robotics
- icon: fontawesome/brands/discord
link: https://discord.gg/prjUvjmGpZ
- icon: fontawesome/brands/tiktok
link: https://www.tiktok.com/@source.robotics
# Page status markers (front matter `status: ...`) shown as an icon in the sidebar.
status:
new: Recently added
deprecated: Deprecated
draft: Not written yet
extra_css:
- stylesheets/fonts.css # the self-hosted fonts
- stylesheets/extra.css
extra_javascript:
- javascripts/mathjax.js
- javascripts/copy-markdown.js # the "Copy this page as Markdown" button
- javascripts/joint-calculator.js # the joint units calculator on Drives, ratios and resolution
- javascripts/bom-kits.js # the kit selector on the Bill of materials
- javascripts/arm-viewer-loader.js # the 3D arm viewer, only on pages that have one
- javascripts/mathjax-loader.js # loads MathJax only on pages with a formula
- javascripts/vendor/tablesort.min.js # sortable tables (click a header); tablesort 5.3.0, served from the site
- javascripts/tablesort.js
exclude_docs: |
includes/
validation:
omitted_files: warn
absolute_links: warn
unrecognized_links: warn
nav:
- PAROL6 Robot Manual:
- index.md
- Before you start:
- Quick start:
- quick-start/index.md
- 1. Install the software: quick-start/1-software.md
- 2. Upload the firmware: quick-start/2-firmware.md
- 3. Connect and switch on: quick-start/3-connect.md
- 4. First moves: quick-start/4-first-moves.md
- About this manual: about.md
- Chapters:
- 1. Overview:
- 01-overview/index.md
- The robot system: 01-overview/robot-system.md
- What you get: 01-overview/what-you-get.md
- What you need: 01-overview/what-you-need.md
- 2. Safety:
- 02-safety/index.md
- Intended use: 02-safety/intended-use.md
- Hazards: 02-safety/hazards.md
- Emergency stop: 02-safety/emergency-stop.md
- Moving the robot by hand: 02-safety/moving-by-hand.md
- What the robot protects against, and what not: 02-safety/safety-functions.md
- Planning the cell: 02-safety/planning-the-cell.md
- 3. Technical data:
- 03-technical-data/index.md
- Specifications: 03-technical-data/specifications.md
- Joint limits and directions: 03-technical-data/joint-limits.md
- Dimensions and kinematics: 03-technical-data/kinematics.md
- Drives, ratios and resolution: 03-technical-data/drives-and-ratios.md
- Currents and temperatures: 03-technical-data/operating-temperatures.md
- 4. Installation:
- 04-installation/index.md
- Installation site: 04-installation/installation-site.md
- Mounting the robot: 04-installation/mounting.md
- Connecting: 04-installation/connecting.md
- First power-on: 04-installation/first-power-on.md
- 5. Operation:
- 05-operation/index.md
- Switching on and off: 05-operation/switching-on-off.md
- Homing: 05-operation/homing.md
- Jogging: 05-operation/jogging.md
- Running programs: 05-operation/running-programs.md
- Errors and recovery: 05-operation/errors-and-recovery.md
- Mastering: 05-operation/mastering.md
- 6. Peripherals:
- 06-peripherals/index.md
- Inputs and outputs: 06-peripherals/io.md
- Pneumatics: 06-peripherals/pneumatics.md
- CAN bus: 06-peripherals/can-bus.md
- 7. Maintenance:
- 07-maintenance/index.md
- Inspection: 07-maintenance/inspection.md
- Belts: 07-maintenance/belts.md
- Couplers and threadlocker: 07-maintenance/couplers.md
- Checking the homing: 07-maintenance/homing-check.md
- 8. Troubleshooting:
- 08-troubleshooting/index.md
- By symptom: 08-troubleshooting/by-symptom.md
- Homing failures: 08-troubleshooting/homing-failures.md
- Communication: 08-troubleshooting/communication.md
- Known issues: 08-troubleshooting/known-issues.md
- 9. Transport and storage: 09-transport.md
- Build guide:
- build/index.md
- Bill of materials: build/bill-of-materials.md
- Printing the parts: build/printing.md
- Mechanical assembly: build/mechanical-assembly.md
- Electronics and wiring: build/electronics-and-wiring.md
- Firmware and first run: build/firmware-and-first-run.md
- Appendix:
- Release notes: appendix/release-notes.md
- Versions and compatibility: appendix/compatibility.md
- Community projects: appendix/community.md
- Resources:
- Glossary: terminology.md
- Downloads and files: cad-files.md
- Control Board:
- board/index.md
- 1. Overview: board/01-overview.md
- 2. Safety: board/02-safety.md
- 3. Technical data: board/03-technical-data.md
- 4. Connectors and pinout: board/04-connectors.md
- 5. Stepper drivers: board/05-stepper-drivers.md
- 6. Inputs, outputs and E-stop: board/06-io-and-estop.md
- 7. CAN bus: board/07-can.md
- 8. Firmware: board/08-firmware.md
- 9. The test firmware: board/09-test-firmware.md
- 10. The serial protocol: board/10-serial-protocol.md
- 11. Troubleshooting: board/11-troubleshooting.md
- End effectors:
- end-effectors/index.md
- The flange: end-effectors/flange.md
- Pneumatic gripper: end-effectors/pneumatic-gripper.md
- Vacuum gripper: end-effectors/vacuum-gripper.md
- SSG-48 electric gripper: end-effectors/ssg-48.md
- MSG electric gripper: end-effectors/msg.md
- Your own tool: end-effectors/custom-tools.md
- GUI interfaces:
- gui/index.md
- The commander software:
- gui/commander/index.md
- Installation: gui/commander/installation.md
- The GUI: gui/commander/the-gui.md
- Waldo Commander (web): gui/waldo-commander.md
- Motor GUI: gui/motor-gui.md
- Programming:
- programming/index.md
- Guide:
- 1. The interfaces at a glance: programming/01-interfaces.md
- 2. The Python API:
- programming/02-python-api/index.md
- Installation: programming/02-python-api/installation.md
- The controller: programming/02-python-api/controller.md
- Clients: programming/02-python-api/clients.md
- Motion: programming/02-python-api/motion.md
- Jogging and servoing: programming/02-python-api/streaming.md
- Tools and the TCP: programming/02-python-api/tools-and-tcp.md
- I/O, delays and checkpoints: programming/02-python-api/io-and-delays.md
- Status and waiting: programming/02-python-api/status-and-waiting.md
- Errors: programming/02-python-api/errors.md
- Examples: programming/02-python-api/examples.md
- 3. RBTscript:
- programming/03-commander/index.md
- The language and its commands: programming/03-commander/rbtscript.md
- Examples: programming/03-commander/examples.md
- 4. ROS 2 and MoveIt: programming/04-ros2.md
- 5. Other interfaces: programming/05-other-interfaces.md
- 6. Troubleshooting: programming/06-troubleshooting.md
- Reference:
- reference/index.md
- Python API:
- reference/python/index.md
- Motion: reference/python/motion.md
- Jogging and servoing: reference/python/streaming.md
- Control: reference/python/control.md
- Queries: reference/python/queries.md
- Synchronization: reference/python/synchronization.md
- Tools: reference/python/tools.md
- I/O: reference/python/io.md
- Configuration: reference/python/configuration.md
- Status fields: reference/python/status.md
- Errors: reference/python/errors.md
- The controller and its environment: reference/python/controller.md
- RBTscript commands: reference/rbtscript.md
- The serial protocol: reference/serial-protocol.md
- Firmware parameters: reference/firmware-parameters.md
- Test firmware commands: reference/test-firmware.md
- Theory corner:
- theory/index.md
- Units: theory/units.md
- Joints, directions and the standby pose: theory/joints-and-poses.md
- Reference frames: theory/reference-frames.md
- Pose and orientation: theory/pose-and-orientation.md
- Forward and inverse kinematics: theory/kinematics.md
- Configurations and singularities: theory/configurations-and-singularities.md
- Workspace and reach: theory/workspace-and-reach.md
- Homing and mastering: theory/homing-and-mastering.md
- Motion profiles: theory/motion-profiles.md
- Blending: theory/blending.md
- Target, commanded and actual: theory/target-commanded-actual.md
- Control ownership: theory/control-ownership.md
- Steppers, open loop and backlash: theory/steppers-and-open-loop.md
- Further reading: theory/further-reading.md
- Support:
- Getting help: support/index.md
- Report a problem: support/report-a-problem.md
- Contributing: support/contributing.md