Migrando meu blog para Github Pages usando Jekyll

1 Maio 2016

• Jekyll update
• GitHub
• Bundler

Decidi migrar meu blog para uma plataforma mais moderna e limpa. Para tanto, usei Jekyll para criar a nova interface e GitHub Pages para implementá-la e publicá-la na net. Inspirei-me em Carl Boettiger e seu open lab notebook. Como eu já tinha interesse em criar um projeto de “caderno de anotações de pesquisa aberto” (open notebook science), mas voltado para pesquisa clínica, um open science clinical trial que vai abrigar um ensaio clínico com os princípios da ciência aberta (open science), entendi que a experiência com esta nova plataforma poderia ser aproveitada para este e outros projetos.

Resumidamente, criei um repositório público no GitHub para abrigar os arquivos gerados pelo Jekyll, uma poderosa ferramenta para criar páginas estáticas da net. Usei, inicialmente, uma versão portátil de Jekyll para Windows, o que facilitou as coisas. Localmente, criei um diretório e iniciei um repositório de Git nele, onde rodei Jekyll para gravar os arquivos necessários para o blog. Também uso tanto a versão para Windows de Git quanto sua versão portátil. Na verdade, meus arquivos locais estão num pendrive e são usados em vários computadores, pessoais e do trabalho. Considerações com segurança não são uma preocupação, uma vez que a maioria de meus trabalhos são públicos. A fim de proteger a confidencialidade de meus pacientes, todos os dados referentes a eles que vão a público são desidentificados.

Em seguida, experimentei instalar Ruby para Windows e Jekyll via Bundler usando a gem do GitHub Pages. Assim, recriei os arquivos do blog para que tivessem integração com os recursos e dependências do Github Pages. Localmente, criei um branch do repositório que havia iniciado, com o nome gh-pages. Fiz o push para o repositório do Github e voilá, o blog estava no ar. Alguns ajustes mais e estava bem razoável.

Uma das vantagens da plataforma Jekyll/Github Pages é poder escrever os posts em sintaxe Markdown, uma forma simplificada de html que permite escrever quase como se estivesse usando apenas texto simples sem formatação, e mesmo assim renderiza páginas esteticamente agradáveis. Os posts podem ser comitados localmente ou no próprio Github na net. Por exemplo, este post foi escrito em markdown (GitHub flavored) no Escritor Pro, um aplicativo para iOS e comitado no Github em meu iPad.

Farei novas postagens neste novo formato do Pharmakon, não importarei todas as postagens antigas, uma funcionalidade oferecida pelo Jekyll, porém vou importar manualmente e acrescentar mais comentários, atualizando e aprofundando o conteúdo, as principais postagens do antigo Pharmakon, para dar um kick-off no novo blog. Uma das postagens a ser “rebooted” vai ser aquela do tratamento de hemangiomas com propranolol, uma das mais visualizadas do velho Pharmakon.