Authors & Team Members

此内容尚不支持你的语言。

Create author profiles to attribute content (like blog posts and publications) to specific people. Authors can have bios, social links, avatars, and optionally their own dedicated profile pages.

Visual Editor (Recommended)

🎬 Video: Managing authors with HugoBlox Studio (coming soon)

Manual Setup

File Structure

Authors are stored as YAML files with matching avatar images:

文件夹data/
- 文件夹authors/
  - jane-doe.yaml # Author profile (slug = jane-doe)
  - john-smith.yaml
文件夹assets/
- 文件夹media/
  - 文件夹authors/
    jane-doe.jpg # Avatar (same filename as profile)
    john-smith.png

Creating an Author

Create the profile file

Create data/authors/<slug>.yaml:

# Display name
title: Dr. Jane Doe

# Role/position
role: Associate Professor

# Short bio (supports Markdown)
bio: |
  Researcher in machine learning and computational biology.
  Previously at MIT and Google Brain.

# Organization(s)
organizations:
  - name: Stanford University
    url: https://stanford.edu

# Social/contact links
social:
  - icon: envelope
    link: mailto:jane@stanford.edu
  - icon: brands/github
    link: https://github.com/janedoe
  - icon: brands/twitter
    link: https://twitter.com/janedoe
  - icon: academicons/google-scholar
    link: https://scholar.google.com/citations?user=...
  - icon: brands/linkedin
    link: https://linkedin.com/in/janedoe

# Education (optional)
education:
  - course: PhD in Computer Science
    institution: MIT
    year: 2018
  - course: BSc in Mathematics
    institution: UC Berkeley
    year: 2013

# Interests (optional)
interests:
  - Machine Learning
  - Computational Biology
  - Open Science

Add an avatar image

Upload a photo to assets/media/authors/<slug>.jpg (or .png).

The filename must match the profile slug exactly.

Reference in content

Use the slug in your content’s front matter:

---
title: My Research Paper
authors:
  - jane-doe    # References data/authors/jane-doe.yaml
  - john-smith
---

Use the pack/icon-name syntax for social links. See the Icon Reference for all available packs.

social:
  - icon: envelope              # Hero icon (default pack)
    link: mailto:...
  - icon: brands/github         # Brand icons
    link: https://github.com/...
  - icon: academicons/orcid     # Academic icons
    link: https://orcid.org/...

Publishing Author Pages

By default, each author gets their own profile page at /authors/<slug>/. You can control this behavior:

Disable Author Pages
Enable Author Pages

For personal sites where you don’t need separate author pages (e.g., the homepage is already your profile), create this file:

---
# Unpublish author profile pages
build:
  render: never
cascade:
  build:
    render: never
    list: always
---

Authors will still work for attribution—they just won’t have dedicated pages.

To publish author profile pages (e.g., for team or lab sites), simply delete the content/authors/_index.md file if it exists.

Each author will get a page at /authors/<slug>/ showing their bio, social links, and authored content.

Quick Reference

Field	Type	Description
`title`	`string`	Display name (required)
`role`	`string`	Job title or role
`bio`	`string`	Short biography (Markdown supported)
`organizations`	`list`	Affiliations with `name` and `url`
`social`	`list`	Social links with `icon` and `link`
`education`	`list`	Degrees with `course`, `institution`, `year`
`interests`	`list`	Research interests or skills