Support for Multiple Authors

Mon, 21 Feb 2022 16:04:06 -0500

Using Introduction, your site can feature multiple authors. Each post displays a byline – the name of a post’s author – if the author field is set in the post front matter. For example, here’s the front matter for this post:

---
title: "Support for Multiple Authors"
date: 2022-02-20T02:04:06-05:00
tags: ["features", "blog"]
series: ["quickstart"]
author: ["Hugo Contributors"]
---

You can list one or more authors. For example, here’s a byline with two credits:

Start Here: Configuration and Content

Sat, 25 Jul 2020 02:04:06 -0500

Here are some helpful tips for setting up this theme.

Configuration

Most of what you’ll want to configure is demonstrated in the exampleSite config.toml. This is Hugo’s configuration file. You can copy the config.toml in the exampleSite/ to your site root get started.

Here are all the options included in the (live!) configuration file for this example site!


baseURL = "http://example.com/" # Your domain name. Must end with "/"
theme = "introduction"
DefaultContentLanguage = "en" # Default language for multilingual sites
# disqusshortname = "" # https://gohugo.io/content-management/comments
# Configure Google Analytics 4 with [services.googleAnalytics] and id = "G-MEASUREMENT_ID".

[params]
 themeStyle = "auto" # Choose "light" or "dark" or "auto"
 favicon = "/img/fav.ico" # Path to favicon file
 showMenu = true # Show navigation menu
 showRSSButton = false # Show rss button in navigation
 fadeIn = true # Turn on/off the fade-in effect
 fadeInIndex = false # Turn on/off the fade-in effect on the index page even if fade-in was otherwise turned off
 dateFormat = "Jan 2, 2006"
 email = "youremail@email.com" # E-mail address for contact section
 # customCSS = ["foo.css"] # Include custom css files placed under assets/
 # customJS = ["foo.js"] # Include custom JavaScript files placed under assets/
 # plausible = true # Use Plausible analytics (requires an account at Plausible.io)

 # Configure the home page
 [params.home]
 introHeight = "fullheight" # Input either "medium" or "large" or "fullheight"
 showLatest = true # Show latest blog post summary
 showAllPosts = false # Set true to list all posts on home page, or set false to link to separate blog list page
 allPostsArchiveFormat = true # show all posts in an archive format
 numberOfProjectsToShow = 3 # Maximum number of projects to show on home page. Unset or comment out to show all projects
 localTime = true # Show your current local time in contact section
 timeZone = "America/Los_Angeles" # Your timezone as in the TZ* column of this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
 timeFormat = "en-US" # Language specific format to use
 [params.projects]
 useTwoColumns = false # Use a layout with two columns instead of three

 # Share buttons on blog post pages
 [params.share]
 twitter = true
 facebook = true
 pinterest = true

 # To enable giscus, the GitHub-discussions-based comment section,
 # input the repository for the discussions below. For more details, see
 # https://www.joelnitta.com/posts/2021-11-24_using-giscus/
 # and https://github.com/giscus/giscus
 [params.giscus]
 # repo = "github-user/github-repo" # Entering repo will enable giscus
 repo-id = "enter-repo-id"
 category = "Comments"
 category-id = "enter-category-id"
 mapping = "pathname"
 reactions-enabled = "1"
 emit-metadata = "0"
 theme = "light"
 lang = "en"

 # Social icons appear in introduction and contact section. Add as many more as you like.
 # Icon pack "fab" includes social network icons, see: https://fontawesome.com/icons?d=gallery&s=brands&m=free
 # Icon pack "fas" includes solid style icons, see: https://fontawesome.com/icons?d=gallery&s=solid&m=free
 [[params.social]]
 url = "https://twitter.com/"
 icon = "twitter" # icon name without the 'fa-'
 icon_pack = "fab"
 [[params.social]]
 url = "https://facebook.com/"
 icon = "facebook-f" # icon name without the 'fa-'
 icon_pack = "fab"
 [[params.social]]
 url = "https://linkedin.com/"
 icon = "linkedin-in" # icon name without the 'fa-'
 icon_pack = "fab"
 [[params.social]]
 url = "mailto:youremail@email.com" # For a direct email link, use "mailto:test@example.org".
 icon = "paper-plane" # icon name without the 'fa-'
 icon_pack = "fas"
 [[params.social]]
 url = "https://mastodon.social/"
 icon = "mastodon" # icon name without the 'fa-'
 icon_pack = "fab"
 html_attributes = "rel=\"me\"" # Add rel attribute for Mastodon profile link verification


# If you don't want to use the default menu, you can define one by yourself
# [[menu.main]]
# name = "Home"
# url = "/"
# weight = 0
# [[menu.main]]
# name = "Blog"
# url = "/blog/"
# weight = 1

# We only use tag as a taxonomies
# You can add more by yourself
[taxonomies]
 tag = "tags"
 series = "series"

[markup]
 defaultMarkdownHandler = "goldmark"
 [markup.goldmark]
 [markup.goldmark.renderer]
 unsafe = true
 [markup.highlight]
 codeFences = true
 guessSyntax = false
 hl_Lines = ""
 lineNoStart = 1
 lineNos = false
 lineNumbersInTable = true
 # noClasses = true
 # For styles, see https://xyproto.github.io/splash/docs/longer/all.html
 style = "solarized-dark"
 tabWidth = 4

[languages]
 [languages.en]
 label = "English"
 locale = "en-us"
 contentDir = "content/en"
 weight = 0
 title = "Introduction"
 [languages.en.params]
 description = "Website Description" # Max 160 characters show in search results
 # footerText = "" # Text to override default footer text (markdown allowed)

 [languages.es]
 label = "Español"
 locale = "es"
 contentDir = "content/es"
 weight = 1
 title = "Introducción"
 [languages.es.params]
 description = "Descripcion del sitio web"
 # footerText = ""

 [languages.de]
 label = "Deutsch"
 locale = "de"
 contentDir = "content/de"
 weight = 2
 title = "Vorstellung"
 [languages.de.params]
 dateFormat = "2. January 2006"
 description = "Beschreibung der Webseite"
 # footerText = ""

Below are some specific things you might like to configure right away.

Markdown Support

Mon, 06 Nov 2017 12:04:06 -0500

Introduction supports code blocks and syntax highlighting:

$ complicated techie code git bash ubuntu
>>> return value init foo

You can easily create tables using Markdown, with rows that support readability:

this	is	a	table	!
this	is	the	1st	row
this	is	the	2nd	row
this	is	the	3rd	row
edgy	jo	ke	lands	here
this	is	the	5th	row
this	is	the	6th	row

Unordered lists render with high readabiltiy as well!

Features on Introduction

Support for Multiple Authors

**Start Here:** Configuration and Content

Configuration

Markdown Support

Start Here: Configuration and Content