I use Publii for website content management. This week, inspired by the flurry of activity around the new human.json protocol, I decided to add it to my website. Here’s the process I followed.

• Gather some urls you want to vouch for
• Use Tools -> File Manager to add the file in your website root
• Use Tools -> Custom HTML to add a new header
• Rebpublish your site
• Confirm with the human.json plugin

I'm currently editing the human.json file by hand, which you'll need to do as well.  Stepping through...

1. Gather URLs

Make list somewhere convenient.  Start with a couple of websites that you know and trust.  Don't forget to include the leading 'https://'.  At the time of writing, this is required by the protocol.  (So, 'https://foo.com' not just 'foo.com')

2. Tools --> File Manager

Open the File Manager tool and add a new file in the root directory.  Name it 'human.json' (all lowercase).  The format of the file is simple and readable.  See the protocol page for examples.

In Publii, there's no obvious "view" vs "edit" option for these files.  If you click it, the OS just uses the default association to open it.  In my case, this opens the file in a browser which is not what I want.  However, if I hold down the shift key and click, it opens in an editor.  I'm on Linux.  YMMV.  

After you make your edits and save the file, you don't need to do anything in Publii.  The latest file will get picked up and used during the site build process.

3. Tools --> Custom HTML

Open the Custom HTML tool and add the following line in your HTML headers.

<link rel="human-json" href="/human.json">

4. Republish Your Site

This will regenerate and re-upload every page on your site, because you've added a new header.

5. Verify with the Browser Plugin

Install the human.json browser extension to check your site, and explore others.  (Sidequest: Try the GNU Terry Pratchett extension while you're at it.)

Hope this helps you get started with human.json!  Trust is more important than ever, and it's great to see this simple protocol getting some interest.   

Guides and tools for other systems:  HTML (from the spec), Wordpress (The Hard Way), Django

At the time of writing, I'm using Publii Version: 0.46.3 (build 17008) for Linux.