aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 861fa136e459306d36086bb22c8afce06da02af2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
# CTimeline
CGI application for timelines. Distributed under the GNU General Public License, version 3.

## Dependencies:
No

## Installation:
```
$ make
$ sudo make install
```

`ctimeline.cgi` and `ctimeline.css` will install into `/var/www/html/ctimeline` by default.

If you would like to configure this location, you may use:
```
$ sudo make install CTIMELINE_PATH='/your/path/to/ctimeline'
```

### Apache configuration:

1) Make sure that CGI module for apache are enabled

2) Add \<Directory\> directive to Apache configuration file like this:

```
<Directory /var/www/html/ctimeline>
	AllowOverride None
	Options +ExecCGI
	Order allow,deny
	Allow from all
</Directory>
```

## Example ctimelinerc file:

```
# Comment that will be ignored

title=Browse random timelines
css=ctimeline.css

header.title=Timelines of projects
header.desc=Here are random but interesting projects. You can explore them at your leisure

branch.name=Linux Kernel
branch.age_from=2000
branch.age_to=2021
branch.desc=Open-source, Unix-like operating system kernel

branch.name=PulseAudio
branch.age_from=2004
branch.age_to=2021
branch.desc=Sound system for POSIX OSes

branch.name=cgit
branch.age_from=2007
branch.age_to=2021
branch.desc=A hyperfast web frontend for git repositories written in C

branch.name=ALSA
branch.age_from=1997
branch.age_to=2020
branch.desc=Advanced Linux Sound Architecture

branch.name=NeXTSTEP
branch.age_from=1989
branch.age_to=1995
branch.desc=Object-oriented, multitasking operating system

branch.name=dpkg
branch.age_from=1994
branch.age_to=2018
branch.desc=Package managment system in the open-source operating system Debian

branch.name=wireguard-linux
branch.age_from=2016
branch.age_to=2021
branch.desc=WireGuard for the Linux kernel

branch.name=ctimeline
branch.age_from=2021
branch.age_to=2021
branch.desc=Web frontend for timelines written in C
```

## Git commands that can help you:

* Get year of first commit:
```
git log --date=format:"%Y" --pretty=format:"%ad" --reverse | head -1
```

* Get year of last commit:
```
git log --date=format:"%Y" --pretty=format:"%ad" | head -1
```