Exibir código-fonte para Predefinição:Portrait Gallery/doc | One Piece Wiki

==Descrição==
Este modelo é usado para criar galerias de retratos.

;Dependências
Este modelo usa [[:File:NoPicAvailable.png]], bem como vários subtemplates.

===Sintaxe===
O modelo funciona para ser chamado da seguinte forma:
<pre>
{{Portrait Gallery
  |template= o nome do modelo
  |title= o título
  |colorscheme= o esquema de cores

  | código retrato
  | outro código de retrato
  | um terceiro código de retrato
  | etc.
}}
</pre>

O "código de retrato" é peculiar. Ele consiste em três partes, separadas por barras invertidas ("\"). Por exemplo, {{code|Caesar \ Caesar Clown Marine Portrait.png \ Caesar Clown}} é um código de retrato.
* A primeira parte é o texto que será mostrado abaixo do retrato.
* A segunda parte é o nome da foto retrato (sem colchetes de link ou "Arquivo:"). É opcional: se não estiver presente, será considerado "XXX Portrait.png", com "XXX" sendo o texto na terceira parte. Além disso, há um valor especial "NOPIC": ele usa [[:File:NoPicAvailable.png]].
* A terceira parte é o nome da página para a qual o retrato e o texto são vinculados. É opcional: se não estiver presente, é considerado igual ao texto (excluindo parênteses). Além disso, há um valor especial "NOLINK", para casos em que o retrato não deve vincular a nenhuma página.

O '''title''' e '''colorscheme''' são auto-explicativos. O '''template''' parâmetro deve ser dado o nome da página do modelo (atenção: <code><nowiki>{{PAGENAME}}</nowiki></code> não funciona!); se presente, permite que a galeria contenha links de modelo à esquerda do título.

==Exemplos==
O seguinte código
<pre>
{{Portrait Gallery
  |title=[[Piratas Alvida]]
  |cs=AlvidaPiratesColors

  |Alvida \ Fat Alvida Portrait.png
  |Coby (antes) \ Coby Before Training Portrait.png
  |Heppoko \ Heppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Peppoko \ Peppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Poppoko \ Poppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
}}
</pre>
dá o seguinte resultado:
{{Portrait Gallery
  |title=[[Piratas Alvida]]
  |cs=AlvidaPiratesColors

  |Alvida \ Fat Alvida Portrait.png
  |Coby (antes) \ Monkey D. Luffy Post Timeskip.png
  |Heppoko
  |Peppoko
  |Poppoko
}}

Um exemplo com muitos casos diferentes, com comentários:
<pre>
{{Portrait Gallery
  |title=People
  |cs=AlabastaColors

  |Pacifista <!-- only text; no pic and no link: the standard pic "XXX Portrait.png" is used, and the text is used as a link -->
  |Caesar Clown \ Caesar Marine Portrait.png  <!-- only text and pic, no link: the text is used as a link -->
  |Coby (former) \ Coby Before Training Portrait.png  <!-- only text and pic, no link: the text is used as a link, but the parentheses are ignored -->
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach  <!-- all three elements, with a link different than the text -->
  |??? \ Kuzan Pre Timeskip Portrait.png \ NOLINK  <!-- use of the NOLINK special parameter; purpose should be clear -->
  |Marguerite  \ NOPIC \  <!-- use of the NOPIC special parameter -->
  |Shanks' Father \ NOPIC \ NOLINK  <!-- NOPIC + NOLINK -->
}}
</pre>
{{Portrait Gallery
  |title=People
  |cs=AlabastaColors

  |Pacifista <!-- only text; no pic and no link: the standard pic "XXX Portrait.png" is used, and the text is used as a link -->
  |Caesar Clown \ Caesar Clown Marine Portrait.png  <!-- only text and pic, no link: the text is used as a link -->
  |Coby (former) \ Coby Before Training Portrait.png  <!-- only text and pic, no link: the text is used as a link, but the parentheses are ignored -->
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach  <!-- all three elements, with a link different than the text -->
  |??? \ Kuzan Pre Timeskip Portrait.png \ NOLINK  <!-- use of the NOLINK special parameter; purpose should be clear -->
  |Marguerite  \ NOPIC \  <!-- use of the NOPIC special parameter -->
  |Shanks' Father \ NOPIC \ NOLINK  <!-- NOPIC + NOLINK -->
}}

An example with only one portrait:
<pre>
{{Portrait Gallery
  |title=The Almighty Marguerite
  |colorscheme=KujaColors
  |Marguerite
}}
</pre>
{{Portrait Gallery
  |title=The Almighty Marguerite
  |colorscheme=KujaColors
  |Marguerite
}}

==Uso Avançado==
===Cores===
Nem sempre é possível usar um esquema de cores; para usar cores personalizadas, existem parâmetros '''textcolor''' e '''backcolor'''.

<pre>
{{Portrait Gallery
  |title=The Almighty Marguerite
  |textcolor=FAEEAF
  |backcolor=012210
  |Marguerite
}}
</pre>
{{Portrait Gallery
  |title=The Almighty Marguerite
  |textcolor=FAEEAF
  |backcolor=012210
  |Marguerite
}}

[[File:Example.jpg]]===Galerias com Seções===
Às vezes, é preciso criar seções em uma galeria de retratos. Isso pode ser feito unindo várias galerias, graças ao '''multi''' parâmetro.
* Usar '''multi=header''' para iniciar uma galeria.
* Usar '''multi=section''' para fazer uma seção.
* Usar '''multi=footer''' para acabar com a galeria.
O '''section''' parâmetro é um atalho: '''section=XXX''' é o mesmo que '''multi=section|title=XXX'''.
Aqui está um exemplo de galeria com seções:

<pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery with Sections
  |cs=AlvidaPiratesColors
}}
{{Portrait Gallery
  |section=Alvida Pirates

  |Alvida \ [[File:.png]]
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko \ Heppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Peppoko \ Peppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Poppoko \ Poppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
}}
{{Portrait Gallery
  |section=People

  |Pacifista <!-- only text; no pic and no link: the standard pic "XXX Portrait.png" is used, and the text is used as a link -->
  |Caesar Clown \ Caesar Clown Marine Portrait.png  <!-- only text and pic, no link: the text is used as a link -->
  |Coby (former) \ Coby Before Training Portrait.png  <!-- only text and pic, no link: the text is used as a link, but the parentheses are ignored -->
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach  <!-- all three elements, with a link different than the text -->
  |??? \ Kuzan Pre Timeskip Portrait.png \ NOLINK  <!-- use of the NOLINK special parameter; purpose should be clear -->
  |Marguerite  \ NOPIC \  <!-- use of the NOPIC special parameter -->
  |Shanks' Father \ NOPIC \ NOLINK  <!-- NOPIC + NOLINK -->
}}
{{Portrait Gallery
  |section=The Almighty Marguerite

  |Marguerite
}}
{{Portrait Gallery
  |multi=footer
}}
</pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery with Sections
  |cs=AlvidaPiratesColors
}}
{{Portrait Gallery
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko 
  |Peppoko 
  |Poppoko 
}}
{{Portrait Gallery
  |section=People

  |Pacifista <!-- only text; no pic and no link: the standard pic "XXX Portrait.png" is used, and the text is used as a link -->
  |Caesar Clown \ Caesar Clown Marine Portrait.png  <!-- only text and pic, no link: the text is used as a link -->
  |Coby (former) \ Coby Before Training Portrait.png  <!-- only text and pic, no link: the text is used as a link, but the parentheses are ignored -->
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach  <!-- all three elements, with a link different than the text -->
  |??? \ Monkey D. Luffy Post Timeskip.png \ NOLINK  <!-- use of the NOLINK special parameter; purpose should be clear -->
  |Marguerite  \ NOPIC \  <!-- use of the NOPIC special parameter -->
  |Shanks' Father \ NOPIC \ NOLINK  <!-- NOPIC + NOLINK -->
}}
{{Portrait Gallery
  |section=The Almighty Marguerite

  |Marguerite
}}
{{Portrait Gallery
  |multi=footer
}}

===Galerias usadas como seções em outras galerias===
Às vezes, galerias são usadas como seções em galerias maiores (como em [[Template:Marine Members Gallery]]). Para permitir que uma galeria seja incluída em outra, é necessário adicionar o seguinte trecho de código: <code><nowiki>included={{{included|no}}}</nowiki></code>. Deve ser adicionado como um parâmetro. O exemplo a seguir é o código para [[Template:Macro Pirates Gallery]]:
<pre>
{{Portrait Gallery|included={{{included|no}}}
  |title=[[Macro Pirates]]
  |cs=MacroPiratesColors

  |Macro
  |Gyaro
  |Tansui
}}
</pre>
{{Macro_Pirates_Gallery}}
Agora podemos incluir este modelo como uma seção em outra galeria, usando o parâmetro '''included=yes''':
<pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery Including Another
  |cs=StrawHatPiratesColors
}}
{{Portrait Gallery
  |section=The Almighty Marguerite

  |Marguerite
}}
{{Macro_Pirates_Gallery|included=yes}}
{{Portrait Gallery
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko \ Heppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Peppoko \ Peppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Poppoko \ Poppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
}}
{{Portrait Gallery
  |multi=footer
}}
</pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery Including Another
  |cs=StrawHatPiratesColors
}}
{{Portrait Gallery
  |section=The Almighty Marguerite

  |Marguerite
}}
{{Macro_Pirates_Gallery|included=yes}}
{{Portrait Gallery
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko 
  |Peppoko 
  |Poppoko 
}}
{{Portrait Gallery
  |multi=footer
}}

Para fazer o mesmo para galerias que já possuem várias seções, adicione o snippet no cabeçalho e no rodapé. Aqui está um exemplo simples:
<pre>
{{Portrait Gallery|included={{{included|no}}}
  |multi=header
  |title=A Gallery with Sections, which Can Be Included Too
  |cs=FishmenColors
}}
{{Portrait Gallery
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko \ Heppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Peppoko \ Peppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
  |Poppoko \ Poppoko Portrait.png \ Heppoko, Peppoko, and Poppoko
}}
{{Portrait Gallery
  |section=The Almighty Marguerite

  |Marguerite
}}
{{Portrait Gallery|included={{{included|no}}}
  |multi=footer
}}
</pre>
Colocando isso em "Template: Foobar Gallery", por exemplo, podemos incluí-lo em outra galeria, exatamente como um template de seção única, usando <code><nowiki>{{Foobar Gallery|included=yes}}</nowiki></code>.

===Número de colunas===
O layout padrão usa 5 colunas. Também é possível usar 2, 3 ou 4, se necessário, graças ao '''cols''' parâmetro, que deve ser adicionado a cada seção.
Note que se houver menos de 5 retratos em uma galeria, deixar o padrão funciona de qualquer maneira.
<pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery using 3 Columns
  |cs=SabaodyColors
}}
{{Portrait Gallery
  |cols=3
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko
  |Peppoko
  |Poppoko 
}}
{{Portrait Gallery
  |cols=3
  |section=People

  |Pacifista
  |Caesar Clown \ Caesar Clown Marine Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach
  |??? \ Kuzan Pre Timeskip Portrait.png \ NOLINK
  |Marguerite  \ NOPIC
}}
{{Portrait Gallery
  |multi=footer
}}
</pre>
{{Portrait Gallery
  |multi=header
  |title=A Gallery using 3 Columns
  |cs=SabaodyColors
}}
{{Portrait Gallery
  |cols=3
  |section=Alvida Pirates

  |Alvida \ Fat Alvida Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Heppoko 
  |Peppoko 
  |Poppoko 
}}
{{Portrait Gallery
  |cols=3
  |section=People

  |Pacifista
  |Caesar Clown \ Caesar Clown Marine Portrait.png
  |Coby (former) \ Coby Before Training Portrait.png
  |Young Teach \ Marshall D. Teach Young Portrait.png \ Marshall D. Teach
  |??? \ Kuzan Pre Timeskip Portrait.png \ NOLINK
  |Marguerite  \ NOPIC
}}
{{Portrait Gallery
  |multi=footer
}}

==Limitações==
Cada seção é limitada a 100 retratos. O número de colunas é 2, 3, 4 ou 5, com 5 o padrão.


<includeonly>[[Category:General Templates]]</includeonly>

<!-- DO NOT EDIT THE FOLLOWING CODE -->
<noinclude>[[Category:Template Documentation|{{PAGENAME}}]]
</noinclude><!--</includeonly>[[Category:Preload Templates]]<includeonly>-->