TutorialTemplate: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{UnderConstruction|This page shows the preferred basic layout of a tutorial. It contains the standard sections and formatting to be used. Copy the whole page text to make a new tutorial.}}
{{UnderConstruction|This page shows the preferred basic layout of a tutorial. It contains the standard sections and formatting to be used. Copy the whole page text to make a new tutorial. When the tutorial is complete, remove the <nowiki>{{UnderConstruction}}</nowiki> heading.}}
[[File:tutorial_template_example_title_image.png|centre]]
[[File:tutorial_template_example_title_image.png|centre]]
<div style="float: left;">__TOC__</div>{{TutorialKey}}{{clear}}
<div style="float: left;">__TOC__</div>{{TutorialKey}}{{clear}}
Line 6: Line 6:
This is where you tell the reader something about what the tutorial does.
This is where you tell the reader something about what the tutorial does.


You should include a message telling the reader what sort of difficulty level the tutorial is for.
You should include a message telling the reader what sort of difficulty level they can expect.
 
If any part of the tutorial is difficult - or isn't explained properly - you should say so here so that the reader has a chance to back out before committing their time and effort.


=== Specific techniques used in this tutorial ===
=== Specific techniques used in this tutorial ===
 
The techniques listed here should be those that the reader will learn but shouldn't include very basic techniques such as: creating image frames, entering text, setting an outline colour etc. unless the tutorial is for complete beginners.
* First technique.
* First technique.
* Second technique.
* Second technique.
Line 17: Line 19:
Here you should tell the reader what sort of things they need to do before starting the tutorial.
Here you should tell the reader what sort of things they need to do before starting the tutorial.


For example, this might be to download a font or image to be used later.
For example, this might be to download a font or image to be used later, or they may need to download some software.
 
Try and make sure that the reader has everything they need at hand before they start the tutorial for real. This makes it easier for the reader to follow what's happening.


== First Section ==
== First Section ==


Each tutorial should be split into a number of logical sections.
Each tutorial should be split into a number of logical sections.
The name of each section should be descriptive to help anyone looking at the table of contents.


You can use the <nowiki>{{Annotation}}</nowiki> template, as below, to make some text stand out from the rest of the text.
You can use the <nowiki>{{Annotation}}</nowiki> template, as below, to make some text stand out from the rest of the text.
Line 29: Line 35:
== Second Section ==
== Second Section ==


With each section following on the the one before it.
Each section should logically follow on from the one before it, otherwise the reader could get confused.


If you want to tell the reader to use a particular window or dialog you can use the <nowiki>{{Window}}</nowiki> template, as below.
If you want to tell the reader to use a particular window or dialog you can use the <nowiki>{{Window}}</nowiki> template, as below.
Line 35: Line 41:
This is an example of using the {{Window|Window|icons}} template, and this is a {{Window|Tab}} within that window.
This is an example of using the {{Window|Window|icons}} template, and this is a {{Window|Tab}} within that window.


An <nowiki>{{InlineAnnotation}}</nowiki> template can also be used to draw the reader's attention {{InlineAnnotation|note|Like this.|outline}} which is sometimes useful.
An <nowiki>{{InlineAnnotation}}</nowiki> template can also be used to draw the reader's attention {{InlineAnnotation|technical|like this|outline}} which is sometimes useful.


== Third Section ==
== Third Section ==
Line 42: Line 48:


This is an example of using the {{Button|Button}} template.
This is an example of using the {{Button|Button}} template.
A <nowiki>{{Callout}}</nowiki> template, as below, can be used to give the reader some extra information that isn't part of the main text but could otherwise be useful.
{{Callout|tip|Beginner Tip|This is an example of a Callout.}}


== Fourth Section ==
== Fourth Section ==
Line 51: Line 61:
== Conclusion ==
== Conclusion ==


Here you can give the reader a summary of what they've done and/or give suggestions for further reading and/or experiment.
Here you can give the reader a summary of what they've done and/or give suggestions for further reading.
 
Once you get to the conclusion, the tutorial should be finished. You shouldn't add any extra instructions here unless you're suggesting that the reader experiments with some slightly different techniques.

Latest revision as of 10:06, 24 March 2015

Warning
Under Construction
This page shows the preferred basic layout of a tutorial. It contains the standard sections and formatting to be used. Copy the whole page text to make a new tutorial. When the tutorial is complete, remove the {{UnderConstruction}} heading.
Tutorial template example title image.png
Key
This article uses these graphical conventions
Tutorial template icon window.pngWindow ⟩⟩ Tab/Panel in Window
ButtonMenuChoiceKeyboard

Introduction

This is where you tell the reader something about what the tutorial does.

You should include a message telling the reader what sort of difficulty level they can expect.

If any part of the tutorial is difficult - or isn't explained properly - you should say so here so that the reader has a chance to back out before committing their time and effort.

Specific techniques used in this tutorial

The techniques listed here should be those that the reader will learn but shouldn't include very basic techniques such as: creating image frames, entering text, setting an outline colour etc. unless the tutorial is for complete beginners.

  • First technique.
  • Second technique.

Set-up

Here you should tell the reader what sort of things they need to do before starting the tutorial.

For example, this might be to download a font or image to be used later, or they may need to download some software.

Try and make sure that the reader has everything they need at hand before they start the tutorial for real. This makes it easier for the reader to follow what's happening.

First Section

Each tutorial should be split into a number of logical sections.

The name of each section should be descriptive to help anyone looking at the table of contents.

You can use the {{Annotation}} template, as below, to make some text stand out from the rest of the text.

Warning
This is an example of an Annotation. It calls the reader's attention to something that's either important or extra information. An Annotation can also have a filled background to make it stand out even more.

Second Section

Each section should logically follow on from the one before it, otherwise the reader could get confused.

If you want to tell the reader to use a particular window or dialog you can use the {{Window}} template, as below.

This is an example of using the Tutorial template icon window.pngWindow template, and this is a Tab within that window.

An {{InlineAnnotation}} template can also be used to draw the reader's attention

Warning
like this

which is sometimes useful.

Third Section

To show the reader that a button needs to be pressed you can use the {{Button}} template as shown below.

This is an example of using the Button template.

A {{Callout}} template, as below, can be used to give the reader some extra information that isn't part of the main text but could otherwise be useful.

warning
Beginner Tip
This is an example of a Callout.

Fourth Section

You can also show the reader that they should use a menu by using the {{Menuitem}} template, as below.

This is an example of using the MenuitemTemplate…

Conclusion

Here you can give the reader a summary of what they've done and/or give suggestions for further reading.

Once you get to the conclusion, the tutorial should be finished. You shouldn't add any extra instructions here unless you're suggesting that the reader experiments with some slightly different techniques.