A Sublime Text 2 plugin for saving files to Write.app
Python
Latest commit b333235 Jan 22, 2013 Bill Patrianakos All data is sent over HTTPS now. First production release

README.md

Codename: Island (Beta)

The official Sublime Text plugin for Write.app. Island lets you save notes to Write.app directly from within Sublime Text 2.

Installation

Package Control

Coming Soon

Manual Install

(Only use this if you aren't comfortable with the command line or don't have package control installed)

  1. Download the latest plugin version from GitHub

  2. Unzip the file and place the Writeapp folder in your Packages directory

  3. Restart Sublime Text and you're ready to go!

Can't find the folder?

Windows: %APPDATA%\Sublime Text 2

Mac: ~/Library/Application Support/Sublime Text 2

Linux: ~/.config/sublime-text-2

Via Git

  1. In a terminal window, navigate to your Packages folder (locations for each platform are listed above).

  2. Run git clone https://github.com/WrtApp/Island.git Writeapp

  3. Restart Sublime. You're done.

Usage

Setup

Before you can use the plugin you have to add your username and password to your User settings file. Add the following lines to the JSON that may already be there:

"writeapper_user": "yourUsername",
"writeapp_pass": "yourPassword"

If your User Settings file is empty, use this code instead:

{
    "writeapper_user": "yourUsername",
    "writeapp_pass": "yourPassword"
}

Saving notes

There are two ways to save notes; through a kayboard shortcut or the context menu.

So save the contents of the currently open file to Write.app just press alt+s. You can also right click anywhere inside the open file and choose "Save to Write.app".

Note: Currently there's no way to update notes. If you save the same note using this plugin twice, two separate notes will be created. This will change with further development. Also, you must first save what you are working on to disk. Currently the plugin can only send data that has already been saved. This will also change with future development

Setting titles and other options

Island uses YAML front matter to determine how to save your note. At the beginning of your file enter your desired settings and Write.app will take care of the rest. Here's an example note with all of the currently proposed settings:

---
title: My title
public: true
notebook: my notebook
---

This is the content of my note

YAML is not required. If you save a note without YAML front matter then it will automatically be saved to your default notebook as an untitled note. Adding preferences to the YAML front matter that don't exist in the app does nothing. They will just be ignored. You do not need to include all possible settings in your front matter. For example, if you only wanted to set a title or only wanted to set the note to be publicly visible but nothing else you would only add the lines you need to the note. Missing settings are considered false and have sane defaults.

Accepted YAML Front Matter Settings

title: A string of text. Defaults to "Untitled-{random-chars}" if empty or missing.

public: Boolean. Accepts values "true" or "false". Defaults to "false" if empty or missing. Anything other than "true" or "false" results in the app turning it into a FALSE.

More settings to come.

Checking if your note was saved

You don't have to log into your account to see if your note was successfully saved. You can view the output from within Sublime Text. Here's how:

  1. Press ctrl+\`

This will open a pane that shows the output of the plugin. Open this before or after running the plugin to see a success or error message.