openstax_kitchen 2.0.0 → 3.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (133) hide show
  1. checksums.yaml +4 -4
  2. data/.devcontainer/devcontainer.json +37 -17
  3. data/.github/config.yml +14 -0
  4. data/.github/workflows/tests.yml +5 -15
  5. data/.gitignore +1 -1
  6. data/.inch.yml +6 -0
  7. data/.rubocop.yml +65 -0
  8. data/CHANGELOG.md +16 -0
  9. data/Gemfile +5 -3
  10. data/Gemfile.lock +54 -5
  11. data/README.md +58 -11
  12. data/Rakefile +5 -3
  13. data/bin/console +4 -3
  14. data/docker/Dockerfile +36 -0
  15. data/docker/Dockerfile.ci +10 -0
  16. data/docker/bash +5 -1
  17. data/docker/build +10 -0
  18. data/docker/ci +16 -0
  19. data/docker/run +9 -0
  20. data/docker/tag_and_push_latest +17 -0
  21. data/lefthook.yml +6 -0
  22. data/lib/kitchen/ancestor.rb +38 -1
  23. data/lib/kitchen/book_document.rb +20 -2
  24. data/lib/kitchen/book_element.rb +24 -3
  25. data/lib/kitchen/book_element_enumerator.rb +4 -0
  26. data/lib/kitchen/book_recipe.rb +15 -1
  27. data/lib/kitchen/chapter_element.rb +43 -3
  28. data/lib/kitchen/chapter_element_enumerator.rb +9 -1
  29. data/lib/kitchen/clipboard.rb +35 -4
  30. data/lib/kitchen/composite_chapter_element.rb +20 -1
  31. data/lib/kitchen/composite_page_element.rb +25 -2
  32. data/lib/kitchen/composite_page_element_enumerator.rb +8 -0
  33. data/lib/kitchen/config.rb +14 -7
  34. data/lib/kitchen/counter.rb +9 -2
  35. data/lib/kitchen/debug/print_recipe_error.rb +53 -35
  36. data/lib/kitchen/directions/.rubocop.yml +22 -0
  37. data/lib/kitchen/directions/bake_appendix.rb +4 -4
  38. data/lib/kitchen/directions/bake_chapter_glossary.rb +10 -7
  39. data/lib/kitchen/directions/bake_chapter_introductions.rb +6 -6
  40. data/lib/kitchen/directions/bake_chapter_key_equations.rb +9 -6
  41. data/lib/kitchen/directions/bake_chapter_summary.rb +16 -13
  42. data/lib/kitchen/directions/bake_chapter_title/main.rb +11 -0
  43. data/lib/kitchen/directions/bake_chapter_title/v1.rb +24 -0
  44. data/lib/kitchen/directions/bake_composite_pages.rb +2 -2
  45. data/lib/kitchen/directions/bake_example.rb +6 -4
  46. data/lib/kitchen/directions/bake_exercises/main.rb +11 -0
  47. data/lib/kitchen/directions/bake_exercises/v1.rb +166 -0
  48. data/lib/kitchen/directions/bake_figure.rb +8 -5
  49. data/lib/kitchen/directions/bake_footnotes/main.rb +2 -2
  50. data/lib/kitchen/directions/bake_footnotes/v1.rb +4 -4
  51. data/lib/kitchen/directions/bake_index/main.rb +2 -2
  52. data/lib/kitchen/directions/bake_index/v1.rb +22 -15
  53. data/lib/kitchen/directions/bake_link_placeholders.rb +24 -0
  54. data/lib/kitchen/directions/bake_math_in_paragraph.rb +5 -3
  55. data/lib/kitchen/directions/bake_notes.rb +8 -8
  56. data/lib/kitchen/directions/bake_numbered_table/main.rb +2 -2
  57. data/lib/kitchen/directions/bake_numbered_table/v1.rb +21 -16
  58. data/lib/kitchen/directions/bake_page_abstracts.rb +14 -0
  59. data/lib/kitchen/directions/bake_preface/main.rb +11 -0
  60. data/lib/kitchen/directions/bake_preface/v1.rb +18 -0
  61. data/lib/kitchen/directions/bake_stepwise.rb +7 -7
  62. data/lib/kitchen/directions/bake_suggested_reading.rb +26 -0
  63. data/lib/kitchen/directions/bake_toc.rb +41 -22
  64. data/lib/kitchen/directions/bake_unit_title/main.rb +11 -0
  65. data/lib/kitchen/directions/bake_unit_title/v1.rb +23 -0
  66. data/lib/kitchen/directions/bake_unnumbered_tables.rb +7 -5
  67. data/lib/kitchen/directions/move_title_text_into_span.rb +2 -2
  68. data/lib/kitchen/document.rb +72 -13
  69. data/lib/kitchen/element.rb +11 -0
  70. data/lib/kitchen/element_base.rb +276 -56
  71. data/lib/kitchen/element_enumerator.rb +8 -0
  72. data/lib/kitchen/element_enumerator_base.rb +210 -28
  73. data/lib/kitchen/element_enumerator_factory.rb +59 -52
  74. data/lib/kitchen/element_factory.rb +27 -12
  75. data/lib/kitchen/errors.rb +5 -0
  76. data/lib/kitchen/example_element.rb +19 -1
  77. data/lib/kitchen/example_element_enumerator.rb +9 -1
  78. data/lib/kitchen/figure_element.rb +36 -2
  79. data/lib/kitchen/figure_element_enumerator.rb +9 -1
  80. data/lib/kitchen/metadata_element.rb +28 -0
  81. data/lib/kitchen/metadata_element_enumerator.rb +21 -0
  82. data/lib/kitchen/mixins/block_error_if.rb +24 -4
  83. data/lib/kitchen/note_element.rb +37 -7
  84. data/lib/kitchen/note_element_enumerator.rb +9 -1
  85. data/lib/kitchen/oven.rb +66 -15
  86. data/lib/kitchen/page_element.rb +62 -13
  87. data/lib/kitchen/page_element_enumerator.rb +9 -1
  88. data/lib/kitchen/pantry.rb +28 -1
  89. data/lib/kitchen/patches/nokogiri.rb +19 -2
  90. data/lib/kitchen/patches/renderable.rb +9 -3
  91. data/lib/kitchen/patches/string.rb +8 -0
  92. data/lib/kitchen/recipe.rb +38 -34
  93. data/lib/kitchen/search_history.rb +43 -4
  94. data/lib/kitchen/search_query.rb +84 -0
  95. data/lib/kitchen/selectors/base.rb +26 -0
  96. data/lib/kitchen/selectors/standard_1.rb +8 -0
  97. data/lib/kitchen/table_element.rb +54 -3
  98. data/lib/kitchen/table_element_enumerator.rb +9 -1
  99. data/lib/kitchen/term_element.rb +15 -1
  100. data/lib/kitchen/term_element_enumerator.rb +9 -1
  101. data/lib/kitchen/transliterations.rb +7 -5
  102. data/lib/kitchen/type_casting_element_enumerator.rb +17 -1
  103. data/lib/kitchen/unit_element.rb +39 -0
  104. data/lib/kitchen/unit_element_enumerator.rb +20 -0
  105. data/lib/kitchen/utils.rb +10 -13
  106. data/lib/kitchen/version.rb +5 -1
  107. data/lib/locales/en.yml +6 -0
  108. data/lib/openstax_kitchen.rb +43 -42
  109. data/openstax_kitchen.gemspec +26 -20
  110. data/tutorials/00/solution1.rb +9 -0
  111. data/tutorials/00/solution2.rb +8 -0
  112. data/tutorials/01/solution1.rb +18 -0
  113. data/tutorials/01/solution2.rb +26 -0
  114. data/tutorials/02/solution1.rb +31 -0
  115. data/tutorials/03/{solution_1.rb → solution1.rb} +6 -4
  116. data/tutorials/03/solution2.rb +18 -0
  117. data/tutorials/04/{solution_1.rb → solution1.rb} +4 -2
  118. data/tutorials/04/{solution_2.rb → solution2.rb} +6 -4
  119. data/tutorials/05/solution1.rb +11 -0
  120. data/tutorials/check_it +16 -15
  121. data/tutorials/setup_my_recipes +7 -6
  122. metadata +101 -22
  123. data/Dockerfile +0 -19
  124. data/docker-compose.yml +0 -12
  125. data/docker/entrypoint +0 -9
  126. data/lib/kitchen/directions/bake_exercises.rb +0 -164
  127. data/tutorials/00/solution_1.rb +0 -7
  128. data/tutorials/00/solution_2.rb +0 -6
  129. data/tutorials/01/solution_1.rb +0 -16
  130. data/tutorials/01/solution_2.rb +0 -24
  131. data/tutorials/02/solution_1.rb +0 -29
  132. data/tutorials/03/solution_2.rb +0 -15
  133. data/tutorials/05/solution_1.rb +0 -9
data/tutorials/00/solution_1.rb DELETED
@@ -1,7 +0,0 @@
1
- @solution_1 = Kitchen::Recipe.new do |doc|
2
-
3
- div = doc.search("div").first
4
- div.name = "h1"
5
- div.search("span").first.replace_children(with: "World!")
6
-
7
- end
data/tutorials/00/solution_2.rb DELETED
@@ -1,6 +0,0 @@
1
- @solution_2 = Kitchen::Recipe.new do |doc|
2
-
3
- doc.search("div").first.name = "h1"
4
- doc.search("span").first.replace_children(with: "World!")
5
-
6
- end
data/tutorials/01/solution_1.rb DELETED
@@ -1,16 +0,0 @@
1
- @solution_1 = Kitchen::Recipe.new do |doc|
2
-
3
- doc.search("[data-type='chapter']").each do |chapter|
4
- movers = chapter.search(".will-move").cut
5
- movers.each{|mover| mover.name = "section"}
6
-
7
- chapter.append(child: <<~HTML
8
- <div class="eoc">
9
- <div class="os-title">End of Chapter Collations</div>
10
- #{movers.paste}
11
- </div>
12
- HTML
13
- )
14
- end
15
-
16
- end
data/tutorials/01/solution_2.rb DELETED
@@ -1,24 +0,0 @@
1
- @solution_2 = Kitchen::BookRecipe.new do |doc|
2
-
3
- # ^
4
- # |
5
- #
6
- # BookRecipe gives us `doc.book` and `book.chapters` to make the code cleaner
7
- #
8
- # | |
9
- # v v
10
-
11
- doc.book.chapters.each do |chapter|
12
- movers = chapter.search(".will-move").cut
13
- movers.each{|mover| mover.name = "section"}
14
-
15
- chapter.append(child: <<~HTML
16
- <div class="eoc">
17
- <div class="os-title">End of Chapter Collations</div>
18
- #{movers.paste}
19
- </div>
20
- HTML
21
- )
22
- end
23
-
24
- end
data/tutorials/02/solution_1.rb DELETED
@@ -1,29 +0,0 @@
1
- @solution_1 = Kitchen::Recipe.new do |doc|
2
-
3
- doc.search("[data-type='chapter']").each do |chapter|
4
- review_questions = chapter.search(".review-questions").cut
5
- critical_thinking = chapter.search(".critical-thinking").cut
6
-
7
- [review_questions, critical_thinking].each do |clipboard|
8
- clipboard.each do |element|
9
- element.first("h3").trash
10
- end
11
- end
12
-
13
- chapter.append(child: <<~HTML
14
- <div class="eoc">
15
- <h2 data-type="document-title">End of Chapter Stuff</h2>
16
- <div class="critical-thinking-container">
17
- <div class="os-title">Critical Thinking Questions</div>
18
- #{critical_thinking.paste}
19
- </div>
20
- <div class="review-questions-container">
21
- <div class="os-title">Review Questions</div>
22
- #{review_questions.paste}
23
- </div>
24
- </div>
25
- HTML
26
- )
27
- end
28
-
29
- end
data/tutorials/03/solution_2.rb DELETED
@@ -1,15 +0,0 @@
1
- @solution_2 = Kitchen::BookRecipe.new do |doc|
2
- book = doc.book
3
-
4
- book.chapters.each do |chapter|
5
- chapter.prepend(child: <<~HTML
6
- <h1 data-type="document-title">Chapter #{chapter.count_in(:book)}</h1>
7
- HTML
8
- )
9
-
10
- chapter.pages.each do |page|
11
- page.title.set(:name, "h2")
12
- .prepend(child: "#{chapter.count_in(:book)}.#{page.count_in(:chapter)} ")
13
- end
14
- end
15
- end
data/tutorials/05/solution_1.rb DELETED
@@ -1,9 +0,0 @@
1
- @solution_1 = Kitchen::Recipe.new do |doc|
2
- original = doc.search("#original").first
3
- original.append(sibling: <<~HTML
4
- \n#{original.copy.paste}
5
- HTML
6
- )
7
-
8
- doc.search("#badness").trash
9
- end