Template:File generation description

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search




 
This vector image was created with Inkscape, or with something else.
Template documentationview · edit · history · purge ]

en-1 The description below was composed by a non-native English speaker.
You are cordially invited to improve the literal quality of any textual expression.

This template allows to specify how an SVG image file was made, e.g. the used tool and other properties.

This wrapper around {{Image generation}} uses more or less self-explaining parameter names, instead of the (cryptic) short codes. Most parameters and essential features of Image generation are supported. Invocations should be descriptive, therefore no abbreviations exist (for template or parameter names).
All parameters names start with an upper case letter (and must be specified with the proper case).
Of the first four parameters:

  • SVG tool is required and Topic is most recommended,
  • W3C error count and Other fields are usefully defaulted.[clarification needed]

There are also:

  • a set of boolean (true/false) parameters which default is "no" (false);
  • the three parameters to describe a digital alteration;
  • parameters to describe possible SVG bugs;
  • parameters to format the possible display of source codes; and
  • more parameters.

Normally very few parameters will be sufficient, and only in special cases some more are needed.

Usage

{{File generation description |SVG tool= |Topic= }}

Template parameters

ParameterDescriptionDefaultStatus
SVG toolspecify the name of the SVG tool: prepended with "Created with" it gives a template name.0required
W3C error countspecify the number of errors detected by the W3C Validator (see explanation)0 (valid)optional
Other fieldsspecify either "yes" for {{InFi}} insertion, or "no" for a linefeed, or "none" (see explanation)yes *)optional
Topicspecify a description what the image shows, e.g. coa, flag, icon, logo, map (see the list below)emptysuggested
00 more parameters:0optional
Categoryspecify to change the categorizationstandardoptional
Subcategoryspecify to change the subcategorizationstandardoptional
Sortkeyspecify to change the sorting within the [sub]categoryemptyoptional
Topic-dspecify a topic for the display only (see Difference between "s" and "w")Topicoptional
Userspecify any textstring for a user (see {{U}} or {{By}})emptyoptional
Userlinkspecify a linkable user name (this parameter precedes "User")emptyoptional
Morespecify free text to be displayed.optional
Prefixspecify anything (text and/or templates) to display previouslyemptyoptional
Trailerspecify anything (text and/or templates) to display afterwardsemptyoptional
Tincturespecify a string e.g. like or/azure/gules (see Tincture); for Tincture-ss= see other shadesemptyoptional
Colorboxspecify a string of one or more color codes (see #Colorboxes)emptyoptional
Graphic labspecify an ISO 639 language code, or Commons or Workshop {see the list below}emptyoptional
Othertoolspecify the toolname when "Other tool" name is knownemptyoptional
Additionalspecify another tool which was used together with the "SVG tool"emptyoptional
Messagespecify one or more message boxesemptyoptional
Broken filespecify the description why the file is corruptedemptyoptional
Supersedesspecify the name of the superseded fileemptyoptional
Superseded byspecify the name of the superseding fileemptyoptional
00 yes–no parameters:0optional
Supersededyes when the file is inferior to another onenooptional
Commonistyes when the file was Uploaded with Commonistnooptional
Text embeddedyes (or switch) when the file contains embedded textnooptional
Text as pathyes when the file contains path textnooptional
Large fileyes when the SVG file is too large to show the source codenooptional
Easy borderyes when a border should be drawnnooptional
PGF datayes when the file contains PGF CDATA blocksnooptional
Traced SVGyes when the file is a poorly traced SVGnooptional
Bad SVGyes when the file contains raster datanooptional
Fake SVGyes when the file is a Fake SVGnooptional
Topo SVGyes when the file contains topographic raster datanooptional
Required rasteryes when the file contains required raster datanooptional
SVG 1.2yes when the file contains SVG 1.2 featuresnooptional
Topo SVGyes when the file Should be textnooptional
Fictionalyes when the image shows a fictional object, e.g. a flagnooptional
Simplified SVGyes (or pair of numbers) when the SVG code had been simplifiednooptional
Textedit onlyyes (or only/+/-) when no vector graphic editor should be used (aka No Inkscape)nooptional
Draw by handyes (or name of an example file) when a very simple SVG image should not be drawn with a toolnooptional
Vector versionyes (or name of the SVG file) when a vector version exists of that raster imagenooptional
Convert to SVGyes (or topic) when the raster image should be converted to SVGnooptional
Simple to SVGyes (or topic) when a very simple bitmap should be converted to SVGnooptional
Importantyes when the code had been created with Inkscape-Importantnooptional
00 Retouched picture parameters:0optional
Retouchespecify what has been modifiedemptyoptional
Modifierspecify the user name of the editor who has done the digital alterationemptyoptional
Originalspecify the file name of the original picture, if anyemptyoptional
00 bug description parameters:0optional
General bug
0Gaussian bug
0Compatibility bug
0Demonstration bug
0Former bug
0Overwritten bug
0Replaced bug
0Unsolved bug
0FlowRoot bug
specify descriptional text of one or more bugs








empty
empty
empty
empty
empty
empty
empty
empty
empty
optional
Technically replacedspecify the name of the replacing fileemptyoptional
00 display source code parameters: see Created with code00Three source codes can be displayed:
0 Each one of the following parameters can be postfixed with either 1, 2 or 3; the first set can also be used without the postfix "1".
0optional
Codecopy the source code which was used to generate the image0optional
Syntaxspecify one of the supported languages for highlighting0optional
Titlingspecify the titling headline to be shown above the code0optional
Collapsespecify the headline to be shown instead of the code0optional
Diffusionspecify a category diffusion to categorize "Images with Diffusion source code"0optional
Explanationspecify an explanatory text to be shown above the code0optional
Footnotespecify a footing note below of the displayed code0optional
Formatspecify a style attribute for code display0optional

Additional information

The template is intended to be used in the following namespaces: the File namespace

The template is intended to be used by the following user groups: all users

Localization

This template is not intended to be localized.

The template itself does not generate any localizable text, except an error message.

Explanation

SVG tool

Regardless of the parameter name it can also be another tool which does not, or not only, create SVG files; parameter Tool name may be used in that case.
This parameter is required and will not be defaulted. An error occurs when this parameter is missing, or when no such template exists.
The value is case sensitive. The names of all tool templates can be used, including:

(more than 100 "Created with ..." templates)
  • IA 0when Inkscape and Adobe Illustrator are used (no matter which sequence)

Validity (W3C error count)

Not setting the W3C error count parameter or setting it to 0 or v means no W3C-error or "valid". A value greater than 0 means "invalid because of .. errors". Other values:

  • For files that are not W3C-checkable, specify -1.
  • n can be set for non-SVG files (not necessary, will be set automatically)
  • s is used for SVG files that are not checked, or should not show their validation

Other fields

By default or when set to yes, includes the {{Information field}} treatment to create the field name. When set to no it performs a {{Clr}}.

An empty value (|Other fields=) or |Other fields=none does nothing.

  • recommended: when used with "other fields" of {{Information}}, do not specify it, or with "yes"
  • deprecated: when used outside of {{Information}}, or within {{Inform}}, specify it with "no" (or with "none")

Topics

This parameter should always be provided with a value, it is essential for display and for the subcategorizing.
The most frequent used "topics" can be specified by the following parameter values, all as written in singular with lower caps.
But as well all values as defined in the tables can be specified with their short codes.

Some templates default a not specified topic, e.g. BKchem, ChemDraw, ChemSketch, Chemtool, N2S with "structural formula".
To suppress the (standard) definition of any topic, use Topic = none.

More parameters

Cat/Sub/Key

Category, subcategory and sort key are created following certain standards; it is advised not to change it – but nevertheless it can be altered if that is desired.

  • Category can be specified complete (e.g. [[Category:Collection of bugs: Part1|Severity]]), or just the category name (e.g. Collection of bugs) with possibility to define the other two parameters (e.g. Subcategory=: Part1, Sort key=Severity).
To suppress the (standard) categorization, use Category = none.
  • Subcategory can replace the standard subcategorizing by topic
To suppress the (standard) subcategorization, use Subcategory = none.
  • Sorting within the category or subcategory can be changed by the parameter value of "Sort key".

The parameter value can be either a simple textstring (e.g. User=The Stanford University), or a transclusion with e.g. {{U}}, {{Ut}}, {{Uw}}, {{Uc}}}, {{Ud}}, {{Uwt}}.

The link to a Commons user page can be performed with the other parameter Userlink which uses the template:U, e.g. Userlink=Leyo

Graphic lab

Grahic lab categories contain in general subcategories for CoA, Flag and Map.
Currently the following Graphic labs are established:

Colorboxes

There are seven different parameter names, to generate different color box layouts:

  • Colorbox00 generates boxes with {{Legend}} from parameter pairs
  • Colorbox-b generates boxes with {{ColorBox}} from single parameters
  • Colorbox-d generates boxes with {{ColorBox}} from parameter pairs
  • Colorbox-l generates boxes with {{Legend}} from single parameters ¹)
  • Colorbox-m generates boxes with {{Legend-small}} from parameter pairs
  • Colorbox-s generates boxes with {{Legend-small}} from single parameters
  • Colorbox-t generates boxes with {{Tbc}} from parameter pairs
¹) Colorbox-l exists just for completion – normally a "Legend" without an explaining text seems not useful.

The (first) parameter has to be a color code

  • a valid hexadecimal color code, e.g. "#FF00FF" or "#080"
  • a valid tincture color name, e.g. "cendrée"
  • a valid CSS color name, e.g "turquoise"

invalid codes cause unpredictable errors. For Colorbox-l and Colorbox-s each parameter is such a color code.
The second parameter of a pair is descriptive text, e.g. "rouge", it may also contain links or other wiki syntax;
when it is missing (e.g. two consecutive slashes), the first parameter is displayed instead.
The parameters are specified as a slash-separated string, e.g. "#aa1122/Color 1/#ccddee/Color 2/#cc00dd/Color 3/#FF0/yellow"

For (heraldic) Tinctures, see the documentation of that template.

Bad/Fake/​Topic/Requ SVG

An SVG file containing raster graphics in most cases is a Bad SVG; in some special cases it will be a Fake SVG or a Topo SVG/Required raster. Only either one of these four possibilities can occur.

Retouched picture

For the complete description of a digital alteration, all three parameters should pass their values; nevertheless any one of them triggers the tagging of the file with the template.

  • Retouche can describe the modifications
  • Modifier can describe the editor of the alterations, in general it will be a link to a user name
  • Original can describe the original picture that has been modified, in general it will be a link to a file name

Always consider the fact that a mere vectorization is not a digital alteration! These cases should use the template:AutVec in the Author= field.

Other tool

It can be specified that a file has been created using more than one (the "SVG tool" of the first parameter) tool.

Raster graphic tags

Of course, Convert to SVG or Simple to SVG is only useful when specified at a raster graphic. All the topics explained in Convert to SVG/doc/param1 can be used.

Vector version when specified at a raster graphic shows the SVG file with the same name, or with the specified name.

Parameter copy

Small example

{{ File generation description
SVG tool = ChemDraw
W3C error count = 
Topic = structural formula
Text as path = no
Text embedded = no }}

In this example, only the first parameter is necessary, the others just specify what would be defaulted anyway.
When "Other fields" is missing it is the same as Other fields=yes which will be the best choice in most cases.

Large parameter list

{{File generation description
|SVG tool=
|W3C error count=
|Topic=

|Category=
|Subcategory=
|Sort key=
|User=
|Userlink=
|More=
|Othertool=
|Additional=
|Graphic lab=
|Tincture=
|Colorbox=
|Broken file=
|Superseded by=
|Supersedes=
|Prefix=
|Trailer=
|Message=

|Superseded=
|Commonist=
|Text embedded=
|Text as path=
|Large file=
|Easy border=
|PGF data=
|Traced SVG=
|Bad SVG=  
|Fake SVG=
|Topo SVG=  
|Required raster=
|Fictional=
|Simplified SVG=
|SVG 1.2=
|Textedit  by hand=
|Vector version=
|Convert to SVG=
|Simple to SVG=

|Retouche=
|Modifier=
|Original=
}}
|Other fields=yes

Bug parameters, Code parameters

|Technically replaced=
|General bug= 
|Gaussian blur bug= 
|Compatibility bug= 
|Demonstration bug= 
|Former bug=
|Overwritten bug= 
|Replaced bug= 
|Unsolved bug= 

|Syntax=
|Titling=
|Collapse=
|Diffusion=
|Explanation=
|Footnote=
|Format=
|Code=

{{ifsandbox|