This repository has been archived by the owner on Jun 15, 2021. It is now read-only.
/
README
118 lines (90 loc) · 3.91 KB
/
README
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
= JekyllCommander
JekyllCommander is a Sinatra based web application, to give non-technical users
the ability to maintain a complex Jekyll website, including git version control,
without any scary terminal experiences.
JekyllCommander has been developed to fit exactly our needs. Some parts are
highly specific to our Website <https://github.com/prometheus-ev/promhp> and
our workflow. But maybe you can take some advantage of this code, anyway.
We are thinking about changing JekyllCommander to be more generic, but you know:
Fork it, if we are to slow for you. ;)
== HOW IT WORKS
Because this is smart, the sources of our website are living in a git
repository. This repo will be cloned by JekyllCommander as a working copy for
every user. Users can make their changes via JekyllCommander's web interface
and generate an own preview.
All changes an user made will be merged into a staging version of the website
when he/she decides that everything is done so far. This staging repo, which
has its own preview, combines the commits of all user.
And at one point, in the case that everything is alright, it can go public. This
means (in the background) that all changes will be pushed to the live repo.
In our case this (or rather pushing a tag) triggers the system to generate the
webside and move it into the document root of our webserver. There are our
scripts in the "example" folder for a better understanding.
== INSTALLATION AND CONFIGURATION
=== Requirements
* grit - object oriented read/write access to Git repositories via Ruby.
* jekyll - a simple, blog aware, static site generator.
* jekyll_commander - a Sinatra based web interface, to maintain a Jekyll website, including git version control.
* logger - a simple logging utility.
=== Organization of the source code
After checking out a working copy of the source code, you will presented with
the following directory structure:
.
|-- examples
|-- lib
|-- public
| |-- css
| |-- images
| |-- js
| `-- markitup
| |-- sets
| | |-- default
| | | `-- images
| | |-- html
| | | `-- images
| | |-- markdown
| | | `-- images
| | `-- textile
| | `-- images
| |-- skins
| | |-- markitup
| | | `-- images
| | `-- simple
| | `-- images
| `-- templates
|-- tmp
`-- views
=== Installation
Will hopefully be written in the near future...
=== Configuration
In order to configure your installation you will have to create a +config.yamle+
file in the root directory of your installation; an example file
+config.yaml.sample+ is provided, which can be used as starting point for
your own settings.
---
:repo: git@example.com:repos/repo.git
:site: http://example.com
:staging: /staging
:preview: /preview-%s
:email: %s@example.com
:users:
jd: { :name: John Doe, :email: jdoe@example.net }
== AUTHORS
* Jens Wille <mailto:jens.wille@uni-koeln.de>
* Arne Eilermann <mailto:eilermann@lavabit.com>
* Lars Baehren <mailto:lbaehren@uni-koeln.de>
== CREDITS
Icons by <http://famfamfam.com>.
== LICENSE AND COPYRIGHT
Copyright (C) 2010-2012 University of Cologne,
Albertus-Magnus-Platz, 50923 Cologne, Germany
JekyllCommander is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your option)
any later version.
JekyllCommander is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
details.
You should have received a copy of the GNU Affero General Public License along
with JekyllCommander. If not, see <http://www.gnu.org/licenses/>.