Difference between revisions of "New Authors landing page"

From WeBWorK_wiki
Jump to navigation Jump to search
Line 30: Line 30:
 
== Manuals and HOWTOs ==
 
== Manuals and HOWTOs ==
   
* [[:Category:MathObjects|MathObjects]], an object system for manipulating mathematics in WeBWorK questions.
+
* '''[[:Category:MathObjects|MathObjects]]''', an object system for manipulating mathematics in WeBWorK questions.
** [[PGLabs]], On-line labs for rendering of PG code. These labs allow you to interactively experiment with PG syntax online.
+
** '''[[PGLabs]]''', On-line labs for rendering of PG code. These labs allow you to interactively experiment with PG syntax online.
 
**[http://hosted2.webwork.rochester.edu/webwork2/cervone_course/PGML-examples/?login_practice_user=true '''PGML''' ]-- Davide Cervone's newest addition to the PG authoring language makes it easier to describe the layout of a question. The new commands and an interactive environment for experimenting with them are available on the [[PGLabs]] page.
 
**[http://hosted2.webwork.rochester.edu/webwork2/cervone_course/PGML-examples/?login_practice_user=true '''PGML''' ]-- Davide Cervone's newest addition to the PG authoring language makes it easier to describe the layout of a question. The new commands and an interactive environment for experimenting with them are available on the [[PGLabs]] page.
* [[:Category:Applets|Applets]], how to embed Flash and Java applets into WeBWorK questions.
+
* [[:Category:Applets|'''Applets''']], how to embed Flash and Java applets into WeBWorK questions.
  +
* Specialized HOWTOS
  +
** [[SequentialProblems]] revealing the problem one step at a time
  +
** [[Converting CAPA problems for use with WeBWorK]]
  +
* '''[[TrainingAuthors |Notes on training authors]]''', and suggestions for further documentation-- Sam Hathaway
  +
  +
Background information
  +
 
* [[Basic Perl syntax]] {{--}} PG is based on Perl, so it is important to know some basic Perl syntax.
 
* [[Basic Perl syntax]] {{--}} PG is based on Perl, so it is important to know some basic Perl syntax.
 
**[How BEGIN_TEXT...END_TEXT blocks work]]
 
**[How BEGIN_TEXT...END_TEXT blocks work]]
Line 39: Line 39:
 
** [[What to do if you find a bug in a problem]]
 
** [[What to do if you find a bug in a problem]]
 
** [[Tagging Problems]] with metadata for indexing and searching.
 
** [[Tagging Problems]] with metadata for indexing and searching.
* Specialized HOWTOS
 
  +
** [[SequentialProblems]] revealing the problem one step at a time
 
** [[Converting CAPA problems for use with WeBWorK]]
 
* '''[[TrainingAuthors |Notes on training authors]]''', and suggestions for further documentation-- Sam Hathaway
 
   
 
[[Category:Top]]
 
[[Category:Top]]

Revision as of 17:29, 21 November 2010

Learning how to Author WeBWorK problems

  • See Problem Authoring Background Information and sample problems If you're just starting out.
  • See index of problem techniques section If you need help with one particular construct.
  • See PGML (Template 4) to learn techniques which simplify formatting the appearance of the questions.
  • See MathObjects for more information on authoring problems using MathObjects.
  • See PGLabs to try out code fragments on line -- including code fragments containing MathObjects. This is a quick way to learn the fine points of the MathObject syntax.

Basic info and Sample Problems

Reference Documents

  • Index of Problem Techniques ** very useful code fragments
  • POD -- POD = "plain old documentation" -- original documentation embedded in the code files.
  • PGLabs, On-line labs for rendering of PG code. These labs allow you to interactively experiment with PG syntax online.
  • PGML formatting examples.
  • The Good Questions project at Cornell University [1]

Manuals and HOWTOs

  • MathObjects, an object system for manipulating mathematics in WeBWorK questions.
    • PGLabs, On-line labs for rendering of PG code. These labs allow you to interactively experiment with PG syntax online.
    • PGML -- Davide Cervone's newest addition to the PG authoring language makes it easier to describe the layout of a question. The new commands and an interactive environment for experimenting with them are available on the PGLabs page.
  • Applets, how to embed Flash and Java applets into WeBWorK questions.
  • Specialized HOWTOS
  • Notes on training authors, and suggestions for further documentation-- Sam Hathaway

Background information