article_json 0.3.7 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2820900cbe5eeba0352a764674bf7dbc1a5a1d2353c0fe5fcacea19799891378
-  data.tar.gz: 95c0cba7f4896556710fa621ea07576979b98ec62b7975e5ef330883f66b98b1
+  metadata.gz: 561ba1f1fff25cba3e32eea10bdff57757ab6776a688bc78f85ec4eafeb62b32
+  data.tar.gz: e72e2425f7008d24be098be9024a27f493c2f13c99577ec71d7dda953564bcef
 SHA512:
-  metadata.gz: 0bd444a45513d39b0499188b7ade246cfde9e215df63b9652dc16435bde2570c51a4ed9cb5124c24a0848b63df3eacd3a2538bcb8ba5829b96b4afc7e5f93ff7
-  data.tar.gz: 4effc300873b4203bbc4e9594cc49ae871275e3d5c0e92940b10fad380e7c06acd1b42b14b869d00f28385102bb2c7646eca0424f4e9ca4957c7796fa497aaa1
+  metadata.gz: 14e75d7a01ad409337b79b98075063807de0d18dd911980c7ef816668ddf4adc6f02211fb36ed54a530962bf0839628b217cfd6c849ff6153575c9e9274500b2
+  data.tar.gz: a2a1eac1de2d0d8b0379c1d1bbc85a7af99e33c44ebdc544d88de7983597be878e59c9bc90a2a1a4958b4dcb1ea26d4bc5817fb6944e04e02224d1af8fd52353

data/CHANGELOG.md

@@ -1,4 +1,35 @@
 # Changelog
+## 0.4.0 - 2024/01/17
+In this fourth release we **added support for Apple News**:
+**New**:
+Support for Apple News Format, specifically the following elements:
+- text
+- text boxes
+- lists
+- pull quotes
+- image
+- embed objects (posts from X etc.)
+- image captions for images and embed objects
+- video
+Support for Ruby 3.2
+
+**Removes**:
+Support for Ruby 2.3
+
+**Refactoring**:
+- Rubocop autocorrections
+
+**Fix:**
+- Fix failing rspec tests
+
+
+## 0.3.8 - 2020/7/31
+- **Improvements:**
+- Add a script to update oembed stubs fixtures.
+- Support for `alt` attribute in images.
+
+- **Fix:** Fix a bug when using the `[image-link-to: ]` tag.
+
 ## 0.3.7 - 2019/8/21
 - **Fix:** Only use https for soundcloud oembed api
 

data/README.md

@@ -1,10 +1,25 @@
 # article_json
-JSON Format for News Articles & Ruby Gem.
+The `article_json` gem is a Ruby library designed to simplify the conversion and manipulation of structured articles in various formats, allowing easy importing, manipulation and export of content across different platforms and environments.
+
+It takes an article from a Google Doc and creates a JSON version of it.
+
+From there it can export the article:
+- as HTML
+- as AMP
+- as Apple News Format (ANF)
+- as Facebook Instant Article HTML
+- as plain text
+- as JSON
+
+It also provides functionalities to parse content from Google Document HTML exports and initialize articles from JSON strings or already parsed JSON.
+
+---
 
 ## Status
 [![Gem Version](https://badge.fury.io/rb/article_json.svg)](https://badge.fury.io/rb/article_json)
-[![Build Status](https://travis-ci.org/Devex/article_json.svg)](https://travis-ci.org/Devex/article_json)
-[![Code Climate](https://codeclimate.com/github/Devex/article_json/badges/gpa.svg)](https://codeclimate.com/github/Devex/article_json)
+[![Check Google Doc](https://github.com/Devex/article_json/workflows/Check%20Google%20Doc/badge.svg)](https://github.com/Devex/article_json/actions/workflows/check-google-doc.yml)
+[![RSpec](https://github.com/Devex/article_json/workflows/rspec/badge.svg)](https://github.com/Devex/article_json/actions/workflows/rspec.yml)
+[![Code Climate](https://codeclimate.com/github/Devex/article_json/badges/gpa.svg)](https://codeclimate.com/github/Devex/article_json?event=push)
 [![Coverage Status](https://coveralls.io/repos/github/Devex/article_json/badge.svg?branch=master)](https://coveralls.io/github/Devex/article_json?branch=master)
 
 ## Usage
@@ -32,6 +47,9 @@ puts article.to_amp
 # get javascript libraries needed for the AMP article
 puts article.amp_exporter.amp_libraries
 
+# export article as Apple News Format (ANF)
+puts article.to_apple_news
+
 # export article as Facebook Instant Article HTML
 puts article.to_facebook_instant_article
 
@@ -43,20 +61,47 @@ puts article.to_json
 ```
 
 ### CLI
-To load, parse and html-export the latest version of the reference document,
-run the following:
+To load, parse and export the latest (amp/ apple news/ facebook/ html) version of the reference document, run the following:
 
-```
+```bash
 $ export DOC_ID=1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8
 $ ./bin/article_json_export_google_doc.rb $DOC_ID \
     | ./bin/article_json_parse_google_doc.rb \
     | ./bin/article_json_export_html.rb
+    ## OR
+    # | ./bin/article_json_export_amp.rb
+    # | ./bin/article_json_export_apple_news.rb
+    # | ./bin/article_json_export_facebook.rb
+    # | ./bin/article_json_export_plain_text.rb
+```
+
+Alternatively, you can concatenate your command line commands, like so:
+```bash
+$ ./bin/article_json_export_google_doc.rb $DOC_ID > test_ref_doc.html
+$ cat test_ref_doc.html | bin/article_json_parse_google_doc.rb > \
+    test_ref_doc_parsed_apple.json
+$ cat test_ref_doc_parsed_apple.json | bin/article_json_export_apple_news.rb > \
+    test_ref_doc_exported_apple.json
+```
+
+You can also update _all_ the different exported versions of the reference document _(amp, apple_news, facebook, google_doc, html and plain_text)_ by running the following command:
+
+```
+$ ./bin/update_reference_document.sh
+```
+
+When running the tests, we use some fixtures to mock the responses for oembed requests, but these may change over time.
+
+To update them, run:
+
+```
+$ ./bin/update_oembed_request-stubs.sh
 ```
 
 ### Configuration
-There are some configuration options that allow a more tailored usage of the
-`article_json` gem. The following code snippet gives an example for every
-available setting: 
+Some configuration options allow a more tailored usage of the `article_json` gem.
+
+The following code snippet gives an example for every available setting:
 
 ```ruby
 ArticleJSON.configure do |config|
@@ -69,48 +114,63 @@ ArticleJSON.configure do |config|
     :html,
     advertisement: ArticleJSON::Export::HTML::Elements::Advertisement
   )
-  
+
   # You can also overwrite existing exporters:
   config.register_element_exporters(
     :html,
     image: ArticleJSON::Export::HTML::Elements::ScaledImage
   )
-  
+
   # And you can define multiple custom exporters:
   config.register_element_exporters(
     :html,
     advertisement: ArticleJSON::Export::HTML::Elements::Advertisement,
     image: ArticleJSON::Export::HTML::Elements::ScaledImage
   )
-  
-  # It works the same way for custom AMP, FacebookInstantArticle, or 
-  # PlainText exporters:
+
+  # It works the same way for custom AMP, FacebookInstantArticle, or PlainText
+  # exporters:
   config.register_element_exporters(
     :amp, # Or change this for `:facebook_instant_article` or `:plain_text`
     image: ArticleJSON::Export::AMP::Elements::ScaledImage
-  ) 
+  )
+end
+```
+
+### Facebook Oembed
+Facebook deprecated its public endpoints for embeddable Facebook content in 2020 (See https://developers.facebook.com/docs/plugins/oembed-legacy for more info).
+
+You now need to use a Facebook token to access the new oembed endpoints. You can configure the gem to use this token so:
+
+``` ruby
+ArticleJSON.configure do |config|
+  # 'token' being the combination of the app-id and the access token joined
+  # with the pipe symbol (`|`)
+  config.facebook_token = 'token'
 end
-``` 
+```
+
+Find more info about the access token [here](https://developers.facebook.com/docs/plugins/oembed#access-tokens).
 
 ## Format
-A full example of the format can be found in the test fixtures:
-[Parsed Reference Document](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_parsed.json)
+A [full example of the format](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_parsed.json) can be found in the test fixtures.
 
 ## Import
 ### Google Document Parser
-This [Reference Document](https://docs.google.com/document/d/1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8/edit?usp=sharing)
-lists contains all supported formatting along with some descriptions.
+This [reference document](https://docs.google.com/document/d/1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8/editusp=sharing) contains all the supported formatting along with some descriptions.
 
 ## Add custom elements
-Sometimes you might want to place additional elements into the article, like e.g. advertisements. 
-`article_json` supports this via `article.place_additional_elements` which accepts an array of elements that you can define in your own code. 
-Each element that is added this way will directly get placed in between paragraphs of the article.
-The method ensures that an additional element is never added before or after any node other than paragraphs (e.g. an image).
-The elements are added in the order you pass them into the method.
-If the article should not have enough spaces to place all the provided elements, they will be placed after the last element in the article.
-
-You can pass any type of element into this method. 
-If the objects you pass in are instances of elements defined within this gem (e.g. `ArticleJSON::Elements::Image`), you won't have to do anything else to get them rendered.
+Sometimes you might want to place additional elements into the article, like e.g. advertisements. `article_json` supports this via `article.place_additional_elements`, which accepts an array of elements that you can define in your code.
+
+Each element that is added this way will directly get placed in between paragraphs of the article. The method ensures that an additional element is never added before or after any node other than paragraphs (e.g. an image). The elements are added in the order you pass them into the method.
+
+If the article does not have enough space to place all the provided elements, they will be placed after the last
+element in the article.
+
+You can pass any type of element into this method.
+
+If the objects you pass in are instances of elements defined within this gem (e.g. `ArticleJSON::Elements::Image`), you won't have to do anything else to render them.
+
 If you pass in an instance of a custom class (e.g. `MyAdvertisement`), make sure to register an exporter for this type (check the _Configuration_ section for more details).
 
 Example using only existing elements:
@@ -119,45 +179,45 @@ Example using only existing elements:
 article = ArticleJSON::Article.from_hash(parsed_json)
 
 # Within your code, create additional elements you would like to add
-image_advertisement = 
-  ArticleJSON::Elements::Image.new(source_url: 'https://robohash.org/great-ad', 
+image_advertisement =
+  ArticleJSON::Elements::Image.new(source_url: 'https://robohash.org/great-ad',
                                    caption: ArticleJSON::Elements::Text.new(
                                     content: 'Buy more robots!',
                                     href: '/robot-sale'
                                    ))
-text_box_similar_articles = 
+text_box_similar_articles =
   ArticleJSON::Elements::TextBox.new(content: [
-    ArticleJSON::Elements::Heading.new(level: 3, content: 'Read more...'),  
+    ArticleJSON::Elements::Heading.new(level: 3, content: 'Read more...'),
     ArticleJSON::Elements::List.new(content: [
       ArticleJSON::Elements::Paragraph(content: [
-        ArticleJSON::Elements::Text.new(content: 'Very similar article', 
+        ArticleJSON::Elements::Text.new(content: 'Very similar article',
                                         href: '/news/123'),
       ]),
       ArticleJSON::Elements::Paragraph(content: [
-        ArticleJSON::Elements::Text.new(content: 'Great article!', 
+        ArticleJSON::Elements::Text.new(content: 'Great article!',
                                         href: '/news/42'),
       ]),
-    ]),  
+    ]),
   ])
 
 # Add these elements to the article
-article.place_additional_elements([image_advertisement, 
+article.place_additional_elements([image_advertisement,
                                    text_box_similar_articles])
-               
-# Export the article to the different formats as you would normally do                    
+
+# Export the article to the different formats as you would normally do
 article.to_html # this will now include the custom elements
-``` 
+```
 
 Example with custom advertisement elements:
 ```ruby
 # Define your custom element class
 class MyAdvertisement
   attr_reader :url
-  
+
   def initialize(url:)
     @url = url
   end
-  
+
   def type
     :my_advertisement
   end
@@ -165,9 +225,9 @@ end
 
 # Define an exporter for your class, we only use HTML in this example but this
 # would work similarly for AMP or other formats
-class MyAdvertisementExporter < 
-  ArticleJSON::Export::HTML::Elements::Base 
-  
+class MyAdvertisementExporter <
+  ArticleJSON::Export::HTML::Elements::Base
+
   # Needs to implement the `#export` method
   def export
     create_element(:iframe, src: @element.url)
@@ -194,35 +254,26 @@ article.to_html
 
 ## Export
 ### HTML
-The HTML exporter generates a HTML string for a list of elements. An example of
-the HTML export for the parsed reference document can be found 
-[here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.html).
+The HTML exporter generates an HTML string for a list of elements. An example of the HTML export for the parsed reference document can be found [here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.html).
 
 ### AMP
-The AMP exporter generates an AMP HTML representation of the elements. 
+The AMP exporter generates an AMP HTML representation of the elements.
 
 AMP uses [custom HTML tags](https://www.ampproject.org/docs/reference/components), some of which require additional Javascript libraries.
-If you have an `article` (see code example in _Usage_ section), you can get a list of the custom tags required by this article by calling `article.amp_exporter.custom_element_tags` and by calling `article.amp_exporter.amp_libraries` you get a list of `<script>` tags that can directly be included on your page to render the AMP article. 
 
-An example of
-the AMP HTML export for the parsed reference document can be found 
-[here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.amp.html).
+If you have an `article` (see code example in _Usage_ section), you can get a list of the custom tags required by this article by calling `article.amp_exporter.custom_element_tags` and calling `article.amp_exporter.amp_libraries` gives a list of `<script>` tags that can directly be included on your page to render the AMP article.
+
+An example of the AMP HTML export for the parsed reference document can be found [here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.amp.html).
 
 ### Facebook Instant Articles
-The `FacebookInstantArticle` exporter generates a custom HTML string for a list
-of elements. An example of the Facebook Instant Article export for the parsed
-reference document can be found 
-[here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.html).
+The `FacebookInstantArticle` exporter generates a custom HTML string for a list of elements. An example of the Facebook Instant Article export for the parsed reference document can be found [here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.html).
 
-To learn more about the Facebook Instant Article HTML format see have a look at
-the [Facebook Developer Documentation](https://developers.facebook.com/docs/instant-articles/guides/format-overview).
+To learn more about the Facebook Instant Article HTML format see have a look at the [Facebook Developer Documentation](https://developers.facebook.com/docs/instant-articles/guides/format-overview).
 
 ### Plain Text
-As the name suggests, this exporter generates a plain text version of the article.
-Rich text elements like images, embeds or even text boxes are not being rendered.
+As the name suggests, this exporter generates a plain text version of the article. Rich text elements like images, embeds or even text boxes are not being rendered.
 
-The reference document rendered as plain text can be found
-[here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.txt).
+The reference document rendered as plain text can be found [here](https://github.com/Devex/article_json/blob/master/spec/fixtures/reference_document_exported.txt).
 
 Usage:
 ```ruby
@@ -230,22 +281,22 @@ Usage:
 article = ArticleJSON::Article.from_hash(parsed_json)
 
 # Then simply call `#to_plain_text` on it
-article.to_plain_text 
+article.to_plain_text
 ```
 
 ## Contributing
 - Fork this repository
-- Implement your feature or fix including Tests
+- Implement your feature or fix including tests
 - Update the [change log](CHANGELOG.md)
 - Commit your changes with a meaningful commit message
 - Create a pull request
 
 Thank you!
 
-See the 
+See the
 [list of contributors](https://github.com/Devex/article_json/contributors).
 
-### Tests
+## Tests
 For the whole test suite, run `bundle exec rspec`.
 
 For individual tests, run `bundle exec rspec spec/article_json/version_spec.rb`.

data/bin/article_json_export_amp.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to AMP.
+#
+# Usage:
+#
+#   ./bin/article_json_export_amp.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require 'bundler/setup'
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_amp

data/bin/article_json_export_apple_news.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to Apple News.
+#
+# Usage:
+#
+#   ./bin/article_json_export_apple_news.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require 'bundler/setup'
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_apple_news

data/bin/article_json_export_facebook.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to Facebook Instant
+# Article.
+#
+# Usage:
+#
+#   ./bin/article_json_export_facebook.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require 'bundler/setup'
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_facebook_instant_article

data/bin/article_json_export_html.rb

@@ -10,5 +10,6 @@
 #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
+require 'bundler/setup'
 require_relative '../lib/article_json'
 puts ArticleJSON::Article.from_json(ARGF.read).to_html

data/bin/article_json_export_plain_text.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to plain text.
+#
+# Usage:
+#
+#   ./bin/article_json_export_plain_text.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require 'bundler/setup'
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_plain_text

data/bin/article_json_parse_google_doc.rb

@@ -10,5 +10,6 @@
 #
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
+require 'bundler/setup'
 require_relative '../lib/article_json'
 puts ArticleJSON::Article.from_google_doc_html((ARGF.read)).to_json

data/bin/check_google_doc_export.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Script to check that google doc export works as expected.
+#
+# Usage:
+#
+#   ./bin/check_google_doc_export.rb
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require 'bundler/setup'
+require 'net/http'
+require 'uri'
+require_relative '../lib/article_json'
+
+doc_id = '1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8'
+url =
+  "https://docs.google.com/feeds/download/documents/export/Export?id=#{doc_id}&exportFormat=html"
+parsed_exported_doc = JSON.parse(
+  ArticleJSON::Article
+    .from_google_doc_html(Net::HTTP.get(URI.parse(url)))
+    .to_json
+)
+parsed_expected_doc = JSON.parse(File.read('spec/fixtures/reference_document_parsed.json'))
+
+# `source_url` (for hosted images) is dynamic, so we need to remove it from the comparison`
+def nullify_source_url(hash)
+  hash['content'].each { |element| element['source_url'] = nil if element['source_url'] }
+  hash
+end
+
+parsed_exported_doc = nullify_source_url(parsed_exported_doc)
+parsed_expected_doc = nullify_source_url(parsed_expected_doc)
+
+if parsed_exported_doc != parsed_expected_doc
+  raise StandardError, "Google doc export doesn't work as expected"
+end
+
+puts 'Google doc export worked as expected'

data/bin/update_oembed_request-stubs.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+
+curl -X GET "https://vimeo.com/api/oembed.json?url=https://vimeo.com/42315417" | jq > spec/fixtures/vimeo_video_oembed.json
+
+curl -X GET "https://www.youtube.com/oembed?format=json&url=https://www.youtube.com/watch?v=_ZG8HBuDjgc" | jq > spec/fixtures/youtube_video_oembed.json
+
+curl -X GET "https://www.slideshare.net/api/oembed/2?format=json&url=https://www.slideshare.net/Devex/the-best-global-development-quotes-of-2012" |  jq > spec/fixtures/slideshare_oembed.json
+
+curl -X GET "https://api.twitter.com/1/statuses/oembed.json?align=center&url=https://twitter.com/d3v3x/status/554608639030599681" | jq > spec/fixtures/tweet_oembed.json
+
+curl -X GET 'https://soundcloud.com/oembed?format=json&url=https://soundcloud.com/rich-the-kid/plug-walk-1' | jq > spec/fixtures/soundcloud_oembed.json

data/bin/update_reference_document.sh

@@ -7,6 +7,10 @@ DOC_ID="1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8"
 SOURCE_HTML_FILE="spec/fixtures/reference_document.html"
 JSON_FILE="spec/fixtures/reference_document_parsed.json"
 HTML_EXPORT_FILE="spec/fixtures/reference_document_exported.html"
+AMP_EXPORT_FILE="spec/fixtures/reference_document_exported.amp.html"
+FACEBOOK_EXPORT_FILE="spec/fixtures/reference_document_exported.facebook.html"
+APPLE_NEWS_EXPORT_FILE="spec/fixtures/reference_document_exported.apple_news.json"
+PLAIN_TEXT_EXPORT_FILE="spec/fixtures/reference_document_exported.txt"
 
 # export the google doc to HTML
 ./bin/article_json_export_google_doc.rb ${DOC_ID} > ${SOURCE_HTML_FILE}
@@ -16,3 +20,15 @@ HTML_EXPORT_FILE="spec/fixtures/reference_document_exported.html"
 
 # convert the JSON export to HTML
 ./bin/article_json_export_html.rb < ${JSON_FILE} > ${HTML_EXPORT_FILE}
+
+# convert the JSON export to AMP
+./bin/article_json_export_amp.rb < ${JSON_FILE} > ${AMP_EXPORT_FILE}
+
+# convert the JSON export to Facebook Instant Article
+./bin/article_json_export_facebook.rb < ${JSON_FILE} > ${FACEBOOK_EXPORT_FILE}
+
+# convert the JSON export to Apple News
+./bin/article_json_export_apple_news.rb < ${JSON_FILE} > ${APPLE_NEWS_EXPORT_FILE}
+
+# convert the JSON export to plain text
+./bin/article_json_export_plain_text.rb < ${JSON_FILE} > ${PLAIN_TEXT_EXPORT_FILE}

data/lib/article_json/article.rb

@@ -14,7 +14,7 @@ module ArticleJSON
     def elements
       @elements ||= begin
         if @additional_elements.any?
-          ArticleJSON::Utils::AdditionalElementPlacer
+          @additional_element_placer_class
             .new(@article_elements, @additional_elements)
             .merge_elements
         else
@@ -62,6 +62,18 @@ module ArticleJSON
       amp_exporter.html
     end
 
+    # Exporter instance for AppleNews
+    # @return [ArticleJSON::Export::AppleNews::Exporter]
+    def apple_news_exporter
+      ArticleJSON::Export::AppleNews::Exporter.new(elements)
+    end
+
+    # AppleNews export of the article
+    # @return [String]
+    def to_apple_news
+      apple_news_exporter.to_json
+    end
+
     # Exporter instance for FacebookInstantArticle
     # @return [ArticleJSON::Export::FacebookInstantArticle::Exporter]
     def facebook_instant_article_exporter
@@ -91,10 +103,18 @@ module ArticleJSON
     # article. If the method is called multiple times, the order of additional
     # elements is maintained.
     # @param [Object] additional_elements
-    def place_additional_elements(additional_elements)
+    # @param [Class<#merge_elements>] with - The passes class's `#initialize` method needs
+    #                                        to accept two lists of elements. See
+    #                                        `ArticleJSON::Utils::AdditionalElementPlacer`
+    #                                        for reference.
+    def place_additional_elements(
+      additional_elements,
+      with: ArticleJSON::Utils::AdditionalElementPlacer
+    )
       # Reset the `#elements` method memoization
       @elements = nil
       @additional_elements.concat(additional_elements)
+      @additional_element_placer_class = with
     end
 
     class << self

data/lib/article_json/configuration.rb

@@ -14,10 +14,11 @@ module ArticleJSON
   end
 
   class Configuration
-    attr_accessor :oembed_user_agent
+    attr_accessor :oembed_user_agent, :facebook_token
 
     def initialize
       @oembed_user_agent = nil
+      @facebook_token = nil
       @custom_element_exporters = {}
     end
 

data/lib/article_json/elements/base.rb

@@ -37,4 +37,3 @@ module ArticleJSON
     end
   end
 end
-

data/lib/article_json/elements/image.rb

@@ -1,18 +1,20 @@
 module ArticleJSON
   module Elements
     class Image < Base
-      attr_reader :source_url, :caption, :float, :href
+      attr_reader :source_url, :caption, :float, :href, :alt
 
       # @param [String] source_url
       # @param [Array[ArticleJSON::Elements::Text]] caption
       # @param [Symbol] float
       # @param [String] href
-      def initialize(source_url:, caption:, float: nil, href: nil)
+      # @param [String] alt
+      def initialize(source_url:, caption:, float: nil, href: nil, alt: nil)
         @type = :image
         @source_url = source_url
         @caption = caption
         @float = float
         @href = href
+        @alt = alt
       end
 
       # Hash representation of this image element
@@ -24,6 +26,7 @@ module ArticleJSON
           float: float,
           caption: caption.map(&:to_h),
           href: href,
+          alt: alt,
         }
       end
 
@@ -35,7 +38,8 @@ module ArticleJSON
             source_url: hash[:source_url],
             caption: parse_hash_list(hash[:caption]),
             float: hash[:float]&.to_sym,
-            href: hash[:href]
+            href: hash[:href],
+            alt: hash[:alt]
           )
         end
       end

data/lib/article_json/export/amp/elements/embed.rb

@@ -69,7 +69,7 @@ module ArticleJSON
 
           # @return [Nokogiri::XML::Element]
           def facebook_node
-            url = "#{@element.oembed_data[:author_url]}videos/#{@element.embed_id}"
+            url = "#{@element.oembed_data[:author_url]}/videos/#{@element.embed_id}"
             create_element('amp-facebook',
                            'data-embedded-as' => 'video',
                            'data-href' => url,