Authors

From WeBWorK
(Difference between revisions)
Jump to: navigation, search
(Created page with "== Learning how to Author WeBWorK problems == * See '''Problem Authoring Background Information''' and '''sample problems''' If you're ju...")
 
Line 1: Line 1:
== Learning how to Author WeBWorK problems ==
+
{|width = "100%" align="center"
 
+
|style="width: 33%; border-width: 0px;"|{{projectline|WeBWorK_Sites|WeBWorK Sites|Map of known WeBWorK Sites|gartoon-globe-48px.svg}}
* See  '''[[Problem Authoring Background Information]]''' and '''[[:Category:Sample Problems|sample problems]]''' If you're just starting out.
+
|style="width: 33%; border-width: 0px;"|{{projectline|extlink=false|Events|Events|Upcoming WeBWorK Events (JMM-Jan 3-7) |echo-calendar-48px.png}}
* 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.
+
|style="width: 33%; border-width: 0px;"|{{projectline|extlink=true|http://webwork.maa.org/moodle/mod/forum/index.php{{?}}id{{=}}3|Forums|WeBWorK Discussion Forums|quote-48px.png}}
* See ''' [[SampleProblem4 |PGML]]''' (Template 4) to learn techniques which simplify formatting  the appearance of the questions.  
+
|style="width: 34%; border-width: 0px;"|{{projectline|IRC|IRC|IRC chat support channel for WeBWorK Instructors, Developers, and Admins|gartoon-irc-48px.svg}}
* 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.
+
|style="width: 33%; border-width: 0px;"|{{projectline|Video conferences|Web-Conferences|Information about WeBWorK Web-Conferences|gartoon-video-48px.svg}}
 +
|style="width: 33%; border-width: 0px;"|{{projectline|Mailing Lists|Mailing Lists|WeBWorK Development Email Lists|gartoon-mail-48px.svg}}
 +
|-
 +
|style="width: 33%; border-width: 0px;"|{{projectline|WeBWorK_Consultants,_Workshops_and_Training_Sessions|Consultants|Information for and about WeBWorK Consultants|echo-ambass-48px.png}}
 +
|style="width: 33%; border-width: 0px;"|{{projectline|Contributors|Contributors|WeBWorK Contributors - join us! [http://webwork.maa.org/planet (blog posts)]|gartoon-credits-48px.svg}}
 +
|}
  
== Basic info and Sample Problems ==
+
[[Learning How to Author 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]]
+

Revision as of 15:11, 7 August 2012

Error creating thumbnail: /var/lib/mediawiki/bin/ulimit4.sh: line 4: rsvg: command not found
WeBWorK Sites
Map of known WeBWorK Sites
Echo-calendar-48px.png
Events
Upcoming WeBWorK Events (JMM-Jan 3-7)
Quote-48px.png
Forums
WeBWorK Discussion Forums
Error creating thumbnail: /var/lib/mediawiki/bin/ulimit4.sh: line 4: rsvg: command not found
IRC
IRC chat support channel for WeBWorK Instructors, Developers, and Admins
Error creating thumbnail: /var/lib/mediawiki/bin/ulimit4.sh: line 4: rsvg: command not found
Web-Conferences
Information about WeBWorK Web-Conferences
Error creating thumbnail: /var/lib/mediawiki/bin/ulimit4.sh: line 4: rsvg: command not found
Mailing Lists
WeBWorK Development Email Lists
Echo-ambass-48px.png
Consultants
Information for and about WeBWorK Consultants
Error creating thumbnail: /var/lib/mediawiki/bin/ulimit4.sh: line 4: rsvg: command not found
Contributors
WeBWorK Contributors - join us! (blog posts)

Learning How to Author Problems

follow us