update emoji ext to latest emoji cheat-sheet and github api versions.

VERSION.md

@@ -119,6 +119,18 @@
 
 ## 0.64.8
 
+* Update: `flexmark-ext-emoji` to latest references from [emoji-cross-reference] based on latest
+  [Emoji-Cheat-Sheet.com], [GitHub Emoji API], [Unicode Emoji List, v15.0] and
+  [Unicode Emoji Modifiers List, v15.0]. Some emoji categories have changed because in the
+  latest references the categories are taken from [Unicode Emoji List, v15.0] and
+  [Unicode Emoji Modifiers List, v15.0], instead of [Emoji-Cheat-Sheet.com].
+* Change: update `flexmark-docx-converter` emoji images to latest from [Emoji-Cheat-Sheet.com].
+* Change: `flexmark-html2md-converter` to ignore image alt emoji category when trying to match
+  emoji shortcut.
+* Add: `USE_UNICODE_FILE_NAMES` option to `EmojiExtension`, default `false`. When true will use
+  `unicodeSampleFile` field for `Emoji Cheat Sheet` image file name. This is to support
+  implementations which rely on the file renaming done by [emoji-cross-reference] when copying
+  emoji cheat sheet images to common `emoji_images/emojis` directory.
 * Fix: reference links in html to md conversion use the same ref id when link text is the same,
   even when the URLs differ. Now the reference id will be generated by adding `_xxx` suffix,
   where `xxx` is an increasing integer, starting at 1, and incremented until a unique reference
@@ -2163,17 +2175,22 @@
 [Add OSGi metadata to Manifest to enable deployment to OSGi environments by benfortuna · Pull Request #521 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/521 "Add OSGi metadata to Manifest to enable deployment to OSGi environments by benfortuna · Pull Request #521 · vsch/flexmark-java · GitHub"
 [Awesome Console]: https://plugins.jetbrains.com/plugin/7677-awesome-console "Awesome Console"
 [Dependency update for jsoup by viglu · Pull Request #544 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/544 "Dependency update for jsoup by viglu · Pull Request #544 · vsch/flexmark-java · GitHub"
+[Emoji-Cheat-Sheet.com]: https://github.com/WebpageFX/emoji-cheat-sheet.com
 [Fix #548: Converting html images fails if the image refers to an emoji without a shortcut by DamnedElric · Pull Request #562 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/562 "Fix #548: Converting html images fails if the image refers to an emoji without a shortcut by DamnedElric · Pull Request #562 · vsch/flexmark-java · GitHub"
 [Fix generation of header IDs by travkin79 · Pull Request #566 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/566 "Fix generation of header IDs by travkin79 · Pull Request #566 · vsch/flexmark-java · GitHub"
 [Fix typo in issue template by MiniDigger · Pull Request #502 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/502 "Fix typo in issue template by MiniDigger · Pull Request #502 · vsch/flexmark-java · GitHub"
+[GitHub Emoji API]: https://api.github.com/emojis
 [HtmlToMarkdownCustomizedSample.java]: https://github.com/vsch/flexmark-java/blob/master/flexmark-java-samples/src/com/vladsch/flexmark/java/samples/HtmlToMarkdownCustomizedSample.java
 [Kijimuna]: https://github.com/Kijimuna
 [NodeInsertingPostProcessorSample.java]: https://github.com/vsch/flexmark-java/blob/master/flexmark-java-samples/src/com/vladsch/flexmark/java/samples/NodeInsertingPostProcessorSample.java
 [PdfLandscapeConverter.java]: https://github.com/vsch/flexmark-java/blob/master/flexmark-java-samples/src/com/vladsch/flexmark/java/samples/PdfLandscapeConverter.java
 [Prevent StringIndexOutOfBounds in ext-resizable-image by MiniDigger · Pull Request #503 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/503 "Prevent StringIndexOutOfBounds in ext-resizable-image by MiniDigger · Pull Request #503 · vsch/flexmark-java · GitHub"
 [TextCollectingVisitor works better with code blocks by roxspring · Pull Request #575 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/575 "TextCollectingVisitor works better with code blocks by roxspring · Pull Request #575 · vsch/flexmark-java · GitHub"
+[Unicode Emoji List, v15.0]: https://unicode.org/emoji/charts/emoji-list.html
+[Unicode Emoji Modifiers List, v15.0]: https://unicode.org/emoji/charts/full-emoji-modifiers.html
 [Update to latest maven bundle plugin. Fix for #529 by cziegeler · Pull Request #530 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/530 "Update to latest maven bundle plugin. Fix for #529 by cziegeler · Pull Request #530 · vsch/flexmark-java · GitHub"
 [YouTrack: IDEA-207453]: https://youtrack.jetbrains.com/issue/IDEA-207453 "Add Conversion of ref anchor to UrlFilter for file line navigation"
+[emoji-cross-reference]: https://github.com/vsch/emoji-cross-reference
 [ext-resizable-image: fix images inside links by e-im · Pull Request #543 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/543 "ext-resizable-image: fix images inside links by e-im · Pull Request #543 · vsch/flexmark-java · GitHub"
 [fix issue #448 by protogenes · Pull Request #510 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/510 "fix issue #448 by protogenes · Pull Request #510 · vsch/flexmark-java · GitHub"
 [Fix vsch#545, do not escape special characters in `<pre><code>` block by MekhailS · Pull Request #546 · vsch/flexmark-java · GitHub]: https://github.com/vsch/flexmark-java/pull/546 "Fix vsch#545, do not escape special characters in `<pre><code>` block by MekhailS · Pull Request #546 · vsch/flexmark-java · GitHub"

flexmark-docx-converter/src/test/resources/docx_converter_issues_ast_spec.md

@@ -2346,7 +2346,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:+1" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2420,7 +2420,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="279400" cy="279400"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:+1" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2470,7 +2470,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="241300" cy="241300"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100002" name="Image100002"/>
+                    <wp:docPr descr="emoji github:+1" id="100002" name="Image100002"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2520,7 +2520,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="203200" cy="203200"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100004" name="Image100004"/>
+                    <wp:docPr descr="emoji github:+1" id="100004" name="Image100004"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2570,7 +2570,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="177800" cy="177800"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100006" name="Image100006"/>
+                    <wp:docPr descr="emoji github:+1" id="100006" name="Image100006"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2620,7 +2620,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100008" name="Image100008"/>
+                    <wp:docPr descr="emoji github:+1" id="100008" name="Image100008"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2670,7 +2670,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100010" name="Image100010"/>
+                    <wp:docPr descr="emoji github:+1" id="100010" name="Image100010"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2718,7 +2718,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100012" name="Image100012"/>
+                    <wp:docPr descr="emoji github:+1" id="100012" name="Image100012"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2889,7 +2889,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:+1" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -2953,7 +2953,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3440,7 +3440,7 @@ TEXT :+1: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji people:+1" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:+1" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3514,7 +3514,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="279400" cy="279400"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100000" name="Image100000"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100000" name="Image100000"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3564,7 +3564,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="241300" cy="241300"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100002" name="Image100002"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100002" name="Image100002"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3614,7 +3614,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="203200" cy="203200"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100004" name="Image100004"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100004" name="Image100004"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3664,7 +3664,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="177800" cy="177800"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100006" name="Image100006"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100006" name="Image100006"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3714,7 +3714,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100008" name="Image100008"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100008" name="Image100008"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3764,7 +3764,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100010" name="Image100010"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100010" name="Image100010"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>
@@ -3812,7 +3812,7 @@ TEXT :basecamp: TEXT
                 <wp:inline distB="0" distL="0" distR="0" distT="0" xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing">
                     <wp:extent cx="139700" cy="139700"/>
                     <wp:effectExtent b="0" l="0" r="0" t="0"/>
-                    <wp:docPr descr="emoji symbols:basecamp" id="100012" name="Image100012"/>
+                    <wp:docPr descr="emoji github:basecamp" id="100012" name="Image100012"/>
                     <wp:cNvGraphicFramePr>
                         <a:graphicFrameLocks noChangeAspect="true" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"/>
                     </wp:cNvGraphicFramePr>

flexmark-ext-attributes/src/test/resources/ext_attributes_ast_spec.md

@@ -1593,7 +1593,7 @@ Document[0, 15]
 Heading with emoji :+1:
 =======================
 .
-<h1 id="heading-with-emoji-">Heading with emoji <img src="/img/plus1.png" alt="emoji people:+1" height="20" width="20" align="absmiddle" /></h1>
+<h1 id="heading-with-emoji-">Heading with emoji <img src="/img/thumbsup.png" alt="emoji github:+1" height="20" width="20" align="absmiddle" /></h1>
 .
 Document[0, 47]
   Heading[0, 47] text:[0, 23, "Heading with emoji :+1:"] textClose:[24, 47, "======================="]
@@ -1607,7 +1607,7 @@ Document[0, 47]
 Heading with emoji :-1:
 =======================
 .
-<h1 id="heading-with-emoji-">Heading with emoji <img src="/img/-1.png" alt="emoji people:-1" height="20" width="20" align="absmiddle" /></h1>
+<h1 id="heading-with-emoji-">Heading with emoji <img src="/img/thumbsdown.png" alt="emoji github:-1" height="20" width="20" align="absmiddle" /></h1>
 .
 Document[0, 47]
   Heading[0, 47] text:[0, 23, "Heading with emoji :-1:"] textClose:[24, 47, "======================="]

flexmark-ext-emoji/src/main/java/com/vladsch/flexmark/ext/emoji/EmojiExtension.java

@@ -25,6 +25,7 @@ public class EmojiExtension implements Parser.ParserExtension, HtmlRenderer.Html
     final public static DataKey<String> ROOT_IMAGE_PATH = new DataKey<>("ROOT_IMAGE_PATH", "/img/");
     final public static DataKey<EmojiShortcutType> USE_SHORTCUT_TYPE = new DataKey<>("USE_SHORTCUT_TYPE", EmojiShortcutType.EMOJI_CHEAT_SHEET);
     final public static DataKey<EmojiImageType> USE_IMAGE_TYPE = new DataKey<>("USE_IMAGE_TYPE", EmojiImageType.IMAGE_ONLY);
+    final public static DataKey<Boolean> USE_UNICODE_FILE_NAMES = new DataKey<>("USE_UNICODE_FILE_NAMES", false);
 
     private EmojiExtension() {
     }