README.md
1 |
|
2 |
===== |
3 |
|
4 |
Gitar is a free/libre, gratis, lightweight, easy to deploy web app for storing information about |
5 |
desired Git repositories for Django powered web servers. |
6 |
|
7 |
Name |
8 |
---- |
9 |
|
10 |
Gitar refers to the fact that the software is built for Git repositories, for |
11 |
use with the [Django web framework](https://djangoproject.com). Django itself |
12 |
refers to the name of the guitarist [Django |
13 |
Reinhardt](https://en.wikipedia.org/wiki/Django_Reinhardt). So I found "Gitar" |
14 |
an awesome name =3 |
15 |
|
16 |
About |
17 |
----- |
18 |
|
19 |
Gitar adheres to Django's MVT structure, and was built to allow people to easily |
20 |
refer to their Git repos, providing readable code in the background, with |
21 |
templates implementing Google's [Material Design |
22 |
specifications](https://www.google.com/design/spec). |
23 |
|
24 |
Another reason Gitar was meant to happen, is because of Github's rather |
25 |
hypocritic approach to its own existence; while it hosts an amazing amount of |
26 |
[free](https://audio-video.gnu.org/video/TEDxGE2014_Stallman05_LQ.webm) |
27 |
software, GitHub Inc. does not share GitHub's code at all ([I'm not the only one |
28 |
that dislikes this](https://github.com/dear-github/dear-github)). Gitar tries to |
29 |
fix that (and hopefully more). |
30 |
|
31 |
Gitar's repo handling consists mainly of read-only features, but I hope I can |
32 |
expand Gitar in such a way, that it becomes a viable alternative to Github's |
33 |
offerings. |
34 |
|
35 |
Gitar was also made because I wanted to make a serious project with a punny name =) |
36 |
|
37 |
Features |
38 |
-------- |
39 |
|
40 |
* Simple and lightweight |
41 |
* Source code syntax highlighting using Pygments |
42 |
* No JavaScript required |
43 |
* Free/Libre software |
44 |
|
45 |
Licensing |
46 |
--------- |
47 |
|
48 |
Gitar is free software, licensed under the GNU Affero General Public License |
49 |
v3+. |
50 |