Skip to content

Latest commit

 

History

History
executable file
·
434 lines (239 loc) · 6.32 KB

hovercraft-t2t.rst

File metadata and controls

executable file
·
434 lines (239 loc) · 6.32 KB

Hovercraft for txt2tags

title:Hovercraft-t2t! demo
data-transition-duration:1500
css:hovercraft.css
skip-help:true

This is a demo for Hovercraft! You can view it as a finished presentation at http://farvardin.github.com/hovercraft-t2t/

It's also useful as an example, in which case it's supposed to be read as source code.

You can render this presentation to HTML with the command:

txt2tags hovercraft-t2t.t2t && hovercraft hovercraft-t2t.rst sample

And then view the outdir/index.html file to see how it turned out.

If you are seeing this text, and not reading this as source code, you are doing it wrong! It's going to be confusing and not very useful.

Use The Source, Luke! But first you probably want to read through the official documentation at https://hovercraft.readthedocs.org/ (TODO)

NOTE: This presentation will only start after the symbol below (either 4 dashes, slash star slash star, or slash dot dot dot)


The problem

Making presentations is no fun!

Note

Welcome to the presenter console!


GUI tools are inflexible

  • It's hard to reorganize or import text
  • Sluggy and memory hungry
  • You get caught up in design early in the process.

Note

Here you have a view of the current slide, a preview of the next slide and your notes.


class:green

Use txt2tags!

t2t_logo.png

  • You can use your favorite text-editor!
  • Many tools available: export to beamer, pdf, html
  • Convenient (and powerful!)

Note

You also have a clock and a timer, so you know how much time you have left.


But then there was Prezi

Sliding from left to right is no longer enough.

You need to be able to...

Note

If you click on the timer it restarts from zero. This is handy when you are rehearsing the presentation and need to make sure it fits in the time allocated.


data-y:r1000

...pan...

Note

If you have more notes than fits in the console, you can scroll down, but more handily, you can scroll the text up by pressing space bar.


data-rotate:90

...rotate...

Note

If there isn't more text to scroll up, space bar will go to the next slide. Therefore you, as a presenter, just press space everytime you run out of things to say!


data-x:r0
data-y:r500
data-scale:0.1

...and zoom!

Note

Zooming is cool. But one day it will grow old as well. What will we do then to make presentations interesting?


data-x:r-800
data-scale:1

But Prezi is a GUI

So we are back to square one.

(And it is closed source to boot)

Note

It's probably back to making bad jokes again.


What about impress.js?

It's open source!

Supports pan, tilt and zoom!


id:ThreeD
data-y:r1200
data-rotate-x:180

In three dimensions!

But...

Note

Wow! 3D! You didn't see that one coming, did you?


It's HTML...

Not a friendly format to edit


data-x:r800

...and manual positioning

So inserting one slide means

repositioning all the following slides!

Note

The endless repositioning of slides is what prompted me to write Hovercraft! in the first place.


id:thequestion
data-x:r0
data-y:r-1200

Is there no solution?

Of course there is!

Note

What would be the point of this slide show if I didn't have a solution? Duh!


data-rotate-y:180
data-scale:3
data-x:r-2500
data-y:r0
class:orange

Introducing Hovercraft!

Note

TADA!


class:blue
data-x:r-3000
data-scale:1

txt2tags

plus

impress.js

plus

impressConsole.js

plus

positioning!


data-y:r-1200

Position slides

  • Automatically!
  • Absolutely!
  • Relative to the previous slide!
  • Along an SVG path!

Note

That SVG path support was a lot of work. And all I used it for was to position the slides in circles.


Presenter console!

  • A view of the current slide
  • A view of the next slide
  • Your notes
  • A clock
  • A timer

Note

You found the presenter console already!


Hovercraft!

The merge of convenience and cool!

Note

A slogan: The ad-mans best friend!


data-x:0
data-y:2500
data-z:4000
data-rotate-x:90

and now...

Hovercraft-t2t!

Edit your presentation with the txt2tags syntax!

On Github:

https://github.com/farvardin/hovercraft-t2t

Note

Fork and contribute!


data-x:0
data-y:4500
data-z:4000
data-rotate-x:00

Note: We didn't code hovercraft.

Hovercraft-t2t is only a frontend to produce a reStructuredText document from a txt2tags document, and it will be parsed further with the hovercraft tool.

The original hovercraft is located at https://github.com/regebro/hovercraft


How to use it

  • Install hovercraft with this command:
pip install hovercraft

Note

If it fails, try: sudo pip install --upgrade setuptools pip-3.2 install --upgrade hovercraft

  • Study the t2t source at:

https://github.com/farvardin/hovercraft-t2t/blob/master/hovercraft-t2t.t2t


Thank you for your attention!