Hexo Tips

Hexo 文档， Ayer 文档， Twikoo 文档

本站使用 Hexo + Ayer + Twikoo 搭建，操作方法参考上述官方文档。

命令

command	description
hexo init <folder>	初始化
hexo clean && hexo deploy	一键部署，需要安装 hexo-deployer-git
hexo new [layout] <title>	创建新文章，默认模板使用配置中的 default_layout 参数。
hexo new page <title>	创建新页面，可以使用路由直接指向该页面。例如新建 About 页面。(hexo new page “About”)

配置

parameter	description
skip_render	跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。

笔记

1. 如何不渲染指定的 markdown 文件

   使用配置中的 skip_render 参数。

2. scaffolds 中 {{ date }} 在 Ctrl + s 后会变成 { { date } } 的问题

   原因是 Prettier - Code formatter 插件在文件保存时，自动进行了文件格式化。
   解决方法是在 .vscode 的 setting.json 中，设置：

   {
     "prettier.bracketSpacing": false
   }

   具体配置见：

   • https://github.com/prettier/prettier-vscode#configuration
   • https://prettier.io/docs/en/configuration.html

3. 如何设置在首页的文章只显示部分内容

   • 文章中使用 <!-- more --> 手动进行截断 (Hexo 推荐的方法)
   • 文章中的 front-matter 中添加 description，并提供文章摘录

其他

1. prettier 配置：

   {
     // 使能每一种语言默认格式化规则
     "[html]": {
       "editor.defaultFormatter": "esbenp.prettier-vscode"
     },
     "[css]": {
       "editor.defaultFormatter": "esbenp.prettier-vscode"
     },
     "[less]": {
       "editor.defaultFormatter": "esbenp.prettier-vscode"
     },
     "[javascript]": {
       "editor.defaultFormatter": "esbenp.prettier-vscode"
     },
   
     /*  prettier的配置 */
     "prettier.printWidth": 100, // 超过最大值换行
     "prettier.tabWidth": 4, // 缩进字节数
     "prettier.useTabs": false, // 缩进不使用tab，使用空格
     "prettier.semi": true, // 句尾添加分号
     "prettier.singleQuote": true, // 使用单引号代替双引号
     "prettier.proseWrap": "preserve", // 默认值。因为使用了一些折行敏感型的渲染器（如GitHub comment）而按照markdown文本样式进行折行
     "prettier.arrowParens": "avoid", //  (x) => {} 箭头函数参数只有一个时是否要有小括号。avoid：省略括号
     "prettier.bracketSpacing": true, // 在对象，数组括号与文字之间加空格 "{ foo: bar }"
     "prettier.disableLanguages": ["vue"], // 不格式化vue文件，vue文件的格式化单独设置
     "prettier.endOfLine": "auto", // 结尾是 \n \r \n\r auto
     "prettier.eslintIntegration": false, //不让prettier使用eslint的代码格式进行校验
     "prettier.htmlWhitespaceSensitivity": "ignore",
     "prettier.ignorePath": ".prettierignore", // 不使用prettier格式化的文件填写在项目的.prettierignore文件中
     "prettier.jsxBracketSameLine": false, // 在jsx中把'>' 单独放一行
     "prettier.jsxSingleQuote": false, // 在jsx中使用单引号代替双引号
     "prettier.parser": "babylon", // 格式化的解析器，默认是babylon
     "prettier.requireConfig": false, // Require a 'prettierconfig' to format prettier
     "prettier.stylelintIntegration": false, //不让prettier使用stylelint的代码格式进行校验
     "prettier.trailingComma": "es5", // 在对象或数组最后一个元素后面是否加逗号（在ES5中加尾逗号）
     "prettier.tslintIntegration": false // 不让prettier使用tslint的代码格式进行校验
   }