Skip to content

jarrpa/contributing-to-oss

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is this?

This is a slide deck authored in Asiidoc, converted into a DZSlides deck using the asciidoctor-backends project.

Requirements

  • Asciidoctor 0.1.4 or higher

To install

gem install asciidoctor tilt slim

Initial setup

This should done only if you want to prepare a new deck.

Clone the asciidoctor-backends and custom dzslides repos:

git clone https://github.com/asciidoctor/asciidoctor-backends.git
git clone https://github.com/mojavelinux/dzslides.git

Delete the underlying git repo and indices:

rm -rf asciidoctor-backends/.git
rm -rf dzslides/.git

Editing the slides

The slides in slides.adoc are authored in Asciidoc. Read this guide to get started on the syntax. Incorporate any content using plaintext.

Generating the slides

Generate the HTML5 based slide deck:

asciidoctor -b dzslides -T asciidoctor-backends/slim/dzslides -a linkcss -a data-uri slides.adoc

Convert to PDF

Conversion of the HTML5 slide deck is performed using deck2pdf.

Java 8 is recommended to ensure that CSS3 font-faces are found and included correctly.

Install Java 8

tar zxvf jdk-8-fcs-bin-b132-linux-x64-04_mar_2014.tar.gz -C /opt
export JAVA_HOME=/opt/jdk1.8.0
export PATH=$JAVA_HOME/bin:$PATH

Install deck2pdf

Build deck2pdf

git clone https://github.com/melix/deck2pdf
cd deck2pdf
./gradlew distZip

Unzip the distribution somewhere and add to PATH

unzip deck2pdf/build/distributions/deck2pdf-0.1-SNAPSHOT.zip -d <DECK2PDF_HOME>
export PATH=<DECK2PDF_HOME>/bin:$PATH

Convert the slides

deck2pdf --profile=dzslides slides.html slides.pdf

About

Slide deck on "Why to contribute to Open Source"

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 77.9%
  • JavaScript 16.3%
  • Ruby 3.1%
  • Groovy 2.7%