Extension:NumerAlpha
![]() Release status: beta |
|
---|---|
Implementation | Tag , Parser function |
Description | Provides methods of inserting incrementing numbers, letters, and roman numerals into pages. |
Author(s) | Thierry G. Veilleux (Kronoxttalk) |
Latest version | 0.7.0 (2020-01-25) |
MediaWiki | 1.25+ |
Database changes | No |
Composer | mediawiki/numer-alpha |
License | The Unlicense |
Download | |
|
|
Quarterly downloads | 7 (Ranked 165th) |
Translate the NumerAlpha extension if it is available at translatewiki.net | |
The NumerAlpha extension adds methods of inserting incrementing numbers, letters, and roman numerals into pages. You can reset the count at any moment or begin to a specified number.
First this extension was to supplement the Page Forms extension allowing to add a numbered table when you use the multiple option but you can also use it in templates by utilizing either the {{#tag: in |}}
magic word or the {{#counter:}}
parser function after v0.6.0 of this extension.
UsageEdit
There are three forms:
- a zero(s) padded number. (you can configure in the source code the length of your zero padded number. (0 = no zero padding)
- Roman numeral (i, ii, iii, iv, etc.)
- alphabetic (a,b,...,z,aa,ab,...,zz,...)
TagsEdit
- <in />
- <ir />
- <ia />
all of them in combination with reset=1 or begin=1
See examples.
Parser functionEdit
{{#counter: Counter name | type = Counter type | set = Number }}
Available counter types are "numeral", "alpha" and "roman".
ExamplesEdit
TagsEdit
- Example 1
You can reset it using the parameter reset, and restart the count with the parameter begin
<ir /> <ir /> <ir /> <ir /> <ir /> <ir /> <ir /> <ir /> <ir /> <ir /> <ir reset=1 /> <ir /> <ir /> <ir /> <ir /> <ir /> <ia /> <ia /> <ia /> <ir begin=10 /> <ir /> <ir /> <ir />
That will be render like
i ii iii iv v vi vii viii ix
i ii iii iv v
a b c
x xi xii xiii
So it's easy to list the alphabet:
<ia reset=1 /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia /><ia />
abcdefghijklmnopqrstuvwxyz
- Example 2
<ia>hello</ia> <ia>world</ia> <ia reset=1>goodbye</ia> <ia>world</ia> <ia begin=11>jupiter</ia> <ia>jazz</ia>
<in>hello</in> <in>world</in> <in reset=1>goodbye</in> <in>world</in> <in begin=11>jupiter</in> <in>jazz</in>
<ir>hello</ir> <ir>world</ir> <ir reset=1>goodbye</ir> <ir>world</ir> <ir begin=11>jupiter</ir> <ir>jazz</ir>
Parser functionEdit
- Wikitext (since version 0.6.0)
{{#counter: ExampleCounter |type=numeral |set=9 }}
{{#counter: ExampleCounter }}
{{#counter: ExampleCounter }}
- Result
9
10
11
|type=numeral
and |set=1
to the first call to the "counter" parser function of the page. If you do not do this the "counter" parser function will increment its number throughout the pages of whole wiki using it. - Wikitext (since version 0.7.0)
{{#counter: list-with-levels |level prefix=: }} Start lev 1
{{#counter: }} Stay lev 1
{{#counter: |level=2 }} Jump to lev 2
{{#counter: }} Stay lev 2
{{#counter: |level=1 }} Drop to lev 1
{{#counter: |level=2 }} back to lev 2
{{#counter: |level=3 }} jump to lev 3
- Result
- 1
- 2
- 1
- 2
- 1
- 3
- 1
- 1
- 1
This allows you to have hierarchical lists. Furthermore, if you add "format=outline" to the first #counter you can get output like:
- 1
- 2
- 2.1
- 2.2
- 2.1
- 3
- 3.1
- 3.1.1
- 3.1.1
- 3.1
InstallationEdit
- Download and place the file(s) in a directory called
NumerAlpha
in yourextensions/
folder. - Add the following code at the bottom of your
LocalSettings.php
:wfLoadExtension( 'NumerAlpha' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
To users running MediaWiki 1.34 or earlier:
The instructions above describe the new way of installing this extension using wfLoadExtension()
.
If you need to install this extension on these earlier versions (MediaWiki 1.34 and earlier), instead of wfLoadExtension( 'NumerAlpha' );
, you need to use:
require_once "$IP/extensions/NumerAlpha/NumerAlpha.php";
See alsoEdit
- Extension:ID Generator - Generates incremental numeric IDs unique per wiki
This extension is included in the following packages and/or wiki farms: This is not an authoritative list. Some wiki farms/hosts may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |