Índice

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

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

Outros Wikis

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

Funcionalidades

• Edição ou criação de páginas Web usando apenas o browser;
• Edição fácil usando o botão "Edit";
• Auto-linkagem de WikiWords e URLs;
• Simples formatação de textos;
• Ferramenta de busca para as Webs (áreas temáticas independentes dentro do Foswiki);
• Lista de alterações;
• Notificação de alterações por e-mail;
• Uso de formulário para estruturação de conteúdos;
• Anexação de arquivos;
• Versionamento;
• Novas funcionalidades com o uso de extensões (plugins);
• Variáveis predefinidas;
• Variáveis definidas pelo usuário;
• Controle de acesso;
• Gerenciamento de usuários;
• Gerenciamento de páginas, anexos e webs;
• Criação de aplicações sem necessariamente ter acesso ao servidor;
• Estatísticas;
• Resolução de conflitos, etc.

Casos de Uso

• Site do escritório brasileiro da W3C (http://www.w3c.br);
• Universidade Federal a Bahia (http://wiki.dcc.ufba.br);
• Projeto Software Livre Brasil (http://wiki.softwarelivre.org)

A Plataforma, WikiWords, Tópicos e Webs

• "Tech.WebHome" resulta em Tech
• "Colivre.QuemSomos" resulta em QuemSomos

Registro, Usuários e Grupos

• No tópico UserRegistration, na web System, são criadas as contas de usuário.
• No tópico WikiUsers, na web Main, existe a lista de todos os usuários do Foswiki. No seu tópico pessoal (que de preferência deve ser formado pela junção do primeiro e do último nome) o usuário pode construir seu perfil, portifólio, ou seja, usá-lo como página pessoal.
• No tópico WikiGroups, na web Main, são listados todos os grupos que podem ser usados para definir o controle de acesso (AccessControl) no Foswiki como um todo ou de forma diferenciada para cada web. O nome do tópico do grupo deve ser uma WikiWord e deve ser terminada em "Group". Exemplo: AdminGroup é o grupo que possui poder administrativos sobre uma instalação do software.

• Existem características que levam a postagem de conteúdo apropriado, como identificação da conta que promoveu a alteração, alerta para novas alterações de modo que os demais colaboradores possam acompanhar o desenvolvimento do conteúdo, etc.
• Os conteúdos não são perdidos pois os tópicos estão sob controle de versão.
• Qualquer revisão do tópico pode ser refeita por um membro do AdminGroup se necessário.
• Por mais estranho que pareça, existem muito mais pessoas dispostas a ajudar do que a atrapalhar. Esta tese foi confirmada pelo primeiro Wiki de Ward Cunningham e pela Wikipedia, ambos os projetos sempre foram abertos para a edição de qualquer visitante.

Formatação de textos

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

Listas

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

Tabelas

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

Hipertextualidade: tópicos, web e links externos

!TutorialFoswiki
<nop/>TutorialFoswiki

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

Anexos ou FileAttachment

• O tópico deve existir previamente à anexação do arquivo;
• Arquivos que possam acarretar risco ao sistema serão renomeados. Exemplo: *.php será renomeado para *.php.txt;
• O Foswiki pode limitar o tamanho do arquivo para upload. Isso é configurado na variável 50000 na WebPreferences. O valor padrão é 10Mb. Isso porque arquivos grandes podem deixar o upload muito lento e ocorrer um time out. Aconselha-se usar um FTP para grandes arquivos.
• Não existe controle de acesso sobre anexos individualmente. Para fazer esse tipo de controle, aconselha-se criar um tópico para cada arquivo e usar restrições de acesso a nível de tópico.

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

Links para arquivos

Operações sobre os tópicos

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

Ferramentas Nativas

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

Plugins

CommentPlugin

Posicionamento

Templates

Exemplo de caixa de comentário

Image Gallery Plugin

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

Sintaxe

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

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

Exemplo

Edit Table Plugin

Sintaxe

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

Exemplo

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

Outros

Macros

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

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

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

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

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

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

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

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

• SCRIPTURL -- URL base onde se encontram os scripts do Foswiki
  • Sintaxe: %SCRIPTURL%
  • Poderia Expandir para: http://meusite.net/wiki/cgi-bin/
  • Expande para: http://wiki.colivre.net/bin
  • Exemplo: Para uma versão autenticada do tópico corrente use %SCRIPTURL{viewauth}%/%WEB%/%TOPIC% que expande para http://wiki.colivre.net/bin/viewauth/Tech/FoswikiMacros
• SEARCH{"text"} -- busca de conteúdo
  • mostra os resultados de uma busca dentro do tópico
  • Sintaxe: %SEARCH{"text" ...}%
  • Parâmetros suportados : [1]

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

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

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

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

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

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

• Exemplo: %TOC{depth="2"}%
• Exemplo: %TOC{"FoswikiMacros" web="Tech" title="Contents:"}%
• Relacionados: TOC

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

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

• Exemplo: %TOPICLIST{"   * $web.$name"}% cria lista de itens de todos os tópicos
• Exemplo: %TOPICLIST{separator=", "}% cria lista com todos os tópicos separados por vírgula
• Exemplo: %TOPICLIST{" <option>$name</option>"}% cria uma lista de opções (para menus tipo drop down)
• Relacionados: SEARCH, WEBLIST

• SYSTEMWEB -- nome da web de documentação do Foswiki
  • web que contém toda a documentação e configurações para todo o site Foswiki
  • Sintaxe: %SYSTEMWEB%
  • Expande para: System
  • Relacionados: MAINWEB

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

Controle de Acesso

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

DataForms

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

Exemplo

Wiki Estruturado

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

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

O que são WikiApplications

Novas Webs

Adicionando Layout

1. Criar tópico LayoutTemplate com o HTML e CSS - aconselha-se incluir um tópico com o CSS no template com o HTML;
2. Acrescentar a variável %TEXT% no tópico do template, onde o conteúdo deverá ser mostrado
3. Na WebPreferences, listar o template acima na variável VIEW_TEMPLATE. No caso ficaria

      * Set VIEW_TEMPLATE = Layout 

4. Para as imagens do layout usar a variável %ATTACHURL%/Nomedaweb/Nomedotopico/Nomedaimagem
   • Pode-se usar também: %PUBURL%/Nomedaweb/Nomedotopico/Nomedaimagem
5. Acrescente os botões de edição, anexação, etc. Veja: Main.TWikiPreferences
6. Faça as devidas customizações do layout

Dicas

• Para saber um pouco mais de XHTML
• Para saber um pouco mais de CSS
• Para layouts livres acesse:
  • http://www.oswd.org ou
  • http://www.csszengarden.com
• Licenciamento de produções artísticas e intelectuais:
  • http://www.gnu.org/licenses/licenses.html
  • http://creativecommons.org.br/

Boas Práticas

• Use preferencialmente ShortHand, que é uma forma simples de formatação de textos no Foswiki, visto que nem todos conhecem HTML e afins;
• Usar WikiWords para que sejam automaticamente hiperlinkadas. Sugere-se usar palavras que dêem significado à WikiWord;
• Em caso de discussão:
  • separe as falas com espaços em branco;
  • adicione seu WikiName com data no final de seus comentários. Ex: -- Main.RicharStallman - 27 Sep 1983
    • se preferir use um link com label. Ex: -- [[Main.RicharStallman][RMS]] - 27 Sep 1983
• Um bom formato para tópicos é o conteúdo seguido por discussão;
• Caso a discussão morra e o tópico se torne uma página estática, sinta-se livre para refatorar sem piedade;
  • Edite destemidamente para capturar os pontos-chave;
  • Reduza o ruído sem perder os fatos;
  • Se você mesclar ou excluir comentários, dê crédito aos contribuintes no fim da página;
    Esta é a forma como o conteúdo Wiki amadurece e cresce em valor ao longo do tempo.
• Use um formato de data internacional como 01 Sep 2003 or 2003/09/01
• Quando quiser verificar o conteúdo de um tópico sem necessariamente editá-lo use o modo de "texto cru" (Raw Text).

Para conhecer mais