https://github.com/gbbr/gopherblog
A blog about Go, written in Go.
https://github.com/gbbr/gopherblog
Last synced: about 1 month ago
JSON representation
A blog about Go, written in Go.
- Host: GitHub
- URL: https://github.com/gbbr/gopherblog
- Owner: gbbr
- License: bsd-2-clause
- Created: 2014-07-31T22:40:57.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2015-10-16T00:29:05.000Z (over 9 years ago)
- Last Synced: 2025-02-11T23:57:58.616Z (3 months ago)
- Language: Go
- Homepage: www.gopherblog.org
- Size: 853 KB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
_My first ever Go project_
# gopherblog [](https://travis-ci.org/gbbr/gopherblog) 
A blog about Go, written in Go. Located at www.gopherblog.org
### TL;DR
```
# Fetch code and install binary
go get github.com/gbbr/gopherblog/...
go install github.com/gbbr/gopherblog/...
# Set up database and admin user
./install.sh
bower install
# Run HTTP server on localhost:8080
gopherblog -db="user[:pass]@tcp(host:port)/gopherblog"
```
### Requirements
The system assumes that you have successfully installed the following requirements:
* A running version of [MySQL](http://dev.mysql.com/doc/refman/5.1/en/installing.html)
* The [Go](https://golang.org/doc/install) language installed, with correct environment variables (GOPATH, GOROOT, etc)
After all of the above are installed, do `go get github.com/gbbr/gopherblog/...` to install the blog and its dependencies.
### Setting up the database
To set up the database you need to run the following command:
`chmod +x install.sh; ./install.sh`
Follow the on-screen instructions and enter your database host and credentials. The second section will ask you to create the Admin credentials and Display Name which you will use to create posts on the blog. The Display Name that you enter here will be displayed on your posts' pages.
### Running the blog
First we must compile the main package and all its dependencies into a binary. To do this we run (in the gopherblog directory):
`go install`
This should create the binary called `gopherblog` in your $GOPATH/bin folder. On my machine, for example, I naively run the blog as:
`gopherblog -db="root:root@tcp(localhost:3306)/gopherblog"`
The following command-line flags are provided:
| Flag | Default Value | Description |
| ------------- |:------------------------------------------|:------------------------------------------------|
|-db= | root@tcp(localhost:3306)/gopherblog | Database connection string. |
|-host= | localhost | Hostname that the server runs on |
|-port= | 8080 | Port to listen on for HTTP connections |
|nocache | | Setting this flag will recompile the HTML templates on every request |
### Navigating
| Route | Description |
| ------------- |:------------------------------------------------|
| / | Home page of the blog, displays a list of posts |
| /tag/:name | Filter posts by tag name |
| /post/:slug| Displays a post with the given slug |
| /login | Displays login page |
| /manage | Manage your posts (requires authentication) |
| /edit/:id | Edit a post with the given ID |