CHANGELOG.txt

0.20.2
  * Added styling for preshow images (thanks @iversond #903)
  * Styling improvements for numbered code blocks (thanks @raphink #904)
  * Corrected Font Awesome style updates (#905, #909)
  * Fixed a version check (thanks @op-ct #906)
  * Fixed an error with `showoff skeleton` (thanks @op-ct #907)
  * Update highlight.js (thanks @abuxton #912)
  * Adds nested hash syntax when using config data in presentation templates (thanks @op-ct #911)

This also starts a complete rearchitecting of Showoff that will make the codebase
far easier to improve and maintain. This work is 99% in parallel to the legacy
codebase so that there should be few or no breaking changes. Currently only the
`static`, `static supplemental/print/pdf`, and `pdf` subcommands have been implemented.
You can use the new engine for these commands with the `--dev` command line argument.

Please file issues if you see *any* breakage or new oddities.


0.20.1
  * Font Awesome changed a lot of class names and the like. This fixes them.
  * Added the ability to specify additional styles and scripts in your presentation.
  * Fixed a couple path problems.
  * Switched to a better way of printing from the presenter
  * UI fixes

0.20.0
  * Update Font Awesome to the latest
  * Prevented tours from loading every time you use the presenter
  * Fix PDFkit printing
  * Add languages from strings.json to the language selector
  * Add ability to line-number code blocks
  * Some minor UI cleanups
  * The usual IE mitigations
  * Removed the asset_path handling. Please read note below.

Prior versions of Showoff used a pretty fragile form of path munging that allowed
it to handle serving multiple presentations with the same server. That's not been
a fully supported use case for years now, and it prevented other kinds of usage,
like using a reverse proxy to run multiple services on different paths on a web
server. If this behaviour is important to you, then please pin to v0.19.6 and
file a ticket explaining your use case.

Going forward, the supported method for running multiple presentations from the
same base URL will be to configure something like nginx to proxy different paths
to multiple Showoff instances running. Simplifying in this way will also make it
far far easier to run multiple containerized instances.

Also note that this was a rather large and invasive change, so I expect that
testing may not catch all issues. Please report any problems you find!


0.19.6
  * Reverted IE hotkey fix that broke presentation navigation in many cases.

0.19.5
  * Reverted hotkey change, sorry about that!
      * Trigger section navigation by pressing SHIFT along with any standard navigation key.
  * Added per-slide content translations via `~~~LANG~~~` tags. (@raphink)
  * Prevent IE from triggering hotkeys when typing in a form.
  * Reordered javascript loading for more predictable behaviour.

0.19.4
  * Move to next/previous sections.  (@raphink)
  * Improved SVG localization.  (@raphink)
  * Allow internal links to slides via title.  (@raphink)
  * Warn the presenter if they open the audience view instead of display view.

0.19.3
  * Dereference symlinks in compatibility themes for the syntax highlighter.
  * This resolves an issue with older RubyGems versions which cannot unpack links properly.

0.19.2
  * Clarifies checkpoint answer keys by decorating correct/incorrect answers
  * Corrects regression: opens links from notes in new a tab/window
  * Allows for table of contents for supplemental materials
  * Minor UI improvements

0.19.1
  * The UI tour only shows by default if running from localhost.
      * There's a new button on the help dialog (`?`) to run it on demand.
  * Add ability to show UI tour for dropdown menu

0.19.0
  * This release adds a first-run interface tour. If you're already familiar with
    the UI, just bear with it. Once you've finished it (by clicking *Done*), you
    won't see it again.
  * Adds tips for both the presenter and the audience for some UI elements when
    they're first seen. For example, it will show how the *Activity complete* toggle
    works for both parties.
  * Corrected several minor issues:
      * Don't crash on blank presentation.
      * Don't show broken images when text files are included in the preshow.
      * Show line highlighting when printing.
      * Print mermaid diagrams and image translations properly.
      * Allow floating notes window to scroll properly.
      * Improve readability for highlighted code on a dark background.

0.18.2
  * Add button to sync with the presenter. When the audience view doesn't match
    the presenter view, they'll have a shortcut button to get back in sync.
  * Sometimes a disconnected server could spike the CPU. Now fixed.
  * When listing slides in an array, generate sections in the proper order, even
    when they're disjointed.
  * Allow for absolute from preso root paths.
  * Add command to dump generated information about a presentation, such as all
    slides, images, styles, javascripts used.
  * Clean up some minor display issues.

0.18.1
  * Added missing gem dependency
  * See notes below for more information about this release

0.18.0
  * Showoff UI now fully internationalized
    * UI appears in the language configured by the browser for both presenter and audience
    * Content can be translated into multiple languages, see docs for info
    * Display the appropriate language for each audience member individually
    * CLI is not currently internationalized
  * Choose the type of notes attached when printing from browser dialog
  * Audience view shows follow mode more readily
  * Preview thumbnails show backgrounds better
  * Show correct answers for quizzes in audience view
  * Minor UI and performance improvements

0.17.2
  * Slides can now be tagged as "activity", which gives audience members the ability
    to inform the presenter when they're done.
  * Several UI/UX improvements and refinements.
  * Added markup to highlight specific line in code blocks.
  * Font Awesome icon markup syntax.
  * Bugfix: another legacy showoff.json fix
  * Bugfix: workaround Commonmarker API breakage
  * Bugfix: edit link works with relative paths

0.17.1
  * Several style updates, including the help dialog and mobile view.
  * Bugfix: fixed failure when manually creating HTML anchors.
  * Bugfix: Properly parse some legacy forms of the showoff.json

0.17.0
  * Presenter UX overhaul:
    * Flatter UI with larger widget target sizes.
    * Nicer full-width slide progress bar.
    * Subdued colors, making it less blinding in darker settings.
    * Relocated some elements to make them more contextual.
      * Of note, the slide source is now located below the slide preview.
    * Presenter/handout note tabs are more accessible.
    * Notes font sizes can be altered.
    * Lesser used settings have been moved into a dialog.
  * Backwards compatible `showoff.json` file format update allowing named sections.
  * Bug fix: missing table of contents tag no longer causes crash.
  * Regression fix: `showoff static` works properly again.

0.16.2
  * More useful real-time viewing statistics.
  * Prevent the system from sleeping with --nosleep.
  * Allow quizzes and stats to work behind a proxy.
  * Experimental: glossary item tags (undocumented for now).

0.16.1
  * Switched the text based status in the presenter to a progress bar.
  * Minor code cleanups.
  * Bugfix: default to sidebar open.
  * Bugfix: allow the stats page to scroll again.
  * Bugfix: highlight code properly when using fenced code blocks (e.g. with Commonmarker).

0.16.0
  * Add dynamic UI functionality to the Presenter view
    * Hide the sidebar using the hamburger icon on the top left.
    * Resize or pop out the notes using the icons on the top right of the notes.
  * Added autoplay as a slide option for videos on a slide.
  * Allow `showoff static` to use alternate json files.
  * Added slide preview hover to the audience menu.
  * A better way to track the time presenters are on a slide.
  * Enable the use of `pry` by wrapping GLI in a module.
    * Dropped GLI v1.x support.
  * Minor UI updates.
  * Bugfix: Fix Heroku publication.

0.15.4
  * Bugfix: Correct issues with slide notes when using `bigtext`.
  * Added Mermaid diagram rendering (http://knsv.github.io/mermaid/)

0.15.3
  * Remember selected layout, so you don't have to change it each time.
  * Adds `bigtext` slide style, which will expand text size to fill the slide.

0.15.2
  * Bugfix: Corrected misplaced hamburger menu.
  * Execute code of any kind by defining custom parsers.
  * Composable showoff.json by including sections as individual json files.

0.15.1
  * Bugfix: Corrected some static page generation issues.

0.15.0
  * Presenter UI overhaul adding multiple layout selections.
      * Choose layout using the selector in the upper right.
      * The old "Notes Window" is now the "Floating" layout.
      * Decreased memory usage.
      * Add hover slide preview tooltips to the menu.
  * Improved scaling algorithms so all supported browsers are treated the same.
  * Bugfix: Fixed several bugs with incremental bullets.
  * Bugfix: Improved UI rendering on IE and Edge.
  * Bugfix: Fixed annotations on IE and Edge.
  * Improved code block validation to allow skipping individual blocks.
  * Add versioning to web assets so cached styles should be less of a problem.
  * Restored the ability to do soft refresh of content only.
  * Known issues:
      * Thumbnail previews are not perfectly rendered; they're approximations.

0.14.3
  * Add browser capability detection with error page for unsupported browsers
  * Update Docker image with Commonmarker & trimmed size

0.14.2
  * Corrected headline duplication in /print view.
  * Prevent Firefox from starting annotations before it's enabled.
  * Fixed Firefox presenter view layout.
  * Improved scaling algorithm for Firefox.

0.14.1
  * Enabled zoom in the popout notes window for Chrome.
  * Bugfix: allow audience members to view with IE again.

0.14.0
  * Minor style fixes.
  * Enhanced serving from git repository.
      * Serve from repo / branch / path within repo
  * Added simple annotation system
      * Draw on the presenter slide and it shows on projector and audience view.
      * Lines, simple shapes, colors, animated focus pointer.
      * Annotations are attached to slides and are persistent until erased or disabled.
      * NOTE: due to differences in browser rendering engines, annotations on
              audience views are slightly imprecise.
      * This makes significant changes to the rendering system. Please file
        tickets on any regressions.
          * https://github.com/puppetlabs/showoff/issues

0.13.4
  * A couple updates which make reloading fresh content more reliable.
  * Refresh content when serving from a git url
  * Fixed a couple styling issues

0.13.3
  * Hotfix to correct interface binding behaviour.

0.13.2
  * Add the ability to serve from a Git url.
  * Add a Dockerfile.
  * Make the content reloading action more predictable.
  * Set a default UTF8 encoding.
  * Add console window styles to differentiate from Bash code.

0.13.1
  * Fixed style regression in form rendering and mobile view.
  * Bumped size of live code execution results.

0.13.0
  * Added on-slide code block validation
  * Add .thumbsup callout style
  * Extended showoff init to support multiple directories
  * Fix the download page lack of scrolling
  * Added a simple example build_pdf.sh script
  * Remove RMagick support, as browser scaling works better anyway

New command:
  * The new `showoff validate` command will ensure that all directories and
    slide files listed in the `showoff.json` file exist and then will run
    validation commands against all code blocks of known styles in your
    presentation. Add your own validation commands by defining `validators`.
  * Validates perl/python/ruby/shell/puppet code snippets.

Removed functionality:
  * RMagick support has been removed. Browsers can autoscale images on demand
    pretty well now, so you probably won't miss it much.

0.12.2
  * Fixed some glaring UI bugs with the new callout styles.
  * Cleaned up and fixed some command line interactions.
  * Recommended update.

0.12.1
  * Lots of small UI cleanups.
  * Properly disable interactivity when the websocket connection dies.
  * New mobile-friendly presentation view.
  * Fixed Github Pages presentation generation.
  * Added mini-tab switcher so the presenter can view handouts or other notes.
  * Added ability to print different notes style. For example,
    `showoff static print notes` will generate a static page with presenter notes.
  * Added Commonmark support, contributed by @raphink
  * Added a new timer widget if you'd like to time your presentations.
  * Major updates to audience interactivity:
    * Provide on-screen notification when questions are pending.
    * Allow audience members to cancel their questions.
    * Notify audience members when the presenter has marked their question as answered.
  * Updated code execution styles.
  * More usable downloads menu.
  * Added the ability to gate presentations behind a key.

New command:
  * The new `showoff skeleton` command will take a `showoff.json` file, either
    in the current working directory or via a `-f` path option, and generate a
    full file & directory structure with starter slide files for you. It's safe
    to run on existing presentations; it will only create missing files, not
    overwrite existing files.

Deprecation warning:
  * RMagick will be completely removed in the next major release. Please migrate
    away from it now. Browsers can autoscale images on demand pretty well now,
    so you probably won't miss it much.

0.12.0
  * ##### WARNING: This is a major breaking change! ######
  * You will need to CLEAR YOUR BROWSER CACHE before presenting.
  * The visual look has been drastically improved.
  * The default slide styles have been improved greatly. This means that if you
    have built custom styles, you **will need to update your styles!**
  * The slides now scale much more cleanly. Ctrl+ and Ctrl- to your heart's content.
  * Many performance improvements.
  * The toolbar has been cleaned up with deprecated functionality being replaced
    more useful buttons.

New command:
  * To replace deprecated features, we added a new `showoff pdf` command. This
    uses `pdfkit` to build the PDF file, which you can then put into `_files/share`
    if you'd like the the audience to download it. This means the file is built once
    instead of each time the endpoint is hit! Much faster and also removed a race
    condition.

Endpoint removal:
  * Some lesser used endpoints were removed. Notably, `/onepage` and `/pdf` are gone.
  * The `/print` endpoint had been a better replacement for `/onepage` for a long time.

0.11.2
  * Fix some small styling issues.
  * Drop IE8 support as it has passed EOL.

0.11.1
  * Fix style regression making it difficult to open the download page

0.11.0
  * The presenter now gets a visual indication of how many responses each
    form question has received.
  * Form bar graphs are now scaled in a more sensible fashion.
  * Forms can now indicate correct responses.
  * Server can now run using SSL, either providing certificates or
    autogenerating self-signed certificates.
  * Record user-agent in stats to help identify browser support for
    future content updates.
  * Faster content loading for audience members.
  * Add full documentation of the `showoff.json` settings in one place.
  * Bugfix: internal links in notes no longer open in new tabs.


0.10.2
  * Corrected again print styling regression.

0.10.1
  * Corrected print styling regression.
  * Open links from notes in new windows.

0.10.0
  * Updated highlighting library
  * Added ability to customize keyboard shortcuts. See CONFIGURATION.rdoc
      * Changed defaults to be more logical
  * Accurate preshow timer
  * Visual revamp of several elements
  * Presenter controls for preshow, pause, blank work better with display view
  * Revamped executable code process
      * Removed security holes
      * Added Perl, Puppet, Python, Shell interpreters
  * Follow mode on by default
  * Removed unreliable style switching functionality

Compatibility note:
If you are currently styling code blocks in your presentations then you will
need to update your selectors. Here is an example that will style both earlier
Showoff versions and current.

    /* Add some nice styling to the code blocks. */
    .content pre:not(.highlight),
    .content pre.highlight code {
        border: 2px solid #ddd;
        padding: 0.5em;
        overflow: hidden;
        -moz-border-radius: 10px;
        -webkit-border-radius: 10px;
        -khtml-border-radius: 10px;
        border-radius: 10px;
        display: block;
    }

0.9.11.1
  * Tiny bugfix to silence deprecation warning

0.9.11
  * Correct regression in navigation menu generation.
    * (Proper names are displayed again!)
  * Change the Slave Window name to Display Window
  * Flush stat files to disk periodically, and only when they're not empty
  * Display personal notes on slides without instructor notes
  * Update to modern JQuery

0.9.10.9
  * Fixed screen blanker
  * Travis CI fixes from @donv
  * Toolbar icons
  * Add hidden `<h1>` section tag for wkhtmltopdf to use as the [section] header.

0.9.10.8
  * Fixed that irritating double question bug.
  * Made the question dismissal widget slightly less ugly.
  * Incremental bullets are more usable in presenter view.
      * Bullets you haven't gotten to yet are dimmed, not hidden.
  * For that matter, they actually work now.
  * The 'next' window is now resizable.
  * Fixed a couple minor crash bugs.

0.9.10.7
  * Fixed some form rendering issues
  * Handle slide background images better

0.9.10.6
  * Bugfix release: repair breakage from Firefox 34.x
  * minor UI corrections for Firefox

0.9.10.5
  * New popout notes window button in the menubar.
  * Minor bugfixes.

0.9.10.4
  * Bugfix release: don't initialize stats collection unless presenting

0.9.10.3
  * Adds the ability to merge in personal notes to the presenter notes.
    See AUTHORING.rdoc for instructions.
  * Generate valid HTML IDs for slides.

0.9.10.2
  * More robust static content generation--don't prematurely fail if a file
    isn't found.
  * Fixed some form generation regular expressions on Ruby 1.8.

0.9.10.1
  * Continuing on in the grand tradition of rapid point releases, this is
    a minor, yet important, errata fix. Current versions of RedCarpet did
    not work with both instructor notes and `:strikethrough` enabled. This
    release turns `:strikethrough` back off and a future update will rework
    the syntax for instructor notes.
  * Enables static supplemental material generation
  * Output cleaner HTML
  * Allows running without a `showoff.json` config file again.

0.9.10
  * Fresh coat of paint on the presenter view. This uses the CSS3 flexbox
    model, so it's much cleaner and will allow more UI work in the future.
    (thanks to @jolshevski for some of the UI cleanup)
  * Slide menu in the presenter view now follows the current slide.
  * Audience questions can now be dismissed by clicking on them.
  * Smartphone remote view simplified, now with hamburger menu button.
  * Enables more Markdown extensions such as:
    * `autolink`: automatically recognize links
    * `definition_lists`: PHP-Markdown style definition lists
    * `no_intra_emphasis`: mid-word underscores don't screw up formatting
    * `strikethrough`: surround words with `~~` to strikethrough
    * `superscript`: superscript text using `^`
    * `tables`: PHP-Markdown style tables
    * `underline`: Use underscores for underline instead of emphasis

These defaults are documented in AUTHORING.rdoc and can be disabled with some
variation of this in your `showoff.json` file:

    "redcarpet" : {
      "autolink"          : false,
      "no_intra_emphasis" : false,
      "strikethrough"     : false,
      "superscript"       : false,
      "tables"            : false,
      "underline"         : false
    }

0.9.9.1
  * Fix `showoff static` again.

0.9.9
  * Added HTML form support
  * Fixed paging bug
  * Handle trailing slash in presenter view properly

0.9.8.1
  * fix thin dependency so prerelease isn't pulled in
  * add nicer usage messaging

0.9.8
  Merged in several community contributions and added some new features.

  * Add favicon support (@raphink and @jamtur01)
  * Add Docker syntax highlighting (@jamtur01)
  * Add ability to link to named slides
  * Added popup next slide view (@WhatsARanjit)
  * Reinstate ability to host multiple presentations at once (@jcoglan)
  * Added a code review workflow allowing quick material updates.

0.9.7.1
  Changed slave window popup behavior to work better with Chrome's popup
  handling.

0.9.7
  Merged in fixes and new features from upstream in preparation for taking
  over maintainership. I tried to keep attribution wherever I could, but
  I had to massage several commits, and had to re-implement a couple.

  New features:

  * Allows one to set a custom per slide background
  * Adds gherkin syntax highlighting
  * Adds support for the Kramdown markdown engine
  * Allows one to set markdown engine configuration options in showoff.json

  If you notice any regressions please file issues and we'll get them fixed.

0.9.6
  Ports client communication to websockets
  Adds audience interaction
    Pace feedback, slower/faster
    Ask a question
    Provide slide feedback