Template:Website commit

From relax wiki
Revision as of 08:21, 27 October 2017 by Bugman (talk | contribs) (Creation of the {{website commit}} template by copying {{relax commit}}.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

{{website commit}}: Missing parameter commit

Template documentation

Goal

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

Usage

{{website commit
| commit
| text       =
}}

The parameters are:

Parameter Description Abbreviated
parameter
Numbered
parameter
Status
commit The commit identifier (git hash). This defaults to HEAD. 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/nmr-relax/website/

SourceForge git <URL>

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

https://sourceforge.net/p/nmr-relax/website/ci/<commit>

SourceForge URL <TEXT>

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

website 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/nmr-relax/code/ci/master/tree/

To use the <code> tags:

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

https://sourceforge.net/p/nmr-relax/code/ci/master/tree/

Examples

Auto-generated text

{{website commit | 831561}}

website commit 831561

User supplied text

Updated to {{website commit | f1d540 | text = relax version 4.0.1}}.

Updated to relax version 4.0.1 .

Parameter alias

Updated to {{website commit | f1d540 | t = relax version 4.0.1}}.

Updated to relax version 4.0.1 .

Numbered parameters

Updated to {{website commit | f1d540 | relax version 4.0.1}}.

Updated to relax version 4.0.1 .

Related templates