From ab310e21cd27725c5a4a7953f55cba8721292e5f Mon Sep 17 00:00:00 2001 From: Steve Perry Date: Wed, 31 May 2017 15:53:04 -0700 Subject: [PATCH] Templates (#3949) * Update page-templates.md * Update page-templates.md * Update page-templates.md * Update page-templates.md * Update page-templates.md * Update page-templates.md * Update page-templates.md * Update page-templates.md --- docs/home/contribute/page-templates.md | 30 ++++++++++++++++++-------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/docs/home/contribute/page-templates.md b/docs/home/contribute/page-templates.md index 60a65c0a23..caf5b41d90 100644 --- a/docs/home/contribute/page-templates.md +++ b/docs/home/contribute/page-templates.md @@ -26,7 +26,7 @@ to conceptual topics that provide related background and knowledge.

To write a new task page, create a Markdown file in a subdirectory of the /docs/tasks directory. In your Markdown file, provide values for these -variables, and then include templates/task.md:

+variables:

+Then include templates/task.md like this: + +{% raw %}
...
+{% include templates/task.md %}
{% endraw %} +

In the steps section, use ## to start with a level-two heading. For subheadings, use ### and #### as needed. Similarly, if you choose to have a discussion section, start the section with a level-two heading.

@@ -74,8 +79,7 @@ Here's an interesting thing to know about the steps you just did. * See this [related task](...). {% endcapture %} -{% include templates/task.md %} - +{% include templates/task.md %} {% endraw %}

Here's an example of a published topic that uses the task template:

@@ -93,7 +97,7 @@ for deep explanations.

To write a new tutorial page, create a Markdown file in a subdirectory of the /docs/tutorials directory. In your Markdown file, provide values for these -variables, and then include templates/tutorial.md:

+variables:

+Then include templates/tutorial.md like this: + +{% raw %}
...
+{% include templates/tutorial.md %}
{% endraw %} +

In the lessoncontent section, use ## to start with a level-two heading. For subheadings, use ### and #### as needed. @@ -154,8 +163,7 @@ Here's something interesting about the code you ran in the preceding steps. * See this [related tutorial](...). {% endcapture %} -{% include templates/tutorial.md %} - +{% include templates/tutorial.md %} {% endraw %}

Here's an example of a published topic that uses the tutorial template:

@@ -172,7 +180,7 @@ tutorials.

To write a new concept page, create a Markdown file in a subdirectory of the /docs/concepts directory. In your Markdown file, provide values for these -variables, and then include templates/concept.md:

+variables:

+Then include templates/concept.md like this: + +{% raw %}
...
+{% include templates/concept.md %}
{% endraw %} +

In the body section, use ## to start with a level-two heading. For subheadings, use ### and #### as needed. @@ -209,8 +222,7 @@ To use ... * See this [related task](...). {% endcapture %} -{% include templates/concept.md %} - +{% include templates/concept.md %} {% endraw %}

Here's an example of a published topic that uses the concept template: