seiffert/carew-authors

carew的作者插件

dev-master / 1.x-dev 2013-07-29 22:14 UTC

This package is not auto-updated.

Last update: 2020-01-06 07:03:59 UTC


README

此插件允许您使用多个作者使用Carew。在每篇文章中,您可以在文章的元数据中设置作者。当您执行Carew的构建命令时,将为每个作者生成特殊作者索引文档。

安装

使用composer安装

composer require seiffert/carew-authors:dev-master

然后在config.yml中进行配置

engine:
    extensions:
        - Carew\Plugin\Authors\AuthorsExtension

authors:
    ego:
        name: Paul
        email: paul.seiffert@gmail.com
    ego2:
        name: Paul
        email: paul.seiffert@gmail.com

在您的layouts目录中创建一个模板authors.html.twig,内容如下

{% extends 'vendor/seiffert/carew-authors/Carew/Plugin/Authors/layouts/authors.html.twig' %}

在此模板中,您可以自定义作者索引文档的渲染。

使用方法

在您的文章中:指定文章作者如下

---
layout: post
title:  This is pure awesomeness!
author: seiffert
---

现在,当您使用Carew的构建命令构建博客时,将生成一个索引文件authors/seiffert.html,列出该作者的所有文章。此外,在元数据中具有作者的文档将扩展一个Author对象,该对象包含上述config.yml中配置的所有信息(在示例中这是nameemail键)。

在模板中渲染文章时,您可以像这样访问这些信息

<a href="/authors/{{ document.metadatas.author.handle }}.html">
    {{ document.metadatas.author.name }}
</a>