Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Adding comments on new lines so they're easier to read #38

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Adding comments on new lines so they're easier to read #38

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
99 changes: 77 additions & 22 deletions email.html
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,29 @@
<!-- ***************************************************
********************************************************

HOW TO USE: Use these code examples as a guideline for formatting your HTML email. You may want to create your own template based on these snippets or just pick and choose the ones that fix your specific rendering issue(s). There are two main areas in the template: 1. The header (head) area of the document. You will find global styles, where indicated, to move inline. 2. The body section contains more specific fixes and guidance to use where needed in your design.
HOW TO USE: Use these code examples as a guideline for formatting your HTML email.
You may want to create your own template based on these snippets or just pick and
choose the ones that fix your specific rendering issue(s). There are two main areas
in the template: 1. The header (head) area of the document. You will find global styles,
where indicated, to move inline. 2. The body section contains more specific fixes
and guidance to use where needed in your design.

DO NOT COPY OVER COMMENTS AND INSTRUCTIONS WITH THE CODE to your message or risk spam box banishment :).
DO NOT COPY OVER COMMENTS AND INSTRUCTIONS WITH THE CODE to your
message or risk spam box banishment :).

It is important to note that sometimes the styles in the header area should not be or don't need to be brought inline. Those instances will be marked accordingly in the comments.
It is important to note that sometimes the styles in the header area should not
be or don't need to be brought inline. Those instances will be marked
accordingly in the comments.

********************************************************
**************************************************** -->

<!-- Using the xHTML doctype is a good practice when sending HTML email. While not the only doctype you can use, it seems to have the least inconsistencies. For more information on which one may work best for you, check out the resources below.
<!-- Using the xHTML doctype is a good practice when sending HTML email.
While not the only doctype you can use, it seems to have the least inconsistencies.
For more information on which one may work best for you, check out the resources below.

UPDATED: Now using xHTML strict based on the fact that gmail and hotmail uses it. Find out more about that, and another great boilerplate, here: http://www.emailology.org/#1
UPDATED: Now using xHTML strict based on the fact that gmail and hotmail uses it.
Find out more about that, and another great boilerplate, here: http://www.emailology.org/#1

More info/Reference on doctypes in email:
Campaign Monitor - http://www.campaignmonitor.com/blog/post/3317/correct-doctype-to-use-in-html-email/
Expand Down Expand Up @@ -40,28 +51,42 @@
body{width:100% !important; -webkit-text-size-adjust:100%; -ms-text-size-adjust:100%; margin:0; padding:0;}
/* Prevent Webkit and Windows Mobile platforms from changing default font sizes, while not breaking desktop design. */
.ExternalClass {width:100%;} /* Force Hotmail to display emails at full width */
.ExternalClass, .ExternalClass p, .ExternalClass span, .ExternalClass font, .ExternalClass td, .ExternalClass div {line-height: 100%;} /* Force Hotmail to display normal line spacing. More on that: http://www.emailonacid.com/forum/viewthread/43/ */
.ExternalClass, .ExternalClass p, .ExternalClass span, .ExternalClass font, .ExternalClass td, .ExternalClass div {line-height: 100%;} /* Force Hotmail to display normal line spacing. More on that: http://www.emailonacid.com/forum/viewthread/43/ */
#backgroundTable {margin:0; padding:0; width:100% !important; line-height: 100% !important;}
/* End reset */

/* Some sensible defaults for images
1. "-ms-interpolation-mode: bicubic" works to help ie properly resize images in IE. (if you are resizing them using the width and height attributes)
1. "-ms-interpolation-mode: bicubic" works to help ie properly resize images in IE.
(if you are resizing them using the width and height attributes)
2. "border:none" removes border when linking images.
3. Updated the common Gmail/Hotmail image display fix: Gmail and Hotmail unwantedly adds in an extra space below images when using non IE browsers. You may not always want all of your images to be block elements. Apply the "image_fix" class to any image you need to fix.
3. Updated the common Gmail/Hotmail image display fix: Gmail and Hotmail unwantedly
adds in an extra space below images when using non IE browsers. You may not
always want all of your images to be block elements. Apply the "image_fix"
class to any image you need to fix.

Bring inline: Yes.
*/
img {outline:none; text-decoration:none; -ms-interpolation-mode: bicubic;}
a img {border:none;}
.image_fix {display:block;}

/** Yahoo paragraph fix: removes the proper spacing or the paragraph (p) tag. To correct we set the top/bottom margin to 1em in the head of the document. Simple fix with little effect on other styling. NOTE: It is also common to use two breaks instead of the paragraph tag but I think this way is cleaner and more semantic. NOTE: This example recommends 1em. More info on setting web defaults: http://www.w3.org/TR/CSS21/sample.html or http://meiert.com/en/blog/20070922/user-agent-style-sheets/
/** Yahoo paragraph fix: removes the proper spacing or the paragraph (p) tag.
To correct we set the top/bottom margin to 1em in the head of the document.
Simple fix with little effect on other styling. NOTE: It is also common to use
two breaks instead of the paragraph tag but I think this way is cleaner and more semantic.
NOTE: This example recommends 1em. More info on setting web defaults:
http://www.w3.org/TR/CSS21/sample.html or http://meiert.com/en/blog/20070922/user-agent-style-sheets/

Bring inline: Yes.
**/
p {margin: 1em 0;}

/** Hotmail header color reset: Hotmail replaces your header color styles with a green color on H2, H3, H4, H5, and H6 tags. In this example, the color is reset to black for a non-linked header, blue for a linked header, red for an active header (limited support), and purple for a visited header (limited support). Replace with your choice of color. The !important is really what is overriding Hotmail's styling. Hotmail also sets the H1 and H2 tags to the same size.
/** Hotmail header color reset: Hotmail replaces your header color styles with
a green color on H2, H3, H4, H5, and H6 tags. In this example, the color is reset
to black for a non-linked header, blue for a linked header, red for an active
header (limited support), and purple for a visited header (limited support).
Replace with your choice of color. The !important is really what is overriding
Hotmail's styling. Hotmail also sets the H1 and H2 tags to the same size.

Bring inline: Yes.
**/
Expand All @@ -70,14 +95,23 @@
h1 a, h2 a, h3 a, h4 a, h5 a, h6 a {color: blue !important;}

h1 a:active, h2 a:active, h3 a:active, h4 a:active, h5 a:active, h6 a:active {
color: red !important; /* Preferably not the same color as the normal header link color. There is limited support for psuedo classes in email clients, this was added just for good measure. */
/* Preferably not the same color as the normal header link color.
There is limited support for psuedo classes in email clients,
this was added just for good measure. */
color: red !important;
}

h1 a:visited, h2 a:visited, h3 a:visited, h4 a:visited, h5 a:visited, h6 a:visited {
color: purple !important; /* Preferably not the same color as the normal header link color. There is limited support for psuedo classes in email clients, this was added just for good measure. */
/* Preferably not the same color as the normal header link color.
There is limited support for psuedo classes in email clients,
this was added just for good measure. */
color: purple !important;
}

/** Outlook 07, 10 Padding issue: These "newer" versions of Outlook add some padding around table cells potentially throwing off your perfectly pixeled table. The issue can cause added space and also throw off borders completely. Use this fix in your header or inline to safely fix your table woes.
/** Outlook 07, 10 Padding issue: These "newer" versions of Outlook add some
padding around table cells potentially throwing off your perfectly pixeled table.
The issue can cause added space and also throw off borders completely.
Use this fix in your header or inline to safely fix your table woes.

More info: http://www.ianhoar.com/2008/04/29/outlook-2007-borders-and-1px-padding-on-table-cells/
http://www.campaignmonitor.com/blog/post/3392/1px-borders-padding-on-table-cells-in-outlook-07/
Expand All @@ -96,7 +130,9 @@
**/
table { border-collapse:collapse; mso-table-lspace:0pt; mso-table-rspace:0pt; }

/* Styling your links has become much simpler with the new Yahoo. In fact, it falls in line with the main credo of styling in email, bring your styles inline. Your link colors will be uniform across clients when brought inline.
/* Styling your links has become much simpler with the new Yahoo.
In fact, it falls in line with the main credo of styling in email, bring your styles inline.
Your link colors will be uniform across clients when brought inline.

Bring inline: Yes. */
a {color: orange;}
Expand All @@ -111,22 +147,29 @@
****************************************************
MOBILE TARGETING

Use @media queries with care. You should not bring these styles inline -- so it's recommended to apply them AFTER you bring the other stlying inline.
Use @media queries with care. You should not bring these styles inline -- so it's
recommended to apply them AFTER you bring the other stlying inline.

Note: test carefully with Yahoo.
Note 2: Don't bring anything below this line inline.
****************************************************
***************************************************/

/* NOTE: To properly use @media queries and play nice with yahoo mail, use attribute selectors in place of class, id declarations.
/* NOTE: To properly use @media queries and play nice with yahoo mail,
use attribute selectors in place of class, id declarations.
table[class=classname]
Read more: http://www.campaignmonitor.com/blog/post/3457/media-query-issues-in-yahoo-mail-mobile-email/
*/
@media only screen and (max-device-width: 480px) {

/* A nice and clean way to target phone numbers you want clickable and avoid a mobile phone from linking other numbers that look like, but are not phone numbers. Use these two blocks of code to "unstyle" any numbers that may be linked. The second block gives you a class to apply with a span tag to the numbers you would like linked and styled.
/* A nice and clean way to target phone numbers you want clickable and avoid
a mobile phone from linking other numbers that look like, but are not phone numbers.
Use these two blocks of code to "unstyle" any numbers that may be linked.
The second block gives you a class to apply with a span tag to the numbers
you would like linked and styled.

Inspired by Campaign Monitor's article on using phone numbers in email: http://www.campaignmonitor.com/blog/post/3571/using-phone-numbers-in-html-email/.
Inspired by Campaign Monitor's article on using phone numbers in email:
http://www.campaignmonitor.com/blog/post/3571/using-phone-numbers-in-html-email/.

Step 1 (Step 2: line 224)
*/
Expand Down Expand Up @@ -205,12 +248,17 @@
<![endif]-->
</head>
<body>
<!-- Wrapper/Container Table: Use a wrapper table to control the width and the background color consistently of your email. Use this approach instead of setting attributes on the body tag. -->
<!-- Wrapper/Container Table: Use a wrapper table to control the width and the
background color consistently of your email. Use this approach instead of
setting attributes on the body tag. -->
<table cellpadding="0" cellspacing="0" border="0" id="backgroundTable">
<tr>
<td>

<!-- Tables are the most common way to format your email consistently. Set your table widths inside cells and in most cases reset cellpadding, cellspacing, and border to zero. Use nested tables as a way to space effectively in your message. -->
<!-- Tables are the most common way to format your email consistently.
Set your table widths inside cells and in most cases reset cellpadding,
cellspacing, and border to zero. Use nested tables as a way to space
effectively in your message. -->
<table cellpadding="0" cellspacing="0" border="0" align="center">
<tr>
<td width="200" valign="top"></td>
Expand All @@ -224,10 +272,17 @@
<!-- Yahoo Link color fix updated: Simply bring your link styling inline. -->
<a href="http://htmlemailboilerplate.com" target ="_blank" title="Styling Links" style="color: orange; text-decoration: none;">Coloring Links appropriately</a>

<!-- Gmail/Hotmail image display fix: Gmail and Hotmail unwantedly adds in an extra space below images when using non IE browsers. This can be especially painful when you putting images on top of each other or putting back together an image you spliced for formatting reasons. Either way, you can add the 'image_fix' class to remove that space below the image. Make sure to set alignment (don't use float) on your images if you are placing them inline with text.-->
<!-- Gmail/Hotmail image display fix: Gmail and Hotmail unwantedly adds in
an extra space below images when using non IE browsers. This can be especially
painful when you putting images on top of each other or putting back together
an image you spliced for formatting reasons. Either way, you can add the 'image_fix'
class to remove that space below the image. Make sure to set alignment (don't use float)
on your images if you are placing them inline with text.-->
<img class="image_fix" src="full path to image" alt="Your alt text" title="Your title text" width="x" height="x" />

<!-- Step 2: Working with telephone numbers (including sms prompts). Use the "mobile_link" class with a span tag to control what number links and what doesn't in mobile clients. -->
<!-- Step 2: Working with telephone numbers (including sms prompts).
Use the "mobile_link" class with a span tag to control what number links and
what doesn't in mobile clients. -->
<span class="mobile_link">123-456-7890</span>

</td>
Expand Down