| 4 | [marginalia]. | 4 | [marginalia]. |
|---|
| 5 | | 5 | |
|---|
| 6 | [marginalia]: http://www.geof.net/code/annotation | 6 | [marginalia]: http://www.geof.net/code/annotation |
|---|
| 7 | | 7 | |
|---|
| 8 | | 8 | |
|---|
| 9 | ## Copyright and License | 9 | ## Copyright and License |
|---|
| 10 | | 10 | |
|---|
| 11 | Copyright (c) 2006-2007 the Open Knowledge Foundation. | 11 | Copyright (c) 2006-2007 the Open Knowledge Foundation. |
|---|
| 12 | | 12 | |
|---|
| 13 | All parts deriving directly from Geof Glass' code are (c) Geoff Glass and | 13 | All parts deriving directly from Geof Glass' code are (c) Geoff Glass and |
|---|
| 14 | collaborators and are licensed under the GPL v2. | 14 | collaborators and are licensed under the GPL v2. |
|---|
| 15 | | 15 | |
|---|
| 16 | All other code licensed under the MIT license: | 16 | All other code licensed under the MIT license: |
|---|
| 17 | | 17 | |
|---|
| 18 | <http://www.opensource.org/licenses/mit-license.php> | 18 | <http://www.opensource.org/licenses/mit-license.php> |
|---|
| 19 | | 19 | |
|---|
| 20 | | 20 | |
|---|
| 21 | ## Getting Started | 21 | ## Getting Started |
|---|
| 22 | | 22 | |
|---|
| 23 | You can start the demo web application: | 23 | You can start the demo web application: |
|---|
| 24 | | 24 | |
|---|
| 25 | $ python demo/demo.py | 25 | $ python demo/demo.py |
|---|
| 26 | | 26 | |
|---|
| 27 | You'll then find an annotable web page presented at <http://localhost:8080/> | 27 | You'll then find an annotable web page presented at <http://localhost:8080/> |
|---|
| 28 | | 28 | |
|---|
| 29 | Try it out. | 29 | Try it out. |
|---|
| 30 | | 30 | |
|---|
| 31 | | 31 | |
|---|
| 32 | ## Technical Information | 32 | ## Technical Information |
|---|
| 33 | | 33 | |
|---|
| 34 | Annotater is derived into 2 parts: | 34 | Annotater is derived into 2 parts: |
|---|
| 35 | | 35 | |
|---|
| 36 | 1. A annotation storage backend providing a web and RESTful interface | 36 | 1. A annotation storage backend providing a web and RESTful interface |
|---|
| 37 | | 37 | |
|---|
| 38 | 2. A web application that uses the marginalia javascript to provide javascript | 38 | 2. A web application that uses the marginalia javascript to provide javascript |
|---|
| 39 | based web annoation. | 39 | based web annoation. |
|---|
| 40 | | 40 | |
|---|
| 41 | | 41 | |
|---|
| 42 | ### Specification of the Annotation Store | 42 | ### Specification of the Annotation Store |
|---|
| 43 | | 43 | |
|---|
| 44 | The RESTful interface is defined by python routes commmand: | 44 | The RESTful interface is defined by python routes commmand: |
|---|
| 45 | | 45 | |
|---|
| 46 | map.resource('annotation') | 46 | map.resource('annotation') |
|---|
| 47 | | 47 | |
|---|
| 48 | That is, the store is mounted at url /annotation/ and supports a restful | 48 | That is, the store is mounted at url /annotation/ and supports a restful |
|---|
| 49 | interface as defined in the [routes docs]. | 49 | interface as defined in the [routes docs]. |
|---|
| 50 | | 50 | |
|---|
| 51 | [routes docs]: http://routes.groovie.org/manual.html | 51 | [routes docs]: http://routes.groovie.org/manual.html |
|---|
| 52 | | 52 | |
|---|
| 53 | There are a few additions to ensure compatibility with the marginalia | 53 | There are a few additions to ensure compatibility with the marginalia |
|---|
| 54 | javascript front-end as well as to support a better 'human' web interface. | 54 | javascript front-end as well as to support a better 'human' web interface. |
|---|
| 55 | These are most easily seen by looking at the routes commands at the top of | 55 | These are most easily seen by looking at the routes commands at the top of |
|---|
| 56 | annotater.py. | 56 | annotater.py. |
|---|
| 57 | | 57 | |
|---|
| 58 | An annotation: see the definition Annotation in model.py (the domain model | 58 | An annotation: see the definition Annotation in model.py (the domain model |
|---|
| 59 | file). | 59 | file). |
|---|
| 60 | | 60 | |
|---|