Hexo-themes-butterfly主题的安装及配置 官方配置教程：Butterfly 安裝文檔(一) 快速開始 安装 进入Hexo博客根目录 下载主题 git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly 启用主题，将根目录_config.yml文件主题部分设置为butterfly theme: butterfly 安装插件 npm install hexo-renderer-pug hexo-renderer-stylus --save 将themes/butterfly/_config.yml文件复制到在Hexo博客根目录并改名为_config.butterfly.yml cp themes/butterfly/_config.yml _config.butterfly.yml 配置 详情参考官方教程，需要注意有些功能要安装额外的插件。 Math数学 启用KaTex时，需要卸载和安装以下插件 npm un hexo-renderer-marked --save # 如果有安裝這個的話，卸載 npm un hexo-renderer-kramed --save # 如果有安裝這個的話，卸載 npm i hexo-renderer-markdown-it --save # 需要安裝這個渲染插件 npm install katex @renbaoshuo/markdown-it-katex #需要安裝這個katex插件 在Hexo根目录的_config.yml中配置如下信息 markdown: plugins: - '@renbaoshuo/markdown-it-katex' 字数统计 进入Hexo根目录，安装以下插件 npm install hexo-wordcount --save 修改主题配置文件 wordcount: enable: true post_wordcount: true min2read: true total_wordcount: true

使用Hexo搭建博客 1 准备阶段 安装node.js 下载地址：https://nodejs.org/en 查看版本：node -v以及npm -v 国内安装cnpm，使用淘宝镜像 npm install -g cnpm --registry=http://registry.npm.taobao.org 安装hexo框架 cnpm install -g hexo-cli 2 初始化博客并测试 打开终端，在当前文件夹新建myblogs文件夹用于存储博客所有相关内容 mkdir myblogs 进入myblogs文件夹，之后所有的操作都在该文件下进行 cd myblogs 初始化博客 hexo init 生成博客静态网页文件 hexo g 启动本地博客进行测试，启动后本地访问地址http://localhost:4000/，使用Ctrl+C终止 hexo s 3 新建博客文档 新建博客文档，将"blog name"替换为需要的博客名称 hexo n "blog name" 在source/_posts文件夹下出现以"blog name"命名的.md文件，使用Vim等修改博客内容，博客使用Markdown语法书写 重新生成静态网页文件 hexo g 4 更换主题 可在主题界面挑选喜欢的主题类型，所有主题更换方式类似，此处以yilia主题为例。首先下载主题 git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia 修改_config.yml文件中theme内容为yilia，默认内容为landscape 变更主题后，生成博客前需要先清除缓存 hexo clean 重新生成 hexo g 5 部署至GitHub 5.1 安装插件 在myblogs文件夹安装git部署插件 cnpm install --save hexo-deployer-git 5.2 添加SSH密钥 生成SSH密钥，其中"your_email@example.com"为你的GitHub账号电子邮件地址 ssh-keygen -t rsa -b 4096 -C "your_email@example.com" 复制刚生成的.ssh/id_rsa.pub文件中的所用内容，进入GitHub设置界面->SSH and GPG keys -> New SSH key，将复制的内容粘贴进去，Title任意 输入下面第一行代码，若提示第二行的内容，则表示配置成功 ssh -T git@github.com Hi YourGitHubName! You've successfully authenticated, but GitHub does not provide shell access. 5.3 配置部署信息 在GitHub创建一个仓库名为"YourGitHubName.github.io"，其中YourGitHubName为GitHub的账号名 配置_config.yml文件，该文件在当前文件夹下，将Deployment内容修改成如下形式，注意将YourGitHubName替换为GitHub的账号名 # Deployment ## Docs: https://hexo.io/docs/one-command-deployment deploy: type: git repo: git@github.com:YourGitHubName/YourGitHubName.github.io.git branch: master 将博客部署至GitHub仓库 hexo d 5.4 添加域名 前往阿里云等网站注册一个域名，如xxx.cn 修改_config.yml文件中url内容为https://xxx.cn 在source/文件夹下创建没有后缀的CNAME文件，写入xxx.cn 前往GitHub仓库，找到Settings -> Pages -> Custom domain，填入xxx.cn 前往域名注册网站，进入域名控制台，选择刚购买的域名，点击解析进入解析界面，增加两条如下 点击添加记录，记录类型选择CNAME，记录值填写YourGitHubName.github.io.git，点击确认 点击添加记录，记录类型选择CNAME，主机记录填写www，记录值填写YourGitHubName.github.io.git，点击确认 至此，域名添加完成

程序编写规范（自用） 在日常的学习工作中，经常需要编写程序辅助计算或者画图，为了能让程序更加美观且可读性更强，按照平时的编程习惯，制作了满足自身需求的编写规范。 作为非计算机专业及行业的人，我常用的编程语言为Matlab、Python和Fortran。 1 基本规范 编程过程中，我尽量满足以下规范条件： 文件夹结构 src 源代码存放目录 img 生成的图片存放目录 dat 运行过程中依赖的数据文件，主要为一些系数或者参数存放位置，应该为固定不变的文件 data 需要处理的数据，作为程序的输入，如仪器观测过程中不断生成的数据。一般为了节约本地空间，我会把需要处理的数据都放到移动硬盘里面，只有在测试过程中，会选择几个数据放进来以便测试 doc 编写过程中涉及到的文档存放目录，如编程大纲、计算公式、程序设计等 refs 存放编写过程中用到的参考文献，如期刊论文等。与doc的区别在于本文件夹下的文档是前人已经发表的论文 old 可正常运行的旧版本备份目录，子文件夹以年月日命名，如old/20221103，子文件夹下应该备份有所有的相关文件。本文件夹存在原因是，可能某个版本的代码编写完成后，后续又需要进行大规模的改动，为避免以后找不到改动前的代码，所以需要本文件夹进行备份 dist 存放打包好的可执行文件 参数定义及传递 主函数的参数输入，确保每个参数只有一个物理意义 子函数之间尽可能减少传递参数的个数，对参数进行分类传递 尽量减少无效参数的传递，保证传递的每个参数都有其价值 尽量减少使用次数很少的中间量的定义 命名规则 过短字符的名称不考虑简写，使用的简写尽量是约定俗成的 定义具有确定含义的函数中间名 定义具有确定含义的变量前缀，以方便对函数内部的变量进行管理。只有同一类的变量比较多时，为了避免和其他变量发生冲突，才需要定义前缀 命名规则可根据个人习惯自行定义，我的定义习惯后续会详细介绍 2 基本框架 在定义函数（或子例程）时，我会习惯在函数名定义之前加上一段描述信息，此处以Python为例，如下所示 ''' coding: utf-8 INFO: 测试 date: 2022-11-03 Washy [institutions e-mail] func: test01 - 这是一个测试函数 ''' ##----------------------------------------------------------------------## # INFO: 这是一个测试函数 ##----------------------------------------------------------------------## # Needs: test02.m ##----------------------------------------------------------------------## # Inputs: # a - 含义 [单位] # Outputs: # b - 含义 [单位] ##----------------------------------------------------------------------## #参考文献 # [1] Kudeki, E., & Milla, M. A. (2011). Incoherent Scatter Spectral # Theories-Part I: A General Framework and Results for Small Magnetic # Aspect Angles. Ieee Transactions on Geoscience and Remote Sensing, # 49(1), 315-328. doi:10.1109/Tgrs.2010.2057252 ##----------------------------------------------------------------------## # author: Washy [institutions e-mail] # date: 2022/11/03 ##----------------------------------------------------------------------## #更新内容[Washy 2022/11/03] ##INFO: 描述信息 # 1. 更新一 # 2. 更新二 ##----------------------------------------------------------------------## # 可改进的地方: 详细内容 ##----------------------------------------------------------------------## #输入测试示例[Washy 2022/11/03] #Inputs: # a = 10 #Outputs: # b = 10 ##----------------------------------------------------------------------## def test01(a): b = a #[1] eq(1) return b ##----------------------------------------------------------------------## if __name__ == "__main__": a = 10 b = test01(a,b) print('{} = {}'.format(a,b)) 基本框架中从上至下的含义如下： 文件头部分 INFO 对整个程序的功能进行概述行描述 date 本程序文件创建日期及作者，中括号里面为单位名称缩写和作者的联系邮箱地址 func 本程序文件所包含的函数及其描述 函数定义前部分 INFO 函数功能描述（必要） Needs 被定义函数依赖的其他自定义函数（非必要） Inputs 函数输入变量（必要） 变量名 - 变量描述，变量如果是物理量，中括号内说明量纲 Outputs 函数输出变量（必要） 变量名 - 变量描述，变量如果是物理量，中括号内说明量纲 参考文献 函数引用的参考文献，需要编号（非必要） author 作者名，中括号里面为单位名称缩写和作者的联系邮箱地址（必要） date 函数创建及修改日期（必要） 更新内容 函数发生重大版本更新时添加本部分（非必要） 可改进的地方 函数还存在的改进点，受限于时间、精力等因素，编写软件时可能没有把完全优化（非必要） 输入测试示例 函数调用示例，描述清楚输入及对应的输出结果（非必要） 函数定义部分 参考文献引用 如果引用了参考文献中的某个公式，在该行代码后加上参考文献编号及文献内公式编号 每一行的内容，都尽量不要超过虚线的长度，虚线的长度来自Matlab编程窗口分割线的宽度。 使用其他编程语言时，只需批量替换注释符号即可。 3 命名规则 命名包含文件命名、函数命名和变量命名。命名时，我习惯使用一些关键词来增加可读性，我常用的关键词如下 前缀 名称 含义 名称 含义 re 重处理 set 设置 get 获取 init 初始化 save 保存 download 下载 示例 rename 重命名函数 set_date 日期设置函数 get_data 数据获取函数 init_paras 初始化参量 save_img 保存图片 download_data 下载数据 文件、文件夹相关 名称 含义 名称 含义 root 根目录 fold 文件夹 file 文件 name 名称 path 路径 示例 rootpath 根目录 foldpath 文件夹路径 filename 文件名 filepath 文件路径，通常由foldpath和filename拼接而成 后缀 名称 含义 名称 含义 date 日期 str 字符串 data 数据 main 主函数 其他: 根据实际问题，以实际处理中遇到的参量名进行定义。