rhinopotamus / just-enough-algebra

Ok here is how the structure works:

main.ptx includes each of the chapter files ch-NAME.ptx, and each of the chapter files includes each of the section files sec-NAME.ptx.

The section files do a bunch of component= versioning. There are four components:

• "web": things that should only apply in the online version, not in either pdf
• "not-web": things that should only apply in pdf
• "workbook": things that should only appear in the workbook
• "not-workbook": things that should appear in both the fullprint and the online version

Here is how those components are used:

• two versions of the <title> tag generate either the plain title (not-workbook) or the title decorated with "- Practice exercises" (workbook)
• the text of the section is enclosed in an <introduction component="not-workbook">
• each of the "Do you know..." lists is in a separate document as an <ol> element
• a <conclusion component="workbook"> loads the "Do you know..." list in after the exercises in the workbook version
• a <conclusion component="not-workbook"> loads the "Do you know..." list in before the exercises in other versions
• The file NotSure.ptx prints some "not-sure" instructions in not-workbook formats and the "Don't forget!" alert in the workbook version
• WYD.ptx is a <conclusion component="workbook"> that is loaded between the exercises and the "Do you know ..." list

Some other important versioning happens in the exercise files ex-NAME.ptx:

• ex-intro.ptx is an <introduction> element that doesn't display in the workbook
• exercises 1-4 are not componented, so they appear in all builds
• if exercises 1-4 include xrefs to exercises 5-? in other sections, those "story also appears in" sentences are versioned in <em component="..."> tags
  • I reference the containing section rather than the exercise directly in the workbook component tag
• exercises 5-8 are written in <exercise component="not-workbook">

Custom xsl in the xsl folder is very important to how this book works. In the latex versions:

• Most importantly, it makes <exercises> respect <page> and @workspace in the workbook version
• it contains some header customization
• it contains some customization of the enumerate labels and makes nested enumerates with empty introductions behave similarly to vanilla latex
• it makes sections start with a pagebreak
• it kills some extra periods generated in titles
• it formats <aside> to appear as margin notes

just-enough-algebra's Issues

marginal asides placed incorrectly in pretext build

Note that my LaTeX build is produced by pdflatex but my pretext build is produced by xetex. Maybe they handle margins differently.

Replace ... with <ellipsis />

fix pizza diameter xrefs with versions

https://pretextbook.org/doc/guide/html/publisher-versions.html

merge workbook exercises into textbook

When you're done...

switch "the problem continues..." to interlude

Then I can omit it from web builds.

If I am lucky this will not fuck up spacing.

Set margins

It looks like it might be best to do this globally

rename definition environment to "formula"

Graph paper size change will require new pagination

use xrefs for "story also appears in"

use xrefs instead of <alert> for formulas?

Idk how those will show up in text but it may be nice.

geometry: fiddle with include head and foot?

This is probably why I am having issues matching paper version. Would probably cause a fair amount of re-spacing.

Second paragraphs in introductions have indents.

oops, something hath fucked up <aside>s in pdfs

Replace \land with \wedge for consistency?

track down xrefs in print

spacing in tables

What are ways to control the amount of space inside a table cell so that students can write their answers in it?

fiddle with preface

Random blank pages in pdf output

Maybe I can look at the draft output for help

Wrap exercises in page tags

See this other thing from the pretext issues -- looks like it's better to undershoot on spacing bc the specified spacing is apparently a minimum.

table font is very small?

I wonder if I can control this on a per-table basis

teen pregnancy table is too wide

restyle enumerate indicators?

the prelude sections aren't going to have workspace in them :(

make covers

Subsection 44.3.8: Covers

make "do you knows" have letters

in the textbook they're

in the workbook they're numbers

prefer capital letters

Put front matter in

Put xml:id names on every exercise

I mean I probably should, right?

Might be nice to rename "worksheet exercise" bc that's long

Reference

graph paper doesn't want to appear in web build

intercept of linear formula should go somewhere in 4.3

            <assemblage>
                <title>Intercept (of Linear) Formula</title>
                <p>
                    <me>
                        \text{intercept} = \text{dep} - \text{slope}\ast\text{indep}
                    </me>
                </p>
            </assemblage>

Too good not to put it in the chapter!

kill borders on tables used for formatting

Relatedly, it may be nice to find a better way to deal with name-the-variables in the source.

What if <worksheet> respected <exercisegroup>?

Maybe this is trickier than I think; see this issue pointing to some subtleties about exercise types.

use <fillin />

according to the paragraphs guide, the <fillin/> tag is what I want for a li'l underlined space.

control margins of printable worksheets in css / html

This is exactly this issue.

Is there a css thing for controlling margins on printable pages? Presumably, right?

Also: maybe find a MWE where it works correctly in latex but then breaks wrong in html.

underlines don't appear in chtml but do appear in svg

This is specifically in the order of operations section. Not sure where else I am using underline.

<kbd> for calculator entry

Subsection 4.1.5: Keyboard Keys

add practice exams to textbook

replace ' and " with <prime/> and <doubleprime/>

This will mostly be in the units section I think.

Fix "the problem continues"

If you just put
<p><em>The problem continues …</em></p>
somewhere in the middle of a worksheet, it doesn't render. Figure out a better way to do this.

Also, do we think it should be on the previous page or the next page?

units letters

<exercise xml:id="walnut-tree-algebraic-notation"> is maybe the perfect illustration of the issue.

cancel isn't working

Mostly this is a problem for sec-Units.ptx.

Per the guide, I added this to docinfo.ptx:

<math-package latex-name="cancel" mathjax-name="cancel"/>

No dice, though.

Change <fn> to <aside>?

pandoc conversion doesn't respect certain boxes

From Rate_of_change.tex:

\bigskip
 \framebox{
 \begin{minipage}[c]{.85\textwidth}  
~ \bigskip \\  \textsc{Rate of change formula:} \quad $ \displaystyle \text{rate of change = }\frac{\text{change dep}}{\text{change indep}}$\\ ~ \bigskip
\end{minipage}
}
\bigskip

This just plain got eaten.

scientific notation section in the textbook is a mess

Lots of use of underbraces with \begin{tiny} etc.

appendices

• formulas
• practice finals

build pdf of full textbook

fiddle with appendix display in print

currently the really big letters for appendix titles are fucking with the spacing of the practice exams

Turn the front part of practice exams into introductions

• PE1A
• PE1B
• PE2A
• PE2B
• PE3A
• PE3B
• PE4A
• PE4B
• PE5A
• PE5B

Check if there are other places for mid-exercise introduction tags

In particular I should check compare-linear-exponential.