Home > Uncategorized > Dokkit vs Blog entry

Dokkit vs Blog entry

November 10th, 2008 Leave a comment Go to comments

I have a problem how do I work both online and offline on my blog? If you look at say Fowler’s Bliki then he is clearly composing offline and then publishing. Looking in the Ruby world, and having had a previous life writing documentation, I looked at Rote and then Dokkit. I thought that I was writing something more like a book in structure. First, forget Rote as it seems to have been discontinued – and has a known bug with the latest version of Rake that still hasn’t been patched. Plus, you tend to need to install RMagick too (all too much time). And Dokkit works well. Dokkit creates websites from individual pages and can be published to multiple formats (text, html, pdf). I thought that I could leverage this because I wanted to write some tutorials as well as entries and could publish them in multiple formats. I found a couple of problems for me (rather than of Dokkit):

  • I wanted to publish to WordPress and Dokkit uses Deplate as it markdown
  • There is no TextMate bundle available (editing or publishing)

Once I started to actually write the Textmate bundle, I found that in fact what I wanted to do was use the Blogging bundle in Textmate. All I need to do is create Blog entries and publish them individual. And that is what this entry is done in. Now, I have a directory of entries that I can update offline, are in source control and are publishable.

Main steps using Blogging bundle in Textmate and publishing to WordPress

Setup WordPress credentials

  • Bundles » Blogging » Setup Blogs
  • Enter in your Word press username and site as per the instructions

Create your file

  • Start up Textmate
  • File » New From Template » Blogging » Blogging Post (Textile|Markdown)
  • Save
  • Make your updates
  • Update your headers: Bundles » Blogging » Headers » add as needed (If you want categories then you will have needed to already setup from the previous set – cat and then tab)

Note: to get the tab triggers to work I had to change the scope selector adding textile to make it text.html.textile.

For example:

Title: Dokkit vs Blog entry
Blog: norockets
Keywords: 
Tags: 
Comments: On

I have a problem how do I work both online and offline on my blog? If you look at say Fowler's "Bliki":http://www.martinfowler.com/bliki/ then he is clearly composing offline and then publishing. Looking in the Ruby world, and having had a previous life writing documentation, I looked at "Rote":http://rote.rubyforge.org and then "Dokkit":http://dokkit.rubyforge.org. I thought that I was writing something more like a book in structure. First, forget Rote as it... 

Checkin/Commit your work

I’m using Bazaar – otherwise there is SVN and Git. Personally, I need to back it up at some stage too because Bazaar isn’t centrally located for my personal work (I rsync it to another server)

Publish to WordPress and check

This is all via the Blogging bundle

* Preview first 
* Post to Blog
* View online version

Migration issues

If you have previously created blog entries but don’t have them locally the Blogging bundle can let you pull those down easy too

* Fetch Posts 
* Select from the returned list
* Save
Categories: Uncategorized Tags: , , ,
  1. No comments yet.
  1. No trackbacks yet.