De volta à página de entrada

Vê ainda estas traduções: Nederlands - Francais - English - Deutsch

Formatação de texto no TWiki

Trabalhar com o TWiki é tão fácil como escrever texto - exactamente como o email. Não necessitas de saber HTML, embora o possas usar se preferires. O links para os tópicos são criados automaticamente quando escrever WikiWords. Os atalhos do TWiki dão-te o poder do HTML com uma codificação simples que demora muito pouco a aprender. Está tudo explicado aqui abaixo. Podes recorrer a esta página sempre que necessitares de ajuda.

#Atalhos de formatação do TWiki

Atalhos de formatação do TWiki

1º parágrafo

2º parágrafo

---++ Sushi

---+++ Maguro

*Negrito*

_Itálico_

__Negrito e itálico__

=Tipo de letra fixo=

==Tipo de letra fixo e negrito==

_Isto funciona_,
_isto não _

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

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

-------

   * Listas com bolas

   * nível 1
      * nível 2

   1. Sushi
   1. Dim Sum

   A. Sushi
   A. Dim Sum

   i. Sushi
   i. Dim Sum

   $ Sushi: Japão
   $ Dim Sum: S.F.

| *L* | *C* | *R* |
| A2 |  2  |  2 |
| A3 |  3  |  3 |
| junção |||
| A4-6 | quatro | quatro |
|^| cinco | cinco |



|^| seis | seis |

WebNotify

Know.ReadmeFirst

[[wiki syntax]]


[[Main.TWiki users]]

literal:
![[wiki syntax]]

[[WikiSyntax][syntax]]

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

[[http://xml.org XML]]

[[WikiWord#NotThere]]

[[#MyAnchor][Jump]]

#MyAnchor To here

!SunOS

 <noautolink>
 RedHat &
 SuSE
 </noautolink>

[[mailto:a@z.com Mail]]

[[mailto:?subject=Hi Hi]]

Usar HTML

Podes usar quase todas as tags de HTML sem problemas - no entanto, há algumas considerações de ordem técnica de usabilidade a ter em conta.

HTML e a usabilidade do Twiki

• Em páginas colaborativas é peferivél NÃO usar HTML, usa antes os comando do Twiki. - isto torna o texto mais claro e mais fácil de editar.
• NOTE: O Twiki é desenhado para funcionar com uma grande variedade de browserse plataformas, não uses HTMl que seja especifico de um determinado browser irá reduzir a usabilidade e a compatibilidade.

Que tipo de HTML o TWiki Gera

• O Twiki converte os comandos de TWiki para XHTML 1.0. Para copiares o texto formatado vê o código fonte no teu browser e guarda o conteúdo.
  • Se necessitares de gravar o HTML com frequência informa-te acercado TWiki:Plugins/GenHTMLAddon - ele gerará um directório que com as as páginas e todos os ficheiros anexos.
• " NOTA: Os sinais de abertura e fecho das tags de HTML - <...> - devem estar na mesma linha ou haverá erro.
  • Esta funcionalidade permite que insiras um sinal de aior ou menor que este seja apresentado como se inserisses <, por exemplo: a < b
  • Se estiveres a fazer copy paste de páginas em HTML e tiveres problemas verifica se não tens quebras de linha indesejadas.

TWiki e JavaScript

Podes usar JavaScript nas tuas aplicações de Twiki. Uma vez que o Javascript pode interferir com a apresentação das páginas tens que o colocar entre comentários de HTML e <pre>:

<script language="JavaScript">
<!-- Hide JavaScript and <pre> escape TWiki rendering
... put your JavaScript code here...
// Stop hiding and stop </pre> escaping TWiki rendering -->
</script>

Hyperlinks

A capacidade de gerar links sem qualquer formatação é uma das funcionalidades do Twiki, tornada possível pelas WikiWords. Being able to create links without any formatting required is a core TWiki feature, made possible with WikiWords.

Linsk internos

• GoodStyle é uma WikiWord que faz um link para o tópico GoodStyle localizado em Indymedia Documentation Project.

• AindaNaoExiste^? é um tópico que ainda não existe. Podes criar o tópico clicando em ?. Se clicares neste depois cancela - depois de criar a página o ? desaparce e o exemplo deixa de fazer sentido.

Lins externos

• http://..., https://..., ftp://..., gopher://..., news://..., file://..., telnet://... and mailto:...@... criam um link automático.

• Endereços de email como name@domain.com criam link automático.

• [[As regras dos paretisis rectos]] permitem criar links sem WikiWords.
  • Também podes escrever [[http://pt.indymedia.org CMI de Portugal]] como forma de criar links externos com texto descritivo, como por exemplo CMI de Portugal.

Variáveis do TWiki

Variáveis do Twiki são palavras rodeadas de sinais de percentagem % que são interpretados peolo TWiki.

• %TOC% : Gera automaticamente um indíce baseado nos cabeçalhos de um tópico. Tens um exemplo no tópico da página.

• %WEB% : A web actual é TWiki.

• %TOPIC% : O tópico actual é TWikiShorthandPt.

• %ATTACHURL% : O URL de um anexo no tópico actual. Por exemplo: se anexares um anexo ao tópico podes referir-te a ele como %ATTACHURL%/imagem.png para mostrar o local do anexo.

• %INCLUDE{"OutroTopico"}% : Server side include, incluí outro tópico. A web actual é Indymedia Documentation Project. Por exemplo: %INCLUDE{"TWiki.SiteMap"}%

• %SEARCH{"sushi"}% : Pesquisa que mostra o resultado incluído num tópico. FormattedSearch dá-te controlo sobre as pesquisa, é usado para criar aplicações web.

• TWikiPreferences define as variásveis do site. Entre outras:
  • Quebra de linhas: Escreve %BR% para iniciar um bova linha.
  • Texto colorido: Escreve: %RED% Red %ENDCOLOR% and %BLUE% blue %ENDCOLOR% colors para obter: Vermelho e azul .
  • Gráficos dos documentos: Escreve: %H% Ajuda, %T% Dica, %X% Alerta para obter: Ajuda, Dica, Alerta. Para mais informações consulta TWikiDocGraphics.

• Há muitas mais variáveis, consulta TWikiVariables.

• Para evitar que uma variável seja interpretada coloca-lhe um ponto de exlamação antes. Escreve: !%SOMEVARIABLE% para obter: %SOMEVARIABLE%.

Extensão de formatação - TWikiPlugin

Os plugins trazem capacidades de formatação adicionais que podem ampliar as da Indymedia Documentation Project em várias áreas. Por exemplo, o opcional SpreadSheetPlugin permite-te criar folhas de cálculo com as mesma caracteristicas das tabelas do TWiki.

Os plugins disponíveis estão em Plugins. Os plugins activos desta instalação estão listados conforme %PLUGINDESCRIPTIONS%:

• DefaultPlugin: This plugin can be used to specify some simple custom rendering rules. It also renders depreciated *_text_* as bold italic text.
• SpreadSheetPlugin: Add spreadsheet calculation like "$SUM( $ABOVE() )" to tables located in Indymedia Documentation Project topics.
• CommentPlugin: Allows users to quickly post comments to a page without an edit/preview/save cycle.
• EditTablePlugin: Edit TWiki tables using edit fields, date pickers and drop down boxes
• InterwikiPlugin: Link ExternalSite:Page text to external sites based on aliases defined in the InterWikis topic
• SmiliesPlugin: Render smilies as icons, like  :-) for or  :cool: for
• TablePlugin: Control attributes of tables and sorting of table columns

Podes verificar os estado dos plugins deste site assim como as suas definições em TWikiPreferences.

Erros de edição comuns

A regras de formatação do Twiki são bastante simples de usar e rápidas de escrever. No entanto, há algumas coisas com as quais deves ter cuidado, retirado do TextFormattingFAQ:

• P: Texto entre angulos rectos <filename> não é mostrado. Como o posso mostrar tal como é?
  • R: Os caracteres '<' e '>' têm um significado especial em HTML, são eles que definem as tags. Necessitas de os "escapar", por isso escreve '<' em vez de '<', e '>' em vez de '>'.
    Por exemplo: Escreve 'prog <filename>' para obter 'prog <filename>'.

• P: Porque é que o caracter '&' não aparece por vezes?
  • R: O caracter '&' tem um significado especial no HTML, é com ele que se inciam as chamadas character entity, i.e. '©' é o sinal de copyright ©. Para obteres o caracter '&' deves escrever '&' em vez de '&'.
    Por exempo: Escreve 'Isto & aquilo' para obter 'Isto & aquilo'.

-- JoAzine - 04 Nov 2004
to top