Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Legacy information

johnmuhl edited this page · 8 revisions

For the most part each Ray release is “compatible” with the previous one. Occasionally though things change between versions, you can find out all about what “breaking” changes the latest version has here.

“Where’d my shortcut go?”

In some cases, a shortcut that existed in Ray 1.x will no longer be present in Ray 2.×. Although the command is still there in long form you may find this to be a particular hassle, in that case please create a ticket complaining about it and I’ll give you your shortcut back.

“What changed in extensions.yml?”

All users of the extension bundling mechanism will need to update their extensions.yml before Ray 2.x can understand them. This is mainly because the original format was not very well considered; you’ll find most of your updating gets done with the delete key.

For example, the old demonstration extensions.yml which looked like:

---
- name: aggregation
- name: link-roll
- name: help
  hub: saturnflyer
- name: markdown
  hub: johnmuhl
  lib: rdiscount
  vendor: markdown_filter
- name: page_attachments
  plugin: attachment_fu
  plugin_repository: technoweenie
  lib: mini_magick
- name: blog
  hub: netzpirat
  remote: saturnflyer/radiant-blog-extension

In Ray 2, the same extensions.yml looks basically the same; just with more less:

---
- name: aggregation
- name: link-roll
- name: help
- name: markdown
- name: page-attachments
  lib: mini_magick
- name: blog
  hub: netzpirat
  remote:
    - saturnflyer

You don’t need to list the lib on the RDiscount Markdown filter because it declares it's own dependencies. For an extension that requires a gem but doesn’t declare it’s dependencies you’ll still need to use the lib option.

“What if I like typing?”

Users of previous versions may notice that the commands have changed. While this appears to be the case it’s not actually (mostly). All the same old commands are available, so if you got comfortable with rake ray:extension:install name=mailer and don’t want to switch to rake ray:i name=mailer you can keep right on using the long versions. You can get a reminder of the shortcuts with the rake ray:help:shortcuts command.

Something went wrong with that request. Please try again.