|
1 |
| -Edirom Online |
2 |
| -============= |
| 1 | +# Edirom Online |
3 | 2 |
|
4 |
| -Table of contents |
| 3 | +Edirom Online is a web application written in XQuery and Javascript, and designed for deployment in eXist-db[http://exist-db.org/exist/apps/homepage/index.html](http://exist-db.org/exist/apps/homepage/index.html). It is based on the work of the [_Edirom_-Project](https://edirom.de/edirom-projekt/) that originally was funded by the German Research Foundation (DFG). This software brings paperbased historio-critical editions of music texts to the web. |
5 | 4 |
|
6 |
| -<ul> |
7 |
| - <li style="margin-top:0;margin-bottom:0;"><a href="#dependencies">Dependencies</a></li> |
8 |
| - <li style="margin-top:0;margin-bottom:0;"><a href="#setup">Setup</a></li> |
9 |
| - <li style="margin-top:0;margin-bottom:0;"><a href="#setupcontent">Setup Content</a></li> |
10 |
| - <li style="margin-top:0;margin-bottom:0;"><a href="#development">Development</a></li> |
11 |
| - <li style="margin-top:0;margin-bottom:0;"><a href="#license">License</a></li> |
12 |
| -</ul> |
| 5 | +The software is still under high development and has to be seen as beta software. |
13 | 6 |
|
14 |
| -Edirom Online is a web application written in XQuery and Javascript, based on the work of the _Edirom_-Project (<http://www.edirom.de>) funded by the German Research Foundation (DFG). This software brings paperbased historio-critical editions of musicians handwritings to the pc. |
| 7 | +## Dependencies |
15 | 8 |
|
16 | 9 | Edirom Online depends heavily on the javascript framework ExtJS (<http://www.sencha.com/products/extjs/>) which is included in parts in our code base. We use ExtJS 4.2.1 in the GPL version. Edirom Online also includes the Raphaël javscript library (<http://raphaeljs.com>, MIT License) and the ACE editor (<http://ace.ajax.org>, BSD license).
|
17 | 10 |
|
18 |
| -The software is still under high development and has to be seen as beta software. |
| 11 | +## Contributing |
| 12 | + |
| 13 | +### Building locally |
| 14 | + |
| 15 | +For building Edirom Online you need *Sencha Cmd* installed on your system. You might want to refer to the [Sencha Cmd System Setup](https://docs.sencha.com/cmd/7.5.0/guides/intro_to_cmd.html#intro_to_cmd_-_system_setup) section for more details. |
| 16 | + |
| 17 | +Alternatively we recommend to use a container image for building, e.g. [bwbohl/sencha-cmd](https://github.com/bwbohl/sencha-cmd/pkgs/container/sencha-cmd) |
19 | 18 |
|
| 19 | +```bash |
| 20 | +docker run --rm -it -v /ABSOLUTE/PATH/TO/YOUR/LOCAL/EDIROM-ONLINE/CLONE:/app --name ediBuild ghcr.io/bwbohl/sencha-cmd:latest |
| 21 | +``` |
20 | 22 |
|
21 |
| -Dependencies |
22 |
| ------------- |
| 23 | +When you have your system preapared with all Sencha Cmd prerequisites or you have your docker container running you have to execute a sencha build command through calling the build script included in this repository with one of the sencha build-type options (please refer to [sencha app build reference](https://docs.sencha.com/cmd/guides/advanced_cmd/cmd_reference.html#advanced_cmd-_-cmd_reference_-_sencha_app_build) for details), either in your native shell or in the container shell, e.g.: |
23 | 24 |
|
24 |
| -* Jetty Application Server (<http://www.eclipse.org/jetty/>), in the newest version |
25 |
| -* eXist-db (<http://www.exist-db.org>), in the newest version |
26 |
| -* Digilib (<http://digilib.sourceforge.net/>), in the newest version |
27 |
| -* Apache with mod_proxy (<http://httpd.apache.org/docs/current/mod/mod_proxy.html>) |
| 25 | +```bash |
| 26 | +./build.sh testing |
| 27 | +``` |
28 | 28 |
|
29 |
| -Install eXist-db and Digilib on different ports. We use Jetty as application server for Digilib, others should work, too. |
| 29 | +### Testing locally |
30 | 30 |
|
| 31 | +It is essential to Test your modifications before committing or issuing a pull request. A recommended way is running a local eXist-db v5.3 container and deploying your local build of Edirom Online together with some test-data, e.g. the [Edirom Edition Example](https://github.com/Edirom/EditionExample). |
31 | 32 |
|
32 |
| -Setup |
33 |
| ------ |
| 33 | +## Other deployment methods |
34 | 34 |
|
35 |
| -Please see our documentation in the wiki section: https://github.com/Edirom/Edirom-Online/wiki |
| 35 | +Please see our documentation in the [wiki](https://github.com/Edirom/Edirom-Online/wiki). |
36 | 36 |
|
37 |
| -License |
38 |
| -------- |
| 37 | +## License |
39 | 38 |
|
40 | 39 | Edirom Online is released to the public under the terms of the [GNU GPL v.3](<http://www.gnu.org/copyleft/gpl.html>) open source license.
|
41 | 40 |
|
@@ -74,4 +73,4 @@ included in the application's javascript code build. By default, files in this
|
74 | 73 | folder are mapped to the application's root namespace, 'EdiromOnline'. The
|
75 | 74 | namespace to which files in this directory are matched is controlled by the
|
76 | 75 | app.sass.namespace property in EdiromOnline/.sencha/app/sencha.cfg.
|
77 |
| ---> |
| 76 | +--> |
0 commit comments