README.rst 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. LAKEsuperior
  2. ============
  3. |build status| |docs|
  4. LAKEsuperior is an alternative `Fedora
  5. Repository <http://fedorarepository.org>`__ implementation.
  6. Documentation
  7. -------------
  8. The full documentation is maintained in `Read The Docs
  9. <http://lakesuperior.readthedocs.io/>`__. Please refer to that for more info.
  10. Installation
  11. ------------
  12. The following instructions are aimed at a manual install using this git
  13. repository. For a hands-off install using Docker, see
  14. `the setup documentation
  15. <http://lakesuperior.readthedocs.io/en/latest/setup.html>`__.
  16. Dependencies
  17. ~~~~~~~~~~~~
  18. 1. Python 3.5 or greater.
  19. 2. A message broker supporting the STOMP protocol. For testing and
  20. evaluation purposes, `CoilMQ <https://github.com/hozn/coilmq>`__ is
  21. included with the dependencies and should be automatically installed.
  22. Installation steps
  23. ~~~~~~~~~~~~~~~~~~
  24. #. Create a virtualenv in a project folder:
  25. ``python3 -m venv <virtualenv folder>``
  26. #. Activate the virtualenv: ``source <path_to_virtualenv>/bin/activate``
  27. #. Install dependencies: ``pip install -r requirements.txt``
  28. #. Start your STOMP broker, e.g.: ``coilmq &``. If you have another
  29. queue manager listening to port 61613 you can either configure a
  30. different port on the application configuration, or use the existing
  31. message queue.
  32. #. Run ``lsup-admin bootstrap`` to initialize the binary and graph
  33. stores.
  34. #. Run ``fcrepo``.
  35. Contributing
  36. ------------
  37. This has been so far a single person’s off-hours project (with much
  38. input from several sides). In order to turn into anything close to a
  39. Beta release and eventually to a production-ready implementation, it
  40. needs some community love.
  41. Contributions are welcome in all forms, including ideas, issue reports,
  42. or even just spinning up the software and providing some feedback.
  43. LAKEsuperior is meant to live as a community project.
  44. See `Contributing Guidelines
  45. <http://lakesuperior.readthedocs.io/en/latest/contributing.html>`__
  46. for further details on how to fork, improve, document and test the project.
  47. .. |build status| image:: http://img.shields.io/travis/scossu/lakesuperior/master.svg?style=flat
  48. :alt: Build Status
  49. :target: https://travis-ci.org/username/repo
  50. .. |docs| image:: https://readthedocs.org/projects/lakesuperior/badge/
  51. :alt: Documentation Status
  52. :scale: 100%
  53. :target: https://lakesuperior.readthedocs.io/en/latest/?badge=latest