Laurens Valk
556728937f
pybricks.common.Accelerometer: Use mm/s/s units.
...
Fixes https://github.com/pybricks/pybricks-api/issues/94
For Move Hub, this is a breaking change since Move Hub IMU support
was already released. For the other hubs, the IMU API has not been
released yet, so we can do this silently.
2022-04-01 15:41:15 +02:00
Laurens Valk
813ea61308
doc/main/conf.py: Show beta features on RTD/latest.
2022-04-01 14:51:38 +02:00
Laurens Valk
243f2948ef
pybricks.hubs.primehub: Show in beta version.
...
Make it show up in the beta build and hide it in the release build.
2022-04-01 14:28:31 +02:00
Laurens Valk
81a1379781
doc/Makefile: Allow BETA=1 to include beta features.
...
Prior to every previous release, we we had to delete certain
features that did not make it into the release. This lets us
do that with a tag instead. This way we can keep a clean git
history that is easier to follow.
2022-04-01 13:39:04 +02:00
Laurens Valk
93a9370790
doc/common/extensions: Hide version directives in IDE build.
...
Version tags can be useful to keep track of new or updated features.
This lets us hide such details in the documentation that ships with the IDE to keep it concise.
2022-04-01 09:38:41 +02:00
Laurens Valk
4101f9be79
poetry: Update Sphinx and RTD-theme.
...
We were not using a proper release for sphinx-rtd-theme
in order to work around some bugs. Meanwhile, a proper
release has come out, so let's upgrade to 1.0.0.
Also bump Sphinx to 4.4.
Also update and fix workarounds for cross references.
Fixes https://github.com/pybricks/pybricks-api/issues/98 .
2022-03-22 15:38:04 +01:00
Pavel Lobodinský
616051149b
pybricks.common.Speaker: Add volume setter.
2022-01-20 08:56:29 +01:00
Laurens Valk
e69c422f83
pybricks.common.Motor: Add absolute value example.
...
Fixes https://github.com/pybricks/support/issues/611
2022-01-20 08:39:43 +01:00
Laurens Valk
0ceabe8497
pybricks.common.Charger: Document it.
2022-01-14 15:14:28 +01:00
Laurens Valk
d3ae4ec9ee
pybricks.pupdevices.ColorSensor: Move cleanup example.
...
The color sensor light is much brighter, so having an example
to turn it off is a bit more useful.
Fixes https://github.com/pybricks/pybricks-api/pull/90
2022-01-07 14:11:03 +01:00
Laurens Valk
ffb2f8aa96
pybricks.pupdevices.UltrasonicSensor: Move cleanup example.
...
Also generalize the example so that it can be used on all hubs.
2022-01-07 13:38:07 +01:00
Pavel Lobodinský
65c81834c9
pybricks.hubs.PrimeHub: Added a cleanup example.
2022-01-07 13:38:07 +01:00
Pavel Lobodinský
97002948d1
pybricks.common: Refactored Speaker API to be hub specific.
...
The Prime/Inventor Hub Speaker allows only a subset of EV3 Speaker API. Hence, splitting the API up.
2022-01-05 12:10:11 -06:00
Laurens Valk
30803fc017
pybricks.robotics.DriveBase: Add curve method.
...
This generalizes motion to curves (arcs), which is in
between straight lines and in-place turns.
2021-12-01 15:38:27 +01:00
Laurens Valk
57f6f0fbef
pybricks.pupdevices.DCMotor: Document settings method.
...
Also update changelog for recent changes.
2021-12-01 14:55:34 +01:00
Laurens Valk
06a1542613
pybricks.pupdevices.DCMotor: Document settings method.
...
See https://github.com/pybricks/support/issues/536
2021-12-01 14:40:06 +01:00
Laurens Valk
82a8f2ae89
pybricks.pupdevices.Motor: Add small motor render.
...
Fixes https://github.com/pybricks/support/issues/441
2021-11-23 08:59:44 +01:00
Laurens Valk
7d0fe9cb85
doc/common/extensions: Fix classlink.
...
Allow the link to be different from the name.
This lets us fix the link for the Inventor Hub, which was linking to a non-existent page.
2021-11-22 14:49:20 +01:00
Laurens Valk
1af876ac8f
pybricks.pupdevices.ColorLightMatrix: Fix render.
...
- Use isometric projection
- Fix broken plug
- Use correct background color
While we are at it, add colors to show which 9 colors this device supports.
2021-11-22 14:49:20 +01:00
David Lechner
a2a375cb5c
docs/pupdevices: fix broken link
...
The link to the color light matrix page was broken due to an invalid
file name.
2021-11-19 20:28:33 -06:00
David Lechner
b6d1eef2a1
pybricks.iodevices.LWP3Device: add api and docs
...
This adds docs and API stubs for pybricks.iodevices.LWP3Device.
Fixes: https://github.com/pybricks/support/issues/534
2021-11-19 19:31:53 -06:00
David Lechner
20cb5fdde5
doc: make all titles sentence case
...
This makes the casing of titles consistent throughout the docs.
Fixes: https://github.com/pybricks/pybricks-api/issues/75
2021-11-19 19:30:57 -06:00
David Lechner
2f574e8c03
pybricks.pupdevices.ColorLightMatrix: add api and docs
...
This adds the SPIKE 3x3 Color Light Matrix to the API and docs.
2021-11-19 19:30:57 -06:00
David Lechner
9d8531a85b
npm/ide-docs: move npm packaging to separate directory
...
This makes a clean separation between the packaging and the docs.
2021-11-19 19:30:57 -06:00
David Lechner
fee122cf33
CHANGELOG: move to top level
...
This makes the CHANGELOG easy to find.
2021-11-19 16:37:38 -06:00
David Lechner
f42ed06d4f
doc/main/CHANGELOG: use keepachangelog.com recommendations
...
This updates the changelog to use keepachangelog.com recommendations
to make it consistent with other Pybricks changelogs.
2021-08-30 13:29:38 -05:00
David Lechner
a8126f0bed
doc/main: fix dir in package.json
...
Another case of a missed ide to main directory.
2021-08-30 12:20:44 -05:00
David Lechner
2c4685f594
doc/main: add TAG make option
...
This splits the Sphinx tag option from SPHINXOPTS. This allows us to
specify the tag without having to remember to add -W and -t. It also
fixes not being able to specify the tag with make.bat on Windows.
While we are touching this, redundant SOURCEDIR uses are removed (main
is already the default) and the .github/workflows/publish-ide-docs.yml
script is fixed (ide directory no longer exists).
2021-08-30 12:14:34 -05:00
David Lechner
8b0f98d25b
@pybricks/ide-docs v1.6.0
2021-08-30 11:12:05 -05:00
Laurens Valk
dd2e6e8603
ubuiltins.int: Document from_bytes manually.
...
Sphinx fails to show the docsting for class methods. Since we have very few of them, it is easier to just document this one manually
Fixes https://github.com/pybricks/pybricks-api/issues/86
2021-08-22 12:15:42 +02:00
Laurens Valk
4124e1dd4e
doc/common/conf: Drop unused imports.
...
These prevent us from upgrading Sphinx and they aren't being used anyway.
Fixes e4c7e5abeb
2021-08-06 10:07:42 +02:00
Laurens Valk
d86b5584fb
ubuiltins: Type enumerate as a class.
...
This reverts commit a0ea0d8ca0 because of https://github.com/pybricks/pybricks-api/issues/72
2021-08-06 09:51:52 +02:00
Laurens Valk
1c01e981e0
usys: Clean up.
...
Add requirements, drop autodoc, and add a few cross references.
2021-08-05 16:13:50 +02:00
Laurens Valk
8a6ddf677c
pybricks.pupdevices.Remote: Light examples.
2021-08-05 14:56:00 +02:00
Laurens Valk
5d4481dbb0
pybricks.pupdevices.ColorDistanceSensor: Drop duplicate example.
2021-08-05 13:45:57 +02:00
Laurens Valk
b3c5353dd6
ubuiltins: Reorganize page.
...
Fixes https://github.com/pybricks/pybricks-api/issues/80
2021-08-05 12:32:41 +02:00
Laurens Valk
0ecf536cda
ubuiltins: Add compatibility everywhere.
...
This lets us sort everything by category or alphabetically without having to make special categories for Move Hub.
2021-08-05 12:32:37 +02:00
David Lechner
f2124615ba
ubuiltins: List decorators in separate section.
...
This moves the built-in decorators to their own section and uses
`autodecorator` to indicate they are decorators.
2021-08-05 12:32:29 +02:00
Laurens Valk
49ade9d9c6
pybricks.robotics: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
045312921e
pybricks.geometry: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
39f58b9e03
pybricks.tools: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
a0467b8d8e
doc/common/requirements: Fix image paths.
...
This ensures that the requirements directive works regardless of the depth of the document in the tree.
2021-08-05 12:32:03 +02:00
Laurens Valk
4945156d9a
pybricks.parameters: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
97b2de46ac
pybricks.hubs: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
e8d7281626
doc/common/requirements: A hub supports itself.
...
This way we can do the following, which is useful if it cannot be expressed in terms of other requirements.
.. pybricks-requirements:: movehub
A good example is on the specific hub page itself. The Move Hub requires the Move Hub.
2021-08-05 12:32:03 +02:00
Laurens Valk
979da8b170
pybricks.pupdevices: Show compatibility.
2021-08-05 12:32:03 +02:00
Laurens Valk
ac4a913be3
doc/common/requirements: Toggle hub table.
...
This makes it possible to hide/unhide the compatibility table.
It is adapted from the sphinxcontrib-contentui extension: https://github.com/ulrobix/sphinxcontrib-contentui
2021-08-05 12:32:03 +02:00
Laurens Valk
31a30f380f
doc/common/requirements: Rename to static.
...
We will work on a version that can be toggled dynamically. It will just include this static version. This keeps things simple and still lets
us use the static version as needed.
2021-08-05 12:32:03 +02:00
Laurens Valk
87dacfbf76
doc/common/extensions/requirements: Allow none.
...
With no requirements imposed, this means all hubs will work.
2021-08-05 12:32:03 +02:00
Laurens Valk
75bc15f071
ubuiltins: Add bytearray.
2021-08-05 12:32:03 +02:00