Giter Club home page Giter Club logo

decks's Introduction

Decks

A repository of my presentation slide decks and workshops.

The presentations are written in AsciiDoc, generated by the AsciiDoc toolchain and presented in HTML5 using (my fork of) dzslides.

Setting up the build environment

Follow these instructions (for *nix) to setup AsciiDoc to generate dzslide presentatations from the AsciiDoc source file:

First, install AsciiDoc. Ensure that the command asciidoc is available on your PATH.

Next, set the environment variable DECKS to where you want to checkout this repository:

DECKS=$HOME/mojavelinux-slide-decks

Finally, fetch and setup the backend, dzslides and the decks.

mkdir -p $HOME/.asciidoc/backends
cd $HOME/.asciidoc/backends
git clone git://github.com/mojavelinux/asciidoc-dzslides-backend.git dzslides
cd dzslides
git clone git://github.com/mojavelinux/dzslides.git
mkdir -p $DECKS
cd $DECKS
git clone git://github.com/mojavelinux/decks.git ${DECKS##*/}

Presentation build instructions

Follow these build instructions to generate a dzslide presentation from the AsciiDoc source files.

First, set the DECK environment variable to the name of the folder for the presentation you want to generate:

DECK=awestruct-git

Next, change into that directory:

cd $DECKS/$DECK

Next, generate a standalone HTML file that embeds all assets (stylesheets, JavaScript sources and images).

asciidoc -a data-uri -a linkcss! slides.asciidoc

You can now view the presentation slides.html in your browser.

Note

If you get the following warning:

asciidoc: WARNING: slides.asciidoc: line 37: missing style: [blockdef-listing]: qrcode

…​it means you need to install the AsciiDoc qrcode filter.

If you want to link to the assets, you can just run the asciidoc command without any arguments:

asciidoc slides.asciidoc

However, you also need to create a symlink to the dzslides project so that the linked assets can be located.

ln -s $HOME/.asciidoc/backends/dzslides/dzslides dzslides

Enjoy!

decks's People

Contributors

mojavelinux avatar graphitefriction avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.