{"id":13430612,"url":"https://github.com/shenliyang/hexo-theme-snippet","last_synced_at":"2025-05-16T08:03:47.906Z","repository":{"id":37484084,"uuid":"96759785","full_name":"shenliyang/hexo-theme-snippet","owner":"shenliyang","description":"Snippet 简洁而不简单，也许是一款你寻找已久的hexo主题","archived":false,"fork":false,"pushed_at":"2023-04-18T18:18:07.000Z","size":1355,"stargazers_count":1093,"open_issues_count":11,"forks_count":209,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-05-03T16:01:57.368Z","etag":null,"topics":["awesome-hexo","hexo","hexo-theme-snippet","snippet"],"latest_commit_sha":null,"homepage":"https://snippet.shenliyang.com/","language":"Less","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shenliyang.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2017-07-10T09:26:39.000Z","updated_at":"2025-04-24T04:01:17.000Z","dependencies_parsed_at":"2022-07-22T05:01:51.378Z","dependency_job_id":"23fb5e23-8584-4125-ada9-2d20687e1996","html_url":"https://github.com/shenliyang/hexo-theme-snippet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shenliyang%2Fhexo-theme-snippet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shenliyang%2Fhexo-theme-snippet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shenliyang%2Fhexo-theme-snippet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shenliyang%2Fhexo-theme-snippet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shenliyang","download_url":"https://codeload.github.com/shenliyang/hexo-theme-snippet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254493380,"owners_count":22080126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["awesome-hexo","hexo","hexo-theme-snippet","snippet"],"created_at":"2024-07-31T02:00:55.629Z","updated_at":"2025-05-16T08:03:47.892Z","avatar_url":"https://github.com/shenliyang.png","language":"Less","funding_links":[],"categories":["Content","Less"],"sub_categories":[],"readme":"# hexo-theme-snippet\n\nSnippet 简洁而不简单，也许是一款你寻找已久 hexo 主题。\n\n如果本主题也是你喜欢的菜，请动动手指 [Star](https://github.com/shenliyang/hexo-theme-snippet/stargazers) 支持一下\n\n[![Build Status](https://api.travis-ci.com/shenliyang/hexo-theme-snippet.svg?branch=develop)](https://travis-ci.com/shenliyang/hexo-theme-snippet)\n[![Read the Docs](https://img.shields.io/badge/docs-complete-brightgreen)](https://github.com/shenliyang/hexo-theme-snippet/blob/master/README.md)\n[![mnt-image](https://img.shields.io/maintenance/yes/2030.svg)](../../commits/master)\n[![codebeat badge](https://codebeat.co/badges/6ef2dcd2-af90-40e0-9628-ac689441f774)](https://codebeat.co/projects/github-com-shenliyang-hexo-theme-snippet-master)\n[![GitHub stars](https://img.shields.io/github/stars/shenliyang/hexo-theme-snippet.svg)](https://github.com/shenliyang/hexo-theme-snippet/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/shenliyang/hexo-theme-snippet.svg)](https://github.com/shenliyang/hexo-theme-snippet/network)\n[![hexo version](https://img.shields.io/badge/hexo-%3E%3D%203.0-blue.svg)](http://hexo.io)\n[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/shenliyang/hexo-theme-snippet/blob/master/LICENSE)\n\n[主题 Demo 戳这里](http://shenliyang.github.io?rf=gh-demo)\n\n![hexo-theme-snippet](https://hexo-theme-snippet-1251680922.cos.ap-beijing.myqcloud.com/img/snippet-screenshots1000.jpg \"Snippet主题\")\n\n## 主题特点\n\n- [x] 原生 JavaScript 实现，去 jQuery 化\n- [x] 样式支持 CSS 预处理器 Less，方便主题自定义\n- [x] 文章过期提醒功能\n- [x] 文章阅读进度条\n- [x] 网站公告功能\n- [x] 首页图片懒加载\n- [x] 首页文章缩略图自动检索文章内图片，支持自动随机图片\n- [x] 主题支持响应式\n- [x] 支持 3D 云标签\n- [x] 支持文章推送和文章打赏\n- [x] 站内本地搜索和谷歌搜索\n- [x] 支持多个第三方评论系统\n- [x] 支持网站统计和不蒜子访客统计\n- [x] 移动端的简洁设计\n- [x] 支持代码高亮并支持自定义高亮样式\n- [x] 支持 Shell 脚本通过 Travis CI 自动化部署 Hexo 博客\n- [x] 支持 Hexo 自动化部署结果发送邮件和实时推送到钉钉\n\n# **基础篇**\n\n\u003e 如果你在此之前使用的是 `Hexo 2.x` 版本，为了避免未知的错误，请备份好数据，或者建立新的博客目录\n\n\u003e \"主题目录\" =\u003e `themes\\hexo-theme-snippet`, \"Hexo 根目录\" =\u003e 项目主目录;\n\u003e \"主题配置\" =\u003e `themes\\hexo-theme-snippet\\_config.yml`, \"Hexo 配置\" =\u003e 项目主目录下`_config.yml`\n\n### 1. 环境搭建\n\n需要`Node.js` 环境、`Git` 环境以及 `Hexo` ,如果你尚未安装或者不了解 `Hexo`，请参考 [官方教程](https://hexo.io/zh-cn/docs/index.html) 进行了解以及安装。如果需要构建工具请自行安装，或使用本主题的 Gulp 方式。\n\n### 2. 下载主题\n\n有两种方式获取本主题--下载 `*.zip` 文件和通过 `git`方式：\n\n1. 下载 [Snippet 主题](https://github.com/shenliyang/hexo-theme-snippet) 文件解压后放在 `themes` 目录下，和博客中的 landscape 为同级目录\n\n2. Git 方式，在 Hexo 根目录执行：\n\n```bash\ngit clone git://github.com/shenliyang/hexo-theme-snippet.git themes/hexo-theme-snippet\n```\n\n### 3. 安装主题插件\n\n因为 **hexo-theme-snippet** 使用了 `ejs` 模版引擎 、 `Less` CSS 预编译语言以及在官方插件的基础上\n进行功能的开发，以下为必装插件：\n\n```bash\nnpm i hexo-renderer-ejs hexo-renderer-less hexo-deployer-git -S\n```\n\n### 4. 部署主题\n\n\u003e 如果没有更改过主题源文件,也不需要代码优化可以跳过 1,2,3 步骤\n\n1. gulp 打包构建，拷贝主题目录下`package.json`文件到 Hexo 根目录下，然后安装项目的开发依赖。 [Gulp 入门指南](http://www.gulpjs.com.cn/docs/getting-started/)\n\n```bash\nnpm i   //安装项目依赖\n```\n\n2. 在 Hexo 根目录下创建一个名为 gulpfile.js 的文件：\n\n```bash\nrequire('./themes/hexo-theme-snippet/gulpfile');\n```\n\n3. 运行 gulp：\n\n```bash\ngulp 或者 gulp default   //执行打包任务\n```\n\n4. 清空 hexo 静态文件和缓存，并重新生成\n\n```bash\nhexo clean \u0026\u0026 hexo g  //清空缓存并生成静态文件\n```\n\n5. 本地预览，确没有问题再进行发布\n\n```bash\nhexo s -p 4000 或者 hexo s  //启动本地服务默认\n```\n\n6. 当 gulp 执行完成，并提示 `please execute： hexo d` 时，可以进行发布\n\n```bash\nhexo d 或者 gulp deploy  //部署发布\n```\n\n### 5. 更新主题\n\n主题可能会不定时优化和更新，更新主题代码：\n\n```bash\ncd themes/hexo-theme-snippet\ngit pull\n```\n\n# **主题篇**\n\n### 1. 主题配置\n\n```yaml\n\n## menu -- 导航菜单显示{[@page:名字,@url:地址,@icon:图标]}\nmenu:\n  - page: home\n    url: /\n    icon: fa-home\n\n## favicon -- 网站图标位置{@favicon}\nfavicon: /favicon.ico\n\n## rss --rss文件位置{@rss}\nrss: /atom.xml\n\n\n# 各个小工具的设置\n\n## widgets -- 6个左边小工具{@widgets:[notification,category,archive,tagcloud,friends]}\nwidgets:\n  - search\n  - notification\n  - social\n  - category\n  - archive\n  - tagcloud\n  - friends\n\n# 各个小工具的设置\n\n## 搜索\njsonContent:\n  searchLocal: true // 是否启用本地搜索\n  searchGoogle: true //是否启用谷歌搜索\n  posts:\n    title: true\n    text: true\n    content: true\n    categories: false\n    tags: false\n\n## notification config --网站公告设置,支持 html 和 纯文本\nnotification: |-\n            \u003cp\u003e主题已经上线！欢迎下载或更新~ \u003cbr/\u003e\n            主题下载：\u003ca href=\"https://github.com/shenliyang/hexo-theme-snippet\" title=\"fork me\" target=\"_blank\"\u003eSnippet主题\u003c/a\u003e \u003cbr/\u003e\n            \u003chr/\u003e接受贡献，包括不限于提交问题与需求，修复代码。欢迎Pull Request\u003cbr/\u003e支持主题：\u003ca href=\"https://github.com/shenliyang/hexo-theme-snippet/stargazers\"\u003eStar一下\u003c/a\u003e\u003c/p\u003e\n\n## 社交设置{@name:社交工具名字，@icon:社交工具图标，@href:设置工具链接} [参考图标](http://fontawesome.io/icons/)\nsocial:\n  - name: Github\n    icon: git\n    href: //github.com/shenliyang\n\n## 文章分类设置{@cate_config:{@show_count:是否显示数字，@show_current: 是否高亮当前category}}\ncate_config:\n   show_count: true\n   show_current: true\n\n## 文章归档设置{@arch_config:/*参数参考：https://hexo.io/zh-cn/docs/helpers.html#list-archives*/}\n## 推荐组合方式：[{type: 'monthly',format: 'YYYY年MM月'},{type: 'yearly',format: 'YYYY年'}]\narch_config:\n   type: 'monthly'\n   format: 'YYYY年MM月'\n   show_count: true\n   order: -1\n\n## 标签云设置{/*参数参考：http://www.goat1000.com/tagcanvas-options.php */}\ntagcloud:\n  tag3d: false // 是否启用3D标签云\n  textColour: '#444' // 字体颜色\n  outlineMethod: 'block' // 选中模式(outline|classic|block|colour|size|none)\n  outlineColour: '#FFDAB9' // 选中模式的颜色\n  interval: 30 // 动画帧之间的时间间隔，值越大，转动幅度越大\n  freezeActive: true // 选中的标签是否继续滚动\n  frontSelect: true // 不选标签云后部的标签\n  reverse: true // 是否反向触发\n  wheelZoom: false // 是否启用鼠标滚轮\n\n## 友链设置{@链接名称：链接地址{@links:[,,,]}}\nlinks:\n  - Hexo官网: https://hexo.io/zh-cn/\n\n\n# 主题自定义个性化配置\n\n## 网站宣传语{@branding：网站宣传语(不设置显示本地图片)}\nbranding: 从未如此简单有趣\n\n## 设置banner背景图片{@img:自定义图片地址(支持绝对和相对路径),主题默认{\"静态背景\":\"banner.jpg\"},{\"动态背景\":\"banner2.jpg\"},{\"动态星空背景\":\"banner3.jpg\"}}\n## 例如：https://hexo-theme-snippet-1251680922.cos.ap-beijing.myqcloud.com/img/banner|2|3.jpg, 或者 './img/banner-img.jpg'(相对本地资源地址)\nbanner:\n  img: https://hexo-theme-snippet-1251680922.cos.ap-beijing.myqcloud.com/img/banner.jpg\n\n\n## 设置carousel{@img:图片地址,@url:点击跳转链接(默认值:\"javascript:\")}\ncarousel:\n  img: 'img/head-img.jpg'\n  url: 'javascript:'\n\n## 首页列表底部面板{@homePanel: 是否开启}\nhomePanel: true\n\n## 首页文章列表缩略图\n### 加载规则: 自定义文章缩略图(在Front-matter中添加的'img'字段) \u003e 文章内的图片 \u003e defaultImgs(随机获取) \u003e 无图模式列表\n\n## 自定义随机图片\ndefaultImgs:\n  - http://www.example.jpg //远程图片链接示例\n  - /img/default-1.jpg //本地图片链接示例\n\n### 文章摘要{@摘要显示优先级：自定义摘要 \u003e 自动截取摘要 }\n### 自定义摘要范围{@\u003c!--more--\u003e:截取more之前的内容为摘要}\n### 自动截取摘要{@excerptLength:自动截取文章前多少个字为摘要，不配置默认：120字}\nexcerptLength: 120\n\n## 是否开启文章目录\ntoc: true\n\n## 代码高亮配置{@highlightTheme: 主题名称,(配置暂时不可用，后续开发中…)}\n\nhighlightTheme: default //TODO\n\n## 文章过期提醒功能 {@warning:{days:临界天数(默认300天,设置0关闭功能),text:提醒文字/*%d为过期总天数占位符*/}}\nwarning:\n  days: 300\n  text: '本文于%d天之前发表，文中内容可能已经过时。'\n\n## 文章内声明{@declaration: {enable:是否开启,title:声明标题,tip:提示内容}}\ndeclaration:\n  enable: true\n  title: '转载声明'\n  tip: |-\n      商业转载请联系作者获得授权,非商业转载请注明出处 © \u003ca href=\"\" target=\"_blank\"\u003eSnippet\u003c/a\u003e\n\n## 文章打赏{@reward: {alipay:支付宝打赏,wepay:微信打赏,tip:打赏提示语; 链接都为空,关闭打赏功能}}\nreward:\n  alipay: ''\n  wepay: '../img/reward-wepay.jpg'\n  tip: 赞赏是不耍流氓的鼓励\n\n\n## 主题评论\n\n## utterances评论: 一款基于 GitHub issues 的评论工具; 首先在 github 上进行安装 utterances，访问 [utterances应用程序](https://github.com/apps/utterances)；然后在主题内配置 [utterances更多配置](https://utteranc.es/)\nutterances:\n  enable: true\n  repo: shenliyang/snippet-comment // github仓库名字, 格式为 user-name/repo-name\n  issueTerm: pathname // 标识issue类型 1. pathname(推荐); 2. url; 3.title; 3. og:title; 4. issue-number 5. specific-term;\n  issueNumber: 123 // 非必填，当配置 issueTerm = \"issue-number\"时，需要配置issue号\n  theme: github-light // 主题配置 1. github-light(推荐); 2. github-dark; 3. preferred-color-scheme; 4. github-dark-orange; 5. icy-dark; 6. dark-blue; 7. photon-dark; 8. boxy-light\n  label: // 非必填\n  cdn: // 使用自定义utteranc脚本加载。 非必填，默认：\"https://utteranc.es/client.js\"\n\n### gitment\ngitment:\n  enable: false\n  owner:\n  repo:\n  client_id:\n  client_secret:\n  labels:\n  perPage:\n  maxCommentHeight:\n\n### 来必力\nlivere:\n  enable: false\n  livere_uid:\n\n### 友言评论(服务不稳定，经常无法加载)\nuyan:\n  enable: false\n  uyan_id:\n\n### Disqus评论(需要翻墙，或者搭建代理)\ndisqus:\n  enable: false\n  shortname: snippet\n  count: false\n\n### 畅言评论(需要ICP备案)\nchangyan:\n  enable: false\n  appid:\n  conf:\n\n### Valine评论(leancloud需要实名认证) 参考网站: [valine评论](https://valine.js.org/)\nvaline:\n  enable: false\n  appId:\n  appKey:\n  placeholder: 说点什么吧\n  notify: false // 邮件通知\n  verify: false // 验证码\n  avatar: mm // avatar头像\n  meta: nick,mail // 输入框内容，可选值nick,mail,link\n  pageSize: 10\n\n## Gitalk评论 参考网站: [一个基于Github Issue和Preact开发的评论插件](https://gitalk.github.io/)\ngitalk:\n   enable: false\n   clientID: \"\" // Github 应用ID\n   clientSecret: \"\" // Github 应用密钥\n   repo: shenliyang.github.io // Github仓库地址\n   owner: shenliyang  // Github 用户名(Github仓库拥有者)\n   admin: shenliyang // GitHub repository 的所有者和合作者 (对这个 repository 有写权限的用户)可以有一个或多个，如果有多名可使用，例如：admin: admin1,admin2 配置\n   perPage: 10 // 每次加载的数据大小，最多100\n   distractionFreeMode: true // 是否启用无干扰模式，类似Facebook评论框的全屏遮罩效果\n\n   // 以下参数主题会默认处理，不需要配置\n   language // 语言类型，默认为站点配置中选项\n   id // 页面的唯一标识, 已使用md5对pathname转换生成唯一id处理\n\n## 网站访客统计 [不蒜子统计](http://busuanzi.ibruce.info/)\nvisit_counter:\n   site: true // 总访问量和访问人数统计\n   page: true // 文章阅读量统计\n\n## 网站访问统计\n\n### 网盟CNZZ统计 参考网站: [网盟CNZZ](http://www.umeng.com/)\ncnzz_anaylytics:\n\n### 百度统计 参考网站: [百度统计](https://tongji.baidu.com/)\nbaidu_anaylytics:\n\n### 谷歌统计 参考网站：[谷歌统计](https://www.google-analytics.com/)\ngoogle_anaylytics:\n\n### 腾讯分析 参考网站：[腾讯分析](http://ta.qq.com/)\ntencent_analytics:\n\n### 百度站点认证\nbaidu-site-verification:\n\n### 百度自动推送(@baidu_push: 是否启用百度自动推送)  参考网站: [百度站长资源](https://ziyuan.baidu.com/college/courseinfo?id=267\u0026page=2#h2_article_title18)\nbaidu_push:\n\n## ICON配置 (不配则启用本地Font Icon)\nfontAwesome: //cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css\n\n## 网站主题配置\nsince: 2017  //建站时间\nbeian: '京ICP备04000001号' //网站备案号\nrobot: 'all'  //控制搜索引擎的抓取和索引编制行为，默认为all\nversion: 1.3.0  //当前主题版本号\n```\n\n### 主题使用技巧及功能扩展\n\n1. 修改新增文章 Front-matter 模板,修改`scaffolds`目录下的`post.md`模板\n   \u003e 模板文件内部不要保留注释部分,关键词后面请使用英文冒号\n\n```yml\n  ---\n  title: {{ title }} // 标题\n  date: {{ date }}   // 时间\n  categories: ['分类1','分类2'] // 分类\n  tags: ['标签1','标签2']       // 标签\n  comments: false    // 是否开启评论\n  img:               // 自定义缩略图\n  ---\n```\n\n2. 启用站内本地搜索功能\n\n如果要使用本地站点搜索，必须安装插件 hexo-generator-json-content 来创建本地搜索 json 文件\n\n```bash\nnpm i hexo-generator-json-content@2.2.0 -S\n```\n\n然后修改主题配置\\_config.yml 文件下`jsonContent`相关参数。\n\n# **提升篇**\n\n## 1. Travis CI 介绍\n\nCI 即持续集成系统。对个人而言，就是让你的代码在提交到远程(这里是 GitHub)，立即自动编译，自动化测试、自动部署等。\n\n不需要在担心更换电脑时，还要从新部署环境的问题，只要你能向远程推送文章，其他的事情就都可以交给 Travis CI 处理就 ok 了。\n\n## 2. Travis CI 使用\n\n\u003e 默认前提是已经通过 Github 进行授权登录 Travis 网站，并关联了 GitHub 上的仓库和相关配置。\n\n1. 拷贝主题下的`gulpfile.js` `travis.yml` `travis.sh` 到项目根目录\n\n2. 配置 travis.yml 文件\n\n```yml\nlanguage: node_js #使用Node语言环境\nnode_js: stable #安装稳定版Node\n\nsudo: false\n\n#cache 启用缓存，加快构建速度\ncache:\n  directories:\n    - \"node_modules\"\n\nnotifications: #启用通知\n  email:\n    recipients:\n      - snippet@aliyun.com #接收构建消息的邮件 不需要可设置为false\n    on_success: never #部署成功时，可设置alway never change\n    on_failure: always #部署失败时，同上\n\n# S: Build Lifecycle\n\nbefore_install:\n  - sudo apt-get install libnotify-bin #支持linux桌面提醒库\n\ninstall:\n  - npm install #安装依赖\n\nbefore_script:\n  - export TZ='Asia/Shanghai' #设置时区\n  - npm install -g gulp #全局安装Gulp\n  - chmod +x _travis.sh #授权脚本执行权限\n\nscript:\n  - hexo clean \u0026\u0026 hexo g #清除缓存并生成静态文件\n  - gulp #执行gulp任务\n\nafter_success: #执行成功时(以后扩展功能使用)\n\nafter_script:\n  - ./_travis.sh #执行部署脚本\n# E: Build LifeCycle\n\nbranches:\n  only:\n    - dev #需要监听部署的分支\nenv:\n  global:\n    - GH_REF: github.com/shenliyang/shenliyang.github.io.git #更改为自己git地址\n```\n\n3. 提交代码到 Github，实现自动部署\n4. 当 `.travis.yml `配置文件修改完成后，将其提交到远程仓库的 hexo 分支下，此时如果之前的配置一切 ok，我们应该能在 Travis CI 的博客项目主页页面中看到自动构建已经在开始执行了。上面会显示出构建过程中的日志信息及状态等。\n\n## 3. 主题开发\n\nGulp 执行启用主题开发模式\n\n```bash\ngulp dev\n```\n\n会监听样式 less 或者 JS 文件的变动。然后执行上面的【主题发布】即可。\n\n### 运行预览\n\n```bash\nhexo clean \u0026\u0026 hexo g \u0026\u0026 hexo s -p 4000\n```\n\n监听 4000 端口，使用浏览器打开地址`http://localhost:4000`进行预览。\n\n# **其他**\n\n## 感谢\n\n在设计这款主题的时候参考了好多主题和博客的设计和创意，深表感谢！\n\n## 鼓励\n\n**如果觉得本主题还不错，您的支持和鼓励才是后续更新最大的动力，== 欢迎 [Star](https://github.com/shenliyang/hexo-theme-snippet/stargazers)下 ==**\n\n![Stargazers over time](https://starchart.cc/shenliyang/hexo-theme-snippet.svg)\n\n## 宗旨\n\n主题宗旨：**致力主题简洁轻量，配置方便开箱即用**，该主题项目会持续维护和更新。\n\n## 贡献\n\n接受各种形式的贡献，包括但不限于提交问题或需求，修复代码。\n欢迎大家提 Issue 或者 Pull Request。\n\n\u003e Hexo 框架追求的是快速、简洁，高效。喜欢绚丽，添加各种功能，折腾的朋友，建议移步至：[wordpress 官网](https://cn.wordpress.org/)\n\n## 你不知道的提 Issues 技巧\n\n\u003e 强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393)，更好的问题更容易获得帮助。\n\n\u003cb\u003e\\* 已阅读以上文章，并知晓，可以 \u003c/b\u003e [提 Issues](https://github.com/shenliyang/hexo-theme-snippet/issues/new) 了。\n\n## 常见问题\n\n#### 1. 搜索功能不能用，content.json 文件找不到？\n\n需要安装 hexo-generator-json-content 插件：\n\n```bash\nnpm i hexo-generator-json-content@2.2.0 -S\n```\n\n#### 2. 谷歌搜索没有响应？\n\n如果使用谷歌搜索没有响应，确定是否已经科学上网\n\n#### 3. 怎么设置首页文章缩略图自动检索文章内图片？\n\n首页文章缩略图加载规则: 自定义文章缩略图 \u003e 自动检索文章内的图片 \u003e defaultImgs(随机获取) \u003e 无图模式列表\n\n在`Front-matter`中：\n指定 img 变量 -\u003e 为固定缩略图\n不指定 img 变量 -\u003e 自动检索文章内的图片\n\n#### 4. 在 url 哪里可以访问到本地静态文件吗？\n\n在主题 `source` 目录下新建文件夹，例如: `static`文件夹，然后添加静态资源，例如: xxx.pdf 文件， 访问：_`http://yoursite.com/static/xxx.pdf`_\n\n#### 5. 这个主题有分页功能吗？\n\n主题已经集成分页功能，在 Hexo 配置中修改\n\n| 参数           |                描述                 | 默认值 |\n| -------------- | :---------------------------------: | :----: |\n| per_page       | 每页显示的文章量 (0 = 关闭分页功能) |   10   |\n| pagination_dir |              分页目录               |  page  |\n\n#### 6. 为什么右侧小工具标题都为英文呢？\n\n可能是您忘记预设网站语言，而启用默认语言了，请先在 Hexo 配置中调整 language 设定\n\n```bash\nlanguage: zh-CN\n```\n\n#### 7. 关于 Hexo 标签和分类方法的分歧\n\n\u003e 只有文章支持分类和标签，您可以在 Front-matter 中设置。在其他系统中，分类和标签听起来很接近，但是在 Hexo 中两者有着明显的差别：分类具有顺序性和层次性，也就是说 `Foo, Bar` 不等于 `Bar, Foo`；而标签没有顺序和层次。\n\n如果您有过使用 WordPress 的经验，就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类，而且这些分类可以是同级的，也可以是父子分类。但是 Hexo 不支持指定多个同级分类。下面的指定方法：\n\n```bash\ncategories:\n- Diary\n- Life\n```\n\n会使分类 Life 成为 Diary 的子分类，而不是并列分类。因此，有必要为您的文章选择尽可能准确的分类。\n\nHexo 官方文档: [分类方法的分歧](https://hexo.io/zh-cn/docs/front-matter#分类和标签)\n\n#### 8. tags 以及 categories 页面显示不正确，不能访问，显示 404？\n\n当使用主题访问，域名+/tags 或 域名+ /categories 若访问 404，是正常情况的。因为这些路径本不属于主题或者 Hexo 框架的一部分。而是由用户主动新建页面扩展而来。\n\n可以新建页面，比如：tags 和 categories，按以下命令格式：\n\n```bash\n hexo new page tags 和 hexo new page categories\n```\n\n当使用主题访问，域名+/tags 或 域名+ /categories 若访问 404，是正常情况的。因为这些路径本不属于主题或者 Hexo 框架的一部分。而是由用户主动新建页面扩展而来。\n\n可以新建页面，比如：tags 和 categories，按以下命令格式：\n\n```bash\n hexo new page tags 和 hexo new page categories\n```\n\n\u003e 没有找到你需要的问题解决方案，建议阅读[《你不知道的提 Issues 技巧》](https://github.com/shenliyang/hexo-theme-snippet#你不知道的提Issues技巧) 再提 Issues。\n\n## 版本更新日志\n\n- 增加 Gitalk 评论系统\n- 增加博客自动化部署结果实时推送到手机钉钉上，第一时间了解部署情况\n\n自动化部署结果通知示例：\n\n![自动化部署结果通知示例](https://s2.ax1x.com/2019/03/06/kvnejs.jpg)\n\n## License\n\n[MIT License](/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshenliyang%2Fhexo-theme-snippet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshenliyang%2Fhexo-theme-snippet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshenliyang%2Fhexo-theme-snippet/lists"}