Template:Repo link/doc commit: Difference between revisions

From FlightGear wiki
Jump to navigation Jump to search
(More fixes for the 'eg2post' parameter.)
mNo edit summary
 
(8 intermediate revisions by the same user not shown)
Line 2: Line 2:
__NOTOC__
__NOTOC__
== Goal ==
== Goal ==
This template can be used when linking to summaries of commits for the [[{{{label|MISSING}}}]] {{{type|git}}} repository at SourceForge.
This template can be used when linking to summaries of commits for the [[{{{label|MISSING}}}]] {{{type|git}}} repository at SourceForge.  It is a subtemplate of the master {{tl|repo link}} template designed to link to specific version control commits.


== Usage ==
{{repo link/doc usage
{{obr}}'''{{{repo|MISSING}}} commit'''
| template                    = {{{repo|MISSING}}} commit
{{!}} commit
| commit                      = 1
{{!}} ''text'' =
| type_commit                = num
{{cbr}}
| pos_commit                  = 1
| stat_commit                = mandatory
| text                        = 1
| type_text                  = named
| short_text                  = t
| pos_text                    = 2
| sf                          = 1
| svn{{#if:{{{svn|}}}||NULL}} = {{{svn}}}
| git{{#if:{{{git|}}}||NULL}} = {{{git}}}
| break                      = 0
}}


; commit: The commit identifier to link to (mandatory).
{{repo link/doc design intro}}
 
{{repo link/doc design overview}}
; text: Optional link text.
{{repo link/doc design sourceforge commit
| label{{#if:{{{label|}}}||NULL}} = {{{label}}}
| proj                            = flightgear
| repo{{#if:{{{repo|}}}||NULL}}  = {{{repo}}}
| user                            = 0
| git{{#if:{{{git|}}}||NULL}}    = {{{git}}}
| svn{{#if:{{{svn|}}}||NULL}}    = {{{svn}}}
}}
{{repo link/doc plain text}}


== Examples ==
== Examples ==
=== Auto-generated text ===
  {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg1commit|MISSING}}}{{cbr}}
  {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg1commit|MISSING}}}{{cbr}}


{{{{{repo|MISSING}}} commit | {{{eg1commit|MISSING}}} }}
{{{{{repo|MISSING}}} commit | {{{eg1commit|MISSING}}} }}


=== User supplied text ===
  {{{eg2intro|MISSING}}} {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg2commit|MISSING}}} {{!}} text = {{{eg2text|MISSING}}}{{cbr}}{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
  {{{eg2intro|MISSING}}} {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg2commit|MISSING}}} {{!}} text = {{{eg2text|MISSING}}}{{cbr}}{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.


Line 25: Line 45:
| {{{eg2commit|MISSING}}}
| {{{eg2commit|MISSING}}}
| text = {{{eg2text|MISSING}}}
| text = {{{eg2text|MISSING}}}
}}
{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
=== Parameter alias ===
{{{eg2intro|MISSING}}} {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg2commit|MISSING}}} {{!}} t = {{{eg2text|MISSING}}}{{cbr}}{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
{{{eg2intro|MISSING}}}
{{{{{repo|MISSING}}} commit
| {{{eg2commit|MISSING}}}
| t = {{{eg2text|MISSING}}}
}}
{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
=== Numbered parameters ===
{{{eg2intro|MISSING}}} {{obr}}{{{repo|MISSING}}} commit {{!}} {{{eg2commit|MISSING}}} {{!}} {{{eg2text|MISSING}}}{{cbr}}{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
{{{eg2intro|MISSING}}}
{{{{{repo|MISSING}}} commit
| {{{eg2commit|MISSING}}}
| {{{eg2text|MISSING}}}
}}
}}
{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.
{{#if: {{{eg2post|}}} |  {{{eg2post}}} }}.

Latest revision as of 19:49, 6 March 2016

The following template description is not displayed when the template is inserted in an article.

Goal

This template can be used when linking to summaries of commits for the MISSING git repository at SourceForge. It is a subtemplate of the master {{repo link}} template designed to link to specific version control commits.

Usage

{{MISSING commit
| commit
| text       =
}}

The parameters are:

Parameter Description Abbreviated
parameter
Numbered
parameter
Status
commit The commit identifier. 1 mandatory
text Text to display as the link label. t 2 optional

Design

In this section, the following notation will be used:

Angular brackets + lower case text <xyz>
Template parameters.
Angular brackets + upper case text <XYZ>
Template constructed text.
Square brackets [xyz]
Optional text, only added if the parameter is set.
Or symbol |
The value on the left, if present, otherwise the value on the right of the symbol.

Overview

The general design is:

<cmd> <opt> [<URL> <TEXT>] <post>

Here the square brackets do not denote optional text, but will instead produce a Mediawiki link. This can be modified by setting full = 1 to produce:

<cmd> <opt> <URL> <post>


Site: SourceForge

Project page

For a normal SourceForge project page, the base URL is respectively constructed as:

https://sourceforge.net/p/flightgear/<repo>/

SourceForge git <URL>

For the svn repository type, the <URL> value will be:

https://sourceforge.net/p/flightgear/<repo>/ci/<commit>

SourceForge svn <URL>

For the svn repository type, the <URL> value will be:

https://sourceforge.net/p/flightgear/<repo>/<commit|HEAD>

SourceForge URL <TEXT>

The link text <TEXT>, if the text parameter is not set, will simply be:

MISSING commit <commit>

Or if the text parameter is supplied, the <TEXT> is simply:

<text>

Plain text

To create a URL or link as plain text and avoid external links, simply use the {{#tag:tagname|content}} magic word construct:

{{#tag:nowiki|
  {{repo link
  | full = 1
  }}
}}

https://sourceforge.net/p/flightgear/flightgear/ci/next/tree/

To use the <code> tags:

{{#tag:code|{{#tag:nowiki|
  {{repo link
  | full = 1
  }}
}}}}

https://sourceforge.net/p/flightgear/flightgear/ci/next/tree/

Examples

Auto-generated text

{{MISSING commit | MISSING}}

Template:MISSING commit

User supplied text

MISSING {{MISSING commit | MISSING | text = MISSING}}.

MISSING Template:MISSING commit .

Parameter alias

MISSING {{MISSING commit | MISSING | t = MISSING}}.

MISSING Template:MISSING commit .

Numbered parameters

MISSING {{MISSING commit | MISSING | MISSING}}.

MISSING Template:MISSING commit .

Related templates