Decko: you hold the cards
Decko (formerly known as “Wagn”) makes serious web development fun.
“Deckers” have used Decko to create open community sites, private knowledge management sites, public proposal submission sites with private back-ends for review, project management systems, wikis, blogs, journals, forums, and more.
Install Decko, open a webpage, and get started. With Decko's wiki-inspired building blocks, you can collaborate from day one on content, design, and structure create elegant web systems on the fly. And ruby developers can take these creations even further with Decko's development framework. Decko's innovative Mods API supports boundless creativity while integrating seamlessly with structures created on the site.
Try it out!
1. install dependencies
version 2.3.1 or higher
version 1.0 or higher
- A database engine
2. install the gem
gem install decko
Watch carefully for errors!
3. create a new deck
decko new MY_DECK
-f, [--force] # Overwrite files that already exist -p, [--pretend], [--no-pretend] # Run but do not make any changes -q, [--quiet], [--no-quiet] # Suppress status output -s, [--skip], [--no-skip] # Skip files that already exist -m, [--mod-dev], [--no-mod-dev] # Prepare deck for mod development -c, [--core-dev], [--no-core-dev] # Prepare deck for core development -g, [--gem-path=GEM-PATH] # Path to local decko repository (Default, use env DECKO_GEM_PATH) -i, [--interactive], [--no-interactive] # Prompt with dynamic installation options
4. create / seed database
Edit the config/database.yml file as necessary. More about database configuration at www.decko.org/database_configuration.
cd MY_DECK decko seed
..to create and seed the database
-p, --production decko:seed production database (default) -t, --test decko:seed test database -d, --development decko:seed development database -a, --all decko:seed production, test, and development database
4. start your server
To fire up the default, built-in WEBrick server, just run:
…and point your browser to localhost:3000 (unless otherwise configured).
-p, [--port=port] # Runs Decko on the specified port - defaults to 3000. -b, [--binding=IP] # Binds Decko to the specified IP - defaults to 'localhost' in development and '0.0.0.0' in other environments'. -c, [--config=file] # Uses a custom rackup configuration. (default: config.ru) -d, [--daemon], [--no-daemon] # Runs server as a Daemon. -e, [--environment=name] # Specifies the environment to run this server under (development/test/production). -P, [--pid=PID] # Specifies the PID file. (efault: tmp/pids/server.pid) [--early-hints], [--no-early-hints] # Enables HTTP/2 early hints.
For more information, see decko.org/get_started.
Always back up your database and uploaded files.
2. Update Libraries
From your decko root directory run:
3. Update Database
Run the following:
4. Restart your server.
Upgrade to Decko from Wagn
1. update references to “wagn” in file content
In your decko's root directory, edit Gemfile, config/application.rb, and config/routes.rb, and script/wagn, replacing “wagn” with “decko”. (Keep the same capitalization pattern.)
2. update references to “wagn” in file names.
From your decko root directory run:
mv script/wagn script/decko
3. continue as with Standard Upgrade
Upgrade pre-gem Wagn site
First check the Wagn/Decko version of your existing site.
Version 1.10 or newer
Create a new deck using steps 1 and 2 from the installation section above.
Copy config/database.yml from the old site to the new one.
Copy the old local/files contents to the new “files” directory.
If you have edited wagn.yml in your old site, make the corresponding changes to the new config/application.rb file.
Follow the standard upgrade procedure above.
Older than Version 1.10
First update your Wagn to version 1.10 via the old update mechanisms, and then follow the directions above.
If you're new to Decko, you'll find lots more info at decko.org
Installation problems? Installation: decko.org/installation
If you're looking to go deep into the code, start with www.rubydoc.info/gems/card
Thinking about contributing to Decko? here