asciidoctor-pdf-table-break 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6efa4ac4626d6cdd4c2cd1ecd78b7094c1a9f2ccee06be5da4a7d9fbd32be9f1
4
- data.tar.gz: 8973d4788509c38fe821f2158c41abc23b42a2521eb46a25cec815b9f80954b3
3
+ metadata.gz: 629cbfd803ba570b11088e08675353108629c89b051d374f4c66e50d0aec196e
4
+ data.tar.gz: cca5a2284b2a5bed0dee1279a7c27e8b091b3114694f8ac4a8c8e4d07c42fac7
5
5
  SHA512:
6
- metadata.gz: 94915273d61c338ed591f6c2ff38951c5216894a22f3f3f91025863ca2acc39c594aee40e7472c74c79c3b5c860b9b554adb45894576b097bee0e94b7b7b9c9b
7
- data.tar.gz: 70ddd0605a2987e2f5c2c9861ec21aadfdaa96d6460c13edfa434c790fd5244004be319465c37d307f111f37969c11b86a1a3e12fe1b7226f1a5fc708fdde320
6
+ metadata.gz: fe6a064ae904fee784eb8c97b6e56f4bfa155c99f2cb34b4ec9d4bcf3267d3cd231922cc726de39f73d17d4adc70835339826aa2db0b1c728328af3f909a56e0
7
+ data.tar.gz: 0e6b823e6d99a5d3aa161ae2fcdd8d88a5715d705cb525fe5a0d26e3377472536234dee20058de1e49c597a1c60301663c630c900202218b72c447af00cc901b
data/README.adoc CHANGED
@@ -75,7 +75,7 @@ Write one `| <<<` per column:
75
75
 
76
76
  === Keeping HTML/Antora output clean
77
77
 
78
- Wrap break rows in `ifdef::backend-pdf[]` so they are invisible to the HTML5 and Antora converters:
78
+ Wrap break rows in `ifdef::backend-pdf[]` so they are invisible to the HTML5 and standard Antora converters:
79
79
 
80
80
  [source,asciidoc]
81
81
  ----
@@ -94,6 +94,16 @@ Wrap break rows in `ifdef::backend-pdf[]` so they are invisible to the HTML5 and
94
94
  |===
95
95
  ----
96
96
 
97
+ If you are using https://gitlab.com/antora/antora-assembler[Antora Assembler] to produce PDF output, use `ifdef::loader-assembler[]` instead.
98
+ Antora Assembler sets the `loader-assembler` attribute to identify its context; `backend-pdf` is not set during its processing pass:
99
+
100
+ [source,asciidoc]
101
+ ----
102
+ \ifdef::loader-assembler[]
103
+ 2+| <<<
104
+ \endif::[]
105
+ ----
106
+
97
107
  == Behavior
98
108
 
99
109
  * Break rows are not rendered — they exist only as page-break markers.
data/demo/demo.adoc CHANGED
@@ -1,16 +1,20 @@
1
- = asciidoctor-table-break demo
1
+ = asciidoctor-table-break Demo
2
+ 白一百 baiyibai
3
+ v1.0.2
2
4
  :doctype: article
3
5
  :toc:
4
6
  :toclevels: 2
5
7
  :sectanchors:
6
8
 
7
9
  This document demonstrates the `asciidoctor-table-break` extension.
8
- Each break row (`2+| <<<`) forces a new page inside the table while keeping headers repeating and borders seamless.
10
+ Each break row (`2+| <<<`) forces a new page inside a table while keeping borders seamless.
9
11
 
10
- == Basic break with repeating header
12
+ Break rows are wrapped in `ifdef::backend-pdf[]` so HTML and standard Antora output is unaffected.
13
+ When using Antora Assembler, use `ifdef::loader-assembler[]` instead.
11
14
 
12
- The table below has a header row and a break after row 2.
13
- The header repeats on the second page.
15
+ == Basic Break with Repeating Header
16
+
17
+ A header row repeats after a break.
14
18
 
15
19
  [%header]
16
20
  |===
@@ -28,9 +32,9 @@ endif::[]
28
32
  | Row 5 | epsilon
29
33
  |===
30
34
 
31
- == Break with footer
35
+ == Break with Footer
32
36
 
33
- The footer row (`Total`) appears only on the last page segment.
37
+ The footer row (`Total`) appears only on the last page.
34
38
 
35
39
  [%header%footer]
36
40
  |===
@@ -55,7 +59,7 @@ endif::[]
55
59
  | Total | 211 |
56
60
  |===
57
61
 
58
- == Multiple breaks (three pages)
62
+ == Multiple Breaks (Three Pages)
59
63
 
60
64
  A three-column reference table split across three pages.
61
65
 
@@ -90,9 +94,12 @@ endif::[]
90
94
  | USA | Washington DC | 335.9
91
95
  |===
92
96
 
93
- == Captioned table
97
+ == Captioned Table
94
98
 
95
- The title and anchor appear only on the first page segment.
99
+ The title and anchor appear only on the first page.
100
+ To repeat the caption on pages after a break, an extended converter is required.
101
+ The `@_tb_saved_title` node instance variable holds the original title on pages after a break (see EXTENSION INTEROP in the source).
102
+ An extended converter can append a `(continued)` modifier to the repeated caption.
96
103
 
97
104
  .Software release history
98
105
  [%header,#tbl-releases]