Slideshow Plugin

My Favourite Fruit | A Heading | Description | Installation | Usage | Examples | Open Issues | Release notes | Screenshots
Name Slideshow Plugin
Vendor Atlassian Software Systems (Website)
Authors Mike Cannon-Brookes, Bob Swift
Homepage http://confluence.atlassian.com/display/CONFEXT/Slideshow+Plugin
Issue Management http://developer.atlassian.com/jira/browse/SLID
Categories Content Macros
Version 0.3
Availability Confluence v2.0 to v2.10-m1
State Prerelease
Support Unsupported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Slideshow+Plugin
Java API Docs n/a
Download Source n/a
Download JAR slideshow-plugin-0.3.jar

 

Bananas

My Favourite Fruit

Jonathan Nolen

Show Show   Show Show   Show inline

Description

This plugin allows you to construct a PowerPoint-style slideshow inside a Confluence page. The slideshow can be displayed inline, in the page, or in a popup window. The slideshow is pure HTML, and navigation is provided through javascript.

Installation

You need to have System Administrator permissions in order to install and configure plugins.

Installing and Configuring Plugins using the Plugin Repository Client

If the plugin you wish to install is listed in the Confluence Plugin Repository, you can use the Confluence Repository Client to install it. Just find the plugin in the list and click the 'install' link. There's more information in Installing and Configuring Plugins using the Plugin Repository Client.

Installing and Configuring Plugins Manually

If the plugin you wish to install is not listed in the Confluence Plugin Repository, you can still install it by uploading it to your Confluence site:

  1. In the 'Administration' section of Confluence, click the Plugin Repository link.
  2. Click the 'Upload' tab.
  3. Use the 'Browse' button to find the plugin jar you wish to install.
  4. Select the jar file and click 'Open'.
  5. The plugin will be uploaded from your machine to Confluence, and will be automatically installed.

There's more information in Installing and Configuring Plugins manually.

RELATED TOPICS

Removing malfunctioning plugins

Usage

The slideshow plugin uses two macros: slideshow and slide. A simple slideshow would look like this:

{slideshow:Bananas|subtitle=My Favourite Fruit}
{slide:Fruit Is Good}
* Bananas are fruit
* Fruit is healthy
* Therefore, bananas are healthy
{slide}
{slideshow}

Each slide macro you insert will create a new slide in your slideshow. The slideshow can take title and subtitle parameters. The slide macro can take a title parameter/

Documentation

  • See the advanced content section of the notation guide on your installation after you install the plugin
  • copied here for convenience
    {slideshow:Bananas|subtitle=My Favourite Fruit}
    
    {slide:Fruit Is Good}
    * Bananas are fruit
    * Fruit is healthy
    * Therefore, bananas are healthy
    {slide}
    
    {slide:Colours}
    * Unripe ones are {color:green}green{color}
    * Good ones are {color:yellow}yellow{color}
    * Bad ones are {color:brown}brown{color}
    {slide}
    {slide:More stuff}
    h2. A Heading
    * Point
    * *Another* _point_ [home]
    
    h3. Third Level
    # one
    # two
    {slide}
    
    {slide:Charts Are Fun}
    {chart:title=My fruits|type=bar|dataOrientation=horizontal|width=500}
    |||Fruit||Banana||Apple||Raisin||
    |Rank||10|5|1|
    {chart}
    {slide}
    {slideshow}
    

    Provides the ability to collaborate with others in creating slide shows using simple Confluence markup. This takes advantage of the versioning and sharing capabilities of Confluence to make creating and maintaining slide shows productive. Confluence content can be easy included in the flow of the slide show. Slide re-use is simple. Viewers can quickly review the content in full screen or inline mode with no additional software. Parameters can be provided and they will be used to replace parameters in the body prior to rendering.

    Parameters

    title - The title of the slide show. Can also be specified as the default paramter. Default is the title of the page.
    subtitle - An additional title for the slide show. Default is blank.
    authors - A comma separated list of author names. User ids will automatically convert to real names with profile links. Names containing commas must be enclosed double quotes ("). Default is the user that created the slide show page.
    theme - Defaults to the default theme. Valid theme names are default and simple.
    showInline - Default is true. Set to false to hide inline display of charts on the page.
    showLabel - Default is Show. Text for the show and inline buttons.
    hideLabel - Default is Hide. Text for the show and inline buttons.
    inlineLabel - Default is inline. Text for the inline button.
    authorsLabel - Default is blank. Text in front of the list of authors.

    {slide:Fruit Is Good}
    * Bananas are fruit
    * Fruit is healthy
    * Therefore, bananas are healthy
    {slide}
    
    {slide:title=More stuff|hide=true}
    * this slide still needs work
    {slide}
    
    

    Provides the slide content for the slideshow macro.

    Parameters

    title - The title of the slide show. Default is blank. Can also be specified as the default paramter.
    hide - Default to false. Set hide to true to hide the content from the slideshow.

Examples

Open Issues

Atlassian Developer Network JIRA (12 issues)
T Key Summary Reporter Assignee Pr Status
New Feature SLID-3 Add speaker notes capability Bob Swift Bob Swift Major Open
Improvement SLID-5 Add ability to select the slides that are shown from a collection of slides Bob Swift Bob Swift Major Open
New Feature SLID-7 Add ability to provide custom css on a slideshow bases Bob Swift Bob Swift Major Open
Improvement SLID-8 Slide macros outside of a slide show should just show the rendered body Bob Swift Bob Swift Major Open
Improvement SLID-12 Allow more than one slideshow on a page Bob Swift Bob Swift Major Open
Improvement SLID-13 Add showHidden parameter on slideshow macro to override slide hide parameter Bob Swift Bob Swift Major Open
Bug SLID-14 Doesn't display the slideshow correctly when Inserting a table in the slide RIM_Confluence Mike Canon-Brookes (Devsuite) Major Open
New Feature SLID-15 Add a 'export to pdf' button in the slideshow interface. James Mortimer Mike Cannon-Brookes Major Open
New Feature SLID-16 Create a shortcut macro for launching a page as a slideshow. James Mortimer Mike Cannon-Brookes Trivial Open
New Feature SLID-17 Integrate with content refactoring plugin James Mortimer Mike Cannon-Brookes Minor Open
New Feature SLID-18 Create a {slideshow-contents} macro James Mortimer Mike Cannon-Brookes Major Open
Bug SLID-19 Table borders from any slide are shown on ALL slides James Mortimer Mike Cannon-Brookes Major Open

Release notes

0.3

When: 8-Apr-2007
Who: Bob Swift
What:

Atlassian Developer Network JIRA (7 issues)
Key Pr Summary Updated Reporter Status
SLID-11 Major Add support for tables in themes Apr 08, 2007 Bob Swift Closed
SLID-10 Major Enable additional themes Apr 08, 2007 Bob Swift Closed
SLID-9 Major Parameterize buttons for non-english use Apr 08, 2007 Bob Swift Closed
SLID-6 Major Allow simple names to be specified for the author parameter Apr 08, 2007 Bob Swift Closed
SLID-4 Major Add help text Apr 08, 2007 Bob Swift Closed
SLID-2 Major Add option to hide slides Apr 08, 2007 Bob Swift Closed
SLID-1 Minor Option to automatically show inline slide show Apr 08, 2007 Bob Swift Closed

0.2

  • Initial release

Screenshots

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Sep 21, 2007

    Todd Katz says:

    It looks like a toy, but I built a very attractive, highimpact (I hope\!) slide ...

    It looks like a toy, but I built a very attractive, high-impact (I hope!) slide show with your 0.3 version. Nice job!! A couple of things that would be nice to have: color, better handling of things like italics, perhaps scrollbars on long slides, I guess there's a whole world of wants out there. I thought it was a particularly nice touch that you can click anywhere on the slide to go to the next screen. (Right mouse click might as well move you back, eh?) It's a bit awkward to get back to the editor. On the other hand, having the show in one Firefox window and the editing in the other, is very powerful.

     I think the reason why I might prefer this to PowerPoint (in addition to being able to run it off the Internet from any machine) is that editing of the pages is done on a single page. Makes the overall context clearer (at least to me).

     Cheers,

  2. Sep 21, 2007

    Fabio Paiano says:

    This kind of plugin is exactly what my company needs. However, we do not feel co...

    This kind of plugin is exactly what my company needs. However, we do not feel confident in installing such a prerelease version.

    Wouldn't it be possible to evolve it until a "stable"version quickly?

    Also: how much work would it take to create a tool that would export a single Powerpoint slide into a Confluence page? That would complete nicely this slideshow tool.

    1. Sep 25, 2007

      Fennie Ng says:

      Hi Fabio, Due to our commitments with other bug fixtures and new implementation...

      Hi Fabio,

      Due to our commitments with other bug fixtures and new implementations we can't straight away foretell the schedule for this request. Please see this on how we schedule new feature requests. For exporting Powerpoint slide please add your concern and vote for the features request, CONF-7122. Thank you.

      Regards,
      Fennie

  3. Nov 15, 2007

    Andy Brook says:

    This plugin is great for simple stuff.  try to convey too much and the inab...

    This plugin is great for simple stuff.  try to convey too much and the inability to control text size will show up as a weakness, as well as the excessive size of the title bar and nav areas.

    1. Nov 15, 2007

      Bob Swift says:

      Agree. It needs a lot more work to make it more likely to be used over Powerpoin...

      Agree. It needs a lot more work to make it more likely to be used over Powerpoint. Eventually, this plugin will get more attention .

  4. Feb 25, 2008

    Rick Hadsall says:

    Bob, How can I reduce the indent on bullet lists?  It indents double by def...

    Bob,

    How can I reduce the indent on bullet lists?  It indents double by default, resulting in a serious lack of text space compared to PPT on the same size screen...?

    Exceptional plugin.  I'd like to vote for the issue you have in the Atlassian Developer Network JIRA (but I'm not allowed to login) that is to export to PDF - being able to hit a button and export the slide show deck to PDF - one page per slide, as it would appear on the screen - would be a HUGE feature.  HUGE.

    Anyhow.. any input on how I can reduce the bullet indent is appreciated.

    Rick

    1. Feb 25, 2008

      Bob Swift says:

      Have you tried theme=simple or theme=i18n to see if they are better for you? If ...

      Have you tried theme=simple or theme=i18n to see if they are better for you? If you know CSS, you can modify the css files in the jar file under resources. If you come up with a good modification, it can be included in a theme or the default can be changed. Unfortunately, I will not have much time for modification for this plugin for a number of weeks, so you are on your own for a while.

      1. Feb 26, 2008

        Rick Hadsall says:

        I haven't tried theme but I did modify the CSS and it worked splendidly.  T...

        I haven't tried theme but I did modify the CSS and it worked splendidly.  This is a major selling point for Confluence - so don't let this one go too long unfinished!

        Great work.

        1. Feb 27, 2008

          Bob Swift says:

          I would appreciate if you contributed your modifications. Either attach them her...

          I would appreciate if you contributed your modifications. Either attach them here or create an issue with them attached. Thanks.

          1. Feb 27, 2008

            Rick Hadsall says:

            I just changed two lines in pretty.css: Line 44: .slide ul, ol Line 46:...

            I just changed two lines in pretty.css:

            Line 44:

            .slide ul, ol {margin-left: 14px; padding-left: 0; margin-right: 7%; }

            Line 46:

            .slide li {margin-top: 0.55em; margin-right: 0;}

            That seems to work nicely.

  5. Jul 13

    Victor Rodrigues says:

    Does anyone have an example of how to use this plugin to cycle through a bunch o...

    Does anyone have an example of how to use this plugin to cycle through a bunch of images as suggested here?