Skip to content

Commit

Permalink
Merge pull request #9 from gernest/dev
Browse files Browse the repository at this point in the history
Added documentation.
  • Loading branch information
gernest committed Jun 11, 2015
2 parents 247c69c + d02e535 commit 46821e8
Show file tree
Hide file tree
Showing 6 changed files with 78 additions and 25 deletions.
35 changes: 14 additions & 21 deletions README.md
Expand Up @@ -8,27 +8,20 @@ This is not for production use, I started this project as a way to learn more ab
programming language, and also to experiment with testing web services in Go.

## Guide
1. Getting started
- Overview
- features
- Installation
2. Routes
- Overview
- Home
- Register
- Login
- ServeImages
- Uploads
- Logout
- Profile
3. Chat
- Overview
- Server side
- Client side
4. Forms
5. Configuration
6. Sessions
7. File uploads.
1. [Getting started](https://github.com/gernest/aurora/blob/master/docs/getting-started.md)
- [x] Overview
- [x] Installation


Roadmap
-------

## Features
- [x] chat
- [x] profile management
- [x] photo upload
- [x] ??? any ideas?


## Contributing
This is a playground, all kinds of contibutions are welcome. Since it is for learning and
Expand Down
6 changes: 3 additions & 3 deletions bin/build.go
Expand Up @@ -88,8 +88,8 @@ func (a *AuroraCLI) Assemble() {
a.logErr(a.copyDir(a.cfg.Templates, path.Join(a.buildDir, a.cfg.Templates)))

// copy application configurations
appCfg := path.Join(a.buildDir, path.Join(a.cfg.ConfigDir, "app"))
a.logErr(a.copyDir(path.Join(a.cfg.ConfigDir, "app"), appCfg))
appCfg := path.Join(a.buildDir, a.cfg.ConfigDir)
a.logErr(a.copyDir(a.cfg.ConfigDir, appCfg))
a.log("---DONE")

}
Expand Down Expand Up @@ -237,7 +237,7 @@ func (a *AuroraCLI) clean() {
}
func main() {
v := flag.Bool("v", false, "logs build messages on stdout")
c := flag.String("c", "config/build/build.json", "specifies wich configuration file to use")
c := flag.String("c", "config/build.json", "specifies wich configuration file to use")
flag.Parse()
a := NewCLI()
if *v {
Expand Down
2 changes: 1 addition & 1 deletion cmd/aurora/aurora.go
Expand Up @@ -10,7 +10,7 @@ import (
)

func main() {
d, err := ioutil.ReadFile("config/app/app.json")
d, err := ioutil.ReadFile("config/app.json")
if err != nil {
panic(err)
}
Expand Down
File renamed without changes.
File renamed without changes.
60 changes: 60 additions & 0 deletions docs/getting-started.md
@@ -0,0 +1,60 @@
# Getting started with aurora

### Overiview
Aurora is a simple yet useful attempt to create a minimalistic social network with Go and
bolt database.
#### Project structure
The project is divided into two parts, a library and an app. The directories in this project
are as follows.

* bin:
This is wehere the binaries should be, unfortunate you will only find the build script file
`build.go` in this directory.
* builds:
This is where the built project is stored. Aurora needs configuration files and templates to run
so, a built binary together with all the dependency files are copied here. Inside this directory
the build versions are used to identify builds.
* config:
configurations are found here
* cmd:
This is where the aurora commandline application is.
* docs:
Project documentation
* public:
All javascript,css,fonts and images are stored here.
* templates:
templates used by aurora.


## Installation.
You will have to build this project in order to install. Make sure you have a working
golang environment, and a GOPATH.

get the project

go get github.com/gernest/aurora


cd into the installed library

cd $GOPATH/github.com/gernest/aurora

Run the build script(NOTE: I have used the script for linux only, so help is needed to
provide scripts for other platforms.) I am waiting for go 1.5 to provide cross platforms
builds. This will take a while to complete as the script runs the test suite before building.

go run bin/build.go

If you see nothing then the build was success. You should see a directory in the builds directory
with the version number e.g `0.0.1`. You can copy this folder anywhere you want or even rename it.
You can start aurora inside this directory like this

,/aurora

A simple single command to help start aurora , you can do like this.

cd buils/0.0.1&&./aurora # assuming the build is version 0.0.1


After running the above command a server is started at port `8080` on localhost. So you
need to point your browser to `localhost:8080` to view the site.

0 comments on commit 46821e8

Please sign in to comment.