Difference between revisions of "Template:Box"

From Trinity Desktop Project Wiki
Jump to navigation Jump to search
m (Added 1px black outline)
m (Changed icon size to 36px)
 
(7 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
'''Template:Box''' is a general-purpose template meant to display Wikipedia-style boxes with information such as warnings about the content of a page.
 
'''Template:Box''' is a general-purpose template meant to display Wikipedia-style boxes with information such as warnings about the content of a page.
   
  +
More specific box templates include:
See the [[Template:Outdated]] template for an example of its usage.
 
  +
* [[Template:TipBox]], for displaying '''notices''', '''tips''' and '''miscellaneous information''';
  +
* [[Template:WarningBox]], for displaying '''warnings''' and '''important notes''';
  +
* [[Template:SafeBox]], for displaying '''validating information''' (e.g. see [[Template:Applicable to TDE]]).
  +
  +
These more specific templates should be preferred when possible to directly using this template.
  +
  +
  +
== Usage ==
   
 
To use this template, use <code><nowiki>{{Box|caption=...|text=...|icon=...|background=...|highlight=...}}</nowiki></code> on the target page.
 
To use this template, use <code><nowiki>{{Box|caption=...|text=...|icon=...|background=...|highlight=...}}</nowiki></code> on the target page.
 
* <code>caption</code> ''(optional)'' is the box caption;
 
* <code>caption</code> ''(optional)'' is the box caption;
 
* <code>text</code> ''(required)'' is the box contents;
 
* <code>text</code> ''(required)'' is the box contents;
* <code>icon</code> ''(optional)'' is the icon displayed by the text ("Messagebox_info.png" by default);
+
* <code>icon</code> ''(optional)'' is the icon displayed by the text (default: [[:File:Gear.png]]);
* <code>background</code> ''(optional)'' is the background color (#D9D1FF by default);
+
* <code>background</code> ''(optional)'' is the background color (default: <tt>gainsboro</tt>);
* <code>highlight</code> ''(optional)'' is the highlight color (#4A80FF by default).
+
* <code>highlight</code> ''(optional)'' is the highlight color (default: <tt>gray</tt>).
   
 
Using this template on a page results in a box being placed.
 
Using this template on a page results in a box being placed.
   
==Example==
+
== Examples ==
  +
  +
  +
<syntaxhighlight lang="html+handlebars">
  +
{{Box
  +
|caption=Hello, TDE Wiki!
  +
|text=This is a box.
  +
}}
  +
</syntaxhighlight>
  +
  +
{{Box
  +
|caption=Hello, TDE Wiki!
  +
|text=This is a box.
  +
}}
  +
  +
  +
----
   
 
<syntaxhighlight lang="html+handlebars">
 
<syntaxhighlight lang="html+handlebars">
Line 32: Line 56:
 
|highlight=#4C8ACE
 
|highlight=#4C8ACE
 
}}
 
}}
</noinclude><includeonly><div style='background-color: {{{background|#D9D1FF}}}; outline: 1px solid #000000; border: solid 2px {{{highlight|#4A80FF}}}; border-left: solid 5px {{{highlight|#4A80FF}}}; padding: 2px 5px; min-height: 48px;'>
+
</noinclude><includeonly><div style="background: {{{background|gainsboro}}}; display: flex; border: solid 1px black; min-height: 36px; margin: 5px 0;">
[[File:{{{icon|Messagebox_info.png}}}|left|48px]]<div style='font-size:1.15em; font-weight: bold;'>{{{caption}}}</div>{{{text}}}</div><br/></includeonly>
+
<div style="padding: 8px 5px; background: linear-gradient(to right, {{{highlight|gray}}}, {{{background|gainsboro}}});">[[File:{{{icon|Gear.png}}}|link=|36px]]</div><div style="padding: 2px 5px; flex-grow: 1;"><div style="font-size:1.15em; font-weight: bold; border-bottom: dotted 1px #000000;">{{{caption}}}</div>{{{text}}}</div></div></includeonly>

Latest revision as of 13:48, 21 April 2022

Template:Box is a general-purpose template meant to display Wikipedia-style boxes with information such as warnings about the content of a page.

More specific box templates include:

These more specific templates should be preferred when possible to directly using this template.


Usage

To use this template, use {{Box|caption=...|text=...|icon=...|background=...|highlight=...}} on the target page.

  • caption (optional) is the box caption;
  • text (required) is the box contents;
  • icon (optional) is the icon displayed by the text (default: File:Gear.png);
  • background (optional) is the background color (default: gainsboro);
  • highlight (optional) is the highlight color (default: gray).

Using this template on a page results in a box being placed.

Examples

{{Box
 |caption=Hello, TDE Wiki!
 |text=This is a box.
}}
Gear.png
Hello, TDE Wiki!
This is a box.



{{Box
 |caption=Welcome to the Trinity Desktop Project Wiki!
 |text=The Trinity Desktop Environment (TDE) project is a feature rich desktop environment for Unix-like operating systems with a primary goal of retaining a traditional, efficient and productive user interface.
 |icon=TDE Logo.png
 |background=#ABCBF0
 |highlight=#4C8ACE
}}
TDE Logo.png
Welcome to the Trinity Desktop Project Wiki!
The Trinity Desktop Environment (TDE) project is a feature rich desktop environment for Unix-like operating systems with a primary goal of retaining a traditional, efficient and productive user interface.