This gem provides common navigational elements across all of our apps.
- Compatibility with MRI 1.8.7 and 1.9.2.
- No dependency on any particular Web Framework.
- The templates must be usable from PHP for SEOMoz.
Terminology reference image:
You may want to review a commit demonstrating these steps for turbo.
-
Add the MozNav gem to the Gemfile, using a
:gitsource. Runbundle installto install the gem. You should use the:tagoption to lock to a specific version (this is quite important, as the production, minified css file is just compiled for every release). -
Ensure the assets can be symlinked properly. In a rails 3 app, the railtie takes care of this for you. For other apps, you will need to add code like
MozNav.ensure_assets_symlinked_from(File.expand_path('../public', __FILE__))to be run during application boot. You'll probably want to gitignore the symlinked dir (using a pattern likepublic/moz_nav_assets) since the symlink uses absolute paths. -
Configure MozNav. In rails, you'll probably want to do this in
config/initializers/moz_nav.rb. Example code:MozNav.configure do |c| c.seomoz_host = 'www.seomoz.org' c.q_and_a_host = 'www.seomoz.org' c.environment = 'development' c.asset_path_prefix = '/q' endseomoz_host: The host used for links to the PHP www.seomoz.org web app. Defaults to"www.seomoz.org".q_and_a_host: The host used for links to the Q&A app. Defaults to"www.seomoz.org"as well. In that code base, you'd probably want to set this to the appropriate host of the rails env (i.e. localhost in development) so that links remain in the same app and environment.environment: Determines which stylesheet is used. If set toproduction, a minified stylesheet will be used. If set todevelopment, a non-minified stylesheet will be used. Note that in a rails context, you shouldn't have to set this; MozNav smartly figures it out based on the value ofRails.env.asset_path_prefix: Can be set if the app is not served from the root. Will prefix all assets with this path.
-
Use the provided RSpec shared example group to test compliance with the MozNav gem. Example:
require 'spec_helper' require 'moz_nav/rspec' describe ApplicationController do it_behaves_like "the MozNav rendering context" do let(:render_context) do described_class.new.tap { |c| c.instance_eval { @current_user = Factory.create(:pro_user) } } end end endBasically, this tests that the rendering context has access to a
current_userhelper method, and that the user object returned by the method conforms to the interface MozNav expects. -
Include the
MozNav::RenderHelpermodule in the appropriate rendering context. In rails you'll probably just want to addinclude MozNav::RenderHelperto theApplicationHelpermodule; in sinatra you can just usehelpers MozNav::RenderHelper. -
Call the appropriate rendering helpers from your application layout. For most applications, you only need to use the following
nav_header_includesshould be called from the<head>of the page.nav_body_classreturns a string that should be used as the class on the body element.render_nav_wrapped(page_content_string)wraps the correct global header, page header and footer around your page body automatically. Usually, you can just pass this methodyieldfrom your layout.nav_footer_includesshould be called just before the closing</body>tag.
If you desire some finer control over what elements render when, you may use the following instead of
render_nav_wrappedabove.render_nav_headershould be called where you want the global header to be. It yields an object that allows you to configure the header.render_nav_body(page_content_string)should be called where you want the navigation to wrap your page content with the blue page title section and optional subnav. For pages not needing a blue page title, such as home pages, you may omit using this method and insteadyieldin your layout like normal.render_nav_footershould be called where you want the footer to be.
To put things another way,
render_nav_wrappedcallsrender_nav_header,render_nav_bodyandrender_nav_footerfor you.
Use RVM to install MRI 1.8.7 and 1.9.2. Then setup the necessary gems:
rvm use 1.9.2
rvm gemset create moz_nav
rvm gemset use moz_nav
gem install bundler
bundle install
rvm use 1.8.7
rvm gemset create moz_nav
rvm gemset use moz_nav
gem install bundler
bundle install
Then you can run terminitor to have it launch all the necessary processes:
terminitor start
Run infinity_test. This will continuously run the specs against
1.8.7 and 1.9.2.
There is an example sinatra app in the app folder. It is used by
the specs. You can also run it. Run rake example_app:serve.
Visit it in your browser at http://localhost:3000.
We're using Compass/SASS for the CSS. You should not edit the CSS files
manually. Instead, edit the SASS files and run rake compass:watch to
have it automatically compile your SASS files to CSS as you save changes
to the SASS files.
For Mustache (logic-less HTML templates), check:
For SASS (the CSS precompiler), check:
For Capybara (the browser simulator used by the acceptance specs), check the Github README.
Copyright 2011 SEOmoz. See LICENSE for details.