{"id":13430521,"url":"https://github.com/blinkfox/hexo-theme-matery","last_synced_at":"2026-01-14T15:50:54.089Z","repository":{"id":38210607,"uuid":"146325535","full_name":"blinkfox/hexo-theme-matery","owner":"blinkfox","description":"A beautiful hexo blog theme with material design and responsive design.一个基于材料设计和响应式设计而成的全面、美观的Hexo主题。国内访问：http://blinkfox.com","archived":false,"fork":false,"pushed_at":"2024-07-02T06:48:18.000Z","size":20642,"stargazers_count":5353,"open_issues_count":275,"forks_count":1241,"subscribers_count":61,"default_branch":"develop","last_synced_at":"2025-11-19T13:29:05.496Z","etag":null,"topics":["featured-pictures","hexo-blog-theme","hexo-theme","hexo-theme-matery","material-design","responsive-design","theme"],"latest_commit_sha":null,"homepage":"https://blinkfox.github.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blinkfox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-27T16:38:12.000Z","updated_at":"2025-11-18T13:54:03.000Z","dependencies_parsed_at":"2024-06-07T20:20:32.362Z","dependency_job_id":null,"html_url":"https://github.com/blinkfox/hexo-theme-matery","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/blinkfox/hexo-theme-matery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blinkfox%2Fhexo-theme-matery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blinkfox%2Fhexo-theme-matery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blinkfox%2Fhexo-theme-matery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blinkfox%2Fhexo-theme-matery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blinkfox","download_url":"https://codeload.github.com/blinkfox/hexo-theme-matery/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blinkfox%2Fhexo-theme-matery/sbom","scorecard":{"id":243449,"data":{"date":"2025-08-11","repo":{"name":"github.com/blinkfox/hexo-theme-matery","commit":"86ad429e24d0b002c1feb245e510ea93f82e3395"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":10,"reason":"all changesets reviewed","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'develop'","Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T07:03:37.425Z","repository_id":38210607,"created_at":"2025-08-17T07:03:37.425Z","updated_at":"2025-08-17T07:03:37.425Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28425233,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T15:24:48.085Z","status":"ssl_error","status_checked_at":"2026-01-14T15:23:41.940Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["featured-pictures","hexo-blog-theme","hexo-theme","hexo-theme-matery","material-design","responsive-design","theme"],"created_at":"2024-07-31T02:00:54.856Z","updated_at":"2026-01-14T15:50:54.068Z","avatar_url":"https://github.com/blinkfox.png","language":"JavaScript","funding_links":[],"categories":["Content","Uncategorized","6 Matery","JavaScript","HTML (177)","HTML"],"sub_categories":["Uncategorized"],"readme":"# hexo-theme-matery\n\n[![HitCount](http://hits.dwyl.io/blinkfox/hexo-theme-matery.svg)](http://hits.dwyl.io/blinkfox/hexo-theme-matery) [![Gitter](https://img.shields.io/gitter/room/blinkfox/hexo-theme-matery.svg)](https://gitter.im/hexo-theme-matery/Lobby?utm_source=badge) [![GitHub issues](https://img.shields.io/github/issues/blinkfox/hexo-theme-matery.svg)](https://github.com/blinkfox/hexo-theme-matery/issues) [![GitHub license](https://img.shields.io/github/license/blinkfox/hexo-theme-matery.svg)](https://github.com/blinkfox/hexo-theme-matery/blob/master/LICENSE) [![Download](https://img.shields.io/badge/downloads-master-green.svg)](https://codeload.github.com/blinkfox/hexo-theme-matery/zip/master) [![Hexo Version](https://img.shields.io/badge/hexo-%3E%3D%205.0.0-blue.svg)](http://hexo.io) [![GitHub forks](https://img.shields.io/github/forks/blinkfox/hexo-theme-matery.svg)](https://github.com/blinkfox/hexo-theme-matery/network) [![GitHub stars](https://img.shields.io/github/stars/blinkfox/hexo-theme-matery.svg)](https://github.com/blinkfox/hexo-theme-matery/stargazers)\n\n[🇨🇳中文说明](README_CN.md) | [国内访问示例(http://blinkfox.com)](http://blinkfox.com) | [Github Deploy Demo(https://blinkfox.github.io)](https://blinkfox.github.io)\n\n\u003e This is a Hexo blog theme with 'Material Design' and responsive design.\n\n## Features\n\n- Simple and beautiful, and post is Beautiful and readable.\n- [Material Design](https://material.io/).\n- Responsive design, which can be displayed well on desktop, tablet, mobile phone, etc.\n- Home page carousel posts and changing 'banner' picture dynamically everyday.\n- Blog posts list with waterflow (There will be 24 images if the article doesn't have featured pictures).\n- Archive page with timeline.\n- Tags page of the **word cloud** and categories page of the **radar chart**\n- Rich 'About' page (including about me, posts charts, my projects, my skills, gallery etc.)\n- Friendly link page for customizable data\n- Support post topping and rewards\n- Support `MathJax`\n- TOC\n- Can be set append the copyright information when copying the content of the post\n- Can be set to do password verification when reading a post\n- Comment module of [Gitalk](https://gitalk.github.io/), [Gitment](https://imsun.github.io/gitment/), [Valine](https://valine.js.org/) and [Disqus](https://disqus.com/).(Gitalk is recommended)\n- Integrated [Busuanzi Statistics](http://busuanzi.ibruce.info/), `Google Analytics` and post word count statistics.\n- Support music playback and video playback on the homepage\n- Support the `emoji` emoticon and use the `markdown emoji` grammar to directly generate the corresponding emoticon.\n- Support [DaoVoice](http://www.daovoice.io/), [Tidio](https://www.tidio.com/) online chat.\n\n## Contributor\n\nThanks to these contributors, without whom, hexo-theme-matery won't be this perfect.\n\n- [@HarborZeng](https://github.com/HarborZeng)\n- [@shw2018](https://github.com/shw2018)\n- [@L1cardo](https://github.com/L1cardo)\n- [@Five-great](https://github.com/Five-great)\n\n## Download\n\nhexo-theme-matery **recommend you to use Hexo 5.0.0 and above**. If you already have your own [Hexo](https://hexo.io/zh-cn/) blog, I suggest you upgrade Hexo to the latest stable version.\n\nClick [here](https://codeload.github.com/blinkfox/hexo-theme-matery/zip/master) to download master branch of the last stable version of the code.After decompressing, copy the `hexo-theme-matery` folder\nto your `themes` folder of your Hexo blog project.\n\nOf course, you can use `git clone` to download in your `themes` folder.\n\n```bash\ngit clone https://github.com/blinkfox/hexo-theme-matery.git\n```\n\n## Configuration\n\n### Modify theme\n\nModify the value of `theme` in `_config.yml` of Hexo's root folder: `theme: hexo-theme-matery`.\n\n#### Suggestions for other changes to the `_config.yml`:\n\n- Please modify the value of `url` of `_config.yml` to your website's main `URL` (e.g. `http://xxx.github.io`).\n- It's recommended to modify the value of the two `per_page` to be a multiple of `6`, such as: `12`, `18`, etc. so that the posts list can be displayed well under each screen.\n- If you are a Chinese user, it is recommended to change the value of `language` to `zh-CN`.\n\n### new categories page\n\n`categories` page is to show all of categories. If the `source` directory of your blog doesn't have `categories/index.md` file, you need to create a new one like this:\n\n```bash\nhexo new page \"categories\"\n```\n\nwhen editing your new page file `/source/categories/index.md`, you need something like:\n\n```yaml\n---\ntitle: categories\ndate: 2018-09-30 17:25:30\ntype: \"categories\"\nlayout: \"categories\"\n---\n```\n\n### new tags page\n\n`tags` page is to show all of tags. If the `source` directory of your blog doesn't have `tags/index.md` file, you need to create a new one like this:\n\n```bash\nhexo new page \"tags\"\n```\n\nand put the following in your new page file `/source/tags/index.md`,\n\n```yaml\n---\ntitle: tags\ndate: 2018-09-10 18:23:38\ntype: \"tags\"\nlayout: \"tags\"\n---\n```\n\n### new about page\n\n`about` page is to show my blog and myself information. If the `source` directory of your blog doesn't have `about/index.md` file, create a new one like this:\n\n```bash\nhexo new page \"about\"\n```\n\nand edit your new page file `/source/about/index.md` to include:\n\n```yaml\n---\ntitle: about\ndate: 2018-09-30 17:25:30\ntype: \"about\"\nlayout: \"about\"\n---\n```\n\n### new contact page (Optional)\n\n`contact` page is to show contact information. If the `source` directory of your blog doesn't have `contact/index.md` file, you need to new one like this:\n\n```bash\nhexo new page \"contact\"\n```\n\nwhen editing your new page file `/source/contact/index.md`, include the following at the beginning:\n\n```yaml\n---\ntitle: contact\ndate: 2018-09-30 17:25:30\ntype: \"contact\"\nlayout: \"contact\"\n---\n```\n\n\u003e **Note**：The message board depends on a third-party comment system, please **activate** your comment system to be effective. And in the theme's `_config.yml` file, the \"**menu**\" of the `19` to `21` line is configured, and the comment about the message board could be canceled.\n\n### new friends link page (Optional)\n\nThe `friends` page is a page for displaying **Friendly Links** information. If you don't have a `friends/index.md` file in your blog's `source` directory, then you need to create a new one. The command is as follows:\n\n```bash\nhexo new page \"friends\"\n```\n\nEdit the file `/source/friends/index.md` you just created, at least you need the following:\n\n```yaml\n---\ntitle: friends\ndate: 2018-12-12 21:25:30\ntype: \"friends\"\nlayout: \"friends\"\n---\n```\n\nAlso, create a new `_data` directory in your blog's `source` directory and a new `friends.json` file in the `_data` directory. The contents of the file is as follows:\n\n```json\n[{\n    \"avatar\": \"http://image.luokangyuan.com/1_qq_27922023.jpg\",\n    \"name\": \"MaJang\",\n    \"introduction\": \"I am not a master, just looking for the master's footsteps.\",\n    \"url\": \"http://luokangyuan.com/\",\n    \"title\": \"Read More\"\n}, {\n    \"avatar\": \"http://image.luokangyuan.com/4027734.jpeg\",\n    \"name\": \"Blinkfox\",\n    \"introduction\": \"Hello, I'm blinkfox, I like programming.\",\n    \"url\": \"https://blinkfox.github.io/\",\n    \"title\": \"Visit Blog\"\n}, {\n    \"avatar\": \"http://image.luokangyuan.com/avatar.jpg\",\n    \"name\": \"ja_rome\",\n    \"introduction\": \"Ordinary steps can also go out of the great journey.\",\n    \"url\": \"https://me.csdn.net/jlh912008548\",\n    \"title\": \"Read More\"\n}]\n```\n### new 404 page\n\nIf the `source` directory of your blog doesn't have `404.md` file, you need create a new one. In `/source/404.md`, you need something as follows:\n\n```yaml\n---\ntitle: 404\ndate: 2020-05-30 00:00:00\ntype: \"404\"\nlayout: \"404\"\ndescription: \"Cannot find the page you want :(\"\n---\n```\n\n### Menu navigation configuration\n\n#### Configure the name of the basic menu navigation, path url and icon icon.\n\n1. The menu navigation name can be Chinese or English (e.g.: `Index` or `主页`)\n2. Icon icon can be found in [Font Awesome](https://fontawesome.com/icons)\n\n```yaml\nmenu:\n  Index:\n    url: /\n    icon: fas fa-home\n  Tags:\n    url: /tags\n    icon: fas fa-tags\n  Categories:\n    url: /categories\n    icon: fas fa-bookmark\n  Archives:\n    url: /archives\n    icon: fas fa-archive\n  About:\n    url: /about\n    icon: fas fa-user-circle\n  Friends:\n    url: /friends\n    icon: fas fa-address-book\n```\n\n#### Secondary menu configuration method\n\nIf you need a secondary menu, you can do the following on the basis of the original basic menu navigation.\n\n1. Add the `children` keyword to the first level menu that needs to add a secondary menu (e.g.: add `children` under the `About` menu)\n2. Create a secondary menu name, path url and icon icon under `children`.\n3. Note that each secondary menu module must be preceded by `-`.\n4. Note the indentation format.\n\n```yaml\nmenu:\n  Index:\n    url: /\n    icon: fas fa-home\n  Tags:\n    url: /tags\n    icon: fas fa-tags\n  Categories:\n    url: /categories\n    icon: fas fa-bookmark\n  Archives:\n    url: /archives\n    icon: fas fa-archive\n  About:\n    url: /about\n    icon: fas fa-user-circle\n  Friends:\n    url: /friends\n    icon: fas fa-address-book\n  Medias:\n    icon: fas fa-list\n    children:\n      - name: Music\n        url: /music\n        icon: fas fa-music\n      - name: Movies\n        url: /movies\n        icon: fas fa-film\n      - name: Books\n        url: /books\n        icon: fas fa-book\n      - name: Galleries\n        url: /galleries\n        icon: fas fa-image\n```\n\n### Code Highlight\n\nStarting from Hexo 5.0.0 version, it comes with support for `prismjs` code syntax highlighting, and hexo-theme-matery has been modified to support it.\n\nIf the plugin of `hexo-prism-plugin` has been installed in your blog, then you need to execute `npm uninstall hexo-prism-plugin` to uninstall it, otherwise there will be `\u0026#123;`, `\u0026#125;` escape characters in the code block of the post.\n\nThen, modify the value of `highlight.enable` to `false` in `_config.yml` at the root your hexo project, and set the value of `prismjs.enable` to `true`, the main configuration is as follows:\n\n```yaml\nhighlight:\n  enable: false\n  line_number: true\n  auto_detect: false\n  tab_replace: ''\n  wrap: true\n  hljs: false\nprismjs:\n  enable: true\n  preprocess: true\n  line_number: true\n  tab_replace: ''\n```\n\nThe default `prismjs` theme in the hexo-theme-matery is `Tomorrow Night`, if you want to customize your own theme, you can go to [prismjs download page](https://prismjs.com/download.html) to download yourself favorite theme `css` file, then name this css theme file `prism.css`, replace the `source/libs/prism/prism.css` file in the theme folder of `hexo-theme-matery`.\n\n### Search\n\nThe theme uses the Hexo plugin [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) to search the content, and the Installation command is as follows:\n\n```bash\nnpm install hexo-generator-search --save\n```\n\nAdd the following content in `_config.yml` at the root of your hexo project:\n\n```yaml\nsearch:\n  path: search.xml\n  field: post\n```\n\n### Translate Chinese Link to Pinyin (Recommended)\n\nDefault permalinks of Hexo will include Chinese if your article's title is Chinese. But it's adverse to `SEO`, and `gitment` comments don't support Chinese Link as well. We can use the [hexo-permalink-pinyin](https://github.com/viko16/hexo-permalink-pinyin) Hexo plugin to generate permalinks in Chinese Pinyin when generating posts.\n\nInstallation command is as follows：\n\n```bash\nnpm i hexo-permalink-pinyin --save\n```\n\nAdd such configurations in `_config.yml` file of Hexo:\n\n```yaml\npermalink_pinyin:\n  enable: true\n  separator: '-' # default: '-'\n```\n\n\u003e **Note**: [hexo-abbrlink](https://github.com/rozbo/hexo-abbrlink) can generate non-Chinese link in addition to this plugin.\n\n### Post word count statistics plugin (Recommended)\n\nIf you want to display the post word count and reading time information in the post detail page, you can install the [hexo-wordcount](https://github.com/willin/hexo-wordcount) plugin.\n\nInstallation command is as follows：\n\n```bash\nnpm i --save hexo-wordcount\n```\n\nThen just activate the following configuration items in the theme `_config.yml` file:\n\n```yaml\npostInfo:\n  date: true\n  update: false\n  wordCount: false # set true.\n  totalCount: false # set true.\n  min2read: false # set true.\n  readCount: false # set true.\n```\n\n### Add emoji support (Optional)\n\nThis theme adds support for the `emoji` emoticon, using the Hexo plugin [hexo-filter-github-emojis](https://npm.taobao.org/package/hexo-filter-github-emojis) to support the generation of the `emoji` expression. The corresponding `markdown emoji` syntax (`::`, for example: `:smile:`) is converted into a `emoji` expression that jumps. The installation command is as follows:\n\n```bash\nnpm install hexo-filter-github-emojis --save\n```\n\nAdd the following configuration into the `_config.yml` file in your hexo project root folder：\n\n```yaml\ngithubEmojis:\n  enable: true\n  className: github-emoji\n  inject: true\n  styles:\n  customEmojis:\n```\n\nExecute `hexo clean \u0026\u0026 hexo g` to regenerate the blog file, and then you can see the expression you wrote in the `emoji` grammar in the corresponding position in the article.\n\n### Add RSS feed support (Optional)\n\nThe theme uses the Hexo plugin [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed) to support `RSS` feed , and the Installation command is as follows:\n\n```bash\nnpm install hexo-generator-feed --save\n```\n\nAdd the following configuration into the `_config.yml` file in your hexo project root folder：\n\n```yaml\nfeed:\n  type: atom\n  path: atom.xml\n  limit: 20\n  hub:\n  content:\n  content_limit: 140\n  content_limit_delim: ' '\n  order_by: -date\n```\n\nExecute `hexo clean \u0026\u0026 hexo g` to regenerate the blog file, and then you can see the `atom.xml` file in the `public` folder, indicating that you have successfully installed.\n\n### [DaoVoice](http://www.daovoice.io/) online chat (Optional)\n\nGo to the official website of [DaoVoice](http://www.daovoice.io/), register and get the `app_id`. Fill the `app_id` into the the theme `_config.yml` file.\n\n### [Tidio](https://www.tidio.com/) online chat (Optional)\n\nGo to the official website of [Tidio](https://www.tidio.com/), register and get the `Public Key`. Fill the `Public Key` into the the theme `_config.yml` file.\n\n### Modify website footer\n\nWebsite footer may need to be customized, and it is not convenient to make it part of the configuration, So you need to modify and process it by yourself. Changes could be made in the theme's `/layout/_partial/footer.ejs` file, including the site information, the theme used, the amount of traffic and so on.\n\n### Modify social links\n\nIn the theme `_config.yml` file, the configurations of `QQ`, `GitHub` and mailbox and more are supported by default. In the `/layout/_partial/social-link.ejs` file of the theme, you can add or modify social link addresses as you need. To add a link, please refer to the following code:\n\n```html\n\u003c% if (theme.socialLink.github) { %\u003e\n    \u003ca href=\"\u003c%= theme.socialLink.github %\u003e\" class=\"tooltipped\" target=\"_blank\" data-tooltip=\"访问我的GitHub\" data-position=\"top\" data-delay=\"50\"\u003e\n        \u003ci class=\"fab fa-github\"\u003e\u003c/i\u003e\n    \u003c/a\u003e\n\u003c% } %\u003e\n```\n\nYou can search social icons such as `fab fa-github` in [Font Awesome](https://fontawesome.com/icons). There are common social icons you can reference:\n\n- Facebook: `fab fa-facebook`\n- Twitter: `fab fa-twitter`\n- Google-plus: `fab fa-google-plus`\n- Linkedin: `fab fa-linkedin`\n- Tumblr: `fab fa-tumblr`\n- Medium: `fab fa-medium`\n- Slack: `fab fa-slack`\n- Sina Weibo: `fab fa-weibo`\n- Wechat: `fab fa-weixin`\n- QQ: `fab fa-qq`\n- Zhihu: `fab fa-zhihu`\n\n\u003e **Note**: The version of `Font Awesome` used by matery is `5.11.0`.\n\n### Configure music player (optional)\n\nTo support music playing, you just need to activate music playing configuration in the theme's `_config.yml` file.\n\n```yaml\n# Whether to display the music\nmusic:\n  enable: true\n  title: \t\t   # non-fixed mode works\n    enable: true\n    show: Listen to music\n  server: netease   # require music platform: netease, tencent, kugou, xiami, baidu\n  type: playlist    # require song, playlist, album, search, artist\n  id: 503838841     # require song id / playlist id / album id / search keyword\n  fixed: false      # enable fixed mode\n  autoplay: false   # audio atuoplay\n  theme: '#42b983'\n  loop: 'all'       # player loop play, values: 'all', 'one', 'none'\n  order: 'random'   # player play order, values: 'list', 'random'\n  preload: 'auto'   # values: 'none', 'metadata', 'auto'\n  volume: 0.7       # default volume, notice that player will remember user setting, default volume will not work after user set volume themselves\n  listFolded: true  # indicate whether list should folded at first\n```\n\n\u003e`server` values :  `netease` (NetEase  cloud music) , `tencent` (QQMusic) , `kugou` (KuGouMusic) , `xiami`  \n\u003e(XiamMusic) , `baidu` (BaiduMusic)  \n\u003e`type` values : `song`  ,   `playlist` , `album` , `search` , `artist`  \n\u003eFor example to get the `id`:open NetEase cloud music in the browser , click the playlist of my love , there will a string of  \n\u003enumbers  in the browser\\`s address bar  ,  the `playlist`\\`s `id` just is the string of numbers.\n\n### add note\n\n\u003e [demonstration](https://blog.17lai.site/posts/cf0f47fd/#tag-note)\n\n#### Usage\n\n```\n{% note [class] [no-icon] [summary] %}\nAny content (support inline tags too).\n{% endnote %}\n```\n\n- `[class]` : *Optional parameter.* Supported values: default | primary | success | info | warning | danger.\n- `[no-icon]` : *Optional parameter.* Disable icon in note.\n- `[summary]` : *Optional parameter.* Optional summary of the note.\n\nAll parameters are optional.\n\n#### example\n\n```\n{% note %}\n#### Header\n(without define class style)\n{% endnote %}\n```\n\n### add button\n\n\u003e [demonstration](https://blog.17lai.site/posts/cf0f47fd/#tag-button)\n\n#### Usage\n\n```\n{% button url, text, icon [class], [title] %}\n```\n\nor\n\n```\n{% btn url, text, icon [class], [title] %}\n```\n\n- `url` : Absolute or relative path to URL.\n- `text` : Button text. Required if no icon specified.\n- `icon` : Font Awesome icon name. Required if no text specified.\n- `[class]` : *Optional parameter.* Font Awesome class(es): `fa-fw` | `fa-lg` | `fa-2x` | `fa-3x` | `fa-4x` | `fa-5x`\n- `[title]` : *Optional parameter.* Tooltip at mouseover.\n\n#### Examples\n\n```\n{% button #, Text %}\n```\n\n\n## Post Front-matter\n\n### Detailed Front-matter options\n\nEverything in the Front-matter option is **not required**. But I still recommend at least filling in the values of `title` and `date`.\n\n| Options   | Defaults              | Description                                             |\n| ---------- | --------------------------- | ------------------------------------------------------------ |\n| title      | Markdown's file title | Post title, it is highly recommended to fill in this option |\n| date       | Date and time when the file created | Publish time, it is highly recommended to fill in this option, and it is best to ensure that it is globally unique |\n| author     | `author` in root `_config.yml` | Post author                                    |\n| img        | a value in `featureImages`  | Post feature image，For example: `http://xxx.com/xxx.jpg` |\n| top        | `true`                      | Recommended post (whether the post is topped), if the `top` value is `true`, it will be recommended as a homepage post. |\n| hide        | `false`                      | Whether show this post in homepage, if the `hide` value is `true`, it will not be showed in homepage. |\n| cover      | `false`                     | The `v1.0.2` version is added to indicate whether the post needs to be added to the homepage carousel cover. |\n| coverImg   | null                        | The new version of `v1.0.2` indicates that the post needs to display the image path on the cover of the homepage. If not, the default image of the post is used by default. |\n| password   | null                        | The post read the password. If you want to set the reading verification password for the article, you can set the value of `password`, which must be encrypted with `SHA256` to prevent others from seeing it. The premise is that the `verifyPassword` option is activated in the theme's `config.yml` |\n| toc        | `true`                      | Whether TOC is turned on or not, you can turn off the TOC function for an article. The premise is that the `toc` option is activated in the theme's `config.yml` |\n| mathjax    | `false`                     | Whether to enable math formula support, whether this article starts `mathjax`, and you need to open it in the theme `_config.yml` file. |\n| summary    | null                        | Post summary, custom post summary content, if the attribute has a value, the post card summary will display the text, otherwise the program will automatically intercept part of the article as a summary |\n| categories | null                        | Article classification, the classification of this topic represents a macroscopically large classification, only one article is recommended for one classification. |\n| tags       | null                        | Post label, a post can have multiple labels |\n| keywords   | Post Title                  | Post key Words With SEO                               |\n| reprintPolicy       | cc_by              | Post reprint policy, value could be one of cc_by, cc_by_nd, cc_by_sa, cc_by_nc, cc_by_nc_nd, cc_by_nc_sa, cc0, noreprint and pay |\n\n\u003e **Note**: \n\u003e 1. post's featured picture will take remainder if not writing the `img` property, and choose the featured picture of theme to let all of post's picture **have their own characteristics**.\n\u003e 2. The value of `date` should try to ensure that each article is unique, because `Gitalk` and `Gitment` recognize `id` in this topic are uniquely identified by the value of `date`.\n\u003e 3. If you want to set the ability to read the verification password for the article, you should not only set the value of the password with SHA256 encryption in Front-matter, but also activate the configuration in the theme `_config.yml`.\n\u003e 4. you can define reprint policy for a single article in the front-matter of the specific md file using this key: reprintPolicy\n\nThe following are examples of the post's `Front-matter`.\n\n### The simplest example\n\n```yaml\n---\ntitle: typora-vue-theme Theme introduction\ndate: 2018-09-07 09:25:00\n---\n```\n\n### The most comprehensive example\n\n```yaml\n---\ntitle: typora-vue-theme Theme introduction\ndate: 2018-09-07 09:25:00\nauthor: Qi Zhao\nimg: /source/images/xxx.jpg\ntop: true\nhide: false\ncover: true\ncoverImg: /images/1.jpg\npassword: 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92\ntoc: false\nmathjax: false\nsummary: This is the content of your custom post summary. If there is a value for this attribute, the post card summary will display the text, otherwise the program will automatically intercept part of the post content as a summary.\ncategories: Markdown\ntags:\n  - Typora\n  - Markdown\n---\n```\n\n## Screenshot\n\n### Home\n\n![首页](http://static.blinkfox.com/matery-20181202-1.png)\n\n![首页推荐文章](http://static.blinkfox.com/matery-20181202-2.png)\n\n![首页文章列表](http://static.blinkfox.com/matery-20181202-3.png)\n\n![首页文章列表](http://static.blinkfox.com/matery-20181202-7.png)\n\n![首页文章列表](http://static.blinkfox.com/matery-20181202-8.png)\n\n## Custom modification\n\nYou can modify some custom modification in `_config.yml` as follows:\n\n- Menu\n- My dream\n- Home music player and video player configuration\n- Whether to display the title of the recommended posts\n- `favicon` and `Logo`\n- profiles\n- TOC\n- post rewards\n- Append copyright information when copying article content\n- MathJax\n- Post word count, reading times\n- the 'love' effect of clicking on the page\n- My Projects\n- My Skills\n- My Gallery\n- Gitalk, Gitment, Valine and Disqus\n- [Busuanzi Statistics](http://busuanzi.ibruce.info/) And Google Analytics\n- The map of default featured pictures. The theme will take remainder according to `hashcode` of the post title if the post does not set featured pictures.\n\n**I think everyone should have their own style and feature for their blogs**. If you are not satisfied with the theme's functions and color, you can modify them by yourself,\nand more free functions and details could be changed by modifying source code when it is hard to achieve by modifying the theme's `_config.yml`.\n\n### Customizing theme color\n\nSearch `.bg-color` to modify background color in `/source/css/matery.css` in theme file：\n\n```css\n/* The overall background color, including navigation, mobile navigation, footer, tab, etc.. */\n.bg-color {\n    background-image: linear-gradient(to right, #4cbf30 0%, #0f9d58 100%);\n}\n\n@-webkit-keyframes rainbow {\n   /* Dynamically switch background colors. */\n}\n\n@keyframes rainbow {\n    /* Dynamically switch background colors. */\n}\n```\n\n### Modify banner picture and post's featured pictures\n\nYou can change `banner` pictures in `/source/medias/banner` as you like .Theme code can switch dynamically every day and just need 7 pictures.If you master `JavaScript`, you can change it to your favorite switching logic, such as Random switching. The code for switching `banner`is in `\u003cscript\u003e\u003c/script\u003e` of `/layout/_partial/bg-cover-content.ejs`file.\n\n```javascript\n$('.bg-cover').css('background-image', 'url(/medias/banner/' + new Date().getDay() + '.jpg)');\n```\n\nThere are 24 featured pictures in `/source/medias/featureimages`, you can add or delete some, and modify corresponding settings in the theme's `_config.yml`.\n\n## Changelog\n\nSee [CHANGELOG.md](https://github.com/blinkfox/hexo-theme-matery/blob/master/CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblinkfox%2Fhexo-theme-matery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblinkfox%2Fhexo-theme-matery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblinkfox%2Fhexo-theme-matery/lists"}