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 versionDeckset 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 inline
directive and a closing inline
directive 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
: Impliesverbatim
. 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 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
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size deckset_inline-0.1.0-py3-none-any.whl (8.1 kB) | File type Wheel | Python version py3 | Upload date | Hashes |
Filename, size deckset-inline-0.1.0.tar.gz (9.3 kB) | File type Source | Python version None | Upload date | Hashes |
Hashes for deckset_inline-0.1.0-py3-none-any.whl
Algorithm | Hash digest |
---|---|
SHA256 | a0135622d9709eec93b473677b5b73d15d00128f9eb7c9c1be8898ad787999b5 |
MD5 | 22b628e9856b6891ab10f04dd369394c |
BLAKE2-256 | 854ea71aaa45448a9dbca7aebac351e0bff5ab12130002ca60461c2be2aa1dbf |
Hashes for deckset-inline-0.1.0.tar.gz
Deck Set
Algorithm | Hash digest |
---|---|
SHA256 | c2e3fae535a79eb3a36fd4326b9f0f0512157561108bcdd09eb6bee39788b9f0 |
MD5 | d4374b8e0a74a20c790e0c5808d99a9f |
BLAKE2-256 | c3751fd3369a364ec0fd7460fd83eae8ea2987f54d624302e9d5bfea5d161c80 |