ppl 4.0.2 → 4.0.3

data/gh-pages/_posts/2013-07-20-2.1.0.md

@@ -0,0 +1,36 @@
+---
+title: 2.1.0
+summary: Better name management
+date: 2013-07-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.1.0.html
+---
+
+With thanks to [@pigmonkey](https://github.com/pigmonkey) for raising this as
+[issue #42](https://github.com/hnrysmth/ppl/issues/42) on GitHub, version 2.1.0
+brings increased control over the names of contacts. This is intended to improve
+interoperability with other address book software, including the Android
+system's contact list.
+
+Short, lower case contact IDs are great for a CLI program, but on a phone, you
+probably want to see full names. This update provides full access to all the
+bits & pieces of vCard's `N` (name) field:
+
+* Family name(s)
+* Middle name(s)
+* Given name(s)
+* Prefix
+* Suffix
+
+See the documentation of [ppl name](/documentation/commands/name/) for more
+details on how to use this new functionality.
+
+Also included is some slightly different behaviour under the hood of [ppl
+add](/documentation/commands/name/).  This command now attempts to "have a
+guess" at the structure of the name of a newly-added contact. It'll treat the
+first word of the full name as the contact's given name, and the rest of the
+string as their family name. This is a shamefully anglocentric approach to name
+parsing, but at least it's a start.
+

data/gh-pages/_posts/2013-07-20-2.2.0.md

@@ -0,0 +1,20 @@
+---
+title: 2.2.0
+summary: ppl scrape overwrite prevention
+date: 2013-07-20
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.2.0.html
+---
+
+Thanks again to [@pigmonkey](https://github.com/pigmonkey) for [issue #32](https://github.com/hnrysmth/ppl/issues/32),
+reporting some unhelpful destructive behaviour in [ppl
+scrape](/documentation/commands/scrape/). In this version, some additional
+checking has been added to that command to prevent it from overwriting existing
+contacts.
+
+In the event that the scraped contact ID happens to match that of an existing
+contact, ppl scrape will now notice this collision and append numbers to the new
+ID until it no longer matches any existing contact's IDs.
+

data/gh-pages/_posts/2013-10-12-2.3.0.md

@@ -0,0 +1,19 @@
+---
+title: 2.3.0
+summary: ppl grep
+date: 2013-10-12
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.3.0.html
+---
+
+With thanks to [@ajford](https://github.com/ajford) for the excellent [feature
+request](https://github.com/hnrysmth/ppl/issues/43), version 2.3.0 brings a new
+command: [ppl grep](/documentation/commands/grep/). This command leverages the
+extremely high speed search `git grep` repository search in order to provide
+near-instant search results.
+
+    $ ppl grep smith
+    john.vcf:EMAIL:john.smith@example.org
+

data/gh-pages/_posts/2014-03-30-2.3.1.md

@@ -0,0 +1,25 @@
+---
+title: 2.3.1
+summary: Simple Bug Fixes
+date: 2014-03-30
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.3.1.html
+---
+
+Once again, I'm grateful to [@alexGschaider] for his patience. This minor
+version fixes a couple of annoying little problems that he's bumped into.
+
+The first problem was a pretty terrible error message which was displayed when a
+`.vcf` file contains invalid vCard data. This has now been fixed, and the error
+message replaced with something much more sensible.
+
+    $ ppl show badcontact
+    ppl: badcontact.vcf contains invalid data
+
+The second was yet another `Encoding::CompatibilityError`, just like back in the
+bad old days before ppl even supported UTF-8 at all. Hopefully this will be the
+last one of those now!
+
+[@alexGschaider]: https://github.com/axelGschaider

data/gh-pages/_posts/2015-01-05-2.3.2.md

@@ -0,0 +1,18 @@
+---
+title: 2.3.2
+summary: scrape output fix
+date: 2015-01-05
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.3.2.html
+---
+
+I'm very grateful to [@hobarrera](https://github.com/hobarrera) for contributing
+this fix to [ppl scrape](/documentation/commands/scrape/). A simple mistake in
+the output formatting code was causing it to appear slightly garbled, like this:
+
+    Add "Hugo Osvaldo Barrera #<Ppl::Entity::EmailAddress:0x00000001ffbd28>>"
+    to your address book [Y/n]?
+
+So thanks for fixing that, Hugo!

data/gh-pages/_posts/2015-12-03-get-involved.md

@@ -0,0 +1,29 @@
+---
+title: Get Involved!
+date: 2015-12-03
+layout: news
+section: news
+categories: [news]
+---
+
+The time has come to give this project a nudge into a slightly different mode of
+operation. Enough people are interested in the long term health of this little
+CLI app that I think it'd benefit from opening the doors a bit to potential
+collaborators and maintainers. So I've converted the project into a proper
+[GitHub organization](https://github.com/hnrysmth) and I'm inviting you to
+come and join it.
+
+I see lots of people come and go with great ideas for this project. I love 99%
+of the ideas and suggestions that pop up but I just can't keep up with all the
+different demands on my time. That's the bottleneck that's holding the project
+back and it's silly, really.
+
+For a while I've been wanting to do something about this. If you want to help
+out in any way, however small, speak up on GitHub, [email me](mailto:henry@henrysmith.org),
+or get in touch on [Twitter](https://twitter.com/hnrysmth). I'd love to add you
+to the organization and let you *just get started* making your ideas happen.
+Even if you just like the project, but don't have any immediate plans to do
+anything in particular, that's fine! If you've never contributed to an open
+source project before, don't let that put you off. Everyone's welcome!
+
+

data/gh-pages/_posts/2015-12-05-2.3.3.md

@@ -0,0 +1,16 @@
+---
+title: 2.3.3
+summary: non-ASCII input fix
+date: 2015-12-05
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.3.3.html
+---
+
+This release is [@tba](https://github.com/tba)'s [non-ASCII input fix PR](https://github.com/hnrysmth/ppl/pull/56)
+
+It's a fix enabling ppl to save non-ASCII names when scraping contact data
+from emails.
+
+It took altogether too long for me to merge this and I apologise!

data/gh-pages/_posts/2016-01-02-2.4.0.md

@@ -0,0 +1,19 @@
+---
+title: 2.4.0
+summary: Better commit author
+date: 2016-01-12
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.4.0.html
+---
+
+If you've ever looked at the commit history that ppl generates in your address
+book you'll have noticed the ugly-looking commit author. [@drewbug] certainly
+noticed and took the time to do something about it.
+
+As of this version, ppl pulls in your Git config and uses your `user.name` and
+`user.email` if available. If not, it falls back to the old (ugly) author
+generation.
+
+[@drewbug]: https://github.com/drewbug

data/gh-pages/_posts/2017-05-01-2.4.1.md

@@ -0,0 +1,12 @@
+---
+title: 2.4.1
+summary: Upgrade to rugged ~> v0.24.0
+date: 2017-05-01
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/2.4.1.html
+---
+
+This release is just a merge of one PR from [@acant](https://github.com/acant). It upgrades to a much more
+modern version of the rugged gem.

data/gh-pages/_posts/2017-10-23-sleep-mode.md

@@ -0,0 +1,18 @@
+---
+title: Sleep Mode
+date: 2017-10-23
+layout: news
+section: news
+categories: [news]
+---
+
+This project seems to be in a good stable state. There's a small active
+userbase who are mostly content with the software as-is. Not a lot of
+maintenance or feature work is necessary these days and I can't justify
+spending money on a domain for a project that's just chilling like this.
+
+I'm converting the whole thing into a single, easy-to-look-after repo in my
+own personal GitHub account and disabling autorenew on `ppladdressbook.org`.
+Wanna make it clear that I consider this a fairly decent set of circumstances
+for the project to be in btw. It mostly just works and that's for the best
+cos I don't really have a lot of time to maintain and fix it any more.

data/gh-pages/_posts/2018-01-03-3.0.1.md

@@ -0,0 +1,12 @@
+---
+title: 3.0.1
+summary: Fix name deletion bug
+date: 2018-01-03
+layout: changelog
+section: development
+categories: [changelog]
+permalink: /development/changelog/3.0.1.html
+---
+
+Fix for a [name deletion bug](https://github.com/hnrysmth/ppl/issues/74) reported by [@the-reverend](https://github.com/the-reverend).
+

data/gh-pages/_stylesheets/ppl/color.less

@@ -0,0 +1,119 @@
+
+@base03  : #002b36;
+@base02  : #073642;
+@base01  : #586e75;
+@base00  : #657b83;
+@base0   : #839496;
+@base1   : #93a1a1;
+@base2   : #eee8d5;
+@base3   : #fdf6e3;
+@yellow  : #b58900;
+@orange  : #cb4b16;
+@red     : #dc322f;
+@magenta : #d33682;
+@violet  : #6c71c4;
+@blue    : #268bd2;
+@cyan    : #2aa198;
+@green   : #859900;
+
+@lightGrey: #FAFAFA;
+@darkGrey: #F0F0F0;
+
+a:link, a:visited {
+  color: @blue;
+}
+
+body {
+  background-color: @lightGrey;
+  color: @base01;
+}
+
+div.content {
+  background-color: @lightGrey;
+}
+
+code {
+  background-color: @base3;
+}
+
+h2 { color: @base03; }
+h3 { color: @orange; }
+
+pre {
+  background-color: @base03;
+  color: @base2;
+  display: block;
+}
+
+.front-page {
+  h1.big-welcome, .little-welcome {
+    color: @base03;
+  }
+}
+
+.btn {
+	&.btn-primary {
+		background-color: @blue;
+		color: @base2;
+	}
+}
+
+.navbar {
+  .navbar-inner {
+    background-color: @darkGrey;
+  }
+  .brand {
+    color: @base03;
+    font-weight: bold;
+    text-shadow: none;
+  }
+}
+
+.command-list {
+  h2 {
+    color: inherit;
+  }
+}
+
+.navbar .nav > li > a {
+  color: @base02;
+}
+
+.navbar .nav > .active > a,
+.navbar .nav > .active > a:hover,
+.navbar .nav > .active > a:focus {
+  background-color: @orange;
+  color: @base3;
+}
+
+.nav-list  {
+  background-color: @darkGrey;
+  border: 1px solid rgb(221, 221, 221);
+}
+.nav-list > li:hover > a {
+  background-color: inherit;
+  color: inherit;
+}
+.nav-list > li.active:hover > a,
+.nav-list > li.active > a {
+  background-color: @orange;
+  color: @base3;
+}
+
+footer.global {
+  color: @base1;
+
+  a:link, a:visited {
+    color: @base0;
+  }
+}
+
+.nav-sidebar {
+  dt.active,
+  dt.active a,
+  dd.active {
+    background-color: @orange;
+    color: @base3;
+  }
+}
+

data/gh-pages/_stylesheets/ppl/layout.less

@@ -0,0 +1,54 @@
+
+.front-page {
+
+  .row.welcome {
+    margin-top: 32px;
+  }
+
+  h1.big-welcome {
+    margin: 32px 0 0 0;
+  }
+ 
+  .little-welcome {
+    margin: 16px 0 0 0;
+  }
+
+  .row.what,
+  .row.latest {
+    margin-top: 32px;
+  }
+
+}
+
+h3 {
+  margin: 16px 0 8px 0;
+}
+
+.navbar .nav > li > a {
+  padding: 12px 15px 12px;
+}
+
+.content {
+  padding-top: 20px;
+  padding-bottom: 128px;
+}
+
+footer.global {
+  border-top: 1px solid #D4D4D4;
+  padding: 16px 0;
+}
+
+.nav-sidebar {
+  margin: 0;
+  dt { padding: 4px 4px 0px 4px; }
+  dd { padding: 0px 4px 4px 4px; }
+  dd { margin: 0 0 16px 0; }
+}
+
+dl.version-history {
+  dd {
+    margin: 0 0 1em 0;
+    padding: 0;
+  }
+}
+

data/gh-pages/_stylesheets/ppl/style.less

@@ -0,0 +1,185 @@
+
+@import "color.less";
+@import "layout.less";
+@import "typography.less";
+
+
+/*
+body {
+	background-color: #fdffdf;
+	color: #586e75;
+	font-family: "Inconsolata", sans-serif;
+	font-size: 18px;
+	margin: 0;
+	padding: 0;
+	line-height: 1.5;
+}
+
+code {
+	font-family: "Inconsolata", monospace;
+	font-size: inherit;
+}
+
+pre {
+	background-color: #073642;
+	border: 1px solid #002b36;
+	color: #93a1a1;
+	display: block;
+	font-family: "Ubuntu Mono", monospace;
+	font-size: 18px;
+}
+
+.front-page .welcome,
+.front-page .what {
+	margin-top: 64px;
+}
+
+.front-page h1.big-welcome {
+	color: #002b36;
+	font-size: 64px;
+	margin: 32px 0 32px 0;
+}
+
+.front-page .little-welcome {
+	color: #002b36;
+	font-size: 24px;
+}
+
+.front-page .welcome-example code {
+	line-height: 20px;
+	font-size: 20px;
+}
+
+.front-page .welcome-example .bash-prompt {
+	color: #859900;
+}
+
+.front-page .what h2 {
+	color: #002b36;
+	font-size: 20px;
+}
+
+.navbar-inner {
+	background-color: #fdf6e3;
+}
+
+.navbar .brand {
+	padding: 5px 20px 0px;
+}
+
+.navbar .nav > li > a {
+	color: #586e75;
+}
+
+.navbar .nav > .active > a,
+.navbar .nav > .active > a:hover,
+.navbar .nav > .active > a:focus {
+	background-color: #cb4b16;
+	color: #eee8d5;
+	text-shadow: none;
+}
+
+.nav-tabs.nav-stacked > li > a {
+	background-color: #fdf6e3;
+	border-color: none;
+	color: #586e75;
+}
+
+.nav-tabs.nav-stacked > li.active > a {
+	background-color: #cb4b16;
+	color: #eee8d5;
+}
+
+.commands h1 {
+	font-size: 32px;
+	font-weight: normal;
+	margin: 0 0 32px 0;
+}
+
+h2 {
+	font-size: 32px;
+	font-weight: normal;
+	margin: 0 0 32px 0;
+}
+
+h3 {
+	font-size: 20px;
+	font-weight: normal;
+}
+
+/*
+SOLARIZED HEX     16/8 TERMCOL  XTERM/HEX   L*A*B      RGB         HSB
+--------- ------- ---- -------  ----------- ---------- ----------- -----------
+base03    #002b36  8/4 brblack  234 #1c1c1c 15 -12 -12   0  43  54 193 100  21
+base02    #073642  0/4 black    235 #262626 20 -12 -12   7  54  66 192  90  26
+base01    #586e75 10/7 brgreen  240 #585858 45 -07 -07  88 110 117 194  25  46
+base00    #657b83 11/7 bryellow 241 #626262 50 -07 -07 101 123 131 195  23  51
+base0     #839496 12/6 brblue   244 #808080 60 -06 -03 131 148 150 186  13  59
+base1     #93a1a1 14/4 brcyan   245 #8a8a8a 65 -05 -02 147 161 161 180   9  63
+base2     #eee8d5  7/7 white    254 #e4e4e4 92 -00  10 238 232 213  44  11  93
+base3     #fdf6e3 15/7 brwhite  230 #ffffd7 97  00  10 253 246 227  44  10  99
+yellow    #b58900  3/3 yellow   136 #af8700 60  10  65 181 137   0  45 100  71
+orange    #cb4b16  9/3 brred    166 #d75f00 50  50  55 203  75  22  18  89  80
+red       #dc322f  1/1 red      160 #d70000 50  65  45 220  50  47   1  79  86
+magenta   #d33682  5/5 magenta  125 #af005f 50  65 -05 211  54 130 331  74  83
+violet    #6c71c4 13/5 brmagenta 61 #5f5faf 50  15 -45 108 113 196 237  45  77
+blue      #268bd2  4/4 blue      33 #0087ff 55 -10 -45  38 139 210 205  82  82
+cyan      #2aa198  6/6 cyan      37 #00afaf 60 -35 -05  42 161 152 175  74  63
+green     #859900  2/2 green     64 #5f8700 60 -20  65 133 153   0  68 100  60
+
+
+
+header.global {
+	padding: 32px 0;
+}
+
+header.page {
+	color: #EEE8D5;
+	padding: 0 0 32px 0;
+}
+
+header.global h1,
+header.page h2,
+footer.global,
+article.page .content {
+	margin: 0 auto;
+	width: 800px;
+}
+
+header.global h1 a {
+	color: #859900;
+	font-size: 32px;
+	font-weight: normal;
+	text-decoration: none;
+}
+
+header.page h2 {
+	color: #859900;
+	color: #268bd2;
+	font-size: 20px;
+	font-weight: normal;
+}
+
+article.page .content {
+	color: #839496;
+	font-size: 18px;
+}
+
+article.page .content h3 {
+	color: #EEE8D5;
+	font-weight: normal;
+	font-size: 20px;
+	margin: 0 0 16px 0;
+}
+
+article.page .content p {
+	margin-top: 0;
+}
+
+footer.global {
+	color: #586E75;
+	margin: 32px auto;
+}
+
+*/
+