PaperMod - Hugo Theme

TODO ์•„์ด์ฝ˜ ํ‘œ์‹œ ๋ฐ ๊ตฌ์กฐ ํŒŒ์•…ํ•ด์„œ ์ด๋ฅผ ์ ์šฉํ•˜๊ธฐ 2022-09-08 - ๋‚ด์šฉ ์ˆ˜์ •, ๊ทธ๋ฆผํŒŒ์ผ ๋งํฌ ๊ด€๋ จ ์ถ”๊ฐ€ PaperMod screen shot Intro hugo์˜ ํ…Œ๋งˆ ์ค‘์— ๊ฐ€์žฅ ๊ฐ„๊ฒฐํ•˜๊ณ  ์•ˆ์ •์ ์ด๋ฉฐ ๋งŽ์€ ์‚ฌ๋žŒ๋“ค์ด ์‚ฌ์šฉํ•˜๊ณ  ์žˆ๋‹ค. hugo ํ”„๋กœ์ ํŠธ๋Š” ~/www๋กœ ๊ฐ€์ •ํ•œ๋‹ค. ์ฃผ์˜ํ•  ๊ฒƒ์€ hugo์˜ ๊ตฌ์กฐ๊ฐ€ ~/www/contents/์ดํ•˜์— markdown ํŒŒ์ผ์„ ๋„ฃ์–ด์ฃผ์–ด์•ผ ํ•˜๊ณ , ์ดํ•˜ ํด๋”๋Š” ์ ์ ˆํžˆ ๋งŒ๋“ค๋˜ index.mdํŒŒ์ผ์€ ๋งŒ๋“ค๋ฉด ์›นํŽ˜์ด์ง€ ๋ฉ”์ธ ํ™”๋ฉด์— ๋‚ด์šฉ์ด ๋œจ์งˆ ์•Š๋Š”๋‹ค๋Š” ์ ์ด๋‹ค. ์„ค์ •์€ ~/www/config.yml์ด๋‹ค. ์„ค์ •์„ ๋ณ€๊ฒฝํ•˜๋ฉด hugo -D server ๋™์ž‘์‹œ ์ž๋™์œผ๋กœ ๋ฐ˜์˜๋œ๋‹ค. ๋งŒ์•ฝ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ์ด ๋ธŒ๋ผ์šฐ์ €์—์„œ ๋ณด์ด์ง€ ์•Š์œผ๋ฉด ์„œ๋ฒ„๋ฅผ ์žฌ์‹คํ–‰ ํ•œ๋‹ค. Install and Update Install $ cd ~/www $ git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1 Update $ cd themes/PaperMod $ git pull Setup ๊ด€๋ จ ๋งํฌ ์•„๋ž˜ ์‚ฌ์ดํŠธ์— config.yml ๋ฐ post.md ์ƒ˜ํ”Œ์ด ์žˆ์œผ๋‹ˆ ์ฐธ๊ณ ํ•œ๋‹ค. https://adityatelange.github.io/hugo-PaperMod/posts/papermod/papermod-installation/ ํ…Œ๋งˆ ์„ค์ • papermod ์˜ ํ…Œ๋งˆ๋Š” light/dark/auto ๊ฐ€ ์žˆ๋‹ค. ํ™ˆํ™”๋ฉด ์ขŒ์ธก ์ƒ๋‹จ์— ํ•ด/๋‹ฌ ์•„์ด์ฝ˜ ํด๋ฆญ baseURL: "https://your_idname.github.io/" # ์ž์‹ ์˜ ๊นƒํŽ˜์ด์ง€ URL title: My Blog and wiki # ๋ธ”๋กœ๊ทธํ™ˆ ์ œ๋ชฉ paginate: 5 # ํ™ˆ์—์„œ ๋ณด์—ฌ์ค„ ๋ธ”๋กœ๊ทธ ํ‘œ์‹œ ๊ฐฏ์ˆ˜ theme: "PaperMod" # ํ…Œ๋งˆ PaperMod๋กœ ์ง€์ • params: # defaultTheme: light # defaultTheme: light defaultTheme: auto # auto๋กœ ์„ค์ •ํ•˜๋ฉด ์‚ฌ์šฉ์ž๊ฐ€ ๋ฐ”๊ฟ€ ์ˆ˜ ์žˆ๋‹ค. # disableThemeToggle: true # ํ•ด/๋‹ฌ ์•„์ด์ฝ˜์„ ๋ณด์ด์ง€ ์•Š๊ฒŒ ํ•˜๊ธฐ ๋ฉ”๋‰ด์„ค์ • ํ™ˆ ์šฐ์ธก ์ƒ๋‹จ ๋ฉ”๋‰ด๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ถ”๊ฐ€ํ•œ๋‹ค. menu: main: - identifier: categories # ๋ธ”๋กœ๊ทธ ์นดํ…Œ๊ณ ๋ฆฌ ๋ฉ”๋‰ด name: categories url: /categories/ weight: 10 - identifier: search # ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰ ๋ฉ”๋‰ด name: Search url: /search weight: 30 - identifier: tags # ๋ธ”๋กœ๊ทธ ํƒœ๊ทธ ๋ฉ”๋‰ด name: tags url: /tags/ weight: 20 - identifier: archives # ๋ธ”๋กœ๊ทธ ํƒœ๊ทธ ๋ฉ”๋‰ด name: tags url: /tags/ weight: 20 Archive Page - ์•„์นด์ด๋ธŒ ํŽ˜์ด์ง€, ๋‚ ์งœ๋ณ„๋กœ ์˜ฌ๋ฆฐ ํฌ์ŠคํŠธ๋ฌธ์„œ๊ฐ€ ์ •๋ฆฌ๋จ $ cat << EOF > ~/www/content/archives.md --- title: "Archive" layout: "archives" # url: "/archives" summary: "archives" --- EOF Search Page - ๊ฒ€์ƒ‰ํŽ˜์ด์ง€, ํผ์ง€ ์Šคํƒ€์ผ์˜ ๋น ๋ฅธ ๊ฒ€์ƒ‰ $ cat << EOF > ~/www/content/search.md --- title: "Search" # in any language you want layout: "search" # is necessary # url: "/archive" # description: "Description for Search" summary: "search" placeholder: "๊ฒ€์ƒ‰์–ด๋ฅผ ์ž…๋ ฅํ•˜์„ธ์š”" --- EOF tags์™€ categories๋Š” ์˜ฌ๋ฆด ํฌ์ŠคํŠธ๋ฌธ์„œ post.md ๋“ฑ์˜ frontmatter์— ๊ธฐ๋กํ•˜๋ฉด ์ž๋™์œผ๋กœ ๋ถ„๋ฅ˜๋˜๊ณ  ํ™ˆ ์ƒ๋‹จ ๋ฉ”๋‰ด์—์„œ ๋ณผ ์ˆ˜ ์žˆ๋‹ค. Post Cover Image ~/www/config.yml์— ์„ค์ •ํ•ด์ฃผ๊ณ  ์•„๋ž˜ ์„ค๋ช…๋Œ€๋กœ ํฌ์ŠคํŠธ๋ฌธ์„œ์— ๋งํฌ๋ฅผ ๊ฑธ์–ด์ฃผ๋ฉด ๋œ๋‹ค. cover: image: "<image path/url>" # can also paste direct link from external site # ex. https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png alt: "<alt text>" caption: "<text>" relative: false # To use relative path for cover image, used in hugo Page-bundles ์ด๋ฏธ์ง€ ์‚ฌ์ด์ฆˆ๋ฅผ ์ค„์ด๊ณ  ์ฒ˜๋ฆฌ์†๋„๋ฅผ ๋†’์ด๋ ค๋ฉด ์•„๋ž˜ ์„ค์ • ์ถ”๊ฐ€ params: cover: responsiveImages: false ๊ทธ๋Ÿฌ๋‚˜ ์‹ค์ œ๋กœ ์ ์šฉํ•ด๋„ ํŽ˜์ด์ง€๋Š” ๋ณ€ํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค. ...

2022-08-24 ยท (updated 2025-06-15) ยท 701 words

PaperMod - Hugo Theme

History 2025-06-27 - tip ์ถ”๊ฐ€: tags, categories list์— cover image ํ‘œ์‹œํ•˜๊ธฐ 2022-09-08 - ๋‚ด์šฉ ์ˆ˜์ •, ๊ทธ๋ฆผํŒŒ์ผ ๋งํฌ ๊ด€๋ จ ์ถ”๊ฐ€ PaperMod screen shot Intro hugo์˜ ํ…Œ๋งˆ ์ค‘์— ๊ฐ€์žฅ ๊ฐ„๊ฒฐํ•˜๊ณ  ์•ˆ์ •์ ์ด๋ฉฐ ๋งŽ์€ ์‚ฌ๋žŒ๋“ค์ด ์‚ฌ์šฉํ•˜๊ณ  ์žˆ๋‹ค. hugo ํ”„๋กœ์ ํŠธ๋Š” ~/www๋กœ ๊ฐ€์ •ํ•œ๋‹ค. ์ฃผ์˜ํ•  ๊ฒƒ์€ hugo์˜ ๊ตฌ์กฐ๊ฐ€ ~/www/contents/์ดํ•˜์— markdown ํŒŒ์ผ์„ ๋„ฃ์–ด์ฃผ์–ด์•ผ ํ•˜๊ณ , ์ดํ•˜ ํด๋”๋Š” ์ ์ ˆํžˆ ๋งŒ๋“ค๋˜ index.mdํŒŒ์ผ์€ ๋งŒ๋“ค๋ฉด ์›นํŽ˜์ด์ง€ ๋ฉ”์ธ ํ™”๋ฉด์— ๋‚ด์šฉ์ด ๋œจ์งˆ ์•Š๋Š”๋‹ค๋Š” ์ ์ด๋‹ค. ์„ค์ •์€ ~/www/config.yml์ด๋‹ค. ์„ค์ •์„ ๋ณ€๊ฒฝํ•˜๋ฉด hugo -D server ๋™์ž‘์‹œ ์ž๋™์œผ๋กœ ๋ฐ˜์˜๋œ๋‹ค. ๋งŒ์•ฝ ์„ค์ • ๋ณ€๊ฒฝ ์‚ฌํ•ญ์ด ๋ธŒ๋ผ์šฐ์ €์—์„œ ๋ณด์ด์ง€ ์•Š์œผ๋ฉด ์„œ๋ฒ„๋ฅผ ์žฌ์‹คํ–‰ ํ•œ๋‹ค. Install and Update Install $ cd ~/www $ git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1 Update $ cd themes/PaperMod $ git pull Setup ๊ด€๋ จ ๋งํฌ ์•„๋ž˜ ์‚ฌ์ดํŠธ์— config.yml ๋ฐ post.md ์ƒ˜ํ”Œ์ด ์žˆ์œผ๋‹ˆ ์ฐธ๊ณ ํ•œ๋‹ค. https://adityatelange.github.io/hugo-PaperMod/posts/papermod/papermod-installation/ ํ…Œ๋งˆ ์„ค์ • papermod ์˜ ํ…Œ๋งˆ๋Š” light/dark/auto ๊ฐ€ ์žˆ๋‹ค. ํ™ˆํ™”๋ฉด ์ขŒ์ธก ์ƒ๋‹จ์— ํ•ด/๋‹ฌ ์•„์ด์ฝ˜ ํด๋ฆญ baseURL: "https://your_idname.github.io/" # ์ž์‹ ์˜ ๊นƒํŽ˜์ด์ง€ URL title: My Blog and wiki # ๋ธ”๋กœ๊ทธํ™ˆ ์ œ๋ชฉ paginate: 5 # ํ™ˆ์—์„œ ๋ณด์—ฌ์ค„ ๋ธ”๋กœ๊ทธ ํ‘œ์‹œ ๊ฐฏ์ˆ˜ theme: "PaperMod" # ํ…Œ๋งˆ PaperMod๋กœ ์ง€์ • params: # defaultTheme: light # defaultTheme: light defaultTheme: auto # auto๋กœ ์„ค์ •ํ•˜๋ฉด ์‚ฌ์šฉ์ž๊ฐ€ ๋ฐ”๊ฟ€ ์ˆ˜ ์žˆ๋‹ค. # disableThemeToggle: true # ํ•ด/๋‹ฌ ์•„์ด์ฝ˜์„ ๋ณด์ด์ง€ ์•Š๊ฒŒ ํ•˜๊ธฐ ๋ฉ”๋‰ด์„ค์ • ํ™ˆ ์šฐ์ธก ์ƒ๋‹จ ๋ฉ”๋‰ด๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ถ”๊ฐ€ํ•œ๋‹ค. menu: main: - identifier: categories # ๋ธ”๋กœ๊ทธ ์นดํ…Œ๊ณ ๋ฆฌ ๋ฉ”๋‰ด name: categories url: /categories/ weight: 10 - identifier: search # ๋ธ”๋กœ๊ทธ ๊ฒ€์ƒ‰ ๋ฉ”๋‰ด name: Search url: /search weight: 30 - identifier: tags # ๋ธ”๋กœ๊ทธ ํƒœ๊ทธ ๋ฉ”๋‰ด name: tags url: /tags/ weight: 20 - identifier: archives # ๋ธ”๋กœ๊ทธ ํƒœ๊ทธ ๋ฉ”๋‰ด name: tags url: /tags/ weight: 20 Archive Page - ์•„์นด์ด๋ธŒ ํŽ˜์ด์ง€, ๋‚ ์งœ๋ณ„๋กœ ์˜ฌ๋ฆฐ ํฌ์ŠคํŠธ๋ฌธ์„œ๊ฐ€ ์ •๋ฆฌ๋จ $ cat << EOF > ~/www/content/archives.md --- title: "Archive" layout: "archives" # url: "/archives" summary: "archives" --- EOF Search Page - ๊ฒ€์ƒ‰ํŽ˜์ด์ง€, ํผ์ง€ ์Šคํƒ€์ผ์˜ ๋น ๋ฅธ ๊ฒ€์ƒ‰ $ cat << EOF > ~/www/content/search.md --- title: "Search" # in any language you want layout: "search" # is necessary # url: "/archive" # description: "Description for Search" summary: "search" placeholder: "๊ฒ€์ƒ‰์–ด๋ฅผ ์ž…๋ ฅํ•˜์„ธ์š”" --- EOF tags์™€ categories๋Š” ์˜ฌ๋ฆด ํฌ์ŠคํŠธ๋ฌธ์„œ post.md ๋“ฑ์˜ frontmatter์— ๊ธฐ๋กํ•˜๋ฉด ์ž๋™์œผ๋กœ ๋ถ„๋ฅ˜๋˜๊ณ  ํ™ˆ ์ƒ๋‹จ ๋ฉ”๋‰ด์—์„œ ๋ณผ ์ˆ˜ ์žˆ๋‹ค. Post Cover Image ~/www/config.yml์— ์„ค์ •ํ•ด์ฃผ๊ณ  ์•„๋ž˜ ์„ค๋ช…๋Œ€๋กœ ํฌ์ŠคํŠธ๋ฌธ์„œ์— ๋งํฌ๋ฅผ ๊ฑธ์–ด์ฃผ๋ฉด ๋œ๋‹ค. cover: image: "<image path/url>" # can also paste direct link from external site # ex. https://i.ibb.co/K0HVPBd/paper-mod-profilemode.png alt: "<alt text>" caption: "<text>" relative: false # To use relative path for cover image, used in hugo Page-bundles ์ด๋ฏธ์ง€ ์‚ฌ์ด์ฆˆ๋ฅผ ์ค„์ด๊ณ  ์ฒ˜๋ฆฌ์†๋„๋ฅผ ๋†’์ด๋ ค๋ฉด ์•„๋ž˜ ์„ค์ • ์ถ”๊ฐ€ params: cover: responsiveImages: false ๊ทธ๋Ÿฌ๋‚˜ ์‹ค์ œ๋กœ ์ ์šฉํ•ด๋„ ํŽ˜์ด์ง€๋Š” ๋ณ€ํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค. ...

2022-08-24 ยท (updated 2025-06-27) ยท 864 words

Vimwiki Hugo Github.io ์—ฐ๋™ํ•˜๊ธฐ

์†Œ๊ฐœ ๋งˆํฌ๋‹ค์šด ๋ฌธ์„œ๋ฅผ vimwiki๋กœ ์ž‘์„ฑํ•˜์—ฌ ๊ฐ„๋‹จํ•œ ๋ฉ”๋ชจ์—์„œ ๋ถ€ํ„ฐ ๋ธ”๋กœ๊ทธ, ๋ฆฌํฌํŠธ, ๊ธฐ์ˆ  ๋ฌธ์„œ์— ์ด๋ฅด๊ธฐ๊นŒ์ง€ ์†์‰ฝ๊ฒŒ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋‹ค. ์ด๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•˜์—ฌ ๊นƒํ—ˆ๋ธŒ์—์„œ ์ œ๊ณตํ•˜๋Š” ๋ฌด๋ฃŒ ์›น์‚ฌ์ดํŠธ์— ์˜ฌ๋ฆฌ๋Š” ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•˜๊ณ ์ž ํ•œ๋‹ค. ์•„๋ž˜๋Š” ๊ฐ„๋žตํ•œ ๊ฐœ์š”์ด๋‹ค. vimwiki + hugo + github.io ๋ฅผ ์—ฐ๊ฒฐํ•˜๋Š” ํ”„๋กœ์ ํŠธ์ด๋‹ค. vim์˜ vimwiki ํ”Œ๋Ÿฌ๊ทธ์ธ์„ ์‚ฌ์šฉํ•˜์—ฌ ์œ„ํ‚ค๋ฌธ์„œ๋ฅผ ์ž‘์„ฑํ•œ๋‹ค. ์œ„ํ‚ค๋ฌธ์„œ์˜ ์ž‘์„ฑ์€ ๋งˆํฌ๋‹ค์šด(markdown) ๋ฌธ๋ฒ•์œผ๋กœ ํ•œ๋‹ค. hugo๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ž„์‹œ ๋กœ์ปฌ์›น์„œ๋ฒ„๋ฅผ ๋„์šฐ๊ณ  ์œ„ํ‚ค๋ฌธ์„œ๋ฅผ html๋กœ ๋ณ€ํ™˜ํ•˜๊ณ  ๋ธŒ๋ผ์šฐ์ €์—์„œ ํ™•์ธํ•œ๋‹ค. ๋ณ€ํ™˜๋œ ์ •์  html ๋ฌธ์„œ๋ฅผ ๊นƒํ—ˆ๋ธŒ์— ์˜ฌ๋ฆฐ๋‹ค. ๊นƒํ—ˆ๋ธŒ ํŽ˜์ด์ง€์—์„œ ์ด๋ฅผ ํ™•์ธํ•œ๋‹ค. UTF-8์ธ์ฝ”๋”ฉ์ด๋ผ๋ฉด ํ•œ๊ธ€๋„ ํŠน๋ณ„ํžˆ ๋ฌธ์ œ๊ฐ€ ์—†๊ณ  ์ž˜ ๋œ๋‹ค. ๋‹ค๋งŒ ๋งˆํฌ๋‹ค์šด ํŒŒ์ผ๋ช…์— ๊ณต๋ฐฑ์ด ๋“ค์–ด๊ฐ€๋ฉด ๊ด€๋ฆฌ๊ฐ€ ์ข‹์ง€ ์•Š์œผ๋‹ˆ -๋“ฑ์œผ๋กœ ์—ฐ๊ฒฐํ•ด์„œ ์“ด๋‹ค. ์„ค์น˜ ํ™˜๊ฒฝ OS ๋ฐ ํ”„๋กœ๊ทธ๋žจ ๋ฒ„์ „ ...

2022-08-24 ยท (updated 2022-10-06) ยท 1366 words

Vimwiki Hugo Github.io ์—ฐ๋™ํ•˜๊ธฐ

์†Œ๊ฐœ ๋งˆํฌ๋‹ค์šด ๋ฌธ์„œ๋ฅผ vimwiki๋กœ ์ž‘์„ฑํ•˜์—ฌ ๊ฐ„๋‹จํ•œ ๋ฉ”๋ชจ์—์„œ ๋ถ€ํ„ฐ ๋ธ”๋กœ๊ทธ, ๋ฆฌํฌํŠธ, ๊ธฐ์ˆ  ๋ฌธ์„œ์— ์ด๋ฅด๊ธฐ๊นŒ์ง€ ์†์‰ฝ๊ฒŒ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋‹ค. ์ด๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ํ•˜์—ฌ ๊นƒํ—ˆ๋ธŒ์—์„œ ์ œ๊ณตํ•˜๋Š” ๋ฌด๋ฃŒ ์›น์‚ฌ์ดํŠธ์— ์˜ฌ๋ฆฌ๋Š” ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•˜๊ณ ์ž ํ•œ๋‹ค. ์•„๋ž˜๋Š” ๊ฐ„๋žตํ•œ ๊ฐœ์š”์ด๋‹ค. vimwiki + hugo + github.io ๋ฅผ ์—ฐ๊ฒฐํ•˜๋Š” ํ”„๋กœ์ ํŠธ์ด๋‹ค. vim์˜ vimwiki ํ”Œ๋Ÿฌ๊ทธ์ธ์„ ์‚ฌ์šฉํ•˜์—ฌ ์œ„ํ‚ค๋ฌธ์„œ๋ฅผ ์ž‘์„ฑํ•œ๋‹ค. ์œ„ํ‚ค๋ฌธ์„œ์˜ ์ž‘์„ฑ์€ ๋งˆํฌ๋‹ค์šด(../markdown) ๋ฌธ๋ฒ•์œผ๋กœ ํ•œ๋‹ค. hugo๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ž„์‹œ ๋กœ์ปฌ์›น์„œ๋ฒ„๋ฅผ ๋„์šฐ๊ณ  ์œ„ํ‚ค๋ฌธ์„œ๋ฅผ html๋กœ ๋ณ€ํ™˜ํ•˜๊ณ  ๋ธŒ๋ผ์šฐ์ €์—์„œ ํ™•์ธํ•œ๋‹ค. ๋ณ€ํ™˜๋œ ์ •์  html ๋ฌธ์„œ๋ฅผ ๊นƒํ—ˆ๋ธŒ์— ์˜ฌ๋ฆฐ๋‹ค. ๊นƒํ—ˆ๋ธŒ ํŽ˜์ด์ง€์—์„œ ์ด๋ฅผ ํ™•์ธํ•œ๋‹ค. UTF-8์ธ์ฝ”๋”ฉ์ด๋ผ๋ฉด ํ•œ๊ธ€๋„ ํŠน๋ณ„ํžˆ ๋ฌธ์ œ๊ฐ€ ์—†๊ณ  ์ž˜ ๋œ๋‹ค. ๋‹ค๋งŒ ๋งˆํฌ๋‹ค์šด ํŒŒ์ผ๋ช…์— ๊ณต๋ฐฑ์ด ๋“ค์–ด๊ฐ€๋ฉด ๊ด€๋ฆฌ๊ฐ€ ์ข‹์ง€ ์•Š์œผ๋‹ˆ -๋“ฑ์œผ๋กœ ์—ฐ๊ฒฐํ•ด์„œ ์“ด๋‹ค. ์„ค์น˜ ํ™˜๊ฒฝ OS ๋ฐ ํ”„๋กœ๊ทธ๋žจ ๋ฒ„์ „ ...

2022-08-24 ยท (updated 2022-10-06) ยท 1350 words