annotate README @ 2:b8bf1af83841 draft

Paste query added, query engine improved, examples added

INSTALLATION VIA TOOL-SHED
==========================

1.- Install through Admin >> Search and browse tool sheds

2.- Copy SPARQLGalaxy.jar and SPARQLGalaxy_TEXT.jar to galaxy-dist/tool-data/shared/jars/ 


INSTALLATION VIA MERCURIAL
==========================

1.- Stop Galaxy.

2.- Move to galaxy-dist/tools/

3.- Clone the SPARQL-Galaxy repository with mercurial: 

hg clone http://[e-mail]/repos/mikel-egana-aranguren/sparql_galaxy

4.- Move to galaxy-dist/tools/sparql_galaxy and copy SPARQLGalaxy.jar and SPARQLGalaxy_TEXT.jar to galaxy-dist/tool-data/shared/jars/

5.- Add the following lines to /galaxy-dist/tool_conf.xml:

  <section name="SPARQL-Galaxy" id="SPARQLGalaxy">
    <tool file="sparql_galaxy/SPARQLGalaxy.xml"/>
  </section>

6.- Start Galaxy.

For updates: 

1.- Stop Galaxy.

2.- Move to galaxy-dist/tools/sparql_galaxy/

3.- Pull changes and update working copy with mercurial: 

hg pull
hg update

4.- Copy SPARQLGalaxy.jar to galaxy-dist/tool-data/shared/jars/

5.- Only edit galaxy-dist/tool_conf.xml in case a tool (an XML file) has been added/removed.

6.- Start Galaxy.



MANUAL INSTALLATION (DIRECT DOWNLOAD)
=====================================

Download and uncompress anywhere you like, and then:

1.- Stop Galaxy.

2.- Copy SPARQLGalaxy.jar and SPARQLGalaxy_TEXT.jar to galaxy-dist/tool-data/shared/jars/
 
3.- Create directory galaxy-dist/tools/sparql_galaxy/

4.- Copy SPARQLGalaxy.xml to galaxy-dist/tools/sparql_galaxy/

5.- Add the following lines to /galaxy-dist/tool_conf.xml:

  <section name="SPARQL-Galaxy" id="SPARQLGalaxy">
    <tool file="sparql_galaxy/SPARQLGalaxy.xml"/>
  </section>

6.- Start Galaxy.



CONTACT
=======

Please send any request or comment to [e-mail].



ACKNOWLEDGEMENTS
================

This work is funded by the Marie Curie Cofund program of the EU, FP7, 
and the Isaac Peral Program.



COPYRIGHT AND LICENSE
=====================

Copyright (c) 2011 Mikel Egaña Aranguren, Alejandro Rodriguez Gonzalez 

SPARQL-Galaxy is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

JENA has its own license.