الگو:گاهشمار افقی ساده
خطای اسکریپتی: پودمان «Horizontal timeline» وجود ندارد.
| نماد لوآ | خطا: هیچ پودمانی مشخص نشدهاست |
This is a Lua implementation of {{Horizontal timeline}}. It has all the functionality of the legacy one with few more features addd to it.
Parameters
Basic Plot settings
|bordr=Border of the plot|bgCol=Baground color of the plot|wdth=Width of the timeline plot. Defaults to100%, can be inpxoremtoo|caption=shows a centered text. Can be used to show legends. Intended to be used to label the axis|from=and|to=Necessary parameters which denotes the start and end of the timeline axis. The entire timeline (for the entire plot) including other type of rows are drawn to this scale.|to=may or maynot be greater than|from=. (see|inc=for more on this) If any bars described using parameters shown below lie outside these values, they will be trimmed or eliminated depending on their position.|inc=Optional Increment to be added to|from=to reach|to=and be displayed along the axis. If not specified it will be automatically calculated. If|to=is greater than|from=then|inc=should be positive and vice versa. If not the outcome is undetermined.
The rowالگو:Sub parameter
|rowالگو:Sub= specifies how horizontal rows are drawn. You can have as many rows as you want. Subscript are positive intigers. They specify where the row is rendered on the plot. Lower subscript indicate higher on the plot. That is |row3= will be above |row4=
Three differenct types of rows are possible. They are:
scale: Specifies where the axis is drawn. (how it is drawn can be found in the Scale Row section below).timeline: Specifies where and how the bars are drawn.note: Row that contains arrow marked notes to give explanations to the graph.
Generic Parameters
|height=Applies height oftimelineandnoterows.
Each of these types of rows have their own attributes specified with an hyphen. For example, the style of a rowالگو:Sub can be specified as |rowالگو:Sub-style=. Full list of available attributes and their description can be found below.
Scale Row
|axis-negativeFmt=,|axis-positiveFmt=and|axis-zeroFmt=Formatting options for Axis scale.|axis-nudge=Amount of nudge to be applied to the axis label, defaults to-1.8em.
Example Usage
Timeline Row
|rowالگو:Sub-bordertop=and|rowالگو:Sub-borderbottom=Specifies the top and bottom border for the row.|rowالگو:Sub-texttop=specifies vertical nudge for the bar labels for the entire row.|rowالگو:Sub-colour=or|rowالگو:Sub-color=specifies the row's background color.
- Note:
colourorcolorboth are acceptable variations for the whole module.
- Note:
|rowالگو:Sub-i-from=Starting point for the bar. This is optional, if not specified, will start from value specified in|from=.|rowالگو:Sub-i-to=Ending point for the bar.|rowالگو:Sub-i-text=Label for the bar.|rowالگو:Sub-i-fontsize=Font size for the label.|rowالگو:Sub-i-texttop=Vertical nudge for the label of iالگو:Sup bar.|rowالگو:Sub-i-colour=bar colour.|rowالگو:Sub-i-border=bar border (See Known Issues).
- Note on Subscripts:
|rowالگو:Sub-i-<attribute>=denotes theattributevalue for iالگو:Sup bar on the nالگو:Sup row.- Here subscript
nis a positive number used to group rows and their attributed. They may not be continious. But are displayed in ascending order. - Subscript
iis same asnbut is used to group bar on a specific row.
- Note on Subscripts:
Style Parameter of the Timeline Row
|rowالگو:Sub-style=and|rowالگو:Sub-i-style=can be used to provide row specific or bar specific styles. Those styles which repeat for every bar or for every row may be grouped into styles and be applied globally. The style prefixes can be anything other thanrow. See example below on how|styleDefault=is used to apply style common to all rows and|stylePopes=/|styleAntiPopes=are used to specify bar specific styles.
Example Usage
| Markup |
|---|
|
|
| Renders as |
|---|
|
خطای اسکریپتی: پودمان «Horizontal timeline» وجود ندارد. |
Note Row
|rowالگو:Sub-i-at=Necessary parameter. Specifies where the note is placed|rowالگو:Sub-i-text=Specifies the content of the note|rowالگو:Sub-i-shift=and|rowالگو:Sub-i-lift=Specifies the nudge applied to the note. Defaults to0em|rowالگو:Sub-i-arrow=Specifies the arrow Character. Defaults to↓
Example Usage
Note: |row1-5-lift= is missing. Same as n, i does not have to be continious.
Usage Tips
- You can use timeline inside {{navbox}} for a collapsible frame. See {{Restoration Movement Timeline graphical timeline}} for a working example.
- If {{navbox}} spoils the line spacing, it is better to use {{cot}} and {{cob}}. See {{Vietnam War graphical timeline}} for a working example.
- It is possible to render only a single row by directly calling the module as {{#invoke:Horizontal timeline | showOneRow | ...}}. See {{Geological eras}} or {{Geological periods}} for a working example.
- If you create a single row template, it can easily be embedded in a different template with different scale. The single row template will be automatically cropped to fit the parent template. See how {{Geological eras}} and {{Geological periods}} are embedded in {{Extinction events graphical timeline}}
- Different browsers have different ways of rendering. It's probably worth checking your finished timeline in at least IE, Firefox and Chrome if you are making a particularly complex timeline.
Examples
- {{Extinction events graphical timeline}}
- {{Prime Ministers of Spain - Democratic Spain graphical timeline}}
- {{Vietnam War graphical timeline}}
- {{Restoration Movement Timeline graphical timeline}}
- {{Cricket in the Great War timeline}}
- {{Portland Youth Philharmonic graphical timeline}}
- {{WikiProject Java/When graphical timeline}}
- {{Tremors Release Dates}}
Known Issues
- Left and bottom border for bars (not rows) will not render properly in old browsers which lacks support for CSS3 Box-sizing.(Refer here for full supported browser list) All mordern browsers provides at-least minimal support for this. Also only in extereme circumstances you will need to set bar border. Most of the time row border will be sufficient. Hence this should not be a problem.