Skip to content

WeBWorK: the sample chapter and the schema agree #3132

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rbeezer merged 6 commits into from
Aug 6, 2026
Merged

WeBWorK: the sample chapter and the schema agree #3132

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
a4cbaba
Schema: WeBWorK forms the code has always honored
rbeezer Aug 6, 2026
3e6c2a5
WeBWorK chapter: legacy image descriptions become "shortdescription"
rbeezer Aug 6, 2026
f908784
Errors: the empty WeBWorK statement trips its warning there
rbeezer Aug 6, 2026
92e6b70
Schema: name the validation-plus stylesheet plainly
rbeezer Aug 6, 2026
2f38daa
Guide: name the validation-plus stylesheet plainly
rbeezer Aug 6, 2026
0a5cc5d
WeBWorK chapter: every answer-format category, and extra macros
rbeezer Aug 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/guide/appendices/schema-install.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<title>Schema Tools</title>

<introduction>
<p>This appendix has technical information about tools that work with the <acro>RELAX-NG</acro> schema and our additional validation stylesheet. See <xref ref="schema" /> for a more general overview.</p>
<p>This appendix has technical information about tools that work with the <acro>RELAX-NG</acro> schema and the validation-plus stylesheet. See <xref ref="schema" /> for a more general overview.</p>
</introduction>

<section xml:id="jing-trang">
Expand Down
15 changes: 15 additions & 0 deletions examples/errors/sample-errors-and-warnings.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -699,6 +699,21 @@ systems.
</tabular>
</table>

<!-- Moved here from the WW sample chapter, 2026-08-06, -->
<!-- since the samples never deliberately raise errors -->
<exercise label="empty-statement">
<introduction>
<p>
This exercise has no content in its statement.
It should throw a PTX warning during the representations build.
</p>
</introduction>
<webwork>
<statement>
</statement>
</webwork>
</exercise>

</section>

<glossary>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/an-exercisegroup-exercise.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-an-exercisegroup-exercise" assembly-id="an-exercisegroup-exercise">
<static seed="112">
<static seed="113">
<statement><p>What is <m>1+1\text{?}</m></p>
<p><fillin characters="5" name="AnSwEr0001"/>&gt;</p>
</statement>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/answer-arrays.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-answer-arrays" assembly-id="answer-arrays">
<static seed="81">
<static seed="83">
<statement><p>These answer blanks are all expecting some sort of answer in an array format.</p>
<p><m>{\left(0,0\right)} = {}</m><fillin cols="2"/></p>
<p><m>{\left\lt 1,2\right&gt;} = {}</m><fillin cols="2"/></p>
Expand Down
105 changes: 105 additions & 0 deletions examples/webwork/sample-chapter/my-generated/webwork/answer-format-extra-macros.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-answer-format-extra-macros" assembly-id="answer-format-extra-macros">
<static seed="73">
<statement><p>Three more flavors, each needing a macro file loaded by <c>&lt;pg-macros&gt;</c>.
<ol label="a.">
<li>
<p>Three quarters, as a fraction: <fillin characters="6" name="AnSwEr0001"/></p>
</li>
<li>
<p>The solutions of <m>3x &gt; 6\text{,}</m> as an inequality: <fillin characters="8" name="AnSwEr0002"/></p>
</li>
<li>
<p>Four meters, a number with its units: <fillin characters="8" name="AnSwEr0003"/></p>
</li>
</ol></p>
</statement>
<answer>
<p>
<m>{\frac{3}{4}}</m>
</p>
</answer>
<answer>
<p>
<m>x &gt; 2</m>
</p>
</answer>
<answer>
<p>
<m>4\ {\rm m}</m>
</p>
</answer>
</static>
<rendering-data problemSource="Integrating_WeBWorK_into_Textbooks/1-Instructive_Examples/1_9-Answer_Formats_and_Extra_Macros/1_9_2-Answers_Needing_Extra_Macros.pg" origin="generated" domain="https://webwork-ptx.aimath.org" course-id="anonymous" user-id="anonymous" passwd="anonymous" language="en-US"/>
<pg><![CDATA[
#############################################
### Generated from PreTeXt source
###
### https://pretextbook.org
###
#############################################
## DBsubject()
## DBchapter()
## DBsection()
## Level()
## KEYWORDS()
## TitleText1()
## EditionText1()
## AuthorText1()
## Section1(not reported)
## Problem1(1.9.2)
## Author()
## Institution()
## Language(en-US)

DOCUMENT();

############################################################
# Load Macros
############################################################
loadMacros(
"PGstandard.pl",
"PGML.pl",
"AnswerFormatHelp.pl",
"parserNumberWithUnits.pl",
"contextFraction.pl",
"contextInequalities.pl",
"PGcourse.pl",
);
COMMENT('Authored in PreTeXt');

############################################################
# Header
############################################################

############################################################
# PG Setup Code
############################################################
Context("Fraction");
$fraction = Fraction(3, 4);
Context("Inequalities");
$inequality = Compute("x > 2");
Context("Numeric");
$quantity = NumberWithUnits("4 m");

############################################################
# Body
############################################################

BEGIN_PGML
Three more flavors, each needing a macro file loaded by [|<pg-macros>|]*.
a. Three quarters, as a fraction: [_]{$fraction}{6} [@AnswerFormatHelp('fractions')@]*

a. The solutions of [`3x > 6\text{,}`] as an inequality: [_]{$inequality}{8} [@AnswerFormatHelp('inequalities')@]*

a. Four meters, a number with its units: [_]{$quantity}{8} [@AnswerFormatHelp('units')@]*

END_PGML

############################################################
# End Problem
############################################################

ENDDOCUMENT();
]]></pg>
</webwork-reps>
169 changes: 169 additions & 0 deletions examples/webwork/sample-chapter/my-generated/webwork/answer-format-gallery.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,169 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-answer-format-gallery" assembly-id="answer-format-gallery">
<static seed="72">
<statement><p>Nine flavors of answer, each blank linking to format help of its own kind.
<ol label="a.">
<li>
<p>An angle, in degrees, half of a right angle: <fillin characters="4" name="AnSwEr0001"/></p>
</li>
<li>
<p>Three quarters, as a decimal: <fillin characters="6" name="AnSwEr0002"/></p>
</li>
<li>
<p>The exponent in <m>2^3 = 8\text{:}</m> <fillin characters="4" name="AnSwEr0003"/></p>
</li>
<li>
<p>The natural logarithm of <m>2\text{,}</m> exactly: <fillin characters="6" name="AnSwEr0004"/></p>
</li>
<li>
<p>The value of <m>\lim_{x\to 2}(x^2+2)\text{:}</m> <fillin characters="4" name="AnSwEr0005"/></p>
</li>
<li>
<p>Any formula equal to <m>x^2+1\text{:}</m> <fillin characters="10" name="AnSwEr0006"/></p>
</li>
<li>
<p>The open interval from <m>1</m> to <m>5\text{:}</m> <fillin characters="8" name="AnSwEr0007"/></p>
</li>
<li>
<p>The point where <m>y=x+1</m> crosses <m>x=1\text{:}</m> <fillin characters="8" name="AnSwEr0008"/></p>
</li>
<li>
<p>The vector from the origin to that point: <fillin characters="8" name="AnSwEr0009"/></p>
</li>
</ol></p>
</statement>
<answer>
<p>
<m>45</m>
</p>
</answer>
<answer>
<p>
<m>0.75</m>
</p>
</answer>
<answer>
<p>
<m>3</m>
</p>
</answer>
<answer>
<p>
<m>\ln\mathopen{}\left(2\right)</m>
</p>
</answer>
<answer>
<p>
<m>6</m>
</p>
</answer>
<answer>
<p>
<m>x^{2}+1</m>
</p>
</answer>
<answer>
<p>
<m>\left(1,5\right)</m>
</p>
</answer>
<answer>
<p>
<m>\left(1,2\right)</m>
</p>
</answer>
<answer>
<p>
<m>\left&lt;1,2\right&gt;</m>
</p>
</answer>
</static>
<rendering-data problemSource="Integrating_WeBWorK_into_Textbooks/1-Instructive_Examples/1_9-Answer_Formats_and_Extra_Macros/1_9_1-A_Gallery_of_Answer_Formats.pg" origin="generated" domain="https://webwork-ptx.aimath.org" course-id="anonymous" user-id="anonymous" passwd="anonymous" language="en-US"/>
<pg><![CDATA[
#############################################
### Generated from PreTeXt source
###
### https://pretextbook.org
###
#############################################
## DBsubject()
## DBchapter()
## DBsection()
## Level()
## KEYWORDS()
## TitleText1()
## EditionText1()
## AuthorText1()
## Section1(not reported)
## Problem1(1.9.1)
## Author()
## Institution()
## Language(en-US)

DOCUMENT();

############################################################
# Load Macros
############################################################
loadMacros(
"PGstandard.pl",
"PGML.pl",
"AnswerFormatHelp.pl",
"contextForm.pl",
"PGcourse.pl",
);
COMMENT('Authored in PreTeXt');

############################################################
# Header
############################################################

############################################################
# PG Setup Code
############################################################
Context("Numeric");
$angle = Real(45);
$decimal = Real(0.75);
$exponent = Real(3);
$logarithm = Compute("ln(2)");
$limit = Real(6);
$syntaxanswer = Formula("x^2+1");
Context("Interval");
$interval = Compute("(1,5)");
Context("Vector");
$point = Point("(1,2)");
$vector = Vector("<1,2>");

############################################################
# Body
############################################################

BEGIN_PGML
Nine flavors of answer, each blank linking to format help of its own kind.
a. An angle, in degrees, half of a right angle: [_]{$angle}{4} [@AnswerFormatHelp('angles')@]*

a. Three quarters, as a decimal: [_]{$decimal}{6} [@AnswerFormatHelp('decimals')@]*

a. The exponent in [`2^3 = 8\text{:}`] [_]{$exponent}{4} [@AnswerFormatHelp('exponents')@]*

a. The natural logarithm of [`2\text{,}`] exactly: [_]{$logarithm}{6} [@AnswerFormatHelp('logarithms')@]*

a. The value of [`\lim_{x\to 2}(x^2+2)\text{:}`] [_]{$limit}{4} [@AnswerFormatHelp('limits')@]*

a. Any formula equal to [`x^2+1\text{:}`] [_]{$syntaxanswer}{10} [@AnswerFormatHelp('syntax')@]*

a. The open interval from [`1`] to [`5\text{:}`] [_]{$interval}{8} [@AnswerFormatHelp('intervals')@]*

a. The point where [`y=x+1`] crosses [`x=1\text{:}`] [_]{$point}{8} [@AnswerFormatHelp('points')@]*

a. The vector from the origin to that point: [_]{$vector}{8} [@AnswerFormatHelp('vectors')@]*

END_PGML

############################################################
# End Problem
############################################################

ENDDOCUMENT();
]]></pg>
</webwork-reps>
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/deep-nested-lists.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-deep-nested-lists" assembly-id="deep-nested-lists">
<static seed="85">
<static seed="87">
<statement><p>Ordered list.</p>
<p><ol label="a.">
<li>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-bare.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-bare" assembly-id="divisional-bare">
<static seed="96">
<static seed="97">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-conclusion.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-conclusion" assembly-id="divisional-conclusion">
<static seed="100">
<static seed="101">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-introduction-conclusion.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-introduction-conclusion" assembly-id="divisional-introduction-conclusion">
<static seed="102">
<static seed="103">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-introduction.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-introduction" assembly-id="divisional-introduction">
<static seed="98">
<static seed="99">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-title-conclusion.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-title-conclusion" assembly-id="divisional-title-conclusion">
<static seed="101">
<static seed="102">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion .../webwork/sample-chapter/my-generated/webwork/divisional-title-introduction-conclusion.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-title-introduction-conclusion" assembly-id="divisional-title-introduction-conclusion">
<static seed="103">
<static seed="104">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-title-introduction.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-title-introduction" assembly-id="divisional-title-introduction">
<static seed="99">
<static seed="100">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
2 changes: 1 addition & 1 deletion examples/webwork/sample-chapter/my-generated/webwork/divisional-title.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version='1.0' encoding='utf-8'?>
<webwork-reps version="2" webwork2_major_version="2" webwork2_minor_version="20" xml:id="extracted-divisional-title" assembly-id="divisional-title">
<static seed="97">
<static seed="98">
<statement><p><m>1+1=2</m></p>
</statement>
</static>
Expand Down
Loading