Mostrar código-fonte de Guia de Utilização da aprendIS

Este Guia de Utilização apresenta as regras básicas para tirar o melhor partido das potencialidades desta Wiki.


Para mais dicas sobre '''edição''' de páginas, consulte o [http://www.mediawiki.org/wiki/Help:Editing Guia de Edição] da MediaWiki.
<br>
Para aprender mais sobre como utilizar '''semântica''' , consulte o [http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Quick_start_guide Guia Semântico] da MediaWiki.


== Criação de Páginas ==

* '''Através do uso de wikilinks'''

A wiki permite estabelecer ligações internas entre as páginas através do uso de uma simples sintaxe - envolver o nome de uma página em duplos parêntesis retos, '''<nowiki>[[assim]]</nowiki>'''. Se for criado um link para uma pagina que não existe, ele aparecerá a vermelho, <span style="color:red;">assim</span>. 
<br>
Para criar o novo artigo, então, basta clicar no link a vermelho para abrir a página de edição, digitar o texto pretendido e fazer "Gravar página". Uma vez criada a nova página, o link passará a aparecer a azul, <span style="color:blue">assim</span>.


Esta é, tipicamente, a melhor forma de criar uma nova página, porque garante, à partida, que o novo artigo estará ligado a partir de um qualquer lado na wiki.


* '''A partir da barra de pesquisa'''

Introduzir o nome de uma página que não existe na barra de pesquisa (canto superior direito da janela), fornece um link para a sua criação.


* '''Usando o URL'''

É possível criar páginas através dos URL's da wiki.


O URL de um artigo na wiki tem, normalmente, o seguinte aspeto: <span style="color: blue;"><nowiki>http://www.aprendis.gim.med.up.pt/index.php/ARTIGO</nowiki></span>.
<br>
Para criar uma nova página, basta, então, substituir "ARTIGO" pelo nome da página que deseja criar. Isto leva, à semelhança do que acontece nos exemplos anteriores, a uma página em branco que pode ser editada com o conteúdo pretendido.


* '''Criar redirecionamentos'''

A criação de redirecionamentos é de extrema importância, na medida em que permite que outras pessoas pesquisem um dado artigo utilizando uma outra expressão.


Por exemplo, a página para a Classificação Internacional de Doenças existente na wiki, pode ser pesquisada tanto pela sigla - '''ICD''' -, como pela designação completa - '''International Classification os Diseases'''.
<br>
A utilização de redirecionamentos permite, assim, que os artigos sejam encontrados mais facilmente, independentemente das preferências de pesquisa.

== Edição de páginas ==

A edição de páginas na MediaWiki é extremamente simples. Basta:
# Clicar na aba "'''Editar'''" no topo, do lado direito da página,
# Fazer as edições necessárias,
# E clicar na opção "'''Gravar Página'''", no fundo da página.


* '''Edição do Resumo'''

A edição do "'''Resumo'''", que aparece no final de cada página, é armazenado juntamente com as edições feitas por cada utilizador e permite seguir com maior eficiência as mudanças que são feitas aos conteúdos. 
<br>
Para isso, basta que seja preenchido com uma pequena indicação das mudanças que foram feitas, como por exemplo: "correção de um erro ortográfico" ou "adição de mais informação sobre o tema X".



* '''Antever Resultado'''

A opção "'''Antever resultado'''" permite perceber como vão ficar as modificações feitas às páginas antes de as gravar. A utilização deste botão está, também, relacionada com o mapeamento de edições.


De cada vez que uma edição é gravada, ela é registada como uma edição separada. Isto não é grande motivo de preocupação, mas a previsão dos resultados permite aperfeiçoar as alterações, eliminando a necessidade de criar novas edições e, por consequência, novos registos de edições, apenas para fazer correções menores.


* '''Mostrar Alterações'''

Outra opção que, à semelhança da anterior, permite fazer uma melhor gestão do mapa de edições, é "'''Mostrar alterações'''". Esta permite comparar a nova versão de uma página com a versão anterior, isto é, comparar a versão com as novas alterações com a versão sem essas mesmas alterações.
<br>
Uma vez mais, isto permite que o utilizador se certifique de que as suas edições são as pretendidas e de que aparecem como deveriam antes de as gravar.


== Formatação de Páginas ==

A formatação de texto nas páginas wiki pode ser feita através dos botões de edição que aparecem no canto superior esquerdo do espaço de edição ou utilizando a chamada '''wiki markup'''. Esta ''linguagem'' consiste num conjunto de símbolos, como asteriscos, apóstrofes ou sinais de igual que desempenham uma função especial nas wikis, muitas vezes dependendo da sua posição.


=== Formatação de Texto ===

----

==== Formatação de Caracteres ====

: <u>Texto em itálico</u>

::: <nowiki>''itálico''</nowiki>'' = ''itálico''


: <u>Texto em negrito</u>

::: <nowiki> '''negrito''' </nowiki> = '''negrito'''


: <u>Texto em itálico e negrito</u>

::: <nowiki> '''''itálico negrito''''' </nowiki> = '''''itálico negrito'''''


: <u>Texto rasurado</u>

::: <nowiki> <strike>texto rasurado</strike> </nowiki> = <strike>texto rasurado</strike>


: <u>Texto sem wiki markup</u>

::: <nowiki> <nowiki>''texto sem markup''</nowiki> </nowiki> = <nowiki>''texto sem markup''</nowiki>


==== Formatação de Secções ====

: <u>Cabeçalhos em diferentes níveis</u>

Para criar cabeçalhos automaticamente, basta colocar o título do cabeçalho entre sinais de igual, assim: '''<nowiki>= Cabeçalho de nível 1=</nowiki>'''.

O nível do cabeçalho é determinado pelo número de sinais de igual utilizados, sendo que um cabeçalho de nível 4, por exemplo, se define da seguinte forma: '''<nowiki>==== Cabeçalho de nível 4 ====</nowiki>'''.
<br>
Quanto maior o número de sinais utilizados, mais se desce na escala/hierarquia e menor será o tamanho do cabeçalho.


Para as páginas que contenham 4 ou mais cabeçalhos, é criado um índice (ou tabela de conteúdos) automaticamente.


: <u>Separador horizontal</u>

Um separador horizontal é uma linha que atravessa a página horizontalmente, podendo ser útil para fazer separação entre conteúdos numa mesma página.
<br>
O separador é definido da seguinte forma:

<blockquote>
texto antes
<br>
<nowiki> ---- </nowiki>
<br>
texto depois
</blockquote>

A aparência do separador é conforme se mostra abaixo:

<blockquote>
texto antes
----
texto depois
</blockquote>


: <u>Lista de pontos</u>

Para criar uma lista de pontos (''bullet list''), utilizam-se asteriscos '''<nowiki>*</nowiki>'''. Quantos mais asteriscos forem utilizados, maior será o avanço do ponto.


Esta lista, por exemplo...
<br>
<nowiki>* Ponto a</nowiki>
<br>
<nowiki>** Ponto aa</nowiki>
<br>
<nowiki>*** Ponto aaa</nowiki>
<br>
<nowiki>* Ponto b</nowiki>


... fica assim:
* Ponto a
** Ponto aa
*** Ponto aaa
* Ponto b


: <u>Lista numerada</u>

Para criar uma lista numerada, utiliza-se o sinal de cardinal '''<nowiki>#</nowiki>'''. Quantos mais sinais de cardinal forem utilizados, maior será o avanço, à semelhança do que acontece com o exemplo anterior.


Esta lista, por exemplo...
<br>
<nowiki># Ponto a</nowiki>
<br>
<nowiki>## Ponto aa</nowiki>
<br>
<nowiki>## Ponto ab</nowiki>
<br>
<nowiki># Ponto b</nowiki>


... fica assim:
# Ponto a
## Ponto aa
## Ponto ab
# Ponto b


: <u>Lista de definições</u>

Uma lista de definições define-se da seguinte forma:
<br>
<nowiki>; item 1</nowiki>
<br>
<nowiki>: definição do item 1</nowiki>
<br>
<nowiki>; item 2</nowiki>
<br>
<nowiki>: definição do item 2</nowiki>


O resultado é este:
; item 1
: definição do item 1
; item 2
: definição do item 2


: <u>Avanço do texto</u>

Criar avanços no texto pode ter muitas utilidades, desde criar hierarquias ou dependências entre os conteúdos, demarcar parágrafos ou até simplesmente organizar a aparência do texto.
<br>
Mas como é que isso se faz? É muito simples:

<blockquote>
'''<nowiki>:</nowiki>''' Avanço único
<br>
'''<nowiki>::</nowiki>''' Avanço duplo
<br>
Sem avanço

=

: Avanço único
:: Avanço duplo
Sem avanço
</blockquote>

Quanto maior for o número de sinais de dois pontos utilizados, maior será o avanço do texto.


: <u>Parágrafos</u>

A MediaWiki ignora as quebras de linha singulares, isto é, ignora a forma como os parágrafos são assumidos em editores de texto como, por exemplo, o Microsoft Word.
<br>
Na MediaWiki, os parágrafos singulares têm que ser forçados através do uso da tag em HTML '''<nowiki><br></nowiki>'''.


=== HTML ===

----

Alguns termos em HTML também podem ser utilizados para formatar o texto na MediaWiki.


: <u>Texto sublinhado</u>

<nowiki> <ins>Texto sublinhado</ins> ou <u>Texto sublinhado</u> </nowiki> = <u>Texto sublinhado</u>


: <u>Texto rasurado</u>

<nowiki> <s>Texto rasurado</s> ou <del>Texto rasurado</del> </nowiki> = <s>Texto rasurado</s>


: <u>Blockquotes</u>

Os blockquotes podem ser utilizados para destacar uma parte do texto, como por exemplos, blocos de texto citado.

<blockquote>
Texto antes
<br>
<nowiki><blockquote>Carpe Diem</blockquote> </nowiki>
<br>
Texto depois

=

Texto antes
<blockquote>Carpe Diem</blockquote>
Texto depois
</blockquote>


: <u>Comentários</u>

Os comentários só podem ser vistos na área de edição das páginas e podem ser interessantes, especialmente neste contexto de contribuição múltipla, para deixar indicações a futuros contribuidores, para dar explicações adicionais que só interessem aos criadores dos conteúdos, etc.


Os comentários definem-se da sequinte forma:
<blockquote>
<nowiki><!--</nowiki> ''Isto é um comentário'' <nowiki>--></nowiki>
</blockquote>


=== Tabelas ===

----

A construção de tabelas na aprendIS, à semelhança do que acontece com as outras wikis, implica o conhecimento de uma sintaxe própria. Contudo, existe a possibilidade de, usando uma ferramenta online complementar, criar tabelas de forma muito mais simples e automática, sem necessidade de recorrer à sintaxe, o que é especialmente interessante para quem não está familiarizado com este tipo de linguagens.


Para criar tabelas pode, então, usar o ''[http://www.tablesgenerator.com/mediawiki_tables Gerador de Tabelas da MediaWiki]'', sendo que apenas precisa definir o tamanho da tabela (como acontece, por exemplo, com as tabelas do Word) e inserir o texto nas células da mesma. Pode, também, adicionar ou remover linhas ou colunas conforme necessário e estilizar o texto da forma que entender, usando os comandos disponibilizados pela ferramenta, que esta irá gerar o código correspondente em linguagem wiki.
<br>
Depois, é só copiar o código resultante e colá-lo na página de edição da aprendIS.


Ainda assim, se preferir criar as suas tabelas de raíz ou alterar alguma coisa no código criado automaticamente, veja a seguir como o pode fazer.


: <u>Tabelas básicas</u>
A linguagem básica para criar uma tabela é a seguinte:

<blockquote>
<nowiki>{|</nowiki>
<br>
<nowiki>|célula 1</nowiki>
<br>
<nowiki>|célula 2</nowiki>
<br>
<nowiki>|-</nowiki>
<br>
<nowiki>|célula 3</nowiki>
<br>
<nowiki>|célula 4</nowiki>
<br>
<nowiki>|-</nowiki>
<br>
<nowiki>|célula 5</nowiki>
<br>
<nowiki>|célula 6</nowiki> 
<br>
<nowiki>|}</nowiki>
</blockquote>

A aparência de uma tabela básica é, então:

<blockquote>
{|
|célula 1
|célula 2
|-
|célula 3
|célula 4
|-
|célula 5
|célula 6 
|}
</blockquote>


: <u>Cabeçalhos de tabela</u>

Para criar cabeçalhos nas tabelas, substitui-se a barra vertical '''|''' utilizada para marcar o início de cada célula, por um ponto de exclamação '''!'''.

<blockquote>
<nowiki>{|</nowiki>
<br>
<nowiki>!Cabeçalho 1</nowiki>
<br>
<nowiki>!Cabeçalho 2</nowiki>
<br>
<nowiki>|-</nowiki>
<br>
<nowiki>|célula 3</nowiki>
<br>
<nowiki>|célula 4</nowiki>
<br>
<nowiki>|-</nowiki>
<br>
<nowiki>|célula 5</nowiki>
<br>
<nowiki>|célula 6</nowiki> 
<br>
<nowiki>|}</nowiki>

=

{|
!Cabeçalho 1
!Cabeçalho 2
|-
|célula 3
|célula 4
|-
|célula 5
|célula 6 
|}
</blockquote>

Estes cabeçalhos aparecem, por omissão, a negrito e centrados, mas podem ser formatados de outra forma.


=== Imagens ===

----

: <u>Carregar imagens</u>
O primeiro passo para inserir imagens numa página wiki é fazer o seu ''upload'' para os servidores da própria wiki.


Para carregar uma imagem, os seguintes passos devem ser seguidos:
# Selecionar a opção '''Carregar ficheiro''', que aparece debaixo do separador '''Ferramentas''' da barra lateral (lado esquerdo da página, por baixo do logótipo);
# Seleccionar a opção '''Escolher Ficheiro''', disponível na caixa ''Ficheiro de origem'', e localizar a imagem no computador;
# Na caixa ''Descrição do ficheiro'', dar um nome ou alterar o nome da imagem em '''Nome do ficheiro de destino''' (usar um nome descritivo, de preferência);
# Preencher o '''Resumo''', se necessário;
# Selecionar a opção '''Carregar ficheiro'''.


: <u>Editar a página de descrição de uma imagem</u>

Quando uma imagem é carregada para a wiki, uma ''página de descrição do ficheiro'' é automaticamente criada sob o nome atribuído à mesma.
<br>
A '''Página de descrição do ficheiro''' deve ser preenchida com informação sobre qual a origem da imagem, sobre o seu ''copyright status''' ou qualquer outra informação descritiva que possa ser útil.


: <u>Utilizar imagens</u>

Existem algumas opções de sintaxe para inserir as imagens carregadas nas páginas da wiki:
# '''<nowiki>[[Ficheiro:nomedoficheiro.extensão]]</nowiki>''' para mostrar uma imagem nas suas dimensões originais;
# '''<nowiki>[[Multimédia:nomedoficheiro.ogg]]</nowiki>''' para apresentar um link direto para o ficheiro em vez de mostrá-lo, quer este tenha por conteúdo uma imagem ou outros dados. Esta opção também permite, por exemplo, que se faça o download de uma imagem separadamente.


<!-- ==== Opções de edição de imagens ==== -->

=== Referências Bibliográficas ===

----

As referências bibliográficas podem ser introduzidas nas páginas da aprendIS através da tag '''<nowiki><ref></nowiki>'''.


A tag <nowiki><ref></nowiki> insere o texto que encerra como notas de rodapé na secção designada. Essa secção é indicada usando a tag '''<nowiki><references /></nowiki>''' no local onde pretende que apareçam as referências (por norma, no final da página). Caso esta secção não seja definida, as referências não irão aparecer e será exibida uma mensagem de erro a vermelho no final da página.


Para inserir as referências, deve, então, introduzi-las entre as tags <nowiki><ref> e </ref></nowiki>, de acordo com a norma que escolher para referenciar fontes de informação, tal como mostram os seguintes exemplos:
<br>
<blockquote>
''O sol brilha durante o dia''. '''<nowiki><ref>J. Sousa, O Sol (Porto: Jornal do Céu, 2005), 10-1.</ref></nowiki>'''
<br>
''A lua aparece à noite''. '''<nowiki><ref>A. Nunes, "A história da lua", Contos lunares, 22 (Abril, 2010).</ref></nowiki>'''
</blockquote>


Para fazer aparecer as referências, pode, por exemplo, criar a secção "''Referências Bibliográficas''" e inserir a tag <nowiki><references /></nowiki>, assim:
<blockquote>
<nowiki>== Referências Bibliográficas ==</nowiki>
<br>
<nowiki><references /></nowiki>
</blockquote>


: <u>Múltiplos usos da mesma referência</u>

Para que possa usar a mesma referência mais do que uma vez no artigo, deve atribuir-lhe um identificador único através da tag '''<nowiki><ref name="nome"></nowiki>'''.
<br>
Para criar as referências, deve, então, usar esta tag da mesma forma que a tag <nowiki><ref></nowiki>, sendo que apenas precisa introduzir o título da referência da primeira vez e, nas restantes, apenas a tag, tal como mostra o exemplo a seguir:
<blockquote>
''Este é um exemplo de uma mesma referência usada múltiplas vezes''.'''<nowiki><ref name="exemplo">B. Silva, "Referências Bibliográficas 101", Manual de coisas (Abril, 2016).</ref></nowiki>'''
<br>
''Esta citação pertence à mesma referência que a de cima''.'''<nowiki><ref name="exemplo" /></nowiki>'''
<br>
''Esta citação também''.'''<nowiki><ref name="exemplo" /></nowiki>'''
</blockquote>


Para fazer aparecer, usa-se a tag <nowiki><references /></nowiki> na área destinada e o resultado é o seguinte:

<blockquote>
''Este é um exemplo de uma mesma referência usada múltiplas vezes''.<ref name="exemplo">B. Silva, "Referências Bibliográficas 101", Manual de coisas (Abril, 2016).</ref>
<br>
''Esta citação pertence à mesma referência que a de cima''.<ref name="exemplo" />.
<br>
''Esta citação também''.<ref name="exemplo" />


<u>Referências Bibliográficas</u>
<references />
</blockquote>


<div style="font-size: 80%;">Nota: Se a primeira referência, que dá o nome ao conjunto, for apagada, todas as seguintes perderão o seu efeito.</div>


== Movimentação de Páginas ==

'''Mover uma página''' significa dar-lhe um novo nome. Para tal, basta:
# Selecionar o separador "'''Mover'''" (opções adicionais podem ser encontradas no separador com um triângulo invertido do lado esquerdo da barra de pesquisa),
# Introduzir o novo nome,
# Selecionar "'''mover página'''".

Quando se move uma página, é importante saber que não só se altera o nome da mesma, como se move todo o seu conteúdo e o histórico de edições. Isto não acontece se apenas se copiar e colar conteúdos em diferentes páginas, podendo perder-se a informação sobre quem criou que conteúdo e quando.


Uma vez que esta operação resulta num redirecionamento, não deverão ocorrer quebras nos links. De qualquer forma, o utilizador deve verificar links noutras páginas que apontam para a página redirecionada e corrigir, se necessário.


== Wiki Semântica ==

=== Como criar classes/categorias ===

----

A forma mais fácil de criar uma classe/categoria , assim como todos os outros elementos semânticos associados a essa mesma classe, é fazê-lo a partir da página '''[[Especial:CreateClass]]'''.
<br>
Esta página especial permite criar, a partir de um único sítio, todas as propriedades, predefinições formulários e categorias de forma automática. Basta, para isso, preencher os campos que são apresentados e fazer "'''Criar'''".
<br>
Para associar conteúdo aos elementos semânticos criados, deve aceder-se ao formulário respetivo e começar a introduzir a informação pretendida.


As classes, e só as classes, podem também ser criadas através de um simples <u>código inserido na página ou páginas que se pretendem classificar</u>.
<br>
Para criar uma classe usando código basta inserir '''<nowiki>[[Categoria:Nome da Classe/Categoria]]</nowiki>''' entre parêntesis retos (dois de cada lado). Esta ficará ativa a partir do momento em que a página for guardada.
<br> A uma mesma página, podem ser associadas as classes/categorias que se entender serem necessárias.


Para cada classe/categoria criada, é criada uma página sob esse nome, que agrega, em forma de lista por ordem alfabética, todas as páginas classificadas/categorizadas por essa mesma classe/categoria.


=== Como criar propriedades ===

----

As propriedades semânticas são os blocos básicos de construção de qualquer site semântico, pois permitem que se façam ligações entre os dados. Isto, por sua vez, permite a articulação destes mesmo dados uns com os outros, promovendo a criação de contexto, de sentido.
<br>
Uma '''propriedade''' é, assim, uma "característica" única e específica de uma dada peça de informação.


As propriedades podem ser criadas através da página especial '''Especial:CreateProperty'''.
<br>
O nome da propriedade, o tipo e algumas restrições podem ser determinadas a partir desta página.

=== Como criar predefinições ===

----

As predefinições dão "corpo" às propriedades. Elas são responsáveis por transformar os dados em informação semântica de facto e, muitas vezes, definem uma página como sendo de uma determinada categoria e de um determinado tipo.
<br> As predefinições permitem, ainda, agregar informação, disponibilizando uma lista de todas as outras páginas que tenham algum tipo de relação com a página a que uma dada predefinição está associada.


A forma mais simples de criar uma predefinição é através da página especial '''Especial:CreateTemplate'''.
<br> A partir desta página, é possível, então, determinar quais as propriedades que pertencem à predefinição, determinar como elas devem aparecer, assim como estabelecer mais alguns requisitos se necessário, entre outras coisas.


=== Como criar formulários ===

----

Construídas as propriedades e as predefinições, passa a ser possível construir os formulários. Os formulários permitem aos utilizadores criar e editar páginas dos mais diversos tipos, de forma muito simples.
<br>
Deve existir um formulário por cada tipo de página. O formulário é responsável por "popular" a predefinição (ou predefinições) contida no tipo de página em questão.


Os formulários podem ser criados, à semelhança do que acontece com os casos anteriores, a partir de uma página especial. Neste caso, a página é '''[[Especial:CreateForm]]'''.


: <u>Como usar os formulários</u>

Para começar a tirar partido dos benefícios da '''semântica''', ela precisa então de ser associada às páginas. E isso é feito a partir dos formulários.


Para associar um formulário a uma página, deve chamar o formulário inserindo a expressão '''form:''Nome do formulário''''' na barra de pesquisa.
<br>
Se não souber ou não se recordar do nome do formulário, pode escrever apenas a expressão '''form:''' na barra de pesquisa e será apresentada uma lista dos formulários disponíveis na wiki, a partir da qual pode escolher o que deseja.


Selecionando o formulário, o utilizador será encaminhado para uma nova página, onde deverá inserir o nome da página ou do artigo que pretende editar na barra destinada e clicar no botão "'''Criar ou editar'''".
<br>
O nome da página pode ser o de uma que já exista e à qual pretende adicionar o formulário, ou uma que ainda não existe e que pretende criar a partir do formulário.


: <u>Outras opções de acesso aos formulários</u>

À semelhança do que pode ser feito com uma série de outros elementos da wiki (páginas, utilizadores, ficheiros, etc.), pode usar a ligação "'''[[Especial:Páginas especiais|Páginas especiais]]'''", disponível na secção "'''Ferramentas'''" na barra esquerda da wiki, e consultar a '''Lista de páginas''' para ver quais os formulários semânticos disponibilizados pela wiki.
<br>
Isto pode ser particularmente útil para identificar se o formulário que precisa já está criado ou se é necessário criar um novo.