wiki-piratas/tutorial/editar_a_wiki/index.mdwn

# Como editar esta wiki

Deveríamos ter imagens aqui ilustrando tudo, mas tem um problema com a wiki. Estamos [tentando resolver](https://github.com/piratas/gti/issues/30).

[[!toc startlevel=2 levels=5]]

---

## O que é isto?

Esta wiki utiliza [ikiwiki](https://ikiwiki.info), auto declarado "compilador de wiki" que usa [[linguagem markdown simples|/ikiwiki/formatting]], como por exemplo no Loomio, no Taiga ou no Trello, e na grande maioria dos sites hoje em dia, para edição de páginas.

Para saber mais sobre o que é uma wiki, acesse estes links: [1](https://en.wikipedia.org/wiki/Wiki) [2](https://www.mediawiki.org/wiki/Differences_between_Wikipedia,_Wikimedia,_MediaWiki,_and_wiki) [3](http://forage.ward.fed.wiki.org/view/an-install-of-wiki) [4](https://en.wikipedia.org/wiki/Wiki_software) [5](https://en.wikipedia.org/wiki/Ikiwiki)

## Não estou conseguindo editar páginas!

Tem que criar conta na wiki. É possível usar OpenID, então quem tem conta OpenID não precisa criar uma conta local.

A forma mais fácil é criar uma conta local.  
Para isto, é necessário clicar em "Preferences", ou então tentar editar alguma página, e a tela de login será apresentada.  

![](https://biblioteca.partidopirata.org/mgoblin_media/media_entries/277/tutorial-wiki-7.png)

Clique em **other** para criar uma conta local  - é esta parte que as pessoas esquecem  
Ao invés de clicar em "login", clique em "register".  

![](https://biblioteca.partidopirata.org/mgoblin_media/media_entries/278/tutorial-wiki-8.png)

Defina um nome de usuária(o) e uma senha. E-mail **não** é necessário.  
Após o registro, forneça o nome de usuária(o) e a senha e clique em "login".  

### Não quero fazer conta!

Engraçado que no feissebuqui tu fez, né?

Existe uma conta secreta exclusiva para as pessoas que lêem o tutorial, que é: usuário **pirata**, senha **pirata**. Quem não conseguiu encontrar esta informação nesta página não pode usar esta conta.

Contas anônimas e sem rastreamento são uma dádiva sagrada, se fizerem mau uso, a conta será apagada e a humanidade voltará às trevas da vigilância.

## Não estou conseguindo criar páginas!

<del>A wiki está com um problema que o [plugin 404](https://ikiwiki.info/plugin/404) não está funcionando, e consequentemente atualmente não é possível criar páginas de forma convencional (digitando o endereço no URL do navegador). Quem quiser ajduar a consertar isto se [integre no gti](https://github.com/piratas/gti/issues/29).</del>

Este problema foi resolvido, agora é possível criar páginas da forma tradicional, como na wikipedia. Quando uma página inexistente é acessada digitando o endereço na barra do navegador, um link aparecerá para criar a página.

Para criar páginas atualmente existem três formas:

#### Wikilink

Criar um [[ikiwiki/wikilink]]. Edite uma página qualquer e crie um [[ikiwiki/wikilink]] desta forma: `\[[wiki/pagina]]`. Não é necessário salvar a edição. Simplesmente clicando em "preview", o link novo deverá aparecer na tela de visualização com um ponto de interrogação. Clicando neste ponto de interrogação, a tela de criação de página será criada.

#### URL direta

A sintaxe do CGI é a seguinte: `https://wiki.partidopirata.org/ikiwiki.cgi?do=create&page=wiki/pagina`

O importante é o parâmetro `do` ter o argumento `create` e é necessário ter um parâmetro `page` com o caminho da página nova como argumento.

#### Digitando URL inexistente

Ao tentar acessar uma página inexistente, um erro 404 será gerado, e um link aparecerá com um sinal de interrogação `?` para criar a nova página.

## Não estou conseguindo enviar imagens e arquivos!

Eu também não.

Por enquanto o jeito de resolver isto é enviar pra outro site, por exemplo a [biblioteca pirata](https://biblioteca.partidopirata.org), e usar a sintaxe de imagem que é a seguinte:

`![](https://biblioteca.partidopirata.org/mgoblin_media/media_entries/282/wiki-tutorial-8.medium.png)`

Neste exemplo, o resultado seria este:

![](https://biblioteca.partidopirata.org/mgoblin_media/media_entries/282/wiki-tutorial-8.medium.png)

### Dica para imagens da biblioteca

O mediagoblin salva a imagem pelo menos em dois formatos, o original e o reduzido para visualização. Então no exemplo acima a imagem original seria:

`https://biblioteca.partidopirata.org/mgoblin_media/media_entries/282/wiki-tutorial-8.png`

E a reduzida:

`https://biblioteca.partidopirata.org/mgoblin_media/media_entries/282/wiki-tutorial-8`**`.medium`**`.png`

## Como é que eu escrevo?

Para aprender markdown, edite a página [[sandbox]], observe como é o texto em markdown e use o botão "Preview" para observar como ele fica depois de formatado. Veja alguns exemplos:

---

Uma linha horizontal como esta acima é feita com três hífens (`---`)

Para forçar uma quebra de linha, é necessário manter dois espaços em branco no **final** da linha  

    Para fazer um bloco de código como este, é necessário colocar quatro espaços em branco no **início** da linha.
    Sintaxe para escrever: **negrito**, *itálico*, `código`
    > Citações começam com um > no **início** da linha seguido de espaço.
    > Citações também podem ter *itálico* ou mesmo **negrito**.
    
    ---
    
    Uma linha horizontal é criada quando há somente --- em uma linha de texto.
    
    # Título
    
    ## Subtítulo
    
    ### Título nível 3
    
    #### Cabeçalho nível 4
    
    ##### Cabeçalho nível 5
    
    ###### Cabeçalho nível 6
    
    Para criar uma tabela de conteúdo, use a diretiva \[[!toc]]

> Citação

> *Citação em itálico*

> **Citação em negrito**

Texto pré  formatado deve ser colocado `entre duas crases` (`)

Veja também a página [[ikiwiki/formatting]] para formatação em markdown e [[ikiwiki/wikilink]] para aprender a criar links internos para outras páginas.

[[!meta title="Como editar esta wiki"]]