Skip to content

Commit 101f06d

Browse files
fix: resolve MyST build warnings
Three warnings appear when running `myst build`: 1. basic_lessons/README.md "missing heading depth 2" — the page title is depth 1 but "Using this book" and "Contents" jumped straight to depth 3, skipping depth 2. Demote them to `##`. 2. lesson0_tutorial.md "Language is not defined for code block" — the verification {code-cell} had no language. Add `python` to the directive (``{code-cell} python``), which MyST records as the code language. 3. lesson2_tutorial.md "textEnv, Too few columns specified in the {array} column argument" — the 4x4 homogeneous transformation matrices H_a and H_a_b declared {array}{ccc} (3 columns) but have 4. Change to {cccc}. Verified with a full `myst build --execute --html`: no warnings remain. Co-authored-by: openhands <openhands@all-hands.dev>
1 parent 9c66026 commit 101f06d

3 files changed

Lines changed: 5 additions & 5 deletions

File tree

basic_lessons/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@ In this six-lesson tutorial, we start from the very basics of setting up your Py
44
then cover scalar and matricial operations in Python using `numpy`,
55
all the way until the basics of kinematic control. Until kinematic control, most is based on [@spong2020robot].
66

7-
# Using this book
7+
## Using this book
88

99
Each lesson is a [MyST text notebook](https://mystmd.org/guide/notebooks-with-markdown). Each lesson can be
1010
opened and executed with popular IDEs, such as [VSCode](https://code.visualstudio.com) and [PyCharm](https://www.jetbrains.com/pycharm/).
1111
The reader is expected to follow it sequentially.
1212

13-
# Contents
13+
## Contents
1414

1515

1616
| Number | Title and Link | Content |

basic_lessons/lesson0_tutorial.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ pip install numpy matplotlib
7171

7272
You can verify that the packages are correctly installed by running the cell below.
7373

74-
````{code-cell}
74+
````{code-cell} python
7575
import numpy as np
7676
import matplotlib
7777
import matplotlib.pyplot as plt

basic_lessons/lesson2_tutorial.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -322,7 +322,7 @@ We can also perform pose transformations using sequential right multiplications
322322

323323
For example, consider a translation in 3D along the _World_ frame, represented by the homogeneous transformation matrix below.
324324

325-
$$\mymatrix{H}^0_a = \mymatrix{H}_a = \left[\begin{array}{ccc}
325+
$$\mymatrix{H}^0_a = \mymatrix{H}_a = \left[\begin{array}{cccc}
326326
1 & 0 & 0 & 1 \\
327327
0 & 1 & 0 & 2 \\
328328
0 & 0 & 1 & 3 \\
@@ -331,7 +331,7 @@ $$\mymatrix{H}^0_a = \mymatrix{H}_a = \left[\begin{array}{ccc}
331331

332332
Consider a rotation in 3D about the _current_ frame, represented by the homogeneous transformation matrix below.
333333

334-
$$\mymatrix{H}^a_b = \left[\begin{array}{ccc}
334+
$$\mymatrix{H}^a_b = \left[\begin{array}{cccc}
335335
\cos{\theta_{ab}} & -\sin{\theta_{ab}} & 0 & 0 \\
336336
\sin{\theta_{ab}} & \cos{\theta_{ab}} & 0 & 0 \\
337337
0 & 0 & 1 & 0 \\

0 commit comments

Comments
 (0)