Projeto

Geral

Perfil

Guia Usuario »

Links

Links no Redmine

Redmine permite fazer hyperlink entre tarefas, changeset páginas wiki e qualquer página em que a formatação wiki é usada.

  • Link para uma tarefa: #124 (mostra #124, o link é cortado ao meio se a tarefa estiver fechada).
  • Link para um changeset: r758 (mostra r758).
  • Link para um changeset com um hash não-numérico: commit:c6f4d0fd (mostra c6f4d0fd).

Links Wiki:

  • [[Guia_Usuario]] mostra um link para a página chamada 'Guia_Usuario': Guia_Usuario
  • [[Guia_Usuario|Manual do Usuário]] mostra um link para a mesma página mas com um texto diferente:[[Guia_Usuario||Manual do Usuário]]
  • [[Guia_Usuario#Guia-do-Usuário|Manual do Usuário]] mostra um link para o header dessa mesma página mas com um texto diferente: Manual do Usuário

Você também pode criar links para páginas wiki de outro projeto:

  • [[erp:GestorSetup]] mostra um link para a página chamada 'GestorSetup' do wiki do projeto ERP
  • [[erp:]] mostra um link para a página wiki principal do projeto 'ERP'

Links wiki são mostrados em vermelho se a página ainda não existe, ex: Página não existente.

Links para outros recursos:

  • Documentos:
    • document#17 (link para o documento com o id 17)
    • document:Redmine (link para o documento com o titulo "Redmine")
    • document:"Bem Vindo" (aspas duplas podem ser usadas quando o título do documento contém espaços)
    • document:algum_project:"Algum documento" (link para um documento em outro projeto)
  • Versões:
    • version#3 (link para a versão com id 3)
    • version:1.0.0 (link para a versão chamada "1.0.0")
    • version:"1.0 beta 2"
  • Anexos:
    • attachment:file.zip (link para o anexo do objeto atual com o nome file.zip)
    • attachment:"file.zip" (aspas duplas podem ser usadas quando o nome do arquivo possui caracteres que não são letras)
    • Por hora, é possível somente linkar anexos do objeto atual (se você estiver em uma tarefa, somente é possível referenciar anexos da tarefa atual)
  • Fórum:
    • forum#2 (link para o fórum com o id 2)
    • forum:Discussion (link para o fórum com o nome "Discussion")
    • forum:"Help and more" (aspas duplas podem ser usadas quando o nome do fórum possui espaços)
  • Mensagens do Fórum:
    • message#1218 (link para a mensagem do forum com o id 1218)
  • Notícias
    • news#1 (link para a notícia com id 1)
    • news:Greetings (link para a noticia com o nome "Greetings")
    • news:"eCookbook first release !" (aspas duplas podem ser usadas quando o nome da notícia possui espaços)
  • Projetos:
    • !project#<id> (link to project with <id>)
    • project:<identifier>
    • project:<name>
  • Anexos:
    • attachment:arquivo.zip (link para o anexo no objeto atual chamado arquivo.zip)
    • attachment:"file.zip" (aspas duplas podem ser usadas quando o nome do arquivo possui caratéres que não são letras)
    • Por agora, apenas anexos do objeto atual podem ser referenciados (se você estiver na página de uma tarefa, só poderá referenciar anexos dessa tarefa)
  • Arquivos do Repositório
    • source:some/file -- Link para o arquivo localizado em /some/file no repositório do projeto
    • source:some/file@52 -- Link para a revisão 52 do arquivo
    • source:some/file#L120 -- Link para a linha 20 do arquivo
    • source:some/file@52#L120 -- Link para a linha 120 da revisão 52 do arquivo
    • source:"some file@52#L120" -- Aspas duplas podem ser usadas se a URL contém espaços
    • export:some/file -- Força o download do arquivo
  • Escapando:
    • Você pode prevenir que os links do Redmine sejam executados por precedê-los com um ponto de exclamação: !

Links externos

URLs HTTP e endereços de email são automaticamente transformados em links clicáveis: URLs HTTP e endereços de email também podem ser diferentes do link em si:
  • "Redmine web site":http://www.redmine.org -- Link externo com um texto diferente: Redmine web site
  • "Email alguem":mailto:alguem@foo.bar -- Link email com um texto diferente: Email alguem
Instruções de email mais complexas podem ser adicionadas para um link de email. Um título padrão, um corpo padrão e informações CC podem ser definidos. Note que espaços em qualquer um destes campos precisa ser substituídos por %20.
  • "Email webmaster e admin":mailto:webmaster@foo.bar?cc=admin@foo.bar -- Email para webmaster, CC admin: Email webmaster e admin
  • "Email alguem para ajudar":mailto:alguem@foo.bar?subject=Website%20Ajuda -- Link email com o tema "Website Ajuda": Email alguem para ajudar
  • "Email alguem para ajudar":mailto:alguem@foo.bar?subject=Website%20Ajuda&body=Meu%20problema%20e%20 -- Link email com o tema "Website Ajuda" com o corpo padrão: Email alguem para ajudar

Formatação de Texto

Para coisas como títulos, negrito, tabelas, listas, o Redmine suporta a sintaxe Textile. Veja http://www.textism.com/tools/textile/ para mais informações em como usar qualquer um desses recursos. Alguns exemplos estão inclusos abaixo, mas a engine é capaz de muito mais que isso.

Acrônimos

 
JPL(Jean-Philippe Lang)

Exibe:

JPL

Estilo de Fonte


* *negrito* 
* _italico_ 
* *_negrito italico_* 
* +sublinhado+ 
* -cortado-ao-meio- 
* Simples ^superscript^ 
* Simples ~subscript~ 
* @inline monospace@

Exibe:

  • negrito
  • italico
  • negrito italico
  • sublinhado
  • cortado-ao-meio
  • Simples superscript
  • Simples subscript
  • inline monospace

Imagens Inline

  • !image_url! mostra a imagem localizada em image_url (textile syntax)
  • !>image_url! imagem flutuando à direita
  • !image_url(Tooltip)! mostra a imagem localizada em image_url com uma Tooltip descritiva
  • !image_url!:URL mostra a imagem localizada em image_url com um link para a URL adicionada

Se você possui uma imagem na sua página wiki, ela pode ser exibida inline usando o nome do arquivo: !imagem_anexo.png!

Cabeçalhos

h1. Cabeçalho
h2. Sub-cabeçalho 
h3. Sub-cabeçalho menor

Parágrafos

p. Alinhado à esquerda

p(. indentação à esquerda 1em 

p((. indentação à esquerda 2em 
Assim como as seguinte linhas

p>. Alinhado à direita

p)))>. indentação à direita 3em 

p=. Isso é um parágrafo centralizado

Linha Horizontal

---

Cria uma linha horizontal cortando a página:

Notas de rodapé:

texto[1]

fn1. Nota

Texto com um link para alguma referência no rodapé1

1 Nota de rodapé com a explicação

Pré-definido

Para escapar uma sintaxe wiki

 <pre> *Seu texto não será negrito* </pre>

Exibe:

 *Seu texto não será negrito*

Blockquotes

Comece o parágrafo com bq. ou > (ou duplamente: >>)

bq. Rails é um framework de desenvolvimento de aplicações web com banco de dados de acordo com o padrão Model-View-Control.
Para funcionar, tudo que você precisa é um banco de dados e um servidor web.

Exibe:

Rails é um framework de desenvolvimento de aplicações web com banco de dados de acordo com o padrão Model-View-Control.
Para funcionar, tudo que você precisa é um banco de dados e um servidor web.

Rails é um framework de desenvolvimento de aplicações web com banco de dados de acordo com o padrão Model-View-Control.
Para funcionar, tudo que você precisa é um banco de dados e um servidor web. (Começando com >>)

Lista sem ordem

 
* Item 1 
* Item 2 
** Item 21 
** Item 22 
* Item 3

exibe:

  • Item 1
  • Item 2
    • Item 21
    • Item 22
  • Item 3

Lista ordenada

 
# Item 1 
# Item 2 
# Item 3 
## Item 3.1 
## Item 3.2

Mostra:

  1. Item 1
  2. Item 2
  3. Item 3
    1. Item 3.1
    2. Item 3.2

Tabelas

 
|_.UserID|_.Nome|_.Grupo|_. lista de atributos | 
|\3=.IT |<. alinhado à esquerda| 
|1|Artur Pirozhkov |/2.Usuàrios |>. alinhado à direita| 
|2|Vasya Rogov |=. centro | 
|3|John Smith |Admin 
(root)|^. alinhado no topo | 
|4|- |Ninguem 
(anônimo)|~. alinhado no final|

Exibe (todos os espaços múltiplos foram substituídos por 1 espaço):

UserID Nome Grupo lista de atributos
IT alinhado à esquerda
1 Artur Pirozhkov Usuàrios alinhado à direita
2 Vasya Rogov centro
3 John Smith Admin
(root)		 alinhado no topo
4 - Ninguem
(anônimo)		 alinhado no final

Tabela de conteúdo (Table of Content)

{{toc}} => toc alinhado à esquerda
{{>toc}} => toc alinhado à direita

Macros

Redmine possui os seguintes macros internos:

hello_world
Sample macro.
macro_list
Displays a list of all available macros, including description if available.
child_pages
Displays a list of child pages. With no argument, it displays the child pages of the current wiki page. Examples:

{{child_pages}} -- can be used from a wiki page only
{{child_pages(depth=2)}} -- display 2 levels nesting only
{{child_pages(Foo)}} -- lists all children of page Foo
{{child_pages(Foo, parent=1)}} -- same as above with a link to page Foo
include
Includes a wiki page. Examples:

{{include(Foo)}}
{{include(projectname:Foo)}} -- to include a page of a specific project wiki
collapse
Inserts of collapsed block of text. Examples:

{{collapse
This is a block of text that is collapsed by default.
It can be expanded by clicking a link.
}}

{{collapse(View details...)
With custom link text.
}}
thumbnail
Displays a clickable thumbnail of an attached image. Examples:

{{thumbnail(image.png)}}
{{thumbnail(image.png, size=300, title=Thumbnail)}} -- with custom title and size

Code highlighting

Code highlighting depende de CodeRay, uma biblioteca de code highlighting de sintaxe rapida escrita completamente em Ruby. Ela suporta códigos C, C++, CSS, Delphi, Diff, Groovy, HTML, Java, Javascript, JSON, Nitro-XHTML, PHP, Python, RHTML, Ruby, Scheme, SQL, XML e YAML.

Você pode colorir códigos na suas páginas wiki usando essa sintaxe:

<pre><code class="ruby"> 
Ponha seu código aqui. 
</code></pre>

Exemplo:


# The Greeter class 
class Greeter 
def initialize(name) 
@name = name.capitalize 
end 

def salute 
puts "Hello #{@name}!" 
end 
end

Formatação Textile

Redmine suporta a formatação de texto Textile. Para detalhes consulte a Syntaxe Textile .

Por exemplo, é possível colorir a cor do texto para mostrar o texto em Vermelho:

%{color:red}Red Text%

Ou mudar a cor do fundo do texto, para mostrar um fundo Verde:

%{background:lightgreen}Green Background%

Os nomes e códigos de cores (RGB) podem ser encontrados em: http://www.w3schools.com/HTML/html_colornames.asp

E também é possível aumentar o tamanho do texto utilizando o comando:

%{font-size:18pt}tamanho do texto%

Adicionar imagem da área de transferência (Tamanho máximo: 5 MB)