kramdown-prismic 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6b30034b89cbc5bbfe5613435382d48f332000ac
-  data.tar.gz: d546c799b441b0c7802221f668da8b573d48f9be
+SHA256:
+  metadata.gz: bb835641c9e7f2e9e600e0307e3bfd6e9eb46e5d83ae257c505c659c20865931
+  data.tar.gz: cba5da2b2d81fff052b24d7921872ec8e9607b726bdbe210ff516b6cf7b6810a
 SHA512:
-  metadata.gz: 31b0d991eb6a2dedb3b7ad156bdf0782437fe59049b4a5444ec48f4fb269504d203ed5fcfdc79e8c77eaef73462dff4e9e85ad4f5abaf03fd84848a5f2adc012
-  data.tar.gz: 56cb4219036f891f893dc12e1ec1e98d0bb1f80bee1ae7168c8b780644e049273f894e278cb6771f76ec327fd0b5797b5a6dc2f72c46dbec776972e30d79cf2d
+  metadata.gz: 9b4e02f18a5dbf5c51f46cc729c8dd2018d1eec8809790e0492ee22f7886627e5bc77d20dabde755f44883f1c062cd7a7dda33ba8acbe9c4dac165218f23ca70
+  data.tar.gz: 5428075b5c8eac073a1729feac6803a378ac55ba330540c46c230f78b5e965caeb95b26ea60be9f059611d182cb0f6c764c2817f9b03c53b1dcde03ec923d86b

data/.github/workflows/ci.yml

@@ -0,0 +1,18 @@
+name: CI
+
+on: [push, pull_request]
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        ruby: [2.5, 2.6, 2.7]
+    runs-on: ${{ matrix.os }}
+    steps:
+    - uses: actions/checkout@v2
+    - uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+        bundler-cache: true
+    - run: bundle exec rake test

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.2
+  - 2.3
+  - 2.4
+script: bundle exec rake test

data/Changelog.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## Version 0.2.1
+
+- Parse embed elements
+- Convert inline code
+
+## Version 0.2.0
+
+- Add parser to convert prismic to markdown
+
+## Version 0.1.2
+
+- fix output with empty paragraph
+
+## Version 0.1.1
+
+- Fix json of the image
+
+## Version 0.1.0
+
+- Initial version

data/Gemfile.lock

@@ -1,13 +1,13 @@
 PATH
   remote: .
   specs:
-    kramdown-prismic (0.1.0)
+    kramdown-prismic (0.2.1)
       kramdown (~> 1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    kramdown (1.15.0)
+    kramdown (1.17.0)
     minitest (5.10.3)
     rake (12.2.1)
 
@@ -20,4 +20,4 @@ DEPENDENCIES
   rake (~> 12.0)
 
 BUNDLED WITH
-   1.14.6
+   1.17.2

data/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2017 Stormz
+Copyright (c) 2021 François de Metz
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,19 +1,94 @@
 # Kramdown Prismic
 
-A Kramdown converter to convert documents into prismic rich text format.
+A [Kramdown][] parser and converter to convert documents into [prismic][] rich text format and back.
+
+A useful usage is to convert markdown documents to prismic for import purpose. Then you can even convert prismic format back to markdown.
 
 ## Status
 
-Most of the content is translated. See the table below to see the difference:
+The converter part (kramdown to prismic) is working and fairly complete. See *Difference between markdown and rich text* below to know more about limitations.
+
+The parser part is quite new and not feature complete (missing list item for instance).
+
+## Install
+
+```ruby
+gem 'kramdown-prismic', '~> 0.1'
+```
+
+## Usage
+
+**Convert kramdown documents to Prismic**
+
+```ruby
+require 'kramdown-prismic'
+
+kramdown = '# Hello world'
+Kramdown::Document.new(kramdown).to_prismic
+```
+
+**Convert markdown documents to Prismic**
+
+```ruby
+require 'kramdown-prismic'
+
+markdown = '# Hello world'
+Kramdown::Document.new(markdown, input: :markdown).to_prismic
+```
+
+**Convert HTML documents to Prismic**
+
+```ruby
+require 'kramdown-prismic'
+
+html = '<h1>Hello world</h1>'
+Kramdown::Document.new(html, input: :html).to_prismic
+```
+
+**Convert Prismic to markdown**
+
+```ruby
+require 'kramdown-prismic'
+prismic = [
+  {
+    type: "heading1",
+    content: {
+      text: "This is the document title",
+      spans: []
+    }
+  }
+]
+Kramdown::Document.new(prismic, input: :prismic).to_kramdown
+```
+
+### Lookup for warnings
+
+If there is some elements that cannot be converted (see the status table), a warning will be emitted.
+
+For instance, html elements in the markdown is not supported:
+
+```ruby
+require 'kramdown-prismic'
+
+markdown = '<h1>Hello world</h1>'
+result = Kramdown::Document.new(markdown, input: :markdown)
+result.to_prismic
+p result.warnings
+```
 
 ### Difference between markdown and rich text
 
+Some elements cannot be converted, due to some Prismic limitations. The table below explain the difference and limitations of the current converter:
+
 | Markdown         | Prismic                    |
 |------------------|----------------------------|
-| Blockquote       | translated to preformatted |
+| blockquote       | converted to preformatted  |
 | hr               | nothing                    |
 | img              | moved to the top level     |
 | nested list      | moved to the top level     |
+| entity           | converted to unicode       |
+| typographic_sym  | converted to unicode       |
+| smart_quote      | converted to unicode       |
 | dl               | not supported              |
 | dt               | not supported              |
 | dd               | not supported              |
@@ -25,9 +100,6 @@ Most of the content is translated. See the table below to see the difference:
 | td               | not supported              |
 | math             | not supported              |
 | footnote         | not supported              |
-| entity           | Transformed to unicode     |
-| typographic_sym  | Transformed to unicode     |
-| smart_quote      | Transformed to unicode     |
 | abbreviation     | not supported              |
 | html_element     | not supported              |
 | xml_comment      | not supported              |
@@ -35,20 +107,19 @@ Most of the content is translated. See the table below to see the difference:
 | comment          | not supported              |
 | raw              | not supported              |
 
-## Install
+## Develop
 
-```ruby
-gem 'kramdown-prismic', '~> 0.1'
-```
+Install dependencies:
 
-## Usage
+    bundle install
 
-```ruby
-require 'kramdown-prismic'
+Run tests:
 
-Kramdown::Document.new(markdown).to_prismic
-```
+    bundle exec rake test
 
 ## License
 
 MIT
+
+[Kramdown]: https://kramdown.gettalong.org/
+[prismic]: https://prismic.io/

data/lib/kramdown-prismic.rb

@@ -1,4 +1,5 @@
 require 'kramdown'
 
+require 'kramdown/parser/prismic'
 require 'kramdown/converter/prismic'
 require 'kramdown-prismic/version'

data/lib/kramdown-prismic/version.rb

@@ -1,3 +1,3 @@
 module KramdownPrismic
-  VERSION = "0.1.0"
+  VERSION = "0.2.1"
 end

data/lib/kramdown/converter/prismic.rb

@@ -59,6 +59,7 @@ module Kramdown
       end
 
       def convert_p(element)
+        return nil if element.children.size == 0
         {
           type: "paragraph",
           content: extract_content(element)
@@ -114,7 +115,9 @@ module Kramdown
             spans: []
           },
           data: {
-            url: element.attr["src"],
+            origin: {
+              url: element.attr["src"]
+            },
             alt: element.attr["alt"]
           }
         }
@@ -209,6 +212,11 @@ module Kramdown
         memo[:text] += "\n"
       end
 
+      def extract_span_codespan(element, memo)
+        warning('translating inline code is not supported')
+        memo[:text] += element.value
+      end
+
       def extract_span_html_element(element, memo)
         warning('translating html elements is not supported')
       end

data/lib/kramdown/parser/prismic.rb

@@ -0,0 +1,101 @@
+module Kramdown
+  module Parser
+    class Prismic < Base
+      def parse
+        @root.options[:encoding] = 'UTF-8'
+        @root.children = @source.map do |block|
+          type = block[:type]
+          if type.match(/heading/)
+            type = 'heading'
+          end
+          element = send("parse_#{type}", block)
+          parse_spans(element, block)
+          element
+        end
+      end
+
+      private
+
+      def parse_heading(block)
+        level = block[:type].match(/heading([1-6])/)[1].to_i
+        Kramdown::Element.new(:header, nil, nil, {level: level, raw_text: ''})
+      end
+
+      def parse_paragraph(block)
+        Kramdown::Element.new(:p)
+      end
+
+      def parse_image(block)
+        p = Kramdown::Element.new(:p)
+        img = Kramdown::Element.new(:img, nil, {"src" => block[:data][:origin][:url], "alt" => block[:data][:alt]})
+        p.children << img
+        p
+      end
+
+      def parse_preformatted(block)
+        Kramdown::Element.new(:blockquote)
+      end
+
+      def parse_embed(block)
+        Kramdown::Element.new(:html_element, 'iframe', { src: block[:data][:embed_url] })
+      end
+
+      def parse_spans(element, block)
+        stack = []
+
+        (block[:content][:text].size + 1).times do |index|
+
+          starting_spans = find_starting_spans_for(block, index)
+          ending_spans   = find_ending_spans_for(block, index)
+
+          ending_spans.each do |ending_span|
+            el = stack.pop
+            if stack.empty?
+              element.children << el
+            else
+              stack[-1].children << el
+            end
+          end
+          starting_spans.each do |starting_span|
+            stack << if starting_span[:type] == "hyperlink"
+              Element.new(:a, nil, {'href' => starting_span[:data][:url]})
+            else
+              Element.new(starting_span[:type].to_sym)
+            end
+          end
+
+          char = block[:content][:text][index]
+          next if char.nil?
+          current_text = if stack.empty?
+            element.children.last
+          else
+            stack[-1].children.last
+          end
+          if current_text.nil? || current_text.type != :text
+            current_text = Element.new(:text, "")
+            if stack.empty?
+              element.children << current_text
+            else
+              stack[-1].children << current_text
+            end
+          end
+          current_text.value += char
+        end
+      end
+
+      def find_starting_spans_for(block, index)
+        block[:content][:spans].find_all do |span|
+          span[:start] == index
+        end.sort_by do |span|
+          -span[:end]
+        end
+      end
+
+      def find_ending_spans_for(block, index)
+        block[:content][:spans].find_all do |span|
+          span[:end] == index
+        end
+      end
+    end
+  end
+end

data/test/{kramdown-prismic_test.rb → converter_test.rb}

@@ -1,32 +1,35 @@
+# coding: utf-8
 require 'minitest/autorun'
 require 'kramdown-prismic'
 
-class KramdownPrismicTest < Minitest::Test
-  def test_convert_heading
-    expected = [
-      {
-        type: "heading1",
-        content: {
-          text: "This is the document title",
-          spans: []
+class KramdownPrismicConverterTest < Minitest::Test
+  6.times do |heading|
+    define_method "test_convert_heading_#{heading}" do
+      expected = [
+        {
+          type: "heading#{heading + 1}",
+          content: {
+            text: "This is the document title",
+            spans: []
+          }
         }
-      }
-    ]
-    markdown = "# This is the document title"
-    assert_equal expected, Kramdown::Document.new(markdown, input: :markdown).to_prismic
+      ]
+      markdown = "#{"#" * (heading + 1)} This is the document title"
+      assert_equal expected, Kramdown::Document.new(markdown, input: :kramdown).to_prismic
+    end
   end
 
-  def test_convert_heading2
+  def test_convert_heading7
     expected = [
       {
-        type: "heading2",
+        type: "heading6",
         content: {
-          text: "This is a document title",
+          text: "# This is the document title",
           spans: []
         }
       }
     ]
-    markdown = "## This is a document title"
+    markdown = "####### This is the document title"
     assert_equal expected, Kramdown::Document.new(markdown, input: :markdown).to_prismic
   end
 
@@ -309,13 +312,6 @@ class KramdownPrismicTest < Minitest::Test
 
   def test_convert_img
     expected = [
-      {
-        type: "paragraph",
-        content: {
-          text: "",
-          spans: []
-        }
-      },
       {
         type: "image",
         content: {
@@ -323,7 +319,9 @@ class KramdownPrismicTest < Minitest::Test
           spans: []
         },
         data: {
-          url: '/img.png',
+          origin: {
+            url: '/img.png'
+          },
           alt: 'alt text'
         }
       }
@@ -336,13 +334,6 @@ class KramdownPrismicTest < Minitest::Test
 
   def test_convert_double_img
     expected = [
-      {
-        type: "paragraph",
-        content: {
-          text: "",
-          spans: []
-        }
-      },
       {
         type: "image",
         content: {
@@ -350,7 +341,9 @@ class KramdownPrismicTest < Minitest::Test
           spans: []
         },
         data: {
-          url: '/img.png',
+          origin: {
+            url: '/img.png'
+          },
           alt: ''
         }
       },
@@ -361,7 +354,9 @@ class KramdownPrismicTest < Minitest::Test
           spans: []
         },
         data: {
-          url: '/img2.png',
+          origin: {
+            url: '/img2.png'
+          },
           alt: ''
         }
       }
@@ -422,6 +417,22 @@ class KramdownPrismicTest < Minitest::Test
     assert_equal expected, Kramdown::Document.new(markdown, input: :kramdown).to_prismic
   end
 
+  def test_convert_inline_code
+    expected = [
+      {
+        type: "paragraph",
+        content: {
+          text: "Hello code",
+          spans: []
+        }
+      }
+    ]
+    markdown = "Hello `code`"
+    doc = Kramdown::Document.new(markdown)
+    assert_equal expected, doc.to_prismic
+    assert_equal 1, doc.warnings.size
+  end
+
   def test_convert_br
     expected = [
       {type: "paragraph",

data/test/parser_test.rb

@@ -0,0 +1,204 @@
+require 'minitest/autorun'
+require 'kramdown-prismic'
+
+class KramdownPrismicParserTest < Minitest::Test
+  def test_parse_heading
+    prismic = [
+      {
+        type: "heading1",
+        content: {
+          text: "This is the document title",
+          spans: []
+        }
+      }
+    ]
+    expected = "# This is the document title\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_heading2
+    prismic = [
+      {
+        type: "heading2",
+        content: {
+          text: "This is an h2 title",
+          spans: []
+        }
+      }
+    ]
+    expected = "## This is an h2 title\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_paragraph
+    prismic = [
+      {
+        type: "paragraph",
+        content: {
+          text: "This is a paragraph",
+          spans: []
+        }
+      }
+    ]
+    expected = "This is a paragraph\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_paragraph_with_spans
+    prismic = [
+      {
+        type: "paragraph",
+        content: {
+          text: "This is a paragraph",
+          spans: [
+            {
+              type: "em",
+              start: 0,
+              end: 4
+            }
+          ]
+        }
+      }
+    ]
+    expected = "*This* is a paragraph\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_paragraph_with_multiple_spans
+    prismic = [
+      {
+        type: "paragraph",
+        content: {
+          text: "This is a paragraph",
+          spans: [
+            {
+              type: "em",
+              start: 0,
+              end: 4
+            },
+            {
+              type: "strong",
+              start: 5,
+              end: 7
+            }
+          ]
+        }
+      }
+    ]
+    expected = "*This* **is** a paragraph\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_paragraph_with_link
+    prismic = [
+      {
+        type: "paragraph",
+        content: {
+          text: "This is a paragraph",
+          spans: [
+            {
+              type: "hyperlink",
+              start: 0,
+              end: 19,
+              data: {
+                url: "https://prismic.io"
+              }
+            }
+          ]
+        }
+      }
+    ]
+    expected = "[This is a paragraph][1]\n\n\n\n[1]: https://prismic.io\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_paragraph_with_nested_spans
+    prismic = [
+      {
+        type: "paragraph",
+        content: {
+          text: "This is a paragraph",
+          spans: [
+            {
+              type: "em",
+              start: 0,
+              end: 4
+            },
+            {
+              type: "hyperlink",
+              start: 0,
+              end: 19,
+              data: {
+                url: "https://prismic.io"
+              }
+            }
+          ]
+        }
+      }
+    ]
+    expected = "[*This* is a paragraph][1]\n\n\n\n[1]: https://prismic.io\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_image
+    prismic = [
+      {
+        type: "image",
+        content: {
+          text: "",
+          spans: []
+        },
+        data: {
+          origin: {
+            url: '/img.png'
+          },
+          alt: 'alt text'
+        }
+      }
+    ]
+    expected = "![alt text](/img.png)\n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_preformatted
+    prismic = [
+      {
+        type: "preformatted",
+        content: {
+          text: "This is a pre block\n",
+          spans: []
+        }
+      }
+    ]
+    expected = "> This is a pre block \n\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+
+  def test_parse_embed
+    prismic = [
+      {
+        type: "embed",
+        data: {
+          type: "video",
+          embed_url: "https://www.youtube.com/watch?v=y6y_4_b6RS8"
+        },
+        content: {
+          text: "",
+          spans: []
+        }
+      }
+    ]
+    expected = "<iframe src=\"https://www.youtube.com/watch?v=y6y_4_b6RS8\"></iframe>\n"
+    doc = Kramdown::Document.new(prismic, input: :prismic)
+    assert_equal expected, doc.to_kramdown
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kramdown-prismic
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - François de Metz
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-10-30 00:00:00.000000000 Z
+date: 2021-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: kramdown
@@ -58,7 +58,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
+- ".travis.yml"
+- Changelog.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
@@ -68,7 +71,9 @@ files:
 - lib/kramdown-prismic.rb
 - lib/kramdown-prismic/version.rb
 - lib/kramdown/converter/prismic.rb
-- test/kramdown-prismic_test.rb
+- lib/kramdown/parser/prismic.rb
+- test/converter_test.rb
+- test/parser_test.rb
 homepage: https://github.com/stormz/kramdown-prismic
 licenses:
 - MIT
@@ -88,10 +93,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: A Kramdown converter to convert documents into prismic rich text format.
 test_files:
-- test/kramdown-prismic_test.rb
+- test/converter_test.rb
+- test/parser_test.rb