From 197d3075eaaf674498f78ccdafea351e295e478d Mon Sep 17 00:00:00 2001
From: "Jiri (George) Lebl"
#### Replace essay boxes with a message + my $essay_message = 'If you were logged into a WeBWorK course ' + . 'and this problem were assigned to you, ' + . 'you would be able to submit an essay answer ' + . 'that would be graded later by a human being.'; + sub essay_box { my $out = MODES( TeX => '', Latex2HTML => '', - HTML => qq!<P> - If you were logged into a WeBWorK course - and this problem were assigned to you, - you would be able to submit an essay answer - that would be graded later by a human being. - </P>!, + HTML => qq!<p>$essay_message</p>!, + PTX => '', + ); + $out; + }; + + sub explanation_box { + return if ($envir{waiveExplanations}); + my $out = MODES( + TeX => '', + Latex2HTML => '', + HTML => qq!<p>$essay_message</p>!, PTX => '', ); $out; From 257cde88d492979a340ee459d0bb5451d091f49c Mon Sep 17 00:00:00 2001 From: Oscar LevinDate: Thu, 16 May 2024 15:41:13 -0600 Subject: [PATCH 3/4] Guide: small typo (PR #2165) --- doc/guide/author/overview.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/guide/author/overview.xml b/doc/guide/author/overview.xml index 9311f374cf..efb6255ceb 100644 --- a/doc/guide/author/overview.xml +++ b/doc/guide/author/overview.xml @@ -102,7 +102,7 @@ Images image -You can include an image via the
+image image tag, using thesource attribute to provide a filename, likely prefixed by a relative path from the top-level of the appropriate directory. Readfor details on how to set these directories correctly. If you are starting a new project, using the -CLI (with the command pretext new book , for example), then most of the setup portion is done for you and the top-level directory for images that are created external to the project is calledassests , and it is a sibling of thesource directory. It is your responsibility to locate that file properly relative to this directory, and that the file format is compatible. So, for example, suppose your source contained<image source="images/butterflies.jpg"/> . Then you would want to have a directory namedimages below wherever you set theexternal top-level directory, and you would place thebutterflies.jpg file inside of theimages directory.You can include an image via the
image image tag, using thesource attribute to provide a filename, likely prefixed by a relative path from the top-level of the appropriate directory. Readfor details on how to set these directories correctly. If you are starting a new project, using the -CLI (with the command pretext new book , for example), then most of the setup portion is done for you and the top-level directory for images that are created external to the project is calledassets , and it is a sibling of thesource directory. It is your responsibility to locate that file properly relative to this directory, and that the file format is compatible. So, for example, suppose your source contained<image source="images/butterflies.jpg"/> . Then you would want to have a directory namedimages below wherever you set theexternal top-level directory, and you would place thebutterflies.jpg file inside of theimages directory.The
From 47f2e275119eceb643b2cbc089d2a7bd2aab9027 Mon Sep 17 00:00:00 2001 From: Steven Clontzwidth attribute can be used to control the size of the image. Widths are expressed as a percentage of the available width, such aswidth="60%" . Instead of a width, you can also specify margins and the width will be deduced.Date: Fri, 31 May 2024 13:22:27 -0500 Subject: [PATCH 4/4] Guide: update commentary on "commentary" element (PR #2166) --- doc/guide/publisher/instructor-version.xml | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/doc/guide/publisher/instructor-version.xml b/doc/guide/publisher/instructor-version.xml index 821baa8375..89b4f6c7db 100644 --- a/doc/guide/publisher/instructor-version.xml +++ b/doc/guide/publisher/instructor-version.xml @@ -27,17 +27,12 @@ Notes and Commentary -The
commentary element is designed primarily for the purpose of adding material to a document to make an enhanced version. It is similar in many ways to aparagraphs in that it can be placed within any division and must be titled. The main difference is that it is not displayed by default, so you must set a processing switch to enable its appearance. In the project manifest inside your desired target, add the following. +The
-commentary element is designed primarily for the purpose of adding material to a document to make an enhanced version (see). It is similar in many ways to a paragraphs in that it can be placed within any division and must be titled.- - ]]> -Other distinctions are:
-
- Since it is elective, you need to be careful about cross-references to and from a
+commentary . It is highly likely that you will want to make cross-references within acommentary pointing to other portions of your text, and this is always a good idea. You will want to avoid making cross-references to acommentary from other parts of the text, with the exception of a cross-reference that originates within somecommentary .- Since it is often elective, you need to be careful about cross-references to and from a
commentary . It is highly likely that you will want to make cross-references within acommentary pointing to other portions of your text, and this is always a good idea. You will want to avoid making cross-references to acommentary from other parts of the text, with the exception of a cross-reference that originates within somecommentary .- Numbered items are prohibited within a
commentary , such as afigure or atheorem . Doing so would disrupt consecutive numbering in different versions, with or without,commentary included. Numbered equations are not prohibited in the schema, but should definitely be avoided anyway.