Warning: Can't find topic SelectTwikiWebs

Manual de Referência do TWiki (01-Dec-2001)

Esta página contém todos os tópicos de documentação, a página completa de referência.
Duplo-clique em qualquer lugar para retornar ao topo desta página.

Note: Leia a versão mais atual deste documento em http://TWiki.org/cgi-bin/view/TWiki/TWikiDocumentation

Tópicos Relacionados: TWikiSite, TWikiHistory, TWikiPlannedFeatures, TWikiEnhancementRequests

Requisitos do Sistema do TWiki

Requerimentos de Servidor e Cliente para o TWiki 01-Sep-2001

Visão Geral

Manter um mínimo de prerequisitos para se rodar o TWiki é necessário para que ele se torne universalmente utilizado.

Requerimentos de servidor

O TWiki é escrito em Perl 5, usa um bom número de comandos de shell, e requer o RCS (Revision Control System), um pacote GNU Free Software. O TWiki é desenvolvido num ambiente GNU/Apache. Ele também funciona com o Microsoft Windows, e não deve apresentar problemas em nenhuma plataforma que cumpra as seguintes exigências mínimas:

A documentação atual cobre apenas o Linux. Um guia de instalação TWikiNoWindows é o próximo projeto.

Requerimentos de Cliente

A instalação padrão do TWiki requer muito pouco de um browser:

• Compatibilidade com HTML 3.2
• Gerador de páginas XHTML 1.0 que são compatíveis com HTML 3.2
• um uso mínimo de JavaScript^? para interfaces de usuário (degrada bem a estética da página)
• sem cookies
• sem CSS

Você pode adicionar recursos facilmente, embora customizando os modelos, por exemplo, enquanto ajustando com precisão os requerimentos de browser para o seu uso.

Problemas Conhecidos

• A nova característica TWikiPlugins^? atualmente não tem guias de compatibilidade para desenvolvedores. Os plugins podem requerir virtualmente qualquer coisa: funções específicas de browser, folhas de estilo (CSS), DHTML, applets Java, cookies, etc.

-- MikeMannix - 15 Sep 2001

parcialmente_traduzido

Guia de instalação do TWiki

Instruções de instalação do TWiki 01-Sep-2001 production release

Visão Geral

Esses passos para instalação são baseados no servidorApache Web server em Linux. TWiki é executado em outros servidores Web e sistemas Unix, e é bem-executado em qualquer SO e servidor que estejam especificados em system requirements. Documentação para outras plataformas é atualmente limitada. Para Windows, confira em TWiki:Codev.TWikiOnWindows. Procure a Web TWiki:Codev para outras dicas de instalação.

Instalação Padrão.

Peça e faça o download da distribuição TWiki 01-Set-2001 em formato Unix ZIP em http://TWiki.org/download.html. (para instalar TWiki em código fonte, para uso em um desenvolvimento de projeto de software, leia TWiki:Codev.SourceForgeHowTo.)

Passo 1: Criar & Configurar os Diretórios

NOTA: Se você não tem acesso aos arquivos de configuração do seu servidor Web - por exemplo, se você está instalando uma conta ISP-hosted - use em seu lugar o Passo 1 alternativo .

• Crie o diretório /home/httpd/twiki e faça o unzip da distribuição TWiki nesse diretório.
• O diretório twiki/bin do TWiki deve ficar definido como um diretório cgi-bin. Adicione /home/httpd/twiki/bin ao arquivo /etc/httpd/httpd.conf com somente a opção ExecCGI.
• O diretório twiki/pub do TWiki deve estar definido como visível como URL. Adicione /home/httpd/twiki ao arquivo httpd.conf com opções de acesso normais (copie de /home/httpd/html ).
• Agora adicione ScriptAlias a /twiki/bin e Alias a /twiki no arquivo httpd.conf .
  NOTA: O ScriptAlias deve vir antes de Alias, senão Apache irá falhar ao definir corretamente /twiki/bin/, ao tratá-lo simplesmente como um sub-diretório de /twiki/ alias.

Exemplo de entradas no arquivo httpd.conf:

 ScriptAlias /twiki/bin/ "/home/httpd/twiki/bin/"
 Alias /twiki/ "/home/httpd/twiki/"
 
    Options +ExecCGI
    SetHandler cgi-script
    AllowOverride all
    Allow from all
 
 
    Options FollowSymLinks +Includes
    AllowOverride None
    Allow from all
 

• Reinicie o Apache usando /etc/rc.d/rc5.d/S85httpd restart .
• Teste que o diretório twiki/bin permite CGI tentando visitá-lo em seu navegador:
  • Digite a URL para o diretório bin, http://yourdomain.com/twiki/bin/.
  • Suas configurações estão corretas se você obtiver uma mensagem como "Forbidden. You don't have permission to access /twiki/bin/ on this server".
  • As configurações NÃO estão corretas se você obtiver algo como "Index of /twiki/bin" - confira seu arquivo httpd.conf.

• Vá diretamente para o Passo 2...

Passo 1 para Contas Não-Root

Para instalar TWiki em um sistema onde você não tem privilégio de administrador de servidor, por exemplo, em uma hosted Web account:

• Faça o download e descompacte com unzip o TWiki em seu computador local
• Usando a tabela abaixo, crie uma estrutura de diretório em sua máquina de servidor
• Faça o upload dos arquivos TWiki por FTP (transfira como text com exceção para arquivos de imagem em pub)

Diretório TWiki:	O que é isso:	Para onde copiar:	Exemplo:
twiki/bin	CGI bin	cgi-enabled dir	/home/smith/public_html/cgi-bin
twiki/lib	library files	same level as twiki/bin	/home/smith/public_html/lib
twiki/pub	public files	htdoc enabled dir	/home/smith/public_html/pub
twiki/data	topic data	outside of htdoc tree (for security)	/home/smith/twiki/data
twiki/templates	Web templates	outside of htdoc tree (for security)	/home/smith/twiki/templates

Passo 2: Definir Permisões de Arquivos

• Certifique-se que Perl 5 e Perl CGI library estejam instalados em seu sistema. A localização padrão do Perl é /usr/bin/perl. Se estiver em outro lugar, mude o path para Perl na primeira linha de cada script no diretório twiki/bin, ou crie um link simbólico de /usr/bin/perl.
  • IMPORTANTE: Em contas ISP-hosted , Perl CGI scripts normalmente exigem uma extensão .cgi para executar.Alguns sistemas precisam da extensão Perl regular .pl. Modifique todos os nomes de arquivo scripts twiki/bin caso necessário.
• Defina as permissões de arquivo de todos os scripts Perl no diretório twiki/bin como executáveis para -rwxr-xr-x (755).
• Para que você possa editar scripts Perl e arquivos .tmpl são necessários chown e chgrp -R twiki de maneira que todos os arquivos tenham o dono que você desejar.
• NOTA: Esse guia assume usuário nobody como dono de todos os arquivos manipulados por scipts CGI (executados pelo servidor Web), e usuário twiki para todos os outros arquivos. Você pode:
  • substituir nobody por qualquer outro usuário caso seu servidor execute scripts sob um nome diferente (ex: padrão para Debian é www-data).
    • DICA: Execute o script testenv a partir do seu navegador: http://yourdomain.com/twiki/bin/testenv. Isso irá mostrá-lo o nome de usuário de scripts CGI, uma tabela listando todas as variáveis de ambiente CGI, e um teste de seu arquivo de configuração twiki/lib/TWiki.cfg (você irá configurar isso em um minuto).
  • substitua usuário twiki pelo seu próprio nome de usuário
• Defina a permissão de todos os arquivos abaixo twiki/data de maneira que eles possam ser escritos pelo usuário nobody. Uma maneira simples é usar chmod para -rw-rw-r-- (664) e chown para nobody.
• Defina a permissão do diretório twiki/data e seus subdiretórios de modo que os arquivos ali contidos posssam ser escritos pelo usuário nobody. Uma maneira simples de fazê-lo é usar chmod para drwxrwxr-x (775) e chown para nobody.
• Defina a permissão do diretório twiki/pub e de todos os seus subdiretórios de maneira que os arquivos ali contidos possam ser escritos pelo usuário nobody. Uma maneira simples de fazê-lo é usar chmod para drwxrwxr-x (775) e chown para nobody.
• NOTA: Os arquivos de reposição twiki/data/*/*.txt,v RCS no pacote de instalação são bloqueados pelo usuário nobody. Se seus scripts CGI não estiverem executando como usuário nobody, não é possível to check in files (você verá que o número de revisão nao irá aumentar após salvar um tópico). Neste caso, você precisa desbloquear todos os arquivos de reposição (confira as páginas de manual RCS) e os bloqueie com um usuário diferente, ex www-data, ou apague-os todos - novos arquivos serão automaticamente criados na primeira vez que cada tópico for editado. Uma maneira simples de mudar o proprietário é pelo método de localizar e substituir em todos os arquivos; por exemplo, using sed:
  for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done

Passo 3: Definir o Arquivo de Configuração Principal

• Edite o arquivo twiki/lib/TWiki.cfg, definindo as variáveis de acordo com as suas necessidades.
  • Defina a extensão de arquivo na variável $scriptSuffix para cgi ou pl se requerido.
  • Certifique-se que RCS está instalado. Defina $rcsDir em twiki/lib/TWiki.cfg para ter a mesma localização de seus binários RCS.
• Alerta de segurança: Diretórios twiki/data , twiki/templates e todos os seus subdiretórios devem estar definidos para que eles não sejam visíveis como uma URL. (Alternativamente, mova os diretórios para um lugar onde eles não sejam visíveis, e mude as variáveis em twiki/lib/TWiki.cfg de acordo com as modificações feitas)
• Teste suas definições executando o script testenv no seu navegador: http://seudominio.com/twiki/bin/testenv. Verifique se suas definições de configuração de arquivo estão corretas.

Passo 4: Finalize pelo seu Navegador

• Coloque seu navegador em http://seudominio.com/twiki/bin/view e comece a usar o TWiki de novo!
• Edite o tópico TWikiPreferences na web TWiki:TWiki para definir o endereço eletrônico do WIKIWEBMASTER, e outras preferências.
• Edite o tópico WebPreferences em cada web, se necessário: defina mensagens individuais WEBCOPYRIGHT, e outras preferências.
• Permita notificação por correio eletrônico de mudança em tópicos, TWikiSiteTools^? tem mais.
• Edite o tópico WebNotify em todas as webs e adicione usuários que você queira notificar.
• Adicione o TWiki:Main/PoweredByTWikiLogo ao seu tópico Main.
• Você pode adicionar novas %VARIABLES%. Defina variáveis site-level no tópico TWikiPreferences. Veja também: TWikiVariables.

Estes são os passos básicos para uma instalação padrão do TWiki. As opções abaixo são para a personalização do servidor.

Opções Adicionais em Nível de Servidor

Com a sua nova instalação TWiki de pé e executando, você pode gerenciar a maioria dos aspectos de seu sítio pela interface do navegador. Somente poucas funções requerem acesso ao sistema de arquivos do servidor, via Telnet ou FTP. Você pode fazer estas mudanças a nível de servidor durante a instalação e a qualquer momento depois disso.

Habilitando Autenticação de Usuários

• Caso TWiki tenha sido instalado em um servidor não-autenticado - não usando SSL - e você queira autenticar usuários:
  1. Renomeie o arquico .htaccess.txt no diretório twiki/bin para .htaccess e o modifique de acordo com as suas necessidades. Para detalhes, consulte a documentação de servidor HTTP (para servidor Apache: [1], [2]). Em particular, as seguintes partes em vermelho necessitam ser configuradas corretamente:
     Redirect /urlpath/to/TWiki/index.html http://your.domain.com/urlpath/to/TWiki/bin/view
AuthUserFile /filepath/to/TWiki/data/.htpasswd
ErrorDocument 401 /urlpath/to/TWiki/bin/oops/TWiki/TWikiRegistration?template=oopsauth
     • NOTA: Caso você tenha renomeado os script de arquivos CGI para ter uma extensão você tem que refletir isso nas entradas edit, view, preview, etc em .htaccess.
     • NOTA: O navegador deve pedir nome de login e senha quando você clicar no link Edit. Caso .htaccess não tenha o efeito desejado você precisa habilitá-lo: Adicione "AllowOverride All" à Directory section de access.conf para o ser diretório twiki/bin.
  2. Copie o tópico TWikiRegistrationPub^? para TWikiRegistration. Faça isso editando os tópicos na web TWiki, ou renomeando os arquivos .txt e .txt,v no diretório twiki/data/TWiki.
     • DICA: Você pode melhorar o formulário de registro apagando ou adicionando tags input. O parâmetro name="" das tags input devem começar com: "Twk0..." (Se este for um campo opcional), ou "Twk1..." (se este for um campo obrigatório). Isso assegura que os campos sejam processados corretamente.
• Registre-se no tópico TWikiRegistration.
  • NOTA: Quando um usuário se registra, uma nova linha com o nome de usuário e a senha encriptada é adicionada ao arquivo data/.htpasswd. O arquivo .htpasswd que vem com a instalação do TWiki inclui contas de usuário para TWiki core team members que são usadas para testes em TWiki.org. Você pode editar o arquivo e apagar aquelas linhas.
• Crie um novo tópico para verificar se a autenticação funciona.
• Edite o tópico TWikiAdminGroup na web TWiki:Main para incluir usuários com status de administrador de sistema.
• Edite o tópico TWikiPreferences na web TWiki:TWiki para definir privilégios de acesso.
• Edite o tópico WebPreferences em cada web, caso necessite: defina privilégios de acesso.

Adicionando uma Nova Web

Para criar uma nova web:

1. Crie um novo diretório web data em twiki/data e verifique as permissões de arquivo deste diretório.
   • Use um nome que comece com os caracteres A..Z, seguidos por a..z e/ou os caracteres 0..9, mas não uma WikiWord.
2. Copie todos os arquivos do diretório twiki/data/_default para um novo diretório de informações, preservando os donos, grupos e permissões dos arquivos originais (em Unix, use cp -p). Os arquivos de informações devem poder ser escritos pelo dono dos scripts CGI scripts que estão rodando (normalmente, nobody).
   • DICA: Você pode deginir permissões de arquivos .txt e .txt,v para -rw-rw-rw- (666) e então editar os tópicos usando o seu navegador; RCS irá rearmazenar as permissões de arquivo corretamente quando salvar o tópico.
3. Adicione a nova web à web list (visível no canto superior direito de cada tópico) editando as preferências site-level, TWikiPreferences:
   • Adicione a nova web para a variável Main  |  TWiki  |  Sandbox.
4. Atualize as definições web editando o tópico WebPreferences da nova web:
   • Aprimore a variável =Página inicial Diretrizes de Tradução Índice de tópicos Últimas atualizações Busca = para que contenha links web-specific de sua preferência.
   • Defina a variável WEBBGCOLOR para uma cor. O número representa a única cor para a web.
   • Defina Plugins, privilégios de acesso, custom variables, other web-level options (ex: Copyleft @ 2002, pelos autores que colaboraram na produção dos textos. Todo material aqui é liberado para uso através da GNU FDL. Para sugestões, dúvidas, etc., entre em contato com diego@edugraf.ufsc.br . can be set for an individual web).
5. Adicione a nova web na tabela colorida que lista as webs através da edição do tópico TWIKIWEB%.TWikiWebsTable
6. Teste a nova web: visualize páginas, crie uma nova página.

Esta é uma configuração básica de uma nova Web!

Opicionalmente, você pode:

• Criar um template Web personalizado em um novo diretório twiki/templates/AlgumaWeb (caso contrário, os templates são herdados de twiki/templates).
• Adicionar TWikiForms para servir de entrada em páginas baseada em formulário que esteja armazenada separadamente do texto do tópico 'free-form' principal.

NOTA: Tópicos home do usuário estão localizados na web TWiki.Main - não tente movê-los ou criá-los em outras webs. A partir de qualquer outra web as assinaturas de usuários devem apontar para a web TWiki.Main , usando um Main.UserName ou uma formatação Main.UserName . (A variável Main é uma vantagem caso você venha a mudar o nome da web Main, mas o padrão Main.UserName é mais fácil para os usuários, o que é a linha inferior!

Informações da estrutura dos arquivos e diretórios do TWiki

Veja Appendix A: TWiki File System^? para um sistema snapshot instalado e descrições de todos os arquivos na distribuição TWiki 01-Sep-2001.

-- PeterThoeny - 13 Sep 2001
-- MikeMannix - 03 Dec 2001

Warning: Can't find topic TWikiUpgradeGuide

Warning: Can't find topic TWikiUserAuthentication

Controle de Acesso TWiki

Restringindo acesso de leitura e escrita a tópicos e Webs por usuários e grupos

Visão Geral

TWikiAccessControl permite que você restrinja o acesso a tópicos individuais e a Webs inteiras por usuários individuais e por grupos de usuários em três áreas principais: view; edit & attach; e rename/move/delete. Estes controles, combinados com o TWikiUserAuthentication^?, permitem que você crie e gerencie facilmente um sistema de privilégio extremamente flexível e refinado.

Uma Consideração Importante Do Controle

Aberta, a edição do freeform é a essência do WikiCulture - é o que faz TWiki diferente e frequentemente mais eficaz do que outras ferramentas da colaboração. Assim, recomenda-se fortemente que as decisões para restringir lêem ou escrevem o acesso a uma WEB ou um tópico seja feito com cuidado. A experiência mostra que _ irrestrito escreva trabalhos do acesso _ muito bem porque:

• Peer influence é suficiente para asegurar que somente é postado conteúdo relevante.

• Peer editing - a habilidade de rearranjar qualquer coisa em uma página - mantém tópicos focalizados.

• Todo o conteúdo é preservado sob um controle de revisão.
  • Edições podem ser desfeitas pelo TWikiAdminGroup( o grupo padrão de administradores; veja #GerenciandoGrupos).
  • Usuários são encouragados a editar e refactor (condensar um tópico grande), já que há uma rede segura.

Como padrão a seguir para colaboração:

• Criar grupos de acesso amplo (more and varied input), and...
• Evitar criar usuários de apenas leitura (se você pode ler, você pode contribuir).

Usuários e Grupos

O controle de acesso é baseado em usuários e grupos. Os usuários são definidos por seus WikiNames, e então organizados em ilimitadas combinações sob diferentes grupos de usuários.

Gerenciando Usuários

Um usuário é criado pelo formulário TWikiRegistration. O processo gera um tópico na Web Main com o WikiName do novo usuário. O nome padrão do visitante é TWikiGuest.

• Usuários podem se autenticar usando Autenticação Básica ou SSL. TWikiUserAuthentication^? é necessária para rastrear identidades de usuários.

Gerenciando Grupos

Grupos são definidos por tópicos de grupos na Web Main, como o TWikiAdminGroup. Para iniciar um novo grupo:

1. Crie um novo tópico com um nome que termine em Group, SomeGroup
2. Defina duas variáveis:
   • Set GROUP = < lista de usuários e grupos >
   • Set ALLOWTOPICCHANGE = < lista de usuários e grupos >

• GROUP é uma lista de usuários e grupos separada por vírgulas:
  =    Set GROUP = SomeUser?, OtherUser?, SomeOtherGroup?=

• ALLOWTOPICCHANGE define quem é autorizado a mudar o tópico do grupo; é uma lista de usuários e grupos delimitados por vírgulas. Você tipicamente deseja restringí-la aos membros do próprio grupo, portanto ele deveria conter o nome do tópico,
  =    Set ALLOWTOPICCHANGE = TWikiAdminGroup=
  para o tópico TWikiAdminGroup^?.(Isso previne que usuários não pertencentes ao grupo editem o tópico e ganhem sem autorização associação ao grupo.)

Restringindo Acesso a Escrita

Você pode definir quem tem permissão de fazer mudanças em uma Web ou um tópico.

Negando a permissão de edição de um tópico

Negar a permissão de edição de um tópico também restringe anexação de arquivos a esse tópico; os privilégios são designados juntos.

• Defina uma ou ambas as seguintes variáveis em um tópico, de preferência ao fim da página:
  • Set DENYTOPICCHANGE = < lista de usuários e grupos >
  • Set ALLOWTOPICCHANGE = < lista de usuários e grupos >

• DENYTOPICCHANGE define usuários ou grupos que não têm permissão de realizar mudanças no tópico. É uma lista de usuários e grupos delimitada por vírgulas. Exemplo:
  = * Set DENYTOPICCHANGE = SomeBadBoy^?, SomeBadGirl^?, SomeHackerGroup^?=

• ALLOWTOPICCHANGE define usuários ou grupos que têm permissão de realizar mudanças no tópico. É uma lista de usuários e grupos delimitados por vírgulas. Exemplo:
  = * Set ALLOWTOPICCHANGE = SomeGoodGuy^?, SomeGoodGirl^?, TWikiAdminGroup=

• DENYTOPICCHANGE é avaliado antes de ALLOWTOPICCHANGE. O acesso é negado se a pessoa autenticada estiver na lista DENYTOPICCHANGE, ou não estiver na lista ALLOWTOPICCHANGE. O acesso é garantido caso DENYTOPICCHANGE e ALLOWTOPICCHANGE não estejam definidas.

Negando a permissão de edição de uma Web

Restringir a edição de uma Web inteira impede a criação de novos tópicos, a modificação de tópicos ou a anexação de arquivos para usuários sem permissão.

• Defina uma ou ambas as seguintes variáveis no tópico WebPreferences :
  • Set DENYWEBCHANGE = < lista de usuários e grupos >
  • Set ALLOWWEBCHANGE = < lista de usuários e grupos >

As mesmas regras se aplicam para a restrição de tópicos, com as seguintes adições:

• DENYTOPICCHANGE (no tópico) ignora DENYWEBCHANGE (em WebPreferences)
• ALLOWTOPICCHANGE (no topic) ignora ALLOWWEBCHANGE (em WebPreferences)

Restringindo a renomeação de tópicos

Você pode definir quem tem permissão de renomear, mover ou excluir um tópico, ou renomear uma Web.

Negando a permissão de renomear tópicos

Para permitir que usuários renomeiem, movam ou excluam um tópico é necessário que eles tenham permissão de escrita. É também necessária permissão de escrita para mudar referências em consulta de tópicos.

• Defina uma ou ambas as seguintes variáveis em um tópico, de preferência ao fim do tópico:
  • Set DENYTOPICRENAME = < lista de usuários e grupos >
  • Set ALLOWTOPICRENAME = < lista de usuários e grupos >

• DENYTOPICCRENAME define usuários ou grupos que não têm permissão de renomear o tópico. É uma lista de usuários e grupos delimitada por vírgulas. Exemplo:
  = * Set DENYTOPICRENAME = SomeBadBoy^?, SomeBadGirl^?, SomeHackerGroup^?=

• ALLOWTOPICRENAME define usuários ou grupos que têm permissão de renomear o tópico. É uma lista de usuários e grupos delimitados por vírgulas. Exemplo:
  = * Set ALLOWTOPICRENAME = SomeGoodGuy^?, SomeGoodGirl^?, TWikiAdminGroup=

• DENYTOPICRENAME é avaliado antes de ALLOWTOPICRENAME. O acesso é negado se a pessoa autenticada estiver na lista DENYTOPICRENAME, ou se não estiver na lista ALLOWTOPICRENAME. O acesso é assegurado caso DENYTOPICRENAME e ALLOWTOPICRENAME não estejam definidos.

Negando a permissão de renomear uma Web

Você pode definir restrições a quem é permitido renomear uma Web TWiki.

• Defina uma ou as duas variáveis no tópico WebPreferences:
  • Set DENYWEBRENAME = < lista de usuários e grupos >
  • Set ALLOWWEBRENAME = < lista de usuários e grupos >

As mesmas regras são aplicadas para tópicos, com as seguintes adições:

• DENYTOPICRENAME (no tópico) prevalece sobre DENYWEBRENAME (em WebPreferences)
• ALLOWTOPICRENAME (no tópico) prevalece sobre ALLOWWEBRENAME (em WebPreferences)

Restringindo acesso para leitura

Você pode definir quem tem permissão de ver uma Web TWiki.

• Defina uma ou ambas as seguintes variáveis no tópico WebPreferences :
  • Set DENYWEBVIEW = < lista de usuários e grupos >
  • Set ALLOWWEBVIEW = < lista de usuários e grupos >

Problemas conhecidos

• A restrição de acesso para leitura não é apropriada para um conteúdo muito suscetível, visto que há um meio de driblar a restrição de acesso a leitura.
• Restrição de acesso a leitura só funciona se o view script for autenticado, o que significa que o usuário também precisa logar para ler os tópicos. TWikiInstallationGuide fala mais de Autenticação Basica baseada no arquivo .htaccess .

Selective Unrestricted Web Access

• Há um workaround caso você prefira ter acesso irrestrito a visualização de tópicos localizados em webs normais, e para autenticar usuários somente para webs onde a restrição de visualização é permitida:
  1. Omita o script view do arquivo .htaccess.
  2. habilite a flag $doRememberRemoteUser em lib/TWiki.cfg como descrito em TWikiUserAuthentication^?. TWiki irá agora lembrar do endereço IP de um usuário autenticado.
  3. Copie o script view para viewauth (ou melhor, crie um link simbólico)
  4. Adicione viewauth à lista de scripts autenticados no arquivo .htaccess .
     • Quando um usuário acessa uma Web onde você habilitou view restriction, TWiki irá redirecionar view script para viewauth script (isso acontece apenas se o usuário nunca tiver editado um tópico). Fazendo isso, irá então pedir autenticação. O viewauth script mostra o tópico pedido se o usuário logar e for autorizado a ver aquela Web.
     • Se você habilitar view restriction para uma Web,é recomendado restringir search "all webs" de pesquisar essa web. Habilite essa restrição com a variável NOSEARCHALL em WebPreferences, como:
       • Set NOSEARCHALL = on
     • Não é recomendado restringir acesso a visualização a tópicos individuais visto que todo o conteúdo é pesquisado na web.

Escondendo configurações de controle

• para esconder o controle de acesso a configurações de uma visualização normal no navegador, coloque-o comentado.

The SuperAdminGroup^?

Ao se colocar erroneamente um usuário ou grupo em ALLOWTOPICCHANGE , é possível que o tópico fique trancado, de maneira que ninguém pode editá-lo de um navegador. Para impedir que isso aconteça:

• Coloque na variável $superAdminGroup em lib/TWiki.cfg o nome do grupo de usuários que sempre tem permissão de editar/visualizar tópicos.

$superAdminGroup = "TWikiAdminGroup";

• A configuração padrão é de não haver superusuários.

-- MikeMannix - 02 Dec 2001

Formatação de Texto TWiki

TWiki Editing Shorthand

1° parágrafo

2° parágrafo

---++ Sushi

---+++ Maguro

*Negrito*

_Itálico_

__Italico negrito__

=Fonte fixa=

==Fonte fixa negritada==

_Isso funciona_,
_isso não _

<verbatim>
class CatAnimal {
  void purr() {
    <code here>
  }
}
</verbatim>

class CatAnimal {
  void purr() {
    <code here>
  }
}

-------

   * item bolota

      * Coisa aninhada

   1 Sushi
   1 Dim Sum

   Sushi: Japan
   Dim Sum: S.F.

| *L* | *C* | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| multi span |||
| A4 \  | next \  | next |

WebNotify

Know.ReadmeFirst

[[wiki syntax]]

[[Main.TWiki users]]

[[WikiSyntax][syntax]]

[[http://gnu.org][GNU]]

[[WebHome#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here

<nop>SunOS

Usando HTML

Você pode utilizar sem problemas qualquer tag HTML que desejar - no entanto, existem algumas usabilidades e considerações técnicas a serem lembradas.

HTML e a Usabilidade do TWiki

• Em páginas de colaboração, é preferível que NÃO se use HTML, mas que se use TWiki shorthand - isso torna o texto organizado e fácil de editar.
• NOTA: O TWiki é projetado para trabalhar com um grande conjunto de navegadores e plataformas, mantendo compatibilidade com HTML 3.2 na instalação padrão - adicionando HTML puro, particularmente tags de navegadores específicos (ou qualquer outra marcação que não seja comum a todos), reduzirá a compatibilidade projetada.

Renderização HTML do TWiki

• O TWiki converte a notação shorthand em XHTML 1.0 para visualização. Pra copiar uma página totalmente codificada em HTML, simplesmente veja o fonte em seu navegador e salve o conteúdo.
  • Se você precisa salvar HTML freqüentemente, você poderia avaliar o TWiki:Plugins/GenHTMLAddon - isso irá "gerar um diretório contendo versões renderizadas de uma seleção de páginas TWiki junto com qualquer arquivo anexado."
• NOTA: Os simbolos < e > das tags HTML devem estar na mesma linha, ou a tag será quebrada.
  • Essa característica possibilita que você entre com os simbolos < e > sem fechamento - como um símbolo de menor-que ou maior-que - e ter isso automaticamente renderizado como se tivesse inserido o caracter HTML <, ex: a > b
  • Se você está colando um texto HTML pré-formatado e notou problemas, cheque o arquivo em um processador de textos sem quebra de linhas. Também, salve sem quebras súbitas de linha no texto, em seu programa de edição de HTML.

Hiperlinks

A habilidade de criar links sem nenhuma formatação é provida pelo núcleo do TWiki, possibilitada por WikiWords. Novas regras de linkagem TWiki são simples extensões da sintaxe que provêem um novo conjunto de opções flexíveis.

Links Internos

• GoodStyle é uma WikiWord que forma um link para o tópico GoodStyle, localizado na web TWiki atual.

• NotExistingYet^? é um tópico cuja criação ainda não terminou, ou seja, ele acaba de ser criado, mas não tem conteúdo. Para terminar a criação do tópico, inserindo conteúdo nele, clique no sinal de ? (Experimente clicar na interrogação nesse tópico, mas depois cancele - criar o tópico estragaria esse exemplo )

Links Externos

• http://..., https://..., ftp://..., gopher://..., news://..., file://..., telnet://... e mailto:...@... produzem um link automaticamente.

• Endereços de Email como nome@dominio.com também produzem um link automaticamente.

• [[Colchetes]] permitem que você crie facilmente links não-WikiWord.
  • Você pode escrever também [[http://yahoo.com Yahoo home page]] como uma maneira mais fácil de fazer links externos com um texto descritivos para o link, como em Yahoo home page.

Variáveis TWiki

Variáveis são nomes limitados por sinais % que são expandidos para o código.

• %TOC% : Gera automaticametne uma lista do conteúdo de um tópico baseado nos cabeçalhos. Veja o topo dessa página para um exemplo.

• %WEB% : A página atual, ou seja Portugues.

• %TOPIC% : O nome do tópico atual é TextFormattingRules.

• %ATTACHURL% : A URL do arquivo anexo ao tópico atual. Exemplo de uso: Se você anexa um arquivo a um tópico você pode se referir a ele como em %ATTACHURL%/image.gif para mostrar a URL para o arquivo ou imagem no seu texto.

• %INCLUDE{"SomeTopic"}% : Inclui o conteúdo de outro tópico. A valor TWiki da web atual é a web padrão. Exemplo: %INCLUDE{"TWiki.SiteMap"}%

• %SEARCH{"sushi"}% : Busca inline mostrando os resultados embutidos em um tópico. FormattedSearch te dá controle sobre a formatação, usado para criaraplicações web-based.

• TWikiPreferences define variáveis válidas para todo o site. Entre outras:
  • Quebra de linha: Escreva %BR% para iniciar uma nova linha
  • Texto Colorido: Escreva: %RED% Red %ENDCOLOR% e %BLUE% blue %ENDCOLOR% colors para obter as cores: Red e blue .
  • Gráficos de Documentação: Escreva: %H% Help, %T% Tip, %X% Alert para obter: Help, Tip, Alert. Para mais informações veja TWikiDocGraphics^?.

• Existem muitas outras variáveis, veja em TWikiVariables.

Extensões para Formatação com TWikiPlugins

Plugins fornecem capacidades adicionais de formatação de texto e podem expandir a funcionalidade do TWiki em muitas outra áreas. Por exemplo, o opcional SpreadSheetPlugin permite que você crie um spreadsheet com as mesmas notações básicas usadas em tabelas TWiki.

Os plugins disponiveis estão na web Plugins em TWiki.org. Os plugins atualmente habilitados, nesta instalação do TWiki, são listados por: %PLUGINDESCRIPTIONS%:

• SpreadSheetPlugin (Dakar, 8154): Add spreadsheet calculation like "$SUM( $ABOVE() )" to tables located in TWiki topics.
• CommentPlugin (Dakar, 8164): Allows users to quickly post comments to a page without an edit/preview/save cycle.
• EditTablePlugin (Dakar, 8154): Edit TWiki tables using edit fields, date pickers and drop down boxes
• EmptyPlugin (Dakar, $Rev: 9598$): Empty Plugin used as a template for new Plugins
• InterwikiPlugin (Dakar, $Rev: 8329$): Link ExternalSite:Page text to external sites based on aliases defined in a rules topic
• PreferencesPlugin (Dakar, 9610): Allows editing of preferences using fields predefined in a form
• RenderListPlugin (Dakar, $Rev: 9598$): Render bullet lists in a variety of formats
• SlideShowPlugin (Dakar, $Rev: 8154$): Create web based presentations based on topics with headings.
• SmiliesPlugin (Dakar, 8154): Render smilies as icons, like  :-) for or  :cool: for :cool:
• TablePlugin (Dakar, 8154):
• WysiwygPlugin (Dakar, 9565): Translator framework and WYSIWYG editor for TWiki topics

Verifique o estado atual do plugin e os ajustes para este site em TWikiPreferences.

Erros comuns de Edição

As regras de formatação TWiki são bastante simples de usar e rápidas de digitar. Porém, existem certas coisas em que se deve prestar atenção, pegas na FAQ de Formatação de Texto:

• Q: Texto envolto entre < e > não é mostrado. Como posso mostrá-lo como ele é?
  • A: Os caracteres '<' and '>' têm um significado especial em HTML, eles definem tags HTML. Você precisa escapar deles, então escreva '<' em vez de '<', e '>' em vez de '>'.
    Exemplo: Digite 'prog <filename>' para obter 'prog <filename>'.
  • A: Os caracteres < e > têm significado especial em HTML, eles definem suas tags. Você precisa escapar deles, então escreva "<" no lugar de "<" e ">" no lugar de ">".
    Exemplo: digite "programa <nomedoarquivo>" para ter "programa <nomedoarquivo>".

• Q: Porque o caracter "&" não aparece algumas vezes?
  • A: O caracter "&" tem significado especial em HTML, ele inicia o que é chamado de entidade de caracter, i.e. "©" é o © caracter de copyright. Você precisa escapar do "&" para vê-lo como ele é, então escreva "&" no lugar de "&".
    Exemplo: Escreva "Isso & aquilo" para ter "Isso & aquilo".

-- MikeMannix - 02 Dec 2001
-- PeterThoeny^? - 01 Feb 2003

TWiki Variáveis

Nomes especiais expandidos no momento da visita à página para mostrar dados ou informações do sistema

Visão Geral

TWikiVariáveis são nomes - %VARIAVEL% - que expandem dentro do conteúdo sempre que uma página é aberta. Variáveis são sustituídas pelos seus valores reais: dados armazenados, ou informações do sistema (como a data, ou o usuário atual). Existem variáveis predefinidas, e variáveis de preferência que você define. Você pode, também, definir variáveis padrões, com novos nomes e valores.

Variáveis Pré-definidas

A maioria das variáveis pré-definidas retornam valores que foram ou definidos na instalação do Twiki, ou obtidas pela informação do servidor (como o usuário atual, ou a data e a hora). Muitas das variáveis deixam você controlar como os resultados formatados aparecem.

• Dê um tempo para ler completamente todas as variáveis definidas nas preferências. Se você configurar ativamente seu site, reveja variáveis periodicamente. Elas cobrem um grande número de funções, e pode ser fácil faltar a variável perfeita para algo que você tem em mente. Por exemplo, veja %INCLUDINGTOPIC%, %INCLUDE%, e o poderoso %SEARCH%.

Essa versão do TWiki - Fri, 31 Mar 2006 build 9626 - expande as seguintes variáveis (envolvidas em % sinais de percentagem):

Variable:	Expanded to:
%WIKIHOMEURL%	A URL base do script do TWiki, é o link do ícone Home no canto superior esquerdo, é /bin/view
%SCRIPTURL%	A URL do script do TWiki, é http://aulas.edugraf.ufsc.br/bin
%SCRIPTURLPATH%	O caminho da URL do script do TWiki, é /bin
%SCRIPTSUFFIX%	O sufixo do script, ex: .pl, .cgi é
%PUBURL%	A URL pública do TWiki, é http://aulas.edugraf.ufsc.br/pub Exemplo: Você pode referir a um arquivo anexado a outro tópico como %PUBURL%/%WEB%/OtherTopic/image.gif
%PUBURLPATH%	O caminho da URL pública do TWiki, é /pub
%ATTACHURL%	A URL de anexos do tópico atual, é http://aulas.edugraf.ufsc.br/pub/Portugues/TWikiVariables Exemplo: Caso você anexe um arquivo você pode se referir a ele como %ATTACHURL%/image.gif
%ATTACHURLPATH%	O caminho da URL de anexos do tópico atual, é /pub/Portugues/TWikiVariables
%URLPARAM{"name"}%	Retorna o valor de um parâmetro de URL. Ex: %URLPARAM{"skin"}% retorna print para um .../view/Portugues/TWikiVariables?skin=print URL. O valor é:
%WIKITOOLNAME%	O nome da ferramenta wiki, é TWiki
%WIKIVERSION%	A versão da ferramenta Wiki é Fri, 31 Mar 2006 build 9626
%USERNAME%	Seu login de usuário é guest
%WIKINAME%	Seu nome de usuário Wiki. O mesmo que %USERNAME% caso não for definido no tópico TWikiUsers. É TWikiGuest
%WIKIUSERNAME%	Seu %WIKINAME% incluindo o nome da web Main - sempre use assinaturas completas. Seu valor é: Main.TWikiGuest
%MAINWEB%	A web principal contendo TWikiUsers, OfficeLocations e TWikiGroups. É Main
%TWIKIWEB%	A web contendo toda a documentação e configuração do TWiki é TWiki
%WEB%	A web atual é Portugues
%BASEWEB%	O nome da web onde os includes foram inicializados, e.g. a web do primeiro tópico dos includes aninhados. Da mesma forma que %WEB% no caso de não haver include.
%INCLUDINGWEB%	O nome da web do tópico que inclui o tópico atual. Assim como %WEB% no caso de não haver include.
%HOMETOPIC%	O tópico home em cada web. É WebHome
%NOTIFYTOPIC%	O tópico de notificação em cada web. É WebNotify
%WIKIUSERSTOPIC%	O tópico index de todos usuários registrados. É TWikiUsers
%WIKIPREFSTOPIC%	A web do tópico de preferências. É TWikiPreferences
%WEBPREFSTOPIC%	O tópico de preferências da web. É WebPreferences
%STATISTICSTOPIC%	O tópico de estatísticas da web. É WebStatistics
%TOPIC%	O nome do tópico atual, é TWikiVariables
%BASETOPIC%	O nome do tópico onde os includes são inicializados, ex. o primeiro tópico de includes aninhados. Do mesmo jeito que %TOPIC% no caso de não haver include.
%INCLUDINGTOPIC%	O nome do tópico que inclui o tópico atual. Da mesma forma que %TOPIC% no caso de não haver include.
%SPACEDTOPIC%	O nome do tópico atual com espaços adicionados, para pesquisa da expressão regular de Ref-By, é TWiki%20*Variables
%TOPICLIST{"format"}%	Tópico de índice da web. O "format" define o formato de um item do tópico. Ele pode incluir variáveis: A variável $name contém o nome do tópico; a variável $web contém o nome da web. Os parâmetros são: formato, separador e web: Parâmetro: Descrição: Padrão: "formato" Formato de uma linha, pode incluir as variáveis $name e $web "$name" format="formato" (Alternativo ao de cima) "$name" separator=", " linha de separação "\n" (nova linha) web="Name" Nome da web Web atual Examples: %TOPICLIST{"   * $web.$name"}% criar uma lista de bolotas de todos os tópicos. %TOPICLIST{separator=", "}% cria uma lista de todos os tópicos separada por vírgula. %TOPICLIST{" <option>$name</option>"}% cria uma lista de opções (para menus drop down).
%WEBLIST{"format"}%	Web index, ex. lista de todas web's. Webs ocultas são excluídas ,ex. webs com uma variável de preferência NOSEARCHALL=on. O "format" define o formato de um item de web. A variável $name contém o nome da web, $qname contém o nome da web entre aspas duplas, $marker contém o marker onde a web condiz com selection. Os parâmetros são: formato, separador e web: Parâmetro: Descrição: Padrão: "formato" Formato de uma linha, pode incluir a variável=$name= "$name" format="formato" (Alternativo ao de cima) "$name" separator=", " separador de linha "\n" (nova linha) webs="public" Lista de web's separada por vírgulas, public contém todas as não ocultas "public" marker="selected" Texto para $marker onde o item condiz com selection, de outro modo é igual a "" "selected" selection="%WEB%" Valor atual a ser selecionado na lista section="%WEB%" Examples: %WEBLIST{"   * [[$name.WebHome]]"}% cria uma lista de bolotas de todas webs. %WEBLIST{"$name" webs="Trash,public" selection="Portugues" separator=" "}% Caixa de seleção (Dropdown) de todas Webs públicas + Trash Web, Web atual selecionada.
%GMTIME%	A hora GM, é 21 Nov 2009 - 08:59
%GMTIME{"format"}%	A hora GM é formatada baseada nas variáveis de tempo. Variável: Unidade: Exemplo $seconds segundos 59 $minutes minutos 59 $hours horas 23 $day dia do mês 31 $month mês no formato ISO Dec $mo mês com 2 dígitos 12 $year ano com 4 dígitos 1999 $ye ano com 2 dígitos 99 As variáveis podem ser abreviadas a 3 caracteres. Exemplo: %GMTIME{"$day $month, $year - $hour:$min:$sec"}% é 21 Nov, 2009 - 08:59:02
%SERVERTIME%	Hora do Servidor, é 21 Nov 2009 - 06:59
%SERVERTIME{"format"}%	Hora do Servidor formatada. Exemplo: %SERVERTIME{"$hou:$min"}% é 06:59
%HTTP_HOST%	A variável de ambiente HTTP_HOST, é aulas.edugraf.ufsc.br
%REMOTE_ADDR%	A variável de ambiente REMOTE_ADDR, é 38.107.191.99
%REMOTE_PORT%	A variável de ambiente REMOTE_PORT, é 40509
%REMOTE_USER%	A variável de ambiente REMOTE_USER, é
%INCLUDE{"page" ...}%	Inclusão, no lado do servidor para Inclua tópicos e páginas web: Parâmetro: Descrição: Padrão: "AlgumTopico" O nome de um tópico localizado na web atual, i.e. %INCLUDE{"WebNotify"}%   "Web.Topico" Um tópico em outra web, i.e. %INCLUDE{"TWiki.SiteMap"}%   "http://..." Uma URL absoluta, i.e. %INCLUDE{"http://twiki.org/"}%   pattern="..." Um padrão em expressão regular para incluir parte de um tópico ou página none rev="1.2" Inclui uma versão anterior do tópico; N/A para URLs última versão
%STARTINCLUDE%	Se presente em um tópico incluído, inicia a inclusão do texto daquele ponto até o fim, ou até o ponto da variável %STOPINCLUDE%. Uma visão normal do tópico mostra tudo, exceto a própria variável %STARTINCLUDE%.
%STOPINCLUDE%	Se presente em um tópico incluído, para a inclusão do texto naquele ponto e ignora o resto do texto. Uma visão normal do tópico mostra tudo, exceto a própria variável %STOPINCLUDE%.
%TOC%	Tabela de conteúdo do tópico atual. (TOC é acrônimo de Table of Contents)
%TOC{"SomeTopic" ...}%	Tabela de conteúdo. Mostra um TOC gerado automaticamente baseado nos cabeçalhos de um tópico. Cabeçalhos em Sintaxe Wiki ("---++ texto") e HTML ("<h2>texto<h2>") são examinados no cliente. (mas não "<H2>texto</H2>", que pode ser usado para excluir um cabeçalho do TOC.) Os parâmetros são: nome do tópico, web e profundidade: Parâmetro: Descrição: Padrão: "NomeDoTopico" nome do tópico tópico atual web="Nome" nome da web web atual depth="2" Profundidade limite de cabeçalhos mostrados no TOC 6 Exemplos: %TOC{depth="2"}%, %TOC{"TWikiDocumentation" web="TWiki"}%
%SEARCH{"text" ...}%	Busca em linha, mostra o resultado de uma busca "encaixado" em um tópico. Os parâmetros são: o termo da busca, web, escopo, ordem e muitos outros: [1] Parâmetro: Descrição: Padrão: "texto" O termo de busca. É uma expressão regular ou é literal, dependendo do parâmetro regex. para expressões regulares é usado ";" para representar and e.g. "search;agrep" encontrará todos os tópicos que contenham search e agrep. requerido search="texto" (alternativa ao anterior) N/A web="Nome" web="Main Know" web="all" Wiki web para a busca: Uma web, uma lista de webs separada por espaços, ou all (todas) as webs. [2] web atual scope="topic" scope="text" Busca pelo nome do tópico (título) ou no texto (corpo/conteúdo) do tópico texto do tópico order="topic" order="modified" order="editby" order="formfield(nome)" Ordena o resultado da busca pelo nome do tópico, última modificação, último editor, ou um campo nome de um TWikiForms nome do tópico limit="all" limit="16" Limita o número de resultados retornados Todos (all) regex="on" Busca com expressão regular; também permite ";" como and busca literal reverse="on" Inverte o sentido da busca busca ascendente casesensitive="on" busca sensível ao estado (maiúscula ou minúscula) ignorar estado nosummary="on" Mostrar somente o título do tópico mostrar o resumo bookview="on" Busca BookView, e.g. mostra o texto completo do tópico mostrar o resumo nosearch="on" Suprimir a linha de busca mostrar busca noheader="on" Suprimir cabeçalho de busca Topics: Changed: By: mostrar cabeçalho nototal="on" não mostrar o número de tópicos encontrados mostrar total header="..." format="..." Formatação customizada do resultado: veja busca formatada para uso, variáveis e exemplos resultados em tabela Exemplo comum: %SEARCH{"wiki" web="Main" scope="topic"}% Exemplo formatado: %SEARCH{"FAQ" scope="topic" nosearch="on" nototal="on" header="| *Topic: * | *Summary: * |" format="| $topic | $summary |"% (mostra o resultado em uma tabela com cabeçalho - detalhes...) Se o TWiki:Plugins.TablePlugin está instalado, você poderá definir uma variável %TABLE{}% logo antes do %SEARCH{}% para alterar a saída da busca. Exemplo: %TABLE{ tablewidth="90%" }%
%METASEARCH{...}%	Busca especial de meta dados Parâmetro: Descrição: Padrão: type="topicmoved" Que propriedade da busca é requisitada? "topicmoved" se a busca é por um tópico que pode ter sido movido "parent" se a busca é por um tópico que tenha um pai específico i.e. O filho deste. required web="%WEB%" A Wiki web da busca: Uma web, uma lista de webs separada por espaço, ou all (todas) as webs. required topic="%TOPIC%" o tópico ao qual a busca se relaciona required title="Titulo" o texto que é colocado antes de cada resultado da busca required Example: %METASEARCH{type="topicmoved" web="%WEB%" topic="%TOPIC%" title="Esse tópico existe e foi movido para: "}%, você pode precisar usar isso em WebTopicViewTemplate e WebTopicNonWikiTemplate %METASEARCH{type="parent" web="%WEB%" topic="%TOPIC%" title="Filhos: "}%
%VAR{"NOME" web="Web"}%	Pega um valor de preferência de uma web diferente da atual. Exemplo: Para pegar %WEBBGCOLOR% da web Main escreva %VAR{"WEBBGCOLOR" web="Main"}%, é #FFEFA6

[1] Nota: O formulário da busca usa nomes idênticos para campos da entrada.

[2] Nota: Uma web pode ser excluida de uma busca web="all" (todas as webs) se você definir uma variável NOSEARCHALL=on no seu WebPreferences.

Variáveis de Preferências

Variáveis adicionais são definidas no tópico de preferências ( nível-do-site ( SL ) em TWikiPreferences, nível-da-web ( WL ) em WebPreferences de cada web e as preferências do nível-do-usuário ( UL ) no tópico individual do usuário )

Variáveis adicionais são definidas em preferências ( site-level ( SL ) in TWikiPreferences, web-level ( WL ) in WebPreferences de cada web, e preferências em nível de usuário ( UL ) em tópicos de usuários individuais):

Nota: Existem várias outras variáveis úteis definidas em TWikiPreferences como %BR% para quebra de linha, cores como %RED% para texto colorido e pequenos ícones como %H% para um ícone de ajuda.

Ajustando Preferências

• A sintaxe para as variáveis de preferência é a mesma em qualquer lugar do TWiki. No modo de edição, no início de uma nova linha:
  [6 espaços] * [espaço] Set [espaço] NOMEDAVARIAVEL [espaço] = [valor]
  Exemplo:
  • Set NOMEDAVARIAVEL = valor

Criando Variáveis sob Encomenda

• Você pode adicionar as suas próprias variáveis preferenciais para um site completo, uma Web, ou um único tópico, usando a sintaxe padrão. O que quer que você coloque na sua variável será substituído na tela e tratado exatamente como se tivesse sido escrito. Deste modo, você pode colocar textos formatados, links para páginas, caminhos para imagens.

Exemplo: Criando uma variável de logotipo personalizado

• Para colocar um logotipo em qualquer lugar de uma web escrevendo %MEULOGO%, simplesmente defina a variável na página de preferências da web da web em questão. Você deve enviar logo.gif - isso pode ser feito anexando um arquivo à um TopicoLogico (qualquer tópico a sua escolha):
  • Set MEULOGO = %PUBURL%/%MAINWEB%/TopicoLogico/logo.gif

-- PeterThoeny - 13 Sep 2001
-- MikeMannix - 30 Nov 2001

Anexação de Arquivos

Cada tópico pode ter arquivos anexados a ele, assim como um arquivo de e-mail anexado. Use o seu navegador para enviar ou pegar um arquivo. Anexos são guardados sob controle de revisões, então uploads nunca podem ser perdidos, e mudanças de arquivos podem ser feitas com uma opção rollback que o permite recuperar todas as versões anteriores.

Pra que serve a Anexação de Arquivos?

A anexação de arquivos pode ser usada para criar poderosas soluções para groupware (programas aplicativos cujo objetivo é auxiliar grupos de pessoas trabalhando cooperativamente) - compartilhamento de arquivos, Gerência de documentos - e para otimizar a autorização web.

Sistema de Gerenciamento de Documentos

• Voçê pode usar anexação para guardar e recuperar documentos (em qualquer formato, com gráficos associados, e outros arquivos mídia); anexe documentos para tópicos específicos do Twiki; colabore com controle total na revisão de arquivos; distribua documentos usando um critério de só disponibilizar o necessário; crie uma biblioteca central de referência que é fácil de acessar e gerenciar por um grupo inteiro de usuários.

Compartilhar Arquivos

• Para compartilhamento de arquivos, FileAttachments numa série de tópicos pode ser usado para criar rapidamente uma bem documentada, central digital de download categorizada por todos os tipos de arquivos: documentos; gráficos e outras mídias; drivers e patches; applicações; qualquer coisa que você possa uploadear com segurança!

Autoria Através da Web

• Através do seu Web browser, você pode facilmente fazer upload de gráficos (ou arquivos de som, ou qualquer outra coisa que você queira adicionar à sua página) e colocá-los em qualquer lugar numa única página, ou em toda a web, ou em todo o site.
  • NOTA: Você também pode adicionar gráficos - qualquer arquivo - diretamente, tipicamente pelo upload através de FTP. Isso requer acesso ao servidor, e pode tornar-se mais conveniente se um grande numero de arquivos, ou um diretório particular, é requerido. Estes arquivos não podem ser administrados usando os controles de anexação baseados em browser.

Enviando Arquivos (Uploading)

• Para fazer upload: Clique no link Attach no rodapé de cada página. Uma forma é mostrada onde você pode procurar por um arquivo e fazer o upload dele. O arquivo que foi feito upload vai aparecer no File Attachment table.
  • Pode ser feito upload de qualquer tipo de arquivo. Alguns arquivos que estão no grupo de risco são renomeados, ex: arquivos do tipo *.php são renomeados para *.php.txt.
  • Atualmente não há limite para o tamanho do arquivo além do espaço em disco do servidor.
  • O caminho do upload prévio é guardado por conveniencia. Caso você faça alguma mudança no arquivo local e queira fazer o upload dele, você pode copiar o caminho do prévio upload para o campo arquivo local.

Recebendo Arquivos (Downloading)

• Para fazer download: Clique no arquivo através da File Attachment table(tabela de arquivos anexados).

• NOTA: Não há controle de acesso para anexos individuais. Se você precisa desse tipo de controle, Crie tópicos separados e defina restrições de acesso por tópico.

Movendo Arquivos Anexados

Um anexo pode ser movido entre tópicos. Para fazer isso clique Action no anexo que será movido. Na página de controle, selecione nova web e tópico, depois clique Move. O anexo e seu histórico são movidos. O local original é guardado como topic Meta Data.

Deletando Anexos

Não é possivel deletar arquivos anexados com a atual implementação do TWiki. Porém, eles podem ser movidos para outro tópico. Uma boa idéia para contornar este problema é o tópico Trash.TrashAttachments - mova para lá os anexos que não são mais necessários.

Linkando a Arquivos Anexados

• Uma vez que o arquivo é anexado ele pode ser referenciado para outro tópico. Exemplo:
  1. Attach arquivo: Exemplo.txt
  2. Edit tópico e escreva texto: http://aulas.edugraf.ufsc.br/pub/Portugues/FileAttachment/Exemplo.txt
  3. Preview - %ATTACHURL texto aparece como: http://aulas.edugraf.ufsc.br/pub/Portugues/FileAttachment/Exemplo.txt, um link.

• Para referenciar um anexo localizado num outro tópico, escreva o texto:
  • http://aulas.edugraf.ufsc.br/pub/Portugues/OtherTopic/Sample.txt (para a mesma web)
  • http://aulas.edugraf.ufsc.br/pub/Otherweb/OtherTopic/Sample.txt (para uma web diferente)

• Arquivos HTML e textos anexados podem ser indexidados num determinado tópico. Exemplo:
  1. Attach arquivo: Sample.txt
  2. Edit tópico e escreva texto: =

Warning

This site does not allow %INCLUDE% of URLs

• • • Conteúdo dos arquivos anexados é mostrado indexado.
    • Leia mais em IncludeTopicsAndWebPages; * Imagens do tipo GIF, JPG e PNG podem ser anexadas e mostradas embutidas no tópico. Exemplo:
  1. Attach arquivo: Smile.gif
  2. Edit tópico e escreva texto: http://aulas.edugraf.ufsc.br/pub/Portugues/FileAttachment/Smile.gif
  3. Preview - texto aparece como , uma imagem.

Tabela de índices de Arquivos Anexados

Arquivos anexados a um tópico são mostrados em uma tabela de diretórios, visualizada no rodapé da página ou, opcionalmente, escondidos e acessados quando você clica em Attach.

Attachment: Action: Size: Date: Who: Comment: Exemplo.txt action 30 22 Jul 2000 - 19:37 PeterThoeny Somente um exemplo Smile.gif action 94 22 Jul 2000 - 19:38 PeterThoeny Smiley face

Controles de Arquivos Anexados

Clicando no link Action leva você a uma nova página que se parece com isso:

Attachment: Action: Size: Date: Who: Comment: Attribute: Exemplo.txt action 30 22 Jul 2000 - 19:37 PeterThoeny Somente um exemplo Smile.gif action 94 22 Jul 2000 - 19:38 PeterThoeny Smiley face Update attachment Sample.txt Version: Action: Date: Who: Comment: 1.1 view 2001.08.30.09.28.56 PeterThoeny Previous upload: C:\DATA\Sample.txt (PeterThoeny) Local file: Comment: Link: Create a link to the attached file at the end of the topic. Hide file: Hide attachment in normal topic view. Help text ... Topic FileAttachment . { | | Move attachment | Cancel }

• A primeira tabela é uma lista de todos os anexos, incluindo seus atributos. Um h significa que os anexos estão ocultos, não são listados quando visualizando um tópico.

• A segunda tabela é todas as versões dos anexos. Clique em View para ver a versão. Se for a versão mais recente, você abrirá a URL que sempre mostra a última versão, que é normalmente o que você deseja.
  • Para mudar o comentário To change the comment em um anexo, digite um novo comentário e clique em mudar propriedades Change properties. Note que o comentário posto numa versão específica diferente não mudará, contudo o comentário é alterado quando o tópico é acessado.
  • Para esconder e mostrar To hide/unhide um anexo, marque o campo Hide file na caixa de seleção, depois clique em mudar propriedades Change properties.

Problemas Conhecidos (Known Issues)

• Diferentemente dos tópicos, anexos não são bloqueados para edição durante uma edição. Por outro lado, você pode mudar o comentário para indicar qual arquivo anexo está em edição - o comentário de uma versão específica não é perdido, estará lá quando você listar todas as versões do anexo.

Formulários TWiki

Entrada de dados form-based em tópicos, com o par nome/valor armazenado como variáveis Meta Dados; escolha um dos múltiplos formulários por Web & tópico

Visão Geral

Com a criação de entradas form-based para um conteúdo de freeform, você pode estruturar tópicos com categorias ilimitadamente pesquisáveis, facilmente. Quando os formulários são habilitados para uma Web e selecionados em um tópico, um formulário simples aparece no modo de edição, a os conteúdos são organizados como uma tabela quando visualizados pela página no modo normal. Pode-se definir um número ilimitado de formulários para uma Web. Para cada tópico, você pode selecionar um padrão se mais de um formulário estiver definido, ou remover os formulários inteiramente. Valores inseridos através dos formulários são armazenados como TWikiMetaData; todos os dados são salvos.

Moldes de Formulários substituem TWikiCategoryTables da versão de 01-Dez-2000 do TWiki.

Mudanças principais de Tabelas de Categoria

Um Molde de Formulário é uma substituição mais poderosa e flexível para a TWikiCategoryTable original. Dados existentes no antigo formato de Category Tables podem ser importados diretamente.

Importando dados de Tabelas de Categoria (Category Table)

Ao fazer o upgrade de uma versão anterior do TWiki, um molde de formulário tem que ser criado para cada Web que utilizava uma Tabela de Categoria, recriando os campos e os valores do antigo twikicatitems.tmpl. A substituição para Formulário deve ser definida como o primeiro item na variável WEBFORMS em WebPreferences. Se ela estiver faltando, as páginas aparecerão, mas as tentativas de edição resultarão em uma mensagem de erro.

O novo sistema de formulários deve trabalhar com o dados da antiga Tabela de Categoria sem nenhuma conversão especial. Dados são convertidos para variáveis Meta Dados na primeira vez que um tópico que as importa é editado e salvo no novo sistema.

NOTA: Se as coisas não estão funcionando corretamente, pode haver informações úteis em data/warning.txt.

Definindo um Molde(Template) de Formulário

Um Molde de Formulário é uma simples página contendo seu formulário, definido como uma tabela onde cada linha é um campo.

Elementos de um Molde(Template) de Formulário

• Molde de formulário - uma seleção de campos definindo um formulário (substitui tabela de definição de categoria)
  • Uma web pode usar um ou mais moldes de formulário
• formulário - um tópico contendo meta dados adicionais (além do TEXTAREA freeform) que categoriza o conteúdo (substitui tabela de definição de categoria)
  • Em uma web com formulários habilitados, tópicos individuais podem ter um ou nenhum formulário
• campo de formulário - um item nomeado em um formulário (substitui nome de item de categoria)
• tipo de campo - seleciona o tipo de entrada:
  • select - um menu deslizante (drop-down) ou uma caixa de seleção rolável
  • checkbox - uma ou mais caixas de seleção
  • checkbox+buttons - uma ou mais caixas de seleção, com os botões Set (marcar) e Clear (apagar)
  • radio - um ou mais botões de rádio
  • text - um campo de texto de uma linha
  • textarea - uma caixa de texto; o tamanho é definido como 40x10 (colunas x linhas)
• valor do campo - um ou mais valores para um grupo fixo (tipos select, checkbox e radio) ou texto livre de formulário. (substitui nome de item de categoria)

Definindo um Formulário em um tópico

1. Crie um novo tópico para o nome de seu formulário: YourForm, ExpenseReport, InfoCategory, RecordReview, o que quer que você precise.
2. Crie uma tabela TWiki, com o cabeçalho de cada coluna representando um elemento de um campo de entrada: Nome, Tipo, Tamanho, Valores, e ==mensagem Tooltip (veja exemplo abaixo).
3. Para cada campo, preencha uma nova linha; para o tipo do campo, selecione da lista.
4. Salve o tópico (você pode escolher habilitar/desabilitar formulários individuais mais tarde)

Exemplo: WebForm

| *Nome* | *Tipo* | *Tamanho* | *Valores* | *Mensagem Tooltip* |
| Know.TopicClassification | select | 1 | Know.NoDisclosure, 
  Know.PublicSupported, Know.PublicFAQ | blah blah... |
| Know.OperatingSystem | checkbox | 3 | Know.OsHPUX, Know.OsLinux,
  Know.OsSolaris, Know.OsWin | blah blah... |
| Know.OsVersion | text | 16 | | blah blah... |

Nome	Tipo	Tamanho	Valores	Mensagem Tooltip
TopicClassification	select	1	NoDisclosure, PublicSupported, PublicFAQ	blah blah...
OperatingSystem	checkbox	3	OsHPUX, OsLinux, OsSolaris, OsWin	blah blah...
OsVersion	text	16		blah blah...

Definindo um formulário com múltiplos tópicos

Formulários podem ser definidos para usar Moldes que retornem valores de campos de um ou mais tópicos separados:

• Um tópico FormTemplate define o Formulário, ex: YourFormTemplate.
• Para cada campo que tem uma lista de valores - select, radio, checkbox - pode-se usar tópicos separados que definem os valores disponíveis.

Exemplo: WebFormTemplate

• Know.WebFormTemplate main definition:
   

  Nome	Tipo	Tamanho	Valores	Mensagem Tooltip
  TopicClassification	select	1		blah blah...
  OperatingSystem	checkbox	3		blah blah...
  OsVersion	text	16		blah blah...

  
  Deixe o campo Valores em branco.

• Know.TopicClassification difinição de valor de campo:
   

  Nome	Tipo	Mensgem Tooltip
  NoDisclosure	option	blah blah...
  PublicSupported	option	blah blah...
  PublicFAQ	option	blah blah...

• Notas de Implementação: Esse formato permite que você defina items de campos com ou sem WikiNames, dependendo de suas necessidades.
  • Tópicos podem ser protegidos da maneira usual, usando TWikiAccessControl, para limitar quem pode mudar o molde de formulário e/ou listas de valores individuais.
  • [[...]] links podem ser usados para forçar um link (no momento, o formato [[...][...]] não é suportado).
  • A coluna Tooltip message é usada como uma tooltip para o nome de campo (somente se o nome de campo for uma WikiName) - você apenas vê o tooltip ao editar.
  • O primeiro item na lista é o item padrão. Valores iniciais alternativos podem ser definidos em um molde de tópico, como WebTopicEditTemplate, com field=value, ou, para checkboxes, field=1.
  • A definição de um tópico não é lida quando um tópico é visto.

Habilitando Formulários pela Web

Formulários são habilitados em uma per web basis. A variável WEBFORMS em WebPreferences é opcional e difine uma lista de possíveis moldes de formulários. Exemplo:

• Set WEBFORMS = BugForm, FeatureForm, BookLoanForm

• Com WEBFORMS habilitado, um botão extra é adicionado a edit view. Se um tópico não possuir um Formulário, um botão Add Form aparecerá ao fim do tópico. Caso haja um formulário, um botão Change aparecerá na coluna de cima do formulário. Os botões abrem uma tela que permite a seleção de um formulário especificado em WEBFORMS, ou a opção No form.

Incluindo Formulários em Tópicos Novos

• Um Molde padrão de Formulário (novos tópicos recebem esse formulário padrão) podem ser providenciados criando o tópico WebTopicEditTemplate em uma Web e adicionando um formulário a ele. Valores iniciais de formulários podem ser definidos ali.

• Adicionalmente, um novo tópico pode receber um formulário usando o parâmetro formtemplate na URL. Valores iniciais podem ser providenciados nas URLs ou como valores de formulários:
  • outros além de checkboxes: name, ex: ?BugPriority=1
  • checkbox: namevalue=1, ex: ?ColourRed=1.
    Caixas com um tick devem ser especificadas.

Definindo Múltiplas Opções de Formulários

• A variável opcional WEBFORMS define formulários alternativos que podem ser selecionados pressionando Change no modo de edição.

• Um molde de tópico pode usar qualquer formulário.

• Novos tópicos com um formulário são criados por simples formulários HTML perguntando por um nome de tópico. Por exemplo, você pode ter um tópico SubmitExpenseReport onde você possa criar novos expense reports, um tópico SubmitVacationRequest, e assim por diante. Estes podem especificar os moldes de tópico requeridos com seus formulários associados.

Armazenamento de dados dos Formulários

O nome do tópico do formulário, campos e valores são armazenados como TWikiMetaData - a ordem dos pares campo/valor é a mesma definida no molde de formulário.

Usandos dados dos Formulários

TwikiForms^? aceitam dados fornecidos por usuários, armazenados como TWikiMetaData. Meta dados também contêm informações geradas automaticamente sobre alterações, arquivos anexados, etc. Para encontrar, formatar e exibir formulários ou outro meta dado, veja TWikiMetaData, e as variáveis SEARCH e METASEARCH no tópico TWikiVariables, e TWiki Busca Formatada para várias opções.

-- JohnTalintyre^? - 16 Aug 2001
- - MikeMannix - 05 Jan 2002

Templates TWiki

Definição dos Templates utilizados para renderizar todas as páginas HTML mostradas no TWiki

Visão Geral

Principais alterações do sistema de templates anterior

Onde os antigos Templates eram cada um um documento HTML completo, os novos Templates são definidos usando-se variáveis para incluir partes de um arquivo mestre. Agora você pode mudar apenas uma instância de um elemento comum e afetar todas as suas ocorrências; antes, cada Template afetado tinha de ser mudado. Isso simplifica a conversão de Templates em arquivos XHTML, e fornece uma solução mais versátil para Templates e TwikiSkins^?. O novo sistema:

• separa uma lista de partes comuns de Templates em um Template base que é incluído em todos os Templates relacionados;
• define variáveis comuns, como um separador padrão (ex: "|"), no modelo base;
• define valores de variáveis em Templates individuais e retorna-os para o modelo base.

Como as Variáveis de Template Funcionam

• Diretivas especiais para Templates (ou comandos de preprocessador) são incluídas em Templates normais.
• Todo o preprocessamento de Templates é feito em &TWiki::Store::readTemplate() de modo que o invocador apenas recebe um arquivo de Template expandido (igual a antigamente).
• As directives são do formulário %TMPL:<key>% e %TMPL:<key>{"attr"}%.
• Directives:
  • %TMPL:INCLUDE{"file"}%: Inclui um arquivo de Template. O diretório de Templates da web é vasculhado antes, e depois os Templates do diretório raiz (twiki/templates).
  • %TMPL:DEF{"var"}%: Define uma variável. O texto entre isso e a directive END não é retornado, mas quardado numa hash para uso posterior.
  • %TMPL:END%: Termina uma definição de variável.
  • %TMPL:P{"var"}%: Mostra uma variável previamente definida.
• As variáveis são globais: elas não recebem parâmetros.
• Procesamento duplo permite que você utilize uma variável antes de declará-la.
• Templates e TWikiSkins^? funcionam de forma transparente e intercambiável. Por exemplo, você pode criar uma skin que substitui apenas o Template mestre twiki.tmpl, como twiki.print.tmpl, que redefine o cabeçalho e o rodapé.
• O uso de directives de Template é opcional: Templates funcionam sem ele.
• NOTE: Template directives work only for templates: they do not get processed in topic text.

Tipos de Template

Existem 3 tipos de Template:

• Template Mestre: Guarda partes comuns; incluído por outros Templates.
• Templates de Página HTML: Define o layout de páginas TWiki
• Tópicos Padrão: Definem o texto padrão quando você cria um novo tópico

Templates Mestre

Variáble:	Define:
%TMPL:DEF{"sep"}%	"|" separador
%TMPL:DEF{"htmldoctype"}%	Início de todas as páginas HTML
%TMPL:DEF{"standardheader"}%	Cabeçalho padrão (ex: ver, índice, busca)
%TMPL:DEF{"simpleheader"}%	Cabeçalho padrão com links reduzidos (ex: editar, anexar, oops)
%TMPL:DEF{"standardfooter"}%	Rodapé,excluindo partes de revisão e copyright
%TMPL:DEF{"oops"}%	Esqueleto da caixa de diálogo oops

Páginas HTML Template

O TWiki usa templates HTML para todas as ações, como ver tópicos, editar, and previsualizar. Isso permite que você mude a aparência e o tom de muitas páginas apenas editando alguns arquivos.

Os templates estão no diretório twiki/templates . Como um exemplo, twiki/templates/view.tmpl é o template para o script twiki/bin/view . Templates podem ser substituídos em webs individuais. A ordem de procura é a seguinte:

1. twiki/templates/$webName/$scriptName.tmpl
2. twiki/templates/$scriptName.tmpl
   • $webName é o nome da web (ex: Main)
   • $scriptName é o script (ex: view).

NOTE: As TWikiSkins^? podem ser definidas para se sobreporem aos templates padrão.

Variáveis especiais são utilizadas em templates, especialmente em view, para mostrar meta dados.

Templates de Tópicos

Template de topicos definem o texto padrão para novos tópicos. Existem três tipos de templates de tópicos:

Nome:	O que é:
WebTopicViewTemplate	Página de erro quando se endereça um tópico não-existente
WebTopicNonWikiTemplate	Página de alerta mostrada quando você tenta visualizar um tópico não existente que não é uma WikiWord
WebTopicEditTemplate	Texto padrão quando se cria um novo tópico.

1. Um nome de tópico especificado pelo parâmetro CGI templatetopic .
2. WebTopicEditTemplate na web atual
3. WebTopicEditTemplate na web TWiki

Editando Templates de Tópicos e Expansão de Variáveis

As variáveis seguintes são expandidas quando um usuário cria um novo tópico baseado num template de tópico:

Variável:	Descrição:
%DATE%	Data atual, e.g. 21 Nov 2009
%WIKIUSERNAME%	Nome do usuário, e.g. Main.TWikiGuest
%URLPARAM{"name"}%	Valor de um parâmetro passado na URL com o nome 'name'
%NOP%	Uma variável de não-operação que é removida. Útil para prevenir uma SEARCH de alcançar um tópico de edição; útil também para escapar uma variável, como em %URLPARAM%NOP%{...}%
%NOP{ ... }%	Um texto de não-operação que é removido. Útil para proteger um template contra edição, mas não os tópicos baseados no template. Veja as notas abaixo. Exemplo: %NOP{    * Set ALLOWTOPICCHANGE = Main.TWikiAdminGroup }%

Notas:

• Diferentemente de outras variáveis, %NOP{ ... }% pode ocupar várias linhas.
• A busca para o padrão de fechamento }% é "non-greedy" (não-avarenta), isto é, pára após a primeira ocorrência. Isto significa que, quando você precisa escapar variáveis com parâmetros localizados dentro de um %NOP{ ... }%: Insira um %NOP% entre } e %. Um exemplo besta: %NOP{ %GMTIME{"$year"}%NOP%% }%.

Todas as outras variáveis vão sem modificações para o tópico.

Templates de Tópicos em Ação

O formulário acima pede por um nome de tópico. Uma tag escondida chamada de templatetopic especifica ExampleTopicTemplate^? como o template de tópico a ser utilizado. Aqui está o fonte HTML do formulário:

<form name="new" action="%SCRIPTURLPATH%/edit%SCRIPTSUFFIX%/%INTURLENCODE{"%WEB%"}%/">
   * Novo template de tópico: 
     <input type="text" name="topic" value="ExampleTopic%SERVERTIME{$yearx$mox$day}%" size="23" />
     <input type="hidden" name="templatetopic" value="ExampleTopicTemplate" />
     <input type="hidden" name="onlywikiname" value="on" />
     <input type="submit" value="Create" />
     (date format is <nop>YYYYxMMxDD)
</form>

O parâmetro onlywikiname força WikiWords para nomes de tópico.

TIP: Você pode usar as variáveis %WIKIUSERNAME% e %DATE% nos seus templates de tópicos para incluir a assinatura de quem gerou o tópico. as variáveis são expandidas em texto quando um tópico é criado. A assinatura padrão é:
-- %WIKIUSERNAME% - %DATE%

Templates por Exemplo

Anexado está o exemplo de um template baseado em oops, oopsbase.tmpl e uma example oops dialog oopstest.tmpl baseada no template base. %A% NOTE: Esta não é a versão final, apenas um demo rápido e simples.

Template de base oopsbase.tmpl

A primeira linha declara uma variável delimitadora chamada "sep", utilizada para separar mútltiplos itens linkados. A variável pode ser invocada em qualquer lugar digitando-se %TMPL:P{"sep"}%

%TMPL:DEF{"sep"}% | %TMPL:END% <html> <head> <title> %WIKITOOLNAME% . %WEB% . %TOPIC% %.TMPL:P{"titleaction"}%</title> <base href="%SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%"> <meta name="robots" content="noindex"> </head> <body bgcolor="#FFFFFF"> <table width="100%" border="0" cellpadding="3" cellspacing="0"> <tr> <td bgcolor="%WEBBGCOLOR%" rowspan="2" valign="top" width="1%"> <a href="%WIKIHOMEURL%"> <img src="%PUBURLPATH%/wikiHome.gif" border="0"></a> </td> <td> <b>%WIKITOOLNAME% . %WEB% . </b><font size="+2"> <B>%TOPIC%</b> %TMPL:P{"titleaction"}%</font> </td> </tr> <tr bgcolor="%WEBBGCOLOR%"> <td colspan="2"> %TMPL:P{"webaction"}% </td> </tr> </table> --- ++ %TMPL:P{"heading"}% %TMPL:P{"message"}% <table width="100%" border="0" cellpadding="3" cellspacing="0"> <tr bgcolor="%WEBBGCOLOR%"> <td valign="top"> Topic <b>%TOPIC%</b> . { %TMPL:P{"topicaction"}% } </td> </tr> </table> </body>

Test template oopstest.tmpl

Cada oops templade apenas define variáveis e inclui o template base que faz o layout.

</table >

Um screenshot de oopstest.tmpl

Com a URL: .../bin/oops/Sandbox/TestTopic2?template=oopstest&param1=WebHome&param2=WebNotify

%TMPL:DEF{"titleaction"}% (test =titleaction=) %TMPL:END% %TMPL:DEF{"webaction"}% test =webaction= %TMPL:END% %TMPL:DEF{"heading"}% Test heading %TMPL:END% %TMPL:DEF{"message"}% Test =message=. Blah blah blah blah blah blah blah blah blah blah blah... * Some more blah blah blah blah blah blah blah blah blah blah... * Param1: %PARAM1% * Param2: %PARAM2% * Param3: %PARAM3% * Param4: %PARAM4% %TMPL:END% %TMPL:DEF{"topicaction"}% Test =topicaction=: [[%WEB%.%TOPIC%][OK]] %TMPL:P{"sep"}% [[%TWIKIWEB%.TWikiRegistration][Register]] %TMPL:END% %TMPL:INCLUDE{"oopsbase"}%

Problemas Conhecidos

• Um problema de se referir a um template mestre é que só se pode testar um template dentro do TWiki, onde as variáveis inclusas são resolvidas. No sistema anterior, cada template era um documento HTML estruturalmente completo, com a extensão .tmpl - ele continha %VARIABLES% não resolvidas, mas podia ser testado em um browser.

-- PeterThoeny - 01 Feb 2003
-- MikeMannix - 14 Sep 2001
-- TWiki:Main/DavidLeBlanc - 11 Mar 2002

Warning: Can't find topic TWikiSkins

Resultados Formatados da Busca TWiki

A característica da busca em linha (%SEARCH{...}%) que permite a formatação flexível do resultado

A variável %SEARCH{...}% documentada em Variávei do TWiki tem um formato fixo para o resultado da busca, isto é, uma tabela contendo nomes de tópicos e sumários. Use o parâmetro format="..." para especificar um formato personalizado do resultado. A string do parâmetro format normalmente é uma lista de bolotas ou linhas de tabela contendo variáveis (como em %SEARCH{ "comida" format="| $topic | $summary |" }%).

Sintaxe

Dois parâmetros podem ser usados para especificar um resultado de busca personalizado:

1. Parâmetro header="..."

Use o parâmetro header para especificar o cabeçalho de um resultado de busca. Isso deve corresponder ao fomato no parâmetro format. Esse parâmetro é opcional.
Exemplo: header="| *Tópico:* | *Sumário:* |"

2. Parâmetro format="..."

Use o parâmetro format para especificar o formato de um item do resultado.
Exemplo: format="| $topic | $summary |"

Variáveis que podem ser usadas na linha de formatação:

Nota: Para $pattern(reg-exp), especifique uma Expressão Regular que varra do início ao fim e contenha o texto que você deseja pegar em parênteses, como $pattern(.*?(daqui.*?até aqui).*). Você precisa ter certeza que a integridade da página web não será comprometida; por exemplo, se você incluir uma tabela, tenha certeza de incluir tudo, inclusive o fim da tag table.

Exemplos

Lista de bolota mostrando nome do tópico e sumário

Escreva isso:

%SEARCH{ "FAQ" scope="topic" nosearch="on" nototal="on" header="   * *Tópico: Sumário:*" format="   * [[$topic]]: $summary" }%

Para ter isso:

• Tópico: Sumário:
• TWikiFAQ: Dúvidas Freqüentes sobre TWiki Este é um FAQ real, e também uma demonstração de uma das soluções de base de conhecimento facilmente implementadas. Veja como é feito ...
• TWikiFaqTemplate: Pergunta: Resposta: Voltar para: TWikiFAQ
• TextFormattingFAQ: FAQ de Formatação de Texto As perguntas mais freqüentes sobre formatação de texto estão respondidas. Além dessa, o tópico TextFormattingRules contém o sistema TWiki ...

Tabela mostrando valores de campos de formulário de tópicos com TWikiForms

Escreva isso na web Know:

| *Tópico:* | *OperatingSystem:* | *OsVersion:* |
%SEARCH{ "[T]opicClassification.*?value=\"[P]ublicFAQ\"" scope="text" regex="on" nosearch="on" nototal="on" format="| [[$topic]] | $formfield(OperatingSystem) | $formfield(OsVersion) |" }%

Para ter isso:

Extraindo algum texto de um tópico usando expressão regular

Escreva isso:

%SEARCH{ "__Back to\:__ TWikiFAQ" scope="text" regex="on" nosearch="on" nototal="on" header="TWiki FAQs:" format="   * $pattern(.*?FAQ\:[\n\r]*([^\n\r]+).*) [[$topic][Answer...]]" }%

Para ter isso:

Busca aninhada

Buscas podem ser aninhadas. Por exemplo, busque por alguns tópicos, então faça uma nova busca em cada tópico da primeira busca. A idéia é montar a busca aninhada usando a busca formatada na primeira busca.

Aqui temos um exemplo. Vamos procurar por todos os tópicos que contenham a palavra "cultura" (primeira busca), e vamos encontrar onde cada tópico encontrado é linkado (segunda busca).

• Primeira busca:
  • %SEARCH{ "culture" format="   * $topic is referenced by: (list all references)" nosearch="on" nototal="on" }%
• Segunda busca. Para cada item nós queremos esta busca:
  • %SEARCH{ "(tópico encontrado na primeira busca)" format="   $topic" nosearch="on" nototal="on" }%
• Agora vamos aninhar as duas. Nós precisamos "escapar" a segunda busca, e.g. a primeira busca irá construir uma segunda linha de busca válida. Note que nós escapamos a segunda busca para que ela não seja avaliada prematuramente na primeira busca:
  • Use $percnt para escapar os porcentos importantes da segunda busca
  • Use \" para escapar as aspas duplas
  • Use $dollar para escapar o $ de $topic
  • Use $nop para escapar a seqüência }%

Escreva isso:

%SEARCH{ "culture" format="   * $topic é referenciado por:$n      * $percntSEARCH{ \"$topic\" format=\"   $dollartopic\" nosearch=\"on\" nototal=\"on\" }$nop%" nosearch="on" nototal="on" }%

Para ter isso:

• FormattedSearch é referenciado por:
  • ManagingWebs TWikiDocumentation TWikiForms TWikiHistory TWikiVariables TWikiWebHome TextFormattingRules
• TWikiAccessControl é referenciado por:
  • FileAttachment TWikiAccessControl TWikiDocumentation TWikiForms TWikiHistory TWikiPages TWikiPreferences TWikiRegistration TWikiTutorial TWikiVariables TWikiWebHome WebPreferences WelcomeGuest WikiWord
• TWikiSite é referenciado por:
  • InterwikiPlugin ManagingWebs TWikiDocumentation TWikiHistory TWikiInstallationGuide TWikiPlannedFeatures TWikiRegistration TWikiSite TWikiTutorial TWikiWebHome WabiSabi WebStatistics WelcomeGuest WikiCulture
• WabiSabi é referenciado por:
  • TWikiSite WabiSabi WikiCulture
• WebStatistics é referenciado por:
  • TWikiHistory TemplateWeb WebStatistics
• WelcomeGuest é referenciado por:
  • DiretrizesDeTraducao TWikiSite TWikiWebHome WebStatistics WikiCulture YouAreHere

-- PeterThoeny^? - 16 May 2002

Meta Dados TWiki

Tópico de informações adicional, gerado pelo programa ou pelo TWikiForms, é armazenado na variável META em pares nome/valor

Visão Geral

TWikiMetaData usa as variáveis META para armazenar tópico de informações que é separado do conteúdo do free-form principal. Isso inclui informação gerada pelo programa como FileAttachment e dados de movimenação do tópico, e informação definida pelo usuário TWikiForms. Use as variáveis META para formatar e mostrar Meta Dados.

Sintaxe do Meta Dado

• A formatação é a mesma de TWikiVariables, exceto que todos os campos têm uma chave.
  • %META:<tipo>{chave1="valor1" chave2="valor2" ...}%

• A ordem dos campos dentro das variáveis meta não estão definidos, exceto caso tenha um campo com a chave name, que aparece primeiro para facilitar a busca (note que a ordem das próprias variáveis é definida).

• Cada meta variável está em uma linha.

• \n (nova linha) é representada em valores por %_N_ e " (aspas duplas) por %_Q_%.

Exemplo de Formatação

%META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}%
   texto do tópico
%META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName"
   by="JohnTalintyre" date="976762680"}%
%META:TOPICPARENT{name="NavigationByTopicContext"}%
%META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }%
%META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }%
%META:FORM{name="WebFormTemplate"}%
%META:FIELD{name="OperatingSystem" value="OsWin"}%
%META:FIELD{name="TopicClassification" value="PublicFAQ"}%

Especificação de Meta Dados

A versão atual de Meta Data é a 1.0, com suporte para as seguintes variáveis.

META:TOPICINFO

META:TOPICMOVED

Isto é opcional, existe caso o tópico já tenha sido movido alguma vez. Caso um tópico seja movido mais de uma vez, somente a mais recente variável meta META:TOPICMOVED existe no tópico, as mais antigas devem ser encontradas no histórico RCS.

%META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName" by="talintj" date="976762680"}%

Notas:

• no momento, o número da versão não é suportado diretamente, mas pode ser inferido a partir do histórico RCS.
• existe apenas um META:TOPICMOVED em um tópico, informações de movimento mais antigas podem ser encontradas no histórico RCS.

META:TOPICPARENT

META:FILEATTACHMENT

Campos extra que são adicionados se um anexo é movido:

META:FORM

META:FIELD

Deve somente ser mostrado caso haja uma entrada META:FORM. Note que essa informação é usada quando um tópico é visualizado, a definição de molde de formulário não é lida.

Seqüência Recomendada

Não há nenhuma necessidade de que as variáveis Meta Data sejam listadas em uma ordem específica dentro de um tópico, mas faz sentido fazê-lo por alguns bons motivos:

• os campos de formulário permanecem na ordem em que foram definidos
• a saída da função diff aparece em uma ordem lógica

A seqüência recomendada é:

• META:TOPICINFO
• text of topic
• META:TOPICMOVED (opcional)
• META:TOPICPARENT (opcional)
• META:FILEATTACHMENT (0 ou mais entradas)
• META:FORM (opcional)
• META:FIELD (0 ou mais entradas; FORM exigido)

Visualizando Meta Data em código de fonte

Ao visualizar um tópico, o link Raw Text pode ser clicado para mostrar o texto de um tópico(i.e., como visto durante edição). Isso é feito adicionando raw=on à URL. raw=debug mostra meta data assim como o topic data, ex: debug view for this topic

Rendering Meta Data

Meta Data é fornecido com a variável %META%. Isso é geralmente usado nos scripts view, preview e edit.

Suporte atual envolve:

Assuntos conhecidos

No momento, Meta Data não tem suporte para Plugins. No entanto, a informação é prontamente extensível e o código Meta.pm que suporta a formatação precisa somente de pequenas alterações.

-- JohnTalintyre^? - 29 Aug 2001
-- MikeMannix - 03 Dec 2001
-- PeterThoeny^? - 10 Jan 2002

Warning: Can't find topic TWikiPlugins

Warning: Can't find topic TWikiSiteTools

Warning: Can't find topic ManagingTopics

Gerenciando Webs

A criação de webs é uma operação que pode ser feita via interface web; renomeação e deleção de webs são operações manuais feitas diretamente no servidor

Visão Geral

Um TWikiSite é dividido em webs; cada uma representa um assunto, uma área de colaboração. Administradores podem adicionar/renomear/deletar webs.

Escolha o Template da Web

Existem dois métodos para criar uma nova web. O primeiro é usar uma (especialmente nomeada) TemplateWeb. Esta é uma web invisível que começa com um caracter de underscore "_". Todos os tópicos na web template _default serão copiados para sua nova web.

O segundo método é usar uma web já existente como uma web template. Isto pode ser útil se você já tem uma web que você gosta de usar como ponto de partida. Somente tópicos que têm nomes começando com Web... (como "WebHome", "WebNotify", etc.) serão copiados.

Em cada um desses casos você irá querer estar certo de que sua nova web tem todas as modificações de personalização que você deseja.

Adicionando uma Nova Web

Nota: Anexos NÃO serão copiados junto com seus tópicos. Essa será uma funcionalidade adicionada na TWiki:Codev/CairoRelease.

Nota: Este script ainda não edita o TWiki.TWikiPreferences arquivo para atualizar o WIKIWEBLIST. É preciso fazê-lo manualmente.

O script de gerenciamento, ao criar a nova web, irá também atualizar as seguintes variáveis em WebPreferences: WEBBGCOLOR, SITEMAPLIST, SITEMAPWHAT, SITEMAPUSETO and NOSEARCHALL. Essas variáveis são usadas agora na geração dinâmica do SiteMap^?.

Renomeando ou Deletando uma Web

Para renomear ou deletar uma web é necessário acesso direto aos arquivos da instalação no servidor. Atualmente não há ferramenta com interface web para renomear, mover ou deletar webs, como há para tópicos.

NOTA: Se você planeja renomear a web TWiki.Main, lembre-se que o TWiki armazena os tópicos de usuários e grupos na %MAINWEB%, nomeada por defaul Main. Isso significa que cada assinatura WikiName - Main.AlgumNomeUsuario - aponta para ela e necessitará de atualização (a não ser que a variável %MAINWEB%.SomeUserName tenha sido usada sempre).

1. Prepare seu site: Busque em cada web links para a web alvo, procurando por Nomedawebantiga. nos textos dos tópicos, incluindo o ponto final, de forma que você achará referências como Nomedawebantiga.AlgumTopico.
   • Faça as mudanças necessárias, para Nomedanovaweb.AlgumTopico, ou melhor ainda, para %MAINWEB%.AlgumTopico.
2. Edite o tópico TWikiPreferences: Renomeie ou delete a web na variável WIKIWEBLIST.
3. Faça o login no servidor do TWiki, via Telnet ou FTP.
4. Vá para o diretório twiki/data e renomeie ou remova o diretório da web.
5. Vá para o diretório twiki/templates e renomeie ou remova o diretório da web, se existir.
6. Vá para o diretório twiki/pub e renomeie ou remova o diretório da web, se existir.

-- MikeMannix - 14 Sep 2001
-- PeterThoeny^? - 07 Apr 2002
-- GrantBow - 16 Jan 2003

Versão português pt-BR:

-- FernandoMoraes^? - 01 Jul 2004

Warning: Can't find topic AppendixFileSystem

Appendix B: Histórico do Desenvolvimento TWiki

01-Dez-2001 Release (Athens)

• 25 Out 2001 - PeterThoeny
  • Adicionou FormattedSearch à variável %SEARCH{}% para database like reporting.

01-Set-2001 Release

• 30 Ago 2001 - JohnTalintyre^?
  • Instalação mais fácil para Windows, incluindo detecção automática em TWiki.cfg
• 30 Ago 2001 - JohnTalintyre^?
  • Habilidade para mover anexos entre tópicos, veja FileAttachments
• 21 Ago 2001 - PeterThoeny
  • Conversão para função XHTML 1.0: primeiro passo para XHTML-ifying TWiki
• 26 Jun 2001 - JohnTalintyre^?
  • Informação de categoria para formulários usando o formato TWikiMetaData, veja TWikiForms
• 07 Jun 2001 - PeterThoeny
  • Novo tópico templates como tópicos em vez de templates. Personalize ao editar o tópico. Aposentados os modelos notedited.tmpl, notext.tmpl e notwiki.tmpl. Mais em TWikiTemplates.
• 07 Jun 2001 - PeterThoeny
  • Novas variáveis %TOPICLIST{"format"}% e %WEBLIST{"format"}% para obter um formatted topic index e web index, respectivamente. Mais em TWikiVariables.
• 01 Jun 2001 - PeterThoeny
  • Nova variável %URLPARAM{"name"}% para questionar parâmetros URL. Mais em TWikiVariables.
• 01 Jun 2001 - AndreaSterbini^?
  • API to extend TWiki, veja TWikiPluginAPI^?
• 01 Jun 2001 - KlausWriessnegger^?, AndreaSterbini^?
  • Formulários para mudar/reset/instalar senhas, veja ChangePassword & ResetPassword
• 01 Mai 2001 - AndreaSterbini^?
  • O TWikiAdminGroup (ou outro grupo) pode ser habilitado como um SuperAdminGroup. Membros têm acesso a edição de navegador a _todos_tópicos bloqueados.
• 01 Mai 2001 - JohnTalintyre^?
  • Meta information format, veja TWikiMetaData
• 01 Mai 2001 - JohnTalintyre^?
  • Anexo sob controle de revisão. Veja FileAttachment
• 01 Mai 2001 - JohnTalintyre^?
  • Habilidade para renomear/mover tópicos, ManagingTopics^?
• 27 Mar 2001 - PeterThoeny
  • A tabela de sintaxe foi elevada para (i) suprir | *negrito* | as células como cabeçalhos de tabela, (ii) suprir space padded cells |   alinhada ao centro   | e |   alinhada a direita |, (iii) span colunas múltiplas usando | células vazias |||. Mais em TextFormattingRules.
• 25 Mar 2001 - PeterThoeny
  • Security fix Questionable files como scripts PHP (executáveis) e arquivos .htaccess que são anexados a um tópico recebem o sufixo .txt no nome do arquivo. Veja também TWiki:Codev/FileAttachmentFilterSecurityAlert
• 28 Fev 2001 - AndreaSterbini^?, PeterThoeny
  • Nova regra Wiki para cabeçalhos, i.e. ---++ Meu Título; e nova %TOC% variável para construir uma tabela de conteúdos de cabeçalhos em um tópico. Mais em TWikiVariables.
• 28 Fev 2001 - PeterThoeny
  • Nova regra Wiki para especificar texto arbitrário para links externos (i.e. [[http://TWki.org][TWiki]]) e links internos (i.e [[WikiSyntax][syntax]]). Mais em TWikiVariables.
• 28 Fev 2001 - PeterThoeny
  • Nova regra Wiki para âncoras nomeadas, e.g. links dentro de um tópico. Defina uma âncora nomeada com #MinhaAncora no início de uma linha, e forme um link a ela com [[#MyAnchor]]. Mais em TWikiVariables.

• 25 Fev 2001 - NicholasLee^?, PeterThoeny
  • Use o módulo Net::SMTP em vez de sendmail caso esteja instalado.
• 01 Fev 2001 - PeterThoeny
  • Adicionadas as tags <verbatim> ... </verbatim> para mostrar código fonte "as is". Ao contrário das tags <pre> ... </pre> , também mostra caracteres <, >, & "as is".
• 01 Fev 2001 - PeterThoeny
  • Consertou TWiki:Codev/CreateLinkToAttachedFileBug.
• 21 Jan 2001 - PeterThoeny
  • Adicionou a checkbox "Minor change, don't notify" em preview. Mais em DontNotify.
• 21 Jan 2001 - PeterThoeny
  • Adicionou formatação Bold Fixed usando sinal duplo de iguais, e.g. escreva ==Bold Fixed== para obter Bold Fixed.
• 20 Jan 2001 - PeterThoeny
  • Mudança na formatação das variáveis %GMTIME{"..."}% e %SERVERTIME{"..."}%. Formatação é agora "$hour:$min" em vez de "hour:min". Mais em TWikiVariables. Atenção: Confira seus tópicos existentes quando fizer o upgrade do TWiki!
• 18 Jan 2001 - PeterThoeny
  • WebChanges, WebSearch e notificação por e-mail indicam também o número de revisão do tópico (i.e. 18 Jan 2001 16:43 r1.5), ou NEW para um novo tópico (i.e. i.e. 18 Jan 2001 16:43 NEW).
• 16 Jan 2001 - PeterThoeny
  • Novas variáveis %STARTINCLUDE% e %STOPINCLUDE% para controlar o que é incluído em um tópico. Mais em TWikiVariables.
• 16 Jan 2001 - PeterThoeny
  • TWiki skins Define um layout de página diferente com um layout de cabeçalho e rodapé customizados, i.e. uma skin print para versão para impressão da visualização de um tópico. Mais em TWikiSkins^? e TWiki:Codev/TWikiSkins.
• 07 Jan 2001 - StanleyKnutson^?
  • Melhor controle de erro ao salvar um tópico.
• 05 Jan 2001 - PeterThoeny
  • Autorização de visualização baseada em grupos. Define quem tem permissão de ver uma Web TWiki. Mais em TWikiAccessControl e TWiki:Codev/AuthenticationBasedOnGroups.
• 05 Dez 2000 - PeterThoeny
  • Melhorou manipulação de include. Previne recursão infinita de includes; novas variáveis %BASEWEB%, %INCLUDINGWEB%, %BASETOPIC% e %INCLUDINGTOPIC% para ter um maior controle sobre a manipulação de include. Mais em TWikiVariables e TWiki:Codev/IncludeHandlingImprovements.
• 03 Dez 2000 - PeterThoeny
  • Novo switch noheader="on" em %SEARCH{...}% para suprimir cabeçalho de tabela. Mais em TWikiVariables.

01-Dez-2000 Release

• 03 Nov 2000 - PeterThoeny
  • Flag $doHidePasswdInRegistration em wikicfg.pm para ocultar senha plain text em registration email.
• 01 Nov 2000 - PeterThoeny
  • Nova variável %VAR{"NAME" web="Web"}% para adquirir preferências Web específicas. Mais em TWikiVariables.
• 01 Nov 2000 - PeterThoeny
  • Adicionou um link "Cancel" na edição que libera o bloqueio de edição.
• 23 Out 2000 - PeterThoeny
  • Autorização baseada em grupos. Define fine graned control who is allowed to change or create topics. Mais em TWikiAccessControl e TWiki:Codev/AuthenticationBasedOnGroups.
• 05 Out 2000 - PeterThoeny
  • Lembra do usuário pelo seu endereço IP de maneira que view "saiba" o usuário que já foi autenticado em edit. Mais em TWikiUserAuthentication^?.
• 26 Set 2000 - AlWilliams^?, PeterThoeny
  • Consertou o erro TWiki:Codev/UppercaseAttachments e adicionou suporte a imagem png.
• 26 Set 2000 - HaroldGottschalk^?, AndreaSterbini^?, PeterThoeny
  • Permite o aninhamento de variáveis, i.e. %INCLUDE{"%TWIKIWEB%.TWikiWebsTable"}%. Mais em TWiki:Codev/BetterTWikiTagTemplateProcessing.
• 20 Set 2000 - ManpreetSingh^?
  • Novo switch -q em mailnotify para suprimir todas as saídas normais.
• 19 Set 2000 - PeterThoeny
  • Consertou TWiki:Codev/AttachedNotificationLinksBug.
• 18 Set 2000 - ManpreetSingh^?, PeterThoeny
  • Adicionou forced internal links. Escreva [[text formatting FAQ]] para obter o link text formatting FAQ que aponta para o tópico TextFormattingFAQ.
• 19 Ago 2000 - PeterThoeny
  • Link Ref-By busca todas as Webs (não apenas a Web atual.)
• 16 Ago 2000 - PeterThoeny
  • Novas variáveis TWikiPreferences %HTTP_EQUIV_ON_VIEW% , %HTTP_EQUIV_ON_EDIT% e %HTTP_EQUIV_ON_PREVIEW% que definem as meta tags <meta http-equiv="..."> para os moldes TWiki. Isso pode ser usado por exemplo para definir o tempo de expiração de um documento.
• 29 Jul 2000 - PeterThoeny
  • Novas variáveis %GMTIME{"..."}% e %SERVERTIME{"..."}% . Mais em TWikiVariables.
• 23 Jul 2000 - PeterThoeny
  • Mudou a sintaxe do include de %INCLUDE{"Web/TopicName.txt"}% para %INCLUDE{"Web.TopicName"}% . Sintaxe Legacy ainda suportada.
• 23 Jul 2000 - PeterThoeny
  • Busca BookView permite que você mostre um conjunto de tópicos para uma fácil impressão.
• 22 Jul 2000 - PeterThoeny
  • More forgiving syntax for *bold*, italic, __bold italic__ e fixed , onde não é mais necessário haver um trailing space antes dos caracteres .,;:?!.
• 22 Jul 2000 - PeterThoeny
  • Dividiu a Web TWiki.Main em TWiki.Main (users, company data) e TWiki.TWiki (TWiki related documentation, registration)
• 07 Jul 2000 - PeterThoeny
  • Adicionou um checkbox "Release edit lock" em preview para permitir que outras pessoas editem o tópico imediatamente sem o bloqueio de uma hora.
• 07 Jul 2000 - PeterThoeny
  • Fixed problem of losing carriage returns ao editar tópicos com o navegador KDE KFM ou o navegador W3M.
• 21 Jun 2000 - PeterThoeny
  • Consertado problema em que a página é redirecionada a algum ambiente de servidor que não esteja funcionando (URL necessita um nome de host).
• 21 Jun 2000 - CrisBailiff^?, PeterThoeny
  • Fixed security issue to prevent a server side %INCLUDE% of arbitrary files.
• 29 Mai 2000 - PeterThoeny
  • Nova variável %GMTIME% que mostra o horário atual GM.
• 28 Mai 2000 - PeterThoeny
  • Lock warning mostra o tempo restante de bloqueamento em minutos.
• 15 Mai 2000 - PeterFokkinga^?
  • Cada tópico pode ter o seu próprio arquivo molde. TWikiTemplatesVer1^? tem mais.
• 02 Mai 2000 - KevinKinnell^?, PeterThoeny
  • Características de busca avançada como busca por múltiplas Webs; pesquisa por nome de tópico / hora da modificação / autor; limita o número de resultados retornados. Mais em TWikiVariables.

01-Mai-2000 Release

• 21 Abr 2000 - PeterThoeny
  • Novas TWikiVariables %HTTP_HOST% , %REMOTE_ADDR% , %REMOTE_PORT% e %REMOTE_USER% .
• 21 Abr 2000 - JohnAltstadt^?, PeterThoeny
  • TWikiRegistration é feita separadamente para uso de Intranet (depende de usuário remoto) ou uso de Internet (depende do arquivo .htpasswd).
• 20 Mar 2000 - PeterThoeny
  • Uploading a file (topic file attachment) will optionally create a link to the uploaded file at the end of the topic. The preference variable %ATTACHLINKBOX% controls the default state of the link check box in the attach file page.
• 11 Mar 2000 - PeterThoeny
  • Melhor segurança com taint checking ( Perl -T option )
• 25 Fev 2000 - PeterThoeny
  • Novas variáveis de preferência %EDITBOXWIDTH% e %EDITBOXHEIGHT% para especificar o tamanho da caixa de edição.
• 25 Fev 2000 - PeterThoeny
  • Edição de tópicos de preferências para definir variáveis TWiki. Existem três níveis de preferências nível de sítio (TWikiPreferences), nível de Web (WebPreferences em cada Web) e preferências a nível de usuário (para cada um dos TWikiUsers). With this, discontinue use of server side include of wikiwebs.inc , wikiwebtable.inc , weblist.inc , webcopyright.inc and webcolors.inc files.
• 11 Fev 2000 - PeterThoeny
  • Nova variável %SCRIPTSUFFIX% / $scriptSuffix contendo uma extensão de arquivo opcional do script TWiki Perl. Moldes foram modificados para usar essa variável. Isso permite que você renomeie arquivos de script Perl para que tenham uma extensão como por exemplo ".cgi".
• 11 Fev 2000 - PeterThoeny
  • Nova variável %SCRIPTURLPATH% / $scriptUrlPath contendo o script URL sem o nome de domínio. Moldes foram modificados para usar essa variável em vez de %SCRIPTURL% . Isso foi feito por motivos de performance.
• 07 Fev 2000 - PeterThoeny
  • Changed the syntax for server side include variable from %INCLUDE:"filename.ext"% to %INCLUDE{"filename.ext"}% . (Previous syntax still supported. Change was done because of inline search syntax)
• 07 Fev 2000 - PeterThoeny
  • Pesquisa Inline. Nova variável %SEARCH{"str" ...}% para mostrar um resultado de pesquisa embutido em um texto de tópico. TWikiVariables has more on the syntax. Inline search combined with the category table feature can be used for example to create a simple bug tracking system.
• 04 Fev 2000 - PeterThoeny
  • Estatísticas de acesso. Cada Web tem um tópico WebStatistics que mostra mensalmente estatísticas com número de visualização e modificação de tópicos, tópicos mais populares e maiores contribuidores. (Isso precisa ser habilitado, TWikiDocumentation tem mais.)
• 29 Jan 2000 - PeterThoeny
  • Consertado erro em que TWiki não iria inicializar corretamente em certas circunstâncias, i.e. quando executado em mod_perl. Sub initialize in wiki.pm did not handle $thePathInfo correctly.
• 24 Jan 2000 - PeterThoeny
  • Consertado erro em que um endereço eletrônico começando com um WikiName era tido como um link interno Wiki em vez de um endereço eletrônico, i.e. SomeWikiName@somewhere.test .
• 10 Jan 2000 - PeterThoeny
  • No more escaping for '%' percent characters. (Número de '%' consecutivos escritos e mostrados é idêntico.)
• 03 Out 1999 - PeterThoeny
  • Limita o número de revisões mostrados no fim do tópico. Exemplo
    Topic TWikiHistory . { ..... Diffs r1.10 > r1.9 > r1.8 > r1.7 >... }
    Revisões adicionais podem ser selecionadas entrando no link >... .

01-Set-1999 Release

• 31 Ago 1999 - PeterThoeny
  • Consertado o erro Y2K. (Data no ano 2000 tinha uma formatação errada.)
• 08 Ago 1999 - PeterThoeny
  • New text formatting rule for creating tables. Text gets rendered as a table if enclosed in " " vertical bars. Example line as it is written and how it shows up
• 03 Ago 1999 - PeterThoeny
  • Registro online de novo usuário usando formulário Web em TWikiRegistration. Autenticação de usuários.
• 22 Jul 1999 - PeterThoeny
  • Flags $doLogTopic* in wikicfg.pm to selectively log topic view, edit, save, rdiff, attach, search and changes to monthly log file.
• 21 Jul 1999 - PeterThoeny
  • Flag $doRemovePortNumber in wikicfg.pm to optionally remove the port number from the TWiki URL. Example www.some.domain:1234/twiki gets www.some.domain/twiki .
• 15 Jul 1999 - PeterThoeny
  • Search path for include files in %INCLUDE:"file.inc"% variable. Search first in the current web, then in parent data directory. Useful to overload default include text in the data directory by web-specific text, like for example webcopyright.inc text.
• 07 Jul 1999 - ChristopheVermeulen^?
  • Link a plural topic to a singular topic in case the plural topic does not exist. Example TestVersion / TestVersions , TestPolicy / TestPolicies , TestAddress / TestAddresses , TestBox / TestBoxes .

01-Jul-1999 Release

• 23 Jun 1999 - PeterThoeny
  • New TextFormattingRules to write bold italic text by enclosing words with double underline characters.
• 23 Jun 1999 - PeterThoeny
  • Separate wiki.pm into configuration (wikicfg.pm) and TWiki core (wiki.pm) . This is to ease the upgrade of TWiki installations, it also allows customized extensions to TWiki without affecting the TWiki core.
• 21 Mai 1999 - DavidWarman^?
  • Externalize copyright text at the bottom of every page into a web-specific webcopyright.inc file. This is to easily customize the copyright text.
• 20 Mai 1999 - PeterThoeny
  • Added meta tag so that robots index only /view/ of topics, not /edit/, /attach/ e.t.c. Tag <META NAME="ROBOTS" CONTENT="NOINDEX">
• 20 Mai 1999 - PeterThoeny
  • Novas variáveis %WIKIHOMEURL% (link when pressing the icon on the upper left corner) e %WIKITOOLNAME% (o nome da ferramenta wiki TWiki ).
• 15 Abr 1999 - PeterThoeny
  • Topic locking adverte o usuário caso um tópico tenha sido editado por alguma outra pessoa dentro de uma hora. Isso serve para prevenir a concorrência, e.g. atualizações simultâneas de um mesmo tópico.
• 26 Mar 1999 - PeterThoeny
  • File attachments faz o Upload e download de qualquer arquivo como um anexo de tópico usando o navegador. FileAttachment tem mais.
• 26 Mar 1999 - PeterThoeny
  • Novas variáveis %PUBURL% (diretório URL público) e %ATTACHURL% (URL of topic file attachment).
• 09 Fev 1999 - PeterThoeny
  • Nova regra de formatação de texto para criar fixed font text . Palavras são mostradas em fixed font ao serem colocadas entre sinais de igual "=". Exemplo: Ao escrever =fixed font= irá aparecer como fixed font .
• 09 Fev 1999 - PeterThoeny
  • Nenhuma nova revisão de tópico é criada se a mesma pessoa salvar um tópico novamente dentro de uma hora.
• 03 Fev 1999 - PeterThoeny
  • Possível visualizar histórico de revisão completo de um tópico em uma página. Access at the linked date in the Changes page, or the Diffs link at the bottom of each topic, e.g.
    Topic TWikiHistory . { Edit Ref-By Diffs r1.3 > r1.2 > r1.1 }
Revision r1.3 1998/11/10 01:34 by PeterThoeny
• 04 Jan 1999 - PeterThoeny
  • Consertou erro ao visualizar diferenças entre revisões de tópicos que inluem tags de tabela HTML como <table>, <tr>, <td>.

1998 Releases

• 08 Dez 1998 - PeterThoeny
  • Assinatura é mostrada abaixo da área do texto quando se está editando um tópico. Use isto para facilmente copiar e colar sua assinatura ao texto.
• 07 Dez 1998 - PeterThoeny
  • Possível adicionar uma tabela de categoria a um tópico TWiki. Isso permite a armazenagem e busca por informações mais estruturadas. Ao editar um tópico mostra um formulário HTML com um text area genérico e uma tabela com selectors, checkboxes, radio buttons e campos de texto. TWikiDocumentation tem mais em setup. A Web TWiki.Know usa esta tabela de categoria para definir classificação, plataforma e versão do SO.
• 18 Nov 1998 - PeterThoeny
  • Internal log of topic save actions to the file data/logYYYYMM.txt, where YYYYMM the year and month in numeric format is. Destinado somente para supervisão, não acessível a partir da Web.
• 10 Nov 1998 - PeterThoeny
  • The email notification and the Changes topic have now a topic date that is linked. Clicando sobre o link irá mostrar a diferença entre as duas revisões de tópico mais recentes.
• 10 Nov 1998 - PeterThoeny
  • Visualizar diferenças entre as revisões dos tópicos. Cada tópico tem uma lista de revisões (e.g. r1.3) e differences thereof (e.g. >) at the bottom
    Topic TWikiHistory . { Edit Ref-By r1.3 > r1.2 > r1.1 }
Revision r1.3 1998/11/10 01:34 by PeterThoeny
• 26 Out 1998 - PeterThoeny
  • Adicionou uma previsualização das mudanças nos tópicos antes de salvá-los. Isso era necessário para se evitar revisões desnecessárias.
• 26 Out 1998 - PeterThoeny
  • Adicionou controle de revisão usando RCS. Cada tópico tem uma lista de revisões no rodapé e uma revisão info, e.g.
    Topic TWikiHistory . { Edit Ref-By r1.3 r1.2 r1.1 }
Revision r1.3 1998/10/26 01:34:00 by PeterThoeny
• 14 Out 1998 - PeterThoeny
  • Refered-By Descubra quais tópicos formam links para o tópico atual. Cada tópico tem um link Ref-By para isso. Nota: Somente referências da Web atual são mostradas, não referências de outras webs.
• 13 Out 1998 - PeterThoeny
  • Índice de tópico em ordem alfabética em WebSearch.
• 24 Set 1998 - PeterThoeny
  • Corrigiu moldes para notificação automática de email de modo que o MS Outlook possa mostrar anexos como um arquivo HTML.
• 13 Ago 1998 - PeterThoeny
  • WikiNotation permite também números após a seqüência AaA, e.g AaA1 é um nome válido de um tópico, mas Aa1 não é.
• 07 Ago 1998 - PeterThoeny
  • Notificação automática por e-mail quando algo for modificado em uma Web TWiki. Cada Web tem um tópico WebNotify onde pessoas possam se inscrever e cancelar assinatura.
• 06 Ago 1998 - PeterThoeny
  • Added server side include of files. Sintaxe é %INCLUDE:"filename.ext"%
• 05 Ago 1998 - PeterThoeny
  • Assinatura e data são inseridos automaticamente quando um novo tópico é criado.
• 04 Ago 1998 - PeterThoeny
  • Separa modelos para texto de tópico não existente e texto padrão para novo tópico.(arquivo modelo templates/Web/notedited.tmpl)
• 04 Ago 1998 - PeterThoeny
  • Avisa ao usuário se o nome do novo tópico não é um nome Wiki válido. (arquivo molde templates/Web/notwiki.tmpl)
• 31 Jul 1998 - PeterThoeny
  • Suporte a um texto citado com um '>' no início de uma linha.
• 28 Jul 1998 - PeterThoeny
  • Adicionou variáveis TWiki, colocadas entre os % símbolos %TOPIC% (nome de tópico), %WEB% (web name), %SCRIPTURL% (script URL), %DATE% (data atual), %WIKIWEBMASTER% (endereço do Wiki webmaster), %WIKIVERSION% (versão Wiki), %USERNAME% (nome de usuário), %WIKIUSERNAME% (nome de usuário Wiki).
• 28 Jul 1998 - PeterThoeny
  • Tópico WebChanges mostra o nome de usuário Wiki em vez de seu nome de usuário Intranet, e.g PeterThoeny em vez de thoeny caso o nome de usuário Wiki exista. Implementation Automatic lookup of Wiki username in topic TWikiUsers.
• 28 Jul 1998 - PeterThoeny
  • Topic index. (Tecnicamente falando, uma busca simples '.*' em nomes de tópicos.)
• 28 Jul 1998 - PeterThoeny
  • Tópico WebSearch permite uma busca completa de textos e tópicos com/sem expressões regulares.
• 27 Jul 1998 - PeterThoeny
  • Adicionou links automáticos para tópicos em outras Webs TWiki ao especificar<web name>.<topic name>, e.g. Know.WebSeach .
• 23 Jul 1998 - PeterThoeny
  • Versão inicial instalada, baseada no JOS Wiki. Veja WikiWikiClones para mais detalhes.

Dev Flow

O fluxo típico no desenvolvimento do TWiki ....

• TWiki:Codev/FeatureBrainstorming: fórum aberto para novas idéias
• TWiki:Codev/TWikiEnhancementRequests: pedido detalhado e específico
• TWiki:Codev/TWikiPlannedFeatures: aceito para desenvolvimento futuro
• TWiki:Codev/FeatureToDo: prioritized to up-next dev status
• TWiki:Codev/FeatureUnderConstruction: atualmente em desenvolvimento
• TWiki:Codev/FeatureDone: completo e implementado
• TWiki:Codev/DocRequest: pedido para documentação
• TWiki:Codev/DocsToDo: documentação característica pendente
• TWiki:Codev/FeatureDocumented: característica documentada
• TWikiDocumentation: manual de referência para o mais recente TWiki