forked from svenfuchs/adva_cms
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
201 lines (137 loc) · 6.32 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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
Welcome to adva-cms
===================
adva-cms is a cutting edge open source application platform based on Ruby on
Rails and Rails Engines.
Different from others, adva-cms lives in vendor directory and keeps your main
app directory clean and dandy. So you can reclaim app directory and use it
only for your own application files.
adva-cms makes it extensible: you can only pick those engines/features you really
need for your application and omit the rest. All engines are designed to work
together seamlessly, so the whole platform feels much more consistent for
similar but separate Rails applications.
Please check out /doc directory and our site http://adva-cms.org for more info.
Installation: Release 0.1.2
===========================
Required: Rails 2.3.2, ImageMagick for image handling
# install Rails 2.3.2 gems if you don't have them already
sudo gem install rails --source http://gems.rubyonrails.org
# install and setup adva-cms using a template
rails my-app -m http://github.com/svenfuchs/adva_cms/raw/master/templates/adva-cms.0.1.2.rb
# there's no step 2
cd my-app
ruby script/server
open http://localhost:3000
You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!
You can install additional engines and plugins through rake adva:install. See
below for more about that.
Installation: Edge version using rails template
===============================================
Required: Rails 2.3.2, ImageMagick for image handling
# install Rails 2.3.2 gems if you don't have them already
sudo gem install rails --source http://gems.rubyonrails.org
# install and setup adva-cms using a template
rails my-app -m http://github.com/svenfuchs/adva_cms/raw/master/templates/adva-cms.master.rb
# there's no step 2
cd my-app
ruby script/server
open http://localhost:3000
You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!
You can install additional engines and plugins through rake adva:install. See
below for more about that.
Installation: Edge version manually
===================================
Required: Rails 2.3.2.1 or newer, ImageMagick for image handling
# First install Rails 2.3.2.1 gems if you don't have it already
sudo gem install rails --source http://gems.rubyonrails.org
# Create your app
rails my-app
cd my-app
rm public/index.html
# Prepare the config/environment.rb and remove the public/index.html
# in config/environment.rb make sure you have:
require File.join(File.dirname(__FILE__), 'boot')
require File.join(File.dirname(__FILE__), '../vendor/adva/engines/adva_cms/boot') # insert this line
# Clone the adva-cms ( this might take a bit, grab a coffee meanwhile :) )
git clone git://github.com/svenfuchs/adva_cms.git vendor/adva # or use: git submodule add ...
# Install the core engines and copy the assets
rake adva:install:core -R vendor/adva/engines/adva_cms/lib/tasks # install adva-cms to vendor/plugins/
rake adva:assets:copy # copy plugin assets to public/
# Migrate the database and start the server
rake db:migrate
ruby script/server
open http://localhost:3000
You should see adva-cms installation screen.
Fill out the form and you're started, enjoy!
Installing/Uninstalling adva-cms engines and plugins
====================================================
You can install/uninstall adva-cms engines and plugins by using a set of rake
tasks. Installation simply works by symlinking (copying on Windows) to
vendor/plugins.
There are the following tasks/subtasks:
rake adva:install:all
rake adva:install:core
rake adva:install
rake adva:uninstall:all
rake adva:uninstall:core
rake adva:uninstall
For each of these tasks you can specify the option except and give it a list
of engine/plugin names that should be excluded from the install/ uninstall
task. E.g.
rake adva:install:all except=adva_themes,adva_wiki
rake adva:uninstall:all except=adva_themes,adva_wiki
For the tasks adva:install and adva:uninstall one can specify the options
engines and plugins and give it a list of engine/plugin names that should be
included to the task. E.g.
rake adva:install engines=adva_themes,adva_wiki plugins=adva_url_history
rake adva:uninstall engines=adva_themes,adva_wiki plugins=adva_url_history
(Accidentally, for the task adva:install:core one can specify the plugins
option in the same way and thus install all core engines plus certain
plugins.)
For both the engines and plugins options one can specify the keyword "all"
which then expands to all available engines and plugins respectively. Thus,
these are equivalent:
rake adva:install:all
rake adva:install engines=all plugins=all
When the "all" keyword is used with the uninstall task this only applies to
all engines and plugins except the adva-cms core engines. To uninstall these
you can still simply delete the symlinks (directories on Windows) from
vendor/plugins.
NOTE please note that right now assets not copied to public/ when engines are
installed and they are not removed from public/ when engines are uninstalled.
So after you've installed additional engines you'll most probably want to
copy the assets to public:
rake adva:assets:copy
Configuration
=============
You can change adva-cms configuration by including an initializer to your
application and overwriting things that adva-cms sets as defaults. See the
initializers in adva-cms engines/plugins, e.g. in
vendor/plugins/adva_cms/config/initializers/*
Running tests
=============
Running tests for adva-cms version 0.1.2 or newer:
rake db:test:clone # Clones from your development database to test database
ruby script/test-adva-cms -p # Prepares the database and runs all adva-cms tests
ruby script/test-adva-cms # Runs all adva-cms tests without preparing the database
ruby script/test-adva-cms vendor/plugins/adva_wiki # Runs only adva_wiki tests
Please check out /doc directory for high level overview about adva-cms.
Development
===========
Please report bugs to Lighthouse:
http://artweb-design.lighthouseapp.com/projects/13992-adva_cms/overview
Git repository:
http://github.com/svenfuchs/adva_cms/tree/master
adva-cms mailing list:
http://groups.google.com/group/adva-cms
adva-cms irc:
irc://irc.freenode.net#adva-cms
Developers
==========
Sven Fuchs
Marko Seppä
Clemens Kofler
Priit Tamboom
Thomas R. Koll
Joshua Harvey