From 1901ac9573931cfca1ae37d1c61931160fccfb7b Mon Sep 17 00:00:00 2001 From: rhymes Date: Thu, 13 May 2021 17:00:35 +0200 Subject: [PATCH] [15 min fix] Update Publishing from RSS guide with correct instructions (#13756) * Update Publishing from RSS guide with correct instructions * Use colons, not arrows * Update app/views/pages/publishing_from_rss_guide.html.erb Co-authored-by: Suzanne Aitchison Co-authored-by: Suzanne Aitchison --- .../_publishing_from_rss_guide_text.html.erb | 27 ----------- .../pages/publishing_from_rss_guide.html.erb | 48 ++++++++++++++++--- app/views/users/_publishing_from_rss.html.erb | 2 +- 3 files changed, 42 insertions(+), 35 deletions(-) delete mode 100644 app/views/pages/_publishing_from_rss_guide_text.html.erb diff --git a/app/views/pages/_publishing_from_rss_guide_text.html.erb b/app/views/pages/_publishing_from_rss_guide_text.html.erb deleted file mode 100644 index 7203adc14..000000000 --- a/app/views/pages/_publishing_from_rss_guide_text.html.erb +++ /dev/null @@ -1,27 +0,0 @@ -
-
-

Publishing from RSS Guide

-
-
-

Front Matter

-

Our RSS reader converts some tags from the RSS items to tags for the Jekyll front matter:

-
    -
  • <title>: title
    • -
  • <category>: - tags, comma separated. Since only 4 tags can be used in a post on <%= community_name %>, only the first four tags will be used from the RSS item. -
    • -
  • <link>: - canonical_url
    Only if the "Mark the RSS source as canonical URL by default" option is enabled in the Publishing from RSS settings. -
    • -
- -

Article Content

-

The article content is prioritized in this order: <content>, - <summary>, or - <description>. The HTML will be converted to Markdown as the body of the <%= community_name %> post.

-

If you're using a Medium RSS feed, Tweet links, YouTube, and Gist iframes are converted to Liquid tags.

-
-
-
-
-
diff --git a/app/views/pages/publishing_from_rss_guide.html.erb b/app/views/pages/publishing_from_rss_guide.html.erb index 2e105284e..d923e9da6 100644 --- a/app/views/pages/publishing_from_rss_guide.html.erb +++ b/app/views/pages/publishing_from_rss_guide.html.erb @@ -1,12 +1,46 @@ -<% title "Editor Guide" %> +<% title "Editor Guide - Publishing from RSS or Atom" %> <%= content_for :page_meta do %> - " /> - + + <%= meta_keywords_default %> <% end %> -
-
-
-<%= render "publishing_from_rss_guide_text" %> +
+
+

Publishing from RSS or Atom

+
+ +
+

Front Matter

+ +

Our feed reader converts some elements from the RSS or Atom feeds to tags for the editor's front matter:

+
    +
  • + <title>: title, the title of the post +
    • + +
  • + <category>: tags, only the first four <category> elements + can be used in a post on <%= community_name %> per each item in the feed. +
    • + +
  • + <link>: canonical_url, only used if the "Mark the RSS source as canonical URL by default" + option is enabled in the <%= link_to "RSS Settings", user_settings_path(:extensions) %>. +
    • +
+ +

Post Content

+ +

+ The post content is prioritized in this order: <content>, <summary>, or + <description>. +

+ +

The HTML will be converted to Markdown as the body of the <%= community_name %> post.

+ +

If you're using Medium RSS feed all its tweet links, YouTube, and Gist iframes will be converted to Liquid tags.

+
+
+
diff --git a/app/views/users/_publishing_from_rss.html.erb b/app/views/users/_publishing_from_rss.html.erb index 8e46da5c5..b6b5495bb 100644 --- a/app/views/users/_publishing_from_rss.html.erb +++ b/app/views/users/_publishing_from_rss.html.erb @@ -20,7 +20,7 @@

Formatting will typically look good, but you may have to make manual fixes. In the case of Medium, you may have to manually fix embeds.

To find out more about how drafts are created from your feed, read this - guide. + guide.

Your feed will be fetched every time you submit this form and updates will be automatically fetched periodically thereafter. Contact