Commit Graph
162 Commits
Author SHA1 Message Date
Laurens Valk 05ea3654ec doc/tools: link to file manager
Now that the EV3 starter guide is back, we can refer to it instead of
including a duplicate image of the ev3dev file browser.
2020-04-16 15:13:46 +02:00
Laurens Valk 2a96106a9d pybricks-projects: update data log example
Bring in update to project settings.
2020-04-16 15:09:44 +02:00
Laurens Valk d0a9e7ca95 doc/api/start_ev3: relative path for labeled image 2020-04-16 14:25:00 +02:00
Laurens Valk 82b01451b1 doc/images: add plain green sensor 2020-04-16 14:18:54 +02:00
Laurens Valk 840e45c078 doc: add placeholder Powered Up quick start guide 2020-04-16 14:13:51 +02:00
Laurens Valk 0a54671b78 doc: bring back EV3 quick start guide
This brings back, updates, and reorganizes the EV3 getting started sections.

- Brought back from older v1.0 docs
- Updated with new labeled screenshots for Visual Studio Code
- Reorganized under EV3 Quick Start heading. This lets us add a similar guide for Powered Up.
2020-04-16 14:13:51 +02:00
David Lechner e18b4370a2 doc: add html sound player for sound preview
This adds an in-browser preview for all sounds without having to
download them first.
2020-04-14 15:17:15 -05:00
David Lechner 512c1fa4b1 doc: fix duplicate thumbs up/down
Thumbs down was listed twice and in one case it had the wrong image.
2020-04-14 15:06:57 -05:00
Laurens Valk 6f8e3ba0ff doc/tools: improve datalog information
- Fix typo in example
- Explain how to upload a log file
- Show an example graph
2020-04-10 13:54:36 +02:00
Laurens Valk 5e921680ab doc/hubs: add Move Hub motor default directions 2020-04-08 11:09:30 +02:00
Laurens Valk 88ffa6c902 doc/media: add sound previews 2020-04-08 10:01:43 +02:00
Laurens Valk 3277382d03 doc/media: add ev3dev-media
Add previews for images
2020-04-08 10:01:43 +02:00
David Lechner f51a25c051 doc: add tip on Fontconfig
For users who want to understand how fonts work under the hood.
2020-04-08 09:58:13 +02:00
David Lechner 402991fce8 config: add support for inkscape 1.x
There are breaking command line option changes between 0.9.x and 1.x.
2020-04-02 20:44:36 -05:00
Laurens Valk dfbda2dd69 doc/robotics: update heading
Make it consistent with the other pages
2020-04-01 13:49:09 +02:00
Laurens Valk 01e3466ed5 doc/index: add link to example projects 2020-04-01 13:48:01 +02:00
Laurens Valk 85c2d28959 doc/nxtdevices: add sensor icons 2020-03-27 14:50:20 +01:00
Laurens Valk f5c3ee6ab7 doc/ev3devices: add sensor icons 2020-03-27 14:50:06 +01:00
Laurens Valk cd5e589494 doc/iodevices: add icons 2020-03-27 14:17:07 +01:00
Laurens Valk 2bdc975f8b doc/ev3devices: add motor icons with directions 2020-03-27 14:16:43 +01:00
David Lechner ffb950869c Add EV3 screen examples
This includes examples from the pybricks-projects repository
2020-03-26 13:58:02 +01:00
Laurens Valk 95e808df9d doc/pupdevices: add sensor icons
Only the ColorDistanceSensor is added to the docs for now. Other icons are included for future use.
2020-03-25 20:30:34 +01:00
Laurens Valk d6b20a962c doc/media: make module level match
ImageFile and SoundFile are located at media.ev3dev, not media.
2020-03-25 20:30:34 +01:00
Laurens Valk 2e4274995d doc/messaging: extend introduction.
Also drop separate, nearly empty Mailboxes page. Ultimately we may separate this page into two pieces again, but for now a single concise page is clearer than two incomplete pages.
2020-03-25 20:30:34 +01:00
Laurens Valk 9e1134b4e9 doc/messaging: add simpler diagram
also restyle to match examples included in the docs.
2020-03-25 20:30:34 +01:00
Laurens Valk a308524289 doc/hubs: add hub icons to toggle menu
Also add icons for hubs we might support one day.
2020-03-25 20:30:33 +01:00
Laurens Valk 3b61cc81d2 doc/pupdevices: dc motors with default directions 2020-03-25 20:30:33 +01:00
Laurens Valk 73a41beeb4 doc/pupdevices: add motors with default directions 2020-03-25 20:27:51 +01:00
David Lechner 87c2b6857f api: Use leading _ to hide internals in intellisense
Intellisense in VS Code (both jedi and ms python language server) picks
up all imported names and suggests them with equal priority for
code completion. By adding a leading underscore, intellisense lists
these with a lower priority, so they don't get in the way.

Also rename from builtins to _common while we are touching this to
better reflect the intention of the module (it contains types shared
by multiple modules, not builtin types like int).
2020-03-25 20:24:32 +01:00
Laurens Valk ada50328bb doc/pupdevices/Motor: fix reset_angle
The note about absolute angle support had accidentally ended up in the GyroSensor. It applies only to pupdevices.Motor.
2020-03-24 16:25:06 +01:00
Laurens Valk 3b76bbc424 config: add link to home page and downloads 2020-03-20 16:10:33 +01:00
Laurens Valk c78f4b04f9 config: fix pybricks logo
Use anti-aliasing
On blue backgrounds like rtd, logo is white and transparent
2020-03-20 15:58:20 +01:00
Laurens Valk a827491b2b doc/pupdevices: doc ColorDistanceSensor.remote() 2020-03-20 11:13:52 +01:00
Laurens Valk d36b5b0ed8 doc/nxtdevices: remove note about old touch sensor
Special treatment is no longer necessary; if no such touch sensor is detected, the port switches to analog mode.

This means that it will work for both touch sensor types, as well as custom switches.
2020-03-20 10:26:26 +01:00
Laurens Valk aa343d017f doc/robotics: add note for when to change settings 2020-03-17 15:47:54 +01:00
Laurens Valk 1158e4e45a api/builtins/Motor: separate methods for stop
stop(Stop.COAST)
stop(Stop.BRAKE)
stop(Stop.HOLD)

becomes

stop()
brake()
hold()

This is easier to type and remember.
2020-03-17 15:19:55 +01:00
David Lechner abe24cf289 api/builtin: add missing DCMotor.stop() method
This was missing. It also has a different default value
from the Motor class, so Motor overrides this method.
2020-03-12 12:52:27 -05:00
David Lechner cab16f6af7 api/media/ev3dev: add Image/screen save method
This was overlooked previously.
2020-03-06 12:59:42 -06:00
Laurens Valk ffae01fd0c config: move project specifics to own conf.py
Each target doc build can have it own parameters.
2020-03-05 14:07:31 +01:00
Laurens Valk a1dce8e50e config: use doc agnostic paths for images
Allow files like messaging .rst to be included without having to copy the images.
2020-03-05 13:05:34 +01:00
Laurens Valk 3c317967af config: separate make target for diagrams
Separate the build step and commit the output to the repository. This way the docs can be built on platforms that do not have inkscape, such as readthedocs.

pipenv run make -C doc diagrams
pipenv run make -C doc html
2020-03-04 11:49:21 +01:00
Laurens Valk 862f881d33 config: rename _images to diagram_source
Make it clear what it really is.
2020-03-04 11:40:34 +01:00
Laurens Valk 95ee2fa885 doc: remove unused images 2020-03-04 11:32:37 +01:00
Laurens Valk 921fd74896 doc/messaging: fix typo in server/client diagram 2020-03-02 10:31:23 +01:00
David Lechner c76395d07f doc/media/ev3dev: sort images and sounds
Put image and sound files in alphabetical order. Exception made for
sorting numbers by numerical order.
2020-02-26 19:06:44 -06:00
Laurens Valk 5288a7e75d doc/iodevices/Ev3devSensor: add links and examples 2020-02-25 10:29:40 +01:00
Laurens Valk a426d412bb doc/iodevices: add preliminary warning 2020-02-20 16:29:13 +01:00
Laurens Valk a0fba6c2d1 api/builtins/Control: Move stalled to control
This is a control status property, so move it to the control class. This way, it is hidden from the common motor methods, and DriveBases will be able to use it too.
2020-02-17 13:55:45 +01:00
Laurens Valk 9db7e95959 api/robotics: DriveBase: rename settings args
Make it explicit that these arguments affect only the settings for the corresponding methods.

Also rephrase a few docstrings to make them easier to read or fix typos.
2020-02-17 13:43:48 +01:00
Laurens Valk 9c6d2267bd api/nxtdevices/ColorSensor: add rgb and light
also, remove detection of brown color, because this is not supported
2020-02-14 19:26:05 +01:00