Merge pull request #1293 from shiltemann/training-boxes

[Training] update templates to use new, more accessible box style

planemo/training/tutorial.py

@@ -56,15 +56,15 @@
 HANDS_ON_TOOL_BOX_TEMPLATE = """
 ## Sub-step with **{{tool_name}}**
 
-> ### {{ '{%' }} icon hands_on {{ '%}' }} Hands-on: Task description
+> <hands-on-title> Task description </hands-on-title>
 >
 > 1. {{ '{%' }} tool [{{tool_name}}]({{tool_id}}) {{ '%}' }} with the following parameters:{{inputlist}}{{paramlist}}
 >
 >    ***TODO***: *Check parameter descriptions*
 >
 >    ***TODO***: *Consider adding a comment or tip box*
 >
->    > ### {{ '{%' }} icon comment {{ '%}' }} Comment
+>    > <comment-title> short description </comment-title>
 >    >
 >    > A comment about the tool or something else. This box can also be in the main text
 >    {: .comment}
@@ -73,12 +73,12 @@
 
 ***TODO***: *Consider adding a question to test the learners understanding of the previous exercise*
 
-> ### {{ '{%' }} icon question {{ '%}' }} Questions
+> <question-title></question-title>
 >
 > 1. Question1?
 > 2. Question2?
 >
-> > ### {{ '{%' }} icon solution {{ '%}' }} Solution
+> > <solution-title></solution-title>
 > >
 > > 1. Answer for question1
 > > 2. Answer for question2
@@ -136,7 +136,6 @@
 
 TUTO_HAND_ON_BODY_TEMPLATE = """
 # Introduction
-{:.no_toc}
 
 <!-- This is a comment. -->
 
@@ -163,7 +162,7 @@
 [tutorial to learn how to fill the Markdown]({{ '{{' }} site.baseurl {{ '}}' }}/topics/contributing/tutorials/\
 create-new-tutorial-content/tutorial.html)**
 
-> ### Agenda
+> <agenda-title></agenda-title>
 >
 > In this tutorial, we will cover:
 >
@@ -195,7 +194,7 @@
 
 ## Get data
 
-> ### {{ '{%' }} icon hands_on {{ '%}' }} Hands-on: Data upload
+> <hands-on-title> Data Upload </hands-on-title>
 >
 > 1. Create a new history for this tutorial
 > 2. Import the files from [Zenodo]({{ '{{' }} page.zenodo_link {{ '}}' }}) or from
@@ -235,7 +234,7 @@
 
 ***TODO***: *Consider adding a detail box to expand the theory*
 
-> ### {{ '{%' }} icon details {{ '%}' }} More details about the theory
+> <details-title> More details about the theory </details-title>
 >
 > But to describe more details, it is possible to use the detail boxes which are expandable
 >
@@ -253,7 +252,6 @@
 Consider merging some hands-on boxes to have a meaningful flow of the analyses*
 
 # Conclusion
-{:.no_toc}
 
 Sum up the tutorial and the key takeaways here. We encourage adding an overview image of the
 pipeline used.