GithubHelp home page GithubHelp logo

cliffe / awesomeslides Goto Github PK

View Code? Open in Web Editor NEW
26.0 5.0 4.0 172.16 MB

AwesomeSlides makes awesome HTML5/CSS slides (based on Reveal.js) by converting slides made with LibreOffice.

License: GNU Affero General Public License v3.0

Perl 1.03% HTML 17.30% JavaScript 43.10% CSS 38.57%

awesomeslides's Introduction

AwesomeSlides (with LibreOffice to Reveal.js slides converter)

AwesomeSlides makes awesome HTML5/CSS slides (based on Reveal.js) by converting slides made with LibreOffice.

A script "convert-to-awesome.pl" can convert from libreoffice slides (you can simply save Powerpoint slides to .odp first), to AwesomeSlides (based on Reveal.js), great looking HTML5-based slides.

  • Supports attribution in slides (for styles, and also for images on the slide)
  • Supports multiple images on a slide, and has CSS styles depending on the number of images on a slide
  • Detects when an image is stretched to be a background to a slide

Features that AwesomeSlides adds to Reveal:

  • New great style/theme
  • Randomised elements of styling for slides (for example, borders, colours, etc)
  • Automatically adds a feature slide (every X slides) with extra fancy CSS (for example, star feilds, or moving clouds)
  • Resizes text to fit on slides

You can view example output slides here.

How to use

1) Create your slides in LibreOffice

Most formatting will be ignored.

Put your text in the outline text box rather than by inserting text via a text box; text will be ignored unless it is outline text or detected as being attribution text.

If you want an image to be used for a background, simply enlarge it.

If you want programming code on slides to be highlighted, include on your slide "code:", "html_code:", or "css_code", followed by the code.

If you start a line with > it will be considered a command line example.

If you want to include attribution text, then follow examples in my slides.

If you start slides with the same heading the generated slides will stack vertically, you can use headings such as "thingy: an introduction" and "thingy: a conclusion", all slides between these will be grouped to stack vertically rather than horizontally (affecting animations between slides).

2) Convert your slides to AwesomeSlides/Reveal.js

Ensure Perl is installed, then install the CPAN modules. Run:

sudo cpan Archive::Extract XML::LibXML Term::ANSIColor URI::Encode

Convert your slides, run:

perl convert-to-awesome.pl [ODP FILEs]

For example, to convert all the example slides:

cd /home/user/bin/awesomeslides/

perl convert-to-awesome.pl input_slides_examples/Modules\ 1718/*/Lectures/*

3) View your slides

The generated slides are found in slides_out

Simply open the html file in your browser (Chrome/Chromium is strongly recommended).

Enjoy!

Customising your HTML slides

You can force a specific fancy background for a slide:

<section data-fancy-background="bg_sky">

Set how often the slides are based on exciting CSS templates:

  awesomify({
    step: 5, // awesomify roughly every 5th background
  });

Other things can be done manually, please refer to the source code or outputs for examples.

awesomeslides's People

Contributors

cliffe avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

awesomeslides's Issues

Fails to convert "slides_out" dir error.

Warning: skipping over non-outline text '<p>Ren&#233; Rivera</p><p><page-number>&lt;number&gt;</page-number></p>' on page 1 at AwesomeSlides/convert-to-awesome.pl line 155.
Warning: skipping over non-outline text '<p><page-number>&lt;number&gt;</page-number></p>' on page 2 at AwesomeSlides/convert-to-awesome.pl line 155.
Warning: skipping over non-outline text '<draw:text-box/><p><page-number>&lt;number&gt;</page-number></p>' on page 3 at AwesomeSlides/convert-to-awesome.pl line 155.
Could not copy framework files to ./slides_out: Not a directory at AwesomeSlides/convert-to-awesome.pl line 301.

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.