openstax_kitchen 16.0.0 → 19.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7796fb964e8a6ff796d9cf84220449681a89e5501e41e0a9a956620faf022d11
-  data.tar.gz: 4b2c488ac82a05067c7353f274b9f94888125eb7f66cfa92f30db3c28e7ae29a
+  metadata.gz: 8ad3abbaf8b72b698a5c8d16136f6d6ec9662c82c12291a7c7f87d02eafc0805
+  data.tar.gz: 948a85a3659dd95502113d351cbeb5a3cbc0b2c0151806974c69978818f622f2
 SHA512:
-  metadata.gz: cc57439823f55ee6cdec35304a2bb4413a28afc5c98ae616effadec60095cfa964a4b9faa0380178f189c55771d1a1f28813268ce001349f29c3d1b44397d4ab
-  data.tar.gz: d055f27db123b8e7441f45056e1c6f2a576ab56d1faa3bbdbb4af6a904674f1562e4403dd5e914a372fe67c5e969eb385838aab6f9ff9a5cbc8a0f5b20356df7
+  metadata.gz: 619c09628f6d62413fd07a7ee4e732cff9f52e78363a2f3414a11f9bbb3f32a008695fb4eaa25f82f0bc8cd81354ebc9e8666973904dd9f5ae2367a6183fde5c
+  data.tar.gz: f1b1198cdf3d84544fdd0af0fafa5bb17a0b15a273fb801ea5a4a345a7812da2e0de5311292e5b1e05a4d11715f6564ef817ff07ae5450a23f4397483ba45254

data/CHANGELOG.md

@@ -6,12 +6,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [19.0.0] - 2022-1-28
+
+* Add features to `BakeScreenreaderSpans` & use translations instead of plaintext (minor)
+* Create `AnswerKeyCleaner` to remove empty chapter containers (minor)
+* Change markup to `span` with `sup` for reference link separator `BakeReferences.v1` plus remove whitespaces and new lines (patch)
+* Changes to `BakeScreenreaderSpans` behavior (major)
+* Changes to `BakeToc` to improve error messaging by including `page.id` (minor)
+
+## [18.0.0] - 2022-01-14
+
+* Fix links in `BakeHanbook` outline to point sections (patch)
+* Add unit title prefix with number to `BakeUnitPageTitle` (patch)
+* Add `scope="col"` attribute to `BakeTableBody` and `BakeUnnumberedTables` (major)
+
+## [17.1.0] - 2021-12-17
+
+* Add append_to support to `BakeChapterSummary` (minor)
+* Add support for italicized terms in index (minor)
+* Fix problem with namespaces in `BakeLinkPlaceholders` and `BakeIndex` (minor)
+* Create `V3` for `BakeChapterReferences`  which sorts references alphabetically (minor)
+
+## [17.0.0] - 2021-12-3
+
+* Create method in `Integer` class that generate roman numbers up to 100 (minor)
+* Add more roman numbers to `Integer` class (patch)
+* Create `V2` for `BakeChapterReferences` (minor)
+* Create `BakeExercisePrefixes` direction adding prefixes for exercises in selected sections (minor)
+* Add support for 'text-heavy-top-titled' tables in `BakeTableBody` (minor)
+* Remove `Nokigiri#previous` patch, `ElementBase#previous` now uses `#previous_element` (minor)
+* Modifies `BakeAnnotationClasses` for annotations wrapper to be a `span` intead of a `div` (major)
 
 ## [16.0.0] - 2021-11-19
 
 * Add reference link separator to `BakeReferences.v1` (patch)
 * Modify `BakeFootnotes` to be more general (minor)
 * Add `#preceded_by_text` method to element_base and the nokigiri patch (minor)
+* Remove `Nokigiri#previous` patch, `ElementBase#previous` now uses `#previous_element` (minor)
 * Broaden caption selection for `BakeNumberedTable#v2` (patch)
 * Add details of question count to injected exercises in `BakeInjectedExercise` (major)
 * Add target labels to chapter content module pages option in `BakeNonIntroductionPages`, create a separate directory `BakeLOLinkLabels` to add `.label-text`, `.label-counter` spans wrappers for links with `.lo-reference` class (minor)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    openstax_kitchen (16.0.0)
+    openstax_kitchen (19.0.0)
       activesupport
       i18n
       nokogiri
@@ -11,7 +11,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.4.1)
+    activesupport (6.1.4.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
@@ -36,7 +36,7 @@ GEM
       yard (~> 0.9.12)
     method_source (1.0.0)
     mini_portile2 (2.5.0)
-    minitest (5.14.4)
+    minitest (5.15.0)
     nokogiri (1.11.1)
       mini_portile2 (~> 2.5.0)
       racc (~> 1.4)
@@ -99,7 +99,7 @@ GEM
       tins (~> 1.0)
     tins (1.26.0)
       sync
-    twitter_cldr (6.8.0)
+    twitter_cldr (6.11.1)
       camertron-eprun
       cldr-plurals-runtime-rb (~> 1.1)
       tzinfo
@@ -107,7 +107,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (1.7.0)
     yard (0.9.24)
-    zeitwerk (2.5.1)
+    zeitwerk (2.5.4)
 
 PLATFORMS
   ruby

data/lib/kitchen/directions/bake_annotation_classes/v1.rb

@@ -20,9 +20,18 @@ module Kitchen::Directions::BakeAnnotationClasses
                                    kinesthetic-icon]
       annotation_icon_classes.each do |annotation_icon_class|
         book.search("p.#{annotation_icon_class}").each do |annotation_with_icon_class|
-          annotation_with_icon_class.search('div.os-icons').first.append(child:
+          annotation_with_icon_class.search('div.os-icons').first&.name = 'span'
+
+          icon_title = I18n.t(:"annotation_icons.#{annotation_icon_class}.title")
+
+          annotation_with_icon_class.search('span.os-icons').first.append(child:
             <<~HTML
-              <span class = "#{annotation_icon_class}"></span>
+              <span
+                class = "#{annotation_icon_class}"
+                role="img"
+                title="#{icon_title}"
+                aria-label="#{icon_title}"
+              ></span>
             HTML
           )
         end

data/lib/kitchen/directions/bake_chapter_references/main.rb

@@ -10,6 +10,21 @@ module Kitchen
           uuid_prefix: uuid_prefix,
           klass: klass)
       end
+
+      def self.v2(chapter:, metadata_source:, uuid_prefix: '.', klass: 'references')
+        V2.new.bake(
+          chapter: chapter,
+          metadata_source: metadata_source,
+          uuid_prefix: uuid_prefix,
+          klass: klass)
+      end
+
+      def self.v3(chapter:, metadata_source:, uuid_prefix: '.')
+        V3.new.bake(
+          chapter: chapter,
+          metadata_source: metadata_source,
+          uuid_prefix: uuid_prefix)
+      end
     end
   end
 end

data/lib/kitchen/directions/bake_chapter_references/v2.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Kitchen::Directions::BakeChapterReferences
+  class V2
+    def bake(chapter:, metadata_source:, uuid_prefix: '.', klass: 'references')
+      chapter.pages.each do |page|
+        bake_page_cite(page: page)
+        bake_page_references(page: page)
+      end
+
+      return if chapter.pages.references.none?
+
+      content = chapter.pages.references.cut.paste
+
+      Kitchen::Directions::CompositePageContainer.v1(
+        container_key: klass,
+        uuid_key: "#{uuid_prefix}#{klass}",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: chapter
+      )
+    end
+
+    def bake_page_cite(page:)
+      page.search('[data-type="cite"]').each do |link|
+        link.id = "#{page.id}-endNote#{link.count_in(:chapter)}"
+
+        link.prepend(child:
+          <<~HTML
+            <sup class="os-end-note-number">#{link.count_in(:chapter)}</sup>
+          HTML
+        )
+
+        link.search('.delete-me').trash
+      end
+    end
+
+    def bake_page_references(page:)
+      page.references.each do |reference|
+        Kitchen::Directions::RemoveSectionTitle.v1(section: reference)
+
+        reference.search('a').each do |ref_link|
+          ref_link.replace_children(with:
+            <<~HTML
+              <span>#{ref_link.count_in(:chapter)}.</span>
+            HTML
+          )
+          ref_link.href = "##{page.id}-endNote#{ref_link.count_in(:chapter)}"
+        end
+      end
+    end
+  end
+end

data/lib/kitchen/directions/bake_chapter_references/v3.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Kitchen::Directions::BakeChapterReferences
+  class V3
+    class Reference
+      attr_reader :element
+
+      def initialize(element)
+        reference_item = Kitchen::I18nString.new(element.text.downcase)
+        @sortable = [reference_item]
+        @element = element
+      end
+
+      def <=>(other)
+        sortable <=> other.sortable
+      end
+
+      protected
+
+      attr_reader :sortable
+    end
+
+    def bake(chapter:, metadata_source:, append_to: nil, uuid_prefix: '.')
+      @references = []
+
+      chapter.references.search('p').each do |reference_element|
+        @references.push(Reference.new(reference_element.cut))
+      end
+
+      chapter.references.trash
+
+      content = @references.sort.map { |reference| reference.element.paste }.join
+
+      return if content.empty?
+
+      Kitchen::Directions::CompositePageContainer.v1(
+        container_key: 'references',
+        uuid_key: "#{uuid_prefix}references",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: append_to || chapter
+      )
+    end
+  end
+end

data/lib/kitchen/directions/bake_chapter_summary.rb

@@ -5,17 +5,18 @@ module Kitchen
     # Bake directions for eoc summary
     #
     module BakeChapterSummary
-      def self.v1(chapter:, metadata_source:, klass: 'summary', uuid_prefix: '.')
+      def self.v1(chapter:, metadata_source:, klass: 'summary', uuid_prefix: '.', append_to: nil)
         V1.new.bake(
           chapter: chapter,
           metadata_source: metadata_source,
           uuid_prefix: uuid_prefix,
-          klass: klass
+          klass: klass,
+          append_to: append_to
         )
       end
 
       class V1
-        def bake(chapter:, metadata_source:, uuid_prefix: '.', klass: 'summary')
+        def bake(chapter:, metadata_source:, uuid_prefix: '.', klass: 'summary', append_to: nil)
           summaries = Clipboard.new
 
           chapter.pages.each do |page|
@@ -36,7 +37,7 @@ module Kitchen
             uuid_key: "#{uuid_prefix}#{klass}",
             metadata_source: metadata_source,
             content: summaries.paste,
-            append_to: chapter
+            append_to: append_to || chapter
           )
         end
       end

data/lib/kitchen/directions/bake_exercise_prefixes/main.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Kitchen
+  module Directions
+    module BakeExercisePrefixes
+      def self.v1(chapter:, sections_prefixed:)
+        V1.new.bake(
+          chapter: chapter,
+          sections_prefixed: sections_prefixed
+        )
+      end
+    end
+  end
+end

data/lib/kitchen/directions/bake_exercise_prefixes/v1.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Kitchen::Directions::BakeExercisePrefixes
+  class V1
+    def bake(chapter:, sections_prefixed:)
+      sections_prefixed.each do |section_key|
+        chapter.composite_pages.each do |composite_page|
+          composite_page.search("section.#{section_key}").exercises.each do |exercise|
+            problem = exercise.problem
+            exercise_prefix =
+              "<span class='os-text'>#{I18n.t(:"sections_prefixed.#{section_key}")}</span>"
+            problem.prepend(child:
+              <<~HTML
+                #{exercise_prefix}
+              HTML
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kitchen/directions/bake_handbook/v1.rb

@@ -43,7 +43,7 @@ module Kitchen::Directions::BakeHandbook
 
         outline_item_html = <<~HTML
           <div class="os-handbook-objective">
-            <a class="os-handbook-objective" href="##{first_section_title[:id]}">
+            <a class="os-handbook-objective" href="##{section[:id]}">
               #{first_section_title.children}
             </a>
           </div>

data/lib/kitchen/directions/bake_index/v1.rb

@@ -11,12 +11,14 @@ module Kitchen::Directions::BakeIndex
       attr_reader :id
       attr_reader :group_by
       attr_reader :page_title
+      attr_reader :italicized
 
-      def initialize(text:, id:, group_by:, page_title:)
+      def initialize(text:, id:, group_by:, page_title:, italicized:)
         @text = text.strip
         @id = id
         @group_by = group_by
         @page_title = page_title
+        @italicized = italicized
       end
     end
 
@@ -126,7 +128,8 @@ module Kitchen::Directions::BakeIndex
         page = term_element.ancestor(:page)
         term_element.id = "auto_#{page.id}_term#{term_element.count_in(:book)}"
         page_title = page.title.text
-        add_term_to_index(term_element, page_title)
+        term_italicized = term_element&.first("em[data-effect='italics']")
+        add_term_to_index(term_element, page_title, term_italicized)
       end
 
       book.chapters.composite_pages.terms.each do |term_element|
@@ -135,7 +138,8 @@ module Kitchen::Directions::BakeIndex
         term_element.id = "auto_composite_page_term#{term_element.count_in(:book)}"
         chapter_number = chapter.count_in(:book)
         page_title = "#{chapter_number} #{page.title.text.strip}".strip
-        add_term_to_index(term_element, page_title)
+        term_italicized = term_element&.first("em[data-effect='italics']")
+        add_term_to_index(term_element, page_title, term_italicized)
       end
 
       types.each do |type|
@@ -150,18 +154,18 @@ module Kitchen::Directions::BakeIndex
       end
     end
 
-    def add_term_to_index(term_element, page_title)
+    def add_term_to_index(term_element, page_title, term_italicized)
       type =
         if !term_element.key?('index')
           'term'
-        elsif term_element['cxlxt:index'] == 'name'
+        elsif term_element['cxlxt:index'] == 'name' || term_element['index'] == 'name'
           'name'
-        elsif term_element['cxlxt:index'] == 'foreign'
+        elsif term_element['cxlxt:index'] == 'foreign' || term_element['index'] == 'foreign'
           'foreign'
         end
 
       if term_element.key?('reference')
-        term_reference = term_element['cmlnle:reference']
+        term_reference = term_element['cmlnle:reference'] || term_element['reference']
         group_by = term_reference[0]
         content = term_reference
       else
@@ -175,6 +179,7 @@ module Kitchen::Directions::BakeIndex
       # Add it to our index object
       @indexes[type].add_term(
         Term.new(
+          italicized: term_italicized,
           text: content,
           id: term_element.id,
           group_by: group_by,

data/lib/kitchen/directions/bake_index/v1.xhtml.erb

@@ -13,7 +13,7 @@
         <div class="os-index-item">
           <%- item.terms.each_with_index do |term, ii| -%>
             <%- if ii == 0 -%>
-              <span class="os-term" group-by="<%= term.group_by %>"><%= term.text %></span>
+              <span class="os-term" group-by="<%= term.group_by %>"><%- if term.italicized -%><em data-effect="italics"><%= term.text %></em><%- else -%><%= term.text %><% end %></span>
             <%- else -%><span class="os-index-link-separator">, </span><% end %>
             <a class="os-term-section-link" href="#<%= term.id %>"><span class="os-term-section"><%= term.page_title %></span></a><!--
           --><%- end %>

data/lib/kitchen/directions/bake_link_placeholders.rb

@@ -9,7 +9,7 @@ module Kitchen
         book.search('a').each do |anchor|
           next unless anchor.text == '[link]'
 
-          label_case = anchor['cmlnle:case']
+          label_case = anchor['cmlnle:case'] || anchor['case']
           id = anchor[:href][1..-1]
 
           if cases

data/lib/kitchen/directions/bake_numbered_table/bake_table_body.rb

@@ -40,12 +40,17 @@ module Kitchen
           table.remove_attribute('summary')
           table.wrap(%(<div class="os-table">))
 
+          table.search('th').each do |header|
+            header[:scope] = 'col'
+          end
+
           # Store label information
           table.target_label(label_text: 'table', custom_content: number, cases: cases)
 
           if table.top_titled?
+            klass = table.text_heavy? ? 'text-heavy-top-titled' : 'top-titled'
             custom_table = CustomBody.new(table: table,
-                                          klass: 'top-titled',
+                                          klass: klass,
                                           fake_title_class: 'os-table-title',
                                           fake_title: table.title,
                                           to_trash: table.title_row)

data/lib/kitchen/directions/bake_references/v1.rb

@@ -8,7 +8,7 @@ module Kitchen::Directions::BakeReferences
       book.chapters.each do |chapter|
         chapter.search('[data-type="cite"]').each do |link|
           link.prepend(child:
-            <<~HTML
+            <<~HTML.chomp
               <sup class="os-citation-number">#{link.count_in(:chapter)}</sup>
             HTML
           )
@@ -21,10 +21,10 @@ module Kitchen::Directions::BakeReferences
           next unless link_sibling&.raw&.attr('data-type') == 'cite'
 
           link.prepend(sibling:
-            <<~HTML
-              <span class="os-reference-link-separator">, </span>
+            <<~HTML.strip.chomp
+              <span class="os-reference-link-separator"><sup>, </sup></span>
             HTML
-            )
+          )
         end
 
         chapter.references.each do |reference|

data/lib/kitchen/directions/bake_screenreader_spans.rb

@@ -6,17 +6,51 @@ module Kitchen
       # Add text for accessibility.
       # Additional screenreader spans can be added below.
       def self.v1(book:)
+        book.search('u[data-effect="underline"]').each do |element|
+          add_screenreader_text(
+            element: element,
+            begin_message: I18n.t(:'screenreader.underline'),
+            end_message: "#{I18n.t(:'screenreader.end')} #{I18n.t(:'screenreader.underline')}"
+          )
+        end
         book.search('u[data-effect="double-underline"]').each do |element|
-          element.add_previous_sibling(
-            '<span data-screenreader-only="true">double underline</span>'
+          add_screenreader_text(
+            element: element,
+            begin_message: I18n.t(:'screenreader.double-underline'),
+            end_message: "#{I18n.t(:'screenreader.end')} #{I18n.t(:'screenreader.double-underline')}"
           )
         end
-        book.search('u[data-effect="underline"]').each do |element|
-          element.add_previous_sibling(
-            '<span data-screenreader-only="true">underline</span>'
+        book.search('p.public-domain').each do |element|
+          add_screenreader_text(
+            element: element,
+            begin_message: I18n.t(:'screenreader.public-domain'),
+            end_message: "#{I18n.t(:'screenreader.end')} #{I18n.t(:'screenreader.public-domain')}"
+          )
+        end
+        book.search('p.student-sample').each do |element|
+          add_screenreader_text(
+            element: element,
+            begin_message: I18n.t(:'screenreader.student-sample'),
+            end_message: "#{I18n.t(:'screenreader.end')} #{I18n.t(:'screenreader.student-sample')}"
+          )
+        end
+        book.search('p.annotation-text').each do |element|
+          add_screenreader_text(
+            element: element,
+            begin_message: I18n.t(:'screenreader.annotation-text'),
+            end_message: "#{I18n.t(:'screenreader.end')} #{I18n.t(:'screenreader.annotation-text')}"
           )
         end
       end
+
+      def self.add_screenreader_text(element:, begin_message:, end_message:)
+        element.prepend(child:
+          "<span data-screenreader-only=\"true\">#{begin_message}</span>"
+        )
+        element.append(child:
+          "<span data-screenreader-only=\"true\">#{end_message}</span>"
+        )
+      end
     end
   end
 end

data/lib/kitchen/directions/bake_toc.rb

@@ -100,7 +100,8 @@ module Kitchen
                   page.has_ancestor?(:composite_chapter)
               'os-toc-unit-page'
             else
-              raise "do not know what TOC class to use for page with classes #{page.classes}"
+              raise "could not detect which page type class to apply for page.id `#{page.id}`
+               during baking the TOC. The classes on the page are: `#{page.classes}`"
             end
           when CompositePageElement
             if page.is_index? || page.is_index_of_type?
@@ -112,10 +113,12 @@ module Kitchen
             elsif page.has_ancestor?(:composite_chapter) || page.has_ancestor?(:chapter)
               'os-toc-chapter-composite-page'
             else
-              raise "do not know what TOC class to use for page with classes #{page.classes}"
+              raise "could not detect which composite page type class to apply to TOC for page id \
+              `#{page.id}` during baking the TOC. The classes on the page are: `#{page.classes}`"
             end
           else
-            raise(ArgumentError, "don't know how to put `#{page.class}` into the TOC")
+            raise(ArgumentError, "could not detect any page type class to apply for `#{page.id}` \
+            during baking TOC")
           end
 
         title = page.title.copy

data/lib/kitchen/directions/bake_unit_page_title/v1.rb

@@ -4,17 +4,23 @@ module Kitchen::Directions::BakeUnitPageTitle
   class V1
     def bake(book:)
       book.units.each do |unit|
+        @unit_title = I18n.t(:unit)
+        @unit_number = unit.count_in(:book)
         unit.element_children.only(Kitchen::PageElement).each do |page|
-          compose_unit_page_title(page: page)
+          compose_unit_page_title(page: page, unit_title_prefix: @unit_title,
+                                  unit_number: @unit_number)
         end
       end
     end
 
-    def compose_unit_page_title(page:)
+    def compose_unit_page_title(page:, unit_title_prefix:, unit_number:)
       title = page.title
       title.name = 'h2'
       title.replace_children(with:
         <<~HTML
+          <span class="os-part-text">#{unit_title_prefix} </span>
+          <span class="os-number">#{unit_number}</span>
+          <span class="os-divider"> </span>
           <span data-type="" itemprop="" class="os-text">#{title.text}</span>
         HTML
       )

data/lib/kitchen/directions/bake_unnumbered_tables.rb

@@ -10,6 +10,10 @@ module Kitchen
           table.parent.add_class('os-unstyled-container') if table.unstyled?
           table.parent.add_class('os-column-header-container') if table.column_header?
           table.parent.add_class('os-top-titled-container') if table.top_titled?
+
+          table.search('th').each do |header|
+            header[:scope] = 'col'
+          end
         end
       end
     end

data/lib/kitchen/directions/move_solutions_to_answer_key/answer_key_cleaner.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Kitchen::Directions::AnswerKeyCleaner
+  def self.v1(book:)
+    V1.new.bake(book: book)
+  end
+
+  class V1
+    renderable
+
+    def bake(book:)
+      answer_key_chapters = book.search(
+        '.os-eob[data-type="composite-chapter"] > [data-type="composite-page"]')
+      answer_key_chapters.each do |container|
+        container.trash unless container.contains?('[data-type="solution"]')
+      end
+    end
+  end
+end

data/lib/kitchen/element_base.rb

@@ -223,6 +223,22 @@ module Kitchen
       self[:'data-type']
     end
 
+    # Returns the element's href
+    #
+    # @return [String]
+    #
+    def href
+      self[:href]
+    end
+
+    # Sets the element's href
+    #
+    # @param value [String] the new value for the href
+    #
+    def href=(value)
+      self[:href] = value
+    end
+
     # A way to set values and chain them
     #
     # @param property [String, Symbol] the name of the property to set
@@ -511,7 +527,7 @@ module Kitchen
     # nil if there's no previous sibling
     #
     def previous
-      prev = raw.previous
+      prev = raw.previous_element
       return prev if prev.nil?
 
       Element.new(

data/lib/kitchen/patches/integer.rb

@@ -3,7 +3,22 @@
 # Monkey patches for +Integer+
 #
 class Integer
-  ROMAN_NUMERALS = %w[0 i ii iii iv v vi vii viii ix x xi xii xiii xiv xv xvi xvii xviii xix xx].freeze
+
+  @roman_numerals = {
+    100 => 'c',
+    90 => 'xc',
+    50 => 'l',
+    40 => 'xl',
+    10 => 'x',
+    9 => 'ix',
+    5 => 'v',
+    4 => 'iv',
+    1 => 'i'
+  }
+
+  class << self
+    attr_accessor :roman_numerals
+  end
 
   # Formats as different types of integers, including roman numerals.
   #
@@ -14,11 +29,25 @@ class Integer
     when :arabic
       to_s
     when :roman
-      raise 'Unknown conversion to Roman numerals' if self >= ROMAN_NUMERALS.size
+      raise 'Unknown conversion to Roman numerals' if self > self.class.roman_numerals.keys.first
 
-      ROMAN_NUMERALS[self]
+      to_roman
     else
       raise 'Unknown integer format'
     end
   end
+
+  def to_roman
+    return 0 if zero?
+
+    roman = ''
+    integer = self
+    self.class.roman_numerals.each do |number, letter|
+      until integer < number
+        roman += letter
+        integer -= number
+      end
+    end
+    roman
+  end
 end

data/lib/kitchen/patches/nokogiri.rb

@@ -67,13 +67,6 @@ module Nokogiri
         self[:class]&.split || []
       end
 
-      def previous
-        prev = previous_element
-        return nil if prev.nil?
-
-        prev.text? ? prev.previous : prev
-      end
-
       def preceded_by_text?
         prev = previous_sibling
         while !prev.nil? && prev.blank? do prev = prev.previous_sibling end

data/lib/kitchen/version.rb

@@ -3,5 +3,5 @@
 # A library for modifying the structure of OpenStax book XML.
 #
 module Kitchen
-  VERSION = '16.0.0'
+  VERSION = '19.0.0'
 end

data/lib/locales/en.yml

@@ -46,3 +46,25 @@ en:
     reference: References
   index:
     main: Index
+  annotation_icons:
+    linguistic-icon:
+      title: Language lens icon
+    culture-icon:
+      title: Culture lens icon
+    dreaming-icon:
+      title: Generating and capturing ideas icon
+    visual-icon:
+      title: Visual learning style icon
+    speech-icon:
+      title: Voice to text icon
+    auditory-icon:
+      title: Auditory learning style icon
+    kinesthetic-icon:
+      title: Kinesthetic learning style icon
+  screenreader:
+    end: end
+    underline: underline
+    double-underline: double underline
+    public-domain: public domain text
+    student-sample: student sample text
+    annotation-text: annotated text

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openstax_kitchen
 version: !ruby/object:Gem::Version
-  version: 16.0.0
+  version: 19.0.0
 platform: ruby
 authors:
 - JP Slavinsky
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-11-19 00:00:00.000000000 Z
+date: 2022-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -265,6 +265,8 @@ files:
 - lib/kitchen/directions/bake_chapter_key_equations.rb
 - lib/kitchen/directions/bake_chapter_references/main.rb
 - lib/kitchen/directions/bake_chapter_references/v1.rb
+- lib/kitchen/directions/bake_chapter_references/v2.rb
+- lib/kitchen/directions/bake_chapter_references/v3.rb
 - lib/kitchen/directions/bake_chapter_section_exercises/main.rb
 - lib/kitchen/directions/bake_chapter_section_exercises/v1.rb
 - lib/kitchen/directions/bake_chapter_solutions/main.rb
@@ -281,6 +283,8 @@ files:
 - lib/kitchen/directions/bake_eoc_section_content/remove_section_title.rb
 - lib/kitchen/directions/bake_equations.rb
 - lib/kitchen/directions/bake_example.rb
+- lib/kitchen/directions/bake_exercise_prefixes/main.rb
+- lib/kitchen/directions/bake_exercise_prefixes/v1.rb
 - lib/kitchen/directions/bake_figure.rb
 - lib/kitchen/directions/bake_first_elements.rb
 - lib/kitchen/directions/bake_folio.rb
@@ -355,6 +359,7 @@ files:
 - lib/kitchen/directions/move_exercises_to_eoc/v1.rb
 - lib/kitchen/directions/move_exercises_to_eoc/v2.rb
 - lib/kitchen/directions/move_exercises_to_eoc/v3.rb
+- lib/kitchen/directions/move_solutions_to_answer_key/answer_key_cleaner.rb
 - lib/kitchen/directions/move_solutions_to_answer_key/answer_key_inner_container.rb
 - lib/kitchen/directions/move_solutions_to_answer_key/move_solutions_from_exercise_section.rb
 - lib/kitchen/directions/move_solutions_to_answer_key/move_solutions_from_numbered_note.rb