Difference between revisions of "Template:SettingSummary"

From WeBWorK_wiki
Jump to navigation Jump to search
(Template for documenting webwork system/course settings)
 
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<includeonly><!--
 
<includeonly><!--
-->[[Category:WeBWorK configuration settings|{{{name|{{BASEPAGENAME}}<!-- -->}}}]]<!--
+
-->[[Category:WeBWorK configuration settings|{{{name}}}]]<!--
 
-->[[Category:WeBWorK configuration settings {{{version_min|version unknown}}}|<!--
 
-->[[Category:WeBWorK configuration settings {{{version_min|version unknown}}}|<!--
-->{{{name|{{BASEPAGENAME}}<!-- -->}}}<!--
+
-->{{{name}}}<!--
 
-->]]<!--
 
-->]]<!--
--></includeonly><!--
+
--></includeonly>
   
-->{{#if: {{{version_max|}}} |<!--
+
{{#if: {{{version_max|}}}
-->{{obsolete|<!-- 1 -->{{{version_max}}}|<!-- name -->name={{{name|{{BASEPAGENAME}}}}}|<!-- -->newvarlink={{{newvarlink|}}}|newvarname={{{newvarname|}}}}}<!--
+
|{{obsolete|{{{version_max}}}
-->}}<!--
+
|name={{{name}}}
  +
|newvarlink={{{newvarlink|}}}
  +
|newvarname={{{newvarname|}}}}}
   
-->{{#if: {{{section|}}} |<!--
 
  +
}}
  +
  +
{{#if: {{{section|}}} |<!--
 
-->{{#switch: {{lc: {{{section}}} }}|
 
-->{{#switch: {{lc: {{{section}}} }}|
seed=[[Category:Seed variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
seed=[[Category:Seed variables|{{{name}}}]]|
path=[[Category:Path variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
path=[[Category:Path variables|{{{name}}}]]|
email settings=[[Category:Email variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
email settings=[[Category:Email variables|{{{name}}}]]|
feedback=[[Category:Feedback variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
feedback=[[Category:Feedback variables|{{{name}}}]]|
theme=[[Category:Theme variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
theme=[[Category:Theme variables|{{{name}}}]]|
system dir=[[Category:System-wide directory variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
system dir=[[Category:System-wide directory variables|{{{name}}}]]|
system url=[[Category:System-wide URL variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
system url=[[Category:System-wide URL variables|{{{name}}}]]|
course dir=[[Category:Course-specific directory variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
course dir=[[Category:Course-specific directory variables|{{{name}}}]]|
course url=[[Category:Course-specific URL variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
course url=[[Category:Course-specific URL variables|{{{name}}}]]|
system file=[[Category:System-wide file variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
system file=[[Category:System-wide file variables|{{{name}}}]]|
course file=[[Category:System-wide file variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
course file=[[Category:System-wide file variables|{{{name}}}]]|
enrollment=[[Category:Enrollment status variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
enrollment=[[Category:Enrollment status variables|{{{name}}}]]|
database settings=[[Category:Database variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
database settings=[[Category:Database variables|{{{name}}}]]|
problem library=[[Category:Problem library variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
problem library=[[Category:Problem library variables|{{{name}}}]]|
logs=[[Category:Logging variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
logs=[[Category:Logging variables|{{{name}}}]]|
site default=[[Category:Site defaults variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
site default=[[Category:Site defaults variables|{{{name}}}]]|
Authentication system=[[Category:Authentication system variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
Authentication system=[[Category:Authentication system variables|{{{name}}}]]|
Authorization system=[[Category:Authorization system variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
Authorization system=[[Category:Authorization system variables|{{{name}}}]]|
Session options=[[Category:Session variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
Session options=[[Category:Session variables|{{{name}}}]]|
PG subsystem options=[[Category:Pg subsystem variables|{{{name|{{BASEPAGENAME}}}}}]]|
+
PG subsystem options=[[Category:Pg subsystem variables|{{{name}}}]]|
Problem creation defaults=[[Category:Problem creation variables|{{{name|{{BASEPAGENAME}}}}}]]<!--
+
Problem creation defaults=[[Category:Problem creation variables|{{{name}}}]]<!--
 
-->}}<!--
 
-->}}<!--
 
-->}}
 
-->}}
Line 38: Line 40:
 
{| style="text-align: left; border: 1px solid black; border-collapse: collapse;" cellpadding="5"
 
{| style="text-align: left; border: 1px solid black; border-collapse: collapse;" cellpadding="5"
 
|-
 
|-
! colspan="2" style="font-size: 120%; padding: 0.5em; text-align: center; background-color: #ccccff;" | [[:Configuration settings#{{{section|top}}}|{{{section|WeBWorK Setting}}}]]: {{BASEPAGENAME}}
+
! colspan="2" style="font-size: 120%; padding: 0.5em; text-align: center; background-color: #ccccff;" | [[Configuration settings#{{{section|top}}}|{{{section|WeBWorK Setting}}}]]: {{BASEPAGENAME}}
 
|-
 
|-
 
| colspan="2" style="text-align: center; margin: 0.3em;" |{{{summary|Please edit this page to enter a summary.}}}<br>
 
| colspan="2" style="text-align: center; margin: 0.3em;" |{{{summary|Please edit this page to enter a summary.}}}<br>

Latest revision as of 10:59, 2 June 2010



WeBWorK Setting: SettingSummary
Please edit this page to enter a summary.
Introduced in version: Unknown
Removed in version: still in use
Allowed values: Unspecified
Defined in: Unspecified
Default value: Unspecified

Other settings: Alphabetical | By Function


Copy and paste template

{{SettingSummary
|name = 
|summary = 
|section = 
|version_min = 
|version_max = 
|range = 
|file =
|default = 
|newvarlink =
|newvarname =
}}

Usage notes

  • name
The name of the setting. E.g. $externalPrograms{latex}
  • summary
A short description of the setting's purpose.
More detailed descriptions are desirable, and should be added to the main page content.
If you update the short description, please also update the two tables at Configuration settings and Configuration settings (alphabetical).
  • section
The category that this setting comes under. This is automatically made into a link to the correct section in Configuration settings, so make sure you use an existing heading (or a new heading that you may add).
  • version_min, version_max
The version of WeBWorK the setting was introduced in (version_min) and the version it was removed in (version_max). Leave out version_max if the setting is still in use. If the setting is no longer used, this template automatically adds the {{obsolete}} template to the top of the page. Only include official versions - beta versions, release candidates, etc. should not be mentioned here (use the rev_introduced field if you want to give full precision).
  • rev_introduced
The revision this feature is introduced, only displayed if version_min is defined. Don't include the leading 'r' (i.e. use rev_introduced=1509, not rev_introduced=r1509)
  • range
The range of allowable values, e.g. "0 - 255", "boolean", "string containing a URL or """.
  • default
The default value defined in the appropriate *.dist config file. If this is different in different versions of the software, then such variations should be noted.
  • file
The file in which the variable is defined, e.g. global.conf, webwork-apache2.config, etc.
  • newvarlink
For obsolete settings replaced by another setting, the link to the variable page that took its place
  • newvarname
For obsolete settings replaced by another setting, the new setting name

If the 'range' or 'default' sections are more than a couple of lines long, then simply put (see below) and fill in the details in the main body of the page.