|
|
| Line 1: |
Line 1: |
| == Learning how to Author WeBWorK problems ==
| |
|
| |
| * See '''[[Problem Authoring Background Information]]''' and '''[[:Category:Sample Problems|sample problems]]''' If you're just starting out.
| |
| * See '''[[SubjectAreaTemplates|subject area templates]]''' if you're looking for complete examples from very basic to advanced.
| |
| * See '''[[:Category:Problem_Techniques|index of problem techniques]]''' section if you need help with one particular construct.
| |
| * See ''' [[SampleProblem4 |PGML]]''' (Template 4) to learn techniques which simplify formatting the appearance of the questions.
| |
| * See '''[[:Category:MathObjects|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 ==
| |
|
| |
| * [[Problem Authoring Background Information]] (Big picture overview)
| |
| * '''[[:File:WeBWorK_Problem_Authoring_Tutorial.pdf|Problem Authoring Tutorial]]''' aimed at people who already know TeX, but need to learn about Perl, PG, and MathObjects.
| |
| * [[:Category:Sample Problems|Index of Sample Problems]]
| |
| ** [[SampleProblem1|Template 1]] (the basic structure of a WeBWorK PG problem file)
| |
| ** [[old-style example template|SampleProblem1a]] (old-style, non-MathObjects example)
| |
| ** [[SampleProblem2|Template 2]] (formulas, multiple choice, and string entry problems)
| |
| ** [[SampleProblem3|Template 3]] (dynamically generated graphs)
| |
| ** '''NEW''' --[[SampleProblem4|Template 4]] (illustrates PGML markup)
| |
| * More Advanced Sample Problems
| |
| ** ....
| |
|
| |
| == Reference Documents ==
| |
|
| |
| * '''[[:Category:Problem Techniques|Index of Problem Techniques]]''' ** very useful code fragments
| |
| * '''[[SubjectAreaTemplates | Subject Area Templates]]''' ** complete examples for questions on various math subjects
| |
| * '''[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.
| |
| * '''[[PGLabs]]''', On-line labs for rendering of PG code. These labs allow you to interactively experiment with PG syntax online.
| |
| * [https://courses.webwork.maa.org/webwork2/cervone_course/PGML-examples/?login_practice_user=true '''PGML''' ] formatting examples.
| |
| * The Good Questions project at Cornell University [http://www.math.cornell.edu/~GoodQuestions/]
| |
|
| |
| == Manuals and HOWTOs ==
| |
|
| |
| * '''[[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.
| |
| * '''[[: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.
| |
| **[https://courses.webwork.maa.org/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.
| |
|
| |
|
| |
| * [[Customize_Course]]
| |
| * [[: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 ==
| |
| (older reference material )
| |
|
| |
| * [[Problem Authoring Background Information]]
| |
| * [[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]]
| |
| * [[Problem Authoring Best Practices]] for problem authoring.
| |
| ** [[What to do if you find a bug in a problem]]
| |
| ** [[Tagging Problems]] with metadata for indexing and searching.
| |
|
| |
|
| |
| [[Category:Top]]
| |