Hugo (휴고) 테마 적용 후 에러 발생시 대처한 내용

Hugo (휴고) 테마 적용 후 에러 발생시 대처한 내용 저장용으로 남겨두기

Originally published at https://ts.devbj.com on February 7, 2020.

Photo by Shane Avery on Unsplash

적용한 테마는 docsy 라는 Google 에서 제공하고 있는 documentation 을 위한 테마이다.

• 테마 홈페이지 : https://www.docsy.dev/

에러 내용은 아래와 같다.

“D:\Hugo\docsy\content\en_index.html:7:1”: failed to extract shortcode: template for shortcode “blocks/cover” not found

$ hugo - debug 
INFO 2020/02/07 18:43:51 No translation bundle found for default language "en" 
INFO 2020/02/07 18:43:51 Translation func for language no not found, use default. 
INFO 2020/02/07 18:43:51 i18n not initialized; if you need string translations, check that you have a bundle in /i18n that matches the site language or the default language. 
INFO 2020/02/07 18:43:51 Translation func for language en not found, use default. 
INFO 2020/02/07 18:43:51 i18n not initialized; if you need string translations, check that you have a bundle in /i18n that matches the site language or the default language. 
INFO 2020/02/07 18:43:51 Using config file: 
Building sites … INFO 2020/02/07 18:43:51 syncing static files to D:\Hugo\docsy\public\ 
Total in 136 ms 
Error: Error building site: "D:\Hugo\docsy\content\en\_index.html:7:1": failed to extract shortcode: template for shortcode "blocks/cover" not found

해결책을 말이야…..엄청 찾아 봤지만 속시원하게 해결해 주는 분들이 없어요…

그래도 힌트를 보다 보면, 긴가민가 이미 Pull request 해서 해결되었다고 한 흔적들이 여기저기 보이곤 해서 혹시나 해서,

npm install

다시 수행해서, 컴포넌트들도 업데이트 해봤는데

이건 아니었고 😊😊

테마 자체를 업데이트 해야겠다고 생각하고 submodule 로 링크 되어 있는 테마를 아래 Git submodule 명령으로 업데이트 수행!!

$ git submodule update - init - recursive 
Submodule path 'themes/docsy': checked out '9ac9dbd708459428ff944ef95534054660034248' 
Submodule path 'themes/docsy/assets/vendor/Font-Awesome': checked out '538a5bc4cf7989821d052e3ff919e2bead07021c' 
Submodule path 'themes/docsy/assets/vendor/bootstrap': checked out '3b558734382ce58b51e5fc676453bfd53bba9201'

🎓🎓 먼가 몇개를 더 업데이트 하는 느낌이 났는데, 오호~~~~ 동작이 된다.

역시 개발자들은 일단 먼저 사용하고 있는 라이브러리를 업데이트를 기본으로 해야지~~~ 업데이트 패치는 항상 기본 📌📌

$ hugo - debug 
INFO 2020/02/07 18:46:45 Using config file: 
Building sites … INFO 2020/02/07 18:46:45 syncing static files to D:\Hugo\docsy\public\ 
INFO 2020/02/07 18:46:46 postcss: use config file D:\Hugo\docsy\themes\docsy\postcss.config.js 
 Replace Autoprefixer browsers option to Browserslist config. 
 Use browserslist key in package.json or .browserslistrc file. 
 Using browsers option can cause errors. Browserslist config 
 can be used for Babel, Autoprefixer, postcss-normalize and other tools. 
 If you really need to use option, rename it to overrideBrowserslist. 
 Learn more at: 
 https://github.com/browserslist/browserslist#readme 
 https://twitter.com/browserslist 
DEBUG 2020/02/07 18:46:49 Render XML for "sitemap" to "\\no\\sitemap.xml" 
DEBUG 2020/02/07 18:46:49 Write redirect to main language en: /docsy/ 
DEBUG 2020/02/07 18:46:49 creating alias: en redirecting to /docsy/ 
DEBUG 2020/02/07 18:46:49 creating alias: \blog\releases\page\1\index.html redirecting to /docsy/blog/releases/ 
DEBUG 2020/02/07 18:46:50 creating alias: \blog\page\1\index.html redirecting to /docsy/blog/ 
DEBUG 2020/02/07 18:46:50 creating alias: \blog\news\page\1\index.html redirecting to /docsy/blog/news/ 
DEBUG 2020/02/07 18:46:50 Render XML for "sitemap" to "\\en\\sitemap.xml" 
DEBUG 2020/02/07 18:46:50 Render XML for "sitemapindex" to "sitemap.xml" 
 | NO | EN 
 - - - - - - - - - -+ - - + - - - 
 Pages | 4 | 48 
 Paginator pages | 0 | 0 
 Non-page files | 0 | 2 
 Static files | 38 | 38 
 Processed images | 0 | 8 
 Aliases | 1 | 3 
 Sitemaps | 2 | 1 
 Cleaned | 0 | 0 
Total in 5194 ms

약간 머 문제가 있어도, 결과는 GitHub에 오픈되어 있으니 참고용으로 살펴보실 분, 필요하신 분들은 눈팅 해보세요. 모양은 테마 사이트에 가면 볼 수 있는데, 아래처럼 구성이 되는 문서 사이트가 되여~

개인 기업이나 스타트업들은 그냥 기본 플랫폼으로 잘 활용하면 좋을 듯~

Originally published at https://ts.devbj.com on February 7, 2020.