bring items and figures outside of p
authordaniel watson <ozzloy@gmail.com>
Fri, 17 Jun 2016 01:48:56 +0000 (18:48 -0700)
committerdaniel watson <ozzloy@gmail.com>
Fri, 17 Jun 2016 01:48:56 +0000 (18:48 -0700)
guide/challenge-bot.scm

index f391ae4d0785f4f6ec0c94026ff0375ff8c5dea3..b0a7f2e50ab62f089fcecf733717573a8ac420ba 100644 (file)
    (p [let's attach the arduino to the deck.])
    (subsection
     :title [required materials]
-    (p [you will need the things in this picture.
-            ,(figure
-              :legend "arduino to deck / required materials"
-              (image :file
-                     "0-arduino-to-deck/0-required-materials.png"))
-            ,(itemize
-              (item [medical kit with bandages])
-              (item [safety goggles])
-              (item [drill bit \(we will determine size in a moment\)])
-              (item [drill])
-              (item [alan wrench])
-              (item [wood block])
-              (item [arduino])
-              (item [#6-32x3/8\", four of them])
-              (item [robot deck, the white thing with a grid of
-                           holes1]))]))
+    (p [you will need the things in this picture.])
+    (figure
+     :legend "arduino to deck / required materials"
+     (image :file
+            "0-arduino-to-deck/0-required-materials.png"))
+    (itemize
+     (item [medical kit with bandages])
+     (item [safety goggles])
+     (item [drill bit \(we will determine size in a moment\)])
+     (item [drill])
+     (item [alan wrench])
+     (item [wood block])
+     (item [arduino])
+     (item [#6-32x3/8\", four of them])
+     (item [robot deck, the white thing with a grid of holes])))
    (subsection
     :title [first hole]
     (subsubsection
              we will choose the biggest drill bit that fits through the
              hole on the arduino, then use that to drill holes in the
              deck.])
-     (p [here's a cross section of a screw in the deck]
-        (figure :legend "screw cross section"
-                (image :file
-                       "0-arduino-to-deck/screw-cross-section.png")))
-     (p [check
-         ,(itemize
-           (item
-            [what would happen if the drill bit were larger than the
-                  screw thread?])
-           (item
-            [what would happen if the drill bit were smaller than the
-                  screw body?]))]))
+     (p [here's a cross section of a screw in the deck])
+     (figure :legend "screw cross section"
+             (image :file
+                    "0-arduino-to-deck/screw-cross-section.png"))
+     (p [check])
+     (itemize
+      (item
+       [what would happen if the drill bit were larger than the
+             screw thread?])
+      (item
+       [what would happen if the drill bit were smaller than the
+             screw body?])))
     (subsubsection
      :title [inserting drill bit]
-     (p (figure :legend "arduino to deck / insert bit"
-                (image :file "0-arduino-to-deck/1-insert-bit.png"))
-        [insert the drill bit into the teeth of the drill.
+     (figure :legend "arduino to deck / insert bit"
+             (image :file "0-arduino-to-deck/1-insert-bit.png"))
+     (p [insert the drill bit into the teeth of the drill.
                 insert it far enough that the teeth will clamp on the
                 smooth part of the bit when they are tightened.])
-     (p (figure
-         :legend "arduino to deck / twist tighten drill teeth"
-         (image
-          :file "0-arduino-to-deck/2-twist-tighten-drill-teeth.png"))
-        [while holding the drill bit, twist end of the drill to tighten
+     (figure
+      :legend "arduino to deck / twist tighten drill teeth"
+      (image
+       :file "0-arduino-to-deck/2-twist-tighten-drill-teeth.png"))
+     (p [while holding the drill bit, twist end of the drill to tighten
                the teeth.
                make sure that the teeth end up gripping the flat part of
                the drill bit.])
-     (p [check
-         ,(itemize
-           (item
-            [where should the teeth clamp down on the drill bit?])
-           (item
-            [what would happen if the teeth tightened on the recessed
-                  part of the drill bit?]))]))
+     (p [check])
+     (itemize
+      (item
+       [where should the teeth clamp down on the drill bit?])
+      (item
+       [what would happen if the teeth tightened on the recessed
+             part of the drill bit?])))
     (subsubsection
      :title [holding drill]
      (p [hold the drill with one hand on the handle and trigger.
               black spinning part.]))
     (subsubsection
      :title [arduino placement]
-     (p [the arduino should be placed as shown in this picture.]
-        (figure :legend "arduino to deck / place arduino"
-                (image :file "0-arduino-to-deck/3-place-arduino.png")))
-     (p [here's a closeup]
-        (figure :legend "arduino to deck / place arduino closeup"
-                (image :file
-                       "0-arduino-to-deck/4-place-arduino-closeup.png"))
-        [the picture above shows where to place the arduino on the deck.
+     (p [the arduino should be placed as shown in this picture.])
+     (figure :legend "arduino to deck / place arduino"
+             (image :file "0-arduino-to-deck/3-place-arduino.png"))
+     (p [here's a closeup])
+     (figure :legend "arduino to deck / place arduino closeup"
+             (image :file
+                    "0-arduino-to-deck/4-place-arduino-closeup.png"))
+     (p [the picture above shows where to place the arduino on the deck.
              the arduino should line up with the holes on the deck.
              this alignment line is highlighted in pink.
              on the arduino, there's a hole on the top left, between the
              the blue box encloses the arduino hole and two deck holes.
              place the arduino hole mid-way between the two
              deck holes.])
-     (p [check
-         ,(itemize
-           (item
-            [should the arduino be upside-down?])
-           (item
-            [what should the upper side of the arduino align with?])
-           (item
-            [why not place the arduino up along the left side of the
-                 robot?]))]))
+     (p [check])
+     (itemize
+      (item
+       [should the arduino be upside-down?])
+      (item
+       [what should the upper side of the arduino align with?])
+      (item
+       [why not place the arduino up along the left side of the
+            robot?])))
     (subsubsection
      :title [drilling practice]
-     (p [strength check]
-        (itemize
-         (item [put on safety goggles])
-         (item [unplug drill])
-         (item [hold drill in one hand])
-         (item [point drill at the ground])
-         (item [point drill at the wall])))
-     (p [steps for drilling into wood block]
-        (itemize
-         (item [plug in the drill])
-         (item [place the drill bit in position])
-         (item [bring the drill up to full speed, and keep it at full
-                      speed while lowering and raising the drill])
-         (item [push down until the drill bit has passed through an inch
-                     of the wood block])
-         (item [keep the drill at full speed])
-         (item [stop before the drill smashes into the wood block])
-         (item [keep the drill at full speed by holding the trigger])
-         (item [bring the drill straight back up])
-         (item [hold the trigger down to keep the drill at full speed])
-         (item [once the drill is back out of the hole, let go of the
-                     trigger])))
-     (p [check
-         ,(itemize
-           (item
-            [should the drill be at full speed while the drill bit is
-                    going down into the wood and coming back up?])
-           (item
-            [how do you keep the drill at full speed?])
-           (item
-            [what would happen if the drill bit were not at full
-                  speed?])
-           (item
-            [what would happen if the drill were twisted sideways while
-                  the drill bit were in the wood?]))]))
+     (p [strength check])
+     (itemize
+      (item [put on safety goggles])
+      (item [unplug drill])
+      (item [hold drill in one hand])
+      (item [point drill at the ground])
+      (item [point drill at the wall]))
+     (p [steps for drilling into wood block])
+     (itemize
+      (item [plug in the drill])
+      (item [place the drill bit in position])
+      (item [bring the drill up to full speed, and keep it at full
+                   speed while lowering and raising the drill])
+      (item [push down until the drill bit has passed through an inch
+                  of the wood block])
+      (item [keep the drill at full speed])
+      (item [stop before the drill smashes into the wood block])
+      (item [keep the drill at full speed by holding the trigger])
+      (item [bring the drill straight back up])
+      (item [hold the trigger down to keep the drill at full speed])
+      (item [once the drill is back out of the hole, let go of the
+                  trigger]))
+     (p [check])
+     (itemize
+      (item
+       [should the drill be at full speed while the drill bit is
+               going down into the wood and coming back up?])
+      (item
+       [how do you keep the drill at full speed?])
+      (item
+       [what would happen if the drill bit were not at full
+             speed?])
+      (item
+       [what would happen if the drill were twisted sideways while
+             the drill bit were in the wood?])))
     (subsubsection
      :title [drilling the first screw hole]
      (itemize
       (item [hold the trigger down to keep the drill at full speed])
       (item [once the drill is back out of the hole, let go of the
                   trigger]))
-     (p [check
-         ,(itemize
-           (item
-            [should the drill be at full speed while the drill bit is
-                    going down into the wood and coming back up?])
-           (item
-            [what would happen if the drill bit were not at full
-                  speed?])
-           (item
-            [how do you keep the drill at full speed?]))])))
+     (p [check])
+     (itemize
+      (item
+       [should the drill be at full speed while the drill bit is
+               going down into the wood and coming back up?])
+      (item
+       [what would happen if the drill bit were not at full speed?])
+      (item [how do you keep the drill at full speed?]))))
    (subsection
     :title [first screw]
     (subsubsection
      (p [the "#6" part of "#6-32x3/8\"" is how big around the bolt is.
              it is related to wire gauge.
              bigger numbers mean larger screws.
-             smaller numbers means smaller screws.]
-        (figure :legend "arduino to deck / #6-32 screw"
-                (image :file
-                       "0-arduino-to-deck/6-32-screw.png")))
-     (p [check
-         ,(itemize
-           (item
-            [in the motor assembly, there are #4-40x1.25\" screws.
-                are those fatter, thinner, or the same thickness as the
-                #6-32x3/8\" screws?]))])
+             smaller numbers means smaller screws.])
+     (figure :legend "arduino to deck / #6-32 screw"
+             (image :file "0-arduino-to-deck/6-32-screw.png"))
+     (p [check])
+     (itemize
+      (item
+       [in the motor assembly, there are #4-40x1.25\" screws.
+           are those fatter, thinner, or the same thickness as the
+           #6-32x3/8\" screws?]))
      (p [the "32" part of "#6-32x3/8\"" is a measurement of how close
              the threads are to each other.
              this is related to the angle of the thread, which is also
              inch of the screw body.])
      (p [the head is the flat part where some tool, like the alan
              wrench, can exert force to spin the screw.])
-     (p [check
-         ,(itemize
-           (item [how many times will the thread wrap around one inch of
-                      the screw body?])
-           (item [what about 2 inches?
-                       how many times will the thread wrap around two
-                       inches of the screw body?])
-           (item [where can a tool exert turning force on
-                        the screw?]))]))
+     (p [check])
+     (itemize
+      (item [how many times will the thread wrap around one inch of
+                 the screw body?])
+      (item [what about 2 inches?
+                  how many times will the thread wrap around two
+                  inches of the screw body?])
+      (item [where can a tool exert turning force on the screw?])))
     (subsubsection
      :title [fasten the arduino board to the deck]
      (p [first we'll put the screw into the deck just enough so the deck
               do not continue tightening after that.])
      (p [the arduino should still be flat against the deck still, just
              as it was before tightening the screw.])
-     (p [check
-         ,(itemize
-           (item [why do we insert the first screw partially before
-                      holding up the arduino?])
-           (item [which side of the deck is the top side?]))]))
+     (p [check])
+     (itemize
+      (item [why do we insert the first screw partially before
+                 holding up the arduino?])
+      (item [which side of the deck is the top side?])))
     (subsubsection
      :title [assessment of the first screw]
      (itemize
             this means minimizing rotation and translation.
             the picture below shows that the second hole should be as
             far as possible from the first hole, since that minimizes
-            rotation.]
-        (figure
-         :legend "arduino to deck / keep holes far apart"
-         (image
-          :file "0-arduino-to-deck/keep-holes-far-apart.png"))))
+            rotation.])
+     (figure
+      :legend "arduino to deck / keep holes far apart"
+      (image
+       :file "0-arduino-to-deck/keep-holes-far-apart.png")))
     (subsubsection
      :title [drilling and attaching second screw]
      (p [to drill the second hole, follow the same steps as drilling the
              glue dots.
              glue dots can be placed easily, are good at attaching flat
              surfaces that directly touch and do not get much stress.])
-   (p (figure
-       :legend "breadboard to deck / required materials"
-       (image
-        :file "1-breadboard-to-deck/0-required-materials.png"))
-      [for this section, we will need the deck with arduino attached,
-           breadboard, and glue dots.]
-      (figure
-       :legend "breadboard to deck / video"
-       (video
-        :file "1-breadboard-to-deck/0-breadboard-to-deck.ogv"))))
+   (figure :legend "breadboard to deck / required materials"
+           (image
+            :file "1-breadboard-to-deck/0-required-materials.png"))
+   (p [for this section, we will need the deck with arduino attached,
+           breadboard, and glue dots.])
+   (figure :legend "breadboard to deck / video"
+           (video
+            :file "1-breadboard-to-deck/0-breadboard-to-deck.ogv")))
   (section
    :title [battery packs]
    (subsection