Lihat sumber bagi Templat:Sidenote/doc

{{documentation subpage}}
{{#switch:{{ROOTPAGENAME}}
|Sidenotes begin=|Sidenotes end=|Sidenotes flush={{div-based-template}}
|#default={{span-based-template}}{{templatestyles|Template:Sidenote/styles.css|Template:Sidenote/styles page ns.css}}
}}

==About==
Templates {{tl|Right sidenote}}, and {{tl|Left sidenote}} are used to create a text in which notes appear to the side of the text, rather than as footnotes at the end. Both templates are based on {{tl|Sidenote}}.

These templates are compatible with [[Help:Layout|dynamic layouts]]. Thus, the way notes are rendered in mainspace partly depends on the layout. [[H:Page styles|Index-based CSS]] can also be used to target the sidenotes using the {{CSS|.wst-sidenote}} class.

==Usage==
Usage is as follows:

*In the '''Page Namespace''', {{tl|Sidenotes begin}} should be placed in the header of the page, and {{tl|Sidenotes end}} in the footer, in order to create margins. (Note: these templates will be deprecated in the future, as css style properties will be imported from the index page)
*In the '''main namespace''', these templates are no longer necessary.

{| class="wikitable"
|+ Parameters for {{tl|Sidenotes begin}}
! Parameter
! Mandatory
! Definition
! Default
|-
|1||No|| Unused, temporarily retained for access to {{parameter|2}} || —  
|-
|2||No||Width of left and right margin to apply(measured in em values) ||11  
|-
|side||No||Side of page to place a sidenotes column (options: <code>left</code>, <code>right</code>, <code>both</code>) || <code>both</code>
|}

{{tl|Right sidenote}} is used to create a sidenote appearing to the right of the text.  

{| class="wikitable"
|+ Parameters for {{tl|Right sidenote}}
! Parameter
! Mandatory
! Definition
! Default
|-
| 1
| Yes
| The text to appear at the right, possibly including wiki markup.
|
|-
| 2
| No
| The css style of the note 
|
|}

{{tl|Left sidenote}} is used to create a sidenote appearing to the left of the text.

{| class="wikitable"
|+ Parameters for {{tl|Left sidenote}}
! Parameter
! Mandatory
! Definition
! Default
|-
| 1
| Yes
| The text to appear at the left, possibly including wiki markup.
|
|-
| 2
| No
| The css style of the note 
| 
|}


Example:
*[[The Solar System/Chapter 1]] (try the different layouts to check how notes are rendered in each of them)

=== Tracking categories ===

* [[:Category:Sidenotes begin with override width]]: if {{tl|sidenotes begin}} used with a width

<includeonly>
[[Category:Sidenotes templates]]
{{#switch:{{ROOTPAGENAME}}
|Sidenotes begin=|Sidenotes end=|Sidenotes flush=[[Category:Opening and closing templates]]
|#default=
}}
</includeonly>

{{templatedata header}}
{{#switch:{{ROOTPAGENAME}}
|Sidenotes begin=|Sidenotes flush=<templatedata>
{
	"params": {
		"2": {
			"aliases": [
				"2"
			],
			"label": "2",
			"description": "Width of margin used"
		},
		"side": {
			"label": "side",
			"suggestedvalues": [
				"left, right "
			]
		},
		"align": {
			"label": "Align"
		}
	}
}
</templatedata>
|Sidenotes end=
|#default=<templatedata>
{
	"params": {
		"1": {
			"label": "1",
			"description": "Text of the side-note to apply.",
			"required": true
		},
		"2": {
			"label": "2",
			"description": "Additional CSS styles to apply to sidenote"
		},
		"class": {
			"label": "class",
			"description": "CSS class to apply to sidenote"
		},
		"size": {
			"label": "size",
			"description": "Font sizing of the sidenote (CSS Units)"
		},
		"height": {
			"label": "height",
			"description": "Line height of sidenote (CSS units)",
			"type": "string"
		},
		"align": {
			"label": "alignment",
			"description": "Text alignment of the sidenote.",
			"suggestedvalues": [
				"left",
				"right",
                "center"
			]
		},
        "side": {
        	"label": "side",
            "description": "Which side of the page the sidenote is on.",
            "suggestedvalues": [
				"left",
				"right"
			]
        },
        "demospace": {
        	"label": "demospace",
            "description": "For testing purposes, the namespace.",
            "suggestedvalues": [
				"Page",
				"Template"
			]
        }
	}
}
</templatedata>
}}