Merge pull request #4 from Magento/pubs2411-block

Pubs2411 Block and Page

Author: Shevtsov, Dmitry(dshevtsov)

_includes/mtf/block_attributes.md

@@ -0,0 +1,12 @@
+<div markdown="1">
+
+See the `block` node attributes details in the following table:
+
+|`block` attribute | Description | Is required|Values| Example|
+|---|---|---|---|---|
+|`name`| Name of the block| Required|Unique in the page. The method to get the block class instance is generated using this value.|`widgetGrid`|
+|`class`| Full name of the block class |Required| Class name |`Magento\Widget\Test\Block\Adminhtml\Widget\WidgetGrid` |
+|`locator`| CSS selector or XPath locator of the block|Required|[CSS Selectors](http://www.w3.org/TR/selectors/), <a href="http://www.w3.org/TR/xpath-31/">XPath</a>|CSS: `#widgetInstanceGrid`, XPath: `//*[@id="widgetInstanceGrid"]`|
+|`strategy` |Selector strategy| Required|`css selector` or `xpath`| `css selector`|
+
+</div>

_includes/mtf/page-generator.html

@@ -0,0 +1,3 @@
+<p>To apply all changes you've made to the page (XML file), run the page generator.</p>
+<pre><code>php &lt;magento2&gt;/dev/tests/functional/utils/page.php</code></pre>
+<p>The page will be updated in the <code>&lt;magento2&gt;/dev/tests/functional/generated</code> directory.</p>

_plugins/remote_markdown.rb

@@ -0,0 +1,46 @@
+# "THE BEER-WARE LICENSE" (Revision 42):
+# <[email protected]> wrote this file. As long as you retain this
+# notice you can do whatever you want with this stuff. If we meet some day, and
+# you think this stuff is worth it, you can buy me a beer in return.
+# Robin Hahling
+
+require 'net/http'
+
+module Jekyll
+  # Remotely fetch a markdown file.
+  class RemoteMarkdownTag < Liquid::Tag
+    def initialize(tag_name, text, tokens)
+      super
+
+      text.strip!
+      check_protocol(text)
+      uri = URI(text)
+
+      check_extension(uri.path)
+
+      res = Net::HTTP.get_response(uri)
+      fail 'resource unavailable' unless res.is_a?(Net::HTTPSuccess)
+
+      @content = res.body.force_encoding("UTF-8")
+    end
+
+    def render(_context)
+      @content
+    end
+
+    private
+
+    def check_protocol(text)
+      error_message = "remote_markdown: invalid URI given #{text}"
+      fail error_message unless text =~ URI.regexp(%w(http https ftp ftps))
+    end
+
+    def check_extension(path)
+      mdexts = %w(.markdown .mkdown .mkdn .mkd .md .xml)
+      error_message = "remote_markdown: URI file extension not in #{mdexts}"
+      fail error_message unless mdexts.include?(File.extname(path))
+    end
+  end
+end
+
+Liquid::Template.register_tag('remote_markdown', Jekyll::RemoteMarkdownTag)