Using Configuration Commands
With Deckset configuration commands we provide a way to control how your presentation looks and works. Specifically, you get control over content scaling, lists building in, slide numbers and footers.
Each command can be applied in two ways, either globally to effect the whole presentation or per slide to set something new or override global settings.
Let’s take a look at the structure and positioning of commands before going through each possibility in detail.
Global commands are set on the first few lines of your Markdown file (e.g. autoscale: true). When using, be sure that there are no line breaks between any other commands at the top of your Markdown file.
All commands are ‘off’ or ‘false’ globally by default, so you only need to add ‘true’ to each to turn them on to affect all slides.
Per Slide Commands
On individual slides you can turn commands on or override and turn off a globally set command, to do this the command is inserted on a new line and wrapped in two square brackets with a preceding dot. ‘True’ turns a command on: [.autoscale: true]
‘False’ turns a globally set command off: [.autoscale: false].
At times you have to fit more content onto one slide than the default font sizes allow for, Deckset’s autoscale command allows you to fit more text in by scaling the text down.
Globally this is enabled by including the autoscale: true command at the top of your Markdown file. This is best for cases where you have a really text heavy presentation, these might be for printing or work like hand-outs rather than being projected.
Sometimes there is just a little more information that needs to fit on one slide, which is a perfect use for applying [.autoscale: true] to a single slide.
Although it is a rare case, you can turn autoscale off on a particular slide when it is applied globally by adding [.autoscale: false] on the respective slide.
When presenting a list of information, you may want each item to appear one by one. To achieve this with Deckset, use the build-lists: true command.
When added to your presentation, the preview in Deckset looks the same, but when using the Presenter and Rehearsal mode you can see the list build in step-by-step.
You may turn this on or off on an individual slide by declaring [.build-lists: true] or [.build-lists: false] on the respective slide.
To add running slide numbers to your presentation use the slidenumbers: true command. This will add them everywhere including full image slides and titles.
You may turn this on or off on an individual slide by declaring [.slidenumbers: true] or [.slidenumbers: false] on the respective slide. This would help remove clutter and create focus on dramatic slides.
To add a persistent footer to each slide of your presentation, use the footer: My Footer command.
To override your global footer or to add a footer to a single slide, add [.footer: A different footer] to the respective slide.
You may turn off the footer on an individual slide by declaring [.hide-footer] on the respective slide. This is again great for image-only slides or ones where you want to make a big point without distraction.
Storing your theme choice
Deckset does store the theme choice as metadata to the file, but in some cases, this information can get lost, e.g. in version control systems or when sending the file via email.
To make sure the theme choice doesn’t get lost, you can use the following command theme: Merriweather.
If you also want to specify the color choice, you can reference the number of the color swatch as it appears within Deckset e.g.: theme: Merriweather, 4
Please note that this command is a global command, needing to be applied at the top of your Markdown file.
We hope you enjoyed this tutorial and learned something new. Feel free to share your ideas or comments via firstname.lastname@example.org.