create relevant descriptions; add Mailchimp page

13 files changed, 75 insertions, 12 deletions

diff --git a/exampleSite/config.toml b/exampleSite/config.toml
index 739b2f7..e5c61cb 100644
--- a/exampleSite/config.toml
+++ b/exampleSite/config.toml
@@ -20,7 +20,6 @@ paginate = 5
 
 [params]
   author = "Baron Schwartz"
-  mailchimp = "your-mailchimp-form-url-here"
   twitter = "xaprb"
   classes = []
 
diff --git a/exampleSite/content/_index.md b/exampleSite/content/_index.md
index af010a5..c29276a 100644
--- a/exampleSite/content/_index.md
+++ b/exampleSite/content/_index.md
@@ -1,5 +1,5 @@
 ---
-title: Story Theme Demo
+title: Story Hugo Theme Demo Site
 subtitle: "Showcase Your Work"
 ---
 [![Baron Schwartz](/img/baron-square.jpg)](https://www.xaprb.com)
diff --git a/exampleSite/content/author-pages.md b/exampleSite/content/author-pages.md
index b5c1b28..47dfd95 100644
--- a/exampleSite/content/author-pages.md
+++ b/exampleSite/content/author-pages.md
@@ -3,7 +3,7 @@ author: Elvis Presley
 title: Story Author Profiles
 url: /author-profiles
 date: "2018-08-29"
-description: "This is a feature demo for the Story Hugo theme."
+description: "With Story, you can define global and per-item author profiles/biographies."
 image: "img/unsplash-photos-TzMi5Ov7QeM.jpg"
 credit: "https://unsplash.com/photos/TzMi5Ov7QeM"
 thumbnail: "img/unsplash-photos-TzMi5Ov7QeM.tn-500x500.jpg"
diff --git a/exampleSite/content/features.md b/exampleSite/content/features.md
index dbd51ae..921c3c0 100644
--- a/exampleSite/content/features.md
+++ b/exampleSite/content/features.md
@@ -2,7 +2,7 @@
 title: Story Feature Flags
 date: "2018-08-30"
 url: "/features"
-description: "This is a feature demo for the Story Hugo theme."
+description: "Story comes with a lot of power, but it's all configurable: almost every extra feature is optional."
 credit: "https://unsplash.com/photos/QRkew0KwXSM"
 image: "img/unsplash-photos-QRkew0KwXSM.jpg"
 thumbnail: img/unsplash-photos-QRkew0KwXSM.tn-500x500.jpg
diff --git a/exampleSite/content/figures.md b/exampleSite/content/figures.md
index 5c2ed18..05b506a 100644
--- a/exampleSite/content/figures.md
+++ b/exampleSite/content/figures.md
@@ -2,7 +2,7 @@
 title: Story Figures, Captions, and Tables
 date: "2018-08-22"
 url: "/figures"
-description: "This is a feature demo for the Story Hugo theme."
+description: "This article shows you how to enhance your images and tables with features such as captions and alternative stylings."
 credit: "https://unsplash.com/photos/vHnVtLK8rCc"
 image: "img/unsplash-photos-vHnVtLK8rCc.jpg"
 thumbnail: img/unsplash-photos-vHnVtLK8rCc.tn-500x500.jpg
diff --git a/exampleSite/content/images.md b/exampleSite/content/images.md
index ec28293..26d118d 100644
--- a/exampleSite/content/images.md
+++ b/exampleSite/content/images.md
@@ -2,7 +2,7 @@
 title: Story Image Formatting Controls
 date: "2018-08-21"
 url: "/images"
-description: "This is a feature demo for the Story Hugo theme."
+description: "Story gives you extra control over image formatting using only Markdown syntax."
 classes:
 - feature-figcaption
 - feature-figcaption-hidden
diff --git a/exampleSite/content/img/jessy-hoffmann-720198-unsplash.jpg b/exampleSite/content/img/jessy-hoffmann-720198-unsplash.jpg
new file mode 100644
index 0000000..4624801
--- /dev/null
+++ b/exampleSite/content/img/jessy-hoffmann-720198-unsplash.jpg
diff --git a/exampleSite/content/img/jessy-hoffmann-720198-unsplash.tn-500x500.jpg b/exampleSite/content/img/jessy-hoffmann-720198-unsplash.tn-500x500.jpg
new file mode 100644
index 0000000..87c7dfe
--- /dev/null
+++ b/exampleSite/content/img/jessy-hoffmann-720198-unsplash.tn-500x500.jpg
diff --git a/exampleSite/content/mailchimp-features.md b/exampleSite/content/mailchimp-features.md
new file mode 100644
index 0000000..44269c8
--- /dev/null
+++ b/exampleSite/content/mailchimp-features.md
@@ -0,0 +1,64 @@
+---
+title: "Story's MailChimp Integration Features"
+date: "2018-08-18"
+url: "/mailchimp-features"
+description: "Story makes it easy to grow a MailChimp subscriber list and send beautifully formatted emails to them automatically."
+image: "img/jessy-hoffmann-720198-unsplash.jpg"
+credit: "https://unsplash.com/photos/EsNkWAv6Vmw/"
+thumbnail: "img/jessy-hoffmann-720198-unsplash.tn-500x500.jpg"
+categories:
+- Demo
+---
+If you're a blogger, you might use MailChimp to build a subscriber list, and
+Story makes that easy. MailChimp also has the ability to automatically send your
+new content to the list from an RSS feed, and guess what---Story helps you
+create an RSS feed customized just for that if you like, too.
+<!--more-->
+
+First, MailChimp subscriber forms. If you want to add a subscription form at the
+bottom of each page, just add your MailChimp URL as a parameter in your
+configuration file. Here's a YAML example for `config.yaml`:
+
+```yaml
+params:
+- mailchimp: "your URL here"
+```
+
+And here's an example for `config.toml`:
+
+```toml
+[params]
+  mailchimp = "your URL here"
+```
+
+You can copy the URL from the address bar of your MailChimp subscriber form. It
+becomes the `action` of the form, which will appear at the bottom of each page
+near your author biography.
+
+Next, an RSS feed. Story has an RSS layout customized to create summaries of
+your content's title, description, featured image, and summary content. The
+summary content is either delimited explicitly by the `<!--more-->` comment in
+your Markdown source, or generated automatically by Hugo. (Read more
+[here](https://gohugo.io/content-management/summaries/).)
+
+To enable this, you need to create a special `.md` file that won't appear as
+regular content, but will render an extra RSS feed file. Its content is ignored,
+and only its front matter is important. For example, you could create it as
+`content/mailchimp.md` with the following contents, using YAML front matter:
+
+```yaml
+---
+skip: true
+layout: mailchimp
+outputs:
+- rss
+---
+```
+
+Now Hugo will build an extra feed at `/mailchimp/index.xml` and you can use it
+to create [RSS campaigns in
+MailChimp](https://mailchimp.com/help/share-your-blog-posts-with-mailchimp/). Of
+course, you can also use your normal RSS feed, but Story's default is to put
+full content into that, so it might be more than you want.
+
+Read next: [Story's 'talks' feature for presentations](/talks/adirondack/).
diff --git a/exampleSite/content/math.md b/exampleSite/content/math.md
index 523a02f..53c5bf5 100644
--- a/exampleSite/content/math.md
+++ b/exampleSite/content/math.md
@@ -2,7 +2,7 @@
 title: Story Mathematical Equation Typesetting
 date: "2018-08-20"
 url: "/math"
-description: "This is a feature demo for the Story Hugo theme."
+description: "If you ever write equations or mathematical formulas, Story has the features you need."
 credit: "https://unsplash.com/photos/5mZ_M06Fc9g/download"
 image: "img/unsplash-photos-5mZ_M06Fc9g.jpg"
 thumbnail: img/unsplash-photos-5mZ_M06Fc9g.tn-500x500.jpg
diff --git a/exampleSite/content/other-features.md b/exampleSite/content/other-features.md
index 89567ed..0c52ed0 100644
--- a/exampleSite/content/other-features.md
+++ b/exampleSite/content/other-features.md
@@ -2,7 +2,7 @@
 title: Story Theme Features
 url: /theme-features
 date: "2018-09-01"
-description: "This is a feature demo for the Story Hugo theme."
+description: "This page is a tour of Story's features, so you can take full advantage of its power."
 image: "img/unsplash-photos-nehfi_SfqtU.jpg"
 credit: "https://unsplash.com/photos/nehfi_SfqtU"
 thumbnail: "img/unsplash-photos-nehfi_SfqtU.tn-500x500.jpg"
@@ -25,11 +25,11 @@ a separate documentation page, or just don't have full documentation yet.
 - [Advanced image styling features](/images)
 - [Mathematical equation typesetting](/math)
 - [Built-in search](/search-page)
+- [MailChimp subscribe forms and RSS feeds](/mailchimp-features)
 
 Story also has support for the following, which aren't extensively documented:
 
 - Code syntax highlighting
-- Mailchimp subscribe forms
 - Google Analytics
 - Categories
 - All types of blogs; Story isn't opinionated about what you call them (you
diff --git a/exampleSite/content/search-page.md b/exampleSite/content/search-page.md
index 545a4df..593f5cb 100644
--- a/exampleSite/content/search-page.md
+++ b/exampleSite/content/search-page.md
@@ -2,7 +2,7 @@
 title: Story JavaScript Search
 date: "2018-08-21"
 url: "/search-page"
-description: "This is a feature demo for the Story Hugo theme."
+description: "With Story, your site will have built-in search with no external dependencies."
 image: "img/unsplash-photos-4zxSWESyZio.jpg"
 credit: "https://unsplash.com/photos/4zxSWESyZio"
 thumbnail: "img/unsplash-photos-4zxSWESyZio.tn-500x500.jpg"
diff --git a/exampleSite/content/typography.md b/exampleSite/content/typography.md
index 1726b9e..12c695d 100644
--- a/exampleSite/content/typography.md
+++ b/exampleSite/content/typography.md
@@ -2,7 +2,7 @@
 title: Story Typography
 date: "2018-08-19"
 url: "/typography"
-description: "This is a feature demo for the Story Hugo theme."
+description: "Story uses gorgeous typefaces and is optimized for a pleasant reading experience on any device."
 credit: "https://unsplash.com/photos/h-M3O25tyvI"
 image: "img/unsplash-photos-h-M3O25tyvI.jpg"
 thumbnail: img/unsplash-photos-h-M3O25tyvI.tn-500x500.jpg
@@ -103,4 +103,4 @@ $( "#dinkus" ).click(function() {
 });
 </script>
 
-Read next: [Story's 'talks' feature for presentations](/talks/adirondack/).
+Read next: [Story's MailChimp subscribe forms and RSS feeds](/mailchimp-features).