ppl 4.0.3 → 4.0.5

data/gh-pages/_layouts/integration.html

@@ -1,44 +0,0 @@
-{% include header.html %}
-
-<div class="integration">
-
-<div class="row">
-
-  <div class="span4 command-list">
-    <h2>
-      Integration
-    </h2>
-
-    <ul class="nav nav-list">
-      <li{%if page.integration == "bash"%} class="active"{% endif %}>
-        <a href="{{site.url}}/documentation/integration/bash">Bash</a>
-      </li>
-      <li{%if page.integration == "google"%} class="active"{% endif %}>
-        <a href="{{site.url}}/documentation/integration/google">Google</a>
-      </li>
-      <li{%if page.integration == "mutt"%} class="active"{% endif %}>
-        <a href="{{site.url}}/documentation/integration/mutt">Mutt</a>
-      </li>
-      <li{%if page.integration == "zsh"%} class="active"{% endif %}>
-        <a href="{{site.url}}/documentation/integration/zsh">ZSH</a>
-      </li>
-    </ul>
-  </div>
-
-  <div class="span8">
-
-    {% if page.title %}
-      <h2>
-        {{page.title}}
-      </h2>
-    {% endif %}
-
-    {{content}}
-  </div>
-
-</div>
-
-</div>
-
-{% include footer.html %}
-

data/gh-pages/_layouts/news.html

@@ -1,2 +0,0 @@
-{% include news.html %}
-

data/gh-pages/_layouts/page.html

@@ -1,6 +0,0 @@
-{% include header.html %}
-
-{{content}}
-
-{% include footer.html %}
-

data/gh-pages/_layouts/tip.html

@@ -1,2 +0,0 @@
-{% include tip.html %}
-

data/gh-pages/_posts/2012-01-15-first-post.md

@@ -1,16 +0,0 @@
----
-title: Version 1.0.0 released
-date: 2012-12-12
-layout: news
-section: news
-categories: [news]
----
-
-After a solid month or so of work, the first stable version of ppl has been
-released to the public. This version includes the ability to store contacts'
-names, organizations, email addresses, phone numbers, and birthdays.
-
-It's by no means feature complete at this stage, and the
-[roadmap](/development/roadmap) has details of the known deficiencies in this
-release.
-

data/gh-pages/_posts/2012-12-20-1.0.0.md

@@ -1,19 +0,0 @@
----
-title: 1.0.0
-summary: First public version
-date: 2012-12-20
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.0.0.html
----
-
-This is the first publicly-announced release. Since none of the previous
-releases have been publicised in any way, it's assumed that nobody out there has
-been using them.
-
-This being the case, the changelog entry for `1.0.0` is effectively the set of
-all changes since the non-existence of the program until this version. So let's
-put that in list form as seems to be customary in changelogs:
-
-* ppl now exists

data/gh-pages/_posts/2012-12-20-1.1.0.md

@@ -1,28 +0,0 @@
----
-title: 1.1.0
-summary: Hacker News feature requests and bugfixes
-date: 2012-12-20
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.1.0.html
----
-
-These are some very quickly added changes resulting from this morning's exposure
-on [Hacker News](http://news.ycombinator.com/item?id=4947047). A few real
-show-stopping bugs have been fixed, and a new feature has been added for mutt
-users.
-
-Many thanks to [@storge](https://github.com/storge) on GitHub for all the help
-fixing the long series of issues in [Issue #1](https://github.com/hnrysmth/ppl/issues/1). You absolute legend.
-
-Also, thanks to [7h0ma5](http://news.ycombinator.com/user?id=7h0ma5) on HN for
-the [mutt integration suggestion](http://news.ycombinator.com/item?id=4947256)
-and the helpful documentation link. Support for usage as the backend to mutt's
-`query_command` option has been added in the form of [ppl
-mutt](/documentation/commands/mutt).
-
-* Fixed missing dependency declaration in gemspec
-* Fixed missing minimum ruby version in gemspec
-* Fixed completely broken and useless `ppl init` command
-* Added `ppl mutt` command

data/gh-pages/_posts/2012-12-20-1.2.0.md

@@ -1,18 +0,0 @@
----
-title: 1.2.0
-summary: ppl post
-date: 2012-12-20
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.2.0.html
----
-
-A relatively small release in terms of new functionality, `1.2.0` simply adds
-the [ppl post](/documentation/commands/post) command. This command was always in
-the pipeline, but thanks anways to
-[nicky0](http://news.ycombinator.com/user?id=nicky0) on Hacker News for
-[prompting me](http://news.ycombinator.com/item?id=4947468) to prioritise it
-slightly.
-
-* Added `ppl post` command

data/gh-pages/_posts/2012-12-21-1.3.0.md

@@ -1,20 +0,0 @@
----
-title: 1.3.0
-summary: XDG-compatible configuration
-date: 2012-12-21
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.3.0.html
----
-
-Adds support for XDG-compatible configuration. Many thanks to
-[@tijn](https://github.com/hnrysmth/ppl/issues/4) on GitHub for [recommending this
-functionality](https://github.com/hnrysmth/ppl/issues/4).
-
-This means ppl can now be alternatively configured using a file at
-`~/.config/ppl/config`. If you like keeping your `~/` free of dotfile clutter
-then this is good news. If not, don't worry, `~/.pplconfig` continues working as
-normal.
-
-* Add support for XDG-compatible configuration file location

data/gh-pages/_posts/2012-12-21-thank-you-for-your-all-your-feedback.md

@@ -1,26 +0,0 @@
----
-title: Thanks For All Your Feedback
-date: 2012-12-21
-layout: news
-section: news
-categories: [news]
----
-
-Yesterday I worked up the courage to submit this project to Hacker News under
-the usual [Show HN](http://news.ycombinator.com/item?id=4947047) format. I was
-pleasantly surprised by how positive the feedback was overall. It was especially
-heartening to confirm that I'm not the only person out there who would be
-interested in using a command line address book!
-
-As a result of all the attention that came flooding in, questions were asked and
-answered, bugs were reported and fixed, and features were suggested and
-implemented. It was a really fun day.
-
-The elephant in the room is obviously sync functionality at this point.  Lots
-and lots of people have made it very clear that even though they think this
-project is a great idea it is useless in the extreme to them unless it can sync
-with their GMail or iCloud. Rest assured that [this has not gone
-unnoticed](https://github.com/hnrysmth/ppl/issues/5).
-
-Stay tuned!
-

data/gh-pages/_posts/2012-12-22-1.4.1.md

@@ -1,21 +0,0 @@
----
-title: 1.4.1
-summary: Multiple email addresses per contact
-date: 2012-12-22
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.4.1.html
----
-
-This version is a first step towards removing the annoying limitation of one
-email address, postal address and so on per contact. This isn't glamorous work
-but it's vital functionality.
-
-The ability to add more than one email address to a contact has been added. This
-is not 100% complete: email addresses cannot yet be deleted, for example. And
-[ppl show](/documentation/commands/show) does not yet show all the addresses
-(only [ppl email](/documentation/commands/email) does for now). But at least
-it's now possible to store the data
-
-* Contacts can now have more than one email address

data/gh-pages/_posts/2012-12-22-1.5.0.md

@@ -1,17 +0,0 @@
----
-title: 1.5.0
-summary: ppl shell
-date: 2012-12-22
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.5.0.html
----
-
-The addition of "interactive mode" in the form of [ppl
-shell](/documentation/commands/shell). Thanks to
-[@axelGschaider](https://github.com/axelGschaider) on GitHub for [the
-suggestion](https://github.com/hnrysmth/ppl/issues/7). This ought to make life a lot
-easier for people entering lots of commands at once!
-
-* Added `ppl shell` command

data/gh-pages/_posts/2012-12-23-1.5.1.md

@@ -1,13 +0,0 @@
----
-title: 1.5.1
-summary: ppl post bugfix
-date: 2012-12-23
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.5.1.html
----
-
-This is a very small release to fix one very small bug.
-
-* Fix fatal error in `ppl post <contact>` when contact has no address

data/gh-pages/_posts/2012-12-23-1.5.2.md

@@ -1,15 +0,0 @@
----
-title: 1.5.2
-summary: ppl shell usability tweaks
-date: 2012-12-23
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.5.2.html
----
-
-Another very small, very minor release addressing a usability issue with [ppl
-shell](/documentation/commands/shell).
-
-* Add "welcome" message to `ppl shell` explaining how to quit
-* Don't show "ppl>" prompt in `ppl shell` if stdin isn't a tty

data/gh-pages/_posts/2012-12-26-1.5.3.md

@@ -1,19 +0,0 @@
----
-title: 1.5.3
-summary: Better 'no such contact' error message
-date: 2012-12-26
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.5.3.html
----
-
-There have been a lot of internal changes in this release, and one user-facing
-change to improve the error message when a non-existent contact is specified in
-a command.
-
-Before this change, non-existent contacts resulted in a fairly cryptic error
-message consisting only of the given non-existent contact ID. From now on the
-problem is actually explained to the user.
-
-* Added a proper error message when a non-existent contact is specified

data/gh-pages/_posts/2012-12-27-1.6.0.md

@@ -1,18 +0,0 @@
----
-title: 1.6.0
-summary: ppl email --delete and bugfix
-date: 2012-12-27
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.6.0.html
----
-
-This release contains a bugfix and the means for users to undo the minor damage
-caused by the bug. The bug was causing every new email address added by users to
-be saved against the contact *twice*. The fix stops that from happening. And a
-new feature has been added in the form of a `--delete` flag for [ppl
-email](/documentation/commands/email) so that dupliate addresses can be removed.
-
-* Fixed a bug causing duplicate email addresses to be saved
-* Added `--delete` flag to `ppl email`

data/gh-pages/_posts/2012-12-29-1.7.0.md

@@ -1,18 +0,0 @@
----
-title: 1.7.0
-summary: ppl show output overhaul
-date: 2012-12-29
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.7.0.html
----
-
-This version contains some fairly substantial changes to the way the [ppl
-show](/documentation/commands/show) command formats its output. The need for
-this change was unearthed by a [question from
-@storge](https://github.com/hnrysmth/ppl/issues/14) on GitHub. In short, the command
-was only showing one of the given contact's email addresses, giving the
-impression that this was all that ppl supported storing.
-
-* Improved the output format of `ppl show`

data/gh-pages/_posts/2013-01-05-1.8.0.md

@@ -1,18 +0,0 @@
----
-title: 1.8.0
-summary: ppl url
-date: 2013-01-05
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.8.0.html
----
-
-Added another attribute that contacts often have: URLs. For example, a given
-contact may have a profile page on some social network, a personal website, or
-any number of different possibilities. The new comand, [ppl
-url](/documentation/commands/url), works similarly to [ppl
-email](/documentation/commands/email) and allows you to store these URLs in your
-address book.
-
-* Added `ppl url` command

data/gh-pages/_posts/2013-01-06-1.9.0.md

@@ -1,20 +0,0 @@
----
-title: 1.9.0
-summary: Aliases and ppl version
-date: 2013-01-06
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.9.0.html
----
-
-This release adds two new features: the [version
-command](/documentation/commands/version), and support for
-[aliases](/documentation/configuration/alias). Both features function similarly
-to their git counterparts, albeit in a less complete way. For now the aliasing
-only supports simple aliasing of plain command names, and doesn't allow things
-like aliasing long chains of arguments or git's `!f() {}` style commands. These
-things will come in time.
-
-* Added `ppl version` command
-* Added rudimentary alias support

data/gh-pages/_posts/2013-01-10-1.10.0.md

@@ -1,18 +0,0 @@
----
-title: 1.10.0
-summary: Multiple organizations and phone numbers
-date: 2013-01-10
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.10.0.html
----
-
-A lot of the work in this release went into some much-needed refactoring as a
-precautionary measure against accumulating too much technical debt early on. The
-code reuse enabled by this refactor facilitated the addition of some key
-functionality, too.
-
-* Added support for storing multiple organizations with `ppl org` command
-* Added support for storing multiple phone numbers with `ppl phone` command
-* Added support for deleting phone numbers with `ppl phone` command

data/gh-pages/_posts/2013-01-20-1.11.0.md

@@ -1,14 +0,0 @@
----
-title: 1.11.0
-summary: ppl nick
-date: 2013-01-20
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.11.0.html
----
-
-This is a simple release that just adds new functionality in the form of support
-for another vCard property: [nicknames](/documentation/commands/nick).
-
-* Added `ppl nick` command

data/gh-pages/_posts/2013-02-16-1.12.0.md

@@ -1,14 +0,0 @@
----
-title: 1.12.0
-summary: ppl age
-date: 2013-02-16
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.12.0.html
----
-
-This release adds the [age](/documentation/commands/age) command, which provides
-easy access to the ages of all contacts based on their dates of birth.
-
-* Added `ppl age` command

data/gh-pages/_posts/2013-02-17-1.13.0.md

@@ -1,29 +0,0 @@
----
-title: 1.13.0
-summary: ppl push, pull and remote
-date: 2013-02-17
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.13.0.html
----
-
-The result of a lot of thought, this is the long-awaited git synchronisation
-functionality. What's been added are three new commands,
-[pull](/documentation/commands/pull), [push](/documentation/commands/push), and
-[remote](/documentation/commands/remote). These commands have no behaviour of
-their own, and are effectively aliases that execute their git counterparts
-inside the address book's directory.
-
-I think that this functionality is a good compromise: synchronising address book
-data can be accomplished using simple, familiar commands such as `ppl pull
-origin master`, and ppl itself is not unduly burdened with duplicating any git
-functionality.
-
-Another positive outcome of this work is that it brings proper git-style "bang"
-aliases closer to being a reality. The code changes required for these three
-commands lay a lot of the foundations necessary for bang aliases.
-
-* Added `ppl pull` command
-* Added `ppl push` command
-* Added `ppl remote` command

data/gh-pages/_posts/2013-02-17-1.14.0.md

@@ -1,15 +0,0 @@
----
-title: 1.14.0
-summary: Bang aliases
-date: 2013-02-17
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.14.0.html
----
-
-Hot on the heels of `1.13.0`, this release brings the git-style bang alias
-functionality facilitated by the previous release's code changes. This allows
-the creation of aliases which execute a shell command.
-
-* Add bang alias support

data/gh-pages/_posts/2013-02-17-1.14.1.md

@@ -1,18 +0,0 @@
----
-title: 1.14.1
-summary: Removes discrepancy with documentation
-date: 2013-02-17
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.14.1.html
----
-
-The release of `1.14.0` exposed a small screw-up in ppl's alias support. The
-`[alias]` section of the `~/.pplconfig` file was not being picked up at all.
-Instead it was looking for a section called `[aliases]`, which was insconsistent
-with the documentation and with git, on which the functionality is based. This
-release, therefore, is a fix for this issue: an `[alias]` section in
-`.pplconfig` should now work as described.
-
-* Fixed `[alias]` configuration

data/gh-pages/_posts/2013-02-17-two-months-in.md

@@ -1,27 +0,0 @@
----
-title: Two Months In
-date: 2013-02-17
-layout: news
-section: news
-categories: [news]
----
-
-It's been almost two months now since the big day of [ppl's public
-release](news/thank-you-for-your-all-your-feedback/). In that time, development
-has continued at a more steady, sustainable pace than during the period leading
-up to the release itself. New functionality has been added, and a few bugs have
-been fixed, as [the changelog](/development/changelog) will attest.
-
-One particularly nasty bug has been reported whose solution eludes me for the
-moment. It seems ppl does not cope well with [non-ASCII
-characters](https://github.com/hnrysmth/ppl/issues/17). The error itself is coming
-from within vpim - although it is almost certainly not a vpim bug - and is
-proving a tough nut to crack. Encodings in Ruby 1.9 are [fraught with
-complexity](http://yehudakatz.com/2010/05/05/ruby-1-9-encodings-a-primer-and-the-solution-for-rails/),
-but I'm optimistic about the existence of a simple solution.
-
-On a more positive note, it's worth mentioning that the overall health of the
-project seems to be good. I continue to enjoy building and maintaining ppl, and
-public interest in a command-line address book is as strong as could be expected
-for such a niche piece of software. Thanks for all your patience and support!
-

data/gh-pages/_posts/2013-03-16-1.15.0.md

@@ -1,28 +0,0 @@
----
-title: 1.15.0
-summary: Color output added
-date: 2013-03-16
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.15.0.html
----
-
-This adds support for colourised output to most ppl commands. The following
-commands are affected by this change:
-
-* [age](/documentation/configuration/color_age)
-* [bday](/documentation/configuration/color_bday)
-* [email](/documentation/configuration/color_email)
-* [ls](/documentation/configuration/color_ls)
-* [name](/documentation/configuration/color_name)
-* [nick](/documentation/configuration/color_nick)
-* [org](/documentation/configuration/color_org)
-* [phone](/documentation/configuration/color_phone)
-* [post](/documentation/configuration/color_post)
-* [url](/documentation/configuration/color_url)
-
-Internally, this release depends on two new gems:
-
-* [morphine](https://github.com/bkeepers/morphine)
-* [colored](https://github.com/defunkt/colored)

data/gh-pages/_posts/2013-03-16-coloured-output-released.md

@@ -1,27 +0,0 @@
----
-title: Coloured Output Released
-date: 2013-03-16
-layout: news
-section: news
-categories: [news]
----
-
-It's been about a month since the last release, but that's not because of any
-lack of internal activity. Today marks the release of support for git-style
-coloured output, configurable in `~/.pplconfig`.
-
-This has taken a while to achieve just because I wanted to take my time over it
-and try to really get it right the first time. Some refactoring was necessary in
-order to get config data into the code responsible for formatting output, but
-hopefully the resulting usage of the
-[morphine](https://github.com/bkeepers/morphine) dependency injection container
-should reduce such code churn in future.
-
-In other news, the [UTF-8 bug](https://github.com/hnrysmth/ppl/issues/17) mentioned
-in [last month's update](/news/two-months-in/) should be gone soon. I've spoken
-to the maintainer of vpim about it, and [his
-response](http://rubyforge.org/pipermail/vpim-talk/2013/000185.html) was
-positive. Apparently vpim just doesn't quite support Ruby 1.9.1's String class
-yet, but will do soon.
-
-

data/gh-pages/_posts/2013-04-10-ruby-2.0-compatibility.md

@@ -1,28 +0,0 @@
----
-title: Ruby 2.0 Compatibility
-date: 2013-04-10
-layout: news
-section: news
-categories: [news]
----
-
-The latest version of ppl is available now, and it's one of those tiny,
-pointless-sounding ones: `1.15.1`. This release is all about Ruby 2.0
-compatibility.  A recent issue reported on GitHub by
-[@pigmonkey](https://github.com/pigmonkey) brought to my attention that vpim,
-ppl's underlying vCard library, [doesn't work at all in Ruby
-2.0](https://github.com/hnrysmth/ppl/issues/19).
-
-    invalid multibyte escape: /^\xFF\xFE/
-
-This is all better now, and ppl works as well in Ruby 2.0 as it does in the
-1.9.\* range. This was a bit of a seismic change behind the scenes, and it
-almost seems misleading to increment only the patch version number.
-
-Essentially, I forked vpim in order to get this done. While this is an
-unexpected turn of events, it does mean I'm now quite well-placed to fix its
-UTF-8 issues myself instead of depending on the mercy of upstream. By the way,
-if you're interested in helping with this, go take a look at
-[greencard](https://github.com/hnrysmth/greencard). It's vpim stripped down to just
-the vCard functionality used by ppl. Go fork it!
-

data/gh-pages/_posts/2013-04-11-1.15.1.md

@@ -1,13 +0,0 @@
----
-title: 1.15.1
-summary: Ruby 2.0 support
-date: 2013-04-11
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.15.1.html
----
-
-Heralding support for Ruby 2.0 and beyond, this version of ppl also sees the
-replacement of the vpim gem dependency with greencard. See the [news
-post](/news/ruby-2.0-compatibility/) for more details.

data/gh-pages/_posts/2013-04-12-1.16.0.md

@@ -1,22 +0,0 @@
----
-title: 1.16.0
-summary: Mutt integration tweaks
-date: 2013-04-12
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.16.0.html
----
-
-With a couple of tweaks to the way ppl handles mutt queries, `1.16.0` should be
-a nice improvement for anybody using ppl to autocomplete email addresses in the
-mail client that "just sucks less".
-
-* Added missing functionality to the [mutt](/documentation/commands/mutt)
-  command enabling it to output *all* of a contact's matching email addresses
-  instead of just the first.
-* Added the `-i` flag to the [mutt](/documentation/commands/mutt) command
-  enabling it to perform case-insensitive search of the address book.
-
-Many thanks to [@pigmonkey](https://github.com/pigmonkey) on GitHub for the
-cooperation that made this release happen.

data/gh-pages/_posts/2013-04-14-1.17.0.md

@@ -1,15 +0,0 @@
----
-title: 1.17.0
-summary: UTF-8 support
-date: 2013-04-14
-layout: changelog
-section: development
-categories: [changelog]
-permalink: /development/changelog/1.17.0.html
----
-
-This is a peculiar version in that it doesn't change any code in ppl itself, but
-simultaneously fixes a really major issue that's been affecting it. All this
-version does is to increment the greencard gem dependency version number to a
-version that copes with UTF-8 input. It's a *tiny* change, but it's a major
-improvement.