Warning: Can't find topic SelectTwikiWebs

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