Module:Documentation/config: Difference between revisions

From TEPwiki, Urth's Encyclopedia
Jump to navigation Jump to search
Content added Content deleted
(split experimentBlurb into two separate messages so that we can avoid guessing whether languages have possessive forms or not)
m (1 revision imported)
 
(46 intermediate revisions by 18 users not shown)
Line 9: Line 9:


local cfg = {} -- Do not edit this line.
local cfg = {} -- Do not edit this line.

----------------------------------------------------------------------------------------------------
-- Environment configuration
----------------------------------------------------------------------------------------------------

-- cfg.titleArg
-- An argument to specify what page to make links for. For testing purposes.
cfg.titleArg = 'page'

-- cfg.titleArgError
-- The error message to display if the value of the cfg.titleArg argument does not result in a
-- valid title.
cfg.titleArgError = '$1 is not a valid title'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 27: Line 14:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg['protection-reason-edit']
-- cfg.protectionTemplate
-- The protection reason for edit-protected templates to pass to
-- The name of the template that displays the protection icon (a padlock on enwiki).
-- [[Module:Protection banner]].
cfg.protectionTemplate = 'pp-template'
cfg['protection-reason-edit'] = 'template'

-- cfg.protectionTemplateArgs
-- Any arguments to send to the protection template.
cfg.protectionTemplateArgs = {docusage = 'yes'}


--[[
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
-- Sandbox template configuration
-- Sandbox notice configuration
--
--
-- On sandbox pages the module can display a template notifying users that the current page is a
-- On sandbox pages the module can display a template notifying users that the current page is a
-- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
-- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
-- sandbox or not based on the value of cfg.sandboxSubpage. The following settings configure which
-- sandbox or not based on the value of cfg['sandbox-subpage']. The following settings configure the
-- messages that the notices contains.
-- template is displayed and what the arguments passed to it are.
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
--]]

-- cfg['sandbox-notice-image']
-- The image displayed in the sandbox notice.
cfg['sandbox-notice-image'] = '[[File:Sandbox.svg|50px|alt=|link=]]'

--[[
-- cfg['sandbox-notice-pagetype-template']
-- cfg['sandbox-notice-pagetype-module']
-- cfg['sandbox-notice-pagetype-other']
-- The page type of the sandbox page. The message that is displayed depends on the current subject
-- namespace. This message is used in either cfg['sandbox-notice-blurb'] or
-- cfg['sandbox-notice-diff-blurb'].
--]]
cfg['sandbox-notice-pagetype-template'] = '[[Wikipedia:Template test cases|template sandbox]] page'
cfg['sandbox-notice-pagetype-module'] = '[[Wikipedia:Template test cases|module sandbox]] page'
cfg['sandbox-notice-pagetype-other'] = 'sandbox page'

--[[
-- cfg['sandbox-notice-blurb']
-- cfg['sandbox-notice-diff-blurb']
-- cfg['sandbox-notice-diff-display']
-- Either cfg['sandbox-notice-blurb'] or cfg['sandbox-notice-diff-blurb'] is the opening sentence
-- of the sandbox notice. The latter has a diff link, but the former does not. $1 is the page
-- type, which is either cfg['sandbox-notice-pagetype-template'],
-- cfg['sandbox-notice-pagetype-module'] or cfg['sandbox-notice-pagetype-other'] depending what
-- namespace we are in. $2 is a link to the main template page, and $3 is a diff link between
-- the sandbox and the main template. The display value of the diff link is set by
-- cfg['sandbox-notice-compare-link-display'].
--]]
cfg['sandbox-notice-blurb'] = 'This is the $1 for $2.'
cfg['sandbox-notice-diff-blurb'] = 'This is the $1 for $2 ($3).'
cfg['sandbox-notice-compare-link-display'] = 'diff'


--[[
-- cfg.sandboxNoticeTemplate
-- cfg['sandbox-notice-testcases-blurb']
-- The name of the template to display at the top of sandbox pages.
cfg.sandboxNoticeTemplate = 'template sandbox notice'
-- cfg['sandbox-notice-testcases-link-display']
-- cfg['sandbox-notice-testcases-run-blurb']
-- cfg['sandbox-notice-testcases-run-link-display']
-- cfg['sandbox-notice-testcases-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit. $1 is a link to the test cases page.
-- cfg['sandbox-notice-testcases-link-display'] is the display value for that link.
-- cfg['sandbox-notice-testcases-run-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit, along with a link to run it. $1 is a link to the test
-- cases page, and $2 is a link to the page to run it.
-- cfg['sandbox-notice-testcases-run-link-display'] is the display value for the link to run the test
-- cases.
--]]
cfg['sandbox-notice-testcases-blurb'] = 'See also the companion subpage for $1.'
cfg['sandbox-notice-testcases-link-display'] = 'test cases'
cfg['sandbox-notice-testcases-run-blurb'] = 'See also the companion subpage for $1 ($2).'
cfg['sandbox-notice-testcases-run-link-display'] = 'run'


-- cfg['sandbox-category'] - A category to add to all template sandboxes.
-- cfg.sandboxNoticeLivepageParam
-- cfg['module-sandbox-category'] - A category to add to all module sandboxes.
-- The parameter of the sandbox notice template to send the cfg.livepageArg to.
-- cfg['module-sandbox-category'] - A category to add to all sandboxe not in templates or modules.
cfg.sandboxNoticeLivepageParam = 1
cfg['sandbox-category'] = 'Template sandboxes'
cfg['module-sandbox-category'] = 'Module sandboxes'
cfg['other-sandbox-category'] = 'Sandboxes outside of template or module namespace'


-- cfg.livepageArg
-- The name of one of the module arguments. The value of this argument should be the main template
-- page (i.e. the "live" template). This is passed to the parameter cfg.sandboxNoticeLivepageParam of
-- the template cfg.sandboxNoticeTemplate.
cfg.livepageArg = 'livepage'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 62: Line 93:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg['documentation-icon-wikitext']
-- cfg.documentationIconWikitext
-- The wikitext for the icon shown at the top of the template.
-- The wikitext for the icon shown at the top of the template.
cfg.documentationIconWikitext = '[[File:Template-info.png|50px|link=|alt=Documentation icon]]'
cfg['documentation-icon-wikitext'] = '[[File:Test Template Info-Icon - Version (2).svg|50px|link=|alt=]]'


-- cfg['template-namespace-heading']
-- cfg.headingArg
-- Custom heading used in the start box.
cfg.headingArg = 'heading'

-- cfg.headingStyleArg
-- Custom CSS style for the start box heading.
cfg.headingStyleArg = 'heading-style'

-- cfg.templateNamespaceHeading
-- The heading shown in the template namespace.
-- The heading shown in the template namespace.
cfg.templateNamespaceHeading = 'Template documentation'
cfg['template-namespace-heading'] = 'Template documentation'


-- cfg['module-namespace-heading']
-- cfg.moduleNamespaceHeading
-- The heading shown in the module namespace.
-- The heading shown in the module namespace.
cfg.moduleNamespaceHeading = 'Module documentation'
cfg['module-namespace-heading'] = 'Module documentation'


-- cfg['file-namespace-heading']
-- cfg.fileNamespaceHeading
-- The heading shown in the file namespace.
-- The heading shown in the file namespace.
cfg.fileNamespaceHeading = 'Summary'
cfg['file-namespace-heading'] = 'Summary'


-- cfg['other-namespaces-heading']
-- cfg.otherNamespacesHeading
-- The heading shown in other namespaces.
-- The heading shown in other namespaces.
cfg.otherNamespacesHeading = 'Documentation'
cfg['other-namespaces-heading'] = 'Documentation'


-- cfg.viewLinkDisplay
-- cfg['view-link-display']
-- The text to display for "view" links.
-- The text to display for "view" links.
cfg.viewLinkDisplay = 'view'
cfg['view-link-display'] = 'view'


-- cfg.editLinkDisplay
-- cfg['edit-link-display']
-- The text to display for "edit" links.
-- The text to display for "edit" links.
cfg.editLinkDisplay = 'edit'
cfg['edit-link-display'] = 'edit'


-- cfg['history-link-display']
-- cfg.historyLinkDisplay
-- The text to display for "history" links.
-- The text to display for "history" links.
cfg.historyLinkDisplay = 'history'
cfg['history-link-display'] = 'history'


-- cfg.purgeLinkDisplay
-- cfg['purge-link-display']
-- The text to display for "purge" links.
-- The text to display for "purge" links.
cfg.purgeLinkDisplay = 'purge'
cfg['purge-link-display'] = 'purge'


-- cfg.createLinkDisplay
-- cfg['create-link-display']
-- The text to display for "create" links.
-- The text to display for "create" links.
cfg.createLinkDisplay = 'create'
cfg['create-link-display'] = 'create'

----------------------------------------------------------------------------------------------------
-- Preload configuration
----------------------------------------------------------------------------------------------------

-- cfg.preloadArg
-- Custom preload page for creating documentation.
cfg.preloadArg = 'preload'

----------------------------------------------------------------------------------------------------
-- Documentation content configuration
----------------------------------------------------------------------------------------------------

-- cfg.contentArg
-- Passes documentation content directly from the {{documentation}} invocation.
cfg.contentArg = 'content'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 130: Line 137:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg['transcluded-from-blurb']
-- cfg.linkBoxArg
-- Specifies a custom link box (end box) or prevents it from being generated.
cfg.linkBoxArg = 'link box'

-- cfg.linkBoxOff
-- The value to send to cfg.linkBoxArg to turn the link box off.
cfg.linkBoxOff = 'off'

-- cfg.transcludedFromBlurb
-- Notice displayed when the docs are transcluded from another page. $1 is a wikilink to that page.
-- Notice displayed when the docs are transcluded from another page. $1 is a wikilink to that page.
cfg.transcludedFromBlurb = 'The above [[Wikipedia:Template documentation|documentation]] is [[Wikipedia:Transclusion|transcluded]] from $1.'
cfg['transcluded-from-blurb'] = 'The above [[Wikipedia:Template documentation|documentation]] is [[Help:Transclusion|transcluded]] from $1.'


--[[
-- cfg.createModuleDocBlurb
-- cfg['create-module-doc-blurb']
-- Notice displayed in the module namespace when the documentation subpage does not exist.
-- Notice displayed in the module namespace when the documentation subpage does not exist.
-- $1 is a link to create the documentation page with the preload cfg.modulePreload and the
-- $1 is a link to create the documentation page with the preload cfg['module-preload'] and the
-- display cfg.createLinkDisplay.
-- display cfg['create-link-display'].
--]]
cfg.createModuleDocBlurb = 'You might want to $1 a documentation page for this [[Wikipedia:Lua|Scribunto module]].'
cfg['create-module-doc-blurb'] = 'You might want to $1 a documentation page for this [[Wikipedia:Lua|Scribunto module]].'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 152: Line 153:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


--[[
-- cfg.experimentBlurbTemplate
-- cfg['experiment-blurb-template']
-- cfg.experimentBlurbModule
-- cfg['experiment-blurb-module']
-- The experiment blurb is the text inviting editors to experiment in sandbox and test cases pages.
-- The experiment blurb is the text inviting editors to experiment in sandbox and test cases pages.
-- It is only shown in the template and module namespaces. With the default English settings, it
-- It is only shown in the template and module namespaces. With the default English settings, it
Line 162: Line 164:
-- In this example, "sandbox", "edit", "diff", "testcases", and "edit" would all be links.
-- In this example, "sandbox", "edit", "diff", "testcases", and "edit" would all be links.
--
--
-- There are two versions, cfg.experimentBlurbTemplate and cfg.experimentBlurbModule, depending
-- There are two versions, cfg['experiment-blurb-template'] and cfg['experiment-blurb-module'], depending
-- on what namespace we are in.
-- on what namespace we are in.
--
--
Line 169: Line 171:
-- $1 is a link to the sandbox page. If the sandbox exists, it is in the following format:
-- $1 is a link to the sandbox page. If the sandbox exists, it is in the following format:
--
--
-- cfg.sandboxLinkDisplay (cfg.sandboxEditLinkDisplay | cfg.compareLinkDisplay)
-- cfg['sandbox-link-display'] (cfg['sandbox-edit-link-display'] | cfg['compare-link-display'])
--
--
-- If the sandbox doesn't exist, it is in the format:
-- If the sandbox doesn't exist, it is in the format:
--
--
-- cfg.sandboxLinkDisplay (cfg.sandboxCreateLinkDisplay | cfg.mirrorLinkDisplay)
-- cfg['sandbox-link-display'] (cfg['sandbox-create-link-display'] | cfg['mirror-link-display'])
--
--
-- The link for cfg.sandboxCreateLinkDisplay link preloads the page with cfg.templateSandboxPreload
-- The link for cfg['sandbox-create-link-display'] link preloads the page with cfg['template-sandbox-preload']
-- or cfg.moduleSandboxPreload, depending on the current namespace. The link for cfg.mirrorLinkDisplay
-- or cfg['module-sandbox-preload'], depending on the current namespace. The link for cfg['mirror-link-display']
-- loads a default edit summary of cfg.mirrorEditSummary.
-- loads a default edit summary of cfg['mirror-edit-summary'].
--
--
-- $2 is a link to the test cases page. If the test cases page exists, it is in the following format:
-- $2 is a link to the test cases page. If the test cases page exists, it is in the following format:
--
--
-- cfg['testcases-link-display'] (cfg['testcases-edit-link-display'] | cfg['testcases-run-link-display'])
-- cfg.testcasesLinkDisplay (cfg.testcasesEditLinkDisplay)
--
--
-- If the test cases page doesn't exist, it is in the format:
-- If the test cases page doesn't exist, it is in the format:
--
--
-- cfg.testcasesLinkDisplay (cfg.testcasesCreateLinkDisplay)
-- cfg['testcases-link-display'] (cfg['testcases-create-link-display'])
--
--
-- If the test cases page doesn't exist, the link for cfg.testcasesCreateLinkDisplay preloads the
-- If the test cases page doesn't exist, the link for cfg['testcases-create-link-display'] preloads the
-- page with cfg.templateTestcasesPreload or cfg.moduleTestcasesPreload, depending on the current
-- page with cfg['template-testcases-preload'] or cfg['module-testcases-preload'], depending on the current
-- namespace.
-- namespace.
--]]
cfg.experimentBlurbTemplate = "Editors can experiment in this template's $1 and $2 pages."
cfg.experimentBlurbModule = "Editors can experiment in this module's $1 and $2 pages."
cfg['experiment-blurb-template'] = "Editors can experiment in this template's $1 and $2 pages."
cfg['experiment-blurb-module'] = "Editors can experiment in this module's $1 and $2 pages."


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 197: Line 200:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg.sandboxSubpage
-- cfg['sandbox-subpage']
-- The name of the template subpage typically used for sandboxes.
-- The name of the template subpage typically used for sandboxes.
cfg.sandboxSubpage = 'sandbox'
cfg['sandbox-subpage'] = 'sandbox'


-- cfg['template-sandbox-preload']
-- cfg.templateSandboxPreload
-- Preload file for template sandbox pages.
-- Preload file for template sandbox pages.
cfg.templateSandboxPreload = 'Template:Documentation/preload-sandbox'
cfg['template-sandbox-preload'] = 'Template:Documentation/preload-sandbox'


-- cfg['module-sandbox-preload']
-- cfg.moduleSandboxPreload
-- Preload file for Lua module sandbox pages.
-- Preload file for Lua module sandbox pages.
cfg.moduleSandboxPreload = 'Template:Documentation/preload-module-sandbox'
cfg['module-sandbox-preload'] = 'Template:Documentation/preload-module-sandbox'


-- cfg['sandbox-link-display']
-- cfg.sandboxLinkDisplay
-- The text to display for "sandbox" links.
-- The text to display for "sandbox" links.
cfg.sandboxLinkDisplay = 'sandbox'
cfg['sandbox-link-display'] = 'sandbox'


-- cfg['sandbox-edit-link-display']
-- cfg.sandboxEditLinkDisplay
-- The text to display for sandbox "edit" links.
-- The text to display for sandbox "edit" links.
cfg.sandboxEditLinkDisplay = 'edit'
cfg['sandbox-edit-link-display'] = 'edit'


-- cfg['sandbox-create-link-display']
-- cfg.sandboxCreateLinkDisplay
-- The text to display for sandbox "create" links.
-- The text to display for sandbox "create" links.
cfg.sandboxCreateLinkDisplay = 'create'
cfg['sandbox-create-link-display'] = 'create'


-- cfg['compare-link-display']
-- cfg.compareLinkDisplay
-- The text to display for "compare" links.
-- The text to display for "compare" links.
cfg.compareLinkDisplay = 'diff'
cfg['compare-link-display'] = 'diff'


-- cfg.mirrorEditSummary
-- cfg['mirror-edit-summary']
-- The default edit summary to use when a user clicks the "mirror" link. $1 is a wikilink to the
-- The default edit summary to use when a user clicks the "mirror" link. $1 is a wikilink to the
-- template page.
-- template page.
cfg.mirrorEditSummary = 'Create sandbox version of $1'
cfg['mirror-edit-summary'] = 'Create sandbox version of $1'


-- cfg.mirrorLinkDisplay
-- cfg['mirror-link-display']
-- The text to display for "mirror" links.
-- The text to display for "mirror" links.
cfg.mirrorLinkDisplay = 'mirror'
cfg['mirror-link-display'] = 'mirror'

-- cfg['mirror-link-preload']
-- The page to preload when a user clicks the "mirror" link.
cfg['mirror-link-preload'] = 'Template:Documentation/mirror'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 238: Line 245:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg.testcasesSubpage
-- cfg['testcases-subpage']
-- The name of the template subpage typically used for test cases.
-- The name of the template subpage typically used for test cases.
cfg.testcasesSubpage = 'testcases'
cfg['testcases-subpage'] = 'testcases'


-- cfg['template-testcases-preload']
-- cfg.templateTestcasesPreload
-- Preload file for template test cases pages.
-- Preload file for template test cases pages.
cfg.templateTestcasesPreload = 'Template:Documentation/preload-testcases'
cfg['template-testcases-preload'] = 'Template:Documentation/preload-testcases'


-- cfg['module-testcases-preload']
-- cfg.moduleTestcasesPreload
-- Preload file for Lua module test cases pages.
-- Preload file for Lua module test cases pages.
cfg.moduleTestcasesPreload = 'Template:Documentation/preload-module-testcases'
cfg['module-testcases-preload'] = 'Template:Documentation/preload-module-testcases'


-- cfg['testcases-link-display']
-- cfg.testcasesLinkDisplay
-- The text to display for "testcases" links.
-- The text to display for "testcases" links.
cfg.testcasesLinkDisplay = 'testcases'
cfg['testcases-link-display'] = 'testcases'


-- cfg['testcases-edit-link-display']
-- cfg.testcasesEditLinkDisplay
-- The text to display for test cases "edit" links.
-- The text to display for test cases "edit" links.
cfg.testcasesEditLinkDisplay = 'edit'
cfg['testcases-edit-link-display'] = 'edit'


-- cfg['testcases-run-link-display']
-- cfg.testcasesCreateLinkDisplay
-- The text to display for test cases "run" links.
cfg['testcases-run-link-display'] = 'run'

-- cfg['testcases-create-link-display']
-- The text to display for test cases "create" links.
-- The text to display for test cases "create" links.
cfg.testcasesCreateLinkDisplay = 'create'
cfg['testcases-create-link-display'] = 'create'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 266: Line 277:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


--[[
-- cfg.addCategoriesBlurb
-- cfg['add-categories-blurb']
-- Text to direct users to add categories to the /doc subpage. Not used if the "content" or
-- Text to direct users to add categories to the /doc subpage. Not used if the "content" or
-- "docname fed" arguments are set, as then it is not clear where to add the categories. $1 is a
-- "docname fed" arguments are set, as then it is not clear where to add the categories. $1 is a
-- link to the /doc subpage with a display value of cfg.docLinkDisplay.
-- link to the /doc subpage with a display value of cfg['doc-link-display'].
--]]
cfg.addCategoriesBlurb = 'Please add categories to the $1 subpage.'
cfg['add-categories-blurb'] = 'Add categories to the $1 subpage.'


-- cfg.docLinkDisplay
-- cfg['doc-link-display']
-- The text to display when linking to the /doc subpage.
-- The text to display when linking to the /doc subpage.
cfg.docLinkDisplay = '/doc'
cfg['doc-link-display'] = '/doc'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 280: Line 293:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


--[[
-- cfg.subpagesLinkDisplay
-- cfg['subpages-blurb']
-- The text to display for the "subpages of this page" link. $1 is cfg.templatePagetype,
-- The "Subpages of this template" blurb. $1 is a link to the main template's subpages with a
-- cfg.modulePagetype or cfg.defaultPagetype, depending on whether the current page is in th
-- display value of cfg['subpages-link-display']. In the English version this blurb is simply
-- e template namespace, the module namespace, or another namespace.
-- the link followed by a period, and the link display provides the actual text.
cfg.subpagesLinkDisplay = 'Subpages of this $1'
--]]
cfg['subpages-blurb'] = '$1.'


--[[
-- cfg.templatePagetype
-- cfg['subpages-link-display']
-- The text to display for the "subpages of this page" link. $1 is cfg['template-pagetype'],
-- cfg['module-pagetype'] or cfg['default-pagetype'], depending on whether the current page is in
-- the template namespace, the module namespace, or another namespace.
--]]
cfg['subpages-link-display'] = 'Subpages of this $1'

-- cfg['template-pagetype']
-- The pagetype to display for template pages.
-- The pagetype to display for template pages.
cfg.templatePagetype = 'template'
cfg['template-pagetype'] = 'template'


-- cfg.modulePagetype
-- cfg['module-pagetype']
-- The pagetype to display for Lua module pages.
-- The pagetype to display for Lua module pages.
cfg.modulePagetype = 'module'
cfg['module-pagetype'] = 'module'


-- cfg.defaultPagetype
-- cfg['default-pagetype']
-- The pagetype to display for pages other than templates or Lua modules.
-- The pagetype to display for pages other than templates or Lua modules.
cfg.defaultPagetype = 'page'
cfg['default-pagetype'] = 'page'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 302: Line 325:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg.docSubpage
-- cfg['doc-subpage']
-- The name of the subpage typically used for documentation pages.
-- The name of the subpage typically used for documentation pages.
cfg.docSubpage = 'doc'
cfg['doc-subpage'] = 'doc'

-- cfg.fileDocpagePreload
-- Preload file for documentation page in the file namespace.
cfg.fileDocpagePreload = 'Template:Documentation/preload-filespace'


-- cfg.docpagePreload
-- cfg['docpage-preload']
-- Preload file for template documentation pages in all namespaces.
-- Preload file for template documentation pages in all namespaces.
cfg.docpagePreload = 'Template:Documentation/preload'
cfg['docpage-preload'] = 'Template:Documentation/preload'


-- cfg.modulePreload
-- cfg['module-preload']
-- Preload file for Lua module documentation pages.
-- Preload file for Lua module documentation pages.
cfg.modulePreload = 'Template:Documentation/preload-module-doc'
cfg['module-preload'] = 'Template:Documentation/preload-module-doc'

----------------------------------------------------------------------------------------------------
-- Print version configuration
----------------------------------------------------------------------------------------------------

-- cfg.printSubpage
-- The name of the template subpage used for print versions.
cfg.printSubpage = 'Print'

-- cfg.printLinkDisplay
-- The text to display when linking to the /Print subpage.
cfg.printLinkDisplay = '/Print'

-- cfg.printBlurb
-- Text to display if a /Print subpage exists. $1 is a link to the subpage with a display value of cfg.printLinkDisplay.
cfg.printBlurb = 'A [[Help:Books/for experts#Improving the book layout|print version]] of this template exists at $1.'
.. ' If you make a change to this template, please update the print version as well.'

-- cfg.displayPrintCategory
-- Set to true to enable output of cfg.printCategory if a /Print subpage exists.
cfg.displayPrintCategory = true

-- cfg.printCategory
-- Category to output if cfg.displayPrintCategory is set to true, and a /Print subpage exists.
cfg.printCategory = 'Templates with print versions'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 347: Line 341:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg.mainDivId
-- cfg['templatestyles']
-- The "id" attribute of the main HTML "div" tag.
-- The name of the TemplateStyles page where CSS is kept.
-- Sandbox CSS will be at Module:Documentation/sandbox/styles.css when needed.
cfg.mainDivId = 'template-documentation'
cfg['templatestyles'] = 'Module:Documentation/styles.css'


-- cfg.mainDivClasses
-- cfg['container']
-- The CSS classes added to the main HTML "div" tag.
-- Class which can be used to set flex or grid CSS on the
-- two child divs documentation and documentation-metadata
cfg.mainDivClasses = 'template-documentation iezoomfix'
cfg['container'] = 'documentation-container'


-- cfg.startBoxLinkclasses
-- cfg['main-div-classes']
-- Classes added to the main HTML "div" tag.
-- The CSS classes used for the [view][edit][history] or [create] links in the start box.
cfg['main-div-classes'] = 'documentation'
cfg.startBoxLinkclasses = 'mw-editsection plainlinks'


-- cfg['main-div-heading-class']
-- cfg.startBoxLinkId
-- Class for the main heading for templates and modules and assoc. talk spaces
-- The HTML "id" attribute for the links in the start box.
cfg['main-div-heading-class'] = 'documentation-heading'
cfg.startBoxLinkId = 'doc_editlinks'


-- cfg['start-box-class']
----------------------------------------------------------------------------------------------------
-- Class for the start box
-- {{fmbox}} template configuration
cfg['start-box-class'] = 'documentation-startbox'
----------------------------------------------------------------------------------------------------


-- cfg['start-box-link-classes']
-- cfg.fmboxIdParam
-- Classes used for the [view][edit][history] or [create] links in the start box.
-- The name of the "id" parameter of {{fmbox}}.
-- mw-editsection-like is per [[Wikipedia:Village pump (technical)/Archive 117]]
cfg.fmboxIdParam = 'id'
cfg['start-box-link-classes'] = 'mw-editsection-like plainlinks'


-- cfg.fmboxId
-- cfg['end-box-class']
-- Class for the end box.
-- The id sent to the "id" parameter of the {{fmbox}} template.
cfg.fmboxId = 'documentation-meta-data'
cfg['end-box-class'] = 'documentation-metadata'


-- cfg.fmboxImageParam
-- cfg['end-box-plainlinks']
-- Plainlinks
-- The name of the "image" parameter of {{fmbox}}.
cfg['end-box-plainlinks'] = 'plainlinks'
cfg.fmboxImageParam = 'image'


-- cfg.fmboxImageNone
-- cfg['toolbar-class']
-- Class added for toolbar links.
-- The value to suppress image output from the "image" parameter of {{fmbox}}.
cfg['toolbar-class'] = 'documentation-toolbar'
cfg.fmboxImageNone = 'none'


-- cfg.fmboxStyleParam
-- cfg['clear']
-- Just used to clear things.
-- The name of the "style" parameter of {{fmbox}}.
cfg['clear'] = 'documentation-clear'
cfg.fmboxStyleParam = 'style'


-- cfg.fmboxStyle
-- The value sent to the style parameter of {{fmbox}}.
cfg.fmboxStyle = 'background-color: #ecfcf4'

-- cfg.fmboxTextstyleParam
-- The name of the "textstyle" parameter of {{fmbox}}.
cfg.fmboxTextstyleParam = 'textstyle'

-- cfg.fmboxTextstyle
-- The value sent to the "textstyle parameter of {{fmbox}}.
cfg.fmboxTextstyle = 'font-style: italic'


----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
Line 403: Line 389:
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------


-- cfg['display-strange-usage-category']
-- cfg.displayStrangeUsageCategory
-- Set to true to enable output of cfg.strangeUsageCategory if the module is used on a /doc subpage
-- Set to true to enable output of cfg['strange-usage-category'] if the module is used on a /doc subpage
-- or a /testcases subpage.
-- or a /testcases subpage. This should be a boolean value (either true or false).
cfg.displayStrangeUsageCategory = true
cfg['display-strange-usage-category'] = true


-- cfg['strange-usage-category']
-- cfg.strangeUsageCategory
-- Category to output if cfg.displayStrangeUsageCategory is set to true and the module is used on a
-- Category to output if cfg['display-strange-usage-category'] is set to true and the module is used on a
-- /doc subpage or a /testcases subpage.
-- /doc subpage or a /testcases subpage.
cfg.strangeUsageCategory = 'Wikipedia pages with strange ((documentation)) usage'
cfg['strange-usage-category'] = 'Wikipedia pages with strange ((documentation)) usage'

-- cfg.strangeUsageCategoryMainspaceSort
-- Category sort key prefix to use for cfg.strangeUsageCategory in the main namespace. The prefix
-- is followed by the full page name.
cfg.strangeUsageCategoryMainspaceSort = 'Main:'


--[[
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
-- End configuration
-- End configuration
Line 423: Line 405:
-- Don't edit anything below this line.
-- Don't edit anything below this line.
----------------------------------------------------------------------------------------------------
----------------------------------------------------------------------------------------------------
--]]


return cfg
return cfg

Latest revision as of 18:15, 15 December 2023

Documentation for this module may be created at Module:Documentation/config/doc 

----------------------------------------------------------------------------------------------------
--
--                               Configuration for Module:Documentation
--
-- Here you can set the values of the parameters and messages used in Module:Documentation to
-- localise it to your wiki and your language. Unless specified otherwise, values given here
-- should be string values.
----------------------------------------------------------------------------------------------------

local cfg = {} -- Do not edit this line.

----------------------------------------------------------------------------------------------------
-- Protection template configuration
----------------------------------------------------------------------------------------------------

-- cfg['protection-reason-edit']
-- The protection reason for edit-protected templates to pass to
-- [[Module:Protection banner]].
cfg['protection-reason-edit'] = 'template'

--[[
----------------------------------------------------------------------------------------------------
-- Sandbox notice configuration
--
-- On sandbox pages the module can display a template notifying users that the current page is a
-- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
-- sandbox or not based on the value of cfg['sandbox-subpage']. The following settings configure the
-- messages that the notices contains.
----------------------------------------------------------------------------------------------------
--]]

-- cfg['sandbox-notice-image']
-- The image displayed in the sandbox notice.
cfg['sandbox-notice-image'] = '[[File:Sandbox.svg|50px|alt=|link=]]'

--[[
-- cfg['sandbox-notice-pagetype-template']
-- cfg['sandbox-notice-pagetype-module']
-- cfg['sandbox-notice-pagetype-other']
-- The page type of the sandbox page. The message that is displayed depends on the current subject
-- namespace. This message is used in either cfg['sandbox-notice-blurb'] or
-- cfg['sandbox-notice-diff-blurb'].
--]]
cfg['sandbox-notice-pagetype-template'] = '[[Wikipedia:Template test cases|template sandbox]] page'
cfg['sandbox-notice-pagetype-module'] = '[[Wikipedia:Template test cases|module sandbox]] page'
cfg['sandbox-notice-pagetype-other'] = 'sandbox page'

--[[
-- cfg['sandbox-notice-blurb']
-- cfg['sandbox-notice-diff-blurb']
-- cfg['sandbox-notice-diff-display']
-- Either cfg['sandbox-notice-blurb'] or cfg['sandbox-notice-diff-blurb'] is the opening sentence
-- of the sandbox notice. The latter has a diff link, but the former does not. $1 is the page
-- type, which is either cfg['sandbox-notice-pagetype-template'],
-- cfg['sandbox-notice-pagetype-module'] or cfg['sandbox-notice-pagetype-other'] depending what
-- namespace we are in. $2 is a link to the main template page, and $3 is a diff link between
-- the sandbox and the main template. The display value of the diff link is set by 
-- cfg['sandbox-notice-compare-link-display'].
--]]
cfg['sandbox-notice-blurb'] = 'This is the $1 for $2.'
cfg['sandbox-notice-diff-blurb'] = 'This is the $1 for $2 ($3).'
cfg['sandbox-notice-compare-link-display'] = 'diff'

--[[
-- cfg['sandbox-notice-testcases-blurb']
-- cfg['sandbox-notice-testcases-link-display']
-- cfg['sandbox-notice-testcases-run-blurb']
-- cfg['sandbox-notice-testcases-run-link-display']
-- cfg['sandbox-notice-testcases-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit. $1 is a link to the test cases page.
-- cfg['sandbox-notice-testcases-link-display'] is the display value for that link.
-- cfg['sandbox-notice-testcases-run-blurb'] is a sentence notifying the user that there is a test cases page
-- corresponding to this sandbox that they can edit, along with a link to run it. $1 is a link to the test
-- cases page, and $2 is a link to the page to run it.
-- cfg['sandbox-notice-testcases-run-link-display'] is the display value for the link to run the test
-- cases.
--]]
cfg['sandbox-notice-testcases-blurb'] = 'See also the companion subpage for $1.'
cfg['sandbox-notice-testcases-link-display'] = 'test cases'
cfg['sandbox-notice-testcases-run-blurb'] = 'See also the companion subpage for $1 ($2).'
cfg['sandbox-notice-testcases-run-link-display'] = 'run'

-- cfg['sandbox-category'] - A category to add to all template sandboxes.
-- cfg['module-sandbox-category'] - A category to add to all module sandboxes.
-- cfg['module-sandbox-category'] - A category to add to all sandboxe not in templates or modules.
cfg['sandbox-category'] = 'Template sandboxes'
cfg['module-sandbox-category'] = 'Module sandboxes'
cfg['other-sandbox-category'] = 'Sandboxes outside of template or module namespace'


----------------------------------------------------------------------------------------------------
-- Start box configuration
----------------------------------------------------------------------------------------------------

-- cfg['documentation-icon-wikitext']
-- The wikitext for the icon shown at the top of the template.
cfg['documentation-icon-wikitext'] = '[[File:Test Template Info-Icon - Version (2).svg|50px|link=|alt=]]'

-- cfg['template-namespace-heading']
-- The heading shown in the template namespace.
cfg['template-namespace-heading'] = 'Template documentation'

-- cfg['module-namespace-heading']
-- The heading shown in the module namespace.
cfg['module-namespace-heading'] = 'Module documentation'

-- cfg['file-namespace-heading']
-- The heading shown in the file namespace.
cfg['file-namespace-heading'] = 'Summary'

-- cfg['other-namespaces-heading']
-- The heading shown in other namespaces.
cfg['other-namespaces-heading'] = 'Documentation'

-- cfg['view-link-display']
-- The text to display for "view" links.
cfg['view-link-display'] = 'view'

-- cfg['edit-link-display']
-- The text to display for "edit" links.
cfg['edit-link-display'] = 'edit'

-- cfg['history-link-display']
-- The text to display for "history" links.
cfg['history-link-display'] = 'history'

-- cfg['purge-link-display']
-- The text to display for "purge" links.
cfg['purge-link-display'] = 'purge'

-- cfg['create-link-display']
-- The text to display for "create" links.
cfg['create-link-display'] = 'create'

----------------------------------------------------------------------------------------------------
-- Link box (end box) configuration
----------------------------------------------------------------------------------------------------

-- cfg['transcluded-from-blurb']
-- Notice displayed when the docs are transcluded from another page. $1 is a wikilink to that page.
cfg['transcluded-from-blurb'] = 'The above [[Wikipedia:Template documentation|documentation]] is [[Help:Transclusion|transcluded]] from $1.'

--[[
-- cfg['create-module-doc-blurb']
-- Notice displayed in the module namespace when the documentation subpage does not exist.
-- $1 is a link to create the documentation page with the preload cfg['module-preload'] and the
-- display cfg['create-link-display'].
--]]
cfg['create-module-doc-blurb'] = 'You might want to $1 a documentation page for this [[Wikipedia:Lua|Scribunto module]].'

----------------------------------------------------------------------------------------------------
-- Experiment blurb configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['experiment-blurb-template']
-- cfg['experiment-blurb-module']
-- The experiment blurb is the text inviting editors to experiment in sandbox and test cases pages.
-- It is only shown in the template and module namespaces. With the default English settings, it
-- might look like this:
--
-- Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
--
-- In this example, "sandbox", "edit", "diff", "testcases", and "edit" would all be links.
--
-- There are two versions, cfg['experiment-blurb-template'] and cfg['experiment-blurb-module'], depending
-- on what namespace we are in.
-- 
-- Parameters:
--
-- $1 is a link to the sandbox page. If the sandbox exists, it is in the following format:
--
--     cfg['sandbox-link-display'] (cfg['sandbox-edit-link-display'] | cfg['compare-link-display'])
-- 
-- If the sandbox doesn't exist, it is in the format:
--
--     cfg['sandbox-link-display'] (cfg['sandbox-create-link-display'] | cfg['mirror-link-display'])
-- 
-- The link for cfg['sandbox-create-link-display'] link preloads the page with cfg['template-sandbox-preload']
-- or cfg['module-sandbox-preload'], depending on the current namespace. The link for cfg['mirror-link-display']
-- loads a default edit summary of cfg['mirror-edit-summary'].
--
-- $2 is a link to the test cases page. If the test cases page exists, it is in the following format:
--
--     cfg['testcases-link-display'] (cfg['testcases-edit-link-display'] | cfg['testcases-run-link-display'])
--
-- If the test cases page doesn't exist, it is in the format:
-- 
--     cfg['testcases-link-display'] (cfg['testcases-create-link-display'])
--
-- If the test cases page doesn't exist, the link for cfg['testcases-create-link-display'] preloads the
-- page with cfg['template-testcases-preload'] or cfg['module-testcases-preload'], depending on the current
-- namespace.
--]]
cfg['experiment-blurb-template'] = "Editors can experiment in this template's $1 and $2 pages."
cfg['experiment-blurb-module'] = "Editors can experiment in this module's $1 and $2 pages."

----------------------------------------------------------------------------------------------------
-- Sandbox link configuration
----------------------------------------------------------------------------------------------------

-- cfg['sandbox-subpage']
-- The name of the template subpage typically used for sandboxes.
cfg['sandbox-subpage'] = 'sandbox'

-- cfg['template-sandbox-preload']
-- Preload file for template sandbox pages.
cfg['template-sandbox-preload'] = 'Template:Documentation/preload-sandbox'

-- cfg['module-sandbox-preload']
-- Preload file for Lua module sandbox pages.
cfg['module-sandbox-preload'] = 'Template:Documentation/preload-module-sandbox'

-- cfg['sandbox-link-display']
-- The text to display for "sandbox" links.
cfg['sandbox-link-display'] = 'sandbox'

-- cfg['sandbox-edit-link-display']
-- The text to display for sandbox "edit" links.
cfg['sandbox-edit-link-display'] = 'edit'

-- cfg['sandbox-create-link-display']
-- The text to display for sandbox "create" links.
cfg['sandbox-create-link-display'] = 'create'

-- cfg['compare-link-display']
-- The text to display for "compare" links.
cfg['compare-link-display'] = 'diff'

-- cfg['mirror-edit-summary']
-- The default edit summary to use when a user clicks the "mirror" link. $1 is a wikilink to the
-- template page.
cfg['mirror-edit-summary'] = 'Create sandbox version of $1'

-- cfg['mirror-link-display']
-- The text to display for "mirror" links.
cfg['mirror-link-display'] = 'mirror'

-- cfg['mirror-link-preload']
-- The page to preload when a user clicks the "mirror" link.
cfg['mirror-link-preload'] = 'Template:Documentation/mirror'

----------------------------------------------------------------------------------------------------
-- Test cases link configuration
----------------------------------------------------------------------------------------------------

-- cfg['testcases-subpage']
-- The name of the template subpage typically used for test cases.
cfg['testcases-subpage'] = 'testcases'

-- cfg['template-testcases-preload']
-- Preload file for template test cases pages.
cfg['template-testcases-preload'] = 'Template:Documentation/preload-testcases'

-- cfg['module-testcases-preload']
-- Preload file for Lua module test cases pages.
cfg['module-testcases-preload'] = 'Template:Documentation/preload-module-testcases'

-- cfg['testcases-link-display']
-- The text to display for "testcases" links.
cfg['testcases-link-display'] = 'testcases'

-- cfg['testcases-edit-link-display']
-- The text to display for test cases "edit" links.
cfg['testcases-edit-link-display'] = 'edit'

-- cfg['testcases-run-link-display']
-- The text to display for test cases "run" links.
cfg['testcases-run-link-display'] = 'run'

-- cfg['testcases-create-link-display']
-- The text to display for test cases "create" links.
cfg['testcases-create-link-display'] = 'create'

----------------------------------------------------------------------------------------------------
-- Add categories blurb configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['add-categories-blurb']
-- Text to direct users to add categories to the /doc subpage. Not used if the "content" or
-- "docname fed" arguments are set, as then it is not clear where to add the categories. $1 is a
-- link to the /doc subpage with a display value of cfg['doc-link-display'].
--]]
cfg['add-categories-blurb'] = 'Add categories to the $1 subpage.'

-- cfg['doc-link-display']
-- The text to display when linking to the /doc subpage.
cfg['doc-link-display'] = '/doc'

----------------------------------------------------------------------------------------------------
-- Subpages link configuration
----------------------------------------------------------------------------------------------------

--[[
-- cfg['subpages-blurb']
-- The "Subpages of this template" blurb. $1 is a link to the main template's subpages with a
-- display value of cfg['subpages-link-display']. In the English version this blurb is simply
-- the link followed by a period, and the link display provides the actual text.
--]]
cfg['subpages-blurb'] = '$1.'

--[[
-- cfg['subpages-link-display']
-- The text to display for the "subpages of this page" link. $1 is cfg['template-pagetype'],
-- cfg['module-pagetype'] or cfg['default-pagetype'], depending on whether the current page is in
-- the template namespace, the module namespace, or another namespace.
--]]
cfg['subpages-link-display'] = 'Subpages of this $1'

-- cfg['template-pagetype']
-- The pagetype to display for template pages.
cfg['template-pagetype'] = 'template'

-- cfg['module-pagetype']
-- The pagetype to display for Lua module pages.
cfg['module-pagetype'] = 'module'

-- cfg['default-pagetype']
-- The pagetype to display for pages other than templates or Lua modules.
cfg['default-pagetype'] = 'page'

----------------------------------------------------------------------------------------------------
-- Doc link configuration
----------------------------------------------------------------------------------------------------

-- cfg['doc-subpage']
-- The name of the subpage typically used for documentation pages.
cfg['doc-subpage'] = 'doc'

-- cfg['docpage-preload']
-- Preload file for template documentation pages in all namespaces.
cfg['docpage-preload'] = 'Template:Documentation/preload'

-- cfg['module-preload']
-- Preload file for Lua module documentation pages.
cfg['module-preload'] = 'Template:Documentation/preload-module-doc'

----------------------------------------------------------------------------------------------------
-- HTML and CSS configuration
----------------------------------------------------------------------------------------------------

-- cfg['templatestyles']
-- The name of the TemplateStyles page where CSS is kept.
-- Sandbox CSS will be at Module:Documentation/sandbox/styles.css when needed.
cfg['templatestyles'] = 'Module:Documentation/styles.css'

-- cfg['container']
-- Class which can be used to set flex or grid CSS on the
-- two child divs documentation and documentation-metadata
cfg['container'] = 'documentation-container'

-- cfg['main-div-classes']
-- Classes added to the main HTML "div" tag.
cfg['main-div-classes'] = 'documentation'

-- cfg['main-div-heading-class']
-- Class for the main heading for templates and modules and assoc. talk spaces
cfg['main-div-heading-class'] = 'documentation-heading'

-- cfg['start-box-class']
-- Class for the start box
cfg['start-box-class'] = 'documentation-startbox'

-- cfg['start-box-link-classes']
-- Classes used for the [view][edit][history] or [create] links in the start box.
-- mw-editsection-like is per [[Wikipedia:Village pump (technical)/Archive 117]]
cfg['start-box-link-classes'] = 'mw-editsection-like plainlinks'

-- cfg['end-box-class']
-- Class for the end box.
cfg['end-box-class'] = 'documentation-metadata'

-- cfg['end-box-plainlinks']
-- Plainlinks
cfg['end-box-plainlinks'] = 'plainlinks'

-- cfg['toolbar-class']
-- Class added for toolbar links.
cfg['toolbar-class'] = 'documentation-toolbar'

-- cfg['clear']
-- Just used to clear things.
cfg['clear'] = 'documentation-clear'


----------------------------------------------------------------------------------------------------
-- Tracking category configuration
----------------------------------------------------------------------------------------------------

-- cfg['display-strange-usage-category']
-- Set to true to enable output of cfg['strange-usage-category'] if the module is used on a /doc subpage
-- or a /testcases subpage. This should be a boolean value (either true or false).
cfg['display-strange-usage-category'] = true

-- cfg['strange-usage-category']
-- Category to output if cfg['display-strange-usage-category'] is set to true and the module is used on a
-- /doc subpage or a /testcases subpage.
cfg['strange-usage-category'] = 'Wikipedia pages with strange ((documentation)) usage'

--[[
----------------------------------------------------------------------------------------------------
-- End configuration
--
-- Don't edit anything below this line.
----------------------------------------------------------------------------------------------------
--]]

return cfg
Retrieved from "https://tep.wiki/wiki/Module:Documentation/config?oldid=73271"