What I'v done to customize this blog

What I'v done to customize this blog

I'v done little work to make this blog a little more 'personalized'.

Here I marked them down, in case of forgotten.

Front-matters #

ItemTypeDefault ValueExplanation
BookToCBooleantruetrue to enable TOC manually.
BookCommentsBooleantruetrueto enable page comments.
copyrightBooleantruetrue to show page copyright info. In case some pages do not need to show that.
snippetsBooleanfalsetrue indicates this page is generated by another versioned code snippets.
showTitleBooleantruetrue to show page title, but not all page needs to show that title.
BookIndexBooleanfalsetrue indicates the page is a _index.md page. A _index.md generally shows the abstraction about contents in folder. Index page does not have to show next/prev navigation and related page links.
BookFooter(deprecated)Booleantruetrue to enable book footer. Now integrated with front-matters.
typeString-setting type: memos to avoid page be archived.

Settings #

1params:
2  notArchivedTypes: [intro, about, memos] #not archive page types
3  archiveGroupByDate: Jan 2006  #archive date format
4# 分页参数
5  archivePaginate: 20   # default page size

Shortcodes #

  • hint: based on theme, used to show info clearly.
  • quote: literature quotation.
  • highlight: highlight code lines.

    Extra system config needed.

  • highline: highlight line.
  • update: content update note.
  • audio: audio player powered by pylr.
  • aplayer: music player powered by Aplayer.

See usage of hugo shortcodes

Partials #

  • back-to-top button
  • comments: powered by giscus.
  • post-meta: display necessary post-meta of page.
  • new navi-bar: whole new website display, takes lot of time because my poor learning of js :-).
  • new toc: re-designed table of contents.
  • next-previous page index: index of next/previous page of same categories.
  • related pages: recommended pages, easy to see.

    Extra system config needed.

  • multilingual: multi-language switch.
  • copyright: yes, copyright info at page bottom.

Others #

  • archive page: yes, archive page.

    Extra system config needed.

  • memo page: memorandums.
  • snippets: directly embed code snippet(from vc) to post, quite cool staff.