×
Create a new article
Write your page title here:
We currently have 230 articles on Farthest Frontier. Type your article name above or create one of the articles listed here!



    Farthest Frontier

    This is the documentation page for Module:RoundN

    Usage

    This is a module for meta templates such as {{Round16}}, {{Round8}}, etc. Though originally designed for sports, it can be used to present any tree.

    Basic form:

    {{#invoke:RoundN|main|columns = [number of columns (3 columns for Round8, 4 columns for Round16, etc.)]}}

    Alternatively, the shorthand form {{#invoke:RoundN|N16}} (or any power of 2 between N2 and N512) is equivalent to {{#invoke:RoundN|main|columns = 4}}

    Parameter List

    • red parameter names are required.
    • italicized parameter names are required in some cases
    • Template:Blue parameter names involve new features not available prior to the release of this module
    Parameter name Description
    Template:TOC tab Number of columns/eliminations (3 columns for Round8, 4 columns for Round16, etc.)

    Note

    • For columns less than 4 (i.e. Round2-Round8), the 3rd Place match box is hidden by default. For columns greater or equal to 4, the 3rd Place match box is visible by default. This reflects the behavior of the templates prior to this module's release.

    Template:TOC tab While required for invoking the main function ({{#invoke:RoundN|main|columns=}}), this module has meta functions in the form of 'N##' which can call main with the right columns for you. For example, you may replace ... |main|columns = 7... with ...|N128 .... Valid for N# where # is a power of 2. You must invoke this module directly to use this (vs. a template that already has a columns value). Only works up to N512. If say N1024 ever becomes necessary, call main directly and set |columns=10.

    PS: Though adding shorthands up to N ~70 trillion would be easy, it would make unnecessary overhead as these meta functions are generated eached time this module is called (granted generating such functions up to ~70 trillion is probably less expensive than making the table for columns = 3).

    Template:TOC tab Unnamed parameters (i.e. a value not prefixed by [param_name] =) are read sequentially in groups of 5 such that:

    Example 1

    {{#invoke:RoundN|main|columns=2
    
    A|'''7'''|B|5 C A }}
     
    Semi-finalsFinal
     
          
     
    Day 1
     
     
    A7
     
    tdb
     
    B5
     
    A
     
    Day 2
     
     
     
    C
     
     
    D
     

    Placing each group of 5 on a new line is optional, but does make it easier to read. Also, consider adding the comments such as <!-- Date-Place/Team 1/Score 1/Team 2/Score 2 --> on top and <!-- Finals --> above the first group of 5 in the finals round, etc.

    Template:TOC tab Set the style parameter to add custom CSS to the table.

    Module talk:RoundN/testcases/1

    Template:TOC tab For large tables, set scroll_height to the desired height in pixels.

    Module talk:RoundN/testcases/1

    CSS units are also allowed (i.e. '20em', '30%', etc.).

    Note This works by duplicating the entire table and then using CSS to lock the clone of the table to the top of the div. Conceivably, for extremely large tables, this can result in a significant amount of extra HTML code to download versus if scroll_head_unlock is used.

    Template:TOC tab If it is desirable to have the round heading scroll with the table (such as if a larger viewing area is desired), set scroll_head_unlock to 'yes'

    Module talk:RoundN/testcases/1

    Template:TOC tab If set, boxes for the #th match group will not be shown. Most often used for playoffs or when the number of teams playing in the first round is not a power of 2.

    Module talk:RoundN/testcases/1 Template:TOC tab: The shorthand |skipmatch = 1-2;4;6-7 will do the same thing as:

    |skipmatch1=yes
    |skipmatch2=yes
    |skipmatch4=yes
    |skipmatch6=yes
    |skipmatch7=yes

    Note:

    • Unlike in the original templates, this module does not require leading zeroes in this parameter, i.e. skipmatch001 is the same as skipmatch1 (though it may make your template code easier to read if lead with an appropriate number of zeroes).
    • The 5 parameters that would have populated the skipped box will be ignored regardless of value unless omit_blanks is set to 'yes' (see below).
    • Previously, skipmatch only worked in the first round. This limitation no longer applies. (See Module talk:RoundN/testcases/3)
    Template:TOC tab If omit_blanks is set to yes, then all parameters that would have been skipped will instead be shifted to the next non-skipped box. (This is turned off by default because most templates made before the release of this module were required to use empty parameters as placeholders.)

    Module talk:RoundN/testcases/1

    Template:TOC tab The bold_winner parameter accepts either 'high' or 'low', which will automatically bold the text of the participant with the higher or lower score, respectively. In other words, set this to 'low' if the lower score wins and 'high' if the high score wins.

    Example 2

    Module talk:RoundN/testcases/2 Note:

    • If entering a score that includes non-numbersTemplate:--such as 3 (6), the Semi Final score for team C in the above exampleTemplate:--the module will first remove all non-digit characters and concatenate the rest. For example, 3 (5) and 3 (6) would be converted to 35 and 36, respectively, before being compared. This should be valid for most cases, however, you may override using the manualboldmatch## parameter.
    • If the scores are tied or contain no numbers, then neither will be bolded, however, you may still manually bold them with wikimarkup.
    • This does not remove any formatting already present.
    Template:TOC tab

    Module talk:RoundN/testcases/2


    Template:TOC tab The form manualboldmatch = 1-3;6;9-12 is also available.

    Template:TOC tab

    Set |previewnumbers = yes to show numbers next to each match group (useful for skipmatch and manualboldmatch) when viewing on the template page.

    Note that these numbers will not appear in article space.

    Template:TOC tab Use RD#, replacing # with the desired column such that 1 is the leftmost round and X is the rightmost when columns = X. For example:
    {{#invoke:RoundN|N128
    
    '''SECOND ROUND'''}}|RD7 = {{red|'''Championship'''}} | RD8 = {{red|'''So close, yet so far'''}} scroll_height=15em }}
     
    Round of 128SECOND ROUNDRound of 32Round of 16Quarter-finalsSemi-finalsChampionship
     
                              
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     So close, yet so far
     
     
     
      
     
     
     
      
     
     
     
      
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
    Round of 128SECOND ROUNDRound of 32Round of 16Quarter-finalsSemi-finalsChampionship
     
                              
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     So close, yet so far
     
     
     
      
     
     
     
      
     
     
     
      
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     

    Note RD[N+1] = Third Place, and will perform the job of the Consol parameter if the latter is omitted, i.e. RD[N+1] is ignored if Consol is true. Also, this alternate name for Consol was not available prior to the release of this module (and is provided because the module's programmer thought 'Consol' was unintuitive).

    Template:TOC tab By default, |3rdplace= is set to 'yes' when columns is greater than 3 and 'no' otherwise. Override as desired. (See Consol if you wish to rename this heading)
    {{#invoke:RoundN|main|columns=1
    
    1 }}
     
    Final
     
      
     
    1
     
     
     
     
     
     
     
    Template:TOC tab Set Consol=name to change the 'Third Place' label to 'name'. You may also use the form RD# where # = columns + 1.
    {{#invoke:RoundN|main|columns=1
    
    3rdplace=yes Consol=Runner up 1 }}
     
    Final
     
      
     
    1
     
     
     
     
     
     
     
     
     
     
     
    Runner up
     
     
     
     
     
     
     
     
     
     
    Template:TOC tab Add |color=yes
     
    Final
     
      
     
    7
     
     
    Team A3
     
     
    Team B2
     
     
     
     
     
    Third place
     
     
    8
     
     
    Team C
     
     
    Team D0
     
    • Note: When |color=yes is set, the brackets are hardcoded to be colored as shown in the example above. To color the "correct" cells, you must also activate bold_winner to either high or low. Thus allowing the module to identify and color the winners and losers correctly.

    Add |color=yes & |bold_winner=high for colored brackets when the winner is the highest scorer.

     
    Final
     
      
     
    7
     
     
    Silver medalist2
     
     
    Gold medalist3
     
     
     
     
     
    Third place
     
     
    8
     
     
     0
     
     
    Bronze medalist1
     

    Add |color=yes & |bold_winner=low for colored brackets when the winner is the lowest scorer.

     
    Final
     
      
     
    7
     
     
    Gold medalist2
     
     
    Silver medalist3
     
     
     
     
     
    Third place
     
     
    8
     
     
    Bronze medalist0
     
     
     1
     
    Template:TOC tab Add |color_repechage=yes for repechage brackets, where the winner is awarded a bronze medal.
     
    Final
     
      
     
    7
     
     
    Team A3
     
     
    Team B2
     
    • Note 1: When |color_repechage=yes is set, the brackets are hardcoded to be colored as shown in the example above. To color the "correct" cells, you must also activate bold_winner to either high or low. Thus allowing the module to identify and color the winners and losers correctly.
    • Note 2: When |color_repechage=yes is set AND the final match of the brackest is skipped, as in cases where there are two bronze medalists, all winners of the final stage visible will be colored bronze.

    Add |color_repechage=yes & |bold_winner=high for colored brackets when the winner is the highest scorer.

     
    Final
     
      
     
    7
     
     
    Team A3
     
     
    Team B2
     

    Add |color_repechage=yes & |bold_winner=low for colored brackets when the winner is the lowest scorer.

     
    Final
     
      
     
    7
     
     
    Team A3
     
     
    Team B2
     

    Add |color_repechage=yes & skip the final match of the brackets for colored brackets when there are two bronze medalists.

    RepechageBronze medal
              
    1
    Team A3
    3
    Team B2
    Team A8
    Team E7
    2
    Team C6
    4
    Team D5
    Team C10
    Team F11
    Template:TOC tab Set team-width to the desired width in pixels. (Default is 170)
    Template:TOC tab Set score-width to the desired width in pixels. (Default is 30)
    Template:TOC tab Setting |widescore=yes is basically equal to |score-width=40. Provided for compatibility. Ignored if score-width is set.
    Template:TOC tab Set score-boxes to the desired number of score boxes per match. (Default is 1). The number can be followed by + sum, which will add one more score box with the sum of all the others. For examples, see test case 5 and test case 6.
    Template:TOC tab Set |template=yes if used to create a template for a specific game (add V.T.E. link using {{navbar}}).
    Template:TOC tab Set |flex_tree=yes to make the brackets vertically more compact. That is, to have less space between matches of the same round.
    Semi-finalsFinal
          
     
     
     
     
     
     
    Template:TOC tab Set |short_brackets=yes to make the brackets horizontally more compact. That is, to have less space between matches of following rounds.
     
    Semi-finalsFinal
     
          
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     
     

    Node Functions

    For greater customization, node functions may be added to the parameter usually used for providing match information such as dates and location. Simply insert node_function{function name} in the appropriate location. A demonstration of most of the node functions can be found at RoundN/testcases/4.

    • orphan - Current node is disconnected from all other nodes (no lines will be drawn). One practical use for this may be when the winners of the previous round advance to a different tournament instead of playing each other but the losers still play a consolation match for 3rd place, as per this discussion.

    For the next three node functions, the parameters usually used for team names and scores should be omitted if these node functions are used.

    • line - Current node is omitted and replaced with a horizontal line. Text may be displayed above this line via node_function{line(text)} (at some point, the preferred format would be node_function{line}text to match the form of the canvas function though backwards compatibility would probably be maintained). If curly brackets are desired in the text, make sure to escape them with \.
    • bridge - Current node is omitted and replaced with a vertical line.
    • canvas - Current node is replaced with whatever you want via node_function{canvas}anything
    • heading - Not yet implemented. Planned node function with the form node_function{heading(name)}date/location. Makes a round name heading like for the Consol parameter, but may be placed anywhere, as per the "Elimination Rounds" of RoundN/testcases/6 (which currently renders the planned output of this function without the functions).

    Undocumented features

    Alas User:Codehydro seriously overbuilt this module and never found the time to document even half the features available. Check out the following examples which may contain some advanced features:


    Partial List of undocumented params

    • no_column_head
    • branch_upwards

    Note that some of these features may not have been documented due to incomplete implementation.


    Cookies help us deliver our services. By using our services, you agree to our use of cookies.
    Cookies help us deliver our services. By using our services, you agree to our use of cookies.