项目名称
Halo
项目介绍
Halo [ˈheɪloʊ],意为光环。Halo 是一款现代化的个人独立博客系统,给习惯写博客的同学多一个选择。当然,你也可以当成拼音读(哈喽)。
项目来源: Github/Gitee
本文内容
由于习惯使用Maven构建项目,但Halo是基于Gradle 构建的,所以打算小小改动一下,两种方式都能构建,没有太多差别,本文主要讲Maven构建Halo CMS系统。
- 第一步,把代码克隆下来,先放桌面
git clone https://gitee.com/halo-dev/halo.git
- 创建新的SpringBoot项目
Java 版本为 11
- 预选一下要用到的依赖
- 打开pom.xml 对照这克隆下来的项目里面的buIld.gradle, 挨个添加依赖
默认是打包jar,有内置的Tomcat,所以暂时不加 Jetty
pom.xml 追加内容
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>31.1-jre</version>
</dependency>
<dependency>
<groupId>com.upyun</groupId>
<artifactId>java-sdk</artifactId>
<version>4.2.3</version>
</dependency>
<dependency>
<groupId>com.qiniu</groupId>
<artifactId>qiniu-java-sdk</artifactId>
<version>7.10.2</version>
</dependency>
<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>3.15.0</version>
</dependency>
<dependency>
<groupId>com.baidubce</groupId>
<artifactId>bce-java-sdk</artifactId>
<version>0.10.209</version>
</dependency>
<dependency>
<groupId>com.qcloud</groupId>
<artifactId>cos_api</artifactId>
<version>5.6.80</version>
</dependency>
<dependency>
<groupId>com.huaweicloud</groupId>
<artifactId>esdk-obs-java</artifactId>
<version>3.22.3.1</version>
</dependency>
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.4.1</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-starter</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-yaml</artifactId>
</dependency>
<dependency>
<groupId>org.eclipse.jgit</groupId>
<artifactId>org.eclipse.jgit</artifactId>
<version>6.1.0.202203080745-r</version>
</dependency>
<dependency>
<groupId>com.google.code.findbugs</groupId>
<artifactId>annotations</artifactId>
<version>3.0.1u2</version>
</dependency>
<dependency>
<groupId>com.vladsch.flexmark</groupId>
<artifactId>flexmark-all</artifactId>
<version>0.64.0</version>
</dependency>
<dependency>
<groupId>kr.pe.kwonnam.freemarker</groupId>
<artifactId>freemarker-template-inheritance</artifactId>
<version>0.4.RELEASE</version>
</dependency>
<dependency>
<groupId>net.coobird</groupId>
<artifactId>thumbnailator</artifactId>
<version>0.4.17</version>
</dependency>
<dependency>
<groupId>image4j.sf.net</groupId>
<artifactId>image4j</artifactId>
<version>0.7</version>
</dependency>
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
<version>8.5.11</version>
</dependency>
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>3.5.0</version>
</dependency>
<dependency>
<groupId>io.github.java-diff-utils</groupId>
<artifactId>java-diff-utils</artifactId>
<version>4.11</version>
</dependency>
<dependency>
<groupId>org.iq80.leveldb</groupId>
<artifactId>leveldb</artifactId>
<version>0.12</version>
</dependency>
该依赖无法下载
<dependency>
<groupId>image4j.sf.net</groupId>
<artifactId>image4j</artifactId>
<version>0.7</version>
</dependency>
需要添加仓库
<repositories>
<repository>
<id>soffid.maven</id>
<url>http://download.soffid.com/maven</url>
</repository>
</repositories>
由于JDK11没有tools.jar 包,所以jdk.tools:1.6 报错。本项目暂不需要使用该依赖,故把jdk.tools 排除掉。
修改pom.xml 内容,将jdk.tools 排除
<dependency>
<groupId>com.baidubce</groupId>
<artifactId>bce-java-sdk</artifactId>
<version>0.10.209</version>
<exclusions>
<exclusion>
<groupId>jdk.tools</groupId>
<artifactId>jdk.tools</artifactId>
</exclusion>
</exclusions>
</dependency>
- 把克隆的代码复制到SpringBoot项目中 , 主要是java ,resources 里面的内容,直接粘贴到项目中即可,然后我们需要先下载一个默认halo主题。
git clone https://gitee.com/halo-dev/halo-theme-anatole.git
克隆下载完成,把目录名称改为anatole即可。
- 直接运行SpringBoot程序
命令太长,点击下方的Shorten the command line and rerun
修改 sql
把 modify 全部替换成 alter column
然后再次启动SpringBoot 项目,即可运行成功
项目启动后,会在用户主目录下创建.halo 文件夹,将主题复制到 templates/themes 下,数据库的路径为 ~/.halo/db/halo。
- 搭建CMS
打开链接 127.0.0.1:8090 , 开始填写表单。
导入其他的主题,打开官方主题网站 https://halo.run/themes.html
Git克隆下载完成
启用该主题后的效果
如果无法查看评论内容,删除注释符号,然后保存文件。
刷新页面,评论就出来了
后台评论管理页面
- 如果你需要重新建站,请删除用户目录下的 .halo 文件夹, 当然下载的主题也会被删除,记得备份,另外还得删除缓存。 再次运行SpringBoot,即可重新进入到建站页面。
- 还有些小问题,一并解决
排除slf4j-reload4j
设置JPA方言
log4j.properties 配置
log4j.rootLogger = debug,stdout,D,E
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = ./logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =./logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
打包成jar
打包的时候,我又把Tomcat排除了,还是选择用Jetty 算了
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jetty</artifactId>
</dependency>
- 将jar包整合成exe安装程序
当你不关闭程序,而再次运行程序时,bat脚本会将前一个运行程序已经taskkill 掉,而且,只会kill掉已存在的名称为 halo-java.exe 的程序。
打印 Halo has started successful代表启动成功
访问路径
前端 http://localhost:8090
后端 http://localhost:8090/admin
数据库访问
安装h2数据库
上面 这个AVATAR属性可以改成QQ头像链接:http://q1.qlogo.cn/g?b=qq&nk=2371778707&s=640
好了,本文到此结束。
代码,jar,安装程序exe
下载地址:
安装包200多MB太大,原因就是里面包含了太多无用的Jar包,还加入了JDK11,先就这样吧。