Tutorial TWikiTutorial TWiki

Marília Silva DantasMarília Silva Dantas

marilia@hidro.ufcg.edu.brmarilia@hidro.ufcg.edu.br

Universidade Federal de Campina Grande

MCT – CT HIDRO - FINEP

Projeto Cisternas

03 e 04 de maio de 2007

Campina Grande - PB

Imagine você um dia poder alterar diretamente o conteúdo de uma web, sem precisar de um programa específico, conhecimentos de programação, ou mesmo de autorização de webmasters de plantão. Hoje isso é possível graças ao TWikiTWiki.

Através do TWiki ganhamos uma descentralização do pólo de emissão das informações, maior liberdade de expressão, e atualização das páginas web de forma muito mais fácil, dinâmica e democrática.

Tutorial TWikiTutorial TWiki

O que é e como utilizar o TWikiO que é e como utilizar o TWiki

O que é o TWiki?O que é o TWiki? O TWiki é uma ferramenta de escrita colaborativa na Web, que consiste

em possibilitar que várias pessoas separadas geograficamente interajam, criando conteúdo utilizando apenas um navegador.

O que é necessário para utilizar o TWiki?O que é necessário para utilizar o TWiki?

Para a edição em TWiki o usuário necessita apenas de um navegador Web, concedendo a quebra das barreiras geográficas para grupos de pesquisadores que querem compartilhar suas informações em um mesmo ambiente na Internet, de uma forma dinâmica e sem a necessidade de software especializado.

WikiNameWikiName WikiName nada mais é do que o seu nome de usuário.

WikiWord ou PalavrasWikisWikiWord ou PalavrasWikis São nomes de tópicos. Um nome do tópico de TWiki tem sempre um formato

fixo: duas ou mais palavras com iniciais maiúsculas e escritas juntas. Ao se criar um WikiWord, cria-se automaticamente um hiperlink para esse novo tópico, isso facilita o manuseio das webs, pois não é necessário saber em qual diretório está o arquivo com o tópico - você apenas digita o nome, assim como também conduz facilmente a tópicos de interesse, já que não é necessário escrever códigos e mais códigos para criar tal link, facilitando até mesmo, ler o texto do tópico quando este estiver em edição.

Conceitos BásicosConceitos Básicos

As ferramentas de trabalho do TWiki estão localizadas sempre no fim do corpo da web como podemos ver na figura abaixo.

Ferramentas de TrabalhoFerramentas de Trabalho

As ferramentas de trabalho são:

•[Edit] – Adiciona ou modifica o tópico

•[Attach image or document] – Anexa arquivos ao tópico

•[Printable version] – vai para uma versão selecionada da página, preparada para impressão

•[Raw text] – Mostra o texto cru, sem converter a formatação

•[More topic actions] – controles adicionais, como [Rename/move], controle de versão e configurações da origem do tópico

•[r1.3 | > | r1.2 | > | r1.1] – mostra uma versão previa do tópico ou a diferença entre duas versões

•[Total page history] – tópicos estão sob controle de revisão – [diffs] mostra o histórico completo de mudanças do tópico, ex. quem mudou o que e quando.

•[Backlinks] - pesquisa quais outros tópicos que linkam a esse link

Ferramentas de TrabalhoFerramentas de Trabalho

Para editar Tópicos TWiki é preciso entrar no modo de edição da página, que de modo geral se acessa através do link [Edit]. O sistema solicitará então seu WikName e Senha de usuário para a autenticação. Como na figura abaixo

Edição de WebsEdição de Webs

Uma vez autenticado, aparece na tela a área de edição.

Daí, basta editar o conteúdo desejado e clicar no botão [Preview Changes] na base da página para prever o resultado da edição. Caso precise corrigir algo clique no botão voltar do navegador e após as alterações clique no [Preview Changes], de novo. Definido o conteúdo, é só confirmar a edição clicando no botão [Save Changes] e pronto!

Edição de WebsEdição de Webs

Para criar um novo tópico (web), é necessário entrar no modo de edição, da mesma forma citada anteriormente, e digitar um novo texto com uma WikiWord (ex: MinhaPagina).

Agora segue-se o mesmo procedimento de edição de webs (verifica-se as alterações [Preview Changes] e salva-se o tópico [Save Changes])

O WikiWord aparecerá com uma tarja amarela e um sinal de interrogação no final, como na imagem abaixo.

Isso significa que o tópico ainda não existe, ao clicar na interrogação entra-se no modo de edição do novo item, daí é só editar (como foi visto no parágrafo anterior).

Criação de WebsCriação de Webs

Embora o TWiki aceite códigos HTML 3.2 e Javascript, ele utiliza uma “linguagem” própria, muito simples e fácil para edição de suas webs.

Vejamos alguns recursos simples de usar que têm o objetivo de melhor organizar os textos e outros elementos no ambiente de edição de uma web desenvolvida em TWiki.

Títulos e subtítulos podem ser formados usando ---++ antecedendo os títulos e ---+++ antecedendo os subtítulos.

Separe cada parágrafo com uma linha em branco.

Três (ou mais) hifens consecutivos expandem-se em uma linha horizontal: ---

Para indicar uma palavra ou frase em negrito, coloque-a entre asteriscos: *negrito*.

Para indicar uma palavra ou frase em itálico, coloque-a entre sublinhados: _itálico_.

Para criar uma lista adicione seus itens um em cada linha no formato: [espaço][espaço][espaço][*][espaço]Texto....

Iniciar itens em uma lista numerada com [espaço][espaço][espaço][1][espaço]Texto.... O "1" (ou qualquer número) será substituído pelo número correto, em ordem. Comece a contar espaços para o "1" do começo de uma nova linha.

Escrita TWikiEscrita TWiki

O TWiki também disponibiliza a opção de anexar qualquer tipo de arquivo em suas webs, isso significa que depois de anexados, estes podem ser abertos, baixados e visualizados. Vejamos como utilizar esse recurso.

Anexar um arquivo no TWiki é exatamente como incluir um arquivo num email.

Clique na ferramenta [Attach]

Clique em Browse para procurar o arquivo

Caso queira criar um link automaticamente para o arquivo na sua web, basta marcar a opção Create a link to the attached file, e no caso de desejar que este arquivo não apareça em uma tabela na web clica-se em Do not show attachment in table.

Em seguida, clique em Upload file, e desça até o final da página e veja se seu anexo está na listagem.

É recomendável que no caso de se anexar uma imagem que deve ser exibida junto com o texto, marcar a opção Create a link to the attached file.

Para mover a disposição da imagem / arquivo em relação ao texto, basta editar o tópico e posicionar a última linha (a linha contém %ATTACHURL%) onde desejar.

Anexando ArquivosAnexando Arquivos

Dicas TWikiDicas TWiki

http://twiki.softwarelivre.org/bin/view/Arte/DicasTWikihttp://twiki.softwarelivre.org/bin/view/Arte/DicasTWiki

http://twiki.im.ufba.br/bin/view/Portugues/TWikiTutorial http://twiki.im.ufba.br/bin/view/Portugues/TWikiTutorial

http://penta2.ufrgs.br/edu/twiki/ http://penta2.ufrgs.br/edu/twiki/

Exemplos de Webs em TWIkiExemplos de Webs em TWIki

Wikipédia - Wikipédia - http://pt.wikipedia.org/http://pt.wikipedia.org/

LSD - LSD - http://http://www.lsd.ufcg.edu.brwww.lsd.ufcg.edu.br//

Projeto SegHidro - Projeto SegHidro - http://seghidro.lsd.ufcg.edu.br/http://seghidro.lsd.ufcg.edu.br/

Laboratório de Hidráulica II - Laboratório de Hidráulica II - http://www.hidro.ufcg.edu.br/hid2/http://www.hidro.ufcg.edu.br/hid2/

Sites RelacionadosSites Relacionados

http://pt.wikipedia.org/wiki/TWikihttp://pt.wikipedia.org/wiki/TWiki

http://twiki.im.ufba.br/bin/view/Portugues/TWikiTutorialhttp://twiki.im.ufba.br/bin/view/Portugues/TWikiTutorial

http://www.colivre.coop.br/bin/view/Tech/TutorialTWikihttp://www.colivre.coop.br/bin/view/Tech/TutorialTWiki

http://penta2.ufrgs.br/edu/twiki/http://penta2.ufrgs.br/edu/twiki/