Halo open source project learning (I): project launch

High quality resource sharing

Catalog

Project brief introduction Project Download Premise setting Start project

Project brief introduction

Halo Is an excellent open source blog publishing application , stay GitHub Well received in Shanghai , I happen to be practicing blogging recently , Take this to record your study Halo The process of .

Project Download

from GitHub Pull up Project source code ,Halo from 1.4.3 Start , Minimum supported JRE Version is 11, What I download is 1.4.13 edition .

Premise setting

Import the project

because Halo Use Gradle structure , So in idea Import Gradle project , And Maven Different ,Gradle The project depends on build.gradle Add .

Halo The following dependencies are mainly used in ：

• Spring Boot： One to simplify Spring A new framework for the construction and development process of ;
• Spring Data JPA： Persistence layer frame ;
• Spring Web： structure Web application ;
• Undertow： High performance Web Containers ;
• Freemarker： template engine ;
• H2 Database： embedded database , No installation required ;
• MySQL： Relational database ;
• Lombok：Java Efficient development tools ;
• Swagger： Generate interface document ;
• Hutool： Open source Java Tool class ;
• Qiniuyun ： Cloud storage server ;
• Alibaba cloud OSS： For amounts 、 Security 、 Low cost 、 Highly reliable cloud storage services ;
• Flexmark： take Markdown Turn into HTML.

ieda Set up

Halo It uses JDK 11, So we need to idea Medium JDK The version is set to JDK 11. In turn, click File -> Project Structure -> Project SDK Set up JDK.

Gradle It also needs to be set to JDK 11, In turn, click File -> Settings -> Search for Gradle Set up JDK.

Start project

matters needing attention

Please make the following preparations before starting the project ：

1. Make sure JDK The version of meets the requirements , This article USES the JDK 11;
2. Ensure that all dependencies are imported properly （ No exception occurred in this practice ）;
3. Make sure resources/templates/themes Directory is not empty , Under normal circumstances, there should be anatole Folder . Is empty because of the use of Git When cloning, there is no clone sub module , Can be in Halo Theme warehouse on the official website download Anatole The theme , Unzip and rename to anatole, And copy it to themes Under the table of contents ;
4. Halo By default H2 Database, The database does not need to be installed , So you can start the project directly . If you want to use MySQL, You need to in application.yaml Note out in the document H2 Database Configuration of , And add MySQL Related configuration of （ The database name is ‘halodb’）：

# MySQL  To configure 
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
username: root
password: 123456

Run the project

Click on the run , Normal project start , The console prints the following information ：

The above information prompts us to visit 127.0.0.1:8090, When you first visit this page , The page will be redirected to the initialization page , Users need to set up bloggers 、 Blog related information , Such as user name 、 Password etc. .

After filling in the information , Click on the install , Then the page will jump to the login page , At this time, the user can log in with the previously set account and password . Log in successfully and enter ‘Halo Dashboard’ page , And the system will automatically create an article ‘Hello Halo!’.‘Halo Dashboard’ The page is the background management page of the blog , For administrator , visit 127.0.0.1:8090/admin You will enter this page （ Login required ）.

The home page of the blog can be accessed 127.0.0.1:8090, You can see all the articles published by the blogger on this page .

thus ,Halo The project in idea Successfully started on ！

author ：John classmate Any reprint is welcome , But be sure to indicate the source . If there is anything wrong with the article and code , Welcome criticism and correction ！