Template:TLH

From Wikibooks, open books for an open world
Jump to navigation Jump to search

TLH's Task[edit source]

This is a modified & targeted version
of the workhorse template {{TL}} with the suffix: /HowTo:_appended in the linking formation.
  • It will otherwise operate identically as does {{TL}}but for the null-argument behavior...
TLH INSTEAD will link then to the TOC page for HowTo topics: (Trainz/HowTo).
  • This no argument link is shown below:
 HowTo

This organization of HowTo topics enables default searching using 'Trainz/HowTo' prefixing—Like parent template, and many in the family of Trainz link templates, it's secondary purpose is to access it's own TOC page.

Actual template code[edit source]

[[<!--
--->{{#if:{{{1|}}}<!--
--->|Trainz/HowTo:_<!--
    --->{{#if:{{{s|{{{3|}}}}}}|/{{{1}}}#{{{s|{{{3|}}}}}} |/{{{1}}}<!--
    --->}}<!-- endif s || 3 defined
--->|<!-- else '1=' undef'd, so make TOC page link (no section capability)
    --->Trainz/HowTo<!--
--->}}<!-- endif {{{1}}} 
--->|<!-- form pretty out:
    --->{{{p|{{{s|{{{3|{{{2|{{{1|HowTo}}}}}}}}}}}}}}}<!--
--->]]

Additional usage...
The {{TL/doc}} (doc page {{/doc}}) for TL follows below:
logo
Trainz Linking Template
TOC | BeginningsFun | AM&C | Creation | InBook Refs ORP Refs:  • Index • Containers • Kinds • Tags | Appendixes  • Vers

Usage[edit source]

Note this \doc sub-page is included by more than one Trainz link templates, as representative of the family of similar templates using the same syntax to link different groups of pages.

Template {{TL}} code:

[[{{
#if:{{{1|}}}
    |{{#if:{{{s|{{{3|}}}}}}
      |Trainz/{{{1}}}#{{{s|{{{3|}}}}}}
      |Trainz/{{{1}}}
      |{{{p|{{{s|{{{3|{{{2|{{{1}}}}}}}}}}}}}}}
     }}
    |Trainz
}}]]

The above code for {{TL}} forms a link to a subpage of Trainz, with or without pipetricking, and with ability to link to a section title.  

General usage

This template forms an internal link to the Trainz wikibook with parameter {{{1}}}, and incorporates an option to access a section title on a page given the optional 3rd default parameter: {{{3}}} or just |3=somepage as well allowing for as an optional pretty-link re-title parameter '2' allowing {{{2}}} and/or '|3=sub-page/' formatted link calls ... all forming the link and all links in the wikimarkup as:

  •   [[Trainz/{{{1}}}{{#if:{{{3|}}}|#{{{3|}}}}}|{{{p|{{{3|{{{2|{{{1}}}}}}}}}}}}]] 

 

  • Users unfamiliar with wiki-markup parameter parsing, just focus on {{{2}}} or '|2=text' overriding the presented text of the link,
  • and {{{3}}}/ or '|3=sub-sub-linktext/' giving a prefix to a sub-sub-page, so {{{3}}},
if and when given, MUST HAVE a trailing '/' to form a proper link.

  Example-1, expanded paste down:

This is because all template default parameters, formally 'numbered parameters' can also be specified like this:
{{TL
 |1=Tips And Tricks
 |2=Tips
 }}
which wiki-markup language is processed exactly
the same as {{TL |Tips And Tricks |Tips }}. 
caution

When using a template such as this which forms a link, it is best to NOT use spaces between the pipe characters "|" as done for clarity above.

Spaces in the 'pretty-text' part are fine!

In-line Examples:

  • {{TL|Tips And Tricks}} links as:
[[Trainz/Tips And Tricks|Tips And Tricks]] and the other formulation:
[[/Tips And Tricks|Tips And Tricks]] both would.
But... is much easier to edit around on a page when trying to get the best prose presentation.
  • Similarly:
{{TL|Tips And Tricks|Tricks}} links as if the constructs:
[[Trainz/Tips And Tricks|Tricks]] and
[[/Tips And Tricks|Tricks]] which is perhaps part of the phrase you want.
  • Sub-subpage links will mainly be needed in the forthcoming Errorfixing series of tutorials and the Programmed Instruction (Trainz A-Z) linked progressive tutorials off their own sub-TOC base page.

Planned use of Sub-sub-pages... Better than splitting the book down the multiple tracks... we're going to make a lot of new pages in the PI tutorials! Whether for beginners or intermediate Trainzers, they'll all end in content creation and other advanced topics like TransDEM map generation anyway.