43 KiB
title | weight | draft | description | slug | tags | series | series_order | |||
---|---|---|---|---|---|---|---|---|---|---|
èšå® | 4 | false | Blowfish ã§äœ¿çšå¯èœãªãã¹ãŠã®èšå®å€æ° | configuration |
|
|
4 |
Blowfish ã¯é«åºŠã«ã«ã¹ã¿ãã€ãºå¯èœãªããŒãã§ãããææ°ã® Hugo æ©èœã䜿çšããŠèšå®æ¹æ³ãã·ã³ãã«ã«ããŠããŸãã
ãã®ããŒãã«ã¯ãåºæ¬çãªããã°ãŸãã¯éç Web ãµã€ããããã«ç«ã¡äžããŠå®è¡ã§ããããã©ã«ãèšå®ãä»å±ããŠããŸãã
{{< alert "fire" >}} Blowfish ãç°¡åã«äœ¿ãå§ããããããã«ãæ°ãã CLI ããŒã«ããªãªãŒã¹ããŸãããã€ã³ã¹ããŒã«ãšèšå®ã«åœ¹ç«ã¡ãŸãã ã°ããŒãã«ã« CLI ããŒã«ãã€ã³ã¹ããŒã«ããã«ã¯ã以äžã䜿çšããŸãã
npx blowfish-tools
{{< /alert >}}
ããŒãã«ãã³ãã«ãããŠããèšå®ãã¡ã€ã«ã¯ãããã©ã«ãã® Hugo æ§æã§ãã TOML 圢åŒã§æäŸãããŠããŸããå¿ èŠã«å¿ããŠãèšå®ã YAML ãŸã㯠JSON ã«å€æã§ããŸãã
ããã©ã«ãã®ããŒãèšå®ã¯åãã¡ã€ã«ã«èšèŒãããŠãããããå¿ èŠã«å¿ããŠèšå®ãèªç±ã«èª¿æŽã§ããŸãã
{{< alert >}}
[ã€ã³ã¹ããŒã«æé ]({{< ref "/docs/installation#set-up-theme-configuration-files" >}}) ã§æŠèª¬ãããŠããããã«ãHugo ãããžã§ã¯ãã® config/_default/
ãã©ã«ãå
ã®ãã¡ã€ã«ãä¿®æ£ãããããžã§ã¯ãã«ãŒãã® config.toml
ãã¡ã€ã«ãåé€ããããšã§ãããŒãèšå®ã調æŽããå¿
èŠããããŸãã
{{< /alert >}}
ãµã€ãèšå®
ããŒãå šäœã§æšæºã® Hugo èšå®å€æ°ãé©çšãããŸãããæé©ãªãšã¯ã¹ããªãšã³ã¹ãåŸãããã«èšå®ããå¿ èŠãããç¹å®ã®äºé ããããŸãã
ãµã€ãèšå®ã¯ config/_default/config.toml
ãã¡ã€ã«ã§ç®¡çãããŸãã äžã®è¡šã¯ãBlowfish ãæŽ»çšãããã¹ãŠã®èšå®ã®æŠèŠã瀺ããŠããŸãã
ãã®è¡šã§æäŸãããŠãã倿°åã¯ãTOML ããŒã¿æ§é ãç°¡çŽ åããããã«ããã衚èšã䜿çšããŠããããšã«æ³šæããŠãã ããïŒã€ãŸãã outputs.home
㯠[outputs] home
ãæããŸãïŒã
Name | Default | Description |
---|---|---|
theme |
"blowfish" |
Hugo Modules ã䜿çšããŠããå Žåã¯ããã®èšå®å€ãåé€ããå¿
èŠããããŸãã ä»ã®ãã¹ãŠã®ã€ã³ã¹ããŒã«ã¿ã€ãã§ã¯ãããŒããæ©èœããããã«ããã blowfish ã«èšå®ããå¿
èŠããããŸãã |
baseURL |
èšå®ãªã | Webãµã€ãã®ã«ãŒããžã® URL ã§ãã |
defaultContentLanguage |
"en" |
ãã®å€ã¯ãããŒãã³ã³ããŒãã³ããšã³ã³ãã³ãã®ããã©ã«ãèšèªã決å®ããŸãã ãµããŒããããŠããèšèªã³ãŒãã«ã€ããŠã¯ã以äžã® èšèªãš i18n ã»ã¯ã·ã§ã³ãåç §ããŠãã ããã |
enableRobotsTXT |
true |
æå¹ã«ãããšãæ€çŽ¢ãšã³ãžã³ããµã€ãå
šäœãã¯ããŒã«ã§ããããã«ãã robots.txt ãã¡ã€ã«ããµã€ãã«ãŒãã«äœæãããŸãã ãããããäœæããç¬èªã® robots.txt ãæäŸããå Žåã¯ãfalse ã«èšå®ãããã¡ã€ã«ã static ãã£ã¬ã¯ããªã«é
眮ããŸãã å®å
šã«å¶åŸ¡ããã«ã¯ããã®ãã¡ã€ã«ãçæããããã® [ã«ã¹ã¿ã ã¬ã€ã¢ãŠã]({{< ref "content-examples#custom-layouts" >}}) ãæäŸã§ããŸãã |
pagination.pagerSize |
10 |
èšäºãªã¹ãã®åããŒãžã«ãªã¹ããããèšäºã®æ°ã§ãã |
summaryLength |
0 |
[ããã³ããã¿ãŒ]({{< ref "front-matter" >}}) ã§æäŸãããŠããªãå Žåã«ãèšäºã®æŠèŠãçæããããã«äœ¿çšãããåèªã®æ°ã§ãã å€ 0 ã¯æåã®æã䜿çšããŸãã æŠèŠãé衚瀺ã«ãªã£ãŠããå Žåããã®å€ã¯å¹æããããŸããã |
outputs.home |
["HTML", "RSS", "JSON"] |
ãµã€ãçšã«çæãããåºå圢åŒã§ãã Blowfish ã§ã¯ããã¹ãŠã®ããŒãã³ã³ããŒãã³ããæ£ããæ©èœããããã« HTMLãRSSãJSON ãå¿ èŠã§ãã |
permalinks |
èšå®ãªã | ããŒããªã³ã¯ã®èšå®ã«ã€ããŠã¯ãHugo ããã¥ã¡ã³ã ãåç §ããŠãã ããã |
taxonomies |
èšå®ãªã | åé¡ã®èšå®ã«ã€ããŠã¯ã[ã³ã³ãã³ãã®æŽç]({{< ref "getting-started#organising-content" >}}) ã»ã¯ã·ã§ã³ãåç §ããŠãã ããã |
ãµã ãã€ã«
Blowfish ã¯ãèšäºã«èŠèŠçãªãµããŒããç°¡åã«è¿œå ã§ããããã«æ§ç¯ãããŠããŸããHugo ã®èšäºæ§é ã«æ
£ããŠããå Žåã¯ãèšäºãã©ã«ãå
ã« feature*
ã§å§ãŸãç»åãã¡ã€ã«ïŒã»ãšãã©ãã¹ãŠã®åœ¢åŒããµããŒããããŠããŸããã.png
ãŸã㯠.jpg
ããå§ãããŸãïŒãé
眮ããã ãã§ããããã§ãBlowfish 㯠Webãµã€ãå
ã§ãµã ãã€ã«ãšããŠç»åã䜿çšãããããœãŒã·ã£ã«ãã©ãããã©ãŒã å
šäœã§ oEmbed ã«ãŒãã«äœ¿çšãããã§ããŸãã
[Here]({{< ref "thumbnails" >}}) is also a guide with more info and a [sample]({{< ref "thumbnail_sample" >}}) if you want to see how you can do it.
èšèªãš i18n
Blowfish ã¯å€èšèª Webãµã€ãåãã«æé©åãããŠãããããŒãã¢ã»ããã¯ããã«äœ¿ããããã«è€æ°ã®èšèªã«ç¿»èš³ãããŠããŸãã èšèªèšå®ã䜿çšãããšãã³ã³ãã³ãã®è€æ°ã®ããŒãžã§ã³ãçæããŠã蚪åè ã«æ¯åœèªã§ã«ã¹ã¿ãã€ãºããããšã¯ã¹ããªãšã³ã¹ãæäŸã§ããŸãã
ãã®ããŒãã¯çŸåšãããã©ã«ãã§æ¬¡ã®èšèªããµããŒãããŠããŸã:
èšèª | ã³ãŒã |
---|---|
ã¢ã©ãã¢èª | ar |
ãã«ã¬ãªã¢èª | bg |
ãã³ã¬ã«èª | bn |
ã«ã¿ããã¢èª | ca |
ãã§ã³èª | cs |
ãã€ãèª | de |
è±èª | en |
ãšã¹ãã©ã³ãèª | eo |
ã¹ãã€ã³èªïŒã¹ãã€ã³ïŒ | es |
ãã£ã³ã©ã³ãèª | fi |
ãã©ã³ã¹èª | fr |
ããã©ã€èª | he |
ã¯ãã¢ãã¢èª | hr |
ãã³ã¬ãªãŒèª | hu |
ã€ã³ããã·ã¢èª | id |
ã€ã¿ãªã¢èª | it |
æ¥æ¬èª | ja |
éåœèª | ko |
ãªã©ã³ãèª | nl |
ããŒã©ã³ãèª | pl |
ãã«ãã¬ã«èªïŒãã©ãžã«ïŒ | pt-br |
ãã«ãã¬ã«èªïŒãã«ãã¬ã«ïŒ | pt-pt |
ã«ãŒããã¢èª | ro |
ãã·ã¢èª | ru |
ãã«ã³èª | tr |
ãããã èª | vi |
äžåœèªïŒç°¡äœåïŒ | zh-cn |
äžåœèªïŒç¹äœåïŒ | zh-tw |
ããã©ã«ãã®ç¿»èš³ã¯ã翻蚳æååãå«ãã«ã¹ã¿ã ãã¡ã€ã« i18n/[èšèªã³ãŒã].yaml
ãäœæããããšã§ãªãŒããŒã©ã€ãã§ããŸãã ãã®æ¹æ³ã䜿çšããŠæ°ããèšèªã远å ããããšãã§ããŸãã æ°ãã翻蚳ãã³ãã¥ããã£ãšå
±æãããå Žåã¯ããã«ãªã¯ãšã¹ããéã㊠ãã ããã
èšå®
å¯èœãªéãæè»ã«å¯Ÿå¿ããããã«ãWeb ãµã€ãã®åèšèªã®èšèªèšå®ãã¡ã€ã«ãäœæããå¿
èŠããããŸããããã©ã«ãã§ã¯ãBlowfish ã«ã¯ config/_default/languages.en.toml
ã«è±èªã®èšèªèšå®ãå«ãŸããŠããŸãã
ããã©ã«ãã®ãã¡ã€ã«ã¯ã远å ã®èšèªãäœæããããã®ãã³ãã¬ãŒããšããŠäœ¿çšããããšããè±èªä»¥å€ã®èšèªã§ Web ãµã€ããäœæããå Žåã¯ååã倿Žããããšãã§ããŸããlanguages.[èšèªã³ãŒã].toml
圢åŒã䜿çšããŠãã¡ã€ã«ã«ååãä»ããã ãã§ãã
{{< alert >}}
泚: ãµã€ãèšå® ã® defaultContentLanguage
ãã©ã¡ãŒã¿ããèšèªèšå®ãã¡ã€ã«åã®èšèªã³ãŒããšäžèŽããŠããããšã確èªããŠãã ããã
{{< /alert >}}
ã°ããŒãã«
åå | ããã©ã«ã | 説æ |
---|---|---|
languageCode |
"en" |
ãã®ãã¡ã€ã«ã® Hugo èšèªã³ãŒãã§ãããããã¬ãã«èšèªïŒäŸïŒ en ïŒãŸãã¯ãµãããªã¢ã³ãïŒäŸïŒ en-au ïŒã«ããããšãã§ãããã¡ã€ã«åã®èšèªã³ãŒããšäžèŽããå¿
èŠããããŸããHugo ã¯ãã®å€ãåžžã«å°æåã§ããããšãæ³å®ããŠããŸããé©å㪠HTML æºæ ã®ããã«ã倧æåãšå°æåãåºå¥ãã isoCode ãã©ã¡ãŒã¿ãèšå®ããŸãã |
languageName |
"English" |
èšèªã®ååã§ãã |
weight |
1 |
éã¿ã¯ãå€èšèªãµã€ããæ§ç¯ãããšãã®èšèªã®é åºã決å®ããŸãã |
title |
"Blowfish" |
Web ãµã€ãã®ã¿ã€ãã«ã§ããããã¯ããµã€ãã®ããããŒãšããã¿ãŒã«è¡šç€ºãããŸãã |
ãã©ã¡ãŒã¿ãŒ
åå | ããã©ã«ã | 説æ |
---|---|---|
params.displayName |
"EN" |
Web ãµã€ãã«èšèªã衚瀺ããããšãã«äœ¿çšãããååã§ãã |
params.isoCode |
"en" |
HTML ã¡ã¿ããŒã¿çšã® ISO èšèªã³ãŒãã§ãããããã¬ãã«èšèªïŒäŸïŒ en ïŒãŸãã¯ãµãããªã¢ã³ãïŒäŸïŒ en-AU ïŒã«ããããšãã§ããŸãã |
params.rtl |
false |
ããã RTL èšèªãã©ããã§ããtrue ã«èšå®ãããšãã³ã³ãã³ããå³ããå·Šã«äžŠã¹æ¿ããããŸãã Blowfish 㯠RTL èšèªãš LTR èšèªã®åæäœ¿çšãå®å
šã«ãµããŒãããŠãããäž¡æ¹ã«åçã«èª¿æŽãããŸãã |
params.dateFormat |
"2 January 2006" |
ãã®èšèªã§ã®æ¥ä»ã®ãã©ãŒãããæ¹æ³ã§ãã䜿çšã§ãã圢åŒã«ã€ããŠã¯ãHugo ããã¥ã¡ã³ã ãåç §ããŠãã ããã |
params.logo |
èšå®ãªã | assets/ ãã©ã«ãå
ã®ãµã€ãããŽãã¡ã€ã«ãžã®çžå¯Ÿãã¹ã§ããããŽãã¡ã€ã«ã¯2åã®è§£ååºŠã§æäŸããå¿
èŠããããããããç»åãµã€ãºããµããŒãããŠããŸãã |
params.secondaryLogo |
èšå®ãªã | assets/ ãã©ã«ãå
ã®ã»ã«ã³ããªãµã€ãããŽãã¡ã€ã«ãžã®çžå¯Ÿãã¹ã§ãã ããŽãã¡ã€ã«ã¯2åã®è§£ååºŠã§æäŸããå¿
èŠããããããããç»åãµã€ãºããµããŒãããŠããŸãã ããã¯ãlogo ãšã¯å転/察ç
§çãªã«ã©ãŒã¹ããŒã ã§ããå¿
èŠããããŸããèšå®ãããŠããå Žåããã®ããŽã¯ããŠãŒã¶ãŒã defaultAppearance ã¢ãŒãããåãæ¿ãããšãã«è¡šç€ºãããŸãã |
params.description |
èšå®ãªã | Web ãµã€ãã®èª¬æã§ããããã¯ãµã€ãã®ã¡ã¿ããŒã¿ã§äœ¿çšãããŸãã |
params.copyright |
èšå®ãªã | ãµã€ãããã¿ãŒã®èäœæš©ã¡ãã»ãŒãžã® Markdown æååã«ã¯ããã¬ãŒã¹ãã«ã { year } ãå«ããŠçŸåšã®å¹Žãåçã«æ¿å
¥ã§ããŸããæå®ãããŠããªãå ŽåãBlowfish ã¯ãµã€ã title ã䜿çšããŠèäœæš©æååãèªåçã«çæããŸãã |
èè (Author)
åå | ããã©ã«ã | 説æ |
---|---|---|
author.name |
èšå®ãªã | èè ã®ååã§ããããã¯ãèšäºã®ããã¿ãŒãšããããã£ãŒã«ã¬ã€ã¢ãŠãã䜿çšãããŠããå Žåã¯ããŒã ããŒãžã«è¡šç€ºãããŸãã |
author.image |
èšå®ãªã | èè
ã®ç»åãã¡ã€ã«ãžã®ãã¹ã§ããç»åã¯çžŠæšªæ¯ 1:1 ã§ããå¿
èŠããããŸããç»åã¯ããµã€ãã® assets/ ãã©ã«ãã«é
眮ããããšããå€éš URL ã«ããããšãã§ããŸãã |
author.headline |
èšå®ãªã | èè ã®èŠåºããå«ã Markdown æååã§ãããããã£ãŒã«ããŒã ããŒãžã®èè ã®ååã«äžã«è¡šç€ºãããŸãã |
author.bio |
èšå®ãªã | èè ã®ç¥æŽãå«ã Markdown æååã§ããèšäºã®ããã¿ãŒã«è¡šç€ºãããŸãã |
author.links |
èšå®ãªã | èè
ã®è©³çްãšäžç·ã«è¡šç€ºãããªã³ã¯ã§ããèšå®ãã¡ã€ã«ã«ã¯ãã³ã¡ã³ããå€ãã ãã§æå¹ã«ãªããªã³ã¯ã®äŸãå«ãŸããŠããŸãããªã³ã¯ã衚瀺ãããé åºã¯ãé
åã«è¡šç€ºãããé åºã«ãã£ãŠæ±ºãŸããŸããassets/icons/ ã«å¯Ÿå¿ãã SVG ã¢ã€ã³ã³ã¢ã»ãããæäŸããããšã§ãã«ã¹ã¿ã ãªã³ã¯ã远å ã§ããŸãã |
ã¡ãã¥ãŒ(Menus)
Blowfish ã¯ãèšèªåºæã®ã¡ãã¥ãŒèšå®ããµããŒãããŠããŸããã¡ãã¥ãŒèšå®ãã¡ã€ã«ã¯ãèšèªãã¡ã€ã«ãšåãåœå圢åŒã«åŸããŸãããã¡ã€ã«åã«èšèªã³ãŒããæå®ããã ãã§ãHugo ã¯ãã¡ã€ã«ãã©ã®èšèªã«é¢é£ããŠããããèªèããŸãã
ã¡ãã¥ãŒèšå®ãã¡ã€ã«ã®ååã¯ã menus.[language-code].toml
圢åŒã§ããã¡ãã¥ãŒèšå®ã§äœ¿çšãããèšèªã³ãŒããèšèªèšå®ãšäžèŽããŠããããšãåžžã«ç¢ºèªããŠãã ããã
[ã¯ããã«]({{< ref "getting-started#menus" >}}) ã»ã¯ã·ã§ã³ã§ã¯ããã®ãã¡ã€ã«ã®æ§é ã«ã€ããŠè©³ãã説æããŠããŸãã詳现ãªèšå®äŸã«ã€ããŠã¯ãHugo ã¡ãã¥ãŒ ããã¥ã¡ã³ã ãåç §ã§ããŸãã
ããŒããã©ã¡ãŒã¿ãŒ(Theme parameters)
Blowfish ã¯ãããŒãã®æ©èœãå¶åŸ¡ãã倿°ã®èšå®ãã©ã¡ãŒã¿ãæäŸããŸããäžã®è¡šã¯ãconfig/_default/params.toml
ãã¡ã€ã«ã§äœ¿çšå¯èœãªãã¹ãŠã®ãã©ã¡ãŒã¿ã®æŠèŠã瀺ããŠããŸãã
ããã«ããèšäºã®ããã©ã«ãã®å€ãã¯ãããã³ããã¿ãŒã§æå®ããããšã§ãèšäºããšã«ãªãŒããŒã©ã€ãã§ããŸãã詳现ã«ã€ããŠã¯ã[ããã³ããã¿ãŒ]({{< ref "front-matter" >}}) ã»ã¯ã·ã§ã³ãåç §ããŠãã ããã
ã°ããŒãã«
åå | ããã©ã«ã | 説æ |
---|---|---|
colorScheme |
"blowfish" |
䜿çšããããŒãã®ã«ã©ãŒããŒãã§ããæå¹ãªå€ã¯ãblowfish ïŒããã©ã«ãïŒãavocado ãfire ãocean ãforest ãprincess ãneon ãbloody ãterminal ãmarvel ãnoir ãautumn ãcongo ãslate ã§ãã詳现ã«ã€ããŠã¯ã[ã«ã©ãŒããŒã]({{< ref "getting-started#colour-schemes" >}}) ã»ã¯ã·ã§ã³ãåç
§ããŠãã ããã |
defaultAppearance |
"light" |
ããã©ã«ãã®ããŒãã®å€èгã§ããlight ãŸã㯠dark ã®ããããã§ãã |
autoSwitchAppearance |
true |
蚪åè
ã®ãªãã¬ãŒãã£ã³ã°ã·ã¹ãã ã®èšå®ã«åºã¥ããŠããŒãã®å€èгãèªåçã«åãæ¿ãããã©ããã§ããfalse ã«èšå®ãããšããµã€ãã¯åžžã« defaultAppearance ã䜿çšããŸãã |
enableSearch |
false |
ãµã€ãå
æ€çŽ¢ãæå¹ãã©ããã§ããtrue ã«èšå®ãããšãæ€çŽ¢æ©èœãæå¹ã«ãªããŸããæ€çŽ¢æ©èœã¯ããµã€ãèšå® ã® outputs.home èšå®ãæ£ããèšå®ãããŠãããã©ããã«äŸåããããšã«æ³šæããŠãã ããã |
enableCodeCopy |
false |
<code> ãããã¯ã®ã¯ãªããããŒããžã®ã³ããŒãã¿ã³ãæå¹ã«ãããã©ããã§ããã³ãŒãã³ããŒãæ£ããæ©èœããã«ã¯ãhighlight.noClasses ãã©ã¡ãŒã¿ã false ã«èšå®ããå¿
èŠããããŸãã以äžã® ãã®ä»ã®èšå®ãã¡ã€ã« ã«ã€ããŠèªãã§ãã ããã |
mainSections |
èšå®ãªã | æè¿ã®èšäºãªã¹ãã«è¡šç€ºããã»ã¯ã·ã§ã³ã§ããæå®ããªãå Žåã¯ãèšäºæ°ãæãå€ãã»ã¯ã·ã§ã³ã䜿çšãããŸãã |
showViews |
èšå®ãªã | èšäºãšãªã¹ãã®è¡šç€ºåæ°ã衚瀺ãããã©ããã§ããããã«ã¯ Firebase çµ±åãæå¹ã«ããå¿ èŠããããŸãã以äžãã芧ãã ããã |
showLikes |
èšå®ãªã | èšäºãšãªã¹ãã®ãããã衚瀺ãããã©ããã§ããããã«ã¯ Firebase çµ±åãæå¹ã«ããå¿ èŠããããŸãã以äžãã芧ãã ããã |
robots |
èšå®ãªã | ããããããµã€ããã©ã®ããã«åŠçãããã瀺ãæååã§ããèšå®ãããŠããå ŽåãããŒãžããããŒã«åºåãããŸããæå¹ãªå€ã«ã€ããŠã¯ãGoogle ã®ããã¥ã¡ã³ã ãåç §ããŠãã ããã |
disableImageZoom |
false |
ãµã€ãå ã®ãã¹ãŠã®ç»åã®ç»åãºãŒã æ©èœãç¡å¹ã«ããŸãã |
disableImageOptimization |
false |
ãµã€ãå ã®ãã¹ãŠã®ç»åã®ç»åãµã€ãºå€æŽãšæé©åæ©èœãç¡å¹ã«ããŸãã |
disableTextInHeader |
false |
ããããŒã®ããã¹ããç¡å¹ã«ããŸããããŽããŒã¹ã®ããããŒã«åœ¹ç«ã¡ãŸãã |
defaultBackgroundImage |
èšå®ãªã | background ããŒã ããŒãžã¬ã€ã¢ãŠããš background ããŒããŒã¹ã¿ã€ã«ã®äž¡æ¹ã®ããã©ã«ãã®èæ¯ç»åã§ãã |
defaultFeaturedImage |
èšå®ãªã | èšäºå
šäœã®ãã¹ãŠã® featured ç»åã®ããã©ã«ãã®èæ¯ç»åã§ããããŒã«ã«ã® featured ç»åã«ãã£ãŠãªãŒããŒã©ã€ããããŸãã |
highlightCurrentMenuArea |
èšå®ãªã | ã¡ã€ã³ã¡ãã¥ãŒã®ã¡ãã¥ãŒé ç®ãéžæãããŠãããšãã«ããŒã¯ãä»ããŸãã |
smartTOC |
èšå®ãªã | ã¹ããŒãç®æ¬¡ãã¢ã¯ãã£ãã«ããŸãã衚瀺ãããŠããé ç®ã匷調衚瀺ãããŸãã |
smartTOCHideUnfocusedChildren |
èšå®ãªã | ã¹ããŒãç®æ¬¡ããªã³ã«ãªã£ãŠããå Žåããã©ãŒã«ã¹ãããŠããªããšãã«ãããŒãã«ã®ããæ·±ãã¬ãã«ãé衚瀺ã«ãªããŸãã |
ããããŒ(Header)
åå | ããã©ã«ã | 説æ |
---|---|---|
header.layout |
"basic" |
ãµã€ãå
šäœã®ããããŒãå®çŸ©ããŸãããµããŒããããŠããå€ã¯ãbasic ãfixed ãfixed-fill ãfixed-fill-blur ã§ãã |
ããã¿ãŒ(Footer)
åå | ããã©ã«ã | 説æ |
---|---|---|
footer.showMenu |
true |
ããã¿ãŒã¡ãã¥ãŒã衚瀺/é衚瀺ã«ããŸããããã¯ãconfig/_default/menus.en.toml ãã¡ã€ã«ã® [[footer]] ã»ã¯ã·ã§ã³ã§èšå®ã§ããŸãã |
footer.showCopyright |
true |
ãµã€ãã®ããã¿ãŒã«èäœæš©æååã衚瀺ãããã©ããã§ããæååèªäœã¯ãèšèªèšå® ã® copyright ãã©ã¡ãŒã¿ã䜿çšããŠã«ã¹ã¿ãã€ãºã§ããããšã«æ³šæããŠãã ããã |
footer.showThemeAttribution |
true |
ãµã€ãã®ããã¿ãŒã«ãpowered byãããŒãã®åž°å±ã衚瀺ãããã©ããã§ãããã®ã¡ãã»ãŒãžãç¡å¹ã«ããå Žåã¯ããµã€ãã®ä»ã®å ŽæïŒããšãã°ãabout ããŒãžïŒã§ããŒãã®åž°å±ãæ€èšããŠãã ããã |
footer.showAppearanceSwitcher |
false |
ãµã€ãã®ããã¿ãŒã«å€èгã¹ã€ããã£ãŒã衚瀺ãããã©ããã§ãã ãã©ãŠã¶ã®ããŒã«ã«ã¹ãã¬ãŒãžã䜿çšããŠã蚪åè ã®èšå®ãä¿æãããŸãã |
footer.showScrollToTop |
true |
true ã«èšå®ãããšãããããžã¹ã¯ããŒã«ã®ç¢å°ã衚瀺ãããŸãã |
ããŒã ããŒãž(Homepage)
åå | ããã©ã«ã | 説æ |
---|---|---|
homepage.layout |
"profile" |
ããŒã ããŒãžã®ã¬ã€ã¢ãŠãã§ããæå¹ãªå€ã¯ãpage ãprofile ãhero ãcard ãbackground ãcustom ã§ããcustom ã«èšå®ããå Žåã/layouts/partials/home/custom.html ãã¡ã€ã«ãäœæããŠç¬èªã®ã¬ã€ã¢ãŠããæäŸããå¿
èŠããããŸãã詳现ã«ã€ããŠã¯ã[ããŒã ããŒãžã¬ã€ã¢ãŠã]({{< ref "homepage-layout" >}}) ã»ã¯ã·ã§ã³ãåç
§ããŠãã ããã |
homepage.homepageImage |
èšå®ãªã | hero ã¬ã€ã¢ãŠããš card ã¬ã€ã¢ãŠãã§äœ¿çšãããç»åã§ããã¢ã»ãããã£ã¬ã¯ããªããã®ããŒã«ã«ç»åãŸãã¯å€éšç»å URL ãšããŠèšå®ã§ããŸãã詳现ã«ã€ããŠã¯ã[ããŒã ããŒãžã¬ã€ã¢ãŠã]({{< ref "homepage-layout" >}}) ã»ã¯ã·ã§ã³ãåç
§ããŠãã ããã |
homepage.showRecent |
false |
ããŒã ããŒãžã«æè¿ã®èšäºãªã¹ãã衚瀺ãããã©ããã§ãã |
homepage.showRecentItems |
5 | showRecent ã true ã®å Žåã«è¡šç€ºããèšäºã®æ°ã§ãã倿°ã0ã«èšå®ãããŠããå ŽåããŸãã¯å®çŸ©ãããŠããªãå Žåã¯ãã·ã¹ãã ã¯ããã©ã«ãã§5ã€ã®èšäºã«èšå®ãããŸãã |
homepage.showMoreLink |
false |
ãŠãŒã¶ãŒãäºåã«å®çŸ©ãããå Žæã«ç§»åããããã£ãšèŠãããªã³ã¯ãæçš¿ã®æåŸã«è¡šç€ºãããã©ããã§ãã |
homepage.showMoreLinkDest |
/posts |
ããã£ãšèŠãããã¿ã³ã®ç§»åå ã§ãã |
homepage.cardView |
false |
æè¿ã®èšäºãã«ãŒãã®ã®ã£ã©ãªãŒãšããŠè¡šç€ºããŸãã |
homepage.cardViewScreenWidth |
false |
æè¿ã®èšäºã«ãŒãã®ã£ã©ãªãŒã®å¹ ãæ¡åŒµããŠãå©çšå¯èœãªå¹ å šäœã䜿çšããŸãã |
homepage.layoutBackgroundBlur |
false |
ããŒã ããŒãžã¬ã€ã¢ãŠãã®èæ¯ç»åãã¹ã¯ããŒã«ã«åãããŠãŒãããŸãã |
èšäº(Article)
åå | ããã©ã«ã | 説æ |
---|---|---|
article.showDate |
true |
èšäºã®æ¥ä»ã衚瀺ãããã©ããã§ãã |
article.showViews |
false |
èšäºã®è¡šç€ºåæ°ã衚瀺ãããã©ããã§ããããã«ã¯ Firebase çµ±åãæå¹ã«ããå¿ èŠããããŸãã以äžãã芧ãã ããã |
article.showLikes |
false |
èšäºã®ãããã衚瀺ãããã©ããã§ããããã«ã¯ Firebase çµ±åãæå¹ã«ããå¿ èŠããããŸãã以äžãã芧ãã ããã |
article.showDateOnlyInArticle |
false |
èšäºãªã¹ã/ã«ãŒãã«è¡šç€ºãããŠããªãå Žåã§ããèšäºå ã«æ¥ä»ã衚瀺ããŸãã |
article.showDateUpdated |
false |
èšäºãæŽæ°ãããæ¥ä»ã衚瀺ãããã©ããã§ãã |
article.showAuthor |
true |
èšäºã®ããã¿ãŒã«èè ããã¯ã¹ã衚瀺ãããã©ããã§ãã |
article.showAuthorBottom |
false |
èè ããã¯ã¹ã¯ãåããŒãžã®äžéšã§ã¯ãªãäžéšã«è¡šç€ºãããŸãã |
article.showHero |
false |
ãµã ãã€ã«ç»åãåèšäºããŒãžå ã§ããŒããŒç»åãšããŠè¡šç€ºãããã©ããã§ãã |
article.heroStyle |
èšå®ãªã | ããŒããŒç»åã衚瀺ããã¹ã¿ã€ã«ã§ããæå¹ãªãªãã·ã§ã³ã¯ãbasic ãbig ãbackground ãthumbAndBackground ã§ãã |
article.layoutBackgroundBlur |
true |
èæ¯èšäº heroStyle ã®èæ¯ç»åãã¹ã¯ããŒã«ã«åãããŠãŒãããŸãã |
article.layoutBackgroundHeaderSpace |
true |
ããããŒã𿬿ã®éã«ã¹ããŒã¹ã远å ããŸãã |
article.showBreadcrumbs |
false |
èšäºã®ããããŒã«ãã³ãããªã¹ãã衚瀺ãããã©ããã§ãã |
article.showDraftLabel |
true |
ãµã€ãã --buildDrafts ã§ãã«ãããããšãã«ãèšäºã®æšªã«ãã©ããã€ã³ãžã±ãŒã¿ã衚瀺ãããã©ããã§ãã |
article.showEdit |
false |
èšäºã³ã³ãã³ããç·šéããããã®ãªã³ã¯ã衚瀺ãããã©ããã§ãã |
article.editURL |
èšå®ãªã | article.showEdit ãã¢ã¯ãã£ããªå Žåãç·šéãªã³ã¯ã® URL ã§ãã |
article.editAppendPath |
true |
article.showEdit ãã¢ã¯ãã£ããªå ŽåãçŸåšã®èšäºãžã®ãã¹ã article.editURL ã§èšå®ããã URL ã«è¿œå ãããã©ããã§ãã |
article.seriesOpened |
false |
ã·ãªãŒãºã¢ãžã¥ãŒã«ãããã©ã«ãã§éããç¶æ ã§è¡šç€ºããããã©ããã§ãã |
article.showHeadingAnchors |
true |
èšäºå ã®èŠåºãã®æšªã«ã¢ã³ã«ãŒãªã³ã¯èŠåºãã衚瀺ãããã©ããã§ãã |
article.showPagination |
true |
èšäºã®ããã¿ãŒã«æ¬¡/åã®èšäºãªã³ã¯ã衚瀺ãããã©ããã§ãã |
article.invertPagination |
false |
次/åã®èšäºãªã³ã¯ã®æ¹åãå転ãããã©ããã§ãã |
article.showReadingTime |
true |
èšäºã®èªäºæéã衚瀺ãããã©ããã§ãã |
article.showTableOfContents |
false |
èšäºã«ç®æ¬¡ã衚瀺ãããã©ããã§ãã |
article.showRelatedContent |
false |
åæçš¿ã®é¢é£èšäºã衚瀺ããŸããconfig.toml ã«è¿œå ã®èšå®ãå¿
èŠã«ãªãå ŽåããããŸãããã®æ©èœãæå¹ã«ããå Žåã¯ãããŒãã® config.toml ã確èªããé¢é£ãããã¹ãŠã® related ãšã³ããªãã³ããŒããŠãã ããããŸããé¢é£èšäºã«ã€ããŠã¯ Hugo ã®ããã¥ã¡ã³ã ã確èªããŠãã ããã |
article.relatedContentLimit |
3 |
showRelatedContent ããªã³ã«ãªã£ãŠããå Žåã«è¡šç€ºããé¢é£èšäºã®äžéã§ãã |
article.showTaxonomies |
false |
ãã®èšäºã«é¢é£ããã¿ã¯ãœãããŒã衚瀺ãããã©ããã§ãã |
article.showAuthorsBadges |
false |
authors ã¿ã¯ãœãããŒãèšäºãŸãã¯ãªã¹ãã®ããããŒã«è¡šç€ºãããã©ããã§ãã ããã«ã¯ããè€æ°ã®èè
ããš authors ã¿ã¯ãœãããŒã®èšå®ãå¿
èŠã§ãããã®æ©èœã®èšå®æ¹æ³ã®è©³çްã«ã€ããŠã¯ã[ãã®ããŒãž]({{< ref "multi-author" >}}) ã確èªããŠãã ããã |
article.showWordCount |
false |
èšäºã®åèªæ°ã衚瀺ãããã©ããã§ãã |
article.showComments |
false |
èšäºã®ããã¿ãŒã®åŸã« [ã³ã¡ã³ãããŒã·ã£ã«]({{< ref "partials#comments" >}}) ãå«ãããã©ããã§ãã |
article.sharingLinks |
èšå®ãªã | åèšäºã®æåŸã«è¡šç€ºããå
±æãªã³ã¯ã§ããæå®ãããŠããªãå ŽåããŸã㯠false ã«èšå®ãããŠããå Žåããªã³ã¯ã¯è¡šç€ºãããŸããã䜿çšå¯èœãªå€ã¯ã"linkedin"ã"bluesky"ã"mastodon"ã"twitter"ã"reddit"ã"pinterest"ã"facebook"ã"email"ã"whatsapp"ã"telegram" ã§ãã |
article.showZenMode |
false |
èšäºã®Zenã¢ãŒããªãŒããŒæ©èœãæå¹ã«ãããã©ã°ã§ãã |
List
Name | Default | Description |
---|---|---|
list.showHero |
false |
Whether the thumbnail image will be shown as a hero image within each list page. |
list.heroStyle |
Not set | Style to display the hero image, valid options are: basic , big , background , thumbAndBackground . |
list.showBreadcrumbs |
false |
Whether or not breadcrumbs are displayed in the header on list pages. |
list.layoutBackgroundBlur |
true |
Makes the background image in the background list heroStyle blur with the scroll |
list.layoutBackgroundHeaderSpace |
true |
Add space between the header and the body. |
list.showTableOfContents |
false |
Whether or not the table of contents is displayed on list pages. |
list.showSummary |
false |
Whether or not article summaries are displayed on list pages. If a summary is not provided in the [front matter]({{< ref "front-matter" >}}), one will be auto generated using the summaryLength parameter in the site configuration. |
list.showViews |
false |
Whether or not list views are displayed. This requires firebase integrations to be enabled, look below. |
list.showLikes |
false |
Whether or not list likes are displayed. This requires firebase integrations to be enabled, look below. |
list.showCards |
false |
Whether or not each article is displayed as a card or as simple inline text. |
list.orderByWeight |
false |
Whether or not articles are sorted by weights. |
list.groupByYear |
true |
Whether or not articles are grouped by year on list pages. |
list.cardView |
false |
Display lists as a gallery of cards. |
list.cardViewScreenWidth |
false |
Enhance the width of card galleries in lists to take the full width available. |
list.constrainItemsWidth |
false |
Limit item width to prose to increase readability. Useful when no feature images are available. |
list.showTableOfContents |
false |
Whether or not the table of contents is displayed on articles. |
Sitemap
Name | Default | Description |
---|---|---|
sitemap.excludedKinds |
["taxonomy", "term"] |
Kinds of content that should be excluded from the generated /sitemap.xml file. Refer to the Hugo docs for acceptable values. |
Taxonomy
Name | Default | Description |
---|---|---|
taxonomy.showTermCount |
true |
Whether or not the number of articles within a taxonomy term is displayed on the taxonomy listing. |
taxonomy.showHero |
false |
Whether the thumbnail image will be shown as a hero image within each taxonomy page. |
taxonomy.heroStyle |
Not set | Style to display the hero image, valid options are: basic , big , background , thumbAndBackground . |
taxonomy.showBreadcrumbs |
false |
Whether or not breadcrumbs are displayed in the taxonomy header. |
taxonomy.showViews |
false |
Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. |
taxonomy.showLikes |
false |
Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. |
taxonomy.showTableOfContents |
false |
Whether or not the table of contents is displayed on taxonomies. |
taxonomy.cardView |
false |
Display lists as a gallery of cards. |
Term
Name | Default | Description |
---|---|---|
term.showHero |
false |
Whether the thumbnail image will be shown as a hero image within each term page. |
term.heroStyle |
Not set | Style to display the hero image, valid options are: basic , big , background , thumbAndBackground . |
term.showBreadcrumbs |
false |
Whether or not breadcrumbs are displayed in the term header. |
term.showViews |
false |
Whether or not article views are displayed. This requires firebase integrations to be enabled, look below. |
term.showLikes |
false |
Whether or not article likes are displayed. This requires firebase integrations to be enabled, look below. |
term.showTableOfContents |
false |
Whether or not the table of contents is displayed on terms. |
term.groupByYear |
false |
Whether or not articles are grouped by year on term pages. |
term.cardView |
false |
Display lists as a gallery of cards. |
term.cardViewScreenWidth |
false |
Enhance the width of card galleries in lists to take the full width available. |
Firebase
Name | Default | Description |
---|---|---|
firebase.apiKey |
Not set | Firebase apiKey, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.authDomain |
Not set | Firebase authDomain, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.projectId |
Not set | Firebase projectId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.storageBucket |
Not set | Firebase storageBucket, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.messagingSenderId |
Not set | Firebase messagingSenderId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.appId |
Not set | Firebase appId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
firebase.measurementId |
Not set | Firebase measurementId, required to integrate against Firebase. Check [this page]({{< ref "firebase-views" >}}) for a guide on how to integrate Firebase into Blowfish. |
Fathom Analytics
Name | Default | Description |
---|---|---|
fathomAnalytics.site |
Not set | The site code generated by Fathom Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
fathomAnalytics.domain |
Not set | If using a custom domain with Fathom Analytics, provide it here to serve script.js from the custom domain. |
Umami Analytics
Name | Default | Description |
---|---|---|
umamiAnalytics.websiteid |
Not set | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
umamiAnalytics.domain |
Not set | If using a custom domain with Umami Analytics, provide it here to serve script.js from the custom domain. |
umamiAnalytics.dataDomains |
Not set | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
umamiAnalytics.scriptName |
script.js | The name of the script.js used for anti-ad-blocking is configured by the environment variable TRACKER_SCRIPT_NAME |
umamiAnalytics.enableTrackEvent |
true | When set to true track event will add automatically. If you do not want to add track event, set it to false . |
Seline Analytics
Name | Default | Description |
---|---|---|
selineAnalytics.token |
Not set | The token generated by Seline Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
selineAnalytics.enableTrackEvent |
true | When set to true track event will add automatically. If you do not want to add track event, set it to false . |
BuyMeACoffee
Name | Default | Description |
---|---|---|
buymeacoffee.identifier |
Not set | The identifier to the target buymeacoffee account. |
buymeacoffee.globalWidget |
Not set | Activate the global buymeacoffee widget. |
buymeacoffee.globalWidgetMessage |
Not set | Message what will be displayed the first time a new user lands on the site. |
buymeacoffee.globalWidgetColor |
Not set | Widget color in hex format. |
buymeacoffee.globalWidgetPosition |
Not set | Position of the widget, i.e. "Left" or "Right" |
Verifications
Name | Default | Description |
---|---|---|
verification.google |
Not set | The site verification string provided by Google to be included in the site metadata. |
verification.bing |
Not set | The site verification string provided by Bing to be included in the site metadata. |
verification.pinterest |
Not set | The site verification string provided by Pinterest to be included in the site metadata. |
verification.yandex |
Not set | The site verification string provided by Yandex to be included in the site metadata. |
RSSNext
Name | Default | Description |
---|---|---|
rssnext.feedId |
Not set | The rss feedId string provided by RSSNext/Follow to be included in the rss.xml , which can helps to claim rss feed as your own. |
rssnext.userId |
Not set | The rss userId string provided by RSSNext/Follow to be included in the rss.xml , which can helps to claim rss feed as your own. |
Other configuration files
The theme also includes a markup.toml
configuration file. This file contains some important parameters that ensure that Hugo is correctly configured to generate sites built with Blowfish.
Always ensure this file is present in the config directory and that the required values are set. Failure to do so may cause certain features to function incorrectly and could result in unintended behaviour.