Experimentar sem instalar

O propósito desta página é permitir os usuários experimentem o limarka rapidamente, sem precisar instalar software.

NOTA: Caso você venha a utilizar o limarka provavelmente irá instalá-lo e usá-lo localmente. O método descrito a seguir NÃO é método mais ágil apenas agiliza a experimentação do limarka.

Se não desejar experimentá-lo desta forma pode avançar para próxima seção: Instalação Visão Geral.

NOTA2: Se você se interessa por desenvolvimento de aplicações recomendo que siga as instruções deste guia, pois ele apresenta como utilizar o github para hospedar projetos e um servidor de integração contínua para gerar artefatos e publicá-lo no github.

O texto abaixo contém as instruções para experimentar o limarka sem instalar nada.

Registre-se e faça um login no Github

Caso você ainda não tenha, crie uma conta no github.

Faça um fork do modelo oficial do limarka

Acesse https://github.com/abntex/trabalho-academico-limarka e clique em Fork. Ou simplesmente clique aqui para realizar o fork.

Isto irá criar uma cópia (um fork) desse repositório no seu espaço, aonde somente você terá permissão para alterar.

Crie um token de acesso

Crie um token de acesso através desse link. Dê qualquer nome, e marque repo. Clique em Generate Token.

Depois copie o token gerado, ele será utilizado mais adiante.

Configure o travis para geração do PDF

Faça o login no travis com a conta do github. Ative o build do repositório do seu fork

Clique em Settings (ao lado do repositório) e configure as seguintes variáveis de ambiente:

EMAIL: O seu e-mail
NOME: O seu nome completo
TOKEN: Cole o token gerado
PDF: O nome do arquivo PDF que será publicado

Gerando o PDF

Inicie o build do repositório a partir do travis:

Depois clique em Trigger para iniciar o build:

Aguarde a geração do PDF

Acessando o PDF

Clique no ícone do Github para voltar ao seu repositório

Clique em releases:

O PDF do trabalho foi gerado, clique no link para acessá-lo.

Editar o texto

Vá para a página inicial do repositório, clique trabalho-academico.md e depois no lápis para editar o arquivo.

Atualize o texto inserindo qualquer coisa, depois clique em Commit changes.

Verifique nova geração

Volte ao travis, clique em builds e perceba que um novo build foi iniciado para geração do PDF.

Aguarde a geração do PDF finalizar e depois volte aos releases do repositório. Perceba que um outro PDF foi publicado:

Verifique as alterações

Abra o PDF e verifique as alterações.

Resumo técnico

Este processo é mesmo utilizado por desenvolvedores de software. Você configurou um servidor de integração contínua para iniciar um build (gerar o PDF) sempre que houver alterações submetidas ao repositório.

NOTE: Caso tenha ficado curioso(a) sobre este processo ele está configurado no arquivo .travis.yml. Neste processo utilizamos o limarka através de uma imagem docker, uma forma moderna de distribuir aplicações.