Deckset



My workflows have changed since I wrote my entry: “Why I Use Plaintext” in June 2012. The entry was about avoiding the distraction of Microsoft Word and Apple Pages while writing. At the time I wrote the entry there was no Ulysses. Now I use Ulysses for almost all my short-form writing. In 2012, there was no iOS version of Scrivener. Now I use Scrivener for all my long-form writing. Although technology has changed, some things have not. I still dislike bloated software packages that get in the way of my final goal. I still love Plaintext / Markdown.There is another requirement of my job that relies just as heavily on bloated software-presentations. Speeding up the development of a presentation is the focus of this entry.Presentations are used throughout business and academia to transmit ideas. Some influential thinkers, such as Edward Tufte, argue bulleted presentations shouldn’t be used at all. The reality is that presentations are deeply ingrained in business and academia. Many presenters rely too heavily on the glitz offered by the software at the expense of content. It’s easy to get lost in software features—spending hours tweaking backgrounds, transitions, and text placement.Which brings me to Deckset. Deckset is an amazing application for iOS that converts Markdown files into presentations. As this review of Deckset 1 in Macworld says: “It’s designed for the average person who needs to make beautiful slides without the muss and fuss of Keynote or PowerPoint.” With the release of Deckset 2 and its outstanding features, the application has become my go-to application for rapid preparation of presentations. Because Deckset uses Markdown, I find myself concentrating less on making my slides look attractive and more on content. Deckset works seamlessly with Ulysses, allowing me to quickly edit my presentations on my phone, my tablet, or my Mac. (You can use any text editor with Deckset. If you plan to use Ulysses, check out these helpful tips).I recently used Deckset to develop a new 30 minute presentation. I estimate the presentation took about 1/4 the amount of time to develop versus Keynote. The cost for Deckset 2 is $29 (with educational discounts available).Here is a link to the Deckset manual.

Latest version

Deckset is described as 'Great-looking slides from simple Markdown files. Write down your thoughts in your favourite text editor, and Deckset will turn them into beautiful presentations' and is an app in the Office & Productivity category.

Released:

  • Deckset doesn’t seem to like Emacs auto-fill very much (like Marked.app, in fact), and I had to unfill all paragraphs in the original Markdown file. On the Pro side, Deckset is easy to use and it provides live preview, much like Apple Keynote.
  • Deckset 2 Great-looking slides from simple Markdown files in no time Write down your thoughts in your favourite text editor, and Deckset will turn them into beautiful presentations.

A tool to inline content in a Deckset Markdown file

Project description

Include content from other files in your Deckset slides.

Okay how?

Deck Setting

First install the tool:

Then prepare a file from which you want to include some content. This is a_file.py:

Then add an opening inlinedirective and a closing inlinedirective to your presentation Markdown file, where you want the content to appear:

Then run the tool with your presentation file:

See how your file has been modified in-place, and you now have the lines 2 to 3 of a_file.py included between the directives:

See how the directives stay? You can now run the command again after you change the source files.

I see, but why?

Swords and sandals 2 unblocked. I want to test the code that I put in my slides, so I write it in proper code files that I then run and test (Yes, I sometimes write tests for the code in my slides). If I find an issue with the code, I don't want to be copy-pasting code into the slides again. This tools takes care of that for me.

Okay, I want this, tell me more

Welcome!

Directives are one line HTML comments with a home made tag inside. The basic directive has the tag name inline and these are the available attributes:

  • src: The only mandatory attribute, it specifies the path of the file to include.
  • verbatim: A flag. When present (it takes no value), the included code will be surrounded by lines with 3 backtics each ```
  • lang: Implies verbatim. Specifies the language that will appear at the top of the backticks block.
  • start: The first line of the source file (counted starting at 1) that will appear in the block.
  • end: The last line of the source file (counted starting at 1) that will appear in the block.

For convenience, I've added a second directive called python, which is equivalent of setting lang='python' on an inline directive.

Deckset

Deckset Columns

The tool puts its output on stdout by default, like sed does, only if you pass the -i (--in-place) flag it will modify the original file. I recommend you also use the -b (--backup-ext) flag to force the creation of a backup of your file, if you aren't using version control for your slides.

There is also an option (-c or --clean) which deletes all the content between opening and closing directives, while leaving the directives themselves intact.

Any caveats?

  • The inline operation is not recursive, and the tool will not handle well if you include files that contain other directives.
  • The parsing is quite rudimentary and line based, so directives cannot span across multiple lines.

Release historyRelease notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Patio Deck Set

Files for deckset-inline, version 0.1.0
Filename, sizeFile typePython versionUpload dateHashes
Filename, size deckset_inline-0.1.0-py3-none-any.whl (8.1 kB) File type Wheel Python version py3 Upload dateHashes
Filename, size deckset-inline-0.1.0.tar.gz (9.3 kB) File type Source Python version None Upload dateHashes
Close1989 upper deck set

Hashes for deckset_inline-0.1.0-py3-none-any.whl

Hashes for deckset_inline-0.1.0-py3-none-any.whl
AlgorithmHash digest
SHA256a0135622d9709eec93b473677b5b73d15d00128f9eb7c9c1be8898ad787999b5
MD522b628e9856b6891ab10f04dd369394c
BLAKE2-256854ea71aaa45448a9dbca7aebac351e0bff5ab12130002ca60461c2be2aa1dbf
Close

Hashes for deckset-inline-0.1.0.tar.gz

Deckset

Deck Set

Hashes for deckset-inline-0.1.0.tar.gz
AlgorithmHash digest
SHA256c2e3fae535a79eb3a36fd4326b9f0f0512157561108bcdd09eb6bee39788b9f0
MD5d4374b8e0a74a20c790e0c5808d99a9f
BLAKE2-256c3751fd3369a364ec0fd7460fd83eae8ea2987f54d624302e9d5bfea5d161c80