Yilia源码构建须知:基于新环境 - AnClark/hexo-theme-yilia GitHub Wiki
一、前言
Yilia诞生于2016年。几年过去,赖以构建Yilia的Node.js和Webpack早已大力度更新,当年上古版本的API不能再保证使用。一种方法是切换回旧版本的Node.js,并使用package.json记载的旧版本依赖,但是这不能保证运行——首先node-sass就没办法编译;更重要的是,在前端技术持续进步的当下,停留旧版本终究不可取,你总要适配最新的技术。
因此,我将原作者repo中的依赖进行了升级,适配上截至目前(2021年9月)最新的Node.js LTS与Webpack。
原版构建须知在此,除了介绍构建过程,还介绍子目录的结构,以及定制时的注意事项。
二、安装前准备
我基于Node LTS(v14.17.6)进行构建,从Node.js官方网站,或者是你的包管理器(如果是Linux发行版)下载。然后运行以下命令准备Yilia构建。
# 克隆源码到任意位置,建议放在你博客的themes/目录下
git clone git://github.com/anclark/hexo-theme-yilia.git yilia
# 安装Webpack CLI
npm install -g webpack-cli
# 安装Yilia的依赖
cd yilia
npm install
三、开始构建
1. 开发
执行:
npm run dev
此时会用webpack打包,把文件编译到source文件里,但文件不会经过压缩。
2. 发布
执行:
npm run dist
生成最终用于发布的版本,此时的编译会经过压缩。
3. 测试
也可以不带参数运行webpack,直接开始构建过程。效果与npm run dev相同,用于测试。