gatsby-plugin-humans-txt

Create humans.txt for your Gatsby site.

Overview

Gatsby plugin to generate a humans.txt file on gatsby build.

humans.txt is an initiative for knowing the people behind a website. It's a TXT file that contains information about the different people who have contributed to building the website.

Install

npm i gatsby-plugin-humans-txt

or

yarn add gatsby-plugin-humans-txt

Usage

Add the plugin to your gatsby-config.js and pass the options property an object representation of what you want the humans.txt file to look like. The example below can be used to follow the humanstxt.org standard:

plugins: [
  {
    resolve: `gatsby-plugin-humans-txt`,
    options: {
      team: [
        {
          Developer: `Dylan Tackoor`,
          GitHub: `dylantackoor`,
          Twitter: `@dylantackoor`
        }
      ],
      thanks: [`Gatsby`, `Node`],
      site: {
        'Last update': `2019/4/16`,
        Standards: `JavaScript`,
        Components: `humans-generator`,
        Softwares: `Visual Studio Code`
      },
      note: `Made in Miami.`
    }
  }
]

Options

Options are passed directly to humans-generator which maps top level properties in the options object from this:

{
  teams: [
    { Role: `Name`, Twitter: `@username`}
    { Role2: `Name2`, Twitter: `@username2` },
  ]
}

To a text file like this:

/* TEAM */
Role: Name
Twitter: @username

Role2: Name2
Twitter: @username2

To follow the standard, use the below options:

Name	Type	Default	Description
metaTag	boolean	true	Flag to include <link rel="author" href="/humans.txt" /> in the head tag
header	String	humans.txt	Text to be converted to header ASCII art
team	Object[]	undefined	Information about every human involved in the project
thanks	Object[] || String[]	undefined	Path to external config file
site	Object[]	undefined	Additional information about the site
note	String	undefined	Path where to create the robots.txt

Or don't! 🤷‍♂️

TODOs

• Write humans-generator zero dependency alternative
  • Add filePath option to override default
  • change header option to print the value without automatically converting to ASCII (see awesome Netflix example)
• Determine feasibility of automatically pulling the teams data from the git repository commits

Support

@dylantackoor