-
Notifications
You must be signed in to change notification settings - Fork 784
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
76 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,56 +1,111 @@ | ||
# [Antwort](http://internations.github.com/antwort) | ||
|
||
### Responsive Layouts for Email | ||
 | ||
 | ||
|
||
Antwort offers responsive layouts for Email that both fits _and_ adapts to client widths. Don't underwhelm desktop users with single column layouts that work for mobile. Antwort offers columns on desktop that automatically become rows on mobile. | ||
|
||
Author: Julie Ng ([@jng5](http://twitter.com/jng5)) | ||
Date: January 2013 | ||
Version: 0.1.2 | ||
Date: October 2014 | ||
Version: 1.0.0 | ||
|
||
## Features | ||
|
||
* Works on mobile: Mail on iOS and Email on Android. | ||
* Works in major clients like Hotmail, Gmail, Yahoo! and AOL. | ||
* Works in major clients like AOL, gmail, outlook.com and Yahoo. | ||
* Even works in Outlook (2000+). | ||
* Bulletproof layouts: made with dynamic content in mind. | ||
* Minimalist in design for maximum customizability. | ||
* [More details on Antwort site »](http://internations.github.com/antwort/) | ||
|
||
## How to use | ||
1. [Read tips and coding style guidelines](http://internations.github.com/antwort). | ||
2. Test with [Litmus](https://litmus.com/). | ||
3. Send! | ||
### NEW since v1.0 | ||
|
||
* __Source templates__ | ||
Antwort now includes the source templates (pre inlined CSS) for your reference. This lets you easily customize the template for your own use. Each template has a `build.html` with inlined CSS as well as the original source files in a `source` folder. | ||
|
||
* __Support for Android 4.3+__ | ||
Antwort v0 relied on applying `display: block;` to `<td>` to force columns into rows. Starting with Android 4.3, that is no longer possible, i.e. columns remain columns. | ||
|
||
Antwort v1 relies on conditional wrapper tables to support Microsoft Outlook desktop clients. The columns themselves are no longer `<td>`s but `<table>`s, whose width expand to 100% on mobile devices. | ||
|
||
## Included Templates | ||
|
||
Included templates as of v1.0.0 release (14 October 2014): | ||
|
||
<table> | ||
<tbody> | ||
<tr> | ||
<td align="center" valign="top"> | ||
<strong>Single Column</strong><br><br> | ||
<img src="http://internations.github.io/antwort/images/v1-previews/1-col.png" style="max-width: 95%;"> | ||
</td> | ||
<td align="center" valign="top"> | ||
<strong>Two Columns (text)</strong><br><br> | ||
<img src="http://internations.github.io/antwort/images/v1-previews/2-cols.png" style="max-width: 95%;"> | ||
</td> | ||
<td align="center" valign="top"> | ||
<strong>Three Columns (images)</strong><br><br> | ||
<img src="http://internations.github.io/antwort/images/v1-previews/3-cols-images.png" style="max-width: 95%;"> | ||
</td> | ||
</tr> | ||
<tr> | ||
<td align="center"><a href="https://litmus.com/pub/23497a4" target="_blank">Litmus Previews</a></td> | ||
<td align="center"><a href="https://litmus.com/pub/2e0aaa0" target="_blank">Litmus Previews</a></td> | ||
<td align="center"><a href="https://litmus.com/pub/de912ba" target="_blank">Litmus Previews</a></td> | ||
</tr> | ||
</tbody> | ||
</table> | ||
|
||
|
||
|
||
## How to use Antwort | ||
|
||
Antwort is **not** a framework. Antwort is meant to teach you how to do responsive layouts for Email. That's why source pre-lined HTML is now included for you to learn from. | ||
|
||
#### Need help? | ||
|
||
Before [posting an issue](https://github.com/InterNations/antwort/issues), please | ||
|
||
1. Make sure you are sending the email from an Email Service Provider (ESP), for example MailChimp **not** your Email client e.g. Outlook. | ||
2. Double check any code changes you might have made | ||
3. Do a test send to yourself and view the source. Did your ESP change the code? | ||
|
||
|
||
## Tools and Resources | ||
* [Campaign Monitor's Guide to CSS Support](http://www.campaignmonitor.com/css) - reference table for CSS support in major email clients. | ||
* [CSS Inliner Tool](http://beaker.mailchimp.com/inline-css) from MailChimp. | ||
* [Premailer](http://premailer.dialect.ca/) another CSS inline tool. Also generates text version. | ||
* [Litmus](http://www.litmus.com/) for testing Emails across clients. | ||
|
||
## Changelog | ||
|
||
### 0.1.2 | ||
### 1.0.0 | ||
|
||
14 October 2014 | ||
|
||
* Complete re-write of code, to reflect latest email development challenges, especially with Android 4.3+ | ||
* New: include source folders before inlining CSS. | ||
* New: single column fluid layout | ||
* Footer now includes example address, which has an example for removing blue iOS links. | ||
|
||
|
||
### 0.1.2 | ||
|
||
April 2013 | ||
|
||
* Fixed issue #8 - headlines no longer centered in Outlook.com and older Outlook. | ||
* Fixed issue #7 - moved padding overrides to parent `<td>` in mobile styles. | ||
|
||
### 0.1.1 | ||
|
||
26 March 2013 | ||
|
||
* Fixed column margin issue after [Hotmail/Outlook dropped margin support](https://litmus.com/blog/hotmail-and-outlook-com-drop-support-for-margin). | ||
* Issue #5 fixed - Outlook.com parses HTML tags in comments. | ||
* Issue #3 fixed - control characters removed from template. | ||
* Added screenshots of current version from Litmus test. | ||
|
||
|
||
### 0.1.0 | ||
* Hello open source world. | ||
|
||
## Demo | ||
* Download and resize your browser window to see its responsiveness. | ||
* [View demo screenshots](https://github.com/InterNations/antwort/blob/gh-pages/screenshots-litmus/) to see *how it looks* in various Email clients, including Android 2.3, Outlook 2000, Apple Mail, etc. | ||
4 Jan 2013 | ||
|
||
[](https://github.com/InterNations/antwort/blob/gh-pages/screenshots-litmus/) | ||
* Hello open source world. | ||
|
||
*Screenshots generated by [Litmus](http://www.litmus.com/). Last updated 26 March 2013 (v0.1.1)* | ||
|
||
## License | ||
Antwort is provided under the MIT License - see LICENSE.md for full details. |