# Sitio 文件目录及文件说明

提示

  • Sitio 文件目录及文件说明,方便自定义组件开发使用。
  • 不提供 node_modules 文件目说明。

# 项目整体文件目录说明

├─.github ------------------------------------------ GitHub 项目托管环境配置
│  └─ISSUE_TEMPLATE -------------------------------- GitHub issue/错误模板
├─includes ----------------------------------------- hexo 插件文件,
│  ├─helpers --------------------------------------- hexo 自定义文章,标签插件
│  └─tasks ----------------------------------------- hexo 初始运行检查
├─languages ---------------------------------------- 语言,设置你项目所使用的语言
├─layout ------------------------------------------- 布局文件夹。用于存放主题的模板文件
│  ├─_partial -------------------------------------- 部分的(顶部、底部、内容)等多个布局组件在该文件夹
│  ├─_widget --------------------------------------- 小部件
│  │   ├─_footer ----------------------------------- 底部
│  │   ├─_head ------------------------------------- head (meta、link、script等)引入
│  │   ├─_link ------------------------------------- link (css)
│  │   └─_script ----------------------------------- 脚本文件(全局变量)
│  └─plugin ---------------------------------------- 插件(音乐、看板娘等)
├─scripts ------------------------------------------ 脚本文件夹,在启动时 Hexo 会载入此文件夹内的 JavaScript 文件
├─source ------------------------------------------- 资源文件夹,包含(样式,第三方插件,字体,图片等)
│  ├─css ------------------------------------------- 样式文件夹,包含该主题所有 css 样式
│  │  ├─_base -------------------------------------- 初始文件夹(css初始化、动画、方法等)
│  │  ├─_custom ------------------------------------ 自定义样式
│  │  └─_variables --------------------------------- css 的全局变量
│  ├─font ------------------------------------------ 字体,网站的字体样式
│  ├─icon ------------------------------------------ 图片,网站的 icon 图片
│  │  └─chrome-pwa-icon ---------------------------- Google Chrome 浏览器的 pwa 图片
│  └─js -------------------------------------------- 打包后的 js 文件夹(源文件在 src 下)
├─src ---------------------------------------------- 该主题所使用到的 JavaScript 脚本。(项目中的轮播图,菜单等等)
└─test --------------------------------------------- 项目测试,仅供开发人员使用

# 根目录文件说明

├─.editorconfig  ----------------------------------- 遵循编码规范(编码风格) (VScode安装 EditorConfig)
├─.gitignore --------------------------------------- git (文件忽略,不向GitHub提交某个文件或文件夹)
├─.jshintrc ---------------------------------------- JSHint 配置方式
├─.stylintrc --------------------------------------- css(styl) 配置
├─.travis.yml -------------------------------------- CI 配置
├─deploy.sh ---------------------------------------- 本项目脚本配置,自动化流程(提交,下载,更新)等
├─LICENSE ------------------------------------------ 开源协议
├─README.md ---------------------------------------- 简述文件中文
├─README_EN.md ------------------------------------- 简述文件英文
├─package-lock.json -------------------------------- 生成的系统当前安装的库的具体来源和版本号,锁定版本
├─_config.yml -------------------------------------- 主题的配置文件,主题配置文件修改时会自动更新
├─package.json ------------------------------------- 自动下载所需要的模块,配置项目所需的运行和开发环境
└─webpack.config.js -------------------------------- 打包 src 文件夹下的所有 js,生成新的 js 文件会自动放到(source/js)文价夹下