aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorJoursoir <chat@joursoir.net>2021-05-22 11:35:12 +0000
committerJoursoir <chat@joursoir.net>2021-05-22 11:35:12 +0000
commit30e291682b3d6e10430b683c062cb2b9491b8025 (patch)
tree0e3ecf87bfa216b827e532e6fb7b5ceb2f4c5f3a /README.md
parent9ec67871aebb039de696b2ee531a8759fc6e2e42 (diff)
downloadctimeline-30e291682b3d6e10430b683c062cb2b9491b8025.tar.gz
ctimeline-30e291682b3d6e10430b683c062cb2b9491b8025.tar.bz2
ctimeline-30e291682b3d6e10430b683c062cb2b9491b8025.zip
add readme, delete example_configv1.0
Diffstat (limited to 'README.md')
-rw-r--r--README.md97
1 files changed, 97 insertions, 0 deletions
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
+```