Sumário Portal do Projeto Tempo de Ser O que é um Wiki?...2 Documentos...2 Localizando documentos...3 Links...3 Criando um Documento...4 Criando um link...4 Editando um Documento...5 Sintaxe Básica...5 Cabeçalhos...6 Tabela de Conteúdos (TOC)...6 Inserindo imagens e outros arquivos...8 Inserindo uma imagem: exemplo prático...8 Inserindo uma imagem que ainda não está no portal...10 Inserindo outros tipos de arquivo...10 Por Sérgio Evandro Motta sergio@tempodeser.org.br Diretoria de Tecnologia da Informação Comissão Gestora do Projeto Tempo de Ser Versão 2 10/06/2012 1
O que é um Wiki? O Portal do Projeto Tempo de Ser é uma ferramenta wiki. Os termos Wiki (pronunciado /uíqui/ ou /víqui/) e WikiWiki são utilizados para identificar um tipo específico de coleção de documentos em hipertexto ou o software colaborativo usado para criá-lo. O termo Wiki wiki significa extremamente-rápido no idioma havaiano. Um wiki permite que os documentos sejam editados coletivamente com uma linguagem de marcação muito simples e eficaz, através da utilização de um navegador web. O que faz o wiki tão diferente das outras páginas da Internet é certamente o fato de poder ser editado pelos usuários que por ele navegam. Por exemplo, uma parte de um artigo pode ter sido adicionada anos após a criação do próprio, e, com certeza, ter várias outras edições; ela será modificada por usuários ao longo do tempo. Desse jeito, é possível corrigir erros, complementar ideias e inserir novas informações. Assim, o conteúdo de um artigo se atualiza graças à coletividade. Além disso, o wiki cria versões dos documentos, registrando todas as alterações efetuadas, com hora, data e autor, permitindo inclusive reverter o documento para um estado anterior à uma alteração, ou seja, voltar à uma versão antiga. A ferramenta wiki adotada pelo portal do Projeto Tempo de Ser é o Dokuwiki, cujo site é: www.dokuwiki.org (em inglês). Documentos Os documentos ou páginas do portal são organizados em pastas. Podem haver pastas dentro de outras pastas, criando uma estrutura hierárquica organizada com vários níveis, onde se pode classificar os documentos e separá-los de acordo com os critérios desejados. Veja a figura: No exemplo acima, temos uma pasta intelmed, que contém as pastas bauru e coordenadores ; dentro da pasta bauru, existe a pasta conteúdos, a pasta sim e uma página chamada início. Para referenciar os documentos adequadamente, dentro desta estrutura, usamos os caminhos ou trilhas para os documentos. Por exemplo, para fazer uma referência à página inicio do exemplo acima, usaremos o seguinte caminho ou trilha : Importante: intelmed:bauru:inicio no caminho, as pastas são separadas por : (dois pontos); o último nome da direita sempre significa uma página, sendo que os anteriores serão sempre pastas. 2
Localizando documentos Para verificar qual a localização de uma página que você está visualizando, observe a linha de endereço da página, na parte superior da tela do seu navegador. Por exemplo: http://www.tempodeser.org.br/bauru:cursos:css:conteudo:2012-02-26:inicio A parte inicial, até a primeira barra ( / ) é o nome de domínio do site que está sendo visitado; a partir daí, começa o caminho da página, sendo que as pastas são separadas por dois pontos ( : ) e o último nome é o nome da página. Assim, no exemplo acima você estaria visualizando a página início, localizada dentro da pasta 2012-02-26, que está dentro da pasta conteudo e assim por diante. Você também poderá conferir a estrutura hierárquica do documento atual observando o item Você está aqui, localizado na parte superior da página, logo abaixo dos cabeçalhos principais, por exemplo: Você está aqui: início» bauru» cursos» css» conteudo» 2012-02-26 Dica: você pode clicar em qualquer pasta da trilha Você está aqui, e será levado para a página inicial daquela pasta. Isto facilita e agiliza a navegação pelo portal. Links Um link é uma ligação ou vínculo dentro de um documento que referencia outro documento. É um elemento em que podemos clicar e acessar outras páginas, constituindo o que se convencionou chamar de navegação. No portal, um link pode ser de dois tipos: 1. Quando um link apontar para um documento que não existe, ele aparecerá em vermelho; 2. Quando apontar para um documento que já existe, o link aparecerá em azul. Neste caso, se você parar o cursor do mouse sobre ele será mostrado o nome completo do documento que o link está referenciando. Veja exemplo abaixo: Os links Bauru e Londrina apontam para documentos que possuem conteúdo; já os links Birigui, Duartina e Presidente Prudente apontam para páginas que ainda não foram criadas. Observe, parando o cursor do mouse sobre o link Bauru, que ele aponta para o caminho intelmed:bauru:inicio, ou seja, a página inicio dentro da pasta bauru que por sua vez está 3
dentro da pasta intelmed. Atenção: Se clicar em um link que aponta para uma página inexistente, você receberá a mensagem Esse tópico ainda não existe, e caso tenha permissão para criá-la, será mostrado também o link Criar esta página, logo acima. Clique sobre ele para criar a página: Criando um Documento Para criar um novo documento, você deverá primeiramente criar um link apontando para ele, em um documento já existente. Você deverá alterar esse documento existente, adicionando o link para o novo documento. Salve sua alteração e verá que o link aparecerá em vermelho, pois obviamente estará sem conteúdo. Clique sobre ele para receber a mensagem de que Esse tópico ainda não existe e poder clicar no Criar esta página. Veremos em seguida a sintaxe para criação de links. Criando um link Para criar um link você deverá usar a seguinte sintaxe: [[caminho_completo_para_o_documento Nome Amigável do Link]] Observe as seguintes regras para o caminho completo para o documento : O caminho_completo_para_o_documento deverá conter o caminho completo, com todas as pastas na sequencia hierárquica, incluindo o nome do documento, à direita. Exemplo: intelmed:bauru:inicio Os nomes das pastas e do documento não poderão conter espaços, caracteres acentuados, nem letras maiúsculas; Recomendamos que o nome do documento seja simples mas que dê ideia do seu conteúdo; Caso deseje separar as palavras para facilitar a leitura do nome, use o caracter _ (underline); Observe as seguintes regras para o Nome Amigável do Link : O nome amigável do link é o nome que irá aparecer na tela, como referencial do link. Ele não deve deixar dúvidas quanto ao conteúdo do documento; O nome amigável poderá conter espaços, caracteres acentuados e inclusive letras maiúsculas e minúsculas; 4
Exemplos de links válidos: [[bauru:conteudo:03-04-2011 Conteúdo Dimensionado no dia 03/04/2011]] [[arquivo:estudos:2010:modelos Modelos dos Estudos do ano 2010]] [[informativo:edicoes:2012:edicao89 Edição 89a. do Informativo]] Dica importante: Você pode simplificar o caminho para o documento utilizando um ponto (. ) em substituição ao nome da pasta atual onde se localiza a página que você está editando. Por exemplo, se você está editando a página chamada aula, dentro da pasta 03-04-2011 que está dentro da pasta conteudo, que está dentro da pasta bauru, observará no Você está aqui o seguinte caminho: Você está aqui: início» bauru» conteudo» 03-04-2011 Assim, supondo que você deseja criar um link para uma nova página chamada conclusao, poderá usar a seguinte sintaxe simplificada: [[.conclusao Conclusão do estudo]] Substituímos o caminho completo ( bauru:conteudo:03-04-2011 ) pelo ponto (. ). O último nome da direita do caminho ( conclusao ) é o nome da página, como já vimos. Editando um Documento Sintaxe Básica Na janela de edição, escreva o conteúdo da página. Você poderá formatá-lo, selecionando o trecho desejado com o mouse e clicando no botão correspondente ao estilo desejado, na barra de ferramentas: p/ negrito; p/ itálico; p/ sublinhado; p/ riscado; Atenção: após clicar no estilo desejado, o texto na janela de edição não aparecerá formatado imediatamente, mas será reescrito de acordo com a codificação que representa o formato desejado. 5
Por exemplo, o texto em negrito será colocado entre '**' (dois asteriscos), da seguinte forma: **texto em negrito** Você poderá verificar como ficará o resultado final da sua página, antes de salvá-la, clicando no botão Visualizar, logo abaixo da janela de edição. Quando estiver satisfeito com o resultado, clique no botão Salvar para armazenar definitivamente seu conteúdo. Dicas importantes: Sempre comece o texto alinhado à esquerda, sem espaços ou tabulação; Para terminar uma linha de texto e iniciar outra logo abaixo, coloque '\\ ' (dois backslashes seguidos de um espaço em branco) ao final da linha. Para criar um novo parágrafo, deixe uma linha em branco entre duas linhas de texto. Você pode inserir smileys (carinhas) clicando no botão da barra de ferramentas; em seguida, escolha a carinha deseja dentre as opções disponíveis; Muitos caracteres especiais, como símbolos e desenhos, podem ser inseridos clicando no botão da barra de ferramentas e escolhendo dentro as opções disponíveis; Cabeçalhos Você pode usar até 5 diferentes níveis de cabeçalhos para estruturar o conteúdo de um documento. Cabeçalho de nível 1 Cabeçalho de nível 2 Cabeçalho de nível 3 Cabeçalho de nível 4 Cabeçalho de nível 5 Observe que além do tamanho proporcional e do destaque das letras, os parágrafos de cada nível são indentados automaticamente, ou seja, cada nível possui o seu espaço entre a margem da página e o início do texto. Tabela de Conteúdos (TOC) Além de ajudar na organização e estruturação do texto, quando há cabeçalhos na página, o sistema cria automaticamente uma Tabela de Conteúdos (também conhecida por TOC, Table of Contents, do inglês), uma espécie de índice localizado no canto superior direito da página, que proporciona uma visão geral do conteúdo e facilita o acesso a um determinado item de forma imediata, sem a necessidade de rolar a tela. Veja um exemplo de tabela de conteúdos (TOC): 6
As tabelas de conteúdo são criadas automaticamente, e caso por algum motivo você deseje que ela não seja criada em uma determinada página, basta colocar o seguinte comando no início da página: ~~NOTOC~~ Para criar um cabeçalho, selecione com o mouse o texto desejado para o cabeçalho e clique num dos 4 botões disponíveis na barra de ferramentas: botão Cabeçalho de mesmo nível : Formatará automaticamente o texto para um cabeçalho de mesmo nível que o anterior utilizado; se não houver cabeçalho anterior, será usado o nível 1. botão Cabeçalho de nível mais baixo : Formatará automaticamente o texto selecionado para um cabeçalho de nível inferior ao último anteriormente utilizado no documento. botão Cabeçalho de nível mais alto : Formatará automaticamente o texto selecionado para um cabeçalho de nível superior ao último anteriormente utilizado no documento. botão Escolha o cabeçalho que abrirá as 5 opções disponíveis: E permitirá escolher qual o nível de cabeçalho desejado, lembrando que o nível 1 é o maior (de mais destaque) e o nível 5, o menor (de menos destaque). 7
Inserindo imagens e outros arquivos Você pode inserir nas páginas de conteúdo, imagens e outros arquivos anexados, como áudio, vídeo, textos e etc. Para isto você deverá usar o Gerenciador de Mídia, que pode ser acessado através do ícone na barra de ferramentas de edição. Veja os exemplos abaixo: Inserindo uma imagem: exemplo prático Estando na janela de edição da página, coloque o cursor no local onde deseja inserir a imagem, que pode ser uma foto, e clique no ícone da barra de ferramentas de edição (observe que ao parar o cursor do mouse sobre este ícone por alguns segundos, aparecerá a legenda Adicionar imagens e/ou outros arquivos ). Ao clicar neste ícone, o Gerenciador de Mídia será aberto em uma nova janela: O Gerenciador de Mídia (figura acima) mostrará as imagens e outros arquivos de mídia existentes dentro da pasta onde está o documento que está sendo editado, em nosso exemplo a pasta sergio dentro da pasta educadores (ver na figura a marcação Obs 1). Você poderá navegar por outras pastas, clicando sobre elas no quadro à esquerda da tela, onde estará toda a estrutura de pastas do portal. Clique no sinal + para abrir as sub pastas, e no sinal de para fechá-las. 8
Ao localizar o arquivo que deseja incluir, basta clicar sobre ele e você poderá formatar a imagem automaticamente, de acordo com as seguintes opções: Alvo do Link: é o que você deseja que aconteça quando alguém clicar na imagem, depois que ela estiver dentro da sua página de conteúdo. As opções são: Link para página de detalhes ( ): quando a imagem for clicada, será aberta numa nova janela do seu navegador uma página de detalhes da imagem, tais como nome do arquivo, formato, tamanho, etc. Link direto para o original ( ): quando a imagem for clicada, ela será aberta numa nova janela do seu navegador, em seu tamanho original, mas sem qualquer outra informação. Sem Link ( acontecerá. ): não haverá link na imagem, ou seja, quando a imagem for clicada, nada Mostrar apenas link ( ): a imagem não será mostrada, mas apenas um link em formato texto, que poderá ser clicado para então visualizar a imagem. Alinhamento Sem alinhamento ( ): não fará o alinhamento da imagem Alinhamento de imagem a esquerda ( ): alinhará a imagem à esquerda do texto Alinhamento de imagem ao centro ( ): alinhará a imagem ao centro Alinhamento de imagem a direita ( ): alinhará a imagem à direita do texto Tamanho da Imagem Pequeno ( ): do inglês small, formatará a imagem em 100 pixels de largura Médio ( ): formatará a imagem em 200 pixels de largura Grande( ): do inglês large, formatará a imagem em 300 pixels de largura Original ( ): mostrará a imagem em seu tamanho original Importante: cuidado com imagens muito grandes que poderão dificultar a visualização do conteúdo da tela. O tamanho da imagem é mostrado logo ao seu lado, em pixels, conforme exemplo abaixo: O tamanho original da imagem acima é 96 x 116, ou seja, 96 pixels de largura por 116 pixels de altura. 9
Clique nos ícones de acordo com as opções desejadas e então clique no botão Inserir : Será criado, no local onde você tinha deixado o cursor na janela de edição da página, o link para a imagem, de acordo com as opções escolhidas. Veja um exemplo de link criado automaticamente: {{ :educadores:sergio:dsc00177-b_tn.jpg?nolink&200 }} Você não precisa saber o que ele significa, basta escolher as opções desejadas no momento da inserção e a formatação será feita adequadamente. Inserindo uma imagem que ainda não está no portal Se a imagem que você deseja inserir ainda não está armazenada no portal, você precisará enviá-la antes de fazer o procedimento de criação do link, descrito no item anterior. Para isso, clique no botão Escolher Arquivo (ver Obs 2 na figura) e será aberta uma janela que lhe permitirá escolher um arquivo qualquer localizado no seu computador. Você poderá alterar o nome com o qual o arquivo será enviado para o portal, escrevendo o nome desejado no campo Enviar como (opcional). Depois disso, basta clicar no botão Enviar (ver Obs 3 na figura) e o processo de envio do arquivo será iniciado. Quando o envio estiver completado, a imagem aparecerá na lista de imagens daquela pasta, e poderá ser inserida da forma descrita no item anterior. Observe que o tempo de envio dependerá do tamanho do arquivo, da qualidade da sua conexão com à Internet, e pode variar de alguns segundos até várias dezenas de minutos. Inserindo outros tipos de arquivo Para inserir outros tipos de arquivo que não são imagens, por exemplo uma apresentação do Power Point ou um arquivo texto do Word, o procedimento é o mesmo, bastanto localizar o arquivo desejado através do Gerenciador de Mídia e clicar sobre ele (lembre-se que o Gerenciador de Mídia aparecerá quando você clicar no ícone da barra de ferramentas). Exemplo: 10
No exemplo acima, ao clicarmos no arquivo plano_de_trabalho_da_comissao.ppt, será criado um link para a apresentação, dentro da página de conteúdo que está sendo editada. 11