EnglishWhat I'v done to customize this blog
I'v done some work to make this blog a little more 'personalized'.
Here I marked them down, in case of forgotten.
Front-matters #
| Item | Type | Default Value | Explanation |
|---|---|---|---|
| BookToC | Boolean | true | true to enable TOC manually. |
| BookComments | Boolean | true | trueto enable page comments. |
| copyright | Boolean | true | true to show page copyright info. In case some pages do not need to show that. |
| snippets | Boolean | false | true indicates this page is generated by another versioned code snippets. |
| showTitle | Boolean | true | true to show page title, but not all page needs to show that title. |
| BookIndex | Boolean | false | true 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) | Boolean | true | true to enable book footer. Now integrated with front-matters. |
| type | String | - | 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 #
Taking advantage of shortcodes, make content more clear and easy to read.
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.
Partials #
Partials are some tiny components, which are used to increase website interactivity and user experience.
- back-to-top button
- comments: powered by giscus.
- post-meta: display necessary post-meta of page.
- new navigation-bar: whole new website display, takes lot of time because my poor javascript :-).
- 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.
