amp-html 0.7.7

data/lib/amp_html/components/docs/social.md

@@ -0,0 +1,130 @@
+
+# [Components](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs) / Social BETA
+
+
+## Information
+
+The AMP-HTML Social Component allows to embed content of various social-platforms and more in an AMP document.
+
+---
+
+### Quick info
+
+#### Latest component release: 0.7.0 (Pre-release) - 2017-03-21
+
+[**Changelog for version 0.7.0**](https://github.com/slooob/amp-html/blob/master/CHANGELOG.md#070-pre-release---2017-03-21)
+
+#### Requirements
+
+The Social Component does not depend on any other components.
+
+#### Dependents
+
+No other components depend on the Social Component.
+
+#### [DeepIntegration](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs#deepintegration-components): Enabled
+
+#### [Availability](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs#availability-of-components): Installable
+
+---
+
+## Installation
+
+Run in the command line:
+
+    amp-html install social
+
+Now you are ready to use the Social Component.
+
+To learn more about this component, without opening the documentation, run:
+
+    amp-html component social
+
+
+## Configuration
+
+The Social Component allows you to specify a default provider for your app.
+
+In your AMP-HTML configuration (`config/amp-html.yml`) search for the section of the Social Component.
+
+There you can set your default network like so:
+
+    default_provider: twitter
+
+You can always override this provider default by passing a different provider to your social integration in your view.
+
+A list of all by AMP preconfigured providers: https://github.com/ampproject/amp-html/blob/master/extensions/amp-social-share/0.1/amp-social-share-config.js
+
+To use a provider that is not preconfigured by AMP, specify the default_data_share_endpoint:
+
+    default_provider: whatsapp
+    default_data_share_endpoint: whatsapp://send
+
+
+## Usage
+
+**The AMP-HTML Social Component introduces a lot of seperate helpers. To take a look at the functionality of each of them, take a look at their references, lnked below.**
+
+### Examples: Embed a Tweet
+
+You can embed a tweet like so:
+
+    <%= amp_twitter(tweet_id) %>
+    <%= amp_twitter("585110598171631616", width: 486, height: 657, data: { cards: "hidden" }) %>
+
+It also takes a block:
+
+    <%= amp_twitter("585110598171631616", width: 486, height: 657, data: { cards: "hidden" }) do %>
+        <%= amp_placeholder("blockquote", class: "twitter-tweet" data: { lang: "en" }) do %>
+            <p lang="en" dir="ltr">The story how I became what some people would call a frontend engineer and an exploration into what that even means<a href="https://t.co/HrVz4cGMWG">https://t.co/HrVz4cGMWG</a></p>&mdash; Malte Ubl (@cramforce) <a href="https://twitter.com/cramforce/status/585110598171631616">April 6, 2015</a>
+        <% end %>
+    <% end %>
+
+Learn more about the `amp_twitter` helper in the dedicated reference linked below.
+
+**References:** [`amp_placeholder`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_placeholder.md)
+
+### Examples: Social Share
+
+It is that easy to create a social share button:
+
+    <%= amp_social_share(type) %>
+    <%= amp_social_share("twitter") %>
+
+It assumes that the current document canonical url is the URL you want to share and the page title is the text you want to share.
+
+When you want to pass parameters to the share endpoint, you can specify `data-param-<attribute>` that will be appended to the share endpoint.
+
+    <%= amp_social_share("linkedin", width: "60", height: "44", data: { param: { text: "Hello world", url: "https://railsamp.com/" } }) %>
+
+If the provider is not preconfigured ([preconfigured providers](https://github.com/ampproject/amp-html/blob/master/extensions/amp-social-share/0.1/amp-social-share-config.js)):
+
+    <%= amp_social_share("whatsapp", width: "60", height: "44", data: { share: { endpoint: "whatsapp://send" } param: { text: "Check out this article: TITLE - CANONICAL_URL" } }) %>
+
+It also takes a block:
+
+    <%= amp_social_share("whatsapp", width: "60", height: "44", data: { share: { endpoint: "whatsapp://send" } param: { text: "Check out this article: TITLE - CANONICAL_URL" } }) do %>
+        Share on Whatsapp
+    <% end %>
+
+Learn more about the `amp_social_share` helper in the dedicated reference linked below.
+
+**References:** [AMP HTML URL Variable Substitutions](https://github.com/ampproject/amp-html/blob/master/spec/amp-var-substitutions.md)
+
+
+### Helpers
+
+The following helpers are usable with the Social Component of AMP-HTML
+
+* [`amp_twitter`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_twitter.md)
+* [`amp_instagram`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_instagram.md)
+* [`amp_facebook`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_facebook.md)
+* [`amp_youtube`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_youtube.md)
+* [`amp_reddit`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_reddit.md)
+* [`amp_social_share`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_social_share.md)
+* [`amp_soundcloud`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_soundcloud.md)
+* [`amp_vine`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_vine.md)
+* [`amp_gfycat`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_gfycat.md)
+* [`amp_pin_it`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pin_it.md)
+* [`amp_pin_widget`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pin_widget.md)
+* [`amp_pinterest_follow`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pinterest_follow.md)

data/lib/amp_html/components/docs/stylesheets.md

@@ -0,0 +1,50 @@
+
+# [Components](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs) / Stylesheets
+
+
+## Information
+
+The AMP-HTML Stylesheets Component allows the use of stylesheets in AMP documents.
+
+---
+
+### Quick info
+
+#### Latest component release: 0.6.1 (Pre-release) - 2017-03-19
+
+[**Changelog for version 0.6.1**](https://github.com/slooob/amp-html/blob/master/CHANGELOG.md#061-pre-release---2017-03-19)
+
+#### Requirements
+
+The Stylesheets Component does not depend on any other components.
+
+#### Dependents
+
+No other components depend on the Stylesheets Component.
+
+#### [DeepIntegration](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs#deepintegration-components): Disabled
+
+#### [Availability](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs#availability-of-components): Build-in
+
+---
+
+## Usage
+
+By default every stylesheet (`.scss`) file inside of your `app/assets/stylesheets/amp` (depending on your AMP-HTML configuration) directory is included in your application layout.
+
+You can include some view specific styles utilizing the `amp_css` helper in your `<head>` tag:
+
+    <%= amp_css do %>
+        /* Your CSS here */
+    <% end %>
+
+For a detailed reference on the `amp_css` helper, follow the link below.
+
+
+### Helpers
+
+The following helpers are usable with the Stylesheets Component of AMP-HTML
+
+* [`amp_css`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_css.md)
+* [`amp_css_link` (in development)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_css_link.md)
+* [`amp_global_css` (deprecated)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_global_css.md)

data/lib/amp_html/components/help.rb

@@ -0,0 +1,19 @@
+module AmpHtml
+    module Components
+        class Help
+
+            def self.all
+                puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'docs', 'README.md'
+            end
+
+            def self.component name
+                begin
+                    puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'docs', "#{name}.md"
+                rescue Exception
+                    warn 'Component is not available'
+                end
+            end
+
+        end
+    end
+end

data/lib/amp_html/components/install.rb

@@ -0,0 +1,34 @@
+module AmpHtml
+    module Components
+
+        COMPONENTS = ['analytics', 'iframe', 'notifications', 'anim', 'ad', 'social', 'javascript', 'service_worker', 'lists']
+
+        class Install
+
+            def self.bundle
+                success1 = system "rails g amp-html:components#{ ' -s' if AmpHtml.split_view }#{ ' -f ' + AmpHtml.raw_format if AmpHtml.raw_format }#{ ' --analytics' if AmpHtml.components && AmpHtml.components.include?('analytics') || AmpHtml.components && AmpHtml.components.include?('notifications') }#{ ' --iframe' if AmpHtml.components && AmpHtml.components.include?('iframe') || AmpHtml.components && AmpHtml.components.include?('javascript') || AmpHtml.components && AmpHtml.components.include?('service_worker') }#{' --notifications' if AmpHtml.components && AmpHtml.components.include?('notifications') }#{ ' --anim' if AmpHtml.components && AmpHtml.components.include?('anim') }#{ ' --ad' if AmpHtml.components && AmpHtml.components.include?('ad') }#{ ' --social' if AmpHtml.components && AmpHtml.components.include?('social') }#{ ' --javascript' if (AmpHtml.components && AmpHtml.components.include?('javascript')) }#{ ' --service_worker' if (AmpHtml.components && AmpHtml.components.include?('service_worker')) }#{ ' --lists' if (AmpHtml.components && AmpHtml.components.include?('lists')) }"
+                success2 = system "rails g amp-html:install --only_initializer#{ ' --javascript' if (AmpHtml.components && AmpHtml.components.include?('javascript')) }"
+                if success1 && success2
+                    puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'templates', 'README.md'
+                else
+                    puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'templates', 'ERROR.md'
+                end
+            end
+
+            def self.install component
+                if COMPONENTS.include? component
+                    success1 = system "rails g amp-html:install#{ ' -s' if AmpHtml.split_view }#{ ' -f ' + AmpHtml.raw_format if AmpHtml.raw_format }#{ ' --analytics' if (AmpHtml.components && AmpHtml.components.include?('analytics')) || AmpHtml.components && AmpHtml.components.include?('notifications') || component == 'analytics' || component == 'notifications' }#{ ' --iframe' if (AmpHtml.components && AmpHtml.components.include?('iframe')) || AmpHtml.components && AmpHtml.components.include?('javascript') || AmpHtml.components && AmpHtml.components.include?('service_worker') || component == 'iframe' || component == 'javascript' || component == 'service_worker' }#{' --notifications' if (AmpHtml.components && AmpHtml.components.include?('notifications')) || component == 'notifications' }#{ ' --anim' if (AmpHtml.components && AmpHtml.components.include?('anim')) || component == 'anim' }#{ ' --ad' if (AmpHtml.components && AmpHtml.components.include?('ad')) || component == 'ad' }#{ ' --social' if (AmpHtml.components && AmpHtml.components.include?('social')) || component == 'social' }#{ ' --javascript' if (AmpHtml.components && AmpHtml.components.include?('javascript')) || component == 'javascript' }#{ ' --service_worker' if (AmpHtml.components && AmpHtml.components.include?('service_worker')) || component == 'service_worker' }#{ ' --lists' if (AmpHtml.components && AmpHtml.components.include?('lists')) || component == 'lists' }"
+                    success2 = system "rails g amp-html:components#{ ' -s' if AmpHtml.split_view }#{ ' -f ' + AmpHtml.raw_format if AmpHtml.raw_format }#{ ' --analytics' if (AmpHtml.components && AmpHtml.components.include?('analytics')) || AmpHtml.components && AmpHtml.components.include?('notifications') || component == 'analytics' || component == 'notifications' }#{ ' --iframe' if (AmpHtml.components && AmpHtml.components.include?('iframe')) || AmpHtml.components && AmpHtml.components.include?('javascript') || AmpHtml.components && AmpHtml.components.include?('service_worker') || component == 'iframe' || component == 'javascript' || component == 'service_worker' }#{' --notifications' if (AmpHtml.components && AmpHtml.components.include?('notifications')) || component == 'notifications' }#{ ' --anim' if (AmpHtml.components && AmpHtml.components.include?('anim')) || component == 'anim' }#{ ' --ad' if (AmpHtml.components && AmpHtml.components.include?('ad')) || component == 'ad' }#{ ' --social' if (AmpHtml.components && AmpHtml.components.include?('social')) || component == 'social' }#{ ' --javascript' if (AmpHtml.components && AmpHtml.components.include?('javascript')) || component == 'javascript' }#{ ' --service_worker' if (AmpHtml.components && AmpHtml.components.include?('service_worker')) || component == 'service_worker' }#{ ' --lists' if (AmpHtml.components && AmpHtml.components.include?('lists')) || component == 'lists' }"
+                    success3 = system "rails g amp-html:views --only_resources#{ ' --javascript' if (AmpHtml.components && AmpHtml.components.include?('javascript')) || component == 'javascript' }"
+                    if success1 && success2 && success3
+                        puts "Successfully installed '#{component}' component!"
+                        puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'templates', 'README.md'
+                    else
+                        puts IO.read File.join AmpHtml.root, 'amp_html', 'components', 'templates', 'ERROR.md'
+                    end
+                end
+            end
+
+        end
+    end
+end

data/lib/amp_html/components/templates/ERROR.md

@@ -0,0 +1,5 @@
+**An error occurred while installing AMP-HTML components**
+
+---
+
+Please visit "https://github.com/slooob/amp-html/issues" to report a bug.

data/lib/amp_html/components/templates/README.md

@@ -0,0 +1,12 @@
+
+**Your installation of AMP-HTML components completed successfully!**
+
+You can now use the components specified in `config/amp-html.yml`.
+
+---
+
+Learn more about AMP-HTML components: https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs
+
+Get help: https://github.com/slooob/amp-html/issues
+
+View guides: https://github.com/slooob/amp-html/wiki/Guides

data/lib/amp_html/configuration.rb

@@ -0,0 +1,170 @@
+module AmpHtml
+
+    def self.default_format
+        config = get_config
+        if config.key :default_format
+            config[:default_format]
+        else
+            'amp'
+        end
+    end
+    def self.raw_format
+        config = get_config
+        config[:default_format]
+    end
+
+    def self.fallback_format
+        config = get_config
+        config[:fallback_format]
+    end
+
+
+    def self.components
+        config = get_config
+        if config.key :components
+            config[:components]
+        else
+            nil
+        end
+    end
+
+
+    def self.split_view
+        config = get_config
+        if config.key :split_view
+            config[:split_view]
+        else
+            false
+        end
+    end
+
+
+    def self.assets_only_amp
+        config = get_config
+        if config.key(:assets) && config[:assets].key :only_amp
+            config[:assets][:only_amp]
+        else
+            if AmpHtml.split_view
+                false
+            else
+                true
+            end
+        end
+    end
+
+
+    def self.application_name
+        config = get_config
+        if config.key(:application) && config[:application].key :name
+            config[:application][:name]
+        else
+            Rails.application.class.parent
+        end
+    end
+    def self.application_type
+        config = get_config
+        if config.key(:application) && config[:application].key :type
+            config[:application][:type]
+        else
+            nil
+        end
+    end
+    def self.application_date_published
+        config = get_config
+        if config.key(:application) && config[:application].key :date_published
+            config[:application][:date_published]
+        else
+            DateTime.now
+        end
+    end
+    def self.application_image
+        config = get_config
+        if config.key(:application) && config[:application].key :image
+            config[:application][:image]
+        else
+            nil
+        end
+    end
+
+
+    def self.forms_selector
+        config = get_config
+        if config.key(:forms) && config[:forms].key :amp_selector
+            config[:forms][:amp_selector]
+        else
+            false
+        end
+    end
+
+
+    def self.analytics_default_vendor
+        config = get_config
+        if config.key(:analytics) && config[:analytics].key :default_vendor
+            config[:analytics][:default_vendor]
+        else
+            nil
+        end
+    end
+
+    def self.google_analytics_account
+        config = get_config
+        if config.key(:analytics) && config[:analytics].key(:google_analytics) && config[:analytics][:google_analytics].key :account
+            config[:analytics][:google_analytics][:account]
+        else
+            nil
+        end
+    end
+
+
+    def self.ad_default_network
+        config = get_config
+        if config.key(:ad) && config[:ad].key :default_network
+            config[:ad][:default_network]
+        else
+            nil
+        end
+    end
+
+    def self.auto_ads_default_network
+        config = get_config
+        if config.key(:ad) && config[:ad].key(:auto_ads) && config[:ad][:auto_ads].key :default_network
+            config[:ad][:auto_ads][:default_network]
+        else
+            nil
+        end
+    end
+
+
+    def self.social_share_default_provider
+        config = get_config
+        if config.key(:social) && config[:social].key(:share) && config[:social][:share].key :default_provider
+            config[:social][:share][:default_provider]
+        else
+            nil
+        end
+    end
+    def self.social_share_default_data_share_endpoint
+        config = get_config
+        if config.key(:social) && config[:social].key(:share) && config[:social][:share].key :default_data_share_endpoint
+            config[:social][:share][:default_data_share_endpoint]
+        else
+            nil
+        end
+    end
+
+
+    private
+
+
+    def self.get_config
+        require 'yaml'
+
+        begin
+            YAML.load_file('config/amp-html.yml')
+        rescue Exception
+            warn 'WARNING (AMP): You need to run `rails g amp-html:bundle` first.'
+            exit
+        end
+    end
+
+end

data/lib/amp_html/configuration/help.rb

@@ -0,0 +1,11 @@
+module AmpHtml
+    module Configuration
+        class Help
+
+            def self.all
+                puts IO.read File.join AmpHtml.root, 'amp_html', 'configuration', 'docs', 'README.md'
+            end
+
+        end
+    end
+end

data/lib/amp_html/helpers/docs/README.md

@@ -0,0 +1,98 @@
+
+# AMP-HTML Helpers
+
+
+## About Helpers
+
+AMP-HTML helpers are an easy way to use AMP specific tags and features in your Ruby on Rails views.
+
+### Takes a block?
+
+Some helpers can "take a block", others cannot. If a helper can take a block, you can wrap it around of some other code-snippet:
+
+    <%= i_am_a_wrapper do %>
+        <%= i_am_inside_of_a_block %>
+    <% end %>
+
+### DeepIntegration Helpers
+
+DeepIntegration helpers are parts of a [DeepIntegration component](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs#deepintegration-components).
+
+### Availability of Helpers
+
+The availability of helpers summarizes whether a helper is included in the vanilla version of AMP-HTML or if it needs to be installed as a part of a [component](https://github.com/slooob/amp-html/tree/master/lib/amp-html/components/docs) in order to get used.
+
+---
+
+## Helpers Reference
+
+Take a look at the references of the helpers of AMP-HTML.
+
+### Built-in
+
+* [`amp_audio` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_audio.md)
+* [`amp_css`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_css.md)
+* [`amp_css_link` (in development)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_css_link.md)
+* [`amp_document_link` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_document_link.md)
+* [`amp_fallback` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_fallback.md)
+* [`amp_font_link` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_font_link.md)
+* [`amp_form_response` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_form_response.md)
+* [`amp_form` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_form.md)
+* [`amp_global_css` (deprecated)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_global_css.md)
+* [`amp_google_font` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_google_font.md)
+* [`amp_head`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_head.md)
+* [`amp_html_doctype`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_html_doctype.md)
+* [`amp_image` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_image.md)
+* [`amp_input` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_input.md)
+* [`amp_link` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_link.md)
+* [`amp_placeholder` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_placeholder.md)
+* [`amp_resources` (deprecated)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_resources.md)
+* [`amp_selector` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_selector.md)
+* [`amp_serviceworker` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_serviceworker.md)
+* [`amp_video` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_video.md)
+* [`amp?` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp.md)
+* [`audio_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/audio_tag.md)
+* [`canonical_document_link` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/canonical_document_link.md)
+* [`form_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/form_tag.md)
+* [`image_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/image_tag.md)
+* [`input_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/input_tag.md)
+* [`javascript_include_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/javascript_include_tag.md)
+* [`noscript_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/noscript_tag.md)
+* [`schema_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/schema_tag.md)
+* [`stylesheet_link_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/stylesheet_link_tag.md)
+* [`video_tag`](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/video_tag.md)
+
+### Installable
+
+* [`amp_ad` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_ad.md)
+* [`amp_analytics` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_analytics.md)
+* [`amp_anim` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_anim.md)
+* [`amp_auto_ads` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_auto_ads.md)
+* [`amp_close_user_notification_button` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_close_user_notification_button.md)
+* [`amp_custom_ad` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_custom_ad.md)
+* [`amp_embed` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_embed.md)
+* [`amp_facebook` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_facebook.md)
+* [`amp_font` (in development)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_font.md)
+* [`amp_gfycat` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_gfycat.md)
+* [`amp_google_analytics` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_google_analytics.md)
+* [`amp_iframe` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_iframe.md)
+* [`amp_instagram` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_instagram.md)
+* [`amp_js` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_js.md)
+* [`amp_list` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_list.md)
+* [`amp_live_list_items` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_live_list_items.md)
+* [`amp_live_list_pagination` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_live_list_pagination.md)
+* [`amp_live_list_update` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_live_list_update.md)
+* [`amp_live_list` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_live_list.md)
+* [`amp_mustache` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_mustache.md)
+* [`amp_pin_it` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pin_it.md)
+* [`amp_pin_widget` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pin_widget.md)
+* [`amp_pinterest_follow` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pinterest_follow.md)
+* [`amp_pixel` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_pixel.md)
+* [`amp_reddit` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_reddit.md)
+* [`amp_social_share` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_social_share.md)
+* [`amp_soundcloud` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_soundcloud.md)
+* [`amp_twitter` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_twitter.md)
+* [`amp_user_notification` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_user_notification.md)
+* [`amp_video_ad` (in development)](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_video_ad.md)
+* [`amp_vine` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_vine.md)
+* [`amp_youtube` BETA](https://github.com/slooob/amp-html/blob/master/lib/amp-html/helpers/docs/amp_youtube.md)