多創作者模式

一個網站會有多個創作者共同貢獻內容，所以需要在整個網站中預設使用多創作者。對於這種情況，Blowfish 允許使用者使用多創作者功能拓展創作者列表。

為了保持向後相容，這個功能僅允許定義額外的創作者，並不會以任何方式修改之前透過配置檔案添加的創作者。

新建創作者

#

新建創作者的第一步是設定一個 ./data/authors 資料夾。然後，你可以在裡面簡單地添加新創作者的 json 檔案。檔案的名稱是你在文章引用該作者時需要指定的 key。

例如，在 ./data/authors 資料夾中新建一個 nunocoracao.json 檔案。檔案的內容示例如下。name、image、bio 和 social 是目前創作者檔案支援的 4 個參數，這與你在 languages.[language-code].toml 配置檔案中的預設創作者配置類似。

注意：社交參數中的 key 將會預設獲取主題的圖示 icon，當然你也可以在 assests/icons 資料夾中設定任何圖示。

{
    "name": "Nuno Coração",
    "image" : "img/nuno_avatar.jpg",
    "bio": "Theme Creator",
    "social": [
        { "linkedin": "https://linkedin.com/in/nunocoracao" },
        { "twitter": "https://twitter.com/nunocoracao" },
        { "instagram": "https://instagram.com/nunocoracao" },
        { "medium": "https://medium.com/@nunocoracao" },
        { "github": "https://github.com/nunocoracao" },
        { "goodreads": "http://goodreads.com/nunocoracao" },
        { "keybase": "https://keybase.io/nunocoracao" },
        { "reddit": "https://reddit.com/user/nunoheart" }
    ]
}

在文章中引用創作者

#

你已經新建好了創作者，下一步讓我們在文章中引用它。在下面的範例中，我們使用前面新建的創作者 key 來引用它。

Blowfish 將會使用額外創作者對應 json 檔案中的資料，以幫助在文章中渲染此作者。這個功能不會改變整個網站配置的預設作者，因此你可以分別控制他們。使用 showAuthor 參數，可以配置是否顯示預設作者，這適用於單創作者的部落格。扉頁中的 authors 參數允許你為文章定義額外的創作者，這裡的創作者將獨立於整個網站中的預設創作者。

---
title: "多創作者"
date: 2020-08-10
draft: false
description: "為你的文章設置多個作者。"
slug: "multi-author"
tags: ["authors", "config", "docs"]
showAuthor: true
authors:
  - "nunocoracao"
showAuthorsBadges : false 
---

上面這個範例和當前這個頁面一樣，將顯示預設創作者和新創作者。你可以滾動此頁面來查看實際效果。

新建創作者分類法

#

如果你想要獲取每個作者的文章列表，需要配置 authors 分類，這會讓你了解到一些更有趣的配置。這是多創作者模式中的一個可選步驟。 To get lists of articles for each of your authors you can configure the authors taxonomy, which opens up some more configurations that might be interesting. This is an optional step in the process that is not required to display the authors in your articles.

第一步是在 config.toml 檔案中配置 authors 分類法，如下所示。儘管 tag 和 category 預設是 Hugo 定義的，但只要你添加了一個特定的分類法，就需要顯式添加 tag 和 category，否則基於 Hugo 的檔案載入順序，網站將不會處理 tag 和 category。

[taxonomies]
  tag = "tags"
  category = "categories"
  author = "authors"

這樣一來，你將會有一個所有創作者列表的頁面，並且每個創作者都會顯示他們參與創作的文章列表。如果你想在每篇文章中以徽章的形式展示作者，有兩種方式：在全域配置檔案添加 article.showAuthorsBadges 參數，或在每篇文章的扉頁參數中配置 showAuthorsBadges 參數。

最後，你可以為每個創作者頁面添加更多細節內容，以便顯示簡介、連結或者適合你需求的任何其他資訊。為了實現這一點，需要在 ./content/authors 資料夾中為每個創作者添加一個目錄名為 key 的資料夾，並在資料夾中添加 _index.md 檔案。對於上面的例子，我們會得到一個 .content/authors/nunocoracao/_index.md 檔案。在這個檔案中你可以添加創作者的實際姓名和他們自己的個人資訊頁面。本文檔網站中的作者就是這麼配置的，你可以在文件網站中查看實際效果。

---
title: "Nuno Coração"
---

Nuno's awesome dummy bio.

範例

#

下面這個範例，介紹了如何關閉網站預設創作者，並在文章中添加多創作者。