Exibir código-fonte para Predefinição:Nota de rodapé/doc

{{Subpágina de documentação}}
<!-- Por favor coloque categorias onde indicado na parte inferior desta página e interwikis no Wikidata -->
Esta predefinição, utiliza-se do sistema de marção <nowiki><ref></ref></nowiki>, da extensão [[mw:Extension:Cite/Cite.php|Cite.php]] do MediaWiki, para geração de notas de rodapé com numeração automática, permitindo, inclusive, a adição de referências dentro da própria nota. Essa predefinição deve ser utilizada em conjunto com {{tl|notas}}.

== Sintaxe ==
;Simples
:<code><nowiki>{{nota de rodapé|Comentário a respeito do texto.}}</nowiki></code>
cujo resultado é o mesmo que
:<code><nowiki><ref group="nota">Comentário a respeito do texto.</ref></nowiki></code>

;Notas com referências
:<code><nowiki>{{nota de rodapé|Comentário a respeito do texto.<ref>Referência da nota</ref>}}</nowiki></code>

'''Obs''':Note que o sistema <code><nowiki><ref>...</ref></nowiki></code> não permite que sejam utilizas referências dentro do texto da nota.

;Notas nomeadas
:<code><nowiki>{{nota de rodapé|Comentário a respeito do texto.<ref>Referência da nota</ref>|nome=nome_nota}}</nowiki></code>
Assim, caso deseje citar a mesma nota em alguma outro local do texto, simplesmente adicione <code><nowiki><ref group="nota" name="nome_nota"/></nowiki></code>

;Sintaxe completa
:<code><nowiki>{{nota de rodapé|nota=Comentário a respeito do texto|nome=nome_nota|grupo=nota}}</nowiki></code>


== Uso ==
De modo geral, as notas de rodapé podem ser utilizadas de duas maneiras:

;Com o comentário junto ao texto
<pre>
Texto de exemplo.{{nota de rodapé|Comentário a respeito do texto.<ref>Referência da nota</ref>}}

...

{{notas}}
</pre>

;Com o comentário inserido ao final do texto
<pre>
Texto de exemplo.<ref group="nota" name="nome_nota"/>

...

{{notas|refs=
{{nota de rodapé|Comentário a respeito do texto.<ref>Referência da nota</ref>|nome=nome_nota}}
}}
</pre>

== Observações importantes ==
*Para que a predefinição funcione adequadamente, ao final do artigo adicione a predefinição {{tl|notas}} logo acima da predefinição {{tl|referências}}, como nos exemplos citados anteriormente.

*Caso altere o parâmetro grupo, não esqueça de declará-lo também na predefinição {{tl|notas}}, por exemplo:
<pre>
Texto de exemplo.{{nota de rodapé|Comentário a respeito do texto.|grupo=nb}}

...

{{notas|grupo=nb}}
</pre>

*Caso o editor tente inserir nos comentários da nota de rodapé, entre colchetes ou não, alguma [[:Ajuda:Guia_de_edição/Ligações_externas|ligação externa]] cujo código contenha um ou mais [[Parâmetro_(ciência_da_computação)|parâmetros]], o texto da nota de rodapé não será exibido na seção '''Notas'''. No exemplo abaixo, o código da ligação está entre colchetes e contém os parâmetros '''jornal''', '''pagina''' e '''data''':
<code><nowiki>[http://pesquisa.in.gov.br/imprensa/jsp/visualiza/index.jsp?jornal=1&pagina=11&data=31/01/2013]</nowiki></code>

:Para contornar o problema, é necessário que o código da ligação externa seja posicionado entre as [[Tag_(linguagens_de_marcação)|tags]] <nowiki><ref></nowiki> e <nowiki></ref></nowiki>. Exemplo:
<code><nowiki>{{nota de rodapé|Este é um comentário de nota de rodapé no qual o código da ligação externa<ref>[http://pesquisa.in.gov.br/imprensa/jsp/visualiza/index.jsp?jornal=1&pagina=11&data=31/01/2013]</ref> teve que ser incluído entre as tags <ref> e </ref> porque contém parâmetros.}}</nowiki></code>
:Neste caso será também necessário acrescentar a predefinição {{t|referências}}, caso ela ainda não conste no final da página.

:Alternativamente, o editor pode eliminar os parâmetros:
<code><nowiki>{{nota de rodapé|Este é um comentário de nota de rodapé no qual o [http://pesquisa.in.gov.br/imprensa/jsp/visualiza/index.jsp código da ligação externa] não contém parâmetros, por isto não é necessário posicioná-lo entre as tags <ref> e </ref>.}}</nowiki></code>

== Parâmetros ==
*<code>nota=</code> ou <code>1=</code>: Texto da nota em si, acompanhada de eventuais referências, se necessário.
*<code>grupo=</code> (opcional): grupo das notas de rodapé; esse texto é utilizado como prefixo no link da nota, por exemplo, <sup>[nota 1]</sup> (por padrão) ou <sup>[nb 1]</sup> (caso grupo="nb"). 
*<code>nome=</code> (opcional): nome da nota, que permite que seja utilizada em outro local do artigo.

<templatedata>
{
	"params": {
		"nome": {
			"aliases": [
				"name"
			],
			"label": "Nome",
			"description": "Caso seja necessário usar a mesma nota duas vezes numa página, dê a ela um nome para chamá-la",
			"type": "string"
		},
		"nota": {
			"label": "Nota",
			"description": "Adicione aqui o texto da nota:",
			"type": "string",
			"aliases": [
				"1"
			],
			"required": true
		},
		"grupo": {
			"label": "Grupo",
			"type": "string",
			"description": "Notas separadas em um grupo serão exibidas separadamente."
		}
	},
	"paramOrder": [
		"nota",
		"nome",
		"grupo"
	],
	"format": "inline",
	"description": "Esta predefinição cria uma nota de rodapé, que será exibida no final do artigo dentro da predefinição {{notas}}."
}
</templatedata>


== Ver também ==
* {{tl|notas}}
* [[Wikipedia:Livro de estilo/Notas de rodapé]]
* [[Predefinição:Referências]]
* [[Predefinição:Notas e referências]]


<includeonly>{{Testes outro||
<!-- Categorias abaixo desta linha, por favor; interwikis no Wikidata -->
[[Categoria:!Predefinições para referências]]

}}</includeonly>