Exibir código-fonte para Módulo:Link de arquivo/doc

<section begin=header />
{{#ifeq:{{#invoke:String|find|{{FULLPAGENAME}}|Testes}}|0|<includeonly><!--{{alto-risco| 3000}}--></includeonly>{{Module rating|pa}}}}<!-- if pagename does not contain sandbox -->
<section end=header />

== Descrição ==
Este módulo é usado para construir ligações wikitext para arquivos. É útil principalmente para predefinições e módulos que utilizam a lógica complicada para fazer links de arquivos. Links de arquivos simples deve ser feita com marcação wikitext diretamente, pois usa menos recursos do que chamar este módulo. Para obter ajuda com arquivo de marcação wikitext consulte o [[mw:Help:Images|documentation at mediawiki.org]].

== Uso de wikitext ==

From wikitext, this module should be called from a template, usually {{tl|file link}}. Please see the template page for documentation. However, it can also be called using the syntax <code><nowiki>{{#invoke:File link|main|</nowiki>''arguments''<nowiki>}}</nowiki></code>.

== Uso de Lua ==

First, you need to import the module.

<source lang="lua">
local mFileLink = require('Module:File link')
</source>

Then you can make file links using the <code>_main</code> function.

<source lang="lua">
mFileLink._main(args)
</source>

<var>args</var> is a table of arguments that can have the following keys:
* <code>file</code> - the filename. (required)
* <code>format</code> - the file format, e.g. 'thumb', 'thumbnail', 'frame', 'framed', or 'frameless'.
* <code>formatfile</code> - a filename to specify with the 'thumbnail' format option. The filename specified will be used instead of the automatically generated thumbnail.
* <code>border</code> - set this to true or "yes" (or any other value recognized as true by [[Module:Yesno]]) to set a border for the image.
* <code>location</code> - the horizontal alignment of the file, e.g. 'right', 'left', 'center', or 'none'.
* <code>alignment</code> - the vertical alignment of the file, e.g. 'baseline', 'middle', 'sub', 'super', 'text-top', 'text-bottom', 'top', or 'bottom'.
* <code>size</code> - the size of the image, e.g. '100px', 'x100px' or '100x100px'.
* <code>upright</code> - the 'upright' parameter, used for setting the size of tall and thin images.
* <code>link</code> - the page that the file should link to. Use the blank string '' to suppress the default link to the file description page.
* <code>alt</code> - the alt text. Use the blank string '' to suppress the default alt text.
* <code>caption</code> - a caption for the file.
* <code>page</code> - sets a page number for multi-paged files such as PDFs.
* <code>class</code> - adds a <code>class</code> parameter to image links. The MediaWiki software adds this parameter to the <code>class="..."</code> attribute of the image's <code><nowiki><img /></nowiki></code> element when the page is rendered into HTML.
* <code>lang</code> - adds a language attribute to specify what language to render the file in.
* <code>start</code> - specifies a start time for audio and video files.
* <code>end</code> - specifies an end time for audio and video files.
* <code>thumbtime</code> - specifies the time to use to generate the thumbnail image for video files.

To see the effect of each of these parameters, see the [[mw:Help:Images#Format|images help page on mediawiki.org]].

=== Exemplos ===

With the file only:
<source lang="lua">
mFileLink.main{file = 'Example.png'}
-- Renders as [[File:Example.png]]
</source>

With format, size, link and caption options:
<source lang="lua">
mFileLink.main{
	file = 'Example.png',
	format = 'thumb',
	size = '220px',
	link = 'Wikipedia:Sandbox',
	caption = 'An example.'
}
-- Renders as [[File:Example.png|thumb|220px|link=Wikipedia:Sandbox|An example.]]
</source>

With format, size, and border:
<source lang="lua">
mFileLink.main{
	file = 'Example.png',
	format = 'frameless',
	size = '220px',
	border = true
}
-- Renders as [[File:Example.png|frameless|border|220px]]
</source>


<includeonly>{{#ifeq:{{SUBPAGENAME}}|Testes||
[[Categoria:!Módulos]]

}}</includeonly>