Hi,

currently thematic tutorials are made of examples and straightforward
application exercises. I would like to propose non-trivial exercises, so
that we should propose a solution or some hints. However, the solution
should not be readable at the first look of the page, but still accessible
by the user. 

I was thinking of:

- having some additional EXERCISE/QUESTION/SOLUTION/ANSWER/HINT sections
  similar to EXAMPLES/TESTS, for which SOLUTION/ANSWER/HINT are folded by
  default.

- having a HIDDEN_TOPIC sphinx directive similar to TOPIC which leads to a
  folded block by default (TOPIC directive is used for exercises e.g. in
  
http://doc.sagemath.org/html/en/thematic_tutorials/tutorial-comprehensions.html)

- putting solutions in a separate file and make links to it (through it
  links might be a bit fastidious to maintain). I currently do this for my
  tutorials (basically i write a worksheet with solutions, and when it is
  ready, i remove the solutions and produce a second worksheet).

- you might have your own workflow for such a situations, which i am
  interested in.

It would be wonderful if this could work with sphinx (online doc) as well
as in ipynb (obtained with "sage -rst2ipynb" command) for indepentent
jupyter worksheets to be distributed to students.

I opened https://trac.sagemath.org/ticket/22508 for that, but i am clearly
incompetent and do not see any way to achieve that. So, any help or
suggestion would be very welcome !

Ciao,
Thierry

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.

Reply via email to