Documentos e slides para o evento Join Community 2014
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
asciidoctor-backends
dzslides
vm
.gitignore
Guardfile
README.adoc
TODO
acknowledgments.adoc
attributes.adoc
configurar-apache.sh
html.build.sh
onstage.html
passo-a-passo.adoc
passo-a-passo.disponibilizacao-vm.adoc
passo-a-passo.tmux-view.sh
slides.adoc
slides.build.sh
slides.html
slides.pdf
submissao.adoc

README.adoc

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! :-)