<p>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.</p>
<h2 id="shortcuts-redux">“Where’d my shortcut go?”</h2>
<p>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 <a href="http://github.com/johnmuhl/radiant-ray-extension/issues">create a ticket</a> complaining about it and I’ll give you your shortcut back.</p>
<h2 id="ext-bundle">“What changed in <code>extensions.yml</code>?”</h2>
<p>All users of the extension bundling mechanism will need to update their <code>extensions.yml</code> 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.</p>
<p>For example, the old demonstration <code>extensions.yml</code> which looked like:</p>
<pre><code>---
- 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</code></pre>
<p>In Ray 2, the same <code>extensions.yml</code> looks basically the same; just with more less:</p>
<pre><code>---
- name: aggregation
- name: link-roll
- name: help
- name: markdown
- name: page-attachments
lib: mini_magick
- name: blog
hub: netzpirat
remote:
- saturnflyer</code></pre>
<p>You don’t need to list the <code>lib</code> on the RDiscount Markdown filter because it [[Extension dependencies|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 <code>lib</code> option.</p>
<h2 id="shortcuts">“What if I like typing?”</h2>
<p>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 <code>rake ray:extension:install name=mailer</code> and don’t want to switch to <code>rake ray:i name=mailer</code> you can keep right on using the long versions. You can get a reminder of the shortcuts with the <code>rake ray:help:shortcuts</code> command.</p>
2009-11-23T00:00:06-08:00
118980
legacy-information
34113
Legacy information
2009-05-04T11:24:42-07:00
7944