Hugo
éçãµã€ããžã§ããŒã¿ HugoïŒãã¥ãŒãŽïŒã«ã€ããŠãŸãšããŠããŸãã
è©³çŽ°ãªæ¥æ¬èªèª¬æãµã€ããã§ããŠãããããç°¡åãªèª¬æã«çããŠããŸãã
詳ãã説æã¯å¿
èŠã«å¿ããŠæ€çŽ¢ããŠã¿ãŠäžããã
å ¬åŒã»é¢é£ãµã€ã
- Hugo - å
¬åŒãµã€ã
- Hugo Documentation - ããã¥ã¡ã³ã
- Hugo Themes - ããŒã
- Hugo Community - æ²ç€ºæ¿
- æ¥æ¬èª - æ¥æ¬èªã§ãæçš¿å¯èœã§ã
- GitHub - gohugoio / hugo
- Twitter - @GoHugoIO
ã€ã³ã¹ããŒã«
GitHub ããçŽæ¥å®è¡ãã¡ã€ã«ãããŠã³ããŒãããpath ãéããŸãã
Releases | GitHub - gohugoio/hugo
Homebrewã»Chocolateyã»Scoop ã䜿çšããŠããå Žåã¯ã
ãã¡ãããããã±ãŒãžã€ã³ã¹ããŒã«ãå¯èœã§ãã
Windows ã§ã¯ PowerShellã»ã³ãã³ã ããã³ããã»Git Bashã
macOS ã§ã¯ ã¿ãŒããã« ãªã©ãèµ·åããæ¬¡ã®ã³ãã³ããå
¥ããŸãã
hugo version
Hugo Static Site Generator vïœ ã®è¡šç€ºã§ã€ã³ã¹ããŒã«ã§ããŠããŸãã
Hugo Extended
ããŠã³ããŒãã»ããã±ãŒãžã®äžèЧã«ã¯ extended 衚èšãååšããŸãã
Extended 㯠SASSã»SCSS ã«å¯Ÿå¿ããããŒãžã§ã³ã§ãã
äžéšã®ããŒãã§äœ¿çšãããŠãããããExtended å¿
é ã®å ŽåããããŸãã
ã¢ããã°ã¬ãŒãã»ããŠã³ã°ã¬ãŒã
GitHub ããå®è¡ãã¡ã€ã«ãããŠã³ããŒãããå Žåã¯ã
åãæ¹æ³ã§ææ°çãããŠã³ããŒããããã¡ã€ã«ãäžæžãããŠäžããã
åé¡ããã£ãŠå€ãããŒãžã§ã³ã«æ»ãããå Žåãåæ§ã§ãã
Scoop
ð Scoop | ãµãããð FU-SEN
Scoop ãçšããŠããå Žåã容æã«ã€ã³ã¹ããŒã«ã§ããŸãã
scoop install hugo
æŽæ°ãç°¡åã§ãã
scoop update hugo
Web ãµã€ãã»ããã°ã®æ°èŠäœæ
ããã§ã¯äžã€ Web ãµã€ãã»ããã°ãäœæããŠã¿ãäºã«ããŸãã
cd å Žæ
ã§ Web ãµã€ãã»ããã°ã®æ§æãã¡ã€ã«ã眮ãå Žæã«ç§»åããŸãã
è€æ°ç°å¢ã®å
±æãããã¯ã¢ãããç®çã« Dropbox ãªã©ã䜿ã£ãŠãè¯ãã§ãããã
次ãå®è¡ããŸãããµã€ãå ã¯ãã£ã¬ã¯ããªïŒãã©ã«ãïŒã«ãªããŸãã
ãã®ããããµã€ãå ã¯è±æ°ãç¡é£ã§ãã
ãµã€ãéå¶è
㯠ãã¡ã€ã³åïŒgohugo.jp.eu.org ãªã©ïŒã«ããŠããŸãã
hugo new site ãµã€ãå
ããŒããæ±ºããŸãã
ããŒãã®è©³çްããŒãžãã Download ãŸã㯠Homepage ã§
GitHib ã®ãããžã§ã¯ãããŒãžã衚瀺ãããŸãã
ãã®ããŒããã¡ã€ã«ã git clone
ãŸã㯠git submodule add
ã§ããŠã³ããŒãããŸãã
cd ãµã€ãå/themes/
git clone ãªããžããª
ããŒããã¡ã€ã«ã®ãã£ã¬ã¯ããªã«å
¥ããšãexampleSite/ ãã£ã¬ã¯ããªãããäºãå€ãã§ãã
ãã® exampleSite/ å
ã ãµã€ãå/ äžã«ã³ããŒããŸãã
ãã®æ config.toml ã¯äžæžãããŠæ§ããŸãããããã§æºåãæŽããŸããã
éåžžäœæ¥
远å ã»å€æŽã¯ cd ãµã€ãå
ã§ç§»åããŠãããŸããconfig.toml ãšè€æ°ã®ãã£ã¬ã¯ããªããããšããã§ãã
hugo server
ãå®è¡ãããš Web ãµãŒããèµ·åããŸãã
Web ãã©ãŠã¶ãã http://localhost:1313/ ãåç
§ãããšã宿ãããç¶æ
ã§åç
§ã§ããŸãã
ãµãŒããèµ·åãããŸãŸãã¡ã€ã«ãç·šéããŸãã
ãã¡ã€ã«ä¿åã§ Web ãã©ãŠã¶ã®è¡šç€ºã«å³åæ ãããŸãã
äž»ã«æ¬¡ã®ãšããã远å ã»ç·šéããäºã«ãªããŸãã
- config.toml - ãµã€ãå šè¬ã®èšå®
- content/ å - ããŒãžã»ããã°èšäºïŒé垞㯠.md ãã¡ã€ã«ïŒ
- static/ å - ç»åã»JavaScriptã»CSS ãªã©ïŒãã®äžã¯ãã®ãŸãŸã³ããŒãããŸãïŒ
ããŒããç·šéããå¿
èŠãããå Žåã themes/ããŒãå/layouts/ å
ã®ãã¡ã€ã«ã
layouts/ å
ã«ã³ããŒããŠããç·šéããŠäžããã
themes/ å
ã¯ããŒããããŒãžã§ã³ã¢ããããæã«æŽæ°ããããã
ããã®ãã¡ã€ã«ãç·šéãããšæŽæ°ã§æ¹æ¶ãããŠããŸããŸãã
themes/ããŒãå/static/ å
ãåæ§ã« static/ å
ãžã³ããŒããŠç·šéããŸãã
äœæ¥å®äºæã¯ Ctrl
+C
ã§ãµãŒãåäœã忢ã§ããŸãã
宿ãããšããã§ãcd ãµã€ãå
ãžç§»åãïŒconfig.toml ãšè€æ°ã®ãã£ã¬ã¯ããªããããšããïŒ
次ã®ã³ãã³ãã§ãã«ãããŸãã
éåžž 1 ç§ããããããããã°ãªã©ããŒãžæ°ãå€ããªã£ãŠãæ°ç§ïœæ°åç§ã§å®äºããŸãã
hugo
ãã®æ Minify ãå¯èœã§ãã
public/ å
ã« index.html ãªã©ãçæãããŸãã
åºåå
ã public/ ãã倿Žããå Žå㯠config.toml ã« publicDir ã§æå®ããŸãã
ããšã¯çæããããã¡ã€ã«ãã¢ããããŒãããŸãã
PHP ãªã©ã¯äœ¿ãããŠããªããããå€ãã® Web ãµãŒãã§å
¬éã§ããŸãã
FTP ã§ã¢ããããŒãããŠãããã§ããã
Hugo æ¡çšã«åãããŠãµãŒãã倿Žãããšå
¬éãå¿«é©ã§ãã
Category: hosting and deployment | Hugo Documents
CLI ã«ããã¢ããããŒãã»å
Ž
ãªããèšäºã®ã¿ã€ãã«ã倿Žããå Žåãªã©ã¯äœ¿çšããªããã¡ã€ã«ãçºçããŸããã
Hugo 㯠public/ å
ã®ãã¡ã€ã«ãåé€ããŸãããæåã§åé€ããå¿
èŠããããŸãã
'hugo clean' #2389 | GitHub gohugoio/hugo issues
ãã¡ã€ã«æ§æ
ããŒãã«ãã£ãŠãã¡ã€ã«æ§æã¯å€ãã£ãŠããŸãã
ããã§ã¯æ¯èŒçããŒãã§å
±éããŠããå
容ã説æããŸãã
config.toml
æè¿ã¯ config.yaml ã§å ¬éããŠããããŒãããããŸãã
baseurl = "https://example.net.eu.org/"
publicDir = "public"
title = "Hugo ã®ã€ããããã"
theme = "whiteplain"
languageCode = "ja"
defaultContentLanguage = "ja"
googleAnalytics = "UA-00000000-0"
disqusShortname = "name"
disableKinds = ["taxonomy","taxonomyTerm"]
- baseurl å
¬é URLïŒæ«å°Ÿ
/
ã®æç¡ã¯ exampleSite ã®èšèŒã«åãããŠïŒ
baseurl ã«ã¯ãã£ã¬ã¯ããªãå«ããäºãå¯èœã§ãã
basedir = "https://example.org/dir/"
ã®å Žå
hugo server
㯠http://localhost:1313/dir/ ã§ãã - publicDir index.html ãªã©ã®åºåå ãéåžžã¯ååšãã public/ ãžåºå
- title ãµã€ãå
- theme 䜿çšããããŒãåïŒthemes/ããŒãå/ ã§åç §ïŒ
- languagecode æ¥æ¬èªã®å Žåã¯
ja
ïŒhtml ã¿ã°ã® lang ã§äœ¿çšãããå ŽåããïŒ
â»ja-JP
ã䜿ããããja
ã¯æ¥æ¬èªèšèªãã¡ã€ã«ãé©çšããããŒããååšãã - defaultContentLanguage æ¥æ¬èªã®å Žåã¯
ja
- googleAnalytics Google ã¢ããªãã£ã¯ã¹ ãã©ããã³ã° IDïŒããŒãã«ãã£ãŠã¯ç¬èªå®è£
ã®å ŽåããïŒ
Google ã¢ããªãã£ã¯ã¹ 4ïŒGA4ïŒã® æž¬å® ID ã¯é察å¿ã®å¯èœæ§ããããŸãã - disqusShortname DisqusïŒã³ã¡ã³ãã·ã¹ãã ïŒã®ã·ã§ãŒãããŒã
- disableKinds ã«ããŽãªã»ã¿ã°ã䜿çšããªãå Žåã¯
["taxonomy","taxonomyTerm"]
â» æå®ããªãå Žåãäœããªãã«ããŽãªã»ã¿ã°ããŒãžã RSSã»ãµã€ããããã«å ¥ã£ãŠããŸã
RSSã»ãµã€ããããã䜿çšããªãå Žåã¯["RSS","sitemap","taxonomy","taxonomyTerm"]
æŽã«ããŒãç¬èªã®èšå®ãšã㊠[params]
ã®é
ç®ãç¶ããŸãã
ãªããtoml ã§ã¯ã"""
ã§å²ãäºã§è€æ°è¡ã§èšèŒãã§ããŸãã
"
ã®åã« \
ãä»ããå¿
èŠããããŸãããHTML ã Markdown ã䜿ããé
ç®ã«äŸ¿å©ã§ãã
copyright = """
Copyright © 2020
<a href="https://balloon.im/" target="_blank">ãµãããð FU-SEN</a>
"""
content/ å
hugo new ããŒãžå.md
ã§ archetypes/default.md ãå
ã« content/ããŒãžå.md ã§çæãããŸãã
ãã§ã« .md ãã¡ã€ã«ãããå Žåãã³ããŒããŠãæ§ããŸããã
ããã°ã¯éåžž content/post/ å
ã§ããhugo new post/ããŒãžå.md
ãšãªããŸãã
index.html ã«è©²åœããã®ã¯ _index.md ãšãªããŸããïŒé ã® _
ã«æ³šæïŒ
ããã§ã¯ yaml ã§ã®èšèŒã§ãã---
ã +++
ã«ãããš toml ã«ãªããŸãã
---
title: "Hugo ã®ã€ããããã"
slug: "Hugoã®ã€ãããã"
date: 2020-01-09T16:20:00+09:00
categories:
- web
- ããã°
tags:
- Hugo
- CSS
- Blog
- ããã°
keywords:
- Hugo
- CSS
description: "Hugo ã«ã€ããŠã®ç޹ä»ã"
weight: 10
draft: false
---
- title ããŒãžåã»èšäºã®ã¿ã€ãã«
- slug URL 衚瀺ãã£ã¬ã¯ããªåïŒãã¡ã€ã«åïŒ ããŒãž URL ã倿Žãããã®ã§ããâŠâŠ
- date æ¥ä»ãçŸåšããæªæ¥ã ãšéå
¬éãæ«å°Ÿ
+09:00
ã§æ¥æ¬æšæºæ - category ã«ããŽãªãäºã€ä»¥äžã®å Žåãäºã€ç®ä»¥éã¯ãµãã«ããŽãªæ±ã
- tags ã¿ããè€æ°æå®å¯èœ
- keyword ããŒã¯ãŒããããŒãã«ãã meta ã¿ã°ã«äœ¿çšããã
- description ããŒãã«ãã meta ã¿ã°ã«äœ¿çšããã
- weight 䞊ã³é ãã¡ãã¥ãŒãªã©ã§äœ¿çšãWeb ãµã€ãã§ã¯å¿ é
- draft true ã®æã¯äžæžãã
hugo server -D
ã§åç §ã§ãã
ãã®ä»ãããŒãžã»èšäºå¥ã®ç»åãé ç®ã«ããå Žåãå€ãã§ãããããç»åãš OGP ã«äœ¿ãããŸãã
ãã¹ãŠèšèŒããå¿
èŠã¯ãããŸãããå€ãã¯çç¥å¯èœã§ãã
æå°é㯠titleã»dateãæ¥ä»è¡šç€ºããªããã° title ã®ã¿ã«ãªããŸãã
draft ã䜿ãããã«èšèŒãããŠããäºãå€ãã§ããã
ãµã€ãéå¶è
㯠draft ã䜿ã£ãŠããŸããã
ãªããã° draft: false ã«åãã§ã-D ãªãã§ã衚瀺ã»å
¬éã®å¯Ÿè±¡ã§ãã
---
title: "Hugo ã®ã€ããããã"
date: 2020-01-09T16:20:00+09:00
---
# Hugo ã®ã€ããããã
éçãµã€ããžã§ããŒã¿ **Hugo** ïŒãã¥ãŒãŽïŒã«ã€ããŠãŸãšããŠããŸãã
æ¬æã¯ Markdown ã§èšèŒããŠãããŸãã
åãæ¶ãç· ãªã© GitHub Flavored MarkdownïŒGFMïŒãæå¹ã§ãã
ð Markdown | ãµãããð FU-SEN
ã¡ãã¥ãŒ
Hugo ã§ã¡ãã¥ãŒæ©èœãååšããŠãããããå€ãã®ããŒãã¯ãããæ¡çšããŠããŸãã
contect/ å
ã® .md ãã¡ã€ã«ã§èšèŒããæ¹æ³ãšãconfig.toml ã«èšèŒããæ¹æ³ããããŸãã
content/ ã® .md ãã¡ã€ã«ãã¡ãã¥ãŒã«è¡šç€ºããå Žåã¯æ¬¡ã§ãã
ããã§ã¯ date ãªã©ãçç¥ããŠããŸãã
---
title: "Hugo ã®ã€ããããã"
type: "top"
menu: "main"
weight: 1
---
config.toml ã«èšèŒããå Žåã¯æ¬¡ã§ãã
ãã®å Žå name ã§èªç±ã«ã¡ãã¥ãŒã®è¡šç€ºåãä»ããããŸãã
ãŸã url 㯠/ïœ ã«ãããµã€ãå
ãhttps:// ã«ããå€éšãæå®ã§ããŸãã
[[menu.main]]
name = "Hugo ã®ã€ããããã"
weight = 1
identifier = "top"
url = "https://example.net.eu.org/"
ããŒãã«ãã£ãŠã¯ç¬èªã®ç°ãªãæ¹æ³ã§å®è£ ããŠããå Žåãããäºã«ã泚æäžããã
Minify
HTML ãªã©ã®äœèšãªç©ºçœã»æ¹è¡ããªãããŠè¡šç€ºã®é«éåãã§ããŸãã
ãã ããçææéããããã®ã§ãããŒãžæ°ã®å€ãããã°ãªã©ã¯ç¹ã«æ³šæããŠäžããã
hugo --minify
config.toml ã«è¿œå ããããã«å¯Ÿå¿ãããŠããããã§ããã
ãµã€ãéå¶è
ã詊ããæãã§ã¯åäœããŠããªãããã§ãã
Cloudflare ã䜿çšããŠããå ŽåãCloudflare åŽã§ Minify ãå®çŸã§ããŸãã
æ¹è¡ã¯æ®ãããããããœãŒã¹ãèŠããã Minify ãšããæãã§ãã
ïŒãã¡ã€ã³éžæåŸãSpeed - Optimization - Auto MinifyïŒ
Web ãµãŒãã¹ã«ãã察å¿
Vercel
Vercel 㯠Hugo ã®ãã«ãã«å¯Ÿå¿ããŠããŸãã
â² Create a Hugo Website and Deploy It with Vercel | Vercel Blog
Hugo ã®ãã£ã¬ã¯ããªæ§æãã vercel --prod
ãŸã㯠GitHubã»GitLabã»Bitbucket ãžã® git push
ã§
Hugo ã®ãã«ããè¡ããå
¬éããŸãã
éåžž Vercel ã¯ã¯ãããŠãã«ãããæ®µéã§ Hugo ã仿§ããŠããäºãèªåèªèãã
é©åãªãã«ããè¡ãããã现ããèšå®ãè¡ãå¿
èŠã¯ãããŸããã
Hugo ã®ããŒãžã§ã³ã§ä»æ§ãç°ãªãå Žåãããããã
䜿çšããŠãã Hugo ã®ããŒãžã§ã³ãæå®ããäºãããããããŸãã
vercel.json
ã§ç°å¢å€æ° HUGO_VERSION
ãèšå®ããŸããæ¬¡ã¯ 0.78.1
ã«ããŠããŸãã
{
"build": {
"env": {
"HUGO_VERSION": "0.78.1"
}
}
}
Fly
Fly
ð FLy | ãµãããð FU-SEN
Fly ã§ã¯ flyctl ã® builder éžæã« hugo-static
ããããŸãã
flyctl apps create
ãŸã㯠flyctl init
ã§éžæããŸãã
? Select builder: [Use arrows to move, type to filter]ïŒæ¬¡ãéžæïŒ
hugo-static
Hugo static build with web server builtin
ãŸã㯠fly.toml
ã«æ¬¡ã®èšèŒãå«ããŸãã
[build]
builtin = "hugo-static"
fly.toml
㯠config.toml
ãšåãå Žæã«çœ®ããŠããã
hugo server
ãšåããšããã§ flyctl deploy
ãå®è¡ããŸãã
ãªãã2020幎12æçŸåšãHugo ã®ããŒãžã§ã³ã¯éžæã§ããªãããã§ã
ãœãŒã¹ã§ã¯ Hugo 0.74.0 ã§åºå®ãããŠããããã§ãã
Q&A
æ£åŒè¡šèšã¯ Hugo ãš HUGO ã©ã¡ãã§ããïŒ
HUGO ã¯ããŽã¿ã€ããšããŠäœ¿çšãããŠããŸããããŽãšå
¬åŒãµã€ãïŒgohugo.ioïŒã®å·Šäžã®ã¿ã§ãã
äžæ¹ Hugo ã¯å
šè¬çã«ãã衚èšãããŠããŸãããããã£ãŠãHugo ãå
¬åŒçãªäžè¬è¡šèš ãšå€æã§ããŸãã
ææ°çãçŽ æ©ãç¥ãæ¹æ³ã¯ãããŸããïŒ
GitHub ãªããžããªã«å ¥ããŸããGitHub ã¯ãã°ã€ã³ããŠãããŸãã
å³äž Notifications éšåã Release only ã«å€æŽããŠäžããã
ããã«ããããã°ã€ã³ããŠãã GitHub ã¢ã«ãŠã³ãã®ã¡ãŒã«ã¢ãã¬ã¹ã«
ææ°ããŒãžã§ã³ãå
¬éãããã¿ã€ãã³ã°ã§éç¥ãå±ãããã«ãªããŸãã
ç»åãã¡ã€ã«ã¯ã©ãã«å ¥ããã°è¯ãã®ã§ããïŒ
static/
å
ã«å
¥ããã®ãäžã€ã®æ¹æ³ã§ãã
ãã®å Žå㯠public/
å
ã«ãã®ãŸãŸå
¥ããŸãã
ãŸãã contents/
å
ã«èšäºãšäžç·ã«ç»åãå
¥ããäºãã§ããŸãã
äŸãã° contents/åå/
ã§ãã£ã¬ã¯ããªãçæãã
ïŒååã¯èšäºåãªã©ã åå.md ã®ä»£ããã«ãã£ã¬ã¯ããªåãäœæïŒ
_index.md
ã®èšäºãšäžç·ã«ç»åããŸãšããŸãã
ããã«ããèšäºãšç»åãåããã£ã¬ã¯ããªã«ããã®ã§ã
ç»åã®æå®ã¯ãã¡ã€ã«åã®ã¿ã«ã§ããŸãã
config ã® permalinks ãã å¹Žã»æ ãã£ã¬ã¯ããªãçæããŠããå Žåã
ããã«åãããŠç»åãã¡ã€ã«ã眮ãã®ãæã§ãã
ã³ã¡ã³ãã¯ä»ããããŸããïŒ
Hugo 㯠config.toml ã®èšå®é
ç®ãšã㊠disqusShortname
ãçšæããŠããŠã
Disqus ã®è¿œå ã«å¯Ÿå¿ããŠããŸãããã®ãããå€ãã®ããŒã㯠Disqus ã«å¯Ÿå¿ããŠããŸãã
ã¹ããŒããã©ã³å¯Ÿå¿ã«ã§ããŸããïŒ
Hugo ã®ããŒãã¯ã»ãŒå
šãŠã¬ã¹ãã³ã·ã察å¿ã§ãã
ã¹ããŒããã©ã³ã§è¡šç€ºããæã¯æé©åãããããã«äœãããŠãããŸãã
ããœã³ã³ã§ãŠã€ã³ããŠã®æšªå¹
ãçž®ããŠã¿ããšåãããŸãã
Googlebot ã¯ã¢ãã€ã«å¯Ÿå¿ãšèªèããŸããå®å¿ããŠããŒããé©çšããŠäžããã
äžéšã®è¡šç€ºãããããã§ã
0.57 ããäžèŠ§è¡šç€ºã®ä»æ§ãå€ãã£ãŠããŸãã
ããŒãã察å¿ããŠããªãå Žåã衚瀺ããããããªããŸãã
WARN 衚瀺ãåºãŠããŸã
0.55 ããããŒãã§å€ã衚èšã®ãŸãŸã«ãªã£ãŠããå Žåã«çºçããŸãã
ããŠã³ããŒãããããŒãã§çºçããŠããå Žåã¯ã
ãã®ããŒãã® GitHub ãªããžããªãž issue ããŠä¿®æ£ãäŸé ŒããŠäžããã
ä¿®æ£ç®æã¯ layouts/ å ã®ãã³ãã¬ãŒãã«ãªããŸããããã§ã¯å ·äœçã«ã¯è§ŠããŸããã
.md ãã¡ã€ã«ã« HTML å ¥ããŠãèªèããŸãã
0.60 ãã config.toml ã«æ¬¡ã远å ã㊠HTML ãèšèŒã§ããŸãã
ãããä»ããªããš HTML ã¿ã°ãã³ã¡ã³ãã«çœ®ãæããŠç¡å¹ã«ããŸãã
[markup.goldmark.renderer]
unsafe = true
HTML ãã¡ã€ã«ã«åºåãããªãã³ã¡ã³ãã¯ã©ã®ããã«ããã°è¯ãã§ããïŒ
ãã³ãã¬ãŒããã¡ã€ã«ã§ã¯åã« HTML ã®ã³ã¡ã³ã <!-- ïœ -->
ãæå¹ã§ãã
HTML ã§ã¯ãããçç¥ãããŸãã
cotnent/
ã«å
¥ãã .md
ãã¡ã€ã«ã§ã¯ã
ã³ã¡ã³ãã倿ããããïŒããã©ã«ãïŒããã®ãŸãŸåºåãããŸãã
ã·ã§ãŒãã³ãŒãã§å¯ŸåŠããææ®µã䜿ããŸãã
layouts/shortcodes/
å
ã«ä»»æã® ã³ãŒãå.html
ã§
次ã®äžèº«ãå
¥ãããã¡ã€ã«ãçæããŸãã
{{ if .Inner }}{{ end }}
comment.html
ã§äœæããå Žåã.md ãã¡ã€ã«å
ã¯æ¬¡ã®ã³ã¡ã³ãèšèŒãå¯èœã«ãªããŸãã
{{< comment ã³ã¡ã³ã >}}{{< /comment >}}
äžã®æ¹æ³ã§ãšã©ãŒã«ãªãå Žå㯠"ã³ã¡ã³ã"
ãš "ïœ"
ã§å²ã£ãŠäžããã
{{< comment >}}ã³ã¡ã³ã{{< /comment >}}
äžã®æ¹æ³ã¯è€æ°è¡èšèŒã§ããŸãã
ãã®æ¹æ³ã¯ Hugo å
¬åŒãµã€ãã§ todo.html
ãšããŠå®éã«äœ¿ãããŠããŸãã
layouts/shortcodes/todo.html | GitHub gohugoio/hugoDocs
åŒ·å¶æ¹è¡ãããå Žåã¯ïŒ
Hugo ã® .md ãã¡ã€ã«å ã§ã¯ãæ¹è¡ãå ¥ããŠãæ¹è¡ãããŸããã空çœã«ãªããŸãã
æ¹è¡ãããå Žåã¯ãè¡æ«ã»æ¹è¡çŽåã§ \
ïŒåè§ ïŒŒ ãŸã㯠åè§ ï¿¥ïŒãå
¥ãããã
åè§ã¹ããŒã¹ã 2 æåå
¥ããŸãã
HTML ãæå¹ã«ããŠããå Žå㯠<br>
ã䜿ããŸãã
TOCïŒTable Of ContentïŒã§èªèãããªãèŠåºããäœãã«ã¯ïŒ
HTML ã® <h1>
ïœ<h6>
ã¿ã°ã¯ TOC ã§èªèãããŸããã
ããŒãž URL ã倿Žãããã®ã§ããâŠâŠ
config.toml ã§ permalinks ã䜿çšããŸãã
ãªãå Žåã¯è¿œå ãããå Žåã¯å€æŽããŸãã
éåžžããã°ã§äœ¿ããã content/post/ å
ã Web ãµã€ãã®ããã«äœ¿ãç®çã§
https://ãµã€ã/ã¿ã€ãã«/
ã«ãããå Žåã¯æ¬¡ã®ããã«ããŸãã
[permalinks]
post = "/:title/"
æ¥æ¬èªãæå¹ãª URL ãšããŠæ£ããåäœããŸããã
ãµãŒãã«ãã£ãŠäžå
·åãããå ŽåããããŸãã
ãŸã FTP ã§ã¢ããããŒãããå Žåãã¡ã€ã«åã倿ããªãã§äžããã
/:year/:month/:slug/ ã /:year/:filename/ ãšããæå®ãã§ããŸãã
:slug 㯠content/ å
ã®é
ç®ãšã㊠slug ãå
¥ããäºã§ã
ããããã£ã¬ã¯ããªåïŒãã¡ã€ã«åïŒã«ãªããŸãã
ãªãå Žå㯠title ãæ±ãããŸãã®ã§ãé垞㯠titleã
å¿
èŠã«å¿ã㊠slug ä»å ãšããå Žåã§ã :slug ã䜿ããŸãã
URL Management | Hugo Documents
ç¬èªã® CSS ãå«ãããå Žåã¯ã©ã®ããã«ããã°è¯ãã§ããïŒ
ããŒãã«ãã£ãŠç°ãªããŸããäž»ã«æ¬¡ã®ããããã§ãã
- config.toml ã§ customCSS ãªã©ã®é
ç®ãããå Žåã
.css åãèšèŒããstatic å ã«çæããŸãã - themes/static/css/ å
ã«ç©ºã® custom.css ãªã©ãããå Žåã
ããã static/css/ å ã«å ¥ããŠè¿œå ããŸãã - ããããèŠã€ãããªãå Žå㯠themes/ããŒãå/layouts/partials/ å
ã確èªãã
head ã¿ã°å ãèšèŒããŠãã html ãã¡ã€ã«ãèŠã€ãåºã㊠layouts/partials/ å ã«å ¥ãã
CSS ã远å ãããã远èšããŸããhead.html ã«è¿œèšããå Žåãå€ãã§ãã - themes/ããŒãå/layouts/partials/ å
ã«ãªãå Žåã¯
themes/ããŒãå/layouts/_defaults/baseof.html ã«èšèŒãããŠããŸãã
baseof.html ã layouts/partials/_defualts/ å ã«å ¥ãã远èšããŸãã
ããã°ããŒãã Web ãµã€ãåãã«äœ¿çšã§ããŸããïŒ
å¯èœã§ãããã¡ãã£ãšæéãå¿
èŠã§ãããŒãã«ãã£ãŠå¯Ÿå¿ãç°ãªããŸãã
themes/ããŒãå/layouts/index.html ã倿Žããå¿
èŠããããŸãã®ã§ã
layouts/index.html ãžã³ããŒããŠç·šéããŸãã
äž»ã«æ¬¡ã®ããããã«ãªããŸãã
- themes/ããŒãå/layouts/single.html ãšåçã«çœ®ãæããŸãã
- é©åãªå Žæã«
{{ .Content }}
ãå ããŸããããã« .md ãã¡ã€ã«ã®å 容ãå ¥ããŸãã
å®å
šã« .md ãã¡ã€ã«ã®å
容ã«ããå Žåã¯ãèšäºäžèŠ§è¡šç€ºéšåãåé€ããŸããã
ãããŠèšäºäžèŠ§è¡šç€ºãæ®ããŠããŒãžã®ã¡ãã¥ãŒäžèŠ§ã«æ¹è¯ããäºãã§ããŸãã
ãã®å Žå .md ãã¡ã€ã«ã§ weight ã䜿ã£ãŠè¡šç€ºé ãæå®ã§ããŸãã
ïŒweight 㯠date ãããåªå
ãããŸãïŒ
ããŒãžçæã¯ content/ çŽäžã« ãã¡ã€ã«å.md ã§çæãããã
次ã config.toml
ã«å
¥ããäžã§ content/post/ ã« .md ãã¡ã€ã«ãå
¥ããŸãã
[permalinks]
post = "/:slug/"
ãªããthemes å
ã¯ããŒãã®æŽæ°ã«äŒŽã£ãŠ
git clone
ãŸã㯠git submodule update
ã§æŽæ°ããã®ã§ã
themes å
ã®ãã¡ã€ã«å€æŽã»åé€ãªã©ã¯è¡ããªãã§äžããã
Not Found ããŒãžã¯çæããŸããïŒ
Hugo ã§ã¯ Not Found ããŒãžã 404.html ã§èæ
®ãããŠããŸãã
Apache ãæ¡çšãããŠãããµãŒãã§ .htaccess ã䜿ããå Žåã¯ã次ã§é©çšã§ããŸãã
ErrorDocument 404 /404.html
ããŒãã§èæ
®ãããŠããå Žåãthemes/ããŒãå/layouts/404.html ãååšããŠããŸãã
ç¬èªã®ããŒãžã«ãããå Žå㯠404.html ã layouts/ å
ã«ã³ããŒããŠç·šéããŠäžããã
RSSã»ãµã€ããããã¯çæããŸããïŒ
RSS 㯠index.xmlïŒãã©ãŒããã㯠RSS 2.0ïŒããµã€ãããã㯠sitemap.xml ã§çæãããŸãã
ãµã€ãããã㯠date ã®æ¥æãåæ ãããã®ã§ãã¯ããŒã©ãŒã®åéã«ã广çã§ãã
ãŸã config.toml
ã« enableRobotsTXT = "true"
ãå«ãããš robots.txt ãçæãããŸããã
ããã©ã«ãã§ã¯åã« 1 è¡ã® robots.txt
ãçæããŸãã
User-agent: *
Sitemap ãªã©ãå«ããããããããŠããã䜿ããã«
static/
å
ãž robots.txt
ãäœã£ãŠãè¯ãã§ãããã
ããã㯠layouts/
å
ã§åãã³ãã¬ãŒããçæã§ããã®ã§ã
现ããå¶åŸ¡ããäºãã§ããŸãã
ð Hugo ã® robots.txt ãš Sitemapã| ãµãããð FU-SEN
çµµæåã§ã¯ãªãã¢ã€ã³ã³ã¯ã©ã®ããã«ããŠè¡šç€ºããã®ã§ããïŒ
Font Amesome ãå°å
¥ãããŠããããŒããå€ãã§ãã
äžé
ç®ã® HTML ãæå¹ã«ããäºã§ãi ã¿ã°ã« style ãå«ããŠè¡šç€ºã§ããŸãã
Font Amesome
ð Font Awesome | ãµãããð FU-SEN
public ãã©ã«ãã®æ¥æããããããªã£ãŠããŸãã
hugo creating invalid timestamps in folder public #6161 | GitHub gohugoio/hugo issues
é·ãçºçããŠããäžå ·åã§ãã
ãããåå ã§æŽã«å¥ã®åé¡ãçºçããŠããå Žåã¯ã
hugo
å®è¡åŸã«ã³ãã³ãã§ public ãã£ã¬ã¯ããªã®æ¥æãæŽæ°ããŠäžããã
å€ãã® OS ãç°å¢ã§ã¯ touch
ã䜿ããŸããWindows ã§ã¯ Git Bash ãªã©ã§æå¹ã§ãã
hugo
touch public
Windows ã® PowerShell ã§ã¯ã次ã®ã³ãã³ãã§æŽæ°ããäºãã§ããŸãã
hugo
sp public LastWriteTime $(Get-Date)