From 30e291682b3d6e10430b683c062cb2b9491b8025 Mon Sep 17 00:00:00 2001
From: Joursoir <chat@joursoir.net>
Date: Sat, 22 May 2021 11:35:12 +0000
Subject: add readme, delete example_config

---
 README.md      | 97 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 example_config | 41 -------------------------
 2 files changed, 97 insertions(+), 41 deletions(-)
 create mode 100644 README.md
 delete mode 100644 example_config

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..861fa13
--- /dev/null
+++ b/README.md
@@ -0,0 +1,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
+```
diff --git a/example_config b/example_config
deleted file mode 100644
index 6d8d155..0000000
--- a/example_config
+++ /dev/null
@@ -1,41 +0,0 @@
-# Example config file for ctimeline
-
-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
-- 
cgit v1.2.3-18-g5258