Loading... ## 前言 之前博客的 RSS 一直用的是 Hugo 自带的模板，以前我也没看过具体效果，昨天心血来潮用了下 Inoreader，订阅了自己的 RSS 试了下，发现没有抓取全文，只是显示了一个摘要，如果需要全文还要自己去点击下，这样感觉有点麻烦了（如果能有朋友愿意订阅我的垃圾博客，我希望能给他们最好的体验，哈哈），然后查看了 Hugo 的官方文档，自己稍微动手改了改，做下记录水一篇文章。 :stuck_out_tongue_closed_eyes: ## 修改 RSS 模板 从官方文档关于 [RSS Templates](https://gohugo.io/templates/rss/) 的叙述中了解到： 1. Hugo 默认的 RSS 模板； 2. RSS 模板的查询顺序。 以 `home` RSS 为例，查询顺序如下： ``` [layouts/index.rss.xml layouts/home.rss.xml layouts/rss.xml layouts/list.rss.xml layouts/index.xml layouts/home.xml layouts/list.xml layouts/_default/index.rss.xml layouts/_default/home.rss.xml layouts/_default/rss.xml layouts/_default/list.rss.xml layouts/_default/index.xml layouts/_default/home.xml layouts/_default/list.xml layouts/_internal/_default/rss.xml] ``` 可以看到，Hugo 自带的模板都是处于最后使用的，其实不管是 `home` 还是 `section` 抑或是 `taxonomy` 都是这样的，因此，只要在合适的位置放上一个 RSS 模板就可以了。 自带 RSS 模板如下： ```xml <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title> <link>{{ .Permalink }}</link> <description>Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description> <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }} <language>{{.}}</language>{{end}}{{ with .Site.Author.email }} <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }} <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }} <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }} <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }} {{ with .OutputFormats.Get "RSS" }} {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }} {{ end }} {{ range .Pages }} <item> <title>{{ .Title }}</title> <link>{{ .Permalink }}</link> <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate> {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}} <guid>{{ .Permalink }}</guid> <description>{{ .Summary | html }}</description> </item> {{ end }} </channel> </rss> ``` 从`<description>{{ .Summary | html }}</description>`这行可以看到该模板只显示概要的原因了，那么我们只需要将其更改为`<description>{{ .Content | html }}</description>`就解决了。 因为我准备博客中所有的 RSS 订阅都使用同一个模板，所以直接在`layouts/_default/`下创建了一个`rss.xml`文件（开始脑子抽了，居然想在每个 RSS 订阅下添加一个模板，怕不是要累死），内容如下： ```xml <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"> <channel> <title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title> <link>{{ .Permalink }}</link> <description>Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description> <generator>Hugo -- gohugo.io</generator> {{ with .Site.LanguageCode }} <language>{{.}}</language>{{end}} {{ with .Site.Author.email }} <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}} {{ with .Site.Author.email }} <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}} {{ with .Site.Copyright }} <copyright>{{.}}</copyright>{{end}} {{ if not .Date.IsZero }} <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }} {{ with .OutputFormats.Get "RSS" }} {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }} {{ end }} {{ range first 10 (where .Data.Pages ".Params.enrypt" "!=" "true") }} <item> <title>{{ .Title }}</title> <link>{{ .Permalink }}</link> <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate> {{ with .Params.author }}<author> {{.}} </author>{{end}} <guid>{{ .Permalink }}</guid> <description>{{ .Content | html }}</description> </item> {{ end }} </channel> </rss> ``` 主要的修改有以下三行： ```html <!-- 默认抓取前十篇不包含加密文章的内容 --> {{ range first 10 (where .Data.Pages ".Params.enrypt" "!=" "true") }} <!-- 作者采用文章作者而不是网站默认作者 --> {{ with .Params.author }}<author> {{.}} </author>{{end}} <!-- 默认输出全文 --> <description>{{ .Content | html }}</description> ``` ## 配置 RSS 根据 RSS 模板内容，我们可以在 `config.toml` 文件中定义一些内容，例如： ```toml languageCode = "zh" copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License." [author] name = "WithdewHua" email = "i@withdewhua.space" ``` 最后修改：2019 年 10 月 08 日 © 允许规范转载 赞 0 如果觉得我的文章对你有用，请随意赞赏
1 条评论
https://slashmerriam.wordpress.com/2018/10/16/embarras-de-choix-of-software/