papercraft 1.1 → 1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41c765213957fc2681e2f4cd7d94e7580e45394128d61a800349aa6e848c6b00
-  data.tar.gz: 5c2b0a91c3d4c744db20536d08ae741a07dab3a9cfc2c5fa790ea987224b5c7e
+  metadata.gz: 4271050e1f7275fc148ae328a83d5e3357b908d47c0fd9817d3d3560def20a44
+  data.tar.gz: 723b2f6cbd79e3f7f979caa7411fc4819f6a4cf62b68089095a0e0c967d26913
 SHA512:
-  metadata.gz: cf87f3ae1bcf718ad7b03e5b1b895cd8065e2aee72f7044cf0fb822db029477aa98297b8caf66d9e3db1ee664d9e42a954afb203f856fa6f190765defe5139e1
-  data.tar.gz: bfd2847daa9f2d9be7a0aa7e0adee170771e3fcdd6ca0ad407478f7b5bff2848b63639d21c26d1b9d040ac44b741d9032ac24742e839e19f1327d81ffd88e901
+  metadata.gz: ab8a2a5fb35361deb86d4db69abb295f82a23fe17756e23dbe4f51a56e4af56db64966d391133750f40c279be3153b4005bbb005289a678908b365a2bd5bdf5f
+  data.tar.gz: 6bd0ffe0f793c87ad37fab7691e1d915f4b29b049a8fc1a69912550c1777e20ade9bc178b88d5812579a5abe986d46df1e98704692100fdc41e40b59ee5e2c5d

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 1.3 2024-12-16
+
+- Update dependencies
+
+## 1.2 2023-08-21
+
+- Update dependencies
+- Implement template fragments
+
 ## 1.1 2023-07-03
 
 - Add direct iteration using the `_for` attribute

data/README.md

@@ -72,10 +72,11 @@ hello.render('world')
 - [Adding Tags](#adding-tags)
 - [Tag and Attribute Formatting](#tag-and-attribute-formatting)
 - [Escaping Content](#escaping-content)
-- [Direct Iteration][#direct-iteration]
+- [Direct Iteration](#direct-iteration)
 - [Template Parameters](#template-parameters)
 - [Template Logic](#template-logic)
 - [Template Blocks](#template-blocks)
+- [Template Fragments](#template-fragments)
 - [Plain Procs as Templates](#plain-procs-as-templates)
 - [Template Composition](#template-composition)
 - [Parameter and Block Application](#parameter-and-block-application)
@@ -97,6 +98,8 @@ hello.render('world')
 
 ## Installing Papercraft
 
+**Note**: Papercraft requires Ruby version 3.2 or newer.
+
 Using bundler:
 
 ```ruby
@@ -381,6 +384,35 @@ page = Papercraft.html {
 page.render { h1 'hi' }
 ```
 
+## Template Fragments
+
+Template fragments allow rendering specific parts of a template, instead of the
+entire template. For example, you can define a template for a web page that
+includes a form, but may want to render just the form. Instead of extracting the
+code and putting it into a separate template, you can use template fragments to
+render just that part of that template:
+
+```ruby
+page = Papercraft.html {
+  div {
+    h1 'Page title'
+    p 'Some text'
+  }
+  div(id: 'my-form') {
+    fragment(:form) {
+      form {
+        input(name: 'email')
+        button 'OK'
+      }
+    }
+  }
+}
+page.render_fragment(:form)
+```
+
+For more information on how to use template fragments, see the [HTMX
+article](https://htmx.org/essays/template-fragments/).
+
 ## Plain Procs as Templates
 
 With Papercraft you can write a template as a plain Ruby proc, and later render