I needed a way to convert Markdown-formatted text to HTML without any line breaks for writing show notes for podcasts using the Driftwood platform, because it holds the shownotes in the YAML front matter. I wanted to be able to do this on both iOS and OS X.
I haven’t given up on TextExpander, yet1, and so far it is the only option I’m aware of in which I can sync the same macros across all my iOS and OS X devices.
The problem ended up being fairly simple2.
I took the minified version and created a TextExpander snippet of just that code.
Then I made the snippet for the conversion. It consists of only two lines of code. The first calls the Marked library:
and the second takes whatever is in the clipboard, runs it through the marked library, and then removes newlines:
It doesn’t get much simpler than that.
Driftwood is a tool I created to rapidly deploy the necessary tools for publishing a podcast: a website, a podcast formatted RSS feed, and hosting for the files. A secondary goal was to be able to do all this from an iPhone. I was inspired in part by Manton’s microcast Timetable, and from my own use of Jekyll and Github pages to host my blog. My final goal was to be able to “self”-host podcasts that I’m currently paying $100+ a year to a commercial company, especially on one that is mostly retired but not dead.
The demo page can be seen here.
My own page using this template is here.
The Github repository is here.
The concept and execution is simple: Github is used to both host the source files, build the website and RSS feed from those source files using Jekyll, and host the audio files.
The template design for the webpage is clean and elegant, thanks to Kiko by @gfjaru. I made a few tweaks but nothing significant. Since podasts are all about the audio and not the webpage1, I think a simple page is best, and the user can add additional features as needed.
Getting started is simple:
- Clone or fork Driftwood to your own repository.
- Rename it.
_config.ymlwith your information.
about.mdwith your information.2
images/itunes.pngwith your own logo (1400x1400)
audio/ep1.m4awith your own file
- Edit the file in
_postswith your information, date, shownotes, etc.
And your first episode is up!
Add future episodes by adding a new audio file to
/audio/and a new markdown file to
/_posts/making sure to follow the template of the original file.
If you need further information on formatting post pages for Jekyll, you’ll find a lot of information at the Jekyll website or on Google, since the first thing one does after using Jekyll to publish their blog is to write a post on using Jekyll to publish their blog.
Doing it iPhone only
You’ll need one of those apps anyway to upload the audio files and logo because there is no way to upload a binary directly to Github from the browser even on a desktop OS. Edit: Ten days after I wrote this Github announced they’re adding the ability to upload binaries from the browser..
Record your own episode. You can use the built-in Voice Memos app, which is free with very limited editing functionality, or use Ferrite, which is more expensive but very powerful with multi-track editing and other professional features. Again, use one of the above apps to upload it.
Is Github the best place to host audio files?
Probably not. It’s certainly not designed for that and if one makes changes to the files then the version tracking aspect of Git will cause those changes to be saved using up a lot of storage space. File size is limited to 100mb and anything over 50 will likely get a warning. Also, a repository size is soft-limited to 1 gig. In general, these will not likely be an issue, especially for small project podcasts. The purpose of Driftwood is a tool for rapid deployment. If you want to host the files somewhere else, it is a trivial problem. Merely put the full URL for the audio file in the YAML front matter for the episode page and change the podcast.rss file from
<enclosure url="http://soitscometothis.net" length="" type="audio/x-m4a"/>to
<enclosure url="" length="" type="audio/x-m4a"/>. You can Dropbox, S3, Internet Archive, or any other place where you can directly link to the url of your file.
What about using Github Large File Storage for the audio files?
I tried that and it didn’t work. Either I missed something or you can’t really link directly to the file url so it breaks. If you find a way to get it to work, please let me know.
I want to use mp3 files not m4a files.
No problem. Just change the audio type in
Brian Jones recently published a 1Writer script for changing selected text to the title case format of John Gruber.
By removing the last three lines
var selectedText = editor.getSelectedText(); var formattedText = toTitleCase(selectedText); editor.replaceSelection(formattedText);
and replacing them with
Since before I bought my first sailboat several years ago, I’ve wanted a Torqeedo–an elegant, efficient, electric motor.
The benefits of electric engines on a sailboat are numerous. To begin with, there are already many options for generating electricity on sailboats using wind and solar energy, thus providing a consistently renewable source of energy. Electric engines are much quieter, almost silent compared to a combustion engine. There are none of the pungent orders of gasoline and oil.
There is however one major drawback that is astounding and is mentioned in the product video for the engine I bought (starts 41 seconds in):
10 pound lithium battery = 35 grams of gasoline
Still, I think the advantages outweigh the drawback, and I ordered one today, finally.
When content blocking apps were first released for iOS 9, they were of the type that most would expect: all-in-one apps that in theory would block all the bad and none of the good.1 As I expected, developers are now starting to release apps with narrower functionality aimed at a specific task that can be used in addition to a main blocker. Image Blocker blocks images only, thereby speeding up browsing of text only and saving on limited data cap plans.
My new favorite is Twenty One by Greg Fiumara, the developer of Tappd That, a beer tracking app. Twenty One is designed to disable the age verification screens some brewery websites use. It gets its block list from the developers server from an open source list hosted on GitHub. I’ve already updated it with a few rules for some of my local breweries: Devil’s Backbone and St. George.
With variable amounts of minor customization. ↩
« Newer Older »