Help:Templates

←Help:Contents

Templates

• 姊妹计划: 百科·图册·教科书·数据项·元

This help page will orient new Wikisource editors to the templates that are most commonly used while editing. The information about our stylistic approach for their use can be found at our style guide

See also the template category tree: Wikisource templates

Templates are shortcuts placed within sets of double curly brackets to perform various functions throughout Wikisource. As you proofread and edit texts in Wikisource, you can use templates to aid in formatting, navigation, and a variety of other tasks.

Formatting Templates

Formatting templates are used to change the way that text displays when being read.

Text Case

The case of text can be changed with {{uc}} (upper case), {{lc}} (lower case), {{small-caps}}, {{all small caps}} and {{capitalize}}.

These template apply a text transform style, but do not fundamentally change the text. This means that when you copy-paste, export as plain text, or view in an app or device without certain style capabilities, you will see the original text. Therefore, the text use should still be grammatically correct. For example:

• {{sc|mr. smith}} is wrong, but {{asc|Mr. Smith}} is correct (both appear the same: "Template:Asc")
• {{uc|london}} is wrong, but {{uc|London}} is correct (both appear as "LONDON")

The use of {{uc}}, {{lc}} and {{capitalize}} is optional and you can also use the equivalent plain text. For example, {{uc|London}} and LONDON are both acceptable.

Template	Example	Result	Copy-pastes/exports as
{{small-caps}}, {{sc}}	{{sc|Small Caps}}	Small Caps	Small Caps
{{all small caps}}, {{asc}}	{{asc|All Small Caps}}	Template:Asc	All Small Caps
{{uc}}	{{uc|uppercase}}	uppercase	uppercase
{{lc}}	{{lc|LOWERCASE}}	Template:Lc	LOWERCASE
{{capitalize}}	{{capitalize|capitalize}}	Template:Capitalize	capitalize

Text Size

All Wikisource size templates are relative to the default size. There are two kinds of sizing template: inline and block templates. Inline templates are suitable for use within a paragraph, but can't handle paragraph breaks, and do not adjust line spacing. Block templates can handle paragraph breaks, and adjust line spacing, but are not suitable for use within a paragraph, as they will cause a paragraph break.

Inline template	Block template	Size	Sample
{{xx-smaller}}	{{xx-smaller block}}	58%	Lorem ipsum dolor sit amet,
{{x-smaller}}	{{x-smaller block}}	69%	Lorem ipsum dolor sit amet,
{{smaller}}	{{smaller block}}	83%	Lorem ipsum dolor sit amet,
—	{{fine block}}	92%	Lorem ipsum dolor sit amet,
—	—	100%	Lorem ipsum dolor sit amet,
{{larger}}	{{larger block}}	120%	Lorem ipsum dolor sit amet,
{{x-larger}}	{{x-larger block}}	144%	Lorem ipsum dolor sit amet,
{{xx-larger}}	{{xx-larger block}}	182%	Lorem ipsum dolor sit
{{xxx-larger}}	{{xxx-larger block}}	207%	Lorem ipsum dolor
{{xxxx-larger}}	{{xxxx-larger block}}	249%	Lorem ipsum
Size elements
{{font-size}} manual text scaling
{{font-size-x}} also scales line height

Indenting and Alignment

Text is by default aligned left, but where it is required to manually align text to the left, use {{left}}. To float a block of text to the left without affecting text alignment within the block, use {{float left}} or {{block left}}.

To align text to the right, use {{right}}. To float a block of text to the right without affecting text alignment within the block, use {{float right}} or {{block right}}.

To center text, use {{center}} (or {{c}}). To float a block of text to the center without affecting text alignment within the block, use {{block center}}.

Template	Example	Result
{{left}}	{{left|this text<br/>is left justified}}	this text is left justified
{{center}}, {{c}}	{{center|this text<br/>is center justified}}	this text is center justified
{{right}}	{{right|this text<br/>is right justified}}	this text is right justified
{{block left}}, {{float left}}	{{block left|this block of text<br/>is left justified}}	this block of text is left justified
{{block center}}	{{block center|this block of text<br/>is center justified}}	this block of text is center justified
{{block right}}, {{float right}}	{{block right|this block of text<br/>is right justified}}	this block of text is right justified

To indent the first line of a paragraph, the template {{text-indent}} is available. Use {{nodent}} to "un-indent" a paragraph within the block. Note replicating indented paragraphs is typically not done in works transcribed here, and paragraphs are separated by a blank line.

To indent every line of a paragraph except the first, use {{hanging indent}} (or {{hi}}) or {{outdent}}. To indent a block of text left, the template {{left margin}} is available. Template {{dent}} combines the functionality of {{left margin}}, {{text-indent}} and {{hi}}

To insert a fixed gap in text, use {{gap}}

Template	Example	Result
{{text-indent}}, {{nodent}}	Template:Monospace block	This paragraph of text has its initial line indented. This is not standard practice. Only use where there is a specific reason to do so.This paragraph, and any following paragraphs, will also have its initial line indented. Template:Nodent
{{hanging indent}}, {{hi}}, {{outdent}}	{{outdent|This paragraph of text has a hanging indent, often used on long entries in tables or lists}}	Template:Outdent
{{left margin}}	{{left margin|2em|This block of text is indented left 2 "ems", to offset it from the main body}}	Template:Left margin
{{dent}}	{{dent|4em|-2em|This block of text is formatted with both a left margin and a hanging indent}}	This block of text is formatted with both a left margin and a hanging indent

Character formatting

To drop the initial character of a paragraph, use {{dropinitial}}. To replicate a large initial character that does not descend into the paragraph, use {{largeinitial}}

To replicate a inline straight line (usually indicating missing or redacted text) use {{bar}} as multiple m-dashes sometimes render as a dashed line.

To create a large brace spanning multiple lines of text, use {{brace}} or {{brace2}}. "brace" is limited to use with or in a table, "brace2" may be used anywhere.

Some works, especially older ones, use ligatures, diacritics, and alternate letterforms. Whether or not to transcribe this formatting is left up to the transcriber. These characters may be hard coded, or entered with templates. Where it is desirable to replicate the long s (Template:Ls, Template:LS) in older works, templates {{long s}} or {{ls}} and {{long S}} or {{lS}} are available. Note these templates now require the addition of some lines to your CSS or Javascript pages to display. Ligatures of various letter combinations can be found in Category:Ligature templates. Templates to assist in the entering of diacritics can be found in Category:Diacritic templates

Templates {{'}}, {{(}} and {{)}} allow for the insertion of the special characters Template:', {, and } where it would otherwise be difficult or impossible due to wikimarkup.

Display of Greek quotes, etc. can be improved with the use of {{polytonic}}.

Template

Example

Result

{{dropinitial}}, {{di}}

{{di|D}}ropped initials are used quite often in many types of works

Template:Diropped initials are used quite often in many types of works

{{largeinitial}}

{{largeinitial|L}}arge initials are less common, but are usually easier to format

Template:Largeinitialarge initials are less common, but are usually easier to format.

{{bar}}

Use bar {{bar|3}} for multiple m-dashes

Use bar 3̅ for multiple m-dashes

{{brace}}

{| {{brace table parameters}}

|Foo||{{brace|r|t}}||{{tlc|brace|r|t}}
|-
|Bar||{{brace|r|s}}||{{tlc|brace|r|s}}
|-
|Spam||{{brace|r|mt}}||{{tlc|brace|r|mt}}
|-
|Eggs||{{brace|r|mb}}||{{tlc|brace|r|mb}}
|-
|Bread||{{brace|r|s}}||{{tlc|brace|r|s}}
|-
|Text||{{brace|r|m}}||{{tlc|brace|r|m}}
|-
|Text||{{brace|r|b}}||{{tlc|brace|r|b}}
|-
|Stuff||{{brace|r|ht}}||{{tlc|brace|r|ht}}
|-
|Things||{{brace|r|hb}}||{{tlc|brace|r|hb}}
|}

Foo		{{brace|r|t}}
Bar		{{brace|r|s}}
Spam		{{brace|r|mt}}
Eggs		{{brace|r|mb}}
Bread		{{brace|r|s}}
Text		{{brace|r|m}}
Text		{{brace|r|b}}
Stuff		{{brace|r|ht}}
Things		{{brace|r|hb}}

{{brace2}}

{{brace2|}} {{brace2|2}} {{brace2|4|r}} {{brace2|1|l}} {{brace2|3|l}}

$\scriptstyle {\left.{\begin{matrix}\ \end{matrix}}\right\}\,}$ $\scriptstyle {\left.{\begin{matrix}\ \\\ \end{matrix}}\right\}\,}$ $\scriptstyle {\left.{\begin{matrix}\ \\\\\ \\\ \ \end{matrix}}\right\}\,}$ $\scriptstyle {\left\{{\begin{matrix}\ \end{matrix}}\right.}$ $\scriptstyle {\left\{{\begin{matrix}\ \\\\\ \ \end{matrix}}\right.}$

{{long s}}, {{ls}}, {{long S}}, {{lS}}

minuscule long s: {{ls}}, {{lS}}

minuscule long s: Template:Ls, Template:LS

{{'}}, {{(}} and {{)}}

apostrophe: {{'}}; open and close brackets: {{(}} {{)}}

apostrophe: Template:'; open and close brackets: { };

{{polytonic}}

Normal: Οἱ ἄνθρωποι πρὸς τὸ ἀληθὲς πεφύκασιν ἱκανῶς, καὶ τὰ πλείω τυγχάνουσι τῆς ἀληθείας.

Polytonic: {{polytonic|Οἱ ἄνθρωποι πρὸς τὸ ἀληθὲς πεφύκασιν ἱκανῶς, καὶ τὰ πλείω τυγχάνουσι τῆς ἀληθείας.}}

Normal: Οἱ ἄνθρωποι πρὸς τὸ ἀληθὲς πεφύκασιν ἱκανῶς, καὶ τὰ πλείω τυγχάνουσι τῆς ἀληθείας.

Polytonic: Template:Polytonic

{{oe}}

Check out that Ph{{subst:oe}}nician pottery!

Check out that Phœnician pottery!

{{ae}}

All hail Athen{{subst:ae}}!

All hail Athenæ!

Roman Numerals

In the interest of data quality {{Roman-to-arabic}} is available to facilitate entering metadata like publication date from the original page; it eases proofreading, allowing comparison of page and text directly—also allows conversion algorithm to be audited by automated testing.

Template	Result
{{roman-to-arabic|CDLXXVI}}	Template:Roman-to-arabic
{{roman-to-arabic|MDCCLXXVI}}	Template:Roman-to-arabic
{{roman-to-arabic|MMXVIII}}	Template:Roman-to-arabic

Separations

Use {{rule}} in preference of "----" for the creation of horizontal lines spanning the page. In addition, rule can create horizontal separators of any length. For more fancy lines, {{custom rule}} is available.

For breaking up discontinuous runs of pages, for example when separating blocks of transcluded front and end matter (ex. Title Page, Dedication, Contents) to one page, use {{page break}}

Template

Example

Result

{{rule}}

{{rule}}{{rule}}

{{rule|height=4px}}{{rule}}

{{rule|5em}}

---

---

---

---

---

{{custom rule}}

{{Custom rule|sp|100|d|6|sp|10|d|10|sp|10|d|6|sp|100}}

{{custom rule|c|6|sp|40|do|7|fy1|40|do|7|sp|40|c|6}}

{{separator}}

{{separator}}

·

·

·

·

·

{{***}}

{{***}}

{{***|5|3em|char=@}}

***

@@@@@

{{page break}}

{{page break}}

Template:Page break

General formatting

Text can be colored using the {{greyed}} and {{red}} templates. Red text was often used as a highlight in older works, especially on the title page. Greyed text can be used to indicate (important) text that has been written or typed onto the original document. {{RunningHeader}} or {{rh}} creates a left justified, a centered, and a right justified block of text all on the same line, and is most often used in the Page namespace, in the header field to replicate page headers. {{gap}} is used wherever a gap of greater than one space is required.

Template	Example	Result
{{greyed}}, {{red}}, {{green}}	{{greyed|grey text}}, {{red|red text}}, {{green|green text}}	grey text, red text, green text
{{RunningHeader}} or {{rh}}	{{RunningHeader|Left text|Center text|Right text}}	Left text Center text Right text
{{gap}}	text with a{{gap|5em}}gap!	text with agap!

Column formatting

• {{multicol}}, {{multicol-break}}, {{multicol-section}}, {{multicol-end}}, this template uses a table to create multiple columns of text. You need to place the breaks explicitly, but they will never move.
• {{div col}}, {{div col end}}, which uses CSS3 properties to create columns dynamically. The reader's browser will choose where best to put the breaks, so the layout cannot be guaranteed not to change. This one is good for lists, as you don't need to worry about placing {{multicol-break}}s.

Navigation Templates

Navigation templates are used to help a reader navigate through or between texts.

Template	You type	You get	Notes
{{TOC}}	{{TOC}}	Template:TOC	Used to provide a compact TOC to an alphabetical listing.
{{AuxTOC}}	{{AuxTOC| * [[/Chapter 1/]]}}	Chapters (not listed in original) Chapter 1	Used when the work does not include an original Table of Contents.
{{TOC begin}}, {{TOC end}} and all {{TOC row....}}'s	{{TOC begin}} {{TOC row 1-1-1|...}} {{TOC end}}	Template:TOC begin Template:TOC row 2-1 Template:TOC row 1-1-1 Template:TOC row 1-1-1 Template:TOC end	Used to easily format existing TOCs in the original.

Proofreading templates

Proofreading templates are used during proofreading to manage the process of transclusion to the main namespace.

Template	You type	You get
{{page end hyphen}} or {{peh}}	First page: over{{peh}} Next page: eager	Over-eager. Use when a hyphen at the end of a page should be kept when transcluded, because the joined word should still be hyphenated in the main namespace. C.f. H:HYPHEN.
{{nop}}	{{nop}} on its own line	Used where the end of a page is also end of a paragraph.

Image templates

Template	You type	You get
{{Missing image}}	{{Missing image}}	Template:Missing image
{{Raw image}}	{{raw image|A song of the English (1909).djvu/167}}	(Upload an image to replace this placeholder.)

XXX: the above are just image maintenance templates; should include actual image templates too ...

Article-specific templates

Some templates are designed for specific articles in Wikisource. They can be found in Category:Specific article templates.

Housekeeping templates

Some templates are not designed for "inline" use in a work, but are used to keep track of things that need to be fixed or indicate the applicable licensing. Please see the following pages for these templates:

• Help:Copyright tags
• Help:Maintenance tags

User talk pages

See Wikisource:User warning templates

Unblock requests

• {{Unblock}}
• {{Unblock reviewed}}
• {{Unblock granted}}

See also

• Help:Font size templates

Template:Proofreading help navbox