Diferenças entre edições de "Predefinição:Documentation"

Da Thinkfn

Deprecated: The each() function is deprecated. This message will be suppressed on further calls in /home1/thinkfnw/public_html/wiki/includes/diff/DairikiDiff.php on line 390
 
(40 edições intermédias não estão a ser mostradas.)
Linha 1: Linha 1:
−
<noinclude>{{documentation}}</noinclude><includeonly>{{
+
<noinclude>{{documentation}}</noinclude><includeonly><!--
−
<!-- caixa -->
+
#
−
aviso
+
# caixa para predefinições
−
   | título = {{
+
#
−
    #switch: {{SUBPAGENAME}}
+
-->
−
    | doc = Documentação desta predefinição
+
{{aviso
−
    | cat = Categorias das páginas desta predefinição
+
   | título = Predefinição<!--
−
    | par = Parâmetros desta predefinição
+
#
−
    | parameterlist = Parâmetros desta predefinição
+
# lista das diferentes páginas padronizadas que constituem a predefinição
−
    | dev = Versão de desenvolvimento desta predefinição
+
#
−
    | tst = Testes desta predefinição
+
-->
−
    | Código desta predefinição
+
  | texto = <center><!--
−
    }}
+
        -->{{documentation/docname|cod}} {{!}} <!--
−
  | texto = Páginas da [[Ajuda:Predefinições|predefinição]]: {{documentation/docname|cod}} {{!}} {{documentation/docname|doc}} {{!}} {{documentation/docname|cat}} {{!}} {{documentation/docname|par}} {{!}} {{documentation/docname|dev}} {{!}} {{documentation/docname|tst}}
+
        -->{{documentation/docname|doc}} {{!}} <!--
 +
        -->{{documentation/docname|cat}} {{!}} <!--
 +
        -->{{documentation/docname|par}} {{!}} <!--
 +
        -->{{documentation/docname|dev}} {{!}} <!--
 +
        -->{{documentation/docname|tst}}<!--
 +
        --></center><br /><br />{{<!--
 +
#
 +
# texto explicativo, dependendo do tipo de página
 +
#
 +
-->
 +
    #ifeq: {{FULLPAGENAME}} | {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}
 +
      | Esta é a página do código desta predefinição. O texto abaixo vem da página da documentação. A categoria vem da página de categoria (não categorize esta página). Todos os parâmetros que a predefinição aceita estão listados na página de parâmetros e o seu uso é explicado na documentação. Se quiser alterar o código, faça-o na página de desenvolvimento. Verifique as suas alterações na página de testes. Quando terminar a alteração, peça a um administrador que migre o código de desenvolvimento para cá.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
      | {{
 +
        #switch: {{#titleparts:{{PAGENAME}}|2}}
 +
        | {{#titleparts:{{PAGENAME}}|1}}/doc = Esta é a página da documentação. O texto abaixo será sempre apresentado na página do código, para que quem consulte o código da predefinição veja também a documentação.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
        | {{#titleparts:{{PAGENAME}}|1}}/cat = Esta é a página da categoria desta predefinição. Só pode usar UMA categoria. NÃO CATEGORIZE A PÁGINA usando <code><nowiki>[[Categoria: ]]</nowiki></code>. Coloque unicamente o nome da página da categoria que pretende. Por exemplo, para categorizar a predefinição na categoria <code>!Ajuda</code> escreve aqui <code>!Ajuda</code> E NÃO <code><nowiki>[[Categoria:!Ajuda]]</nowiki></code>.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
        | {{#titleparts:{{PAGENAME}}|1}}/par = Esta é a página dos parâmetros desta predefinição. Liste todos os parâmetros que a predefinição aceita. Esta lista deve ser apresentada na documentação e pode ser usada no código para mostrar aos utilizadores quais os parâmetros que podem ser usados.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
        | {{#titleparts:{{PAGENAME}}|1}}/dev = Esta página normalmente contém o mesmo código que a página do código, mas que pode ser alterado para fazer experiências e melhoramentos, sem alterar o código que os restantes utilizadores estão a usar.''<br /><br />''Para alterar a predefinição, comece por copiar o conteúdo da página de código para cá. Depois, faça as alterações que pretende e grave. Os resultados das suas alterações podem ser verificados na página de testes. Verifique todos os casos de teste existentes, para se certificar de que só alterou os comportamentos pretendidos.<br /><br />Quando a sua alteração estiver completa, peça a um administrador para migrar o novo código para a página do código.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
        | {{#titleparts:{{PAGENAME}}|1}}/tst = Os seguintes testes são usados no desenvolvimento e manutenção desta predefinição. Devem testar o comportamento da predefinição em casos típicos e em casos limite, onde ela deve ter sempre um comportamento elegante para o leitor. Servem também, claro, como exemplos do uso da predefinição.<br /><br />Para cada caso de teste, é apresentada a versão actual (criada pelo código da página de código) e a versão de desenvolvimento (criada pelo código da página de desenvolvimento). Ao alterar a predefinição, adicione aqui casos de teste que demonstrem o comportamento anterior e posterior à sua alteração. Verifique também, nos testes já existentes, que a sua funcionalidade já existente não foi danificada.<br /><br />''Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.''
 +
        | #default = <center>'''Esta é uma página extra da predefinição (adicional às páginas padrão, listadas acima).'''</center>
 +
        }} }} }} {{<!--
 +
#
 +
# após a caixa: link à direita para editar ou criar a documentação
 +
#
 +
-->
 +
#ifeq: {{FULLPAGENAME}} | {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}
 +
| <span class="editsection plainlinks" id="doc_editlinks">{{
 +
  #ifexist: {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/doc
 +
  | [[{{fullurl:{{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/doc|action=edit}} editar documentação]]
 +
  | [[{{fullurl:{{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/doc|action=edit&preload=Template:Documentation/preload/doc}} criar documentação]]<!--
 +
#
 +
# cabeçalho da secção documentação
 +
#
 +
-->
 +
  }}</span><span><h2>Documentação</h2></span>{{<!--
 +
#
 +
# conteúdo da secção documentação: se a subpágina /doc existe, transcluí-la para cá
 +
#
 +
-->
 +
#ifexist: {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/doc
 +
  | {{:{{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/doc}}
 +
  | }}  
 
}}<!--
 
}}<!--
−
 
+
#
 +
# categorizar esta página, dependendo do seu tipo
 +
#
 
-->{{
 
-->{{
−
#switch: {{SUBPAGENAME}}
+
#ifexist: {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/cat
−
  | doc =
+
| {{
−
<h2>Documentação</h2>
+
  #ifeq: {{FULLPAGENAME}} | {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}
−
Esta é a página de documentação desta predefinição. Este texto é transcluído para a página do código, para que quem consulta a predefinição também veja a documentação ao mesmo tempo.<br />
+
    | [[Categoria: {{ {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/cat }} | {{PAGENAME}} ]]
−
  | cat =
+
    | {{
−
<h2>Categorias</h2>
+
      #switch: {{#titleparts:{{PAGENAME}}|2}}
−
Esta é a página das categorias que serão automaticamente atribuídas a todas as páginas desta predefinição. Ao colocar uma categoria nesta página, a mesma categoria será automaticamente atribuída a todas as restantes páginas da predefinição. Isto evita que tenha de categorizar as páginas uma a uma e garante que a categorização é a mesma para todas. Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir.<br />
+
      | {{#titleparts:{{PAGENAME}}|1}}/doc
−
  | parameterlist
+
      | {{#titleparts:{{PAGENAME}}|1}}/cat
−
  | dev = <!-- não fazer nada -->
+
      | {{#titleparts:{{PAGENAME}}|1}}/par
−
  | tst =
+
      | {{#titleparts:{{PAGENAME}}|1}}/dev
−
<h2>Casos de teste</h2>
+
      | {{#titleparts:{{PAGENAME}}|1}}/tst = <!--
−
Os seguintes testes são usados no desenvolvimento e manutenção desta predefinição. Devem testar o comportamento da predefinição em casos típicos e em casos limite, onde ela deve ter sempre um comportamento elegante para o leitor. Para cada caso de teste, é apresentada a versão actual (criada pelo código da página de código) e a versão de desenvolvimento (criada pelo código da página de desenvolvimento). Servem também, claro, como exemplos do uso da predefinição.<br />
+
        -->[[Categoria:!Páginas padronizadas das predefinições|{{PAGENAME}}]]
−
  | #default =<span class="editsection plainlinks" id="doc_editlinks">{{
+
      | #default = <!--
−
      #ifexist: {{NAMESPACE}}:{{PAGENAME}}/doc
+
        -->[[Categoria: {{ {{NAMESPACE}}:{{#titleparts:{{PAGENAME}}|1}}/cat }} | {{PAGENAME}} ]]
−
        | [[{{fullurl:{{NAMESPACE}}:{{PAGENAME}}/doc|action=edit}} editar documentação]]
+
      }}
−
        | [[{{fullurl:{{NAMESPACE}}:{{PAGENAME}}/doc|action=edit&preload=Template:Documentation/preload/doc}} criar documentação]]
+
  }}
−
        }}</span><span><h2>Documentação</h2></span><!--
+
|
−
    -->{{:{{NAMESPACE}}:{{PAGENAME}}/doc}}
+
}} __NOEDITSECTION__ __NOTOC__</includeonly>
−
}}<div style="clear: both;"></div>__NOEDITSECTION__ __NOTOC__</includeonly>
+

Edição atual desde as 16h35min de 4 de julho de 2010

Predefinição
código | documentação | categoria | parâmetros | desenvolvimento | testes


Esta é a página do código desta predefinição. O texto abaixo vem da página da documentação. A categoria vem da página de categoria (não categorize esta página). Todos os parâmetros que a predefinição aceita estão listados na página de parâmetros e o seu uso é explicado na documentação. Se quiser alterar o código, faça-o na página de desenvolvimento. Verifique as suas alterações na página de testes. Quando terminar a alteração, peça a um administrador que migre o código de desenvolvimento para cá.

Nota: Se está a criar esta página pela primeira vez, ela já foi pré-preenchida com o modelo que deve seguir. Siga-o, por favor. Não categorize esta página. Coloque a categoria da predefinição na página da categoria.
[editar documentação]

Documentação

Esta predefinição é o elemento central de articulação do mecanismo das predefinições. Deve ser incluída em todas as páginas do espaço nominal Predefinição:. Ela:
  • cria a caixa de navegação da predefinição que vê acima, com links para navegar facilmente por todas as páginas padrão da predefinição,
  • auxilia a criação inicial dessas páginas, apresentado um modelo padronizado do conteúdo de cada uma, que deve ser seguido,
  • mostra a página da documentação quando se consulta o código da predefinição, para que se veja também a sua documentação (esse processo está a ocorrer neste momento: o texto que está a ler, não está na página Predefinição:Documentation, que é a página do código de {{documentation}}, mas sim na página Predefinição:Documentation/doc), e
  • categoriza automaticamente todas as páginas da predefinição nas quais tenha sido incluída.

Esta predefinição existe para permitir que o código das predefinições seja protegido enquanto todos os restantes componentes, que estão noutras páginas, possam continuar a ser editados pelos utilizadores.

Uso

Para usar {{documentation}} coloque o seguinte código no topo de todas as páginas da predefinição: 

<noinclude>{{documentation}}<noinclude>

Se criar as páginas seguindo os links na caixa de navegação da predefinição, as páginas serão automaticamente preenchidas com um modelo que deve seguir. Os modelos estão listados abaixo.

Parâmetros

Não aceita parâmetros.

Ver também

Páginas extra desta predefinição (adicionais às páginas padrão)
Outras
Obtida de "https://www.thinkfnwiki.com/wiki/index.php?title=Predefinição:Documentation&oldid=45550"