O 1Wiki oferece duas maneiras de editar o conteúdo das suas páginas: o Editor de Texto Rico em HTML (também conhecido como WYSIWYG - What You See Is What You Get) e o Editor Markdown. Esta página explica como usar cada um dos editores.
Editor de Texto Rico em HTML #
O Editor de Texto Rico em HTML vem com uma barra de ferramentas no topo, oferecendo várias opções comuns de formatação. Passar o mouse sobre cada ícone exibirá a descrição da função de cada uma. Por padrão, o conteúdo inserido é envolto por tags <p> HTML, e ao pressionar Enter ou Return, você cria um novo parágrafo.
Se você preferir trabalhar diretamente com o código HTML, clique no botão "Mostrar HTML" abaixo do editor para visualizar e editar o HTML do conteúdo. Você pode alternar de volta para o editor de texto depois de modificar o código HTML.
Adicionando Links #
Existem dois tipos de links no 1Wiki: links internos e externos.
Links Externos: São links para páginas da web fora do seu 1Wiki. Para inseri-los, use o ícone 🔗 na barra de ferramentas. O link será inserido na página ou, se você selecionar algum texto, ele será transformado em um link para a URL especificada. Links externos são identificados com o ícone ⧉ e abrirão em uma nova aba.
Links Internos: São links para outras páginas dentro do seu 1Wiki. Para criar um link interno, insira o título da página entre dois colchetes ❗assim. O texto dentro dos colchetes será automaticamente convertido em um slug. Caso você queira especificar um slug manualmente, use o formato ❗texto de link. Se você criar um link para uma página que ainda não existe, ela será exibida em vermelho com um ponto de exclamação. Clicar nesse link permitirá criar a página posteriormente.
Para vincular a um título de uma página, adicione o hash do título após o slug: ❗curtir isso. Se você deseja vincular ao título de uma página na página atual, use o slug da página da mesma forma.
Adicionando Imagens #
O 1Wiki permite adicionar imagens internas e externas.
Imagens Externas: São referenciadas por URLs e podem ser inseridas usando o ícone 🖼️. Ao adicionar imagens externas, o arquivo do seu 1Wiki permanecerá leve, mas será necessário acesso à internet para visualizá-las.
Imagens Internas: São carregadas diretamente do seu computador e armazenadas no arquivo HTML do seu 1Wiki. Para inserir uma imagem interna, use o ícone 📸 na barra de ferramentas. Após escolher a imagem, você pode definir a largura, altura e o texto alternativo da imagem. O 1Wiki irá redimensionar a imagem de acordo com as dimensões fornecidas, se necessário. Caso a imagem já tenha sido adicionada anteriormente, você pode reutilizá-la sem duplicá-la.
Depois de inserir a imagem, é possível movê-la cortando e colando em outra parte da página, mas fique atento a eventuais problemas ao fazer isso. Para gerenciar imagens internas, você pode usar o ícone 📎 para selecionar imagens já carregadas no seu 1Wiki.
Editor Markdown #
Markdown é uma linguagem de marcação simples que permite escrever texto formatado de maneira legível sem precisar de código HTML. O Editor Markdown no 1Wiki é um campo de texto simples com três botões abaixo: Visualizar, Inserir imagem do arquivo e Adicionar imagem existente.
- O botão Visualizar expande um painel mostrando como o conteúdo será renderizado em tempo real.
- Os botões Inserir imagem do arquivo e Adicionar imagem existente funcionam da mesma forma que os ícones 📸 e 📎 no editor de texto rico.
Links e Imagens no Markdown #
Os links internos e externos em Markdown são adicionados da seguinte forma:
As imagens também seguem uma estrutura simples em Markdown, mas a imagem será representada por um hash encurtado, como . O texto alternativo será renderizado automaticamente ao exibir a imagem na página.
Alternando entre HTML e Markdown #
Você pode alternar entre os editores HTML e Markdown a qualquer momento. Quando mudar de Markdown para HTML, o 1Wiki perguntará se deseja converter o conteúdo do Markdown para HTML. Se optar por "Ok", o conteúdo será convertido; caso contrário, o Markdown será mantido, mas você continuará no editor HTML. Se mudar de volta para o editor Markdown, o código HTML será inserido como texto no campo Markdown e não será renderizado.
Texto de Escape #
O 1Wiki permite que você evite que qualquer texto seja processado como links ou Markdown, usando a tag <nowiki>. Isso é útil para mostrar exemplos de links internos sem que eles sejam convertidos em links reais, como em <nowiki>❗like this</nowiki>.
Esse recurso pode ser utilizado no editor Markdown diretamente, mas no editor HTML é necessário ativar o botão "Mostrar HTML" e inserir a tag <nowiki> manualmente.