Automation: Getting Your Words From Scrivener (iOS) into WordPress

Like many out there, I’ve been enjoying the heck out of Scrivener for iOS. The portability, the familiarity with the desktop client, the functionality therein… we all know it was taking its sweet time getting here, but I think we can all agree that the finished product surpassed our expectations.

One thing I was curious about though, was how I could port my original blogging methodology in Scrivener for the desktop, to Scrivener on iOS. I was even more curious as to whether there were even better ways to blog with it on the go, since iOS hardware is so damn portable.

Luckily there is, and I wanted to share it with the folks that may not know.

A little help from the iOS app ecosystem…

Out of the box, Scrivener doesn’t export text to blogs and it shouldn’t. That’s not its core purpose. For me at least, this omission of functionality wasn’t a let down. The good news though, is that there are plenty of apps out there that can pick up the slack in this regard and the one that did this best for me was an app called Workflow.

Now Workflow could merit its own post worth thousands of words alone. I’ll save you the geeked-out deep-dive though and simply say that, as its name suggests, Workflow is a universal iOS app that provides automated workflows for you on your iOS devices. It can accomplish a shocking amount tasks without a jailbreak and one of those tasks is exporting text from any iOS app to your WordPress blog via an action extension.

Keeping it simple so you can get back to blogging…

Instead of walking you through the process of how to create this workflow within the app, the kind developers of Workflow allow you to share your workflows via URL schemes. So all you should have to do is buy the app (on sale right now at a steal for $2.99 USD) and click this link here to install the workflow I created for you all, automagically! After the workflow shows up in the Workflow app, all you have to do hook up your blog to the workflow (by providing your login credentials) and tweak the settings within the workflow to taste.

I personally have mine setup to output to draft mode, allowing me to manually add a title and categories/tags before publishing live on my site. You can set it to however you like though.

Also, for all of you markdown lovers, I have set this workflow up to create markdown from rich text! So get on up and get your MD on!

“Sounds great! Got it all installed. How do I use it though?”

Once you have everything setup the way you like, all you have to do in Scrivener is simply write your post. Once that’s complete do the following:

  1. Highlight all of your text and copy it. Then tap the “Share” option.
  2. On the share sheet that pops up, look at the action extensions (bottom row) and look for the option to “Run Workflow”. This will then bring up the Workflow automations you currently have, one of which will be the Workflow you got from this post. Protip: If “Run Workflow” isn’t showing up, scroll all the way to the right of that row. Tap more. And add that option from the list that shows up of available actions.
  3. Just tap that, fill out any field prompts, and let Workflow do its thing!
  4. Once the workflow finishes, log into your site and verify everything is published as expected.
  5. Enjoy more blogging from your favorite writing app on the go!

That’s it! If you have the official iOS app for WordPress you can actually blog completely desktop free from any iOS device at your disposal! Pretty awesome right?!

So, from the top, here’s what you need to make this all work:
  • A phone or tablet the runs iOS.
  • Scrivener for iOS (though, this Workflow can work with ANY text editor on iOS).
  • Workflow (it’s universal so you just buy it once and it works on iPad or iPhone. Workflows will sync between the two devices as well.)
  • WordPress for iOS (if you want to not think about blogging on a desktop again.)

New Year? New Coat of Paint.

I am happy to introduce version 4.0 of thaddeushunt.com!

I don’t know if doing a theme redux is an annual thing for me honestly. This year though, it felt right.

I typically don’t get into much personal stuff anymore on this site and that isn’t going to change this year. Suffice it to say though, between quitting my corporate job to work for myself full-time and all of the upheaval therein, 2014 was quite a year for me (don’t worry, 98% of it was all good things).

So in tribute to that change, I thought I’d redo the theme on my personal site too. Truth be told, I was already 75% of the way through a 100% original theme of my own making when WordPress’ “Twenty Fifteen” theme dropped. I wasn’t keen on it at first, but then I got to play with it and saw the potential. This site has always been about its content, so when I saw how this theme put your words front and center, I started entertaining a child theme. Fast forward a month later and you have what you see here. The changes I made from the parent theme were subtle. Mostly font-based, with a tightening up of some spacing/layout issues that bugged me.

My aesthetic leanings are often toward flat, uber-clean design. With easy to read fonts and nothing garish. As you can see, I ditched the header images and horizontal nav/search of the last theme for a more vertical layout, giving more room for my words and cleaner edge-to-edge featured images in my posts: something that I hardly every did in the last theme because it made everything too busy. I also really love the responsive design that is baked into this theme. It retains the look and feel of the big screen version well and offers a much superior mobile menu to themes I’ve used in the past.

Anyways, I think it’s about 95% there, with only a few things left that are bugging me still. Not enough to hold off implementing it live into the wild. I hope you all like it and that it makes reading a here that much more of a joy.

Please feel free to kick the tires. If you find anything broken or “off”, please leave me a note in the comments below. I’ll look into it as soon as I am able.

Happy New Year everyone!

~Tad

Writing: Scrivener as a complete Blogging System

About a month after I used Scrivener to finally finish a novel I started years ago, I got the idea of trying to use it as not only a staging area for posts here on my blog, but also as an infrastructure and archive of it as well. My system is admittedly quite basic, but I thought I would share it as it’s become critical and amazingly helpful since I’ve set it up. I figured the more basic it is now, the easier it would be for you all to adopt; modifying it to fit your needs.

Here goes…

Each Project is a Year

Project Year

Start a new project in Scrivener (File > New Project or shift-command-N on the Mac), choose a project template (whatever you are used to), and change the title to the year you are writing in. I originally thought I would call it “Posts” but, for me anyways, it quickly became too unwieldy and chaotic. I wanted this system to be simple yet powerful, not muddied with years of content.

Each Month is a Folder

Folder Month

I chose to break my posts into months but it would be just as easy to make each folder a site topic or category. I personally like months because I can generally remember about when chronologically I wrote a post. Also, if I search my blog and find it, it makes the post that much easier to find in my Scrivener project.

This is also a great opportunity to shift to corkboard view and add notes to each month so that you can either see what you wrote about at a glance, or maybe attach a note about a life event that occurred that effected your writing at the time. It’s up to you (obviously). Sometimes I don’t add anything, but I am glad I have the option when I do.

Believe it or not, this is the core structure of my blog writing system in Scrivener – a project is a year, a month is a folder.  Once this is set up, open the month you are currently in and create a new document.

Each Document is a Post

Document Posts

Here’s where your writing comes in. You can keep it simple and write the entirety of your post, save it, and then copy and paste the text into your blog of choice. Or you also have the opportunity to leverage Scrivener to its fullest! A lot of folks use Scrivener for short and long form writing and they should, there’s nothing out there that is better for that. But one of Scrivener’s secret weapons is its ability to export MultiMarkDown into clean and precise html. Which is perfect for a blog’s built-in text editor.

If you are familiar with markdown syntax, it’s a huge shortcut for exporting your writing easily into perfectly formatted html code (what your browser reads and translates into a web page). If you are interested in learning it, you can find everything you need to know right here. The learning curve is far from steep and it could save you a ton of time going forward.

*UPDATE* 09/27/13 – If you are interested in getting Scrivener setup to export MMD markup, I posted a companion piece to this post walking you through how to do so.  You’ll find it right here.

Markdown Export

Of course if you are not into learning that kind of stuff, that’s cool too. You don’t have to. A lot of blogging platforms handle copy and pasting text from word processors into their WYSIWYG editors quite well now, parsing your pasted text into HTML the best that it can. Still, the clean code that Markdown generates eliminates a lot of guess-work (and potential html clean up when a blog editor translates your text incorrectly) and I am immensely grateful that the kind folks at Literature and Latte had the foresight to see a need for it from their customers.

Ok, enough about my love of markdown! There are other tools you can leverage that cater very nicely to blogging. Many of these I am sure you are already familiar with, but I figured I’d hit them anyways.

Word Targets

Word Target

When I blog I like to set a word count target. Generally in Scrivener this is a goal for you to strive for, but with blogging it’s particularly great to know when you should start wrapping things up or stop completely and jump into edit mode. I like to think of it as the warning track on a baseball field giving you a heads up before your run head-long into a wall, or in the case of blogging, becoming too verbose.

Synopsis and Document Notes

Synopsis Notes

I often like to use the coveted right column in Scrivener to add notes, reference external links/topics, or even other posts that this post is linked to on my blog… just about anything else that is useful to you the author, but not necessary for your readership.

It’s a little extra work for you, but helpful at-a-glance down the road.

Corkboard View For Your Posts

corkboard view

This is something that, once you use it, you are always giving yourself a high-five in the future for doing so. I can’t tell you how many times this view in Scrivener has saved me from digging into pages and pages of text to find that one post that I wrote about topic “X”.

On each card, I add the date it was posted and a very brief synopsis. Make it part of your workflow, you will not regret it.

ProTip – if you do utilize Scrivener’s right column and fill out the synopsis field, the cork board view uses that text as the content displayed on the card.

Meta-Data

metadata

I may be getting a little too much “in the weeds” on this one but, I thought I’d throw it out there nonetheless. As you add more and more posts, you may want to consider assigning meta-data or “tags” to the content you produce. This will help organize your content a lot more efficiently and make it all infinitely more searchable in the future.

Start with broad topics and then hone in from there.

Many of you won’t need this, but Scrivener does such a bang-up job of its implementation of it, I thought I’d mention it.

What You End Up With

As with my long-form writing, Scrivener provides me with a one-stop-shop writing platform for my blog. If it could actually export to my blog (WordPress), that would be amazing! But don’t let that tiny quibble keep you from trying this idea out. With a little bit of groundwork applied up front, you get all of your writing organized and searchable, post by post, month by month, year by year.

One last perk? Exporting a project and getting an entire year’s worth of posts in pdf or epub format. Flipping through a retrospective of the last 365 days of your creative life is surprisingly satisfying to view on a tablet or even printed out if you want to feel the literal weight of your work.

Sort of like a yearbook for your blog! Only without the awkward interactions of asking for classmates to sign it. ;)