Skip to content

denisbakhtin/ginblog

Repository files navigation

GIN-powered blog boilerplate

This is a skeleton project that provides essentials most web blogs need - MVC pattern, user authorisation, orm, admin dashboard, javascript form validation, rss feeds, etc.

You can check out GinShop for a more modern e-shop bundle.

It consists of the following core components:

Screenshots

Home page

Blog post

Dashboard

Ckeditor 5 WYSIWYG editor

Custom 404, 405, 500 error pages

Recent updates

Removed node.js dependency, jquery, replaced select2 with a lightweight Tom Select, updated CKEditor5, Bootstrap 5 with icons, etc..

Usage

git clone https://github.com/denisbakhtin/ginblog.git
cd ginblog
go get .

Copy sample config cp config/config.json.example config/config.json, create postgresql database, modify config/config.json accordingly.

Type go run main.go to launch web server.

Deployment

make build

Upload ginblog binary config, views and public directory to your server.

Project structure

/config

Contains application configuration file & go wrapper.

/controllers

MVC controllers

/models

Database models.

/public

All web-site static files

/views

Web-site views.

main.go

Main file that starts the application, initializes subsystems and web routes

Make it your own

I assume you have followed installation instructions and you have ginblog installed in your GOPATH location.

Let's say you want to create Amazing Website. Add a new GitHub repository https://github.com/denisbakhtin/amazingblog (of course replace that with your own repo).

Prepare ginblog: delete its .git directory.

Issue:

rm -rf src/github.com/denisbakhtin/ginblog/.git

Replace all references of github.com/denisbakhtin/ginblog with github.com/denisbakhtin/amazingblog:

grep -rl 'github.com/denisbakhtin/ginblog' ./ | xargs sed -i 's/github.com\/denisbakhtin\/ginblog/github.com\/denisbakhtin\/amazingblog/g'

Move all files to the new location:

mv src/github.com/denisbakhtin/ginblog/ src/github.com/denisbakhtin/amazingblog

And push it to the corresponding repo:

cd src/github.com/denisbakhtin/amazingblog
git init
git add --all .
git commit -m "Amazing Blog First Commit"
git remote add origin https://github.com/denisbakhtin/amazingblog.git
git push -u origin master

You can now go back to your GOPATH and check if everything is ok:

go install github.com/denisbakhtin/amazingblog

And that's it.

Continuous Development

For Continuous Development a good option is to install fresh - https://github.com/pilu/fresh Then simply run fresh in the project directory.