Commit Graph
78 Commits
Author SHA1 Message Date
Laurens Valk 2d2d365fb2 doc: run instructions update
based in part on 86f341d520838c43be57dc1a62937b1b8ade0520
2019-02-25 15:40:06 +01:00
Laurens Valk 4fb31688f7 doc: install update
based in part on e1f0ae450067ece3826e454d2df93436e11f9905
2019-02-25 15:12:53 +01:00
Laurens Valk 15b2aab8a5 doc: terminology and nomenclature
- EV3 brick
- MicroPython
- microSD card
- EV3 MicroPython microSD card image
2019-02-25 14:04:21 +01:00
Laurens Valk f568e01c1f doc: Revert doc changes on master
This reverts commits
2d3a4f43369fa65f8c07bfe5ea013cac26a9a571
86f341d520838c43be57dc1a62937b1b8ade0520
e1f0ae450067ece3826e454d2df93436e11f9905
4e34704a5bd0b0774acbe7cf5167e754313c0290
2019-02-25 10:54:41 +01:00
Anton 4a9ef64658 doc/installation: fixed build issues. Sorry. 2019-02-23 19:54:18 +01:00
Anton a1d366f9c8 docs/creating&running: revised text for simplicity and ease of reading. 2019-02-23 19:13:07 +01:00
Anton 677b5b3647 docs/installation: revised text for simplicity and ease of reading. 2019-02-23 19:12:38 +01:00
Anton 082158d84a docs: explained python vs micropython in introduction. 2019-02-23 19:11:53 +01:00
Anton 3cfc1d97ee doc: makefile mac proof with abs path 2019-02-22 11:51:09 +01:00
Laurens Valk 579e46806c robotics: DriveBase import and example 2019-02-21 15:07:16 +01:00
Laurens Valk e75ad00e1c doc: file manager
doc: basic drive base example
2019-02-21 15:06:10 +01:00
Laurens Valk a5bfa06a5e robotics: basic placeholder DriveBase class 2019-02-21 12:24:25 +01:00
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