Algumas dicas de como editar páginas no Estúdio Livre
Introdução
Seja bem vind@ ao ambiente colaborativo do Estúdio Livre. Para saber mais sobre o Estudio Livre, visite este
link. Para saber como colaborar e em quais projetos veja
aqui.
Esta página está em contante construção. Se você, ao editar uma página, perceber que falta algo aqui, sinta-se à vontade para adicicionar dicas e informações.
A melhor forma de aprender a editar um wiki é obsevar as páginas existentes para ver como ela funciona. Para isso basta clicar no ícone 'editar' (lápis) acima para ver como a página está organizada. Você pode fazer isso em qualquer página que ache interessante, assim você pode copiar alguma funcionalidade, ou aprender um pouco mais sobre edição no wiki. Para sair da página de edição sem salvar as alterações realizadas, é só clicar em "cancelar".
Utilizando os recursos da página de edição
Utilize os atalhos do wiki!
No topo da página de edição, existem alguns ícones que lhe ajudarão a editar a página wiki, assim como se faz na maioria dos editores de texto.
Estes ícones facilitam bastante a vida na hora de editar ua página. Mais dicas de como editar uma página wiki, podem ser encontradas clicando no ícone '?' (ver ajuda do wiki), no topo da página de edição do wiki.
Categorias
Ao clicar em 'Categorias' (ao final da página de edição), você vê uma lista das categorias que pode adicionar ou remover. Basta clicar nelas para fazer isso.
No momento, existem as categorias de gráfico, vídeo e áudio. Escolha uma ou mais de uma. Para
Comentários
Observe que há um campo de 'comentário' logo abaixo do texto de edição. É muito importante que você coloque observações acerca das alterações feitas. Isso é algo muito útil em se tratando de um wiki e do trabalho desenvolvido pela comunidade do Estúdio Livre, posto que várias pessoas editam as mesmas páginas.
Alterações
Cada vez que você salva uma página do wiki ela aparece em
últimas alterações do site. Se você está salvando seu trabalho a todo momento com pequenas alterações, o melhor a fazer é selecionar a alteração 'pequena' logo abaixo do texto 'Essa alteração foi:'. Desta forma seu texto não aparecerá em últimas alterações do site inúmeras vezes.
Pré-visualização
Antes de salvar uma alteração, é aconselhável que você faça uma pré-visualização de como ficou a página. Para isso existe o botão 'gerar pré visualização' acima do botão salvar na página de edição e também no topo da página.
Dessa maneira, você tem certeza de que a alteração ficou de seu gosto e que você pode salvá-la sem poluir o histórico das alterações.
Edição
Cabeçalhos
Para criar um cabeçalho para a página coloque
-=Título=-
no topo da página. É claro que você deve substituir 'título' pelo texto que acha apropriado para o cabeçalho.
Seções
Para criar uma seção, use
!Seção 1
O número de '!'s define se a seção é uma subseção. Ou seja:
!!Subseção da seção 1
!Seção 2
!!Subseção da seção 2
!!!Subseção da subseção 2
e assim por diante.
Links
O recurso mais importante de um wiki são os links. É por causa deles que o wiki é tão interessante: você sempre deve poder clicar em uma palavra chave para poder ver o artigo sobre ela.
Há duas formas de criar links no wiki
- Links para outras páginas wiki
- Links externos
1. Links para páginas wiki
Para isso basta escrever as palavras juntas:
paginaWiki
Isso irá transformar o texto "paginaWiki" para um link para a página "páginaWiki". Caso a página não exista, um link que permite a criação da mesma será criado.
Outra forma de colocar links para páginas wiki é através do uso de parêntesis:
((página wiki))
isso é especialmente útil se o nome da página wiki tiver espaços. Além disso, uma barra "|" serve para modificar o texto do link (no exemplo acima, as palavras "página wiki" seriam o texto do link):
((página wiki|clique aqui))
assim, a palavra "clique aqui" será o texto do link que leva para a página "página wiki".
IMPORTANTE: Não coloque o caminho completo que você vê na barra de navegação do seu browser para links para páginas wiki. Ou seja, isso:
((http://estudiolivre.org/tiki-index.php?page=exemplo))
não deve ser feito
nunca!!!
Mas por quê???
Isso não deve ser feito pois a única maneira de sabermos que uma determinada página possui um link para uma outra é através do uso de parntesis.
O sistema wiki funciona de uma forma que permite ao usuário ver quais páginas estão links em quaisquer outra página, mas isso só funciona se os links utilizarem parêntesis.
Por isso, ao colocar links entre páginas wiki sem usar os parêntesis você faz com que percamos uma das funcionalidades mais interessantes do wiki, dificultando a compreensão da estrutura de páginas do site.
2. Links externos
Para isso basta usar colchetes, por exemplo:
[http://www.google.com]
é importante lembrar de
sempre colocar o "http", senão o link não funciona!
Assim como com os parêntesis, os colchetes também permitem o uso do "|" para modificar o texto do link, ou seja:
[http://www.google.com|google]
IMPORTANTE: Se você colocou "http://estudiolivre.org" no seu link usando colchetes, você cometeu um
grave erro. Veja a nota "IMPORTANTE" da seção anterior.
Índice
Para criar um índice, use:
{maketoc}
Ele coloca o índice no topo da página e estrutura o texto de acordo com os cabeçalhos, tópicos e subtópicos (veja acima).
Imagens
Para carregar imagens em seu turorial é preciso que esta imagem esteja em algum local da internet. Caso a imagem que você deseja utilizar já estiver na rede, utilize a tag 'inserir imagem', no topo desta página (ícone com um quadro), e aparecerá este código em sua página:
{img src= width= height= align= desc= link= }
onde:
- img src= endereço da imagem sem espaço. Exemplo:
img src=http://estudiolivre.org/styles/estudiolivre/logo_EL.png'
- width= largura da imagem (obs: a imagem utilizada já deve estar no tamanho correto).
- height= altura da imagem (obs: a imagem utilizada já deve estar no tamanho correto).
- align= alinhamento da imagem em inglês (left=imagem à esquerda, center=imagem no centro, right=imagem à direita)
- desc= descrição da imagem que aparecerá quando o mouse passar em cima.
- link= link para onde a imagem apontará caso seja clicada.
Caso a imagem que você desaja utilizar não esteja na rede, você deve carregá-la na própria página, clicando em
Mais opções e inserir a imagem no campo
Carregar uma imagem clicando em
Browse. Após fazer isso, ao salvar a alteração, a imagem aparecerá automaticamente no final da página. Se necessário, clique em 'editar' novamente e altere as propriedades da imagem, como descrito acima.
Tutoriais
Caso esteja fazendo um tutorial para algum programa específico é bom verificar se ele tem pelo menos os seguintes itens:
- breve descrição do software e suas funcionalidades
- versão do software
- instalação e configuração
- descrição da interface
- tutoriais de uso
- links relacionados.
Ortografia e gramática
Para leig@s, o 'tecnicês' já é difícil de compreender. Se falar sobre código é fácil para você imagine que um "geologês" de um geógrafo/a não será tão simples assim. E se o assunto requer um aprofundamento específico - no caso do Estúdio Livre muitas vezes técnico - tente simplificar a vida de quem quer aprender, para isso um português inteligível é essencial. Também é importante o uso de um bom portugês ao invés do 'InTeRnEtÊs' utilizado usualmente pela internet.