This is a simple bash script that takes a markdown .md document and publishes it directly to your blot folder. If you don’t have citations in your post, there is less of a need to run this script. However, blot doesn’t convert markdown to html perfectly and so this script means you can use the full wealth of pandoc’s markdown conversion abilities and set proper HTML before dumping it into your blot folder for publications.

Download the script from github

It needs a little preparation.

• open the script in a script editor such as atom or xCode
• setup the path to your blot directory, mine is here, yours is probably the same:
  • ~/Dropbox/Apps/Blot
• setup the path to your .csl style document (how pandoc makes your citations look)
  • e.g. cslPath="$dropboxPath/bibliography/journal-of-new-music-research.csl"
• similarly setup the path to your .bib file
  • e.g. "$dropboxPath/bibliography/bibliography.bib"

When you’ve done that, save the script somewhere sensible.

The script assumes that you’re already using pandoc and pandoc-citeproc to render useful documents from markdown.

dependencies

• pandoc http://www.pandoc.org/
• pandoc-citeproc https://github.com/jgm/pandoc-citeproc
• a pucker .bib file (made with zotero or something) https://www.zotero.org/download/
• a bib csl style, download from here: https://www.zotero.org/styles/
• something nice to write markdown with, atom is lovely: https://atom.io/
• realpath available in the OSX core utils from brew brew install coreutils
• rsync to enable flawless updates from your source directory brew install rsync

usage example

• cd to/the/directory/with/your/markdown
• bash /path/to/script/p2b.sh inFileName.md '[subfolder]/[subsubfolder]'
• eg: bash ~/Dropbox/shellScripts/p2b.sh example.md '[teaching]/[soundtracks for screen]'

note

The script will copy an images, sounds and videos folder across to the relative directory in blot. If you have other things like files this goes to the root directory instead. Any images you refer to in your canonical document will be copied across. Bear in mind however that if you don’t place an _ (underscore) in front of image names, they will be published as blog posts as well. I have taken to naming my files thus: _image.png.

Have fun.., oh and here’s some citations to be sure that the script is working properly for this post. Notice, that in markdown, I’ve added a final section #References. Citations will show up underneath this (Parker, 2018), (MacFarlane, 2019), (Smalley, 1994).

References