Version 2 (modified by jonesmadruga, 15 anos atrás) (diff)

--

Wiki Processors

Processadores Wiki

Processors are WikiMacros designed to provide alternative markup formats for the Trac Wiki engine. Processors can be thought of as macro functions to process user-edited text. Processadores são WikiMacros desenvolvidos para prover uma alternativa de formatação de alto nível para o sistema da wiki Trac. Processadores podem ser vistos como funções macros para processar a edição de texto dos usuários

The wiki engine uses processors to allow using Restructured Text and raw HTML in any wiki text throughout Trac. O sistema da wiki usa processadores para permitir o uso de Texto Restruturado (RST) e HTML puro em qualquer texto wiki do Trac.

Using Processors

Usando Processadores

To use a processor on a block of text, use a wiki blockquote, selecting a processor by name using 'hashbang notation' (#!), familiar to most UNIX users from scripts. Para usar um processador em um bloco de texto, use um 'blockquote', selecionando um processador pelo nome usando uma 'notação hashbang' (#!), familiar para muitos usuários de scripts UNIX.

Example 1 (inserting raw HTML in a wiki text):

{{{
#!html
<h1 style="color: orange">This is raw HTML</h1>
}}}

Exemplo 1 (inserindo HTML puro em um texto da wiki):

{{{
#!html
<h1 style="color: orange">Isto é HTML puro</h1>
}}}

Results in:

This is raw HTML

Resulta em:

Isto é HTML puro


Example 2 (inserting Restructured Text in wiki text):

{{{
#!rst
A header
--------
This is some **text** with a footnote [*]_.

.. [*] This is the footnote.
}}}

Exemplo 2 (Inserindo Texto Restruturado(RST) em textos wiki):

{{{
#!rst
Cabeçalho
--------
Isot é um **texto** com um rodapé [*]_.

.. [*] Isto é um rodapé.
}}}

Results in:

A header
--------
This is some **text** with a footnote [*]_.

.. [*] This is the footnote.

Resulta em:

Cabeçalho
--------
Este é um **texto** com rodapé [*]_.

.. [*] Isto é um rodapé.

Example 3 (inserting a block of C source code in wiki text): Exemplo 3 (Inserindo código em C em um bloco de texto da wiki):

{{{
#!c
int main(int argc, char *argv[])
{
  printf("Olá Mundo\n");
  return 0;
}
}}}

Resulta em:

int main(int argc, char *argv[])
{
  printf("Olá Mundo\n");
  return 0;
}

Available Processors

Processadores disponíveis

The following processors are included in the Trac distribution: Os seguintes processadores estão incluidos na distribuição do Trac:

Source Code Support

Suporte a Código-Fonte

Trac includes processors to provide inline syntax highlighting for these languages: O Trac inclui processadores pra prover suporte embutido de destaque para essas linguagens:

  • c -- C
  • cpp -- C++
  • python -- Python
  • perl -- Perl
  • ruby -- Ruby
  • php -- PHP
  • asp --- ASP
  • sql -- SQL
  • xml -- XML

Note: Trac relies on external software packages for syntax coloring. See TracSyntaxColoring for more info. Nota: Trac conta com pacotes de softwares externos para prover a sintacxe colorida. Veja TracSyntaxColoring para maiores informações.

By using the mime-type as processor, it is posible to syntax-highlight the same languages that are supported when browsing source code. (The list of mime-types can be found in Mimeview.py). Usando o mime-type como um processador, é possível destacar a sintaxe ddas mesmas linguagens que são suportadas quando se navega pelo código-fonte.( A lista de mime-types pode ser encontrada em Mimeview.py).

For example, you can write: Por exemplo, você pode escrever:

{{{
#!text/html
<h1>text</h1>
}}}

The result will be syntax highlighted html code. The same is valid for all other mime types supported. O resultado será uma sintaxe de código HTML em destaque.O mesmo é válido para todos os outros mime-types suportados.

For more processor macros developed and/or contributed by users, visit the macro bazaar: Para mais processadores macros desenvolvidos e/ou contribuidos por usuários, visite o macro bazaar:

http://projects.edgewall.com/trac/wiki/MacroBazaar


Advanced Topics: Developing Processor Macros

Tópicos avançados: Desenvolvendo Processadores Macros

Developing processors is no different than WikiMacros. In fact they work the same way, only the usage syntax differs. See WikiMacros for more information. Desenvolver processadores não é diferente do que WikiMacros. Na verdade, eles trabalham da mesma maneira, somente a sintaxe é diferente. Veja WikiMacros para maiores informações

Example: (Restructured Text Processor): Exemplo: (Processador de Texto Restruturado(RST)):

from docutils.core import publish_string

def execute(hdf, text, env):
    html = publish_string(text, writer_name = 'html')
    return html[html.find('<body>')+6:html.find('</body>')].strip()

See also : WikiMacros, WikiHtml, WikiRestructuredText, TracSyntaxColoring, WikiFormatting, TracGuide Veja também : WikiMacros, WikiHtml, WikiRestructuredText, TracSyntaxColoring, WikiFormatting, TracGuide

 

The contents and data of this website are published under license:
Creative Commons 4.0 Brasil - Atribuir Fonte - Compartilhar Igual.