<div id="readability-page-1" class="page"><article>
 <div>

 
 <div>
 <details open="">
 <summary accesskey="c" title="(Alt + C)">
 Table of Contents
 </summary>
 <nav id="TableOfContents">
 <ul>
 <li><a href="#개요">개요</a>
 <ul>
 <li><a href="#템플릿-파일-생성하기">템플릿 파일 생성하기</a></li>
 <li><a href="#결과-확인">결과 확인</a></li>
 </ul>
 </li>
 </ul>
</nav>
 </details>
 </div>
 
 <h2 id="개요">개요</h2>
지난주에 커뮤니티에서 친분이 있는 분이 이 블로그의 RSS 링크에서 포스트의 태그가 확인되지 않는다고 제보해 주셨다. 확인 결과 rss 링크 “<a href="https://findstar.pe.kr/index.mlx%22">https://findstar.pe.kr/index.mlx"</a> 에서 포스트에 등록한 태그가 노출되지 않고 있었다. 그래서 RSS 스펙을 확인하여 hugo 템플릿을 수정해서 해결하였다.
<h2 id="템플릿-파일-생성하기">템플릿 파일 생성하기</h2>
<a href="https://gohugo.io/templates/rss/#the-embedded-rss-xml">매뉴얼</a> 을 확인하면 먼저 RSS 템플릿의 파일 매칭 순서를 확인할 수 있다.
내가 사용하는 테마파일에서는 별도의 RSS 템플릿을 지정하지 않았기 때문에 내장된 기본값이 사용된다. 기본값은 <a href="https://github.com/gohugoio/hugo/blob/master/tpl/tplimpl/embedded/templates/_default/rss.xml">링크</a>에서 내용을 확인할 수 있다.
내장된 기본값은 다음과 같다.
<div><pre><code data-lang="xml">{{- $pctx := . -}}
{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}}
{{- $pages := slice -}}
{{- if or $.IsHome $.IsSection -}}
{{- $pages = $pctx.RegularPages -}}
{{- else -}}
{{- $pages = $pctx.Pages -}}
{{- end -}}
{{- $limit := .Site.Config.Services.RSS.Limit -}}
{{- if ge $limit 1 -}}
{{- $pages = $pages | first $limit -}}
{{- end -}}
{{- printf "&lt;?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?&gt;" | safeHTML }}
&lt;rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"&gt;
 &lt;channel&gt;
 &lt;title&gt;{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}&lt;/title&gt;
 &lt;link&gt;{{ .Permalink }}&lt;/link&gt;
 &lt;description&gt;Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}&lt;/description&gt;
 &lt;generator&gt;Hugo -- gohugo.io&lt;/generator&gt;{{ with .Site.LanguageCode }}
 &lt;language&gt;{{.}}&lt;/language&gt;{{end}}{{ with .Site.Author.email }}
 &lt;managingEditor&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/managingEditor&gt;{{end}}{{ with .Site.Author.email }}
 &lt;webMaster&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/webMaster&gt;{{end}}{{ with .Site.Copyright }}
 &lt;copyright&gt;{{.}}&lt;/copyright&gt;{{end}}{{ if not .Date.IsZero }}
 &lt;lastBuildDate&gt;{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}&lt;/lastBuildDate&gt;{{ end }}
 {{- with .OutputFormats.Get "RSS" -}}
 {{ printf "&lt;atom:link href=%q rel=\"self\" type=%q /&gt;" .Permalink .MediaType | safeHTML }}
 {{- end -}}
 {{ range $pages }}
 &lt;item&gt;
 &lt;title&gt;{{ .Title }}&lt;/title&gt;
 &lt;link&gt;{{ .Permalink }}&lt;/link&gt;
 &lt;pubDate&gt;{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}&lt;/pubDate&gt;
 {{ with .Site.Author.email }}&lt;author&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/author&gt;{{end}}
 &lt;guid&gt;{{ .Permalink }}&lt;/guid&gt;
 &lt;description&gt;{{ .Summary | html }}&lt;/description&gt;
 &lt;/item&gt;
 {{ end }}
 &lt;/channel&gt;
&lt;/rss&gt;
</code></pre></div>이제 나의 고유한 RSS 템플릿 파일을 작성해보자. 위의 내장된 기본값을 바탕으로 약간의 수정된 내용을 추가하면 된다. 나의 경우에는
<code>layouts/_default/index.xml</code> 파일을 생성하였다. 만약 값이 적용이 안된다면 <a href="https://gohugo.io/templates/rss/#the-embedded-rss-xml">매뉴얼</a>에서 매칭 순서를 다시 확인해보자. 우선순위가 높은 파일이 이미 존재할 수도 있다.
생성한 파일은 다음과 같이 <code>&lt;category&gt;</code> 태그를 추가하였다. 포스트에서는 <code>TAG</code> 이지만, 이를 표한혀는 <a href="https://validator.w3.org/feed/docs/rss2.html">RSS 스펙</a>이 <code>Category</code> 이기 때문이다. 이를 <code>Taxonomy</code> 라고 한다.
<div><pre><code data-lang="xml">{{- $pctx := . -}}
{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}}
{{- $pages := slice -}}
{{- if or $.IsHome $.IsSection -}}
{{- $pages = $pctx.RegularPages -}}
{{- else -}}
{{- $pages = $pctx.Pages -}}
{{- end -}}
{{- $limit := .Site.Config.Services.RSS.Limit -}}
{{- if ge $limit 1 -}}
{{- $pages = $pages | first $limit -}}
{{- end -}}
{{- printf "&lt;?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?&gt;" | safeHTML }}
&lt;rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"&gt;
 &lt;channel&gt;
 &lt;title&gt;{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}&lt;/title&gt;
 &lt;link&gt;{{ .Permalink }}&lt;/link&gt;
 &lt;description&gt;Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}&lt;/description&gt;
 &lt;generator&gt;Hugo -- gohugo.io&lt;/generator&gt;{{ with .Site.LanguageCode }}
 &lt;language&gt;{{.}}&lt;/language&gt;{{end}}{{ with .Site.Author.email }}
 &lt;managingEditor&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/managingEditor&gt;{{end}}{{ with .Site.Author.email }}
 &lt;webMaster&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/webMaster&gt;{{end}}{{ with .Site.Copyright }}
 &lt;copyright&gt;{{.}}&lt;/copyright&gt;{{end}}{{ if not .Date.IsZero }}
 &lt;lastBuildDate&gt;{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}&lt;/lastBuildDate&gt;{{ end }}
 {{- with .OutputFormats.Get "RSS" -}}
 {{ printf "&lt;atom:link href=%q rel=\"self\" type=%q /&gt;" .Permalink .MediaType | safeHTML }}
 {{- end -}}
 {{ range $pages }}
 &lt;item&gt;
 &lt;title&gt;{{ .Title }}&lt;/title&gt;
 &lt;link&gt;{{ .Permalink }}&lt;/link&gt;
 &lt;pubDate&gt;{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}&lt;/pubDate&gt;
 {{ with .Site.Author.email }}&lt;author&gt;{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}&lt;/author&gt;{{end}}
 &lt;guid&gt;{{ .Permalink }}&lt;/guid&gt;
 &lt;description&gt;{{ .Summary | html }}&lt;/description&gt;
 {{ range .Params.tags }}
 &lt;category&gt;{{ . }}&lt;/category&gt;
 {{ end }}
 &lt;/item&gt;
 {{ end }}
 &lt;/channel&gt;
&lt;/rss&gt;
</code></pre></div>실제 기본 템플릿 내용에서 추가한 부분은 다음과 같다.
<div><pre><code data-lang="xml">&lt;item&gt;
 ..생략..
 {{ range .Params.tags }}
 &lt;category&gt;{{ . }}&lt;/category&gt;
 {{ end }}
&lt;/item&gt;
</code></pre></div>템플릿 파일에서는 <code>.Params</code> 값을 사용할 수 있다. 템플릿에서 사용할 수 있는 값들은 <a href="https://gohugo.io/variables/page/">매뉴얼</a>을 참고하자.
추가한 내용을 해석하면 포스트의 <code>tags</code> 라는 값을 확인해서 <code>category</code> 라는 RSS 태그를 추가한 것이다. 따라서 <code>category</code> 는 여러개가 될 수 있다.
물론 위의 RSS 태그가 표시되려면 개별 포스트는 tags 라는 속성값이 존재해야한다.
<div><pre><code data-lang="markdown">...
tags: ["hugo", "rss template"]
...
</code></pre></div><h2 id="결과-확인">결과 확인</h2>
이제 rss 결과를 확인하자.
<div><pre><code data-lang="xml">&lt;item&gt;
&lt;title&gt;Spring 프로젝트 Maven을 사용할 때 도커라이즈 캐싱방법&lt;/title&gt;
&lt;link&gt;https://findstar.pe.kr/2021/08/06/dockerize-maven-project/&lt;/link&gt;
&lt;pubDate&gt;Fri, 06 Aug 2021 20:08:09 +0900&lt;/pubDate&gt;
&lt;guid&gt;https://findstar.pe.kr/2021/08/06/dockerize-maven-project/&lt;/guid&gt;
&lt;description&gt;spring 프로젝트에서 maven 을 사용할 때 도커라이즈에서 레이어를 캐싱하여 빌드 속도를 향상시키는 방법을 살펴보았다.&lt;/description&gt;
&lt;category&gt;dockerize&lt;/category&gt;
&lt;category&gt;spring boot&lt;/category&gt;
&lt;category&gt;maven&lt;/category&gt;
&lt;/item&gt;
</code></pre></div><h3 id="참고">참고</h3>
<ul>
<li><a href="https://gohugo.io/templates/rss/#the-embedded-rss-xml">https://gohugo.io/templates/rss/#the-embedded-rss-xml</a></li>
<li><a href="https://gohugo.io/variables/page/">https://gohugo.io/variables/page/</a></li>
<li><a href="https://validator.w3.org/feed/docs/rss2.html">https://validator.w3.org/feed/docs/rss2.html</a></li>
</ul>


 

 <hr>
 

 





<a href="https://disqus.com/">comments powered by </a>



 </div>
</article></div>

Soo Story

Jung-Soo Ahn

그 동안 작성된 포스트를 rss 링크에서 확인한 결과 태그가 정상적으로 노출되지 않고 있다는 것을 발견하였다. 그래서 hugo 에서 지원하는 RSS 템플릿 기능을 사용해서 RSS 에서 포스트의 태그를 확인할 수 있게 작업을 진행해보았다.

Hugo에서 RSS 템플릿을 지정하는 방법

댓글