Using the Notebook Present extension (AEN 4.2.0)
================================================

.. raw:: html

    <p>The AEN Notebook Present extension turns your notebook into a Microsoft
    PowerPoint-style presentation.</p>
    <p>The Present extension adds 2 buttons to Notebook&#8217;s menu bar&#8212;Edit Presentation
    and Show Presentation:</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present1.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present1.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    <p>To begin using Notebook Present, click the Edit Presentation button.</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present2.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present2.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    <p>The Notebook Present sidebar is displayed on the right side of your browser:</p>
    <p>Clicking each icon changes the menu and layout of your notebook.</p>
    <p>Clicking the Help icon displays 3 tours&#8212;demonstrations&#8212;of the main features
    of Present:</p>
    <ul class="simple">
    <li><a class="reference internal" href="#pres-intro"><span class="std std-ref">Intro tour</span></a>.</li>
    <li><a class="reference internal" href="#pres-slides"><span class="std std-ref">Slides tour</span></a>.</li>
    <li><a class="reference internal" href="#pres-editor"><span class="std std-ref">Editor tour</span></a>.</li>
    </ul>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present3.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-present3.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    <p>Select one of the tours to view a short presentation regarding the specifics of
    that feature.</p>
    <div class="section" id="intro-tour">
    <span id="pres-intro"></span><h2>Intro tour<a class="headerlink" href="#intro-tour" title="Permalink to this headline">¶</a></h2>
    <p>The Intro tour is a 2-minute presentation that explains how to use the main
    features of Present, including a description of each button&#8217;s purpose.</p>
    <p>NOTE: At any time, you can pause, go back to the previous or move forward to the
    next slide.</p>
    <p>The following information is covered in the Intro tour:</p>
    <ul>
    <li><p class="first">App Bar&#8212;When Authoring, this allows you control the content and style of your presentation. It also can be used to activate several keyboard shortcuts for editing:</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-shortcuts.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-shortcuts.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Stop Authoring&#8212;Clicking the Edit Presentation button again stops Authoring, and removes all keyboard shortcuts.</p>
    </li>
    <li><p class="first">Show Presentation&#8212;If you just want to run your presentation without using any Authoring tools, just click the Show Presentation button.</p>
    </li>
    <li><p class="first">Presenting/Authoring&#8212;Once you&#8217;ve made some slides, start Presenting, where you can use most Notebook functions with the Theme we have defined, as well as customize slides on the fly.</p>
    </li>
    <li><p class="first">Slides button&#8212;Slides, made of Regions linked to Cell Parts are the bread and butter of any presentation, and can be imported, created, linked, reordered, and edited here.</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-slides1.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-slides1.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Theming&#8212;Theming lets you select from existing colors, typography, and backgrounds to make distinctive presentations. The first theme you select will become the default, while you can choose custom themes for a particular slide, like a title.</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-themes.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-themes.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    </li>
    <li><p class="first">Saving&#8212;Whenever you save your Notebook, all your presentation data will be stored right in the Notebook .ipynb file.</p>
    </li>
    <li><p class="first">Downloading&#8212;After you&#8217;ve made a presentation, you can download it as an HTML page by choosing Download → Download As: Presentation (.html) in the menu.</p>
    </li>
    <li><p class="first">Help&#8212;Activate Help at any time to try other tours, connect with the Present developers and community, and other information.</p>
    </li>
    </ul>
    </div>
    <div class="section" id="slides-tour">
    <span id="pres-slides"></span><h2>Slides tour<a class="headerlink" href="#slides-tour" title="Permalink to this headline">¶</a></h2>
    <p>Slides make up a presentation. Clicking Slides toggles the sorter view and the
    Slide Toolbar on and off:</p>
    <div class="figure">
    <img alt="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-slides2.png" src="../../../../../../_images/ae-notebooks/4.2.0/nb-ext-slides2.png" />
    </div>
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    <p>The Slides tour explains how to create and manage slides, including the
    following information:</p>
    <ul class="simple">
    <li>Slide Toolbar&#8212;Create a new slide. Clicking + Slide will offer some choices for creating your new slide.</li>
    <li>Import&#8212;The quickest way to create a presentation is to import each cell as a slide. If you&#8217;ve already created slides with the official slideshow cell toolbar or RISE, you can import most of that content.</li>
    <li>Template Library&#8212;You can create a presentation from an existing template.<ul>
    <li>Reuse Slide as Template&#8212;You can create a presentation based on an existing slide.</li>
    <li>Simple Template&#8212;A common template is the Quad Chart, with four pieces of content arranged in a grid.</li>
    </ul>
    </li>
    <li>Region&#8212;The Quad Chart has four Regions. To select a region, click it.<ul>
    <li>Link a Region to a Cell Part&#8212;Each Region can be linked to a single Cell Part using the Link Overlay, which shows all of the parts available.<ul>
    <li>Cell Part: Source (blue)&#8211;Source, such as code and Markdown text.</li>
    <li>Cell Part: Outputs (red)&#8211;Outputs, such as rich figures and script results.</li>
    <li>Cell Part: Widgets (purple)&#8211;Jupyter widgets, interactive widgets that provide both visualization and user input.</li>
    <li>Cell Part: Whole (orange)&#8211;Finally, a Whole Cell, including its Source, Widgets and Outputs can be linked to a single region.</li>
    </ul>
    </li>
    <li>Unlink a region from a Cell Part&#8212;Unlinking removes the connection between a region and a cell part, without deleting either one.</li>
    <li>Region: Trashing&#8212;Trashing a Region permanently deletes it, without affecting any linked Cell Part.</li>
    <li>Part Thumbnail&#8212;We&#8217;ll try to draw a part thumbnail. It can only be reliably updated when a linked Cell Part is on-screen when you mouse over it, but you should usually be able to get an idea of what you&#8217;re seeing. The colors of the regions correspond to the cell types.</li>
    </ul>
    </li>
    <li>Presenting&#8212;Clicking the Present button while editing brings up the Presenter with editing mode still enabled:<ul>
    <li>Linked inputs and widgets are still interactive.</li>
    <li>Go forward&#8212;Click to go to the next slide</li>
    <li>Go back&#8212;Click to go back to the previous slide</li>
    <li>Go back to the beginning&#8212;Click to go back to the first slide</li>
    <li>My work is done here&#8212;Click to go back to the Notebook.</li>
    </ul>
    </li>
    </ul>
    </div>
    <div class="section" id="editor-tour">
    <span id="pres-editor"></span><h2>Editor tour<a class="headerlink" href="#editor-tour" title="Permalink to this headline">¶</a></h2>
    <p>Once you&#8217;ve made a few slides, you&#8217;ll likely want to customize them. The Editor
    tour explains how to edit your notebook, including the following information:</p>
    <ul class="simple">
    <li>Editing Slides&#8212;Activate the Slide Editor by double-clicking it, or by clicking Edit Slide.</li>
    <li>Region Editor&#8212;Click to drag Regions around and resize them.</li>
    <li>Region Tree&#8212;Reorder Regions and see the details of how Regions will show their linked Parts.</li>
    <li>Add Region&#8212;Add new regions.</li>
    <li>Attribute Editor&#8212;Edit the properties of a region.</li>
    <li>Data Layouts&#8212;In addition to manually moving regions, you can apply these layouts to automatically fill your slides.</li>
    <li>More Regions&#8212;Add more regions&#8212;with a weight of 1.</li>
    <li>Tree Weight&#8212;Make a Region bigger or smaller, based on its relative weight.</li>
    <li>12 Grid&#8212;A compromise between the Free and Treemap layouts, the 12 Grid option rounds all of the values in a layout to a factor of 12.</li>
    </ul>
    </div>
