Warning: Can't find topic SelectTwikiWebs

Inclua Tópicos e Páginas Web Usando a Variável %INCLUDE{...}%

Use a variável %INCLUDE{...}% para encaixar o conteúdo de outro tópico ou web page dentro de um tópico TWiki. Todo o conteúdo ou somente partes de uma página podem ser incluídos. Se for necessário, defina um servidor proxy em TWikiPreferences.

Sintaxe

%INCLUDE{ "página" pattern="expressão-regular" rev="1.X" }%

• "página":
  O parâmetro sem nome especifica a página a incluir. Isso é
  • O nome de um tópico localizado na web atual, e.g., %INCLUDE{"WebNotify"}%
  • Um nome Web.Topic especificando um tópico em outra web, e.g., %INCLUDE{"TWiki.SiteMap"}%
  • Uma URL completa qualificada com protocolo http , nome de domínio e número de porta opcional, e.g., %INCLUDE{"http://twiki.org:80/index.html"}%. Supported content types are text/html and text/plain. A página completa é incluída como padrão, mas o cabeçalho e script HTML são retirados caso seja uma página web.

• pattern="expressão-regular":
  O parâmetro pattern é opcional e permite que você extraia algumas partes de uma página web. Especifique uma RegularExpression que leia do início ('^') ao fim e que contenha o texto que você queira manter entre parênteses, e.g., pattern="^.*?(daqui.*?até aqui).*". Você precisa se certificar que a integridade de uma página web não seja comprometida; por exemplo, se você incluir uma tabela, certifique-se de incluir tudo, inclusive a tag de fim de tabela.

• rev="1.X":
  O parâmetro rev é opcional e permite que você inclua uma revisão de tópico anterior. Isso pode ser utilizado para incluir uma versão oficial de um tópico, e.g., um que tenha sido assinado pela administração. Este parâmetro não se aplica a URLs.

Nota: Todo o texto de um tópico é incluído a nao ser que você especifique %STARTINCLUDE%, %STOPINCLUDE% e/ou um parâmetro pattern.

Exemplos de Uso

1. Mostra testes de regressão em uma página TWiki

  <pre>
  %INCLUDE{"http://domain/~qa/v1.1/REDTest.log.txt"}%
  </pre>

2. Mostra o arquivo robot.txt do Yahoo

• Você digita:
  • %INCLUDE{"http://www.yahoo.com/robots.txt"}%

3. Mostra o SUNW stock quote em uma página TWiki

• Você digita:
  • SUNW: %INCLUDE{"http://finance.yahoo.com/q?s=SUNW&d=v1&o=t" pattern="^.*?>SUNW</a>[^<]+(.*?)\s+\S+\s+<small.*"}%
• Você obtém:
  • SUNW:

Warning

This site does not allow %INCLUDE% of URLs

4. Mostra a temperatura em São Francisco

• Você digita:
  • San Francisco: %INCLUDE{"http://weather.yahoo.com/forecast/San_Francisco_CA_US_f.html" pattern="^.*?([0-9]+\&ordm\;F).*"}%
• Você obtém:
  • San Francisco:

Warning

This site does not allow %INCLUDE% of URLs

Veja outras Variáveis TWiki.

-- PeterThoeny^? - 15 Jan 2003