Project

segments

0.0
No commit activity in last 3 years
No release in over 3 years
segmentsjoshmcarthur/segmentsHomepageDocumentationSource CodeBug TrackerWiki
A Rails 3 Engine for managing and rendering text segments into your Rails web application. Segments are short-to-medium blocks of text or HTML that you wish to use throughout your application. It includes a web interface for managing segments, and is automatically compatible with Internationalization (I18n)
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
4,249
Stars
1
Forks
0
Watchers
3
 Releases
Current version
0.1.0
Total releases
1
First release
2011-06-04
Latest release
2011-06-04
 Development
Primary Language
Ruby
Average date of last 50 commits
2011-06-04
Reverse Dependencies
0

 Dependencies

Development

git
>= 0
jeweler
>= 0
 Project Readme

Segments

A Rails 3 Engine for managing and rendering text segments into your Rails web application. Segments are short-to-medium blocks of text or HTML that you wish to use throughout your application. It includes a web interface for managing segments, and is automatically compatible with Internationalization (I18n).

Features

  • Rails 3 Engine
  • Internationalized web interface
  • Customizable
  • Supports segments in multiple languages
  • ActiveRecord backend

Installation

  1. Add Segments to your Gemfile gem 'segments' (Stable) gem 'segments', :git => 'https://github.com/joshmcarthur/segments.git
  2. Install the engine bundle install rails generate segments
  3. Migrate database rake db:migrate

Usage

  • Managing segments:
    • Start your application, and visit /segments to manage segments
    • A segment has a key (Like an Internationalization key, except a string), content and a locale for which it should be rendered (I18n's default locale is the default). Keys can be the same, as long as the locale is different. This effectively means that you can have the same segment, for different languages.
    • If you require this segment page to be secured, you can override the authenticate_segments method of the SegmentsController to authenticate users.
  • Displaying segments:
    • A helper method called render_segment is available to all views. This block accpets a single argument, which is the key of the segment to render. The code that finds the segment uses I18n's current locale, so as long as this is set correctly, the correct segment will be rendered.

Contributing

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2011 Josh McArthur. See LICENSE.txt for further details.