README.rst 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. Pagure
  2. ======
  3. :Author: Pierre-Yves Chibon <pingou@pingoured.fr>
  4. Pagure is a light-weight git-centered forge based on pygit2.
  5. Currently, Pagure offers a decent web-interface for git repositories, a
  6. simplistic ticket system (that needs improvements) and possibilities to create
  7. new projects, fork existing ones and create/merge pull-requests across or
  8. within projects.
  9. Homepage: https://github.com/pypingou/pagure
  10. Dev instance: http://209.132.184.222/ (/!\\ May change unexpectedly, it's a dev instance ;-))
  11. Get it running
  12. ==============
  13. * Retrieve the sources::
  14. git clone git://github.com/pypingou/pagure
  15. * Create the folder that will receive the projects, forks, docs and tickets'
  16. git repo::
  17. mkdir {repos,docs,forks,tickets}
  18. * Create the inital database scheme::
  19. python createdb.py
  20. * Run it::
  21. ./runserver.py
  22. * To get some profiling information you can also run it as::
  23. ./runserver.py --profile
  24. This will launch the application at http://127.0.0.1:5000
  25. UI overview
  26. -----------
  27. .. image:: screenshots/overview_home.png
  28. :scale: 50 %
  29. :alt: Pagure's home page overview
  30. :align: center
  31. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_home.png
  32. .. image:: screenshots/overview_main.png
  33. :scale: 50 %
  34. :alt: Pagure's project page overview
  35. :align: center
  36. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_main.png
  37. .. image:: screenshots/overview_commit.png
  38. :scale: 50 %
  39. :alt: Pagure's commit overview
  40. :align: center
  41. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_commit.png
  42. .. image:: screenshots/overview_request_pull.png
  43. :scale: 50 %
  44. :alt: Pagure's pull-request overview
  45. :align: center
  46. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_request_pull.png
  47. .. image:: screenshots/overview_issues_list.png
  48. :scale: 50 %
  49. :alt: Pagure's issues list overview
  50. :align: center
  51. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_issues_list.png
  52. .. image:: screenshots/overview_issue.png
  53. :scale: 50 %
  54. :alt: Pagure's issue overview
  55. :align: center
  56. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_issue.png
  57. .. image:: screenshots/overview_users.png
  58. :scale: 50 %
  59. :alt: Pagure's users overview
  60. :align: center
  61. :target: https://github.com/pypingou/pagure/raw/master/screenshots/overview_users.png