hacks-guide-minimal-mistake.../docs/_docs/09-authors.md
Michael Rose 42de7a56fc Improve author link flexibility
Deprecate social networking links in `_config.yml` in favor or new `author.links` array for any link and in any order. All of Font Awesome's icons are available for use.

```
author:
  links:
    - label: "Your Website"
      icon: "fas fa-fw fa-link"
      url: "https://your-site.com"
    - label: "Twitter"
      icon: "fab fa-fw fa-twitter-square"
      url: "https://twitter.com/username"
    - label: "GitHub"
      icon: "fab fa-fw fa-github"
      url: "https://github.com/username"
    - label: "Instagram"
      icon: "fab fa-fw fa-instagram"
      url: "https://instagram.com/username"
```

Fixes #1581
2018-09-10 15:05:07 -04:00

1.7 KiB

title permalink excerpt last_modified_at
Authors /docs/authors/ Instructions and settings for working with multiple site authors. 2018-09-10T12:33:24-04:00

Sites that may have content authored from various individuals can be accommodated by using data files.

To assign an author to a post or page that is different from the site author specified in _config.yml:

Step 1. Create _data/authors.yml and add authors using the following format. Any variables found under author: in _config.yml can be used (e.g. name, bio, avatar, author links, etc.).

# /_data/authors.yml

Billy Rick:
  name        : "Billy Rick"
  bio         : "What do you want, jewels? I am a very extravagant man."
  avatar      : "/assets/images/bio-photo-2.jpg"
  links:
    - label: "Email"
      icon: "fas fa-fw fa-envelope-square"
      url: "mailto:billyrick@rick.com"
    - label: "Website"
      icon: "fas fa-fw fa-link"
      url: "https://thewhip.com"
    - label: "Twitter"
      icon: "fab fa-fw fa-twitter-square"
      url: "https://twitter.com/extravagantman"

Cornelius Fiddlebone:
  name        : "Cornelius Fiddlebone"
  bio         : "I ordered what?"
  avatar      : "/assets/images/bio-photo.jpg"
  links:
    - label: "Email"
      icon: "fas fa-fw fa-envelope-square"
      url: "mailto:cornelius@thewhip.com"
    - label: "Twitter"
      icon: "fab fa-fw fa-twitter-square"
      url: "https://twitter.com/rhymeswithsackit"

Step 2. Assign one of the authors in authors.yml to a post or page you wish to override the site.author with.

Example: To assign Billy Rick as an author for a post the following YAML Front Matter would be applied:

author: Billy Rick