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

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

에러 내용은 아래와 같다.

적용한 테마는 docsy 라는 Google 에서 제공하고 있는 documentation 을 위한 테마이다.
막상 쓸 문서는 없는데, 시작한 거 데모는 돌려봐야지...흠
테마 홈페이지 : https://www.docsy.dev/

$ 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에 오픈되어 있으니 참고용으로 살펴보실 분, 필요하신 분들은 눈팅 해보세요.

• https://github.com/bjnhur/docsy

모양은 테마 사이트에 가면 볼 수 있는데, 아래처럼 구성이 되는 문서 사이트가 되여~

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

구글 Docsy hugo theme