Chris Krycho
902612b6d2
infra: create mdbook-trpl-figure preprocessor
...
Building on the shared infra from `mdbook_trpl`, this preprocessor takes
nicely accessible and semantic HTML input like this:
<figure>
<img src="https://www.example.com/something.jpg ">
<figcaption>Figure 12-34: An illustration of something</figcaption>
</figure>
It produces output like this:
<img src="https://www.example.com/something.jpg ">
Figure 12-34: An illustration of something
This matches what we need for the nostarch output. Accordingly, wire up
the `nostarch/book.toml` to use this. There is no need to worry about
ordering of the two preprocessors, because in `Simple` mode the listing
preprocessor emits plain text output for listings (much as this does for
figures).
2024-12-05 09:37:01 -07:00
Chris Krycho
8ab103d510
Add Chris Krycho (me!) to the nostarch book.toml authors
2024-12-04 17:06:57 -07:00
Chris Krycho
1a9f1ebb01
Ch. 17: Correct several points about Pin and Unpin
...
Thanks very much to @tmandry (<tmandry@gmail.com >) for the corrections
and feedback!
2024-10-15 11:43:43 -06:00
Chris Krycho
9e85fcc993
Ch. 17: integrate early reader feedback
2024-10-15 08:02:26 -06:00
Chris Krycho
a514770075
Add info about handling editions in book.toml to ADMIN.md
2024-10-10 07:21:37 -06:00
Chris Krycho
1af831aa5e
Ch. 17: Fix a lot of wording issues in the conclusion section
...
So many “however” sections! Etc.
2024-10-08 10:00:19 -06:00
Chris Krycho
3b920cdf3b
Ch. 17: tweaks and fixes for discussion of the traits
...
- Fix the numbers on the SVG files so they match up again after having
added a new 17-3 earlier in the chapter.
- Actually explain what `Context` is *for*, even though we don’t get
into the details of using it.
2024-10-08 09:41:24 -06:00
Chris Krycho
7076be0692
Ch. 17: improve the discussion of streams
...
- One example compiles that I used to think didn’t. Probably the result
of some renumbering. Need to check *all* of those.
- Don’t repeat the same basic “you <verb>” form so much.
2024-10-08 09:18:53 -06:00
Chris Krycho
f45980afda
Ch. 17: get rid of some extra italics
...
These made more sense when this section was all about big ideas and the
runtimes; now it’s needless since we actually spent the section building
something non-trivial.
2024-10-07 14:24:34 -06:00
Chris Krycho
8aee93d82d
Ch. 17: include main when first showing trpl::run
...
This gives people a better chance of understanding how the pieces fit
together.
2024-10-07 14:16:31 -06:00
Chris Krycho
a64884fb8b
Ch. 17: kill a double-“thus”
2024-10-07 14:15:42 -06:00
Chris Krycho
3111eda07a
Ch. 17: create a diagram showing blocked parallelism
2024-10-07 13:34:57 -06:00
Chris Krycho
c1d60d0696
Ch. 17: some alternative wordings for “like” substitutions
2024-10-07 08:31:51 -06:00
Carol (Nichols || Goulding)
daccf5eca3
Manual changes to the async chapter snapshot
...
Some of these could be scripted but I'm just trying to get this done
right now.
2024-10-03 21:26:50 -04:00
Carol (Nichols || Goulding)
3b8d132adf
Generated nostarch snapshot for the new async chapter
2024-10-03 21:24:28 -04:00
Carol (Nichols || Goulding)
fa97cab9dd
Change nostarch snapshot chapter numbers to make room for the async chapter
2024-10-03 21:22:12 -04:00
Carol (Nichols || Goulding)
e7d217be2a
Snapshot changes to ch 12 to consider sending to nostarch
2024-08-13 21:19:47 -04:00
Carol (Nichols || Goulding)
084b0e3a5e
Snapshot changes to generated ch12 that SHOULDN'T be sent to nostarch
2024-08-13 21:19:47 -04:00
Carol (Nichols || Goulding)
8880eacd33
Backported edits of ch12 from print to src
2024-08-13 21:19:47 -04:00
Carol (Nichols || Goulding)
48a3c173c1
Upstream changes to ch7 to consider sending to nostarch
2024-08-13 13:40:00 -04:00
Carol (Nichols || Goulding)
75bc555105
Updates to ch7 snapshot, not to send to nostarch
2024-08-13 13:40:00 -04:00
Carol (Nichols || Goulding)
6a1bf5dede
Snapshot changes to ch11 to consider sending to nostarch
2024-07-05 20:32:23 -04:00
Carol (Nichols || Goulding)
010f769361
Snapshot changes to generated ch11 that SHOULDN'T be sent to nostarch
2024-07-05 20:32:23 -04:00
Carol (Nichols || Goulding)
81e74f93aa
Snapshot changes to ch 10 to consider sending to nostarch
2024-05-28 14:15:30 -04:00
Carol (Nichols || Goulding)
553bb202ac
Snapshot changes to generated ch10 that SHOULDN'T be sent to nostarch
2024-05-28 14:15:30 -04:00
Carol (Nichols || Goulding)
4338a6d160
Snapshot changes to ch 9 to consider sending to nostarch
...
Inline format and one reference to a nonexisting variable
2024-05-28 14:15:30 -04:00
Carol (Nichols || Goulding)
c8dc2f5431
Snapshot changes to generated ch9 that SHOULDN'T be sent to nostarch
2024-05-28 14:15:30 -04:00
Chris Krycho
04841f73ba
infra: configure trpl-listing preprocessor
2024-05-14 08:25:02 -06:00
Carol (Nichols || Goulding)
b04c03d01a
Snapshot changes to ch8 to consider sending to nostarch
2024-05-07 19:58:22 -04:00
Carol (Nichols || Goulding)
d1e3925a96
Snapshot changes to generated ch8 that SHOULDN'T be sent to nostarch
2024-05-07 19:58:22 -04:00
Chris Krycho
593ec2af6a
Do not apply semantic note handling to nostarch
...
Introduce a `book.toml` in the `nostarch` directory, which matches the
existing `book.toml` except for specifying the correct relative input
and output directories and disabling the `trpl-note` preprocessor. This
also lets us simplify the invocation in the `nostarch.sh` script a bit,
by providing the configuration directly in the file.
2024-04-29 16:18:34 -06:00
Carol (Nichols || Goulding)
cb0a24007f
Snapshot changes to ch7 to consider sending to nostarch
2024-04-25 17:04:25 -04:00
Carol (Nichols || Goulding)
f954cb859f
Snapshot changes to generated ch7 that SHOULDN'T be sent to nostarch
...
This snapshot contains line wrapping problems, irrelevant comments,
extraneous output lines, and differences we're going to allow between
the online and print version.
The intention is to make this a baseline commit for chapter 7 that we
can diff against to find changes to consider sending to nostarch as tiny
tweaks.
2024-04-25 17:04:25 -04:00
Carol (Nichols || Goulding)
4ad07d9e17
Fix a problem with literal style ending
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
16ba58d00d
Snapshot consolidated appendices
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
e593d2a53b
Fix ListNumber0, newlines after lists
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
c2bcf788c0
Don't match nodes without anything
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
af23aac799
Handle listing numbers in appendices too
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
786fbf17b4
Regenerate everything
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
d57b3d4764
Fix chapter numbers in word doc so they're in the XML
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
77bfbfe16f
Handle figures too
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
b46e40570b
Regenerate ch4
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
6e47fbf18f
Handle listing numbers
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
e7d48b9278
Regenerate ch13
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
7d8b7e8267
Regenerate ch12
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
5784f677cd
Regenerate ch11
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
a2d6893c6c
Regenerate chapter 10
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
ef3535544a
Fix ListBullet0
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
6e4c1fdd00
Handle ending of BoxCode better
2022-10-20 16:39:55 -04:00
Carol (Nichols || Goulding)
2b9f0dc4d8
Regenerate chapter 9
2022-10-20 16:39:55 -04:00
