diff --git a/Changes b/Changes index b3934b8..948e84e 100644 --- a/Changes +++ b/Changes @@ -1,3 +1,7 @@ +1.6 2018-08-05 + + - Adding experimental support for Webmention sending, receiving, and display. + 1.55 2018-03-07 - Switching away from a naive copy of Text::SmartyPants in favor of a custom fork of same (Plerd::SmartyPants). As a result, Plerd inserts higher-than-ASCII characters like curly-quotes and emdashes directly into its UTF-8 output, rather than using HTML entities. This avoids problems arising from mixing HTML entities with other modules' entity-escaping code. diff --git a/README.md b/README.md index 1fb3712..45238a9 100644 --- a/README.md +++ b/README.md @@ -177,13 +177,13 @@ Once you've configured your blog as described above, you can add these attribute ### Webmention -Plerd includes experimental support for [Webmention](https://www.w3.org/TR/webmention/), an open technology that allows websites to send simple "Hey, this page of mine contains a link to that page of yours!" messages to other websites. +Plerd includes experimental support for [Webmention](https://alistapart.com/article/webmentions-enabling-better-communication-on-the-internet), an open technology that allows websites to send simple "Hey, this page of mine contains a link to that page of yours!" messages to other websites. If the linking page employs [Microformats2](http://microformats.io) metadata, then the target page can choose to display salient information about the mention, such as its author, or a summary of its content. It can adjust the format of this display depending upon the mention's apparent type -- a "like", a repost, a comment-style response, and so on. -Plerd can send webmentions to websites that new or updated blog posts link to, and it can also receive and display webmentions from elsewhere on the internet. +Thus, with certain options enabled, Plerd can send webmentions to websites that your blog posts link to. It can also receive and display webmentions when pages elsewhere on the internet link to specific posts of yours. -These features are _essentially undocumented_ at this time, but I expect that to improve presently. Adding Webmention support has been the focus of my Plerd development since the start of 2018, and I expect it to receive more complete documentation and test coverage by the end of the year. +These features are sparsely documented or tested as of August 2018, but I expect that to improve presently. Adding Webmention support has been the focus of my Plerd development since March, and I expect it to receive more complete documentation and test coverage by the end of the year. -For the time being, you can consult the documentation of the `plerdwatcher` script for a list of Webmention-related options, and see `post.tt` in the included sample templates for an example of webmention display technique. +For the time being, you can consult the documentation of the `bin/plerdwatcher` and `bin/plerdall` programs for a list of Webmention-related options, and see `templates/post.tt` among the included sample templates for an example of webmention display technique. You can also see a variety of displayed webmentions on [this post](http://fogknife.com/2018-04-22-announcing-two-new-indieweb-modules-for-perl.html), generated by a Plerd-powered blog. (Note that this includes mentions from other, subsequent posts within the same blog, making for an organic sort of "Related Posts" feature.) If you are interested in helping me test Webmention support working with your own Plerd setup while it's still in this experimental stage, please do feel free to get in touch via email. diff --git a/lib/Plerd.pm b/lib/Plerd.pm index 874c485..5f12a1c 100644 --- a/lib/Plerd.pm +++ b/lib/Plerd.pm @@ -1,6 +1,6 @@ package Plerd; -our $VERSION = '1.6b'; +our $VERSION = '1.6'; use Moose; use MooseX::Types::URI qw(Uri);