A simple (and cheerful) way to handle page titles in your layouts.
Add this line to your application's Gemfile:
gem 'happy-titles'
And then execute:
$ bundle
Or install it yourself as:
$ gem install happy-titles
Create a new file in config/initializers called happy_titles.rb or something else which makes sense!
In this new file, add the following lines to set the default site and tagline.
HappyTitles.configure do |config|
config.site = "Your Site"
config.tagline = "Your witty but informative tagline"
end
In the layout where you want to display your title add the following call to the Happy Titles helper method.
<%= page_title %>
The header element of your layout might end up looking something like:
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<%= page_title %>
</head>
Notice you don't need to wrap the helper in a <title> element, this is done for you.
In each of your views call the title method to set the title for that page.
<% title 'Your very first Happy Title!' %>
Given the above settings, let's have a look at the output you will receive when you call the page_title method in your layouts.
On pages where the title has not been set you will see...
<title>Your Site | Your witty but informative tagline</title>
...and on pages where the title has been set you will see...
<title>Your very first Happy Title! | Your Site</title>
That really is all there is to setting up and using Happy Titles!
You have already seen how to set up and use Happy Titles, now let's take a look at how to customise the individual title templates.
In all of the following examples I am going to assume the same defaults that are set up in the Set the Defaults section of this README.
Before we have a look at that, let's have a look at the placeholders you can use. These placeholders will be replaced with the real content when the title is rendered.
| Placeholder | Example |
|---|---|
| :site | "Your Site" |
| :tagline | "Your witty but informative tagline" |
| :title | Will become "Your very first Happy Title!" or :tagline if a page title has not been set |
Now let's have a look at the default templates.
| Template | Description |
|---|---|
| :site | :title | Is used when there is no title set: "Your Site | Your witty but informative tagline" |
| :title | :site | Is used when there is a title set: "Your very first Happy Title! | Your Site" |
You can change the default templates by using the following setting in config/initializers/happy_titles.rb
HappyTitles.configure do |config|
config.templates do
# The second param is the template to use when there is no title set
# The third param is the template to use when there is a title set
default "[:site]", "[:site] :title"
end
end
Then when you render your titles you will see the following
<title>[Your Site]</title> <!-- when there is no title -->
<title>[Your Site] Your very first Happy Title!</title> <!-- when the title is set -->
As well as changing the default template, you can also add new templates and then use those when you need a different title format in a different layout.
In config/initializers/happy_titles.rb:
HappyTitles.configure do |config|
config.templates do
extra "++ :site ++", "++ :site ++ :title ++"
end
end
Then in your layout, you can use the following to call the extra template.
<%= page_title :extra %>
And you will get the following output, as you probably would've guessed by now!
<title>++ Your Site ++</title> <!-- when there is no title -->
<title>++ Your Site ++ Your very first Happy Title! ++</title> <!-- when the title is set -->
You can add as many additional title templates as you need!
One final thing to mention, you can create templates that just have one format. So...
In config/initializers/happy_titles.rb:
HappyTitles.configure do |config|
config.templates do
single ":site (:title)"
end
end
In your layout:
<%= page_title :single %>
The output:
<title>Your Site (Your witty but informative tagline)</title> <!-- when there is no title -->
<title>Your Site (Your very first Happy Title!)</title> <!-- when the title is set -->
git checkout -b my-new-feature)git commit -am 'Add some feature')git push origin my-new-feature)FAQs
Unknown package
We found that happy-titles demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.