Difference between revisions of "SimplifiedEntry"

From WeBWorK_wiki
Jump to navigation Jump to search
m (no embedding html in wiki-pages!)
m (get rid of all that html and use wikimarkup instead)
Line 1: Line 1:
−
In order to facilitate the creation of problems in WebWork, it seems necessary to streamline and simplify the problem generation process while at the same time providing a method for basic problem generation that newcomers can use that avoids much of the difficulty associated with mastery of the PG language.<br /><br />We propose two new approaches here to the problem authoring facility built in to WebWork that focus on either <br />
 +
In order to facilitate the creation of problems in WebWork, it seems necessary to streamline and simplify the problem generation process while at the same time providing a method for basic problem generation that newcomers can use that avoids much of the difficulty associated with mastery of the PG language.
−
<ul>
 +
−
<li>building problems in a more controlled fashion that hides the details of the PG language or that <br /></li>
 +
We propose two new approaches here to the problem authoring facility built in to WebWork that focus on either:
−
<li>allows authoring of PG problems via a TeX-like interface<br /></li>
 +
# building problems in a more controlled fashion that hides the details of the PG language or that
−
</ul>This would potentially make problem input for beginners more tractable in the PG language and encourage more widespread problem development. <br /><br /><br /><span style="text-decoration: underline;"><span style="font-weight: bold;">A Segmented Edit Page<br /></span></span><br />One approach is to create a redesigned version of the existing edit page could be created that provides a more graphical user interface the PG problem edit mechanism. An example of this is provided in the link above. In this page, the essential parts of a PG problem are split into areas that are more controlled and that hide portions of the PG backend. This also presents a cleaner version of a problem and would help to prevent confusion surrounding how problems work.<br /><br /><br /><span style="text-decoration: underline;"><span style="font-weight: bold;">A Hybrid PG/Tex Authoring Mode</span></span><br />In general, it also seems appealing to be able to author problems in a PG/LaTeX hybrid mode where the formulas and problem formatting are determined by LaTeX commands and the WebWork problem aspects ( answer rules, random parameters, etc.) are handled by keyword tags. This PGTex could then be processed by a perl script into true PG for inclusion into problem sets. This approach offers several advantages.
 +
# allows authoring of PG problems via a TeX-like interface
−
<ul>
 +
−
</ul>
 +
This would potentially make problem input for beginners more tractable in the PG language and encourage more widespread problem development.
−
<ul>
 +
−
<li>First of all, the existing problem editing facility can be modified to support this PGTex entry mode in a Basic Editor version that would be accessible from a different URL within WebWork. It would limit the available problem types, but would allow for quick, easy problem generation for people familiar with TeX.</li>
 +
==A Segmented Edit Page==
−
<ul>&nbsp;
 +
One approach is to create a redesigned version of the existing edit page could be created that provides a more graphical user interface the PG problem edit mechanism. An example of this is provided in the link above. In this page, the essential parts of a PG problem are split into areas that are more controlled and that hide portions of the PG backend. This also presents a cleaner version of a problem and would help to prevent confusion surrounding how problems work.
−
</ul>
 +
−
<li>Secondly, external applications could be adapted to use this problem generation mode. For example, LyX, a LaTeX typesetting application, could be adapted to use this problem processing externally and the resulting PGTex could be uploaded and processed by WebWork in the same way as with the built in Basic Editor. <br /></li>
 +
==A Hybrid PG/Tex Authoring Mode==
−
<li>It also would permit the basic aspects of a PG problem, e.g. macro loading, etc., to be suppressed for users who have no interest in understand the more complicated aspects of PG problem authoring</li>
 +
In general, it also seems appealing to be able to author problems in a PG/LaTeX hybrid mode where the formulas and problem formatting are determined by LaTeX commands and the WebWork problem aspects ( answer rules, random parameters, etc.) are handled by keyword tags. This PGTex could then be processed by a perl script into true PG for inclusion into problem sets. This approach offers several advantages.
−
<li>It would abstract out the encoding of things like functions and answer comparisons so that changes to the macro library could be made transparent in some sense (maybe)<br /></li>
 +
−
<ul>&nbsp;
 +
# First of all, the existing problem editing facility can be modified to support this PGTex entry mode in a Basic Editor version that would be accessible from a different URL within WebWork. It would limit the available problem types, but would allow for quick, easy problem generation for people familiar with TeX.
−
</ul>
 +
# Secondly, external applications could be adapted to use this problem generation mode. For example, LyX, a LaTeX typesetting application, could be adapted to use this problem processing externally and the resulting PGTex could be uploaded and processed by WebWork in the same way as with the built in Basic Editor.
−
</ul>The Basic Editor could also be adapted to utilize a GUI like TeX editor such as the HTML editor in Moodle (that is used to create Wiki entries) further simplifying the creation of problems.<br /><br /><br />TODO: <br />
 +
# It also would permit the basic aspects of a PG problem, e.g. macro loading, etc., to be suppressed for users who have no interest in understand the more complicated aspects of PG problem authoring
−
<ul>
 +
# It would abstract out the encoding of things like functions and answer comparisons so that changes to the macro library could be made transparent in some sense (maybe)
−
<li>create the Tex2PG processor within WebWork</li>
 +
−
<li>create a modified version of PGProblemEditor.pm that supports PGTex editing</li>
 +
The Basic Editor could also be adapted to utilize a GUI like TeX editor such as the HTML editor in Moodle (that is used to create Wiki entries) further simplifying the creation of problems.
−
<li>develop a secure way for external applications to upload files for processing (perhaps using the xmlrpc connection for preview as well)<br /></li>
 +
−
</ul><br /><br />
+
==TODO==
  +
* create the Tex2PG processor within WebWork
  +
* create a modified version of PGProblemEditor.pm that supports PGTex editing
  +
* develop a secure way for external applications to upload files for processing (perhaps using the xmlrpc connection for preview as well)
 
* [[EditorDesigns]]
  
* [[EditorDesigns]]
 
[[Category:AIMWeBWorK Working Groups]]
  
[[Category:AIMWeBWorK Working Groups]]

Revision as of 11:14, 24 August 2008

In order to facilitate the creation of problems in WebWork, it seems necessary to streamline and simplify the problem generation process while at the same time providing a method for basic problem generation that newcomers can use that avoids much of the difficulty associated with mastery of the PG language.

We propose two new approaches here to the problem authoring facility built in to WebWork that focus on either:

  1. building problems in a more controlled fashion that hides the details of the PG language or that
  2. allows authoring of PG problems via a TeX-like interface

This would potentially make problem input for beginners more tractable in the PG language and encourage more widespread problem development.

A Segmented Edit Page

One approach is to create a redesigned version of the existing edit page could be created that provides a more graphical user interface the PG problem edit mechanism. An example of this is provided in the link above. In this page, the essential parts of a PG problem are split into areas that are more controlled and that hide portions of the PG backend. This also presents a cleaner version of a problem and would help to prevent confusion surrounding how problems work.

A Hybrid PG/Tex Authoring Mode

In general, it also seems appealing to be able to author problems in a PG/LaTeX hybrid mode where the formulas and problem formatting are determined by LaTeX commands and the WebWork problem aspects ( answer rules, random parameters, etc.) are handled by keyword tags. This PGTex could then be processed by a perl script into true PG for inclusion into problem sets. This approach offers several advantages.

  1. First of all, the existing problem editing facility can be modified to support this PGTex entry mode in a Basic Editor version that would be accessible from a different URL within WebWork. It would limit the available problem types, but would allow for quick, easy problem generation for people familiar with TeX.
  2. Secondly, external applications could be adapted to use this problem generation mode. For example, LyX, a LaTeX typesetting application, could be adapted to use this problem processing externally and the resulting PGTex could be uploaded and processed by WebWork in the same way as with the built in Basic Editor.
  3. It also would permit the basic aspects of a PG problem, e.g. macro loading, etc., to be suppressed for users who have no interest in understand the more complicated aspects of PG problem authoring
  4. It would abstract out the encoding of things like functions and answer comparisons so that changes to the macro library could be made transparent in some sense (maybe)

The Basic Editor could also be adapted to utilize a GUI like TeX editor such as the HTML editor in Moodle (that is used to create Wiki entries) further simplifying the creation of problems.

TODO

  • create the Tex2PG processor within WebWork
  • create a modified version of PGProblemEditor.pm that supports PGTex editing
  • develop a secure way for external applications to upload files for processing (perhaps using the xmlrpc connection for preview as well)
  • EditorDesigns
Retrieved from "https://webwork.maa.org/mediawiki_new/index.php?title=SimplifiedEntry&oldid=3855"