Michel2/pybricks-api
1
0
Fork 0
mirror of https://github.com/pybricks/pybricks-api.git synced 2026-09-12 01:24:17 +00:00
Code Issues Releases Activity
66 Commits 10 Branches 125 Tags
822877c4161bcaaaf5e45a95e9abf3eeada0b170
Commit Graph
66 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Laurens Valk 822877c416 doc: fix svg reference 
fixes #124 (I think)
 2019-02-21 09:23:34 +01:00
David Lechner 97d8536862 doc: move introduction before toctree 
This fixes the introduction text appearing at the end of the pdf doc instead of at the begining. Also use rubric directive instead of sections so that these headings don't appear in the TOC (and mess up the heading levels).

https://stackoverflow.com/q/25276415/1976323
 2019-02-20 20:07:19 -06:00
David Lechner df432d5252 doc: use project name and version for latex(pdf) file name 2019-02-20 18:59:55 -06:00
David Lechner c3b5e52b5b doc: allow branding of project name 2019-02-20 18:58:35 -06:00
David Lechner 79b2ded6f2 doc: fix dobule copyright in generated html docs 
the html docs already include the copyright symbol and the word "Copyright", so we ended up with "© Copyright Copyright © 2018-2019 The Pybricks MicroPython Authors. "

drop it from the _COPYRIGHT setting and add it back into the disclaimer in the latex generated doc
 2019-02-20 18:50:51 -06:00
David Lechner 1bca2706af doc: add dummy empty toctree directive 
This adds an empty toctree directive with the caption "Table of Contents" so that the latexpdf build says "Table of Contents" on the TOC instead of "Getting Started".
 2019-02-20 18:36:08 -06:00
David Lechner 6ca0465322 docs: drop autogenerated comment 
this doesn't tell us anything useful, so remove it
 2019-02-20 18:31:56 -06:00
Laurens Valk 443e986d82 doc: very rough run instructions 2019-02-20 21:39:41 +01:00
Laurens Valk a7913baffc doc: draft text for install page 
and EV3 brick usage instruction pictures
 2019-02-19 21:18:19 +01:00
Laurens Valk 93fd0d7289 doc: images for run with brickman 2019-02-19 17:02:27 +01:00
Laurens Valk 302e8e6e2b doc: test inclusion of getting started example 2019-02-19 15:57:43 +01:00
Laurens Valk 712ea78576 doc: store instructions 2019-02-19 15:21:08 +01:00
Laurens Valk c9a53e8236 doc: getting started images 2019-02-19 12:43:38 +01:00
David Lechner 2b67a3a10d doc: integrate image rendering into makefiles 
This makes it so that `make -C doc` works to build all of the docs in a single command.

there are still a few problems with this:
1. the build does not fail if the correct fonts are not found
2. the images are only generated via the makefile, so trying to build the docs by other methods won't work
 2019-02-08 13:25:55 -06:00
Laurens Valk 0423530af6 doc: create build directory for images with labels 2019-02-08 13:25:40 +01:00
Laurens Valk 924e866539 doc: separate images and labels 
- remove quick draft images
- push plain screenshots and separate plain text svg files
- Update label content based on user feedback
- Cleaner label layout
- Use same fonts in labels as in text + better scaling
- basic automation of inkscape in travis; this probably needs some work. It  should at least be moved into the make doc instead
 2019-02-08 12:54:57 +01:00
Laurens Valk 0f6656ada1 doc: signal types 
fixes #111
 2019-02-07 12:29:42 +01:00
Laurens Valk 7935a4ab57 doc: proposed API update for dc motor settings 2019-02-06 15:48:54 +01:00
David Lechner 050302d6a1 doc: add logo to footer in pdf 2019-01-30 10:43:50 -06:00
Laurens Valk 0125afd45b doc: add image and sound file enums 
fixes #94

bricks/ev3dev: static sound and image file enums
 2019-01-29 11:00:30 +01:00
David Lechner bd94558375 doc: allow branding in title via environment variable 2019-01-25 11:12:04 -06:00
David Lechner 2e392e2312 doc: enable warnings as errors 
This will let CI catch more problems. Fixes #104

Checking references had to be temporarily disabled because of temporarily disabled pages.
 2019-01-24 16:34:24 -06:00
David Lechner d3475f7870 doc: fix module index 
some modules were missing because of missing automodule directive
 2019-01-24 16:10:11 -06:00
David Lechner af6fdf9729 doc: clean up latex/pdf doc 
- Override header and footer
    - fixes warnings about even/odd pages
    - adds disclaimer for LEGO trademarks
- rename "Release" to "Version"
- new title
- remove authors
 2019-01-24 16:09:30 -06:00
Laurens Valk 25f0aa24d8 doc: remove unwritten intro 2019-01-24 16:12:38 +01:00
Laurens Valk ce1ec1cb55 doc: copyediting 2019-01-24 15:52:00 +01:00
David Lechner 2acc07d0d2 doc: update for directory name changes in examples submodule 2019-01-21 20:16:00 -06:00
David Lechner cbefc64136 doc: add some Pybricks branding 
This adds some Pybricks logos to the the generated docs .

The actual logos are quick hacks and should be revisited.
 2019-01-20 19:10:26 -06:00
David Lechner 48d795ea08 doc: add dummy file so we stop getting warnings 
This prevents warnings about the _static directory not existing. We will probably want to override something eventually, so adding an empty file rather than removing it from conf.py.
 2019-01-20 19:02:33 -06:00
Laurens Valk 18652e0639 doc: update robot arm name and references 2019-01-19 18:22:01 +01:00
Laurens Valk 1918adf7b4 doc: remove vscode instructions for first release 
add examples instead

users can use their favorite method of getting the examples or their own scripts to the brick
 2019-01-19 17:31:45 +01:00
Laurens Valk 0a8cb055b2 doc: drop features that won't be implemented for first release 
Combined with previous comments, this closes #91
 2019-01-18 17:19:19 +01:00
Laurens Valk 072ba814d7 doc: formatting 
.

Remove empty pages

a few images were falling off the page because there wasn't any body text.
 2019-01-18 16:50:07 +01:00
Laurens Valk 188dbf0e7d doc: update ev3dev link 2019-01-17 23:14:33 +01:00
Laurens Valk 98adc2edb1 doc: placeholder run diagrams 2019-01-17 21:05:13 +01:00
Laurens Valk 3b8e9bfda1 doc: very rough installation steps 2019-01-17 19:38:50 +01:00
Laurens Valk 23d5e582e3 doc: extend table of contents 2019-01-17 11:26:13 +01:00
Laurens Valk 8a133b8101 doc: test instructions 2019-01-16 21:29:19 +01:00
David Lechner cccc9f9b46 Merge branch 'travis' 2019-01-15 21:42:00 -06:00
David Lechner a15f3bc99a use versioneer for setting python package version 
https://github.com/warner/python-versioneer

😋 🍪
 2019-01-15 20:58:43 -06:00
Laurens Valk 7867704514 bricks/ev3dev: move print to tools 2019-01-13 18:37:00 +01:00
Laurens Valk 5381f528f5 extmod: Make light function and doc match 
For now, do not implement features such as brightness and patterns.
 2019-01-13 18:10:22 +01:00
Laurens Valk 9e65c7eabc extmod: implement run_until_stalled with variable limits 2019-01-12 12:02:39 +01:00
Laurens Valk 4c74eff39f doc: group motor methods by rubric 2019-01-11 09:03:18 +01:00
Laurens Valk 5327611ac0 doc: motor debug, dc, and tracking api 2019-01-10 10:31:26 +01:00
Laurens Valk 39eab3230e doc: back to explicit ev3brick and ev3devices 
(instead of brick and devices)

After internal discussion:
- This way we need to maintain only one fake API.
- Autocomplete can pick up the right brick/devices.
- Explicit is better than implicit.
 2019-01-09 14:51:41 +01:00
Laurens Valk 2f0d7ec0a2 doc: brick, sound, display, and experiment with samples 2019-01-04 15:05:17 +01:00
Laurens Valk 3da8785995 doc: rough draft EV3 brick 2019-01-03 19:44:10 +01:00
Laurens Valk 02bee5766f doc: tools 
need to test StopWatch after this modification
 2019-01-03 19:06:04 +01:00
Laurens Valk 3873a20497 doc: motor draft 2019-01-03 13:54:47 +01:00