Filled out readme file

This commit is contained in:
Brian Buller 2017-07-24 08:54:02 -05:00
parent 883bca0566
commit c6dc295100
2 changed files with 78 additions and 6 deletions

View File

@ -1,11 +1,83 @@
# ictgj-voting # ictgj-voting
The ICT GameJam Voting Application The ICT GameJam Voting Application
pass in the `-dev` flag to enable development mode (load assets from file system instead of embedded). Downloading and Running
----
Download a binary from the list below that is appropriate for your system
Run the binary, if a database is not found in the current directory, the application will walk you through
and initial set up (create an admin user, give the site a title, name the current game jam) and a database
will be created in the current directory
Uses 'esc' for embedding assets:
https://github.com/mjibson/esc
TODO: Build Instructions Command Line Arguments
----
Configuration arguments
Passing a configuration argument will save the value to the database for future use
```bash
-title=<title> Set the title for the site
-port=<port> The port to run the site on
-session-name=<name> A name to use for the session
-server-dir=<director> Directory to use for assets (templates/js/css)
-reset-defaults Reset all of the configurable site settings to their defaults
This only affects the settings that can be set from the command line
```
Runtime Arguments
These arguments only affect the current run of the application
```bash
-help Display the application help, breakdown of arguments
-dev Run in development mode, load assets (templates/js/css) from file system
rather than the binary
```
Prebuilt Binaries
----
[Linux 64 bit](https://br0xen.com/dowload/ictgj-voting/gjvote.linux64 "Linux 64 bit build")
[Linux 32 bit](https://br0xen.com/download/ictgj-voting/gjvote.linux386 "Linux 32 bit build")
[Linux Arm](https://br0xen.com/download/ictgj-voting/gjvote.linuxarm "Linux Arm build")
[Mac OS](https://br0xen.com/download/ictgj-voting/gjvote.darwin64 "Mac OS build")
[Windows 64 bit](https://br0xen.com/download/ictgj-voting/gjvote.win64 "Windows 64 bit build")
[Windows 32 bit](https://br0xen.com/download/ictgj-voting/gjvote.win386 "Windows 32 bit build")
Building
----
```bash
go get github.com/devict/ictgj-voting
```
Developing/Contributing Notes
----
Do not make changes to `assets.go`, this file is generated when you run `go generate`
Pass in the `-dev` flag to enable development mode (load assets from the file system instead of embedded).
After making changes to assets (templates, javascript, css) be sure to run `go generate` before `go build`
This regenerates the assets.go file
Please use the go tooling to match the standard go coding style. For parts that aren't bound by that style,
either try to match the already existing style, or give a reason why you think it should change.
Vendorings
----
* 'boltdb' as a data store: https://github.com/boltdb/bolt
* 'boltease' to manipulate the bolt db easier: https://github.com/br0xen/boltease
* Various 'gorilla' libraries for http server stuff: https://github.com/gorilla/
* context: https://github.com/gorilla/context
* handlers: https://github.com/gorilla/handlers
* mux: https://github.com/gorilla/mux
* securecookie: https://github.com/gorilla/securecookie
* sessions: https://github.com/gorilla/sessions
* 'alice' for http server middleware: https://github.com/justinas/alice
* 'uuid' for uuid generation: https://github.com/pborman/uuid
* 'esc' for embedding assets: https://github.com/mjibson/esc
TODO: Contribution Instructions

View File

@ -12040,7 +12040,7 @@ Xo6z3V9nVvnKh0MZ+h0AAP//kX1qvCYDAAA=
"/templates/admin-main.html": { "/templates/admin-main.html": {
local: "templates/admin-main.html", local: "templates/admin-main.html",
size: 1476, size: 1476,
modtime: 1500477139, modtime: 1500477228,
compressed: ` compressed: `
H4sIAAAJbogA/6xTTQ/aMAy971d4FRKXtQHtNrWVEJN22oc2tp1Da0q0NGFJWoQQ/30OAVTxMVDhgpPY H4sIAAAJbogA/6xTTQ/aMAy971d4FRKXtQHtNrWVEJN22oc2tp1Da0q0NGFJWoQQ/30OAVTxMVDhgpPY
fjy/56alaKGQ3NosKrRyqFyUvwHw7z7Safk+/9bMpSjgsy4xZXQPiXnjnFagVUHJP1m0FqrU60Tqgjuh fjy/56alaKGQ3NosKrRyqFyUvwHw7z7Safk+/9bMpSjgsy4xZXQPiXnjnFagVUHJP1m0FqrU60Tqgjuh