Skip to content

Commit

Permalink
Version-bumping to 1.6.
Browse files Browse the repository at this point in the history
  • Loading branch information
jmacdotorg committed Aug 6, 2018
1 parent 2de860f commit d51b207
Show file tree
Hide file tree
Showing 3 changed files with 9 additions and 5 deletions.
4 changes: 4 additions & 0 deletions 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.
Expand Down
8 changes: 4 additions & 4 deletions README.md
Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion 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);
Expand Down

0 comments on commit d51b207

Please sign in to comment.