Difference between revisions of "Template:Definition table"

From Sugar Labs
Jump to navigation Jump to search
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>{|
+
<includeonly>{| style="font-size: 111%;" <!-- overide font-size: 90% set in main.css for table -->
{{#if:{{{1|}}}| {{!}} style="font-weight:bold; text-align:right; vertical-align:top;" {{!}} {{{1}}} {{!}}{{!}}
+
{{#if:{{{1|}}}| {{!}} style="font-weight:bold; text-align:right; vertical-align:top; width:{{{width|}}}" {{!}} {{{1}}} {{!}}{{!}}
 
{{!}} style="vertical-align:top;" {{!}} {{{2}}}
 
{{!}} style="vertical-align:top;" {{!}} {{{2}}}
 
{{!}}-}}
 
{{!}}-}}
Line 150: Line 150:
 
{{!}} style="vertical-align:top;" {{!}} {{{100}}}  
 
{{!}} style="vertical-align:top;" {{!}} {{{100}}}  
 
{{!}}-}}
 
{{!}}-}}
|}{{#if:{{{101|}}}|''Definition tables only support 50 rows; additional definitions have been omitted''}}</includeonly><noinclude>
+
|}{{#if:{{{101|}}}|''Definition tables only support 50 rows; additional definitions have been omitted''}}</includeonly>
 +
 
 +
<noinclude>
 
==Usage==
 
==Usage==
 
<pre>
 
<pre>
 
{{Definition_table
 
{{Definition_table
|Word_1 | Definition one
+
|width=NNem|Word_1 | Definition one
 
|Word_2 | Definition two
 
|Word_2 | Definition two
 
...
 
...
Line 160: Line 162:
 
}}
 
}}
 
</pre>
 
</pre>
 +
 +
The <code>width=NNem</code> is an optional, named parameter used to set the Word column width.
 +
: Examples: <code>|width=12em|</code> or <code>|width=12%|</code>
 +
This avoids the use of non-breaking spaces (&amp;nbsp;) to keep word groups from wrapping in the first column.
  
 
==Sample==
 
==Sample==
 
{{Definition_table
 
{{Definition_table
|Definition&nbsp;list | A [[Help:Editing#Sections.2C_paragraphs.2C_lists_and_lines| definition list]] is used for creating lists of definitions.  The term is rendered in bold, left-aligned, on its own line, and the definition appears, indented, on the following line(s).  Definitions in definition lists are limited to single line formatting, though newlines can be inserted with <nowiki><br></nowiki> tags.
+
|Definition&nbsp;list | A [[Wiki_Team/Guide/Formatting#Lists | definition list]] is used for creating lists of definitions.  The term is rendered in bold, left-aligned, on its own line, and the definition appears, indented, on the following line(s).  Definitions in definition lists are limited to single line formatting, though newlines can be inserted with <nowiki><br></nowiki> tags.
 
|Definition&nbsp;table | A definition table is used anywhere one wishes to organize blocks of content according to specific key terms, without creating separate section headers for each.  The term is rendered in bold, right-aligned, in the first column of the table, and the second column contains the definition or other content.  The content may contain any wiki formatting desired, excluding tables, and may contain multi-line formatting such as lists.
 
|Definition&nbsp;table | A definition table is used anywhere one wishes to organize blocks of content according to specific key terms, without creating separate section headers for each.  The term is rendered in bold, right-aligned, in the first column of the table, and the second column contains the definition or other content.  The content may contain any wiki formatting desired, excluding tables, and may contain multi-line formatting such as lists.
 
}}
 
}}
 +
 
==Limitations==
 
==Limitations==
 
* Definition tables support a maximum of 50 rows.  If more rows are supplied, a warning will appear on the page, indicating that additional rows have been omitted.
 
* Definition tables support a maximum of 50 rows.  If more rows are supplied, a warning will appear on the page, indicating that additional rows have been omitted.

Latest revision as of 10:40, 9 May 2010


Usage

{{Definition_table
|width=NNem|Word_1 | Definition one
|Word_2 | Definition two
...
|Word_n | Definition n
}}

The width=NNem is an optional, named parameter used to set the Word column width.

Examples: |width=12em| or |width=12%|

This avoids the use of non-breaking spaces (&nbsp;) to keep word groups from wrapping in the first column.

Sample

Definition list A definition list is used for creating lists of definitions. The term is rendered in bold, left-aligned, on its own line, and the definition appears, indented, on the following line(s). Definitions in definition lists are limited to single line formatting, though newlines can be inserted with <br> tags.
Definition table A definition table is used anywhere one wishes to organize blocks of content according to specific key terms, without creating separate section headers for each. The term is rendered in bold, right-aligned, in the first column of the table, and the second column contains the definition or other content. The content may contain any wiki formatting desired, excluding tables, and may contain multi-line formatting such as lists.


Limitations

  • Definition tables support a maximum of 50 rows. If more rows are supplied, a warning will appear on the page, indicating that additional rows have been omitted.
  • Since definition tables use wiki table formatting, tables in the content blocks must begin on a new line.
  • When using a list (beginning with * or #) on the first line of a content block, one must insert a newline between the pipe (|) following the term and the list character, or the first list item won't be properly formatted.
  • Content blocks within a definition table cannot be individually edited (though this is by design).