Difference between revisions of "Authors"

From WeBWorK_wiki
Jump to navigation Jump to search
m (Added link to MathObject presentation, and moved PGML link to under PGML section)
m (add reference to documentation shared in Final Exams Conference (Nov 2020))
(3 intermediate revisions by 2 users not shown)
Line 19: Line 19:
   
 
== Reference documents and manuals ==
 
== Reference documents and manuals ==
  +
* '''[https://github.com/drdrew42/WeBWorK-problem-authoring Intro to Problem Authoring]''' Introduction to the basics of Perl, MathObjects, and PGML (Nov 2020) -- includes problem templates
  +
* '''[[Problem Authoring Videos]]''' Complete course of streamed recordings from the PREP 2015 Workshop on Problem Authoring
 
* [[: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.
 
* '''[[SequentialProblems]]''' revealing the problem one step at a time
 
* '''[[SequentialProblems]]''' revealing the problem one step at a time
* '''[http://webwork.maa.org/pod/pg_TRUNK/ POD]''' -- POD = "plain old documentation" -- original documentation embedded in the code files -- this is the place to find the most complete and most technical description of macro behaviors.
+
* '''[https://demo.webwork.rochester.edu/wwdocs POD]''' -- POD = "plain old documentation" -- original documentation embedded in the code files -- this is the place to find the most complete and most technical description of macro behaviors.
 
* '''[[Doxygen]] Doxygen compiles a list of all the subroutines occurring in all the files from the webwork2 and pg directories. Can be used to find where a macro command is defined.
 
* '''[[Doxygen]] Doxygen compiles a list of all the subroutines occurring in all the files from the webwork2 and pg directories. Can be used to find where a macro command is defined.
 
* '''[[:File:WeBWorK_Problem_Authoring_Tutorial.pdf| WeBWorK Problem Authoring Tutorial]]''' aimed at people who already know TeX, but need to learn about Perl, PG, and MathObjects (pdf file) -- (by Paul Pearson).
 
* '''[[:File:WeBWorK_Problem_Authoring_Tutorial.pdf| WeBWorK Problem Authoring Tutorial]]''' aimed at people who already know TeX, but need to learn about Perl, PG, and MathObjects (pdf file) -- (by Paul Pearson).

Revision as of 17:48, 5 November 2020

Templates

Most people write problems starting from templates. Problems from the OPL can be modified to suit individual needs, or existing problem templates can be used to create new problems.

  • Problem Techniques This page lists templates for WeBWorK problems in alphabetical order. This collection of templates can also be accessed through the associated category page: Category:Problem Techniques
  • Subject Area Templates Some may find it useful to use this page where templates are ordered by subject area.
  • Sample_Problems A third page with a collection of templates is this page of sample problems. These are very basic examples that illustrate the structure of a WeBWorK problem.

Basic Information

WeBWorK problems should be written with the use of MathObjects. Most of the templates mentioned above will include the MathObject Macros (recognizable by the line "MathObjects.pl" in the LoadMacros section of the code). For those who would like to read up on the basics of coding problems the following pages are recommended:

Reference documents and manuals

  • Intro to Problem Authoring Introduction to the basics of Perl, MathObjects, and PGML (Nov 2020) -- includes problem templates
  • Problem Authoring Videos Complete course of streamed recordings from the PREP 2015 Workshop on Problem Authoring
  • Applets, how to embed Flash and Java applets into WeBWorK questions.
  • SequentialProblems revealing the problem one step at a time
  • POD -- POD = "plain old documentation" -- original documentation embedded in the code files -- this is the place to find the most complete and most technical description of macro behaviors.
  • Doxygen Doxygen compiles a list of all the subroutines occurring in all the files from the webwork2 and pg directories. Can be used to find where a macro command is defined.
  • WeBWorK Problem Authoring Tutorial aimed at people who already know TeX, but need to learn about Perl, PG, and MathObjects (pdf file) -- (by Paul Pearson).
  • Customize Course This page includes a bit of code that allows student to obtain a new version of a problem.
  • Notes on training authors, and suggestions for further documentation-- Sam Hathaway
  • The Good Questions project at Cornell University [1]
  • Converting CAPA problems for use with WeBWorK (This article has been retained as a historical document.)

Other

Echo-ambass-48px.png
Developers
Become a WeBWorK Developer
Gartoon-credits-48px.png
Contributors
WeBWorK Contributors - join us! (blog posts)
Echo-ambass-48px.png
Learning How to Author Problems
Various tools and tricks for writing problems