openstax_kitchen 8.0.1 → 9.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50c444687ca21462df4d8110fd8789f10ba40a439b5d037b3eba8d255b5e16fa
-  data.tar.gz: 353afbf616ae3f9794ee13594cf9baa244fbc1077e55c78c193aac1a89cefffd
+  metadata.gz: fca2eb47435f5ff74342d7de2afc02e2c55eed224f1ae669b440d52a1c50b1b0
+  data.tar.gz: f22d42bc7618868d1890e149d9e0bf5134945b8fccce5c7742827e6c53589d81
 SHA512:
-  metadata.gz: 0b52d4418f83bdacfac36d7d6c904500cd4bb965795f91e718c6588e0f27c72eb5b73d9b05db9f2bafa60711717c93888a0d09ced10c6986e7ec0a83d7283a31
-  data.tar.gz: 34ebd35add4868907853f3a3e4cc839f521352d3eadc763350487e5a7f372f947e6e837d0fea7ad198810d968c1e1bfc7a591f515b65218253c084db21b85a45
+  metadata.gz: a457781d0bcb61533c5b96ca0b2ffcde74a69743a54c09f4b901b7e769056d1d616afa736df40067e7472a479c8526505d72fe5d7e9ecf3eca6789581d92c380
+  data.tar.gz: 9f517fbc86ae32e0fd2bbc108774a9f4b94a63df01675530c7f26d7f9bf9522654f4ddb5d7e1c9d141b1a67a0ccc6a98ac2f8c0cf94719ccf04b67cfbf69f240

data/CHANGELOG.md

@@ -6,6 +6,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.0.0] - 2021-07-12
+
+* Refactor `BakeChapterKeyConcepts`, `BakeChapterReferences`, `BakeChapterSolutions`, and `MoveExercisesToEoc` versions 1-3 to use new general eoc directions (major?)
+* Fixed `BakeExample.v1` to also search inside `.body` for titles (minor)
+* Add documentation to `MoveCustomSectionToEocContainer` & `EocCompositePageContainer` (minor)
+* Add a `MoveCustomSectionToEocContainer` to allow for custom sections (minor)
+* Add a `EocCompositePageContainer` direction to handle creation of eoc page wrapper (minor)
+* Refactor `BakeChapterKeyEquations`, `BakeChapterGlossary`, `BakeChapterSummary`, `BakeFurtherResearch` (major)
+* Fix metadata title in composite pages (major)
 
 ## [8.0.1] - 2021-06-29
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    openstax_kitchen (8.0.1)
+    openstax_kitchen (9.0.0)
       activesupport
       i18n
       nokogiri

data/lib/kitchen/chapter_element.rb

@@ -52,14 +52,6 @@ module Kitchen
       search("div[data-type='glossary']")
     end
 
-    # Returns an enumerator for the key equations
-    #
-    # @return [ElementEnumerator]
-    #
-    def key_equations
-      search('section.key-equations')
-    end
-
     # Returns an enumerator for the abstracts
     #
     # @return [ElementEnumerator]

data/lib/kitchen/directions/.rubocop.yml

@@ -15,6 +15,9 @@ Metrics/CyclomaticComplexity:
 Metrics/PerceivedComplexity:
   Enabled: false
 
+Metrics/ParameterLists:
+  Max: 5
+
 Style/ClassAndModuleChildren:
   Enabled: false
 

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

@@ -2,8 +2,6 @@
 
 module Kitchen::Directions::BakeChapterGlossary
   class V1
-    renderable
-
     class Definition
       attr_reader :element
 
@@ -24,10 +22,6 @@ module Kitchen::Directions::BakeChapterGlossary
     end
 
     def bake(chapter:, metadata_source:, append_to: nil, uuid_prefix: '')
-      @metadata = metadata_source.children_to_keep.copy
-      @klass = 'glossary'
-      @title = I18n.t(:eoc_key_terms_title)
-      @uuid_prefix = uuid_prefix
       @glossary = []
 
       chapter.glossaries.search('dl').each do |definition_element|
@@ -36,13 +30,15 @@ module Kitchen::Directions::BakeChapterGlossary
 
       chapter.glossaries.trash
 
-      @content = @glossary.sort.map { |definition| definition.element.paste }.join
-
-      append_to_element = append_to || chapter
-      @in_composite_chapter = append_to_element.is?(:composite_chapter)
+      content = @glossary.sort.map { |definition| definition.element.paste }.join
 
-      append_to_element.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: 'glossary',
+        uuid_key: "#{uuid_prefix}glossary",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: append_to || chapter
+      )
     end
   end
 end

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

@@ -2,34 +2,30 @@
 
 module Kitchen::Directions::BakeChapterKeyConcepts
   class V1
-    renderable
     def bake(chapter:, metadata_source:, append_to:, uuid_prefix:)
-      @metadata = metadata_source.children_to_keep.copy
-      @klass = 'key-concepts'
-      @title = I18n.t(:eoc_key_concepts)
-      @uuid_prefix = uuid_prefix
-
       key_concepts_clipboard = Kitchen::Clipboard.new
       chapter.non_introduction_pages.each do |page|
         key_concepts = page.key_concepts
         next if key_concepts.none?
 
-        key_concepts.search('h3').trash
         title = Kitchen::Directions::EocSectionTitleLinkSnippet.v1(page: page)
         key_concepts.each do |key_concept|
+          Kitchen::Directions::RemoveSectionTitle.v1(section: key_concept)
           key_concept.prepend(child: title)
           key_concept.wrap("<div class='os-section-area'>")
           page.search('div.os-section-area').first.cut(to: key_concepts_clipboard)
         end
       end
 
-      @content = "<div class=\"os-key-concepts\"> #{key_concepts_clipboard.paste} </div>"
-
-      append_to_element = append_to || chapter
-      @in_composite_chapter = append_to_element.is?(:composite_chapter)
+      content = "<div class=\"os-key-concepts\"> #{key_concepts_clipboard.paste} </div>"
 
-      append_to_element.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: 'key-concepts',
+        uuid_key: "#{uuid_prefix}key-concepts",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: append_to || chapter
+      )
     end
   end
 end

data/lib/kitchen/directions/bake_chapter_key_equations.rb

@@ -15,24 +15,17 @@ module Kitchen
       end
 
       class V1
-        renderable
         def bake(chapter:, metadata_source:, append_to:, uuid_prefix:)
-          @metadata = metadata_source.children_to_keep.copy
-          @klass = 'key-equations'
-          @title = I18n.t(:eoc_key_equations)
-          @uuid_prefix = uuid_prefix
-
-          chapter.key_equations.search('h3').trash
-
-          return if chapter.key_equations.none?
-
-          @content = chapter.key_equations.cut.paste
-
-          append_to_element = append_to || chapter
-          @in_composite_chapter = append_to_element.is?(:composite_chapter)
-
-          append_to_element.append(child: render(file:
-            '../templates/eoc_section_title_template.xhtml.erb'))
+          MoveCustomSectionToEocContainer.v1(
+            chapter: chapter,
+            metadata_source: metadata_source,
+            container_key: 'key-equations',
+            uuid_key: "#{uuid_prefix}key-equations",
+            section_selector: 'section.key-equations',
+            append_to: append_to
+          ) do |section|
+            RemoveSectionTitle.v1(section: section)
+          end
         end
       end
     end

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

@@ -2,25 +2,22 @@
 
 module Kitchen::Directions::BakeChapterReferences
   class V1
-    renderable
-
     def bake(chapter:, metadata_source:, uuid_prefix: '.', klass: 'references')
-      @metadata = metadata_source.children_to_keep.copy
-      @klass = klass
-      @title = I18n.t(:references)
-      @uuid_prefix = uuid_prefix
-
-      chapter.references.search('h3').trash
-
       bake_page_references(page: chapter.introduction_page)
 
       chapter.non_introduction_pages.each do |page|
         bake_page_references(page: page)
       end
 
-      @content = chapter.pages.references.cut.paste
-      chapter.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
+      content = chapter.pages.references.cut.paste
+
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: klass,
+        uuid_key: "#{uuid_prefix}#{klass}",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: chapter
+      )
     end
 
     def bake_page_references(page:)
@@ -42,6 +39,7 @@ module Kitchen::Directions::BakeChapterReferences
               end
 
       references.each do |reference|
+        Kitchen::Directions::RemoveSectionTitle.v1(section: reference)
         reference.prepend(child: title)
       end
     end

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

@@ -2,14 +2,7 @@
 
 module Kitchen::Directions::BakeChapterSolutions
   class V1
-    renderable
-
     def bake(chapter:, metadata_source:, uuid_prefix: '')
-      @metadata = metadata_source.children_to_keep.copy
-      @klass = 'solutions'
-      @title = I18n.t(:eoc_solutions_title)
-      @uuid_prefix = uuid_prefix
-
       solutions_clipboard = Kitchen::Clipboard.new
 
       chapter.search('section.free-response').each do |free_response_question|
@@ -26,12 +19,15 @@ module Kitchen::Directions::BakeChapterSolutions
         end
       end
 
-      @content = solutions_clipboard.paste
-
-      @in_composite_chapter = false
+      content = solutions_clipboard.paste
 
-      chapter.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: 'solutions',
+        uuid_key: "#{uuid_prefix}solutions",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: chapter
+      )
     end
   end
 end

data/lib/kitchen/directions/bake_chapter_summary.rb

@@ -15,52 +15,30 @@ module Kitchen
       end
 
       class V1
-        renderable
         def bake(chapter:, metadata_source:, uuid_prefix: '.', klass: 'summary')
-          @metadata = metadata_source.children_to_keep.copy
-          @klass = klass
-          @title = I18n.t(:eoc_summary_title)
-          @uuid_prefix = uuid_prefix
-
           summaries = Clipboard.new
 
-          # TODO: include specific page types somehow without writing it out
           chapter.non_introduction_pages.each do |page|
             summary = page.summary
 
             next if summary.nil?
 
             summary.first("[data-type='title']")&.trash # get rid of old title if exists
-            summary_title = page.title.copy
-            summary_title.name = 'h3'
-
-            unless summary_title.children.search('span.os-number').present?
-              summary_title.replace_children(with:
-                <<~HTML
-                  <span class="os-number">#{chapter.count_in(:book)}.#{page.count_in(:chapter)}</span>
-                  <span class="os-divider"> </span>
-                  <span class="os-text" data-type="" itemprop="">#{summary_title.children}</span>
-                HTML
-              )
-            end
-
-            summary.prepend(child:
-              <<~HTML
-                <a href="##{page.title.id}">
-                  #{summary_title.paste}
-                </a>
-              HTML
-            )
+            title = EocSectionTitleLinkSnippet.v1(page: page)
+            summary.prepend(child: title)
+            summary.first('h3')[:itemprop] = 'name'
             summary.cut(to: summaries)
           end
 
           return if summaries.none?
 
-          @content = summaries.paste
-          @in_composite_chapter = false
-
-          chapter.append(child: render(file:
-            '../templates/eoc_section_title_template.xhtml.erb'))
+          EocCompositePageContainer.v1(
+            container_key: klass,
+            uuid_key: "#{uuid_prefix}#{klass}",
+            metadata_source: metadata_source,
+            content: summaries.paste,
+            append_to: chapter
+          )
         end
       end
     end

data/lib/kitchen/directions/bake_eoc_section_content/remove_section_title.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Kitchen
+  module Directions
+    module RemoveSectionTitle
+      def self.v1(section:)
+        section.first('[data-type="title"]')&.trash
+      end
+    end
+  end
+end

data/lib/kitchen/directions/bake_further_research.rb

@@ -13,47 +13,21 @@ module Kitchen
       end
 
       class V1
-        renderable
         def bake(chapter:, metadata_source:, uuid_prefix: '.')
-          @metadata = metadata_source.children_to_keep.copy
-          @klass = 'further-research'
-          @title = I18n.t(:eoc_further_research_title)
-          @uuid_prefix = uuid_prefix
-
-          further_researches = Clipboard.new
-
-          chapter.non_introduction_pages.each do |page|
-            further_research = page.first('.further-research')
-            next unless further_research.present?
-
-            further_research.first("[data-type='title']")&.trash # get rid of old title if exists
-            further_research_title = page.title.copy
-            further_research_title.name = 'h3'
-            further_research_title.replace_children(with: <<~HTML
-              <span class="os-number">#{chapter.count_in(:book)}.#{page.count_in(:chapter)}</span>
-              <span class="os-divider"> </span>
-              <span class="os-text" data-type="" itemprop="">#{further_research_title.children}</span>
-            HTML
-            )
-
-            further_research.prepend(child:
-              <<~HTML
-                <a href="##{page.title.id}">
-                  #{further_research_title.paste}
-                </a>
-              HTML
-            )
-            further_research.cut(to: further_researches)
+          MoveCustomSectionToEocContainer.v1(
+            chapter: chapter,
+            metadata_source: metadata_source,
+            container_key: 'further-research',
+            uuid_key: "#{uuid_prefix}further-research",
+            section_selector: 'section.further-research',
+            append_to: nil,
+            include_intro_page: false
+          ) do |further_research|
+            RemoveSectionTitle.v1(section: further_research)
+            title = EocSectionTitleLinkSnippet.v1(page: further_research.ancestor(:page))
+            further_research.prepend(child: title)
+            further_research.first('h3')[:itemprop] = 'name'
           end
-
-          return if further_researches.none?
-
-          @content = further_researches.paste
-
-          @in_composite_chapter = false
-
-          chapter.append(child: render(file:
-            '../templates/eoc_section_title_template.xhtml.erb'))
         end
       end
     end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Kitchen
+  module Directions
+    module EocCompositePageContainer
+      # Creates a wrapper for the given content & appends it to the given element
+      #
+      # @param container_key [String] Appended to 'eoc.' to form the I18n key for the container title; also used as part of a class on the container.
+      # @param uuid_key [String] the uuid key for the wrapper class, e.g. `'.summary'`
+      # @param metadata_source [MetadataElement] metadata for the book
+      # @param content [String] the content to be contained by the wrapper
+      # @param append_to [ElementBase] the element to be appended, usually either a `ChapterElement` or a `CompositeChapterElement`
+      # @return [ElementBase] the append_to element with container appended
+      #
+      def self.v1(container_key:, uuid_key:, metadata_source:, content:,
+                  append_to:)
+        V1.new.bake(
+          container_key: container_key,
+          uuid_key: uuid_key,
+          metadata_source: metadata_source,
+          content: content,
+          append_to: append_to
+        )
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Kitchen::Directions::EocCompositePageContainer
+  class V1
+    renderable
+
+    def bake(container_key:, uuid_key:, metadata_source:, content:, append_to:)
+      @title = I18n.t(:"eoc.#{container_key}")
+      @uuid_key = uuid_key
+      @container_class_type = container_key
+      @metadata = metadata_source.children_to_keep.copy
+      @content = content
+      @in_composite_chapter = append_to.is?(:composite_chapter)
+
+      append_to.append(child: render(file:
+        '../../templates/eoc_section_template.xhtml.erb'))
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/ParameterLists
+# More parameters are ok here because these generic classes DRY up a lot of other code
+module Kitchen
+  module Directions
+    module MoveCustomSectionToEocContainer
+      # Creates a custom eoc composite page for a section within the given chapter.
+      # The sections are moved into this composite page, and can be transformed before the moved by an optional block argument.
+      #
+      # @param chapter [ChapterElement] the chapter in which the section to be moved is contained
+      # @param metadata_source [MetadataElement] metadata for the book
+      # @param container_key [String] Appended to 'eoc.' to form the I18n key for the container title; also used as part of a class on the container.
+      # @param uuid_key [String] the uuid key for the wrapper class, e.g. `'.summary'`
+      # @param section_selector [String] the selector for the section to be moved, e.g. `'section.summary'`
+      # @param append_to [ElementBase] the element to be appended. Defaults to the value of `chapter` param if none given.
+      # @param include_intro_page [Boolean] control the introduction page for the chapter should be searched for a section to move, default is true
+      # @return [ElementBase] the append_to element with container appended
+      #
+      def self.v1(chapter:, metadata_source:, container_key:, uuid_key:,
+                  section_selector:, append_to: nil, include_intro_page: true)
+        V1.new.bake(
+          chapter: chapter,
+          metadata_source: metadata_source,
+          container_key: container_key,
+          uuid_key: uuid_key,
+          section_selector: section_selector,
+          append_to: append_to || chapter,
+          include_intro_page: include_intro_page
+        ) do |section|
+          yield section if block_given?
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/ParameterLists

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/ParameterLists
+# More parameters are ok here because these generic classes DRY up a lot of other code
+module Kitchen::Directions::MoveCustomSectionToEocContainer
+  class V1
+    def bake(chapter:, metadata_source:, container_key:, uuid_key:,
+             section_selector:, append_to:, include_intro_page:, &block)
+      section_clipboard = Kitchen::Clipboard.new
+      pages = include_intro_page ? chapter.pages : chapter.non_introduction_pages
+      sections = pages.search(section_selector)
+      sections.each(&block)
+      sections.cut(to: section_clipboard)
+
+      return if section_clipboard.none?
+
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: container_key,
+        uuid_key: uuid_key,
+        metadata_source: metadata_source,
+        content: section_clipboard.paste,
+        append_to: append_to || chapter
+      )
+    end
+  end
+end
+# rubocop:enable Metrics/ParameterLists

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

@@ -2,35 +2,18 @@
 
 module Kitchen::Directions::MoveExercisesToEOC
   class V1
-    renderable
-
     def bake(chapter:, metadata_source:, klass:, append_to: nil, uuid_prefix: '.')
-      @klass = klass
-      @metadata = metadata_source.children_to_keep.copy
-      @title = I18n.t(:"eoc.#{klass}")
-      @uuid_prefix = uuid_prefix
-
-      exercise_clipboard = Kitchen::Clipboard.new
-
-      chapter.non_introduction_pages.each do |page|
-        sections = page.search("section.#{@klass}")
-
-        sections.each do |exercise_section|
-          exercise_section.first("[data-type='title']")&.trash
-
-          exercise_section.cut(to: exercise_clipboard)
-        end
+      Kitchen::Directions::MoveCustomSectionToEocContainer.v1(
+        chapter: chapter,
+        metadata_source: metadata_source,
+        container_key: klass,
+        uuid_key: "#{uuid_prefix}#{klass}",
+        section_selector: "section.#{klass}",
+        append_to: append_to || chapter,
+        include_intro_page: false
+      ) do |exercise_section|
+        Kitchen::Directions::RemoveSectionTitle.v1(section: exercise_section)
       end
-
-      return if exercise_clipboard.none?
-
-      @content = exercise_clipboard.paste
-
-      append_to_element = append_to || chapter
-      @in_composite_chapter = append_to_element.is?(:composite_chapter)
-
-      append_to_element.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
     end
   end
 end

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

@@ -4,25 +4,16 @@ module Kitchen::Directions::MoveExercisesToEOC
   # Main difference from v1 is the presence of a section title
   # and some additional wrappers
   class V2
-    renderable
-
     def bake(chapter:, metadata_source:, klass:, append_to: nil, uuid_prefix: '.')
-      @klass = klass
-      @metadata = metadata_source.children_to_keep.copy
-      @title = I18n.t(:"eoc.#{klass}")
-      @uuid_prefix = uuid_prefix
-
       exercise_clipboard = Kitchen::Clipboard.new
 
       chapter.non_introduction_pages.each do |page|
-        sections = page.search("section.#{@klass}")
+        sections = page.search("section.#{klass}")
 
         sections.each do |exercise_section|
-          exercise_section.first("[data-type='title']")&.trash
-
+          Kitchen::Directions::RemoveSectionTitle.v1(section: exercise_section)
           # Get parent page title
           section_title = Kitchen::Directions::EocSectionTitleLinkSnippet.v1(page: page)
-
           # Configure section title & wrappers
           exercise_section.prepend(child: section_title)
           exercise_section.wrap('<div class="os-section-area">')
@@ -33,17 +24,19 @@ module Kitchen::Directions::MoveExercisesToEOC
 
       return if exercise_clipboard.none?
 
-      @content = <<~HTML
-        <div class="os-#{@klass}">
+      content = <<~HTML
+        <div class="os-#{klass}">
           #{exercise_clipboard.paste}
         </div>
       HTML
 
-      append_to_element = append_to || chapter
-      @in_composite_chapter = append_to_element[:'data-type'] == 'composite-chapter'
-
-      append_to_element.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
+      Kitchen::Directions::EocCompositePageContainer.v1(
+        container_key: klass,
+        uuid_key: "#{uuid_prefix}#{klass}",
+        metadata_source: metadata_source,
+        content: content,
+        append_to: append_to || chapter
+      )
     end
   end
 end

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

@@ -4,46 +4,22 @@ module Kitchen::Directions::MoveExercisesToEOC
   # The difference from v1 is the presence of a section title
   # and from v2 the lack of additional "os-section-area" and os-#{@klass} wrappers
   class V3
-    renderable
-
     def bake(chapter:, metadata_source:, klass:, append_to: nil, uuid_prefix: '.')
-      @klass = klass
-      @metadata = metadata_source.children_to_keep.copy
-      @title = I18n.t(:"eoc.#{klass}")
-      @uuid_prefix = uuid_prefix
-
-      exercise_clipboard = Kitchen::Clipboard.new
-
-      chapter.non_introduction_pages.each do |page|
-        sections = page.search("section.#{@klass}")
-
-        sections.each do |exercise_section|
-          exercise_section.first("[data-type='title']")&.trash
-
-          section_title = Kitchen::Directions::EocSectionTitleLinkSnippet.v1(page: page)
-
-          exercise_section.exercises.each do |exercise|
-            exercise.document.pantry(name: :link_text).store(
-              "#{I18n.t(:exercise_label)} #{chapter.count_in(:book)}.#{exercise.count_in(:chapter)}",
-              label: exercise.id
-            )
-          end
-
-          # Configure section title
-          exercise_section.prepend(child: section_title)
-          exercise_section.cut(to: exercise_clipboard)
-        end
+      Kitchen::Directions::MoveCustomSectionToEocContainer.v1(
+        chapter: chapter,
+        metadata_source: metadata_source,
+        container_key: klass,
+        uuid_key: "#{uuid_prefix}#{klass}",
+        section_selector: "section.#{klass}",
+        append_to: append_to || chapter,
+        include_intro_page: false
+      ) do |exercise_section|
+        Kitchen::Directions::RemoveSectionTitle.v1(section: exercise_section)
+        title = Kitchen::Directions::EocSectionTitleLinkSnippet.v1(
+          page: exercise_section.ancestor(:page)
+        )
+        exercise_section.prepend(child: title)
       end
-
-      return if exercise_clipboard.none?
-
-      @content = exercise_clipboard.paste
-
-      append_to_element = append_to || chapter
-      @in_composite_chapter = append_to_element.is?(:composite_chapter)
-
-      append_to_element.append(child: render(file:
-        '../../templates/eoc_section_title_template.xhtml.erb'))
     end
   end
 end

data/lib/kitchen/example_element.rb

@@ -28,7 +28,7 @@ module Kitchen
     # @return [ElementEnumerator]
     #
     def titles
-      search("span[data-type='title']")
+      search("[data-type='title']")
     end
 
   end

data/lib/kitchen/templates/eoc_section_template.xhtml.erb

@@ -0,0 +1,11 @@
+<% main_title_tag = @in_composite_chapter ? 'h3' : 'h2' %>
+<div class="os-eoc os-<%=@container_class_type%>-container" data-type="composite-page" data-uuid-key="<%= @uuid_key %>">
+  <<%= main_title_tag %> data-type="<%= @in_composite_chapter ? 'title' : 'document-title' %>">
+    <span class="os-text"><%= @title %></span>
+  </<%= main_title_tag %>>
+  <div data-type="metadata" style="display: none;">
+    <h1 data-type="document-title" itemprop="name"><%= @title %></h1>
+    <%= @metadata.paste %>
+  </div>
+  <%= @content %>
+</div>

data/lib/kitchen/templates/eoc_section_template_old.xhtml.erb

@@ -0,0 +1,11 @@
+<% main_title_tag = @in_composite_chapter ? 'h3' : 'h2' %>
+<div class="os-eoc os-<%=@klass%>-container" data-type="composite-page" data-uuid-key="<%=@uuid_prefix%><%=@klass%>">
+  <<%= main_title_tag %> data-type="<%= @in_composite_chapter ? 'title' : 'document-title' %>">
+    <span class="os-text"><%= @title %></span>
+  </<%= main_title_tag %>>
+  <div data-type="metadata" style="display: none;">
+    <h1 data-type="document-title" itemprop="name"><%= @title %></h1>
+    <%= @metadata.paste %>
+  </div>
+  <%= @content %>
+</div>

data/lib/kitchen/version.rb

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

data/lib/locales/en.yml

@@ -18,16 +18,18 @@ en:
   references: References
   answer_key_title: Answer Key
   eoc_chapter_review: Chapter Review
-  eoc_key_terms_title: Key Terms
-  eoc_summary_title: Summary
   eoc_exercises_title: Exercises
   eoc_composite_metadata_title: Chapter Review
   eoc_solutions_title: Solutions
-  eoc_key_concepts: Key Concepts
-  eoc_key_equations: Key Equations
   eoc_suggested_reading: Suggestions for Further Study
-  eoc_further_research_title: Further Research
   eob_index_title: Index
   eob_index_symbols_group: Symbols
   review_exercises: Review Exercises
   section_exercises: ! 'Section %{number} Exercises'
+  eoc:
+    glossary: Key Terms
+    key-equations: Key Equations
+    summary: Summary
+    further-research: Further Research
+    key-concepts: Key Concepts
+    references: References

data/lib/locales/es.yml

@@ -18,16 +18,18 @@ es:
   references: Referencias
   answer_key_title: Clave de Respuestas
   eoc_chapter_review: Revisión Del Capítulo
-  eoc_key_terms_title: Términos Clave
-  eoc_summary_title: Resumen
   eoc_exercises_title: Ejercicios
   eoc_composite_metadata_title: Revisión Del Capítulo
   eoc_solutions_title: Soluciones
   eoc_key_concepts: Conceptos Clave
-  eoc_key_equations: Ecuaciones Clave
   eoc_suggested_reading: Sugerencias Para Estudios Adicionales
-  eoc_further_research_title: Investigación Adicional
   eob_index_title: Índice
   eob_index_symbols_group: Símbolos
   review_exercises: Ejercicios De Repaso
   section_exercises: ! 'Sección %{number} Ejercicios'
+  eoc:
+    glossary: Términos Clave
+    key-equations: Ecuaciones Clave
+    summary: Resumen
+    further-research: Investigación Adicional
+    references: Referencias

data/lib/locales/pl.yml

@@ -16,11 +16,13 @@ pl:
   stepwise_step_label: Krok
   answer_key_title: Rozwiązania zadań
   eoc_chapter_review: Podsumowanie rozdziału
-  eoc_key_terms_title: Kluczowe pojęcia
   eoc_solutions_title: Rozwiązania
-  eoc_summary_title: Podsumowanie
-  eoc_key_equations: Najważniejsze wzory
   eob_index_title: Skorowidz rzeczowy
   eob_index_symbols_group: Symbole
   references: Bibliografia
+  eoc:
+    glossary: Kluczowe pojęcia
+    key-equations: Najważniejsze wzory
+    summary: Podsumowanie
+    references: Bibliografia
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openstax_kitchen
 version: !ruby/object:Gem::Version
-  version: 8.0.1
+  version: 9.0.0
 platform: ruby
 authors:
 - JP Slavinsky
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-06-29 00:00:00.000000000 Z
+date: 2021-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -263,6 +263,7 @@ files:
 - lib/kitchen/directions/bake_checkpoint.rb
 - lib/kitchen/directions/bake_composite_chapters.rb
 - lib/kitchen/directions/bake_composite_pages.rb
+- 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_figure.rb
@@ -313,7 +314,11 @@ files:
 - lib/kitchen/directions/chapter_review_container/chapter_review.xhtml.erb
 - lib/kitchen/directions/chapter_review_container/main.rb
 - lib/kitchen/directions/chapter_review_container/v1.rb
+- lib/kitchen/directions/eoc_composite_page_container/main.rb
+- lib/kitchen/directions/eoc_composite_page_container/v1.rb
 - lib/kitchen/directions/eoc_section_title_link_snippet.rb
+- lib/kitchen/directions/move_custom_section_to_eoc_container/main.rb
+- lib/kitchen/directions/move_custom_section_to_eoc_container/v1.rb
 - lib/kitchen/directions/move_exercises_to_eoc/main.rb
 - lib/kitchen/directions/move_exercises_to_eoc/v1.rb
 - lib/kitchen/directions/move_exercises_to_eoc/v2.rb
@@ -368,7 +373,8 @@ files:
 - lib/kitchen/table_element.rb
 - lib/kitchen/table_element_enumerator.rb
 - lib/kitchen/templates/eob_section_title_template.xhtml.erb
-- lib/kitchen/templates/eoc_section_title_template.xhtml.erb
+- lib/kitchen/templates/eoc_section_template.xhtml.erb
+- lib/kitchen/templates/eoc_section_template_old.xhtml.erb
 - lib/kitchen/term_element.rb
 - lib/kitchen/term_element_enumerator.rb
 - lib/kitchen/type_casting_element_enumerator.rb

data/lib/kitchen/templates/eoc_section_title_template.xhtml.erb

@@ -1,10 +0,0 @@
-<div class="os-eoc os-<%=@klass%>-container" data-type="composite-page" data-uuid-key="<%=@uuid_prefix%><%=@klass%>">
-  <<%= @in_composite_chapter ? 'h3' : 'h2' %> data-type="<%= @in_composite_chapter ? 'title' : 'document-title' %>">
-    <span class="os-text"><%= @title %></span>
-  </<%= @in_composite_chapter ? 'h3' : 'h2' %>>
-  <div data-type="metadata" style="display: none;">
-    <h1 data-type="document-title" itemprop="name"><%= @in_composite_chapter ? I18n.t(:eoc_composite_metadata_title) : @title %></h1>
-    <%= @metadata.paste %>
-  </div>
-  <%= @content %>
-</div>