Microformats2

A Microformats2 parser for Elixir.

Installation

This parser is available in Hex:

1. Add microformats2 to your list of dependencies in mix.exs:

   def deps do [{:microformats2, "~> 0.3.1"}] end

2. If you want to directly parse from URLs, add tesla to your list of dependencies in mix.exs:

   def deps do [{:microformats2, "_{> 0.3.1"}, {:tesla, "}> 1.3.0"}] end

Usage

Give the parser an HTML string and the URL it was fetched from:

Microformats2.parse("""<div class="h-card">
  <img class="u-photo" alt="photo of Mitchell"
       src="https://webfwd.org/content/about-experts/300.mitchellbaker/mentor_mbaker.jpg"/>
  <a class="p-name u-url"
     href="http://blog.lizardwrangler.com/">Mitchell Baker</a>
  (<a class="u-url" href="https://twitter.com/MitchellBaker">@MitchellBaker</a>)
  <span class="p-org">Mozilla Foundation</span>
  <p class="p-note">
    Mitchell is responsible for setting the direction and scope of the Mozilla Foundation and its activities.
  </p>
  <span class="p-category">Strategy</span>
  <span class="p-category">Leadership</span>
</div>
""", "http://localhost")

It will parse the object to a structure like that:

%{
  rels: _,
  rel_urls: _,
  items: [
    %{
      type: ["h-card"],
      properties: %{
        "photo" => ["https://webfwd.org/content/about-experts/300.mitchellbaker/mentor_mbaker.jpg"],
        "name" => ["Mitchell Baker"],
        "url" => ["http://blog.lizardwrangler.com/", "https://twitter.com/MitchellBaker"],
        "org" => ["Mozilla Foundation"],
        "note" => [
          "Mitchell is responsible for setting the direction and scope of the Mozilla Foundation and its activities."
        ],
        "category" => ["Strategy", "Leadership"]
      }
    }
  ]
}

You can also provide HTML trees already parsed with Floki:

Microformats2.parse(Floki.parse("""<div class="h-card">...</div>"""), "http://localhost")

Or URLs if you have Tesla installed:

Microformats2.parse("http://localhost")

Dependencies

We need Floki for HTML parsing and Tesla for fetching URLs.

Features

Implemented:

• parsing depth first, doc order
• parsing a p- property
• parsing a u- property
• parsing a dt- property
• parsing a e- property
• parsing implied properties
• nested properties
• nested microformat with associated property
• dynamic creation of properties
• rel
• nested microformat without associated property
• normalize u-* property values

Not implemented:

• value-class-pattern
• include-pattern
• recognition of vendor extensions
• backwards compatible support for microformats v1

License

This software is licensed under the MIT license.