Documentos e slides para o evento Join Community 2014

Esse repositório contém:

1. Minha proposta de submissão de apresentação para o evento Join Community 2014;

2. Dois guias que são insumo para os slides dessa apresentação:

   1. O primeiro fala sobre como crio e disponibilizo uma máquina virtual (VM) com o Fedora 20, instalado e configurado para as tarefas dessa apresentação;

   2. O segundo pode ser utilizado pelo público em geral, para a execução das tarefas da apresentação.

3. Os slides da apresentação:

   1. Em formato HTML: slides.html. Elem podem ser visualizados diretamente em seu browser se você tiver feito um clone do projeto em seu sistema de arquivos. Do contrário, abra-o através do htmlpreview;

   2. Em formato PDF: slides.pdf. Observação: esse formato estará aqui, no GitHub, somente após a conclusão final dos slides.

4. Um agradecimento as pessoas que contribuiram com o meu aprendizado para realizar essa apresentação;

Obviamente, o trabalho de algumas outras pessoas foi utilizado, por mim, como base para criar esse repositório. A seguir, descrevo o passo a passo que desenvolvi para a sua criação, utilizando o Fedora 20 que tenho instalado em meu MacBook.

Baixei o projeto wildfly-deck, do Arun Gupta, pois ele já estava preparado com algumas configurações que eu queria utilizar. Então, fiz apenas alguns ajustes na estrutura de diretórios e apaguei alguns arquivos que eu não precisaria:

$ cd ~/Projects/github.com/paulojeronimo
$ git clone --depth 1 https://github.com/arun-gupta/wildfly-deck.git join-community-2014
$ cd !$
$ mv deck/* .
$ rm -rf README.md LICENSE .git deck/ zh-cn/ slides.{html,pdf}

Instalei o RVM, o Ruby e, por fim, o Asciidoctor:

$ curl -sSL https://get.rvm.io | bash -s stable
$ source ~/.rvm/scripts/rvm
$ rvm install 2.1.1
$ gem install asciidoctor

Antes de gerar os slides com o Asciidoctor, utilizando os comandos mais abaixo, dois gems precisaram ser instalados:

$ gem install tilt
$ gem install slim

Gerei os slides com o Asciidoctor:

Tip	Não foi preciso instalar o dzslides e nem o asciidoctor-backends pois eles já existiam e estavam configurados na estrutura clonada do projeto wildfly-deck.

$ asciidoctor -b dzslides -T asciidoctor-backends/slim/dzslides slides.adoc

Baixei e compilei o projeto deck2pdf para fazer a geração dos slides no formato PDF:

$ pushd ~/Projects/github.com/
$ mkdir melix
$ cd !$
$ git clone https://github.com/melix/deck2pdf.git
$ pushd deck2pdf/

Fiz um upgrade do JDK 7 para o 8, utilizando o Fedy, através dos comandos a seguir. (O deck2pdf precisa da versão 8 do Java, especificamente)

$ sudo fedy -u oracle_jdk
$ sudo fedy -e oracle_jdk

Ajustei o JAVA_HOME para o local de instalação do JDK 8 e fiz o solicitei a construção do deck2pdf:

$ export JAVA_HOME=/usr/java/latest
$ ./gradlew distZip

Note	$ ./gradlew distZip através de um proxy Ao executar esse comando, acessando a Internet através de um proxy, tive que executar a seguinte linha antes dele: $ export JAVA_OPTS="-Dhttp.proxyHost=proxy -Dhttp.proxyPort=3128"

Instalei os binários gerados como resultado da compilação/ construção do deck2pdf:

$ mkdir -p ~/Projects/Java
$ unzip build/distributions/deck2pdf-0.1-SNAPSHOT.zip -d !$
$ chmod +x !-2:2/deck2pdf-0.1-SNAPSHOT/bin/deck2pdf
$ export PATH=!-3:2/deck2pdf-0.1-SNAPSHOT/bin:$PATH
$ popd
$ !!

Regerei o PDF dos slides criados pelo Arun, para testar a instalação:

$ asciidoctor -b dzslides -T asciidoctor-backends/slim/dzslides -a linkcss -a data-uri slides.adoc
$ deck2pdf --profile=dzslides slides.html slides.pdf

Funcionou! A versão PDF dos slides foi gerada. Agora, a instalação das ferramentas para a edição dos slides estava ok!

Prossegui removendo as imagens existentes no diretório images:

$ rm -rf images/*

Criei um pequeno script, que executo quando estou editando o slides.adoc dentro do vim (comando :!./slides.build.sh):

$ f=slides.build.sh
$ echo 'asciidoctor -b dzslides -T asciidoctor-backends/slim/dzslides slides.adoc' > $f
$ chmod +x $f

Segui em frente editando o arquivo slides.adoc e regerando o slides.html com as minhas informações até a sua conclusão:

$ vim slides.doc

Important

Os passos acima estão sendo repetidamente executados até poucos dias antes do evento (31/Maio/2014).

Criei o repositório no GitHub, o repositório local, e fiz o push dos arquivos que criei:

$ git init .
$ git add .
$ git commit -m 'commit inicial'
$ git remote add origin https://github.com/paulojeronimo/join-community-2014.git
$ git push -u origin master

Important

Você poderá acompanhar o desenvolvimento e o histórico desse repositório aqui no GitHub! :-)