Ajuda para contribuidores

De Wiki@DCOM
Revisão de 18h45min de 26 de agosto de 2024 por Fabio.frozza (discussão | contribs) (→‎Abas)
Ir para navegação Ir para pesquisar

Primeiros passos

Comece com estas informações básicas para trabalhar com a ferramenta Wiki: Editando páginas pelo editor visual (NOVO!), Editando páginas pelo código-fonte, Iniciando uma nova página e Conteúdo da ajuda

Dica: Procure entrar na edição da página e compare o código com o resultado para entender melhor o funcionamento

Quando já estiver editando uma página, procure marcar as edições não relevantes, que não impliquem em conteúdo novo (correções de ortografia, gramática, paginação, etc), como edição menor.

E, quando possível, utilizar o botão "Mostrar previsão" para verificar o resultado das edições, evitando assim múltiplos registros no histórico de edições, o que pode dificultar uma eventual busca de quando o conteúdo foi alterado. (Exemplo: Se um requerente que teve seu pedido devolvido questionar que enviou o pedido com as regras vigentes naquele momento, ficaria mais fácil de responder o questionamento se as edições estivessem claramente identificadas).



Ajuda para formatação

Formatação

  • Para destacar o texto em vermelho, use {{red|DIGITE SEU TEXTO AQUI}}


Para criar as seções com índice no começo da página

Utilize o formato ==seção== no código, que a ferramenta gera automaticamente. Veja diretamente no código que fica mais fácil de entender!


Trabalhando com imagens

Utilize o seguinte formato para inserir imagens no corpo do texto:

Arquivo upado pra wiki por meio da opção "Enviar arquivo" (única opção para a imagem já aparecer no meio do texto)

Código Resultado
Para inserção de uma imagem, sem redimensionamento ou outras opções: [[Arquivo:cropped-DCOM-2.png]] Cropped-DCOM-2.png
Para inserção de uma imagem, com redimensionamento: [[Arquivo:Logo manual fundo cinza.png|200px]] Logo manual fundo cinza.png
Para inserção de uma imagem, com redimensionamento e uma fina borda cinza: [[Arquivo:Logo manual fundo cinza.png|200px|border]] Logo manual fundo cinza.png
Para exibir uma legenda quando o cursor passar sobre a imagem, adicione-a ao final do código (ex.: [[Arquivo:Logo manual fundo cinza.png|200px|Clique para ampliar]]) Clique para ampliar
Caso não deseje legenda nenhuma, não finalize o código com |legenda (ex.: [[Arquivo:cropped-DCOM-2.png|200px]]) Logo manual fundo cinza.png

Mais informações: Ajuda para Imagens


Trabalhando com links

Padrões/diretrizes para uso de links:

  • Sendo referência (legislação, normativas), colocar como nota de rodapé, sem repetição;
  • Sendo link para site externo, link normal;
  • Sendo link para a própria wiki, usar wikilink;
  • Atentar para multireferências a notas, para não haver repetição.
Código Resultado
Para que o link apareça nomeado, usar o formato [https://mediawiki.org MediaWiki], onde a primeira parte (https://mediawiki.org) é o link, e a segunda (MediaWiki, após o espaço) é a descrição que aparecerá na página. MediaWiki
Para que o link seja numerado automaticamente: [http://towbar.com.br/loja/FotosProdutos_2/6290/120032014162549236444265412651f56we1f56ef1236r65.jpg]. [1]
Para usar um link (numerado) gerado pelo arquivos.ufsc: [https://arquivos.ufsc.br/f/9930adbc9a/?raw=1]. [2]
Para criar um link para uma outra página do Manual (interna/wikilink): [[APRESENTAÇÃO|Este é um link para a página Apresentação, deste Manual]], onde, no exemplo, "APRESENTAÇÃO" é o nome da página e "Este é um link para a página Apresentação, deste Manual" é o texto que será exibido como link.

Obs.: São 2 (dois) colchetes ([[]])

O nome da página deve ser EXATAMENTE igual, inclusive MAIÚSCULAS E MINÚSCULAS.

Este é um link para a página Apresentação, deste Manual
Para link interno para uma seção dentro de uma página se usa o operador "#", como em: [[Ajuda para contribuidores#Trabalhando com links|Este é um link para a seção "Trabalhando com links", desta página]]. Este é um link para a seção "Trabalhando com links", desta página
Para criar um link para o topo da página, use: {{topo}}.

Observação: só é necessário incluir o código uma única vez na página, em qualquer local.

Para criar um ícone de download, use: {{download|link=LINK|texto=TEXTO EXPLICATIVO}}. Download.pngCheck-list
Link para página com orientações sobre assinaturas:

{{assinatura}}

Veja aqui como assinar documentos
Link utilizando uma imagem:

[[Arquivo:Logo Calendário 2020 retang.png|200px|link=http://dcom.proad.ufsc.br/calendario-de-compras/]]

Logo Calendário 2020 retang.png

Notas de rodapé

Lembrando:

  • Sendo referência (legislação, normativas), colocar como nota de rodapé, sem repetição;
  • Sendo link para site externo, link normal;
  • Sendo link para a própria wiki, usar wikilink;
  • Atentar para multireferências a notas, para não haver repetição.

Ajuda: https://www.mediawiki.org/wiki/Help:Cite

Códigos especiais para a Nova Lei de Licitações

  • {{novalei}}
    Insere o texto Lei n. 14.133, de 1º de abril de 2021 e uma nota de rodapé para a Nova Lei


  • {{novalei|[LINK_DO_ARTIGO Texto a ser exibido]}}
    Insere o texto Lei n. 14.133, de 1º de abril de 2021, uma nota de rodapé para a Nova Lei, além de um link para o trecho específico da legislação
    Exemplo:
    Código: {{novalei|[https://www.planalto.gov.br/ccivil_03/_ato2019-2022/2021/lei/l14133.htm#art75ii Art. 75, II]}}
    Resultado: Lei nº 14.133, de 1º de abril de 2021[1]Art. 75, II


  • {{novaleiref}}
    Insere somente a nota de rodapé para a Nova Lei


  • {{novaleiref|[LINK_DO_ARTIGO Texto a ser exibido]}}
    Insere a nota de rodapé para a Nova Lei e um link para o trecho específico da legislação
    Exemplo:
    Código: {{novaleiref|[https://www.planalto.gov.br/ccivil_03/_ato2019-2022/2021/lei/l14133.htm#art75ii Art. 75, II]}}
    Resultado: Este é um exemplo de nota de rodapé para a Nova Lei[1]Art. 75, II



Referências (exemplo)


  • Para criar uma nota de rodapé, utilize as tags <ref></ref>
Código Resultado
Este é o texto principal<ref>e esta é uma nota de rodapé</ref>. Este é o texto principal[1].


  • Também pode ser utilizada a tag {{ref}}
Código Resultado
Esta é uma nota de rodapé incrementada{{ref|NOMENOTA|Este é o texto da nota de rodapé [https://compras.ufsc.br com link, se necessário]|[https://compras.ufsc.br/calendario-de-compras Art. 123]}}. Esta é uma nota de rodapé incrementada[2]Art. 123


  • Para exibir as notas, utilize a tag {{referencias}} no final do texto.
Código Resultado
{{referencias}} =Referências=
  1. e esta é uma nota de rodapé
  2. Este é o texto da nota de rodapé com link, se necessário
  • Se a mesma nota de rodapé for utilizada mais de uma vez, inclua o nome dentro da tag <ref> na primeira e nas próximas utilize apenas a tag <ref name=nomedareferencia />.
Código Resultado
Esta nota<ref name=NOME>Esta nota foi utilizada 2 vezes.</ref> será utilizada duas<ref name=NOME /> vezes.

{{referencias}}

Esta nota[1] será utilizada duas[1] vezes.

Referências

  1. a b Esta nota foi utilizada 2 vezes.

Abas

Para utilizar o layout de abas, utilize o código conforme abaixo:

<tabs>

<tab name="Aba 1">
Conteúdo da Aba 1
</tab> <== NÃO ESQUEÇA DE FECHAR A TAG DA ABA 

<tab name="Aba 2">
Conteúdo da Aba 2
</tab>

<tab name="Aba 3">
Conteúdo da Aba 3
</tab>

</tabs> <== NÃO ESQUEÇA DE FECHAR A TAG GERAL <tabs></tabs>

Exemplo:
<tabs>

<tab name="Aba 1">
Conteúdo da Aba 1
</tab> <== NÃO ESQUEÇA DE FECHAR A TAG DA ABA 

<tab name="Aba 2">
Conteúdo da Aba 2
</tab>

<tab name="Aba 3">
Conteúdo da Aba 3
</tab>

</tabs>

==Avisos e destaques==

Para inserir avisos e destaques no texto, utilize os seguintes códigos:

===Destaques no texto dentro da linha===
* <code><nowiki>{{destaque|info|TEXTO}}</nowiki></code> -> Este é um texto de {{destaque|info|TEXTO}} exemplo.
* <code><nowiki>{{destaque|alerta|TEXTO}}</nowiki></code> -> Este é um texto de {{destaque|alerta|TEXTO}} exemplo.
* <code><nowiki>{{destaque|erro|TEXTO}}</nowiki></code> -> Este é um texto de {{destaque|erro|TEXTO}} exemplo.
* <code><nowiki>{{destaque|ok|TEXTO}}</nowiki></code> -> Este é um texto de {{destaque|ok|TEXTO}} exemplo.

===Avisos===
''Obs.: o texto pode ser de uma ou mais linhas e pode conter formatação, links, imagens, tabelas, entre outros.''

* <code><nowiki>{{aviso|info|TEXTO}}</nowiki></code>
{{aviso|info|TEXTO}}
* <code><nowiki>{{aviso|alerta|TEXTO}}</nowiki></code>
{{aviso|alerta|TEXTO}}
* <code><nowiki>{{aviso|ok|TEXTO}}</nowiki></code>
{{aviso|ok|TEXTO}}
* <code><nowiki>{{aviso|erro|TEXTO}}</nowiki></code>
{{aviso|erro|TEXTO}}


* <code><nowiki>{{alertafundobranco|TEXTO}}</nowiki></code>
{{alertafundobranco|TEXTO}}


* <code><nowiki>{{artigo|TEXTO}}</nowiki></code>
{{artigo|TEXTO}}


* <code><nowiki>{{video|TEXTO}}</nowiki></code>
{{video|TEXTO}}


* <code><nowiki>{{planilha|TEXTO}}</nowiki></code>
{{planilha|TEXTO}}

==Tabelas==

Para fazer uma tabela como a que segue, verifique o código fonte:

{| class="wikitable" style="background-color: WHITE" <!-- INÍCIO DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->

|- style="text-align:center; background-color: #4f81bd; color: WHITE; font-weight: bold" <!-- TÍTULOS DAS COLUNAS. NÃO EDITE ESTA LINHA DE CÓDIGO -->
| PRIMEIRA COLUNA
| SEGUNDA COLUNA
| TERCEIRA COLUNA

|- <!-- PRIMEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! LINHA 1 COLUNA 1
| LINHA 1 COLUNA 2
| LINHA 1 COLUNA 3

|- <!-- SEGUNDA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! LINHA 2 COLUNA 1
| LINHA 2 COLUNA 2
| LINHA 2 COLUNA 3

|- <!-- TERCEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! LINHA 3 COLUNA 1
| LINHA 3 COLUNA 2
| LINHA 3 COLUNA 3

|} <!-- FIM DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO-->

Outro exemplo com formatações:

{| class="wikitable" style="background-color: WHITE" <!-- INÍCIO DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->

|- style="text-align:center; background-color: #4f81bd; color: WHITE; font-weight: bold" <!-- TÍTULOS DAS COLUNAS. NÃO EDITE ESTA LINHA DE CÓDIGO -->
| style="width: 10%"| COLUNA MENOR
| style="width: 90%"| COLUNA MAIOR

|- <!-- PRIMEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! Para alterar o tamanho das colunas:
| Utilize o código <code><nowiki>style="width: XX%"|</nowiki></code> antes do texto do título da coluna.

A soma dos percentuais de todas as colunas deve ser igual a 100.

|- <!-- SEGUNDA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
| Célula sem destaque começa com <code><nowiki>|</nowiki></code>
! Célula com destaque começa com <code><nowiki>!</nowiki></code>

|- <!-- TERCEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! style="text-align:left" | Texto da célula com destaque é centralizada automaticamente
| style="text-align:right" | Para alterar o alinhamento, use o código <code><nowiki>style="text-align:center OU left OU right" |</nowiki></code> antes do texto da célula.

|- <!-- QUARTA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! Células com várias linhas de texto
| Não é necessário colocar <code><nowiki>|</nowiki></code> para incluir nova linha dentro da mesma célula.

Basta iniciar uma nova linha sem nenhum código no início, como num texto normal.

O conteúdo da célula aceita:
* listas;
* {{infopequena|destaques}};
* imagens: [[Arquivo:ok.png|50px|link=]];
* e outros. 

|} <!-- FIM DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO-->

A tabela pode ter uma formatação de linhas e colunas diferente do padrão, usando os códigos <code>colspan</code> e <code>rowspan</code> antes do texto da célula.
* <code>colspan="XX" |</code>: a célula irá ocupar XX colunas.
* <code>rowspan="XX" |</code>: a célula irá ocupar XX linhas.

{| class="wikitable" style="background-color: WHITE" <!-- INÍCIO DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->

|- style="text-align:center; background-color: #4f81bd; color: WHITE; font-weight: bold" <!-- TÍTULOS DAS COLUNAS. NÃO EDITE ESTA LINHA DE CÓDIGO -->
| PRIMEIRA COLUNA
| SEGUNDA COLUNA
| TERCEIRA COLUNA

|- <!-- PRIMEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! colspan="2" | LINHA 1 COLUNA 1 e 2
| LINHA 1 COLUNA 3

|- <!-- SEGUNDA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! LINHA 2 COLUNA 1
| LINHA 2 COLUNA 2
| rowspan="2" | LINHA 2 e 3 COLUNA 3

|- <!-- TERCEIRA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! LINHA 3 COLUNA 1
| LINHA 3 COLUNA 2

|- <!-- QUARTA LINHA DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO -->
! colspan="3" | LINHA 4 COLUNA 1, 2 e 3

|} <!-- FIM DA TABELA. NÃO EDITE ESTA LINHA DE CÓDIGO-->

[[Arquivo:Dedo apontando.png|30px|link=]]Existem editores no formato MediaWiki que podem ajudar a elaborar código para tabelas mais complexas, como, por exemplo: https://www.tablesgenerator.com/mediawiki_tables

==Texto ocultável==

Use o código <code><nowiki>{{oculto|TEXTO VISÍVEL|TEXTO OCULTO}}</nowiki></code>

ou

<code><nowiki>{{oculto</nowiki></br>
<nowiki>|TEXTO VISÍVEL</nowiki></br>
<nowiki>|TEXTO OCULTO</nowiki></br>
<nowiki>}}</nowiki></code>

Exemplos:

{{oculto|TEXTO VISÍVEL|TEXTO OCULTO}}

{{oculto
|'''1. Documento de oficialização de demanda com justificativa e estudo de
eficiência, viabilidade e economicidade da aquisição via Adesão, incluindo nº do PGC'''
|O '''Documento de Formalização de Demanda''' (DFD) deve conter o que é exigível no modelo disponível no sítio eletrônico do
DCOM, na seção [http://dcom.proad.ufsc.br/formularios/ '''formulários''']. Ressaltamos, entretanto, a necessidade expressa dos seguintes aspectos:<br>
• Argumentação que expresse uma situação emergencial; e/ou <br>
• Descrição de situação em que a universidade poderá ser onerada; e <br>
• O não descumprimento dos prazos estipulados no Calendário de Compras; e <br>
• Nºs PGC.<br><br>
Além disso, em observância ao art. 22, § 1º-A do Decreto nº 7.892/2013, deverá
contemplar estudo que demonstre:<br>
• O '''ganho de eficiência''' (adequação da modalidade Adesão à necessidade, em detrimento de outras modalidades para compras);<br>
• A '''viabilidade''' (disponibilidade financeira para o atendimento da necessidade) e <br>
• A '''economicidade''' (melhor aproveitamento dos recursos).
<br><br>
'''Conforme o [http://www.planalto.gov.br/ccivil_03/_Ato2015-2018/2018/Decreto/D9488.htm Decreto nº 9.488/2018], a aprovação da solicitação de Adesão à Ata de Registro de Preços fica condicionada à apresentação de "estudo, pelos órgãos e pelas entidades que não participaram do registro de preços, que demonstre o ganho de eficiência, a viabilidade e a economicidade para a administração pública federal da utilização da ata de registro de preços".'''

{{alerta|Caso os itens não constem no PAC da UFSC, acesse a seção [[PLANO ANUAL DE CONTRATAÇÕES (PAC)#Como faço para cadastrar um item no PAC do ano corrente após o fechamento do sistema PGC?|"Como faço para cadastrar um item no PAC do ano corrente após o fechamento do sistema PGC?"]] para verificar o procedimento. '''Itens não constantes no PAC da UFSC do ano corrente não poderão ser adquiridos''', conforme disposto na IN nº 1/2019/SEGES/ME.}}
}}

==Página Principal - Índice/Sumário/Conteúdo==
<tabs>

<tab name="Criação da Página Principal">
[[Arquivo:Site-paginaprincipal.png|Exemplo de Página Principal|miniaturadaimagem|400px]]
A Página Principal é bloqueada para edição, sendo permitida apenas para os usuários com nível de Administrador (Páginas Especiais/Lista de usuários).

A Página Principal é composta de uma tabela com duas colunas (a coluna do sumário e a dos botões), e é constituída com o seguinte código:

<syntaxhighlight lang="html" line>
__NOTOC__ 
{{topo}}
<!-- INÍCIO DA TABELA GERAL -->
{| class="sumario"
<!-- INÍCIO DA COLUNA DO SUMÁRIO -->
| class="coluna-sumario" | 
=============
GRUPOS DE ASSUNTO DO SUMÁRIO A SEREM INSERIDOS
=============
<!-- FIM COLUNA DO SUMÁRIO -->
<!-- INÍCIO DA COLUNA DE BOTÕES --> 
| class="coluna-botoes" |
=============
BOTÕES A SEREM INSERIDOS
=============
<!-- FINAL DA COLUNA DE BOTÕES -->
|} <!-- FINAL DA TABELA GERAL -->

</tab>

Exemplo de grupo de assunto

Para a coluna do sumário, são adicionados grupos de assuntos individualmente, com o código abaixo:

{{sumario-grupo
| imagem = NOME DO ARQUIVO DE IMAGEM COM EXTENSÃO
| nome = NOME DO GRUPO
| conteudo = 
==========================
INSERIR O CONTEÚDO DO GRUPO
CONFORME ABAIXO
==========================
}}

O conteúdo do sumário pode ter 3 formatos:

  • Linha simples, título exibido igual ao do link wiki, que é o link no formato NOME DA PÁGINA ou NOME DA PÁGINA#Nome da seção interna da página:
{{sumario-linha
| link-wiki = LINK WIKI DO CONTEÚDO
}}
  • Linha simples, com título exibido diferente do link wiki:
{{sumario-linha
| link-wiki = LINK WIKI DO CONTEÚDO
| titulo-se-diferente-do-link-wiki = TÍTULO, SE DIFERENTE DO LINK-WIKI ACIMA 
}}
  • Seção contendo o título a ser exibido que, quando clicado, abre uma lista de opções (o conteúdo interno da página):
{{sumario-com-subtitulos
| titulo = TÍTULO DO CONTEÚDO
| subtitulos =
TÍTULOS INTERNOS DAS PÁGINAS, EM FORMATO DE LISTA E WIKILINKS, COMO ABAIXO:
- TÍTULO PRINCIPAL: *[[NOME DA PÁGINA|TEXTO A SER EXIBIDO]]
- TÍTULO PRINCIPAL: *[[NOME DA PÁGINA#NOME DA SEÇÃO|TEXTO A SER EXIBIDO]]
- TÍTULO SECUNDÁRIO: **[[NOME DA PÁGINA#NOME DA SEÇÃO|TEXTO A SER EXIBIDO]]

EXEMPLO:
*[[COMPRAS PÚBLICAS#PREGÃO ELETRÔNICO|PREGÃO ELETRÔNICO]]
**[[COMPRAS PÚBLICAS#Fornecimento imediato (Pronta-entrega)|Fornecimento imediato (Pronta-entrega)]]
*[[COMPRAS PÚBLICAS#DISPENSA E INEXIGIBILIDADE DE LICITAÇÃO|DISPENSA E INEXIGIBILIDADE DE LICITAÇÃO]]
**[[COMPRAS PÚBLICAS#Dispensa de licitação|Dispensa de licitação]]
}}
  • Se o título exibido for o link para a página, utilize o código abaixo:
{{sumario-com-subtitulos-e-link
| titulo = TÍTULO DO CONTEÚDO (ESTA LINHA PODE SER OMITIDA, E O TÍTULO SERÁ IGUAL AO WIKILINK)
| wikilink = WIKILINK DA PÁGINA PRINCIPAL
| subtitulos =
TÍTULOS INTERNOS DAS PÁGINAS, EM FORMATO DE LISTA E WIKILINKS, COMO ABAIXO:
- TÍTULO PRINCIPAL: *[[NOME DA PÁGINA|TEXTO A SER EXIBIDO]]
- TÍTULO PRINCIPAL: *[[NOME DA PÁGINA#NOME DA SEÇÃO|TEXTO A SER EXIBIDO]]
- TÍTULO SECUNDÁRIO: **[[NOME DA PÁGINA#NOME DA SEÇÃO|TEXTO A SER EXIBIDO]]

EXEMPLO:
*[[COMPRAS PÚBLICAS#PREGÃO ELETRÔNICO|PREGÃO ELETRÔNICO]]
**[[COMPRAS PÚBLICAS#Fornecimento imediato (Pronta-entrega)|Fornecimento imediato (Pronta-entrega)]]
*[[COMPRAS PÚBLICAS#DISPENSA E INEXIGIBILIDADE DE LICITAÇÃO|DISPENSA E INEXIGIBILIDADE DE LICITAÇÃO]]
**[[COMPRAS PÚBLICAS#Dispensa de licitação|Dispensa de licitação]]
}}
Exemplo de botões da Página Principal

Na coluna de botões são colocados links para acessos rápidos, como o site do DCOM, a página do Calendário etc.

Os botões são gerados com o seguinte código:

{{botao
| imagem = NOME DO ARQUIVO DE IMAGEM COM EXTENSÃO
| link = LINK SEMPRE NO FORMATO EXTERNO (http://.......)
| texto = TEXTO DO BOTÃO
}}

</tabs>

Outras dicas de código

Para incluir algum código que não será interpretado como sintaxe pela wiki: <nowiki> (antes), e </nowiki> (depois)

Para incluir comentários no código, que não aparecerão na página (para ajudar na compreensão do código pelos outros contribuidores): <!-- Isso é um comentário -->


Páginas em construção

POR ONDE COMEÇAR? (EM TESTE)

NOVA METODOLOGIA DOS PEDIDOS (TESTE)

FLUXO PRÉVIO - NOVO

Página de teste

Teste - decision tree