Template:TutorialInfo: Difference between revisions

From FreeCAD Documentation
No edit summary
Line 5: Line 5:
! class="ctOdd"|Topic
! class="ctOdd"|Topic
|-
|-
| class="ctEven"|{{{Class}}}
| class="ctEven"|{{{Topic}}}
|-
|-
! class="ctOdd"|Level
! class="ctOdd"|Level
Line 36: Line 36:


The minimum code required for this template usage is: (sample result to right)
The minimum code required for this template usage is: (sample result to right)
{{TutorialInfo|Class=SampleClass|Level=Beginner|FCVersion=0.14.3700 or greater}}
{{TutorialInfo|Topic=SampleTopic|Level=Beginner|FCVersion=0.14.3700 or greater}}
<pre><nowiki>
<pre><nowiki>
{{TutorialInfo
{{TutorialInfo
|Topi=SampleTopic
|Class=SampleClass
|Level=Beginner
|Level=Beginner
|FCVersion=0.14.3700 or greater
|FCVersion=0.14.3700 or greater
Line 46: Line 46:
===Minimum Parameters===
===Minimum Parameters===
The following parameters are used in the format [parameter]=[value], with each parameter in the list separated by a pipe symbol (|):
The following parameters are used in the format [parameter]=[value], with each parameter in the list separated by a pipe symbol (|):
;Class : The subcategory of this tutorial. Proposed classes are: 2D Drafting, Modeling, Rendering.
;Topic : The subcategory of this tutorial. Proposed topics are: 2D Drafting, Modeling, Rendering.
;Level : Experience level required to complete this tutorial: Beginner, Intermediate, Advanced.
;Level : Experience level required to complete this tutorial: Beginner, Intermediate, Advanced.
;FCVersion : The FreeCAD version used in the creation of this tutorial. This should be the current stable version at the moment of writing.
;FCVersion : The FreeCAD version used in the creation of this tutorial. This should be the current stable version at the moment of writing.
Line 60: Line 60:
<pre><nowiki>
<pre><nowiki>
{{TutorialInfo
{{TutorialInfo
|Class=
|Topic=
|Level=
|Level=
|Time=
|Time=
Line 71: Line 71:
<pre><nowiki>
<pre><nowiki>
{{TutorialInfo
{{TutorialInfo
|Class=2D Drafting/Modeling/Rendering
|Topic=2D Drafting/Modeling/Rendering
|Level=Beginner/Intermediate/Advanced
|Level=Beginner/Intermediate/Advanced
|Time=
|Time=

Revision as of 16:56, 20 February 2016

Tutorial

Topic
{{{Topic}}}
Level
{{{Level}}}
Time to complete
Not provided
Author
Not provided
FreeCAD version
0.14.3700 or greater
Example File(s)
None


Usage

This Template is the main anchor on documenting Tutorials. It should be inserted as the first line in new documents.

The minimum code required for this template usage is: (sample result to right)

Tutorial

Topic
SampleTopic
Level
Beginner
Time to complete
Not provided
Author
Not provided
FreeCAD version
0.14.3700 or greater
Example File(s)
None


{{TutorialInfo
|Topi=SampleTopic
|Level=Beginner
|FCVersion=0.14.3700 or greater
}}

Minimum Parameters

The following parameters are used in the format [parameter]=[value], with each parameter in the list separated by a pipe symbol (|):

Topic
The subcategory of this tutorial. Proposed topics are: 2D Drafting, Modeling, Rendering.
Level
Experience level required to complete this tutorial: Beginner, Intermediate, Advanced.
FCVersion
The FreeCAD version used in the creation of this tutorial. This should be the current stable version at the moment of writing.

Optional Parameters

The following parameters are optional. If they are not included in the template code, they will default to a value of "None".

Time
The approximate time required to complete the tutorial.
Author
Author of the tutorial. A link to the author's wiki or forum profile page will allow visitors to reach him/her with questions or comments.
Files
Optional link to example files. An appropriate repository needs to be determined (GitHub or CADinet, see forum discussion

Full code

Empty:

{{TutorialInfo
|Topic=
|Level=
|Time=
|Author=
|FCVersion=
|Files=
}}

Prefilled, keep the right option

{{TutorialInfo
|Topic=2D Drafting/Modeling/Rendering
|Level=Beginner/Intermediate/Advanced
|Time=
|Author=
|FCVersion=
|Files=
}}


Localization

The code required for this template is different if you are using a localized version. For more information see the Localization page.

  • First, a localized version of this template must exist or be created.
  • The localized template must be named:
    Template:TutorialInfo/AA
    where /AA is the 2 letter code for the desired language, for example /fr = French localization.
  • The method for calling the localized TutorialInfo template in a Tutorial document is:
    {{TutorialInfo/AA|Class=SampleClass|Level=Beginner|FCVersion=>=0.14.3700}}
    where /AA is the 2 letter code for the desired language, for example /fr = French localization.
  • Make sure you add the localized version of this template to the Languages list below.