diff --git a/exampleSite/config.yml b/exampleSite/config.yml index 92863fd..8972d45 100644 --- a/exampleSite/config.yml +++ b/exampleSite/config.yml @@ -58,28 +58,27 @@ languages: ☄️ 快速 | ☁️ 流畅 | 📖 可读性 | 📱 响应式 buttons: - name: 文档 - url: posts + url: docs - name: 标签 url: tags menu: main: - - name: 归档 - url: archives/ - weight: 5 + - name: 文档 + url: docs + weight: 1 - name: 标签 - url: tags - weight: 10 - - name: 分类 - url: categories - weight: 10 - - name: 系列 - url: series - weight: 10 + url: tags/ + weight: 4 + - name: 归档 + url: archives + weight: 5 - name: 搜索 url: search/ - weight: 20 - - name: "@Author" + weight: 10 + - name: "@作者" url: "https://reorx.com" + params: + external: true outputs: home: diff --git a/exampleSite/content/docs/_index.zh.md b/exampleSite/content/docs/_index.zh.md new file mode 100644 index 0000000..db542aa --- /dev/null +++ b/exampleSite/content/docs/_index.zh.md @@ -0,0 +1,6 @@ +--- +title: PaperModX 文档 +summary: 包含 PaperModX 的功能介绍和详细用法说明 +description: 包含 PaperModX 的功能介绍和详细用法说明 +paginate: 10 +--- diff --git a/exampleSite/content/docs/papermodx-new-features.md b/exampleSite/content/docs/papermodx-new-features.md index 70d6a1d..2f58b0a 100644 --- a/exampleSite/content/docs/papermodx-new-features.md +++ b/exampleSite/content/docs/papermodx-new-features.md @@ -1,6 +1,7 @@ --- title: "PaperModX New Features" date: 2022-04-12T23:37:00+08:00 +summary: This page explains the new features and changes of PaperModX comparing to the original PaperMod. weight: 1 --- diff --git a/exampleSite/content/docs/papermodx-new-features.zh.md b/exampleSite/content/docs/papermodx-new-features.zh.md new file mode 100644 index 0000000..cc1cb45 --- /dev/null +++ b/exampleSite/content/docs/papermodx-new-features.zh.md @@ -0,0 +1,121 @@ +--- +title: "PaperModX 新功能说明" +date: 2022-04-12T23:37:00+08:00 +summary: 本文档描述 PaperModX 相比原版 PaperMod 增加的新功能和变化。 +weight: 1 +--- + + +本文档描述 PaperModX 相比原版 PaperMod 增加的新功能和变化。 + + +## Table of Contents (ToC) floating on the side + +By adding config: + +```yaml +params: + TocSide: 'left' # or 'right' +``` + +ToC will float on the left/right side of the page. +You can take a look at how `'right'` feels like in [Installation | Update](https://reorx.github.io/hugo-PaperModX/docs/installation/). + +The ToC box is responsive, it only shows on the side when minimum screen size is 1440px. + +This feature is enabled on this site. + + +## InstantClick integration + +By adding config: + +```yaml +params: + EnableInstantClick: true +``` + +[InstantClick](http://instantclick.io/) will be enabled, +making navigation behaves like Single Page Application. + +Note that `/search` pages are omitted from InstantClick +to prevent conflicts from search's JavaScript, +this may be changed in the future after refactoring those scripts. + +Another thing to notice is smooth scrolling will be disabled +if InstantClick is enabled, because they both listen click +event on every `` tags. IMO smooth scrolling is not very useful +so it has to give way to InstantCllick. + +This feature is enabled on this site. + + +## Give links an accent color. + +Though PaperModX is designed to be minimal, accent color is still essential. +It's a good way to show personality and make your site feels more delightful. + +The default color is a purple vibe, +you can customize the colors of link, link underline and their hover variants +by override the following css variables in `assets/css/extended/custom.css` of your site. + +```css +:root { + --link-color: var(--primary); + --link-hover-color: #573eaa; + --link-underline-shadow: 0 1px 0 var(--link-color); + --link-hover-underline-color: #573eaa; + --link-hover-underline-shadow: 0 2px 0 var(--link-hover-underline-color); +} +``` + + +## Customize pagniator size + +In section pages, if you want the paginator size be different from the +[global config](https://gohugo.io/templates/pagination/#configure-pagination), +you can add `paginate` in the frontmatter to customize. + +```yaml +--- +paginate: 10 +--- +``` + + +## Menus external link + +You can add `external: true` to a menu item's params to mark it as an external link, +this will add a small icon to the end, and make the link open in new tab when clicked. + +```yaml +menu: + main: + - name: "@Author" + url: "https://reorx.com" + params: + external: true +``` + + +## Social icons from Simple Icons + +Add social icons with `-simple` suffix from [Simple Icons](https://simpleicons.org/). + +Available icons: +- github-simple +- rss-simple +- telegram-simple +- twitter-simple +- pinboard-simple + +The icons are moved from `layouts/partials/svg.html` to `data/svg.toml`, +makes it easier to maintain, it's now possible to have an index page +to show all the icons, check it out at: [Icons Preview](https://reorx.github.io/hugo-PaperModX/docs/icons_preview/) + + +## Opinionated UI enhancements + +- Distinguish home page width and post page width, post page is wider + (800px) for better readability, you can change it by `--post-width` in `theme-vars.css`. +- Menu links are always bold, this feels more consistent when clicking around. Active links have deeper color.