Step 3: Publish
How Does Calepin Work?
Calepin reads Markdown-formatted, plain-text files stored in your Dropbox and converts them into blog posts for you. You can publish, edit, re-edit, and delete posts just by editing these files and then re-publishing your blog. Calepin does the work of converting these plain-text files into a useable blog, and even generates an Atom feed to allow people to subscribe to your blog in their favourite feed-reader, leaving your free to concentrate on writing.
After logging into Calepin go back to your Dropbox and look for a folder
labeled “Apps”. The Calepin folder should already be there with a sample blog
post. Make sure all your blog posts are plain text. Use a plain text editor
like Byword or Notepad. All files in
.rst filename extension.
All blog posts must carry a date and a title. This is metadata needed by the generator to order and label your posts meaningfully. Format your posts like the screenshot at the bottom of the page, otherwise they may not be picked up by Calepin and won’t be published published on your blog. More details on how to format your posts are in the Calepin Guide.
When you hit the “Publish” button Calepin picks up edits, removals and new posts and updates your Calepin URL to reflect your newest work.
Why Use Calepin?
Because It’s Uncomplicated
Because Markdown Is Easy and Elegant
Markdown “allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid HTML”. You don’t need to learn complex HTML tags, and the syntax isn’t heavy or distracting; you can easily add headlines, subheads, emphasis, links, and footnotes without ended up with a complex, hard-to-read mishmash of tags.
Due to its simplicity and ease-of-reading, Markdown is the ideal syntax for writing essays, long-form journalism, and short stories: none of the complexity of Microsoft Word, but all of the features you’ve come to rely on for serious writing.
Because Dropbox Is Always With You
Dropbox takes care of syncing your writing to all your devices together so you can write and edit posts anywhere. It’s on your desktop, your laptop, and your smartphone, and you don’t need to worry: write a draft on your iPhone and it’s waiting for to put the finishing touches on you on your Mac.
Because Calepin Does All the Hard Work for You
With Calepin, you don’t have any of the complexity normally involved with static site generators. No awkward CLI commands to try and remember, no updates or patches to apply, no server management, no fiddling with RSS feeds. Calepin does this all for you, leaving you to concentrate on the most important part: the writing.
Because You’re Not Locked In
Find something that works better for you? No problem. Your
files are small and portable, and aren’t locked away inside a proprietary
format or hidden away inside an arcane XML file. They’re right there in a
folder you own and control, ready to be used somewhere else if you need
Because You Own Your Writing
Some other blog services claim copyright or unlimited, permanent reuse rights on everything you post on them.
Calepin doesn’t. Not now, not ever.
You retain copyright to everything you post with Calepin, and always will. We won’t reuse it, sell it, or try to take your rights away from you. And if we want to use anything you’ve created in our publicity materials, we’ll ask your permission before we do it.
Calepin currently has no plans for custom themes. Think of it like submitting a short story to a newspaper: the writer’s identity isn’t portrayed through a look and feel — it’s portrayed through their words.
Posts Not Showing Up?
Calepin is picky on posts it processes. Every post must have “Date” and “Title” in the metadata, formatted correctly. Calepin also skips ANYTHING that is not UTF-8 encoded. So make sure your editor handles saving and editing UTF-8 files. Most Mac OS X and iOS editors do this by default. Windows users may need to dig into the editor settings.
Calepin fully supports custom domains for all accounts.
Is Calepin Free
Many users are rightfully concerned about the longevity of their published work. The only way to guarantee it is by making Calepin make sense in the long term to the app creator. In the future, expect Calepin to become a paid service with a free trial or limited account. Right now the service is 100% free. There is no concrete time plan for the paid version.
What Does a Calepin Site Look Like?
What Editors Are Recommended for Markdown?
There’s a lively and growing ecosystem of apps and online tools built with Markdown in mind. MarkdownPad for Windows and Byword for Mac are both good desktop editors; Elements for iPad and iPhone uses Dropbox for storing all its files, and makes a good option for writing on iOS devices.
There are lots of other options, though, so follow @calepinapp on Twitter for tips on writing in Markdown. We always welcome suggestions on which tools to use for writing Markdown.
For more settings and tips read the Calepin Guide.
- Jon Mitchell at ReadWriteWeb has written a nice introduction to Calepin.