Skip to content
master
Switch branches/tags
Code
This branch is 22 commits ahead, 108 commits behind 11ty:master.
Contribute

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
css
 
 
 
 
img
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

eleventy-webmentions

A basic starter template for Eleventy blogs with added support for webmentions.
For more information about this, read Static Indieweb: Using Webmentions.

Example of Webmention Section

Installation

Run npm install after cloning this repository. The available commands are identical to eleventy-base-blog.

Enable Webmentions

Follow these steps to get it working:

  1. Go to https://webmention.io/ and sign in. To authenticate, you will have to include a <a rel="me"> link at your domain, pointing to your github or twitter user URL:

<a href="https://github.com/maxboeck" rel="me">Max on Github</a>

  1. Once you've verified domain ownership, go to the settings page. Copy the token listed under "API Key" there.

  2. Paste the token into the .env.sample file, then delete the .sample from the filename. That's a secret key, so this file should be in your .gitignore. If you are hosting your site on Netlify, make sure to enter the token in your build settings.

  3. Check the information in _data/metadata.json and make sure your domain name is correct. It should look like example.com.

  4. Run Eleventy. It will try to fetch the webmentions for your domain (you may not yet have any, check your webmentions.io dashboard). After the first use, a cached json file will be created so you don't have to re-fetch that data everytime eleventy regenerates the site in development.

Customization

This starter includes just the basic functionality, feel free to make it your own.
The relevant parts are:

  • Templates: _includes/webmentionlist.njk and _includes/webmention.njk
  • Filter: webmentionsForUrl in .eleventy.js
  • Data Fetching: _data/webmentions.js
  • Basic Styling: css/webmentions.css

About

A basic starter template for Eleventy blogs, with added support for webmentions.

Resources

License

Packages

No packages published