asciidoctor-pdf 2.0.0.alpha.2 → 2.0.0.beta.2

data/README.adoc

@@ -1,6 +1,6 @@
 = Asciidoctor PDF: A native PDF converter for AsciiDoc
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>; Sarah White <https://github.com/graphitefriction[@graphitefriction]>
-v2.0.0.alpha.2, 2022-04-29
+v2.0.0.beta.2, 2022-05-14
 // Settings:
 :experimental:
 :idprefix:
@@ -24,7 +24,7 @@ endif::[]
 :project-handle: asciidoctor-pdf
 // Variables:
 :release-line: 2.0.x
-:release-version: 2.0.0.alpha.2
+:release-version: 2.0.0.beta.2
 // URIs:
 :url-asciidoctor: http://asciidoctor.org
 :url-gem: http://rubygems.org/gems/asciidoctor-pdf
@@ -49,7 +49,7 @@ It bypasses the requirement to generate an intermediary format such as DocBook,
 Instead, you can use this extension to convert your documents directly from AsciiDoc to PDF.
 Its aim is to take the pain out of creating PDF documents from AsciiDoc.
 
-NOTE: You're viewing the documentation for the (unreleased) {release-line} release line.
+NOTE: The documentation for Asciidoctor PDF {release-line} is now available at https://docs.asciidoctor.org/pdf-converter/latest/.
 If you're looking for the documentation for another release line, please refer to one of the following branches: +
 {url-project-repo}/tree/v1.5.x#readme[1.5.x]
 -
@@ -75,7 +75,7 @@ But don't miss the <<Highlights>> to get a preview of what's possible.
 == Highlights
 
 * Direct AsciiDoc to PDF conversion
-* <<docs/theming-guide.adoc#,Configuration-driven theme (style and layout)>>
+* Configuration-driven theme (style and layout)
 * Custom fonts (TTF or OTF)
 * Full SVG support (thanks to https://github.com/mogest/prawn-svg[prawn-svg])
 * PDF document outline (i.e., bookmarks)
@@ -319,7 +319,7 @@ The pain of the DocBook toolchain should be melting away about now.
 == Themes
 
 The layout and styling of the PDF is driven by a YAML configuration file.
-To learn how the theming system works and how to create and apply custom themes, refer to the <<docs/theming-guide.adoc#,Asciidoctor PDF Theming Guide>>.
+To learn how the theming system works and how to create and apply custom themes, refer to the https://docs.asciidoctor.org/pdf-converter/latest/theme/[Asciidoctor PDF theming documentation].
 You can use the built-in theme files, which you can find in the [.path]_data/themes_ directory, as examples.
 
 If you've enabled a source highlighter, you can control the style (aka theme) it applies to source blocks using the `coderay-style`, `pygments-style`, and `rouge-style` attributes, respectively.
@@ -328,7 +328,7 @@ For example, to configure Rouge to use the built-in monokai theme, run Asciidoct
  $ asciidoctor-pdf -a rouge-style=monokai basic-example.adoc
 
 It's possible to develop your own theme for Rouge.
-Refer to the <<docs/theming-guide.adoc#,Asciidoctor PDF Theming Guide>> for details.
+Refer to the https://docs.asciidoctor.org/pdf-converter/latest/theme/[Asciidoctor PDF theming documentation] for details.
 
 == Support for Non-Latin Languages
 
@@ -343,80 +343,6 @@ There's no one font that supports all the world's languages (though some, like N
 Even if there were such a font, bundling that font with the main gem would make it enormous.
 It would also severely limit the style choices in the default theme, which targets Latin-based languages.
 Therefore, we're taking the strategy of creating separate dedicated theme gems that target each language family, such as CJK.
-Read on to find out how to use these themes.
-
-Asciidoctor PDF provides a built-in theme that provides a broad range of characters in the CJK charsets, so you can start with that theme:
-
- $ asciidoctor-pdf -a scripts=cjk -a pdf-theme=default-with-fallback-font document.adoc
-
-Notice the `-a scripts=cjk` option.
-That's important.
-It tells the converter to insert break opportunities between CJK characters so that the line wraps properly when mixing English and a CJK language like Japanese.
-
-If the built-in theme with the fallback font doesn't go far enough, you'll need to use a theme that is optimized for CJK text.
-You can get such a theme by installing the `asciidoctor-pdf-cjk-kai_gen_gothic` gem.
-The https://github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic[asciidoctor-pdf-cjk-kai_gen_gothic] project provides themes optimized for CJK languages based on the kai_gen_gothic font.
-See the https://github.com/chloerei/asciidoctor-pdf-cjk-kai_gen_gothic[asciidoctor-pdf-cjk-kai_gen_gothic] project README for detailed setup instructions.
-
-WARNING: The theme provided by the `asciidoctor-pdf-cjk-kai_gen_gothic` gem is no longer compatiable with the stable release of Asciidoctor PDF.
-However, you can still use it to create a <<Create a Custom CJK Theme,custom CJK theme>>.
-
-Once you have that gem installed (and the fonts), you need to tell Asciidoctor PDF to use one of the themes.
-If you're converting a document that is primarily written in Japanese, you'd run Asciidoctor PDF as follows:
-
- asciidoctor-pdf -r asciidoctor-pdf-cjk-kai_gen_gothic -a pdf-theme=KaiGenGothicJP document.adoc
-
-If that command fails, you may have better luck creating your own CJK theme.
-
-=== Create a Custom CJK Theme
-
-You also have to option of creating your own theme gem that uses fonts of your choice.
-For example, if you want to use the `asciidoctor-pdf-cjk-kai_gen_gothic` gem to fetch fonts, but then use them in your own theme, here's how you'd do it.
-
-. Install the `asciidoctor-pdf-cjk-kai_gen_gothic` gem:
-
- $ gem install asciidoctor-pdf-cjk-kai_gen_gothic
-
-. Download / install the fonts:
-
- $ asciidoctor-pdf-cjk-kai_gen_gothic-install
-
-. Create a theme file named [.path]_cjk-theme.yml_ that extends the default theme to override the fonts:
-+
-[source,yml]
-----
-extends: default
-font:
-  catalog:
-    merge: true
-    KaiGen Gothic CN:
-      normal: KaiGenGothicCN-Regular.ttf
-      bold: KaiGenGothicCN-Bold.ttf
-      italic: KaiGenGothicCN-Regular-Italic.ttf
-      bold_italic: KaiGenGothicCN-Bold-Italic.ttf
-  fallbacks:
-  - KaiGen Gothic CN
-base:
-  font-family: KaiGen Gothic CN
-heading:
-  font-family: $base-font-family
-abstract:
-  title:
-    font-family: $heading-font-family
-sidebar:
-  title:
-    font-family: $heading-font-family
-----
-
-. Load your theme when running Asciidoctor PDF:
-
- $ asciidoctor-pdf -a scripts=cjk -a pdf-theme=./cjk-theme.yml -a pdf-fontsdir=GEM_FONTS_DIR,`ruby -r asciidoctor-pdf-cjk-kai_gen_gothic -e "print File.expand_path '../fonts', (Gem.datadir 'asciidoctor-pdf-cjk-kai_gen_gothic')"` document.adoc
-
-The `-a pdf-fontsdir` option is important to tell Asciidoctor PDF where to find your custom fonts.
-(Note that the inclusion of GEM_FONTS_DIR in the value is only required when using Asciidoctor PDF 1.5).
-
-Rather than using the installer from the `asciidoctor-pdf-cjk-kai_gen_gothic` gem, you can download fonts whatever way you choose.
-When using your own fonts, be sure to consult the <<docs/theming-guide.adoc#preparing-a-custom-font,Preparing a Custom Font>> section of the theming guide to find recommended modifications.
 
 == Font-Based Icons
 
@@ -672,64 +598,43 @@ Here's how to move it to the bottom right:
 
 If an image dimension matches the height or width of the page, the positioning keyword for that axis has no effect.
 
-== Fonts in SVG Images
-
-Asciidoctor PDF uses {url-prawn-svg}[prawn-svg] to embed SVGs in the PDF document, including SVGs generated by Asciidoctor Diagram.
-
-Actually, it's not accurate to say that prawn-svg embeds the SVG.
-Rather, prawn-svg is an SVG _renderer_.
-prawn-svg translates an SVG into native PDF text and graphic objects.
-You can think of the SVG as a sequence of drawing commands.
-The result becomes indistinguishable from other PDF objects.
-
-What that means for text is that any font family used for text in the SVG _must_ be registered in the Asciidoctor PDF theme file (and thus with Prawn).
-Otherwise, Prawn will fallback to using the closest matching built-in (afm) font from PDF (e.g., sans-serif becomes Helvetica).
-Recall that afm fonts only support basic Latin.
-As we like to say, PDF is <<docs/theming-guide.adoc#built-in-afm-fonts,bring your own font>>.
-
-If you're using Asciidoctor Diagram to generate SVGs to embed in the PDF, you likely need to specify the default font the diagramming tool uses.
-Let's assume you are making a plantuml diagram.
+== Supporting Additional Image File Formats
 
-To set the font used in the diagram, first create a file named [.path]_plantuml.cfg_ and populate it with the following content:
+In order to embed an image into a PDF, Asciidoctor PDF must understand how to decode it.
+To perform this work, Asciidoctor delegates to the underlying libraries.
+{url-prawn}[Prawn] provides support for decoding JPG and PNG images.
+{url-prawn-svg}[prawn-svg] brings support for translating SVG images to PDF commands.
+Without any additional libraries, those are the only image file formats supported by Asciidoctor PDF.
 
-----
-skinparam defaultFontName Noto Serif
-----
+If you need support for additional image formats, such as GIF, TIFF, WebP, or interlaced PNG--and you don't want to convert those images to a supported format like JPG--you must install the {url-prawn-gmagick}[prawn-gmagick] (>= 0.0.9) Ruby gem.
+prawn-gmagick is an extension for Prawn that delegates image decoding to {url-graphicsmagick}[GraphicsMagick] to add support for all image formats recognized by that library.
 
-TIP: You can choose any font name that is registered in your Asciidoctor PDF theme file.
-When using the default theme, your options are "Noto Serif", "M+ 1mn", and "M+ 1p Fallback".
+prawn-gmagick has the additional benefit of *significantly* reducing the processing time, power, and memory necessary to generate a PDF that contains a lot of PNG images.
+For large books (such as Pro Git), you might see the conversion time drop by as much as half.
+Decoding PNG images requires a lot of mathematical computation, a task Ruby is not particularly efficient at performing.
+That's why adding the prawn-gmagick gem to the converter makes such a substantial difference.
 
-Next, pass that path to the `plantumlconfig` attribute in your AsciiDoc document (or set the attribute via the CLI or API):
+As an alternative to using prawn-gmagick, you could optimize the images you pass into Asciidoctor PDF, either by scaling them down or converting them to an uncompressed format like JPG.
 
-----
-:plantumlconfig: plantuml.cfg
-----
+The prawn-gmagick gem uses native extensions to compile against GraphicsMagick.
+This system prerequisite limits installation to C Ruby running on Linux and macOS.
+Please refer to the {url-prawn-gmagick}[README for prawn-gmagick] to learn how to install it.
 
-Clear the cache of your diagrams and run Asciidoctor PDF with Asciidoctor Diagram enabled.
-The diagrams will be generated using Noto Serif as the default font, and Asciidoctor PDF will know what to do.
+ $ gem install prawn-gmagick
 
-The bottom line is this:
-If you're using fonts in your SVG, and you want those fonts to be preserved, those fonts must be defined in the Asciidoctor PDF theme file.
+When this gem is installed, Asciidoctor automatically detects and loads it, then delegates all image decoding to GraphicsMagick by way of the bridge it provides.
+We highly recommend using this gem with Asciidoctor PDF if you're able to install it.
 
-== Supporting Additional Image File Formats
+The one downside of delegating to GraphicsMagick is that it can mangle certain PNG images.
+If this happens, you can instruct Asciidoctor PDF to not delegate to GraphicsMagick to load PNG images by requiring `asciidoctor/pdf/nopngmagick` when calling Asciidoctor PDF, as follows:
 
-In order to embed an image into a PDF, Asciidoctor PDF must understand how to read it.
-To perform this work, Asciidoctor delegates to the underlying libraries.
-{url-prawn}[Prawn] provides support for reading JPG and PNG images.
-{url-prawn-svg}[prawn-svg] brings support for SVG images.
-Without any additional libraries, those are the only supported image file formats.
+ $ asciidoctor-pdf -r asciidoctor/pdf/nopngmagick doc.adoc
 
-If you need support for additional image formats, such as GIF, TIFF, or interlaced PNG--and you don't want to convert those images to a supported format--you must install the {url-prawn-gmagick}[prawn-gmagick] (>= 0.0.9) Ruby gem.
-prawn-gmagick is an extension for Prawn based on {url-graphicsmagick}[GraphicsMagick] that adds support for all the image formats recognized by that library.
-prawn-gmagick has the added benefit of significantly reducing the time it takes to generate a PDF containing a lot of images.
+You can also tell Asciidoctor PDF not to use prawn-gmagick at all by requiring `asciidoctor/pdf/nogmagick` when calling Asciidoctor PDF, as follows:
 
-The prawn-gmagick gem uses native extensions to compile against GraphicsMagick.
-This system prerequisite limits installation to Linux and OSX.
-Please refer to the {url-prawn-gmagick}[README for prawn-gmagick] to learn how to install it.
+ $ asciidoctor-pdf -r asciidoctor/pdf/nogmagick doc.adoc
 
-Once this gem is installed, Asciidoctor automatically loads it, then delegates to it to handle all image embedding.
-In addition to support for additional image file formats, this gem also speeds up image processing considerably.
-We highly recommend using this gem if you're able to install it.
+Granted, bypassing prawn-gmagick means you no longer get support for additional image formats that Prawn cannot handle or the PNG acceleration.
 
 == Importing PDF Pages
 

data/data/fonts/ABOUT-mplus1p-subset

@@ -17,6 +17,7 @@ The following changes were made using fontforge to produce mplus1p-regular-fallb
  ** General Punctuation (U+2000–U203a)
  ** Geometric Shapes (U+25a0–U25ff)
  ** Assorted Symbols (U+20ac, U+2122, U+21d0–U+21d5, U+2190–U+2195, U+2610–U+2611, U+2713–U+2714)
+ ** Latin Small Capital Letters (U+1D00, U+0299, U+1D04, U+1D05, U+1D07, U+A730, U+0262, U+029C, U+026A, U+1D0A, U+1D0B, U+029F, U+1D0D, U+0274, U+1D0F, U+1D18, U+A7AF (missing), U+0280, U+A731, U+1D1B, U+1D1C, U+1D20, U+1D21, U+028F, U+1D22)
  ** .notdef glyph
 * Added BOM (U+feff), hair space (U+200a), zero-width space (U+200b) and line feed (U+000a) characters (from blank)
 * Manually added non-breaking hyphen (U+2011) from hyphen (U+002d)

data/data/fonts/ABOUT-notosans-subset

@@ -17,6 +17,7 @@ The following changes were made using fontforge to produce the notosans-*-subset
  ** General Punctuation (U+2000–U203a)
  ** Geometric Shapes (U+25a0–U25ff)
  ** Assorted Symbols (U+20ac, U+2122, U+21d0, U+21d2, U+2190, U+2192)
+ ** Latin Small Capital Letters (U+1D00, U+0299, U+1D04, U+1D05, U+1D07, U+A730 (missing), U+0262, U+029C, U+026A, U+1D0A, U+1D0B, U+029F, U+1D0D, U+0274, U+1D0F, U+1D18, U+A7AF (missing), U+0280, U+A731 (missing), U+1D1B, U+1D1C, U+1D20, U+1D21, U+028F, U+1D22, U+01EB)
  ** .notdef glyph
 * Imported ballot boxes from Font Awesome (U+2610, U+2611) (Noto Serif Regular only)
 * Added line feed character (U+000a)

data/data/fonts/ABOUT-notoserif-subset

@@ -17,6 +17,7 @@ The following changes were made using fontforge to produce the notoserif-*-subse
  ** General Punctuation (U+2000–U203a)
  ** Geometric Shapes (U+25a0–U25ff)
  ** Assorted Symbols (U+20ac, U+2122, U+21d0, U+21d2, U+2190, U+2192)
+ ** Latin Small Capital Letters (U+1D00, U+0299, U+1D04, U+1D05, U+1D07, U+A730 (missing), U+0262, U+029C, U+026A, U+1D0A, U+1D0B, U+029F, U+1D0D, U+0274, U+1D0F, U+1D18, U+A7AF (missing), U+0280, U+A731 (missing), U+1D1B, U+1D1C, U+1D20, U+1D21, U+028F, U+1D22, U+01EB)
  ** .notdef glyph
 * Imported ballot boxes from Font Awesome (U+2610, U+2611) (Noto Serif Regular only)
 * Added line feed character (U+000a)

data/data/themes/base-theme.yml

@@ -1,24 +1,19 @@
-# NOTE file is read "as is"; variables are not parsed; key layout must be flat
+# NOTE: file is read "as is"; variables are not parsed; key layout must be flat
 page_background_color: 'FFFFFF'
 page_layout: portrait
 page_initial_zoom: FitH
-# 36 is equivalent to 0.5in
-page_margin: 36
+page_margin: 36 # 36 is 0.5in
 page_margin_inner: 48
 page_margin_outer: 24
 page_size: A4
 base_text_align: left
-#base_font_color: '333333'
 base_font_color: '000000'
-#base_font_family: Times-Roman
 base_font_family: Helvetica
 base_font_size: 12
-# QUESTION should we rename to min_font_size?
 base_font_size_min: 6
 base_font_style: normal
 base_line_height: 1.15
-base_border_color: 'EEEEEE'
-base_border_width: 0.5
+base_border_color: '000000'
 role_lead_font_size: 13.5
 role_line-through_text_decoration: line-through
 role_underline_text_decoration: underline
@@ -47,7 +42,6 @@ heading_margin_top: 4
 heading_margin_bottom: 12
 heading_min_height_after: 20
 title_page_text_align: center
-title_page_line_height: 1.15
 title_page_logo_top: 10%
 title_page_title_top: 40%
 title_page_title_font_size: 18
@@ -69,50 +63,46 @@ abstract_line_height: 1.4
 abstract_padding: 0
 abstract_title_align: center
 abstract_title_font_style: bold
-admonition_column_rule_color: 'EEEEEE'
 admonition_column_rule_width: 0.5
 admonition_padding: [4, 12, 4, 12]
 admonition_label_font_style: bold
 admonition_label_text_transform: uppercase
-quote_border_color: 'EEEEEE'
 quote_border_left_width: 4
-quote_padding: [6, 12, 6, 14]
-verse_border_color: 'EEEEEE'
+quote_padding: [3, 12, 3, 14]
 verse_border_left_width: 4
-verse_padding: [6, 12, 6, 14]
+verse_padding: [3, 12, 3, 14]
 code_font_family: Courier
 code_font_size: 10.8
 code_line_height: 1.2
 code_padding: 9
-code_border_color: 'EEEEEE'
 code_border_width: 0.5
 conum_line_height: 1.15
 conum_glyphs: circled
 example_background_color: 'FFFFFF'
-example_border_color: 'EEEEEE'
 example_border_width: 0.5
 example_padding: 12
 image_align: left
 prose_margin_bottom: 12
 sidebar_background_color: 'EEEEEE'
+sidebar_border_width: 0.5
 sidebar_padding: 12
 sidebar_title_align: center
 sidebar_title_font_style: bold
-table_border_color: '000000'
 table_border_style: solid
 table_border_width: 0.5
-table_grid_width: 0.5
 table_cell_padding: 2
 table_head_font_style: bold
 table_head_border_bottom_width: 1.25
 table_body_stripe_background_color: 'EEEEEE'
-thematic_break_border_color: 'EEEEEE'
 thematic_break_border_style: solid
 thematic_break_border_width: 0.5
-thematic_break_margin_bottom: 12
+thematic_break_padding: 0
 toc_indent: 15
 toc_line_height: 1.4
 footnotes_font_size: 9
 footnotes_item_spacing: 3
+footer_border_width: 0.5
+footer_font_size: 10
+footer_height: 30
 footer_recto_right_content: '{page-number}'
 footer_verso_left_content: '{page-number}'

data/data/themes/default-for-print-theme.yml

@@ -3,7 +3,7 @@ base_border_color: BBBBBB
 base_font_color: 000000
 role_subtitle_font_color: 666666
 link_font_color: ~
-literal_font_color: ~
+codespan_font_color: ~
 mark_background_color: CCCCCC
 menu_caret_content: " <font size=\"1.15em\">\u203a</font> "
 heading_font_color: $base_font_color
@@ -11,10 +11,10 @@ title_page_title_font_color: $role_subtitle_font_color
 abstract_font_color: 2C2C2C
 abstract_title_font_color: $heading_font_color
 admonition_column_rule_color: $base_border_color
-blockquote_border_color: $base_border_color
-blockquote_cite_font_color: $role_subtitle_font_color
+quote_border_color: $base_border_color
+quote_cite_font_color: $role_subtitle_font_color
 verse_border_color: $base_border_color
-verse_cite_font_color: $blockquote_cite_font_color
+verse_cite_font_color: $quote_cite_font_color
 code_font_color: $base_font_color
 conum_font_color: $base_font_color
 example_border_color: $base_border_color

data/data/themes/default-for-print-with-fallback-font-theme.yml

@@ -1,3 +1,2 @@
-extends:
-- default-for-print
-- default-with-fallback-font
+# DEPRECATED
+extends: default-for-print-with-font-fallbacks

data/data/themes/default-for-print-with-font-fallbacks-theme.yml

@@ -0,0 +1,3 @@
+extends:
+- default-with-font-fallbacks
+- default-for-print

data/data/themes/{sans-with-fallback-font-theme.yml → default-sans-theme.yml}

@@ -1,4 +1,4 @@
-extends: default-with-fallback-font
+extends: default
 font:
   catalog:
     merge: true

data/data/themes/default-sans-with-font-fallbacks-theme.yml

@@ -0,0 +1,3 @@
+extends:
+- default-with-font-fallbacks
+- default-sans

data/data/themes/default-theme.yml

@@ -168,8 +168,8 @@ quote:
   font_size: $base_font_size_large
   border_color: $base_border_color
   border_width: 0
-  border_left_width: 5
-  padding: [0, $horizontal_rhythm, $block_margin_bottom * 0.25, $horizontal_rhythm + $quote_border_left_width / 2]
+  border_left_width: $horizontal_rhythm / 3
+  padding: [$vertical_rhythm / 4, $horizontal_rhythm, $vertical_rhythm / 4, $horizontal_rhythm + $quote_border_left_width / 2]
   cite:
     font_size: $base_font_size_small
     font_color: $role_subtitle_font_color
@@ -226,8 +226,7 @@ thematic_break:
   border_color: $base_border_color
   border_style: solid
   border_width: $base_border_width
-  margin_top: $vertical_rhythm * 0.5
-  margin_bottom: $vertical_rhythm * 1.5
+  padding: [$vertical_rhythm * 0.5, 0]
 list:
   indent: $horizontal_rhythm * 1.5
   #marker_font_color: 404040
@@ -262,6 +261,8 @@ toc:
 footnotes:
   font_size: round($base_font_size * 0.75)
   item_spacing: $list_item_spacing / 2
+index:
+  column_gap: $vertical_rhythm
 header:
   font_size: $base_font_size_small
   line_height: 1

data/data/themes/default-with-fallback-font-theme.yml

@@ -1,9 +1,2 @@
-extends: default
-font:
-  catalog:
-    merge: true
-    # M+ 1p supports Latin, Latin-1 Supplement, Latin Extended, Greek, Cyrillic, Vietnamese, Japanese & an assortment of symbols
-    # It also provides arrows for ->, <-, => and <= replacements in case these glyphs are missing from font
-    M+ 1p Fallback: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf
-    Noto Emoji: GEM_FONTS_DIR/notoemoji-subset.ttf
-  fallbacks: [M+ 1p Fallback, Noto Emoji]
+# DEPRECATED
+extends: default-with-font-fallbacks

data/data/themes/default-with-font-fallbacks-theme.yml

@@ -0,0 +1,9 @@
+extends: default
+font:
+  catalog:
+    merge: true
+    # M+ 1p supports Latin, Latin-1 Supplement, Latin Extended, Greek, Cyrillic, Vietnamese, Japanese & an assortment of symbols
+    # It also provides arrows for ->, <-, => and <= replacements in case these glyphs are missing from font
+    M+ 1p Fallback: GEM_FONTS_DIR/mplus1p-regular-fallback.ttf
+    Noto Emoji: GEM_FONTS_DIR/notoemoji-subset.ttf
+  fallbacks: [M+ 1p Fallback, Noto Emoji]