fe2o3_text/src/doc/djot/write.rs
9 operations, oldest first
created by r1870400018:72231, which is this file's identity for as long as the history lasts, whatever it is later renamed to
read the file · who wrote it · compare two states
An operation carries no clock of its own. Each row is therefore dated by the first mark written after it by the same replica, which is one copy of the repository, and that mark is where the command that wrote the operation ended.
+ signed and verified, ? signed by a key this forge does not carry, - unsigned
| Operation | Author | What | When | |
|---|---|---|---|---|
| + | r1870400018:72231 | replica 1870400018 | created fe2o3_text/src/doc/djot/write.rs | 40 days ago under "fe2o3_text: Djot writer, part 1 -- djot::render(&Doc) -> String, the counterpart to djot::parse, holding parse(&render(&d)) == d for every tree a reader could produce over headings, paragraphs, nested lists, fenced code, quotations, pipe tables (header or none, alignment, a `^ caption` line), rules, divisions with attrs, and text, emphasis, links, images with attrs, code, spans, breaks, superscript and subscript. The mapping, with the one spelling chosen where Djot has two, is in the djot module header. Light escaping: marks, brackets, braces and the backslash wherever they fall; block openers only at a line start. Marks are written plain and braced ({_ so _}) only where plain would not read back. The reader learns what the writer needs: ^sup^ and ~sub~, the braced marks, table captions, headerless tables, a pipe inside a code span in a cell, and a division's closing fence found among its blocks (a fence inside a listing or a list item closes nothing outside it). A standalone attributes line now needs every item to parse, so a braced paragraph stays a paragraph. Figure, Terms and header cells in body rows degrade via as_plain until F2b. tests/djot_write.rs: generated round trip over every listed variant at depth 4 (5000 seeds; 30000 checked once), the escaping cases one by one, and the new reader forms (Zoapedia F2a)" |
| + | r1870400018:72232 | replica 1870400018 | inserted 12.6 KiB | 40 days ago under "fe2o3_text: Djot writer, part 1 -- djot::render(&Doc) -> String, the counterpart to djot::parse, holding parse(&render(&d)) == d for every tree a reader could produce over headings, paragraphs, nested lists, fenced code, quotations, pipe tables (header or none, alignment, a `^ caption` line), rules, divisions with attrs, and text, emphasis, links, images with attrs, code, spans, breaks, superscript and subscript. The mapping, with the one spelling chosen where Djot has two, is in the djot module header. Light escaping: marks, brackets, braces and the backslash wherever they fall; block openers only at a line start. Marks are written plain and braced ({_ so _}) only where plain would not read back. The reader learns what the writer needs: ^sup^ and ~sub~, the braced marks, table captions, headerless tables, a pipe inside a code span in a cell, and a division's closing fence found among its blocks (a fence inside a listing or a list item closes nothing outside it). A standalone attributes line now needs every item to parse, so a braced paragraph stays a paragraph. Figure, Terms and header cells in body rows degrade via as_plain until F2b. tests/djot_write.rs: generated round trip over every listed variant at depth 4 (5000 seeds; 30000 checked once), the escaping cases one by one, and the new reader forms (Zoapedia F2a)" |
| + | r1870400018:72362 | replica 1870400018 | inserted 7 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72363 | replica 1870400018 | replaced 15 bytes with 220 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72364 | replica 1870400018 | inserted 19 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72365 | replica 1870400018 | inserted 95 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72366 | replica 1870400018 | replaced 1 byte with 36 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72367 | replica 1870400018 | replaced 180 bytes with 2.6 KiB | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |
| + | r1870400018:72368 | replica 1870400018 | inserted 118 bytes | 40 days ago under "fe2o3_text: Djot writer, part 2 -- figures, definition lists and header cells round-trip, so parse(&render(&d)) == d holds over every block and inline the tree has. A figure is `::: figure {attrs}` with its caption a `^ caption` line last (a captionless table last in a figure gets a bare `^`); a division classed `figure` alone is written `::: {.figure}`. A definition list is Djot's `: term` with each definition indented beneath it, a `::` line before each further definition (and before a first that is empty), `:` alone for an empty term, and its attrs on a line above, given even when empty where a second list follows a first. The reader now reads a header row's cells as headers; a table that departs from that carries `{heads=\"rows\"}` (every body row headed by its first cell) or a word of 1 and 0 per row on the line above. An attributes line above a figure or definition list merges into its attrs. A `:` line does not interrupt a paragraph. tests: the generator widened to every variant at depth 4 (5000 seeds; 40000 checked once); hand-written reader forms; the F1 corpus read from HTML keeping names round-trips through Djot (fixtures hoisted to consts); the 25 Zoapedia page bodies likewise, behind #[ignore], read by absolute path (Zoapedia F2b)" |