Índice

O que é um Wiki: Cultura Wiki, Histórico, TWiki

Sobre wiki se compreende uma coleção de softwares colaborativos que se utilizam apenas do aplicativo navegador de internet para sua gerência.

A Cultura Wiki diz que:

• Qualquer pessoa pode deletar toda e quaisquer informações;
• Qualquer pessoa pode "jogar"/usar;
  • Apenas os bons jogadores continuarão jogando...
• Wiki não é WYSIWYG - What you see is what you get, ou seja, "O que você vê é o que você tem";
  • Mas já existe plugin para edição WYSIWYG;
• Wiki não é tempo real;
  • O conteúdo pode ser pensado de forma que o resultado apresentado poderá ter boa qualidade.

TWiki, segundo o seu site oficial (http://TWiki.org), é uma flexível, poderosa, segura e simples plataforma de colaboração baseada na Web. O TWiki pode ser usado para desenvolver projetos, documentações, base de aprendizagem ou outras ferramentas de trabalho em grupo em uma intranet ou na Web.

Utilizando o TWiki, pessoas geograficamente separadas podem trabalhar juntas na construção de conteúdos. O TWiki também possibilita a criação de diversos tipos de aplicações, tais como: controle de tarefas e pendências, agenda compartilhada, sistema de revisão e publicação de textos, acompanhamento de projetos, e outros. O TWiki vem revolucionando o modo como as pessoas trabalham em conjunto através da Internet.

Tudo começou em 1995, quando o Ward Cunningham, criou o WikiWikiWeb e atribuiu o atual significado para os softwares chamados wikis, que editariam páginas Web rapidamente. Ele se inspirou na palavra "wikiwiki", que significa rápido, em havaiano e na expressão "wikiwiki bus" que faz referencia avião, no Aeroporto de Honolulu. Em 1997, foi criado o JosWiki. Em 1998, o TWiki foi criado por Peter Thoeny. Seu nome originou-se de TakeFive Wiki, que é o nome da empresa para qual o Peter Thoeny trabalhava.

O TWiki™, a logomarca TWiki e a tagline "Collaborate with TWiki" são de Peter Thoeny, criador do software. O software é desenvolvido como Software Livre sob a GNU/GPL.

Outros Wikis

Além do TWiki, existem vários outros wikis no mercado:

• Um dos mais conhecidos é a plataforma usada para o desenvolvimento da Wikipedia (http://wikipedia.org), o chamado MediaWiki (htp://www.mediawiki.org/). Lançado em 2002, contribuiu com a sua facilidade de edição para o atual grau de crescimento dessa enciclopédia livre, construída por vários colaboradores ao redor do mundo. Segundo a Wikipédia, o MediaWiki "é um software wiki escrito em PHP utilizando sistemas de gestão de base de dados MySQL, e licenciado sob GPL."
• Existem outros wikis como o Zwiki (desenvolvido em Python, sob GPL, 2002)*, MoinMoin (desenvolvido em Python, sob GPL, 2000) e DokuWiki (desenvolvido em Python, sob GPL, 2004).
  • * (linguagem de desenvolvimento, licença, ano de publicação da primeira versão).
  • Para mais informações veja o quadro de comparações entre wikis, disponível na Wikipédia (http://pt.wikipedia.org/wiki/Comparação_de_softwares_wiki).

Funcionalidades

• Edição ou criação de páginas Web usando apenas o browser;
• Edição fácil usando o botão "Edit";
• Auto-linkagem de WikiWords e URLs;
• Simples formatação de textos;
• Ferramenta de busca para as Web TWiki;
• Notificação de alterações por e-mail;
• Uso de formulário para estruturação de conteúdos;
• Anexação de arquivos;
• Versão de controle;
• Controle de acesso;
• Extensão das funcionalidades com o uso de plugins;
• Variáveis predefinidas;
• Variáveis predefinidas;
• Variáveis definidas pelo usuário;
• Gerenciamento de usuários;
• Gerenciamento de páginas;
• Criação de aplicações;
• Estatísticas;
• Lista de alterações;
• Configurações das páginas;
• Resolução de conflitos, etc.

Casos de Sucesso

A empresa Yahoo! utiliza o TWiki nos seus processos internos de comunicação para gerenciar documentos e projetos de seus produtos. Como o Yahoo! conta com um grande time de desenvolvedores ao redor do mundo, encontram no TWiki uma importante plataforma colaborativa de gerência e comunicação.

Veja, na íntegra, o testemunho do Eric Baldeschwieler, diretor de desenvolvimento de software da Yahoo em http://twiki.org/cgi-bin/view/Main/TWikiSuccessStoryOfYahoo

O TWiki também é usado por equipes de desenvolvimento do grupo de internet da Disney. Inicialmente, foi usado para concentrar anotações e gerenciar informações para a construção do portais como Go.com e Starwave.com.

Outros casos internacionais de sucesso do TWiki é o seu uso pela Motorola, Michelin China, SAP, dentre outros.

No Brasil, o TWiki tem vários outros casos de sucesso:

• Instituto Nacional de Tecnologia da Informação - ITI, que é uma autarquia federal vinculada à Casa Civil da Presidência da República (http://www.iti.br);
• Universidade Federal a Bahia (http://www.twiki.ufba.br);
• Projeto Software Livre Brasil (http://twiki.softwarelivre.org)

A Colivre sempre utilizou o TWiki para hospedar a sua intranet, site oficial, criar documentações como esta, além de prover sites personalizados e fáceis de editar para os seus consumidores.

A Plataforma, WikiWords, Tópicos e Webs

O TWiki é uma plataforma na qual pode-se organizar conteúdos por temas através de webs, que por sua vez são constituídas de páginas chamadas de tópicos.

Os tópicos no TWiki são unicamente identificados pela chamada *WikiWord* (ou PalavraWiki), que podem ser definidas por conjuntos sucessivos de letras maiúsculas e minúsculas, podendo também conter números.

Alguns exemplos: AtaReuniãoGeral20050525, ProgramacaoEvento, WebHome, etc.

O conteúdo de uma página TWiki consiste de textos e opcionalmente de formulários e anexos (imagens, arquivos de áudio, etc). Cada tópico tem uma WikiWord que o identifica unicamente em uma web.

No TWiki, webs são uma coleção de tópicos sob um nome (ou tema) em comum. Várias características, como buscas, privilégios de acesso, plugins disponíveis, template de design, podem ser controlados em Webs próprias.

Analise a URL: http://www.colivre.coop.br/bin/view/Tech/TutorialTWiki

Diferenciando:

• web, TWikiWeb, site: Tech.WebHome, Colivre.QuemSomos
• tópico, página: TutorialTWiki, OQueÉCSS

Registro, Usuários e Grupos

Para editar WikiWebs é necessário possuir uma conta TWiki:

• No tópico TWikiRegistration, na web Main, são criadas as contas TWiki.
• No tópico TWikiUsers, na web Main, existe a lista de todos os usuários do TWiki. No seu tópico pessoal, que de preferência deve ser formado pela junção do primeiro e do último nome, o usuário pode construir seu perfil, portifólio, ou seja, usá-lo como página pessoal.
• No tópico TWikiGroups, na web Main, são listados todos os grupos que podem ser usados para definir o controle de acesso (TWikiAccessControl) no TWiki. O nome do tópico do grupo deve ser uma WikiWord e deve ser terminar em "Group". Exemplo TWikiAdminGroup é o grupo que possui poder administrativos sobre uma instalação do software.

Nota: Pense duas vezes antes de restringir o acesso a escrita para uma Web ou um tópico, por que em um sistema aberto, onde qualquer um pode contribuir é a essência da Cultura Wiki. Experiências mostram que trabalhos com acesso irrestrito de escrita são possíveis pois:

• Existem muitos pontos que levam a postagem de conteúdo apropriado, como identificação da conta que promoveu a alteração, alerta para novas alterações de modo que os demais colaboradores possam acompanhar o desenvolvimento do conteúdo, etc.
• Os conteúdos não são perdidos pois os tópicos estão sob controle de versão.
• Qualquer revisão do tópico pode ser refeita por um membro do TWikiAdminGroup se necessário.

Formatação de textos

Comando de Formatação:	Você escreve:	Você terá:
Parágrafos: Linhas em branco entre blocos de textos criam parágrafos.	1º parágrafo 2º parágrafo	1º parágrafo 2° parágrafo
Títulos: Três ou mais traços (hífens) no início da linha, seguidos por sinais de soma e o texto do título. Um "+" cria títulos de primeiro nível, dois "+" para títulos de segundo nível, etc. O nível máximo para títulos é 6. Pode-se criar uma tabela de conteúdos, ou menu, com a variável %TOC%. Se você quiser excluir um título do menu, acrescente !! depois do ---+. Exemplo: ---++ Títulos vazios são permitidos, mas não irão aparecer na tabela.	---++ TWiki ---+++ Software Livre ---+++!! Não entrará no TOC	TWiki Software Livre Não entrará no TOC
Texto em negrito: Palavras ou frases são mostradas em negrito quando envolvidos por * asteriscos.	*Negrito*	Negrito
Texto em Itálico: Palavras ou frases são mostradas em itálico, quando envolvidas por _ underline ou sublinhado.	_Itálico_	Itálico
Negrito e Itálico: Palavras ou frases são mostrados em negrito itálico, quando envolvidos por dois __ underlines ou sublinhados.	__Negrito Itálico__	Negrito Itálico
Fonte Fixa: Palavras ou frases são mostradas em fonte fixa, quando envolvidas por sinais de igualdade =.	=Fonte Fixa=	Fonte Fixa
Fonte Fixa em negrito: Palavras ou frases são mostradas em fonte fixa em negrito, quando envolvidas por dois sinais de igualdade ==.	==Fonte Fixa em negrito==	Fonte Fixa em negrito
Pode-se fazer a pontuação do texto normalmente após os indicadores de negrito, itálico, etc,(* _ __ = ==). Note se não existem espaços em branco entre o texto e os indicadores.	_Cultura Wiki_, _não funcionará _	Cultura Wiki, _não funcionará _
Texto em Verbatim (Literal): Envolva códigos especiais ou com outras formatações com <verbatim> e </verbatim> tags. tags verbatim tags desabilitam o código HTML. Use <pre> and </pre> tags se quiser que o código HTML seja interpretado. NOTA: De Preferência variáveis (* Set NOME = valor) são setadas dentro de tags verbatim.	<verbatim> class CatAnimal { void purr() { <código aqui> } } </verbatim>	class CatAnimal { void purr() { <código aqui> } }
Separador (Linha Horizontal): Três ou mais traços (hífens) no início da linha	-------

Listas

Comando de Formatação:	Você escreve:	Você terá:
Lista não ordenada: Múltiplos de três espaços, um asteriscos e outro espaço Para todos os tipos de listas, pode-se quebra um item da lista em várias linhas, contanto que não se esqueça de fazer a indentação idêntica ao da primeira linha do item de lista.	* nível 1 * nível 2 * voltou para 1 * Um item quebrado em três linhas * último item de lista	nível 1 nível 2 voltou para 1 Um item quebrado em três linhas último item de lista
Lista Numerada: Múltiplo de três espaços, um caracter, um ponto e outro espaço. Digite Estilo Exemplo de sequência 1. Numerais árabes 1, 2, 3, 4... A. Letras maiúsculas A, B, C, D... a. Letras minúsculas a, b, c, d... I. Numerais romanos maiúsculos I, II, III, IV... i. Numerais romanos minúsculas i, ii, iii, iv...	1. Plataforma 1. Web 1. Tópico A. Plataforma A. Web A. Tópico i. Plataforma i. Web i. Tópico	Plataforma Web Tópico Plataforma Web Tópico Plataforma Web Tópico
Lista de Definição: Três espaços, um símbolo sifrão, um termo, um sinal de dois pontos, um espaço, seguido pela definição.	$ Chimarrão: Rio Grande\ do Sul $ Acarajé: Bahia	Chimarrão Rio Grande do Sul Acarajé Bahia

Tabelas

| *L* | *C* | *R* |
| A2 |  B2  |  C2 |
| A3 |  B3  |  C3 |
| multi span |||
| A5-7 |  5  |  5 |
|^| seis | seis |
|^| sete | sete |
| conteúdo\
  | em\
  | 3 linhas |
| A9 |  B9  |  C9 |

Hipertextualidade: tópicos, web e links externos

O TWiki faz auto-linkagem para as WikiWords. Para escapar da auto-linkagem pode-se usar uma "!" ou a tag HTML "nop" precedendo a palavra Wiki. Exemplo:

!TutorialTWiki
<nop/>TutorialTWiki

Caso não exista na web uma página relacionada a uma WikiWord escrita em um tópico, será mostrada uma "?" após a WikiWord. Com isso, o TWiki lhe indica que o tópico ainda não existe e que pode ser criado clicando-se sobre a interrogação e salvando-se o tópico criado.

Comando de Formatação:	Você escreve:	Você terá:
Links e WikiWords: Palavras com as suas iniciais maiúsculas concatenadas (ou WikiWords) irão produzir automaticamente links se forem envolvidos por espaços em branco ou parênteses. Para linkar uma página de uma outra web escreva Outraweb.NomeTopico. O título do link irá excluir o nome da web, isto é, apenas o nome do tópico será mostrado. Como excesão, p nome da web será mostrada no tópico WebHome. Geralmente, é uma boa idéia usar TWikiVariables %TWIKIWEB% e %MAINWEB% para referenciar a web TWiki e a web Main.	WebStatistics Sandbox.WebNotify Sandbox.WebHome	WebStatistics WebNotify WebHome
Ancoras: Você pode definir uma referência dentro de um tópico TWiki (chamado de ancora) e linká-lo. Para definir uma ancora você deve escrever #NomeDaAncora (deve ser WikiWord) no início de uma linha. Para criar um link para a ancora use a sitaxe [[NomeDoTopico#NomeDaAncora]]. Pode-se omitir o nome do tópico se você estiver trabalhando com o link dentro do mesmo tópico.	[[#MyAnchor][Pule...]] #NomeDaAncora ...para aqui	Pule... ...para aqui
Links Forçados: Você pode criar um link interno forçado usando a sintaxes dos colchetes duplos. É opcional a existência de espaços em branco no texto dentro dos colchetes; o nome do texto é formado pela concatenação das palavras com as iniciais maiúscula, por exemplo, [[tutorial TWiki]] para linkar o tópico TutorialTWiki. Pode-se também referenciar um tópico em uma web diferente e usar âncoras. Para escapar os colchetes duplos, use uma "!" ao lado esquerda dos colchetes.	[[tutorial TWiki]] [[Main.TWiki users]] escapado: ![[tutorial TWiki]]	TutorialTWiki TWikiUsers escapado: [[tutorial TWiki]]
Links Específicos: Pode-se criar links usando-se a notação de colchetes: [[referência][texto]]. A referência suporta links internos (WikiWords, exemplo: TutorialTWiki) e URLs (exemplo: http://colivre.coop.br). As regras sobre Links Forçados são aplicáveis aqui também. Âncoras podem ser usadas para criar link para um lugar específico dentro do tópico.	[[TutorialTWiki][tutorial TWiki]] [[http://gnu.org][GNU]]	tutorial TWiki GNU
Prevenindo Links: Para evitar a linkagem de uma WikiWord, deve-se usar um ponto de exclamação.	!WebHome	WebHome
Desabilitando Links: Pode-se desabilitar automaticamente link das WikiWords utilizando as tags <noautolink> e </noautolink>	<noautolink> CoopTecLivre & TutorialTWiki </noautolink>	CoopTecLivre & TutorialTWiki
Links Mailto: Endereços de e-mail também são linkados automaticamente. Para criar links para e-mail com o assunto, corpo da mensagem ou para emitir o endereço de e-mail, escreva: [[mailto:usuário@domínio][texto descritivo]].	a@b.com [[mailto:a@b.com]\ [Mail]] [[mailto:?subject=\ Hi][Hi]]	a@bSEMSPAM.com Mail Hi

Anexos ou FileAttachment

No TWiki, um tópico pode ter um ou mais arquivos anexados (FileAttachment). A anexação é feita por meio de uma tela (formulário) e os arquivos são armazenados sob controle de versão, assim como os tópicos.

O upload de arquivos é feito usando o link ou botão Attach. Este link leva a tela de anexação, onde se pode escolher o arquivo, adicionar um comentário que esclareça a natureza do arquivo, escolher se um link deve ou não ser criado para o anexo e se este deve ficar visível na tabela de anexo ao final do tópico.

Notas:

• O tópico deve existir previamente à anexação do arquivo;
• Arquivos que possam acarretar risco ao sistema serão renomeados. Exemplo: *.php será renomeado para *.php.txt;
• O TWiki pode limitar o tamanho do arquivo para upload. Isso é configurado na variável 20000 na WebPreferences. O valor padrão é 10Mb. Isso porque arquivos grandes podem deixar o upload muito lento e ocorrer um time out. Aconselha-se usar um FTP para grandes arquivos.
• O caminho do último arquivo anexado é guardado para o caso de uma possível modificação localmente e assim possibilita copiar e colar esse caminho em vez de localizar o arquivo no computador, atualizando-o mais facilmente no TWiki.
• Não existe controle sobre anexos individualmente. Para fazer esse tipo de controle, aconselha-se criar um tópico para cada arquivo e usar restrições de acesso a nível de tópico.

O link criado para o arquivo é adicionado ao final do conteúdo do tópico, mas uma vez anexado, o arquivo pode ser reutilizado quantas vezes se fizer necessário, manipulando-se o link no modo de edição para alteração do seu posicionamento.

Pode-se mover arquivos entre webs e tópicos usando-se o seu relativo link manage ou gerenciar na tabelas de anexos do tópico. Esse link leva à tela de controle do anexo, no qual se deve escolher a opção Move ou Mover e posteriormente, indicar a web e tópico para qual o anexo será enviado e clicar no botão Move ou Mover.

Para deletar um anexo do tópico, igualmente à operação anterior, deve-se usar o manage do arquivo que se quer excluir, escolher a opção remove ou remover e movê-lo para o tópico TrashAttachment, na web Trash.

Para acessar a tela de controle do anexo, caso este esteja com o atributo de permanecer fora da tabela de anexos (ou seja, esteja invisível), deve-se usar o botão attach do tópico. Abaixo do formulário para a anexação de um novo arquivo, existe a tabela com todos os anexos do tópico. Assim tem-se acesso a fazer alterações a partir do link manage do anexo. Caso não esteja invisível a tabela de anexos fica ao final do conteúdo do tópico. Abaixo um exemplo de tabela de anexos:

I	Attachment	Action	Size	Date	Who	Comment
	Sample.txt	manage	0.1 K	22 Jul 2000 - 19:37	UploadingUser	Um exemplo de arquivo texto
	Smile.gif	manage	0.1 K	22 Jul 2000 - 19:38	UploadingUser	Um exemplo de arquivo de imagem

Links para arquivos

Operações sobre os tópicos

• Visualização: http://www.colivre.coop.br/bin/view/Tech/TutorialTWiki
• Pré-visualização: https://www.colivre.coop.br/bin/save/Tech/TutorialTWiki - Não funciona como link.
• Edição: http://www.colivre.coop.br/bin/edit/Tech/TutorialTWiki?t=1179320927
• Anexação: http://www.colivre.coop.br/bin/attach/Tech/TutorialTWiki
• Impressão: https://www.colivre.coop.br/bin/view/Tech/TutorialTWiki?template=viewprint
• Texto Puro - Raw: https://www.colivre.coop.br/bin/view/Tech/TutorialTWiki?raw=on
• Histórico: https://www.colivre.coop.br/bin/rdiff/Tech/TutorialTWiki?type=history
• Mais ações: https://www.colivre.coop.br/bin/oops/Tech/TutorialTWiki?template=oopsmore&param1=6&param2=6
  • Preferências
  • Renomear / Mover
  • Remover
  • Tópico Pai
  • Visualização de revisões
  • Comparar revisões
  • Visualização de revisões anteriores
  • Referências ao tópico

Ferramentas Nativas

• WebTopicList - lista de todos os tópicos em ordem alfabética da web
• WebChanges - lista de tópicos recém alterados nesta web
• WebNotify - para subscrição de envio de um e-mail alerta sobre alterações na web
• WebRss, WebAtom - RSS e ATOM feeds das alterações dos tópicos da web
• WebStatistics - lista de tópicos mais populares, quantidade de visitas e maiores contribuidores da web
• WebPreferences - configuração das preferências da web
  • As configurações gerais do TWiki se encontram na web Main, no tópico TWikiPreferences. Essas configurações são válidas para todas as web da instância do TWiki.
• WebSearch - para buscas na web

Plugins

No TWiki, o que se chama de plugin são as extensões que utilizam a sua API, as demais são denominadas de Add-on.

A seguir alguns plugins do TWiki, para conhecer outros acesse TWiki.InstalledPlugins? .

CommentPlugin

Este plugin insere uma caixa de edição para postagem rápida de comentários nos tópicos nos quais estão escritos. Ou seja, não há necessidade de ir para o modo de edição para adicionar conteúdos na página.

Sintaxe básica: %COMMENT%

Posicionamento

Em relação a tag COMMENT: o mais comum é posicionar em relação a tag. Pode-se usar os parâmetros bellow e above (abaixo e a cima, respectivamente). Ex: %COMMENT{type="bellow"}%

Em relação a uma âncora do TWiki: %COMMENT{type="above" target="Main.PersonalRemarks#InsertHere" }%

Em relação a primeira ocorrência de um texto da página: %COMMENT{type="above" location="Texto Qualquer"}%

Templates

Exemplo de caixa de comentário

A tag %COMMENT{type="below" button="Enviar" target="TutorialTWiki" }% irá resultar em:

Image Gallery Plugin

Este plugin possibilita a criação de uma galeria com as imagens anexadas ao tópico.

A galeria cria miniaturas das imagens para:

• ampliação das imagens;
• navegação pelas imagens: próximo, anterior, primeiro, último e voltar (up);
• ordenação das imagens com a adição da numeração no seu comentário: <número><espaço>-<espaço><comentários>;
• fácil gerenciamento das imagens clicando-se sobre o ponto vermelho localizado no seu título;

Além disso é possível customização da aparência da galeria usando-se CSS e HTML, veja mais informações em http://twiki.org/cgi-bin/view/Plugins/CommentPlugin.

Sintaxe

Duas tags da sintaxe básica:

• %IMAGEGALLERY{...}%: renderiza a galeria de imagens
• %NRIMAGES%: retorna o número de imagens anexadas na (lista de) tópicos

Argumento	Descrição
topic	lista separada por vírgula dos tópicos nos quais estão as imagens que devem ser mostradas (padrão: tópico corrente)
limit	número máximo de imagens a serem mostradas (padrão: 0, ou seja, sem limite).
size	tamanho das miniaturas da galeria, pode ser tiny, small, medium, large, huge (padrão: medium)
columns	número de colunas de miniaturas mostradas em cada linhas da galeria (padrão: 4)
docrels	flag para habilitar ou desabilitar a relação de documentos entre as imagens; possíveis valores são on, off, 0, 1 (padrão: on)
maxwidth	largura máxima da imagem mostrada (padrão: 640)
maxheight	comprimento máximo de uma imagem (padrão: 480)
minwidth	largura mínima da imagem mostrada (padrão 0)
minheight	comprimento mínimo da imagem mostrada (padrão: 0)
format	formato html da imagem (padrão: )
titles	Torna o título das imagens on ou off (padrão: on)
title	formato html do título da imagem; "off" esconderá o título das imagens (padrão: $comment ($imgnr/$nrimgs) $reddot)
thumbtitle	formato html do título das miniaturas; "off" esconderá os títulos (padrão: $comment $reddot)
sort	configura a ordem inicial das imagens, pode ser name, date, size ou comment (padrão:date)
reverse	inverte a ordem inicial das imagens, pode ser on ou off (padrão:off)

Exemplo

Tags:

Temos %NRIMAGES{topic="PluginsTWiki"}% imagens na galeria:
%IMAGEGALLERY{columns="3" size="small" topic="PluginsTWiki"}%

Resultado:

Temos 5 imagens na galeria:

Comunicóloga .	Firefox .	Firefox 2 .
Logo TWiki .	Exemplo de edição de tabela com EDITTABLEPLUGIN .

Saiba mais sobre esse plugin, instalação e variáveis em http://twiki.org/cgi-bin/view/Plugins/ImageGalleryPlugin.

Edit Table Plugin

este plugin é útil para edição de tabelas sem a necessidade de se editar todo o tópico. O seu uso torna ainda mais fácil o uso de tabelas TWiki, além de permitir a aplicação de drop down, radio, campo de texto, etc.

Para formatação da tabela pesquise pelo TablePlugin em TWiki.org.

Sintaxe

Sintaxe básica: %EDITTABLE{}%

• header, especifica o cabeçalho da nova tabela. Usado para iniciar a tabela com o uso do botão (sem cabeçalho);
• format, formato das colunas durante a edição da tabela. Uma célula pode ser um campo de entrada de texto, ou um dos tipos a seguir:
  • Campo de entrada de texto (1 linha): text, <tamanho>, <valor inicial>
  • Área de entrada de texto: textarea, <linhas>x<colunas>, <valor inicial>
  • Caixa Drop Down: select, <tamanho>, <opção 1>, <opção 2>, etc, apenas um item pode ser selecionado;
  • Botões Radio: radio, <tamanho*>, <opção 1>, <opção 2>, etc, o tamanho indica o número de botões por linha no modo de edição;
  • Checkboxes: checkbox, <tamanho*>, <opção 1>, <opção 2>, etc, o tamanho indica o número de checkboxs por linha no modo de edição;
  • Etiqueta fixa: label, 0, <label texto>
  • Número de linhas: row, <offset>
  • Data: date, <tamanho>, <valor inicial>, <data no formato DHTML>, "text, 16"for all cells   * =changerows
  • Linhas podem ser adicionadas e removidas se configurado para "on";
  • Linhas podem ser adicionadas e não podem ser removidas se configurado para "add";
  • Linhas não podem ser adicionadas ou removidas se configurado para "off";
• quietsave mostra o botão de Save (salvar) se "on", o esconde se "off";
• include, outros tópicos definindo os parâmetros do EDITTABLE. O primeiro %EDITTABLE% do tópico será usado. Isso é usado quando se tem muitos tópicos com o mesmo formato de tabel e se quer atualizar o formato em um só lugar;
• helptopic, nome do tópico contendo o texto de ajuda mostrado abaixo da tabela quando se edita a tabela. As variáveis %STARTINCLUDE% e %STOPINCLUDE% podem ser usados no tópico para especificar o que é mostrado;
• O padrão é sem texto de ajuda;
• headerislabel, as células de cabeçalho da tabela é mostrado apenas para leitura se "on"; as células de cabeçalho poderão ser editadas ser "off" ou "0". O padrão é "on";
• editbutton configura o botão de edição, por exemplo, "Editar tabela"; pode-se considerar uma imagem botão com texto alternativo "alt", como "Editar tabela, http://www.colivre.coop.br/pub/TWiki/TWikiDocGraphics/edittopic.gif"; pode-se esconder o botão no fim da tabela com "hide" (Nota: O botão é automaticamente escondido se um botão edite estiver presente na célula;

Exemplo

Tag:

%EDITTABLE{ format="| row, -1 | text, 20, inicial | select, 1, um, dois, três, quatro | radio, 3,:-),:-I,:-( | label, 0, %SERVERTIME{"$day $mon $year $hour:$min"}% |" changerows="on" }%

Resultado:

Número	Campo de Texto	Drop down	Mood	Timestamp
1	inicial	um		02 May 2008 15:48
2	texto 1	dois		02 May 2008 15:49
3	texto 2	três		02 May 2008 15:49
4	inicial	quatro		06 May 2008 11:51
5	teste	três		06 May 2008 11:54

A seguir um exemplo de edição de tabela com o EDITABLE que demonstra a utilização do date:

Outros

O TWiki conta com uma enorme variedade de plugins, organizados por tag relativas a sua função. Para a busca por novos plugins, acesse o menu lateral do site TWiki.org. Na web destinadas aos plugins, pode-se fazer os download e ter informações sobre a instalação.

Com os inúmeros plugins pode-se trabalhar com agenda de eventos, formatação de tabelas, operações matemáticas e de tratamento de strings, desenvolvimento, autenticação, etc.

Variáveis do TWiki ou TWikiVariables

A seguir uma lista das variáveis mais utilizadas do TWiki. Para obter a lista completa, visite o site TWiki.org.

• GMTIME -- tempo GM
  • Sintaxe: %GMTIME%
  • Expande para: 19 May 2007 - 20:30
  • Relacionados: DISPLAYTIME, GMTIME{"format"}, SERVERTIME

• GMTIME{"format"} -- tempo GM formatado
  • Sintaxe: %GMTIME{"format"}%
  • Variáveis suportadas:
  • Exemplo: %GMTIME{"$day $month, $year - $hour:$min:$sec"}% expande para 19 May, 2007 - 20:30:33
  • Relacionados: DISPLAYTIME, GMTIME, SERVERTIME

• INCLUDE{"page"} -- inclui outros tópicos ou páginas Web
  • Sintaxe: %INCLUDE{"page" ...}%
  • Relacionados: BASETOPIC, BASEWEB, INCLUDINGTOPIC, INCLUDINGWEB, IncludeTopicsAndWebPages, STARTINCLUDE, STOPINCLUDE
  • Parâmetros suportados:

• INCLUDINGTOPIC -- nome do tópico que inclui o tópico corrente
  • O nome do tópico que inclue o tópico corrente - como o %TOPIC% em caso de não existir inclusão
  • Sintaxe: %INCLUDINGTOPIC%
  • Relacionados: BASETOPIC, INCLUDINGWEB, INCLUDE, TOPIC

• INCLUDINGWEB -- web que inclui o tópico corrente
  • O nome da web do tópico que inclui o tópico corrente - como o %WEB% se não existir inclusão
  • Sintaxe: %INCLUDINGWEB%
  • Relacionados: BASEWEB, INCLUDINGTOPIC, INCLUDE, WEB

• PUBURL -- base da URL dos anexos
  • Sintaxe: %PUBURL%
  • Expande para: http://twiki.colivre.coop.br/pub
  • Exemplo: Você pode referenciar o arquivo anexado de outro tópico com %PUBURL%/%WEB%/OtherTopic/image.gif
  • Relacioandos: ATTACHURL, PUBURLPATH, SCRIPTURL, FileAttachments

• REVINFO{"format"} -- informações sobre a revisão do tópico
  • Sintaxe: %REVINFO{"format"}%
  • Parâmetros suportados:

Variáveis suportadas em format:

• Exemplo: %REVINFO{"$date - $wikiusername" rev="1.1"}% retorna informações sobre a primeira revisão
• Relacionados: REVINFO

• SCRIPTURL -- script URL do TWiki
  • Sintaxe: %SCRIPTURL%
  • Expande para: http://twiki.org/cgi-bin
  • Exemplo: Para uma versão autenticada do tópico corrente use %SCRIPTURL%/viewauth%SCRIPTSUFFIX%/%WEB%/%TOPIC% que expande para http://colivre.coop.br/viewauth/Tech/TutorialTWiki

• SEARCH{"text"} -- busca de conteúdo
  • mostra os resultados de uma busca dentro do tópico
  • Sintaxe: %SEARCH{"text" ...}%
  • Parâmetros suportados : [1]

• Exemplo: %SEARCH{"wiki" web="Main" scope="topic"}%
• Exemplo com formatação: %SEARCH{"FAQ" scope="topic" nosearch="on" nototal="on" header="| *Típico: * | *Sumário: * |" format="| $topic | $summary |"% (mostra resultados em uma tabela com cabeçalho)
• Se o TWiki:Plugins.TablePlugin está instalado, você pode configurar uma variável %TABLE{}% apenas antes de %SEARCH{}% para alternar a saída da pesquisa. Exemplo: %TABLE{ tablewidth="90%" }%
• Relacionado: METASEARCH, TOPICLIST, WEBLIST, FormattedSearch

• [1] Nota: A busca em formulários usa nomes idênticos para as entradas dos campos.
• [2] Nota: A web pode ser excluída de da pesquisa web="all" se você definir a variável NOSEARCHALL=on na WebPreferences.

• STARTINCLUDE -- posição inicial do texto do tópico se incluído
  • Se presente em um tópico incluído, inicia a inclusão dessa posição até o final ou até a localização da variável %STOPINCLUDE%. A visualização normal do tópico é mostrada exceto a própria variável %STARTINCLUDE%.
  • Sintaxe: %STARTINCLUDE%
  • Relacionadas: INCLUDE, STOPINCLUDE

• STOPINCLUDE -- posição final da texto do tópico a ser incluído
  • Se presente no tópico incluído, pára a inclusão nesta localização e ignora o restante do texto. Uma visualização normal do tópico mostra tudo exceto a própria variável %STOPINCLUDE%
  • Sintaxe: %STOPINCLUDE%
  • Relacionados: INCLUDE, STARTINCLUDE

• TOC -- menu de conteúdos do tópico corrente
  • Sintaxe: %TOC%
  • Relacionados: TOC{"SomeTopic"}

• TOC{"Topic"} -- menu de conteúdos
  • Sintaxe: %TOC{"SomeTopic" ...}%
  • Tabelas de conteúdos. Mostra um TOC que é gerado automaticamente baseada nos títulos do tópico. Títulos na WikiSyntax ("---++ texto") e HTML ("<h2>texto</h2>") são usados. Qualquer título com "!!" é excluído do TOC; por exemplo, escreva "---+!! texto" se você não quer listar o título no TOC.

Parâmetros suportados:

• Exemplo: %TOC{depth="2"}%
• Exemplo: %TOC{"TWikiDocumentation" web="TWiki04x01" title="Contents:"}%
• Exemplo: veja TWiki:Sandbox.TestTopicInclude
• Relacionados: TOC

• TOPIC -- nome do tópico corrente
  • Sintaxe: %TOPIC%
  • Expande to: TWikiVariablesNtoZ, renderiza como TWikiVariablesNtoZ
  • Relacionados: BASETOPIC, INCLUDINGTOPIC, TOPICLIST, WEB

• TOPICLIST{"format"} -- tópico de índices da web
  • O "format" define o formato dos itens do tópico. Ele deve incluir as variáveis: $name expande para o nome do tópico; a variável $web expande para o nome da web.
  • Sintaxe: %TOPICLIST{"format" ...}%
  • Parâmetros suportados :

• TWIKIWEB -- nome da web de documentação do TWiki
  • web que contém toda a documentação e configurações em nível de TWiki
  • Sintaxe: %TWIKIWEB%
  • Expande para: TWiki
  • Relacionados: MAINWEB

• USERNAME -- seu nome de usuário
  • TWiki tem 3 formatos para nomes: USERNAME como jsmith, WIKINAME como JohnSmith e WIKIUSERNAME como Main.JohnSmith. Um usuário é denominado TWikiGuest caso o tópico não seja autenticado.
  • Sintaxe: %USERNAME%
  • Espande para: guest
  • Relacionados: REMOTE_USER, WIKINAME, WIKIUSERNAME, TWikiUserAuthentication

• WIKINAME -- seu nome de usuário Wiki
  • O WikiName é o mesmo %USERNAME% caso não seja definido no tópico TWikiUsers da web Main.
  • Sintaxe: %WIKINAME%
  • Expande para: TWikiGuest
  • Relacionados: REMOTE_USER, USERNAME, WIKIUSERNAME, WIKIUSERSTOPIC

Controle de Acesso

As permissões de acesso no TWiki, assim como as outras opções do ambiente, são definidas como variáveis. Existem variáveis para definir o acesso à tópicos e webs. Como é natural, as variáveis que definem as permissões de web como um todo devem ser definidas no tópico WebPreferences e as variáveis que definem as permissões de um tópico podem ser setadas no corpo de qualquer tópico.

As variáveis são:

• DENYWEBVIEW e ALLOWWEBVIEW - definem a visibilidade da web
• DENYWEBCHANGE e ALLOWWEBCHANGE - definem quem edita a web
• TWiki.TWikiDocumentation#Restricting_AccessDENYWEBRENAME e ALLOWWEBRENAME - definem quem renomeia topicos da web
• DENYTOPICVIEW e ALLOWTOPICVIEW - definem a visibilidade do tópico
• DENYTOPICCHANGE e ALLOWTOPICCHANGE - definem quem edita o tópico

Essas variáveis podem receber como valor uma lista de nomes de usuários ou grupos.

Exemplos:

Restringindo a visualização e edição de uma web:
   * Set ALLOWWEBVIEW = Main.BrasilGroup
   * Set ALLOWWEBCHANGE = Main.BrasilGroup

Restringindo a edição de um tópico:
   * Set ALLOWWEBCHANGE = Main.JoseDaSilva, Main.MariaBonita

TWikiForms

No TWiki, formulários são facilmente criados através de Template de Formulários, que são tópicos contendo tabelas, nas quais cada linha se refere a um campo do formulário.

Os passos para a criação de um formulário são:

1. Crie um novo tópico com o nome para o formulário (WikiWord terminado em 'Form'). Ex: NomeForm, EmpresaForm, ServicosForm, etc.
2. Crie uma tabela TWiki, onde cada coluna represente uma elemento de um campo de entrada: Name, Type, Size, Values, mensagem Tooltip, e Attributes.
3. Para cada campo, adicione uma nova linha;
4. Salve o tópico

Antes de utilizar os formulários é necessário listá-lo na variável WEBFORMS da WebPreference do site em questão.

Para acrescentar um formulário em um tópico, deve-se ir no modo de edição e clicar no link "Adicionar Formulário". O formulário aparecerá após o conteúdo do tópico.

Exemplo

Veja a seguir o NoticiaForm do sistema de notícias do PSL-BA.

Wiki Estruturado

O Objetivo de um Wiki estruturado é combinar os benefícios de um Wiki com aplicações de bancos de dados

Podemos caracterizar Wikis e aplicações com BD como:

• Wiki:
  • Conteúdo Orgânico: O conteúdo da estrutura e do texto do site está aberto para edição e evolução
  • Conteúdo aberto: leitores podem refazer conteúdos incompletos ou pobres de informação;
  • Hiper-linkado: muitos links relacionando os conteúdos através de WikiWord
  • Confiável: aberto para qualquer pessoa editar com segurança
• Aplicação com banco de dados:
  • Dados altamente estruturados
  • Relatórios fáceis
  • Workflow (ex: requisição de compra)
  • Controle de acesso

Logo os benefícios de um Wiki estruturado são:

• Flexibilidade para adicionar livremente conteúdos de um formulário como um conteúdo estruturado (e vice-versa)
• Possibilidade de construção de Wiki Applications.

O que são TWikiApplications

Denomina-se TWikiApplication ou Aplicação TWiki, a aplicação criada sobre a plataforma TWiki, através do uso de formulários, expressões regulares, formatação de buscas, criação de tópicos, plugins e outras funcionalidades do TWiki, para automatizar trabalhos colaborativos específicos.

Isso é possível pelo fato do TWiki ser um wiki estruturado. Um wiki que funde os benefícios do wiki e dos bancos de dados, possibilitando a criação maleável e buscas específicas e algumas possibilidades de filtragem.

Um exemplo didático de aplicação no TWiki é o sistema de notícias do site do Projeto Software Livre Bahia (PSL-BA), visite: http://twiki.dcc.ufba.br/bin/view/PSL/SistemaDeNoticias.

Novas Webs

As webs são criadas apenas por usuários administradores, através do tópico ManagingWebs. Após a criação é aconselhável visitar o tópico WebPreferences da nova web para ajustar as restrições e configuraçõ