Présentation du projet Ariane (Paris.rb 11/03/12)

1. Ariane
Breadcrumbs pour Rails

2. whoami
Simon COURTOIS
CTO chez Selectra
Github: simonc
Twitter: @happynoff

3. Breadcrumbs ?

4. Breadcrumbs et Rails ?
Crummy

5. Objectif
Crummy
Twitter Bootstrap
Schema.org
I18n

6. Participer au projet

7. Participer au projet

8. Ariane - Objectif
Flexibilité
Faciliter l’usage
Faciliter la participation

9. Ariane - Objectif
Flexibilité !
U R
O
Faciliter l’usage
Jparticipation
1
Faciliter la

10. Ariane - Construction
# app/controllers/application_controller.rb
class ApplicationController < ActionController::Base
before_filter :set_ariane
def set_ariane
ariane.add "Home", root_path
end
end
# app/controllers/articles_controller.rb
class ArticlesController < ApplicationController
def set_ariane
super
ariane.add "Articles", articles_path
end
end

11. Ariane - Affichage
# app/views/layouts/application.html.erb
<%= ariane.render %>

12. Ariane - Lien spécifique
Titre d’un article ?
# app/views/articles/show.html.erb
<% ariane.add @article.title, article_path(@article) %>

13. Ariane - Structure
Breadcrumb Crumb
Ariane
Renders
Base
HTML
HTMLList

14. Ariane - Renderers
Renders
<p class="breadcrumb">
Base
<a href="/">Home</a> / Articles
HTML
</p>
HTMLList

15. Ariane - Renderers
<ul class="breadcrumb">
Renders
<li>
Base <a href="/">Home</a>
<span class="divider">/</span>
</li>
HTML
<li class="active">Other</li>
HTMLList </ul>

16. Ariane - Renderers
JSON
XML
Markdown
Whatever...

17. Ariane - Choix du Renderer
Renderers inclus dans Ariane
<%= ariane.render(Ariane::Render::HTMLList) %> (par défaut)
<%= ariane.render(Ariane::Render::HTML) %>
<%= ariane.render(Ariane::Render::JSON) %>
<%= ariane.render(Ariane::Render::XML) %>
<%= ariane.render(Ariane::Render::...) %>
Créez vos propres Renderers !

18. Ariane - Paramètres
# config/initializers/ariane.rb
rndr = Ariane::Render::HTML.new({
:divider => '-',
:link_active => true,
:list_id => 'awesome-breadcrumb'
})
Ariane.configure do |config|
config.default_renderer = rndr
end
<p class="awesome-breadcrumb">
<a href="/">Home</a> -
<a href="/articles" class="active">Articles</a>
</p>

19. Ariane - Objectif
Flexibilité
Faciliter l’usage
Faciliter la participation

20. Ariane - Objectif
Flexibilité
Faciliter l’usage
Faciliter la participation

21. Ariane - La suite ?
Dynamic Breadcrumb
Big thanks to Anthony Bouch (github: 58bits)
Sucre syntaxique
# app/views/articles/show.html.erb
<% ariane.add @article.title, @article %>

22. Ariane - Ressources
Github
http://github.com/simonc/ariane
Twitter @happynoff

23. Merci !