planetfederal / workshops

Workshop materials relating to open source projects that we participate in or products we support.
58 stars 62 forks source link

boundless_training theme fixes for FOSS4G #17

Open jodygarnett opened 10 years ago

jodygarnett commented 10 years ago

The boundless_training theme is great - and answers @pramsey request for a theme that "works" in a classroom setting.

Before using it at FOSS4G:

Example from point.rst:

   #. **Challenge:** Use this approach to rewrite the *Dynamic Styling* example.

      .. only:: instructor

         .. admonition:: Instructor Notes 

            Example available here :download:`point_example.css </files/point_example2.css>`
eshon commented 10 years ago

If you want spoiler annotation why not just build/share Instructor versions?

jodygarnett commented 10 years ago

Because I do not want them to see the answer until they want to check their work.

eshon commented 10 years ago

So how/where should they be placed?

jodygarnett commented 10 years ago

How about we adapt the example:

   #. **Challenge:** Use this approach to rewrite the *Dynamic Styling* example.

      .. only:: spolier

         .. admonition:: Spoiler

            Example available here :download:`point_example.css </files/point_example2.css>`

Q: Why .. only:: spoiler? So that ti can be avoid when generating PDF content? <-- not sure if we care?

eshon commented 10 years ago

This can't be automated, you'd have to go through the docs and change all references yourself when you generate the docs.

http://sphinx-doc.org/markup/misc.html?highlight=only#including-content-based-on-tags