top
(README)
Imperial Library of Trantor

The Imperial Library of Trantor (also known as Galactic Library) is a repository management system of ebooks on ePub format.

You can check out the main development branch from Gitorious at:

https://gitorious.org/trantor/

(We still in pre-beta fase)

== Dependences ==

In order to run Trantor, you need to install the following packages:

* Go language
* Mongodb (>= 2.6)
* Bazaar
* Git

Under Debian Wheezy you can simply run:

# aptitude install golang-go git mercurial bzr mongodb

Yo also need to install go dependences:

# go get gopkg.in/mgo.v2 gopkg.in/mgo.v2/bson github.com/gorilla/sessions \
         github.com/gorilla/securecookie github.com/gorilla/mux \
         github.com/nfnt/resize github.com/cihub/seelog \
         code.google.com/p/go.crypto/scrypt \
         github.com/rainycape/cld2

== Installation ==
=== For admins ("for developers" below) ===

Now you can install Trantor itself:

# go get -tags prod git.gitorious.org/trantor/trantor.git

You can run trantor in /srv/www/trantor i.e. For this:

# mkdir -p /srv/www/trantor

# cd /srv/www/trantor

# ln -s /usr/lib/go/src/pkg/git.gitorious.org/trantor/trantor.git/templates/ templates
# ln -s /usr/lib/go/src/pkg/git.gitorious.org/trantor/trantor.git/css/ css
# ln -s /usr/lib/go/src/pkg/git.gitorious.org/trantor/trantor.git/js/ js
# ln -s /usr/lib/go/src/pkg/git.gitorious.org/trantor/trantor.git/img/ img

Now you can run it:
# /usr/lib/go/bin/trantor.git

Go to your browser to: http://localhost:8080

=== For developers ===

Login to gitorius: https://gitorious.org/login
and clone your own Trantor: https://gitorious.org/trantor/trantor/clone

In your shell
$ git clone git://gitorious.org/~yourname/trantor/yournames-trantor.git 
$ cd yournames-trantor

You can edit config.go if you want to change the port and other configuration, by default is 8080

Now you can compile Trantor:
$ go build -tags prod
(remove '-tags prod' for a faster compilation without language guessing)

Now you can run it:
$ ./yourname-trantor

Go to your browser to: http://localhost:8080

== Bugs ==

Please, report bugs to zenow@tormail.org

== Patches ==
Make your enhacements and sent it by git:

$ git commit -m "comment"
$ git remote set-url --push origin git@gitorious.org:~yournames/trantor/alfinals-trantor.git
$ git push origin master
$ git push

Go to "merge-requests"
 https://gitorious.org/trantor/yournames-trantor/merge_requests/new


== Rights ==

All the matterial of this project is under WTFPL as described on the LICENSE 
file with the exception of:
- css/bootstrap.min.css css/bootstra-responsive.min.css js/bootstrap.min.js 
  img/glyphicons-halflings-white.png img/glyphicons-halflings.png
  From the bootstrap framework: http://twitter.github.com/bootstrap/
- js/jquery.js
  From jquery library: http://jquery.com/
- js/Chart.min.js
  From chart.js library: http://www.chartjs.org/
- img/bright_squares.png
  From subtlepatterns: http://subtlepatterns.com/bright-squares/
- css/FredokaOne.ttf css/PTSerif.ttf
  From Google Web Fonts: http://www.google.com/webfonts

Imports 8 package(s) ΒΆ

  1. github.com/nfnt/resize
  2. git.gitorious.org/trantor/trantor.git/storage
  3. github.com/gorilla/securecookie
  4. github.com/cihub/seelog
  5. git.gitorious.org/trantor/trantor.git/database
  6. git.gitorious.org/go-pkg/epubgo.git
  7. github.com/gorilla/mux
  8. github.com/gorilla/sessions