View source for Template:Framework/doc

{{Documentation subpage}}
{{esoteric}}
<!-- Categories and interwikis go at the bottom of this page. -->
This template is based upon the original [[:It:Template:Cartella|Italian version]] of template with added features imported from the [[:Fr:Modèle:Cadre1|French version]]. It is more versatile than the [[Template:Filefolder|English version]] with more user defined parameters such as customizable images, formatting and colors.

== Usage ==
{|style="background: none" width="100%" cellspacing="8" cellpadding="0"
|-
| style="width: 20em; padding:0.5em 1em; border: 1px dotted gray; background: #EFE;"|
<pre style="background:#EFE; font-weight:bold; width: 20em; overflow:auto">{{Framework
|width = 
|height = 
|title = 
|color = 
|border = 
|background = 
|cartella = 
|content = 
|link = 
|text_height = 
|logo = 
|logo_editlink = 
|px = 
|height_px = 
|footer = 
|footer_image = 
}}
</pre>
|
* '''width''': (optional) sets the width of the box, defaults to 100%.
* '''height''': (optional, blank if none) sets the height of the box.
* '''title''': (optional, blank if none) Title of the frame.
* '''color''': (optional) Used to choose one of the defined color sets. For custom sets, set color to ''user''
** '''border''': If a user defined color set is chosen, place a border color here.
** '''background''': If a user defined color set is chosen, place a background color here.
** '''cartella''': If a user defined color set is chosen, place one of the defined cartella images here.
* '''content''': Is used to insert text and pictures into the body frame.
* '''link''': (optional, blank if none) name of the item to modify (replace spaces with'_').
* '''text_height''': (Optional, no lift if anything) causes the frame height, a lift is displayed if the text requires that exceed this height.
* '''logo''': (optional, if nothing xmag.png Crystal) picture of the logo.
* '''logo_editlink''': (optional text [change] 'if none) image of the logo on the link.
* '''px''': (optional, if nothing 22px) size of the logo.
* '''height_px''': (optional, if nothing 21px) size of the logo.
* '''footer''': (optional) adds a message in the color band at the bottom of the box.
* '''footer_image''': (optional) allows you to add image in the bottom of the box, place one of the defined cartella footer images here.
|-
| style="font-weight:bold;" |General guidelines & notes:
|-
| colspan="2" |
# When adding images to the ''|cartella='' and ''|footer_image='' fields, do not include the namespace prefix (''File:'').
# When defining image sizes do not include the abbreviation for pixel (''px''}.
# User defined colors can be hex, RGB or a named HTML color.
# The gray option can be spelled either as ''gray'' or ''grey''.
|-
|}

{| style="margin-left: auto; margin-right: auto; border: 1px solid black; padding: 0.5em 1em;"
|-
| colspan="8" style="text-align:left;font-weight:bold;" | Defined color sets
|- style="text-align:center; border-bottom: 1px solid gray;"
| style="text-align:left; font-weight:bold; width:10em;" | Color name
| style="width:5em;" | Red
| style="width:5em;" | Orange
| style="width:5em;" | Yellow
| style="width:5em;" | Green
| style="width:5em;" | Blue
| style="width:5em;" | Violet
| style="width:5em;" | Gray
| style="width:5em;" | Pink
|- style="text-align:center;"
| style="text-align:left; font-weight:bold; height:5em;" | Border color
| style="background:darkred; color:white;" |Dark red<br>#8B0000
| style="background:orange;" |Orange<br>#FFA500
| style="background:gold;" |Gold<br>#FFD700
| style="background:darkgreen; color:white;" |Dark green<br>#006400
| style="background:blue; color:white;" |Blue<br>#0000FF
| style="background:blueviolet;" |Blue violet<br>#8A2BE2
| style="background:darkgray;" |Dark gray<br>#A9A9A9
| style="background:darksalmon;" |Dark salmon<br>#E9967A
|- style="text-align:center;"
| style="text-align:left; font-weight:bold; height:5em;" | Background color
| style="background:salmon" |Salmon<br>#FA8072
| style="background:gold;" |Gold<br>#FFD700
| style="background:yellow;" |Yellow<br>#FFFF00
| style="background:lightgreen;" |Light green<br>#90EE90
| style="background:lightblue;" |Light blue<br>#ADD8E6
| style="background:violet;" |Violet<br>#EE82EE
| style="background:lightgray;" |Light gray<br>#D3D3D3
| style="background:lightsalmon" |Light salmon<br>#FA8072
|-
|}
=== Cartella images ===
{{Commons cat|Cartella}}
There are over fifty defined "Cartella" images that can be used. When choosing an undefined image, just use the second part of the name in the '''|cartella''' field.<br>
{{divhide|Cartella images}}<gallery heights="30px">
<gallery>
File:Cartella grigia.jpg|Cartella grigia.jpg
File:Cartella newblue.jpg|Cartella newblue.jpg
File:Cartella newred.jpg|Cartella newred.jpg
File:Cartella newpurple.jpg|Cartella newpurple.jpg
File:Cartella newpink.jpg|Cartella newpink.jpg
File:Cartella newgreen.jpg|Cartella newgreen.jpg
File:Cartella newbrown.jpg|Cartella newbrown.jpg
File:Cartella rossa.jpg|Cartella rossa.jpg
File:Cartella arancione.jpg|Cartella arancione.jpg
File:Cartella giallo.jpg|Cartella giallo.jpg
File:Cartella verde.jpg|Cartella verde.jpg
File:Cartella blu.jpg|Cartella blu.jpg
File:Cartella viola.jpg|Cartella viola.jpg
File:Cartelle acadie.jpg|Cartelle acadie.jpg
File:Cartella grigia.jpg|Cartella grigia.jpg.
</gallery>
{{divhide|end}}

== Example ==
<pre>
{{Framework
| width         = 75%
| title         = [[Template:Framework/doc | Image ]]...
| content       =
{{POTD wikipedia |float=left |title=yes |thumb=yes}}
{{Lorem ipsum}}
| color         = red
| text_height   = 300px
| logo          = Nuvola camera.svg
| logo_editlink = Nuvola apps kedit.png
| px            = 25
| link          = Template:Framework/doc
}}
</pre>

{{Framework
| width         = 75%
| title         = [[Template:Framework/doc | Image]]...
| content       =
{{POTD wikipedia|float=left|title=yes|thumb=yes}}
{{Lorem ipsum}}
| color         = red
| text_height   = 300px
| logo          = Nuvola camera.svg
| logo_editlnk  = Nuvola apps kedit.png
| px            = 25
| link          = Template:Framework/doc
}}

=== Other examples ===

{| style="background: none; width:66.6%;" cellspacing="8" cellpadding="0"
|-
| Footer message
| Footer image
| Combined footer message & image
|-
| style="vertical-align:top; width:33.3%;" |{{Framework
| title   = Example 2
| content = {{tlx|Framework |footer{{=}}Example}}
| footer  = This is an example of a footer message
}}
| style="vertical-align:top; width:33.3%;" |{{Framework
| title         = Example 3
| content       = {{tlx|Framework |footer_image{{=}}image.gif}}
| footer_image  = NeveFooter.gif
}}
| style="vertical-align:top; width:33.3%;" |{{Framework
| title         = Example 4
| content       = {{tlx|Framework |footer{{=}}Example<br>|footer_image{{=}}image.gif}}
| footer        = This is an example of a footer message
| footer_image  = NeveFooter.gif
}}
|-
| User defined fields
|-
| style="vertical-align:top;" colspan="3" |{{Framework
| title         = Example 5
| color         = user
| border        = black
| background    = gray
| cartella      = blu (darker)
| content       = {{tlx|Framework |color{{=}}user |border{{=}}black |background{{=}}gray |cartella{{=}}blu (darker)}}
}}
|-
| style="vertical-align:top;" colspan="3" |{{Framework
| title         = Example 5
| color         = user
| border        = black
| background    = gray
| cartella      = blu (darker)
| link          = template:Framework/Doc
| content       = {{tlx|Framework |color{{=}}user |border{{=}}black |background{{=}}gray |cartella{{=}}blu (darker) |link{{=}}/Doc}}
}}
|-
|}

=== Different colors ===
{| style="background: none; width:66.6%;" cellspacing="8" cellpadding="0"
|-
| style="width:33.3%;" |{{Framework |color=red |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}red|link{{=}}/Doc}}}}
| style="width:33.3%;" |{{Framework |color=orange |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}orange|link{{=}}/Doc}}}}
| style="width:33.3%;" |{{Framework |color=yellow |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}yellow|link{{=}}/Doc}}}}
|-
| style="width:33.3%;" |{{Framework |color=green |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}green|link{{=}}/Doc}} }}
| style="width:33.3%;" |{{Framework |color=blue |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}blue|link{{=}}/Doc}} }}
| style="width:33.3%;" |{{Framework |color=violet |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}violet|link{{=}}/Doc}}}}
|-
| style="vertical-align:top; width:33%;" |{{Framework |color=pink |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}pink|link{{=}}/Doc}} }}
| style="width:33.3%;" |{{Framework |color=gray |title=title |link=template:Framework/Doc |content={{tlx|Framework|color{{=}}gray|link{{=}}/Doc}}}}
|-
|}

=== Without "edit" link ===
{| style="background: none; width:66.6%; vertical-align:top;" cellspacing="8" cellpadding="0"
|-
|style="width:33.3%;"|{{Framework |color=red |title=title |content={{tlx|Framework|color{{=}}red}}}}
|style="width:33.3%;"|{{Framework |color=orange |title=title |content={{tlx|Framework|color{{=}}orange}}}}
|style="width:33.3%;"|{{Framework |color=yellow |title=title |content={{tlx|Framework|color{{=}}yellow}}}}
|-
|{{Framework |color=green |title=title |content={{tlx|Framework|color{{=}}green}} }}
|{{Framework |color=blue |title=title |content={{tlx|Framework|color{{=}}blue}} }}
|{{Framework |color=violet |title=title |content={{tlx|Framework|color{{=}}violet}}}}
|-
|{{Framework |color=pink |title=title |content={{tlx|Framework|color{{=}}pink}} }}
|{{Framework |color=gray |title=title |content={{tlx|Framework|color{{=}}gray}}}}
|-
|}
This template is not recommended articles.

== See also ==
{{Window templates}}

<includeonly>{{Sandbox other||
<!-- Categories go here -->
[[Category:Folder templates]]
}}</includeonly>