halo开源博客项目配置

谁践踏了优雅 2023-02-22 07:44 74阅读 0赞

## Halo开源博客项目配置 ##

### README ###

#### 简介 ####

**Halo** `[ˈheɪloʊ]`，意为光环。Halo 是一款现代化的个人独立博客系统，给习惯写博客的同学多一个选择。当然，你也可以当成拼音读(哈喽)。

#### 声明 ####

> 本项目旨在创造一个好的产品以供人们使用（虽然现在并不是太好），并非一个所谓提供学习的项目。所以，不提供任何学习代码的帮助。也请不要在讨论群，issues，论坛发起任何有关代码学习的问题。当然，如果你是要参与代码贡献，我们非常欢迎。

另外，写给想自己拉代码编译运行的同学：

> 目前我们的开发分支即 master，肯定会有很多小问题，不要运行不起来就跑过来吐槽什么代码开源不完整之类的，多找找自己的原因。同时建议下载最新 release 版本的代码，或者在 master 分支执行 `git checkout v1.3.2`。

PS：实在不想写这个声明（影响 README 的美观），但是就目前来看，写在 README 上是有必要的，因为大部分遇到问题的人都不会去仔细阅读文档。

#### 快速开始 ####

##### 下载最新的 Halo 安装包 #####

> 其他地址：https://halo.run/archives/download.html

curl -L https://github.com/halo-dev/halo/releases/download/v1.3.2/halo-1.3.2.jar --output halo-latest.jar

或者

wget https://github.com/halo-dev/halo/releases/download/v1.3.2/halo-1.3.2.jar -O halo-latest.jar

##### 启动 Halo #####

java -jar halo-latest.jar

详细部署文档请移步：[https://halo.run/archives/install-quick-start.html][https_halo.run_archives_install-quick-start.html]

##### 博客示例 #####

请移步： [https://halo.run/p/user-wall.html][https_halo.run_p_user-wall.html]。

#### 周边 ####

*  后台管理（halo-admin）：[https://github.com/halo-dev/halo-admin][https_github.com_halo-dev_halo-admin]
 *  独立评论模块（halo-comment）：[https://github.com/halo-dev/halo-comment][https_github.com_halo-dev_halo-comment]
 *  管理 APP（已停止维护）：[https://github.com/halo-dev/halo-app][https_github.com_halo-dev_halo-app]
 *  主题仓库：[https://halo.run/p/themes.html][https_halo.run_p_themes.html]
 *  资源下载：[https://dl.halo.run][https_dl.halo.run]
 *  WeHalo 小程序：[https://github.com/aquanlerou/WeHalo][https_github.com_aquanlerou_WeHalo]

--------------------

**启动项目前配置**

项目为gradle项目，项目依赖文档配置在build.gradle,开始前确保能自动导入依赖，导入需要花费一些时间。之后可以进行具体的配置，如数据库的配置，找到文件application.yaml文件。  
![项目结构][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center]

将h2数据库的enabled和web-allow-others改为**true**  
![数据库配置][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 1]

差不多就可以启动整个项目了，怎么启动呢？之前已经有经验了吧，介绍了一个eladmin后台管理系统的项目，难度或者复杂度比这个大一点，其中就讲了具体的项目的启动配置。找到项目中唯一能运行的源代码文件，一般在源代码文档src/main/java里面，找到它，命名一般是AppRun或ApplicationRun或者Application的Java文件，打开能看到有main()函数的，就是项目启动文件。IDEA会自动找到可运行的启动文件，并打开绿色小三角按钮，点击小三角启动它！  
![小三角启动][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 2]  
可以看到左下角项目在编译运行。  
![启动标志][20200702103054697.PNG_pic_center]  
启动后没有乱码和红色报错，说明配置对了。  
![启动成功][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 3]  
![启动成功][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 4]

如果出现乱码的情况，说明编译的时候没有配置好，而编码需要的是UTF-8，找到项目的依赖配置文件build.gradle,添加如下配置。

tasks.withType(JavaCompile) {
    	options.encoding = 'UTF-8'
    }

如果出现红色报错，说明有其他配置问题，很大原因是导入依赖不成功，受到了网速影响，需要重新导入模块。还有问题请加群交流，这里不做详细的解释！

#### 预览图 ####

![install.png][]  
这个halo博客后台支持markdown语法的编辑，对写博客非常友好！

![admin-post-edit.png][]

--------------------

#### 总结 ####

对比其他博客框架，halo博客是一个动态的博客系统，有前端，有后台，可以自己买个服务器搭一搭。而其他的开源博客，有一部分是没有后台的，修改上传文章主要在线下完成，所以维护起来十分费劲。如果可以的话还可以动手改halo的样式，halo也有其他主题样式供选择。OK，以上就是简单的玩一玩开源项目，具体大家可自行研究，有问题或探讨可以关注我公众号加群！

[个人网站][Link 1]

[https_halo.run_archives_install-quick-start.html]: https://halo.run/archives/install-quick-start.html
[https_halo.run_p_user-wall.html]: https://halo.run/p/user-wall.html
[https_github.com_halo-dev_halo-admin]: https://github.com/halo-dev/halo-admin
[https_github.com_halo-dev_halo-comment]: https://github.com/halo-dev/halo-comment
[https_github.com_halo-dev_halo-app]: https://github.com/halo-dev/halo-app
[https_halo.run_p_themes.html]: https://halo.run/p/themes.html
[https_dl.halo.run]: https://dl.halo.run
[https_github.com_aquanlerou_WeHalo]: https://github.com/aquanlerou/WeHalo
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20200702102932816.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20200702103019124.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20200702103304505.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu,size_16,color_FFFFFF,t_70#pic_center
[20200702103054697.PNG_pic_center]: https://img-blog.csdnimg.cn/20200702103054697.PNG#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20200702103122874.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20200702103132613.PNG?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0dvYnVsbGlu,size_16,color_FFFFFF,t_70#pic_center
[install.png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pLmxvbGkubmV0LzIwMTkvMDkvMTEvSXUxZU16WkRnNmZydzk3LnBuZw?x-oss-process=image/format,png
[admin-post-edit.png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pLmxvbGkubmV0LzIwMTkvMDkvMTEvdWNEaDJ0T1pMSkdUeUhYLnBuZw?x-oss-process=image/format,png
[Link 1]: https://maliaoblog.cn