SpringBlog is a very simple and clean-design blog system implemented with Spring Boot. I had put it on production for my personal bvn13's blog since 2017-11-03.
SpringBlog is powered by many powerful frameworks and third-party projects:
- Spring Boot and many of Spring familiy (e.g. Spring MVC, Spring JPA, Spring Secruity and etc)
- Hibernate + PostgreSQL
- HikariCP - A solid high-performance JDBC connection pool
- Bootstrap - A very popular and responsive front-end framework
- Pegdown -
A pure-java markdown processor(deprecated) - ACE Editor - A high performance code editor which I use to write posts and code.
- Pygments -
A python library for highlighting code syntax(deprecated) - Flexmark - Java implementation of CommonMark 0.28 spec parser using the blocks first, inlines after Markdown parsing architecture
- Jade4j - Jade is an elegant template language.
- Webjars - A client-side web libraries packaged into JAR files. A easy way to manage JavaScript and CSS vendors in Gradle.
- Redis - A very powerful in-memory data cache server.
- github-markdown-css - markdown syntax highlighter
- Implemented files uploads/downloads
- Added sharing buttons via sharethis.com - register and change verification code to use it
- Removed deprecated Jython, Pygments and Pegdown. Replaced with Flexmark and github-markdown-css
- Added 'admin' button on the home page if admin is logged in
- Added SEO meta-tags:
- list of keywords
- description
- Updated html > head > title for posts pages
- Was forked from SpringBlog by Raysmon
- Was migrated onto SpringBoot 1.5.8, all libraries was updated
Before development, please install the following service software:
Edit the spring config profile src/main/resources/application.yml
according to your settings.
And start MySQL and Redis first before running the application.
# If you're using Ubuntu server
# Install MySQL
apt-get install mysql-server
service mysql start
mysql -u root -p
>> create database spring_blog;
# Install Python pygments
apt-get install python-pip
pip install pygments
# If you want to enable redis cache
# Install redis server first, you can find instructions
# from https://www.digitalocean.com/community/tutorials/how-to-install-and-use-redis
service redis_6379 start
This is a Gradle project. Make sure Gradle is installed in your machine.
Try gradle -v
command. Otherwise install in from http://www.gradle.org/.
I recommend you import the source code into Intellij IDE to edit the code.
# Start the web application
./gradlew bootRun
How to import the project into Intellij IDEA and run from the IDE?
- Clone the project
git clone https://github.com/Raysmond/SpringBlog.git
- Download all dependencies
cd SpringBlog
./gradlew idea
- Open the project in Intellij IDEA.
- Run
Application.java
as Java application. - Preview: http://localhost:8001 Admin: http://localhost:8001/admin , the default admin account is: admin@admin.com, password: admin
Lombok is required to run the project. You can install the plugin in Intellij IDEA. Reference: https://github.com/mplushnikov/lombok-intellij-plugin
-
Build application jar
./gradlew build
, then upload the distribution jar (e.g.build/libs/SpringBlog-0.1.jar
) to your remote server. -
Upload
application-production.yml
to your server and change it according to your server settings. -
Run it (Java8 is a must)
# assuming you have the jar and yml files under current dir java -jar SpringBlog-0.1.jar --spring.config.location=application-production.yml
Modified BSD license. Copyright (c) 2015, Jiankun LEI (Raysmond).