Module:Documentation/config

From Viki
Jump to navigation Jump to search

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

  1 ----------------------------------------------------------------------------------------------------
  2 --
  3 --                               Configuration for Module:Documentation
  4 --
  5 -- Here you can set the values of the parameters and messages used in Module:Documentation to
  6 -- localise it to your wiki and your language. Unless specified otherwise, values given here
  7 -- should be string values.
  8 ----------------------------------------------------------------------------------------------------
  9 
 10 local cfg = {} -- Do not edit this line.
 11 
 12 ----------------------------------------------------------------------------------------------------
 13 -- Protection template configuration
 14 ----------------------------------------------------------------------------------------------------
 15 
 16 -- cfg['protection-reason-edit']
 17 -- The protection reason for edit-protected templates to pass to
 18 -- [[Module:Protection banner]].
 19 cfg['protection-reason-edit'] = 'template'
 20 
 21 --[[
 22 ----------------------------------------------------------------------------------------------------
 23 -- Sandbox notice configuration
 24 --
 25 -- On sandbox pages the module can display a template notifying users that the current page is a
 26 -- sandbox, and the location of test cases pages, etc. The module decides whether the page is a
 27 -- sandbox or not based on the value of cfg['sandbox-subpage']. The following settings configure the
 28 -- messages that the notices contains.
 29 ----------------------------------------------------------------------------------------------------
 30 --]]
 31 
 32 -- cfg['sandbox-notice-image']
 33 -- The image displayed in the sandbox notice.
 34 cfg['sandbox-notice-image'] = '[[File:Sandbox.svg|50px|alt=|link=]]'
 35 
 36 --[[
 37 -- cfg['sandbox-notice-pagetype-template']
 38 -- cfg['sandbox-notice-pagetype-module']
 39 -- cfg['sandbox-notice-pagetype-other']
 40 -- The page type of the sandbox page. The message that is displayed depends on the current subject
 41 -- namespace. This message is used in either cfg['sandbox-notice-blurb'] or
 42 -- cfg['sandbox-notice-diff-blurb'].
 43 --]]
 44 cfg['sandbox-notice-pagetype-template'] = '[[Wikipedia:Template test cases|template sandbox]] page'
 45 cfg['sandbox-notice-pagetype-module'] = '[[Wikipedia:Template test cases|module sandbox]] page'
 46 cfg['sandbox-notice-pagetype-other'] = 'sandbox page'
 47 
 48 --[[
 49 -- cfg['sandbox-notice-blurb']
 50 -- cfg['sandbox-notice-diff-blurb']
 51 -- cfg['sandbox-notice-diff-display']
 52 -- Either cfg['sandbox-notice-blurb'] or cfg['sandbox-notice-diff-blurb'] is the opening sentence
 53 -- of the sandbox notice. The latter has a diff link, but the former does not. $1 is the page
 54 -- type, which is either cfg['sandbox-notice-pagetype-template'],
 55 -- cfg['sandbox-notice-pagetype-module'] or cfg['sandbox-notice-pagetype-other'] depending what
 56 -- namespace we are in. $2 is a link to the main template page, and $3 is a diff link between
 57 -- the sandbox and the main template. The display value of the diff link is set by 
 58 -- cfg['sandbox-notice-compare-link-display'].
 59 --]]
 60 cfg['sandbox-notice-blurb'] = 'This is the $1 for $2.'
 61 cfg['sandbox-notice-diff-blurb'] = 'This is the $1 for $2 ($3).'
 62 cfg['sandbox-notice-compare-link-display'] = 'diff'
 63 
 64 --[[
 65 -- cfg['sandbox-notice-testcases-blurb']
 66 -- cfg['sandbox-notice-testcases-link-display']
 67 -- cfg['sandbox-notice-testcases-run-blurb']
 68 -- cfg['sandbox-notice-testcases-run-link-display']
 69 -- cfg['sandbox-notice-testcases-blurb'] is a sentence notifying the user that there is a test cases page
 70 -- corresponding to this sandbox that they can edit. $1 is a link to the test cases page.
 71 -- cfg['sandbox-notice-testcases-link-display'] is the display value for that link.
 72 -- cfg['sandbox-notice-testcases-run-blurb'] is a sentence notifying the user that there is a test cases page
 73 -- corresponding to this sandbox that they can edit, along with a link to run it. $1 is a link to the test
 74 -- cases page, and $2 is a link to the page to run it.
 75 -- cfg['sandbox-notice-testcases-run-link-display'] is the display value for the link to run the test
 76 -- cases.
 77 --]]
 78 cfg['sandbox-notice-testcases-blurb'] = 'See also the companion subpage for $1.'
 79 cfg['sandbox-notice-testcases-link-display'] = 'test cases'
 80 cfg['sandbox-notice-testcases-run-blurb'] = 'See also the companion subpage for $1 ($2).'
 81 cfg['sandbox-notice-testcases-run-link-display'] = 'run'
 82 
 83 -- cfg['sandbox-category']
 84 -- A category to add to all template sandboxes.
 85 cfg['sandbox-category'] = 'Template sandboxes'
 86 
 87 ----------------------------------------------------------------------------------------------------
 88 -- Start box configuration
 89 ----------------------------------------------------------------------------------------------------
 90 
 91 -- cfg['documentation-icon-wikitext']
 92 -- The wikitext for the icon shown at the top of the template.
 93 cfg['documentation-icon-wikitext'] = '[[File:Test Template Info-Icon - Version (2).svg|50px|link=|alt=]]'
 94 
 95 -- cfg['template-namespace-heading']
 96 -- The heading shown in the template namespace.
 97 cfg['template-namespace-heading'] = 'Template documentation'
 98 
 99 -- cfg['module-namespace-heading']
100 -- The heading shown in the module namespace.
101 cfg['module-namespace-heading'] = 'Module documentation'
102 
103 -- cfg['file-namespace-heading']
104 -- The heading shown in the file namespace.
105 cfg['file-namespace-heading'] = 'Summary'
106 
107 -- cfg['other-namespaces-heading']
108 -- The heading shown in other namespaces.
109 cfg['other-namespaces-heading'] = 'Documentation'
110 
111 -- cfg['view-link-display']
112 -- The text to display for "view" links.
113 cfg['view-link-display'] = 'view'
114 
115 -- cfg['edit-link-display']
116 -- The text to display for "edit" links.
117 cfg['edit-link-display'] = 'edit'
118 
119 -- cfg['history-link-display']
120 -- The text to display for "history" links.
121 cfg['history-link-display'] = 'history'
122 
123 -- cfg['purge-link-display']
124 -- The text to display for "purge" links.
125 cfg['purge-link-display'] = 'purge'
126 
127 -- cfg['create-link-display']
128 -- The text to display for "create" links.
129 cfg['create-link-display'] = 'create'
130 
131 ----------------------------------------------------------------------------------------------------
132 -- Link box (end box) configuration
133 ----------------------------------------------------------------------------------------------------
134 
135 -- cfg['transcluded-from-blurb']
136 -- Notice displayed when the docs are transcluded from another page. $1 is a wikilink to that page.
137 cfg['transcluded-from-blurb'] = 'The above [[Wikipedia:Template documentation|documentation]] is [[Help:Transclusion|transcluded]] from $1.'
138 
139 --[[
140 -- cfg['create-module-doc-blurb']
141 -- Notice displayed in the module namespace when the documentation subpage does not exist.
142 -- $1 is a link to create the documentation page with the preload cfg['module-preload'] and the
143 -- display cfg['create-link-display'].
144 --]]
145 cfg['create-module-doc-blurb'] = 'You might want to $1 a documentation page for this [[Wikipedia:Lua|Scribunto module]].'
146 
147 ----------------------------------------------------------------------------------------------------
148 -- Experiment blurb configuration
149 ----------------------------------------------------------------------------------------------------
150 
151 --[[
152 -- cfg['experiment-blurb-template']
153 -- cfg['experiment-blurb-module']
154 -- The experiment blurb is the text inviting editors to experiment in sandbox and test cases pages.
155 -- It is only shown in the template and module namespaces. With the default English settings, it
156 -- might look like this:
157 --
158 -- Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
159 --
160 -- In this example, "sandbox", "edit", "diff", "testcases", and "edit" would all be links.
161 --
162 -- There are two versions, cfg['experiment-blurb-template'] and cfg['experiment-blurb-module'], depending
163 -- on what namespace we are in.
164 -- 
165 -- Parameters:
166 --
167 -- $1 is a link to the sandbox page. If the sandbox exists, it is in the following format:
168 --
169 --     cfg['sandbox-link-display'] (cfg['sandbox-edit-link-display'] | cfg['compare-link-display'])
170 -- 
171 -- If the sandbox doesn't exist, it is in the format:
172 --
173 --     cfg['sandbox-link-display'] (cfg['sandbox-create-link-display'] | cfg['mirror-link-display'])
174 -- 
175 -- The link for cfg['sandbox-create-link-display'] link preloads the page with cfg['template-sandbox-preload']
176 -- or cfg['module-sandbox-preload'], depending on the current namespace. The link for cfg['mirror-link-display']
177 -- loads a default edit summary of cfg['mirror-edit-summary'].
178 --
179 -- $2 is a link to the test cases page. If the test cases page exists, it is in the following format:
180 --
181 --     cfg['testcases-link-display'] (cfg['testcases-edit-link-display'] | cfg['testcases-run-link-display'])
182 --
183 -- If the test cases page doesn't exist, it is in the format:
184 -- 
185 --     cfg['testcases-link-display'] (cfg['testcases-create-link-display'])
186 --
187 -- If the test cases page doesn't exist, the link for cfg['testcases-create-link-display'] preloads the
188 -- page with cfg['template-testcases-preload'] or cfg['module-testcases-preload'], depending on the current
189 -- namespace.
190 --]]
191 cfg['experiment-blurb-template'] = "Editors can experiment in this template's $1 and $2 pages."
192 cfg['experiment-blurb-module'] = "Editors can experiment in this module's $1 and $2 pages."
193 
194 ----------------------------------------------------------------------------------------------------
195 -- Sandbox link configuration
196 ----------------------------------------------------------------------------------------------------
197 
198 -- cfg['sandbox-subpage']
199 -- The name of the template subpage typically used for sandboxes.
200 cfg['sandbox-subpage'] = 'sandbox'
201 
202 -- cfg['template-sandbox-preload']
203 -- Preload file for template sandbox pages.
204 cfg['template-sandbox-preload'] = 'Template:Documentation/preload-sandbox'
205 
206 -- cfg['module-sandbox-preload']
207 -- Preload file for Lua module sandbox pages.
208 cfg['module-sandbox-preload'] = 'Template:Documentation/preload-module-sandbox'
209 
210 -- cfg['sandbox-link-display']
211 -- The text to display for "sandbox" links.
212 cfg['sandbox-link-display'] = 'sandbox'
213 
214 -- cfg['sandbox-edit-link-display']
215 -- The text to display for sandbox "edit" links.
216 cfg['sandbox-edit-link-display'] = 'edit'
217 
218 -- cfg['sandbox-create-link-display']
219 -- The text to display for sandbox "create" links.
220 cfg['sandbox-create-link-display'] = 'create'
221 
222 -- cfg['compare-link-display']
223 -- The text to display for "compare" links.
224 cfg['compare-link-display'] = 'diff'
225 
226 -- cfg['mirror-edit-summary']
227 -- The default edit summary to use when a user clicks the "mirror" link. $1 is a wikilink to the
228 -- template page.
229 cfg['mirror-edit-summary'] = 'Create sandbox version of $1'
230 
231 -- cfg['mirror-link-display']
232 -- The text to display for "mirror" links.
233 cfg['mirror-link-display'] = 'mirror'
234 
235 -- cfg['mirror-link-preload']
236 -- The page to preload when a user clicks the "mirror" link.
237 cfg['mirror-link-preload'] = 'Template:Documentation/mirror'
238 
239 ----------------------------------------------------------------------------------------------------
240 -- Test cases link configuration
241 ----------------------------------------------------------------------------------------------------
242 
243 -- cfg['testcases-subpage']
244 -- The name of the template subpage typically used for test cases.
245 cfg['testcases-subpage'] = 'testcases'
246 
247 -- cfg['template-testcases-preload']
248 -- Preload file for template test cases pages.
249 cfg['template-testcases-preload'] = 'Template:Documentation/preload-testcases'
250 
251 -- cfg['module-testcases-preload']
252 -- Preload file for Lua module test cases pages.
253 cfg['module-testcases-preload'] = 'Template:Documentation/preload-module-testcases'
254 
255 -- cfg['testcases-link-display']
256 -- The text to display for "testcases" links.
257 cfg['testcases-link-display'] = 'testcases'
258 
259 -- cfg['testcases-edit-link-display']
260 -- The text to display for test cases "edit" links.
261 cfg['testcases-edit-link-display'] = 'edit'
262 
263 -- cfg['testcases-run-link-display']
264 -- The text to display for test cases "run" links.
265 cfg['testcases-run-link-display'] = 'run'
266 
267 -- cfg['testcases-create-link-display']
268 -- The text to display for test cases "create" links.
269 cfg['testcases-create-link-display'] = 'create'
270 
271 ----------------------------------------------------------------------------------------------------
272 -- Add categories blurb configuration
273 ----------------------------------------------------------------------------------------------------
274 
275 --[[
276 -- cfg['add-categories-blurb']
277 -- Text to direct users to add categories to the /doc subpage. Not used if the "content" or
278 -- "docname fed" arguments are set, as then it is not clear where to add the categories. $1 is a
279 -- link to the /doc subpage with a display value of cfg['doc-link-display'].
280 --]]
281 cfg['add-categories-blurb'] = 'Add categories to the $1 subpage.'
282 
283 -- cfg['doc-link-display']
284 -- The text to display when linking to the /doc subpage.
285 cfg['doc-link-display'] = '/doc'
286 
287 ----------------------------------------------------------------------------------------------------
288 -- Subpages link configuration
289 ----------------------------------------------------------------------------------------------------
290 
291 --[[
292 -- cfg['subpages-blurb']
293 -- The "Subpages of this template" blurb. $1 is a link to the main template's subpages with a
294 -- display value of cfg['subpages-link-display']. In the English version this blurb is simply
295 -- the link followed by a period, and the link display provides the actual text.
296 --]]
297 cfg['subpages-blurb'] = '$1.'
298 
299 --[[
300 -- cfg['subpages-link-display']
301 -- The text to display for the "subpages of this page" link. $1 is cfg['template-pagetype'],
302 -- cfg['module-pagetype'] or cfg['default-pagetype'], depending on whether the current page is in
303 -- the template namespace, the module namespace, or another namespace.
304 --]]
305 cfg['subpages-link-display'] = 'Subpages of this $1'
306 
307 -- cfg['template-pagetype']
308 -- The pagetype to display for template pages.
309 cfg['template-pagetype'] = 'template'
310 
311 -- cfg['module-pagetype']
312 -- The pagetype to display for Lua module pages.
313 cfg['module-pagetype'] = 'module'
314 
315 -- cfg['default-pagetype']
316 -- The pagetype to display for pages other than templates or Lua modules.
317 cfg['default-pagetype'] = 'page'
318 
319 ----------------------------------------------------------------------------------------------------
320 -- Doc link configuration
321 ----------------------------------------------------------------------------------------------------
322 
323 -- cfg['doc-subpage']
324 -- The name of the subpage typically used for documentation pages.
325 cfg['doc-subpage'] = 'doc'
326 
327 -- cfg['docpage-preload']
328 -- Preload file for template documentation pages in all namespaces.
329 cfg['docpage-preload'] = 'Template:Documentation/preload'
330 
331 -- cfg['module-preload']
332 -- Preload file for Lua module documentation pages.
333 cfg['module-preload'] = 'Template:Documentation/preload-module-doc'
334 
335 ----------------------------------------------------------------------------------------------------
336 -- HTML and CSS configuration
337 ----------------------------------------------------------------------------------------------------
338 
339 -- cfg['templatestyles']
340 -- The name of the TemplateStyles page where CSS is kept.
341 -- Sandbox CSS will be at Module:Documentation/sandbox/styles.css when needed.
342 cfg['templatestyles'] = 'Module:Documentation/styles.css'
343 
344 -- cfg['container']
345 -- Class which can be used to set flex or grid CSS on the
346 -- two child divs documentation and documentation-metadata
347 cfg['container'] = 'documentation-container'
348 
349 -- cfg['main-div-classes']
350 -- Classes added to the main HTML "div" tag.
351 cfg['main-div-classes'] = 'documentation'
352 
353 -- cfg['main-div-heading-class']
354 -- Class for the main heading for templates and modules and assoc. talk spaces
355 cfg['main-div-heading-class'] = 'documentation-heading'
356 
357 -- cfg['start-box-class']
358 -- Class for the start box
359 cfg['start-box-class'] = 'documentation-startbox'
360 
361 -- cfg['start-box-link-classes']
362 -- Classes used for the [view][edit][history] or [create] links in the start box.
363 -- mw-editsection-like is per [[Wikipedia:Village pump (technical)/Archive 117]]
364 cfg['start-box-link-classes'] = 'mw-editsection-like plainlinks'
365 
366 -- cfg['end-box-class']
367 -- Class for the end box.
368 cfg['end-box-class'] = 'documentation-metadata'
369 
370 -- cfg['end-box-plainlinks']
371 -- Plainlinks
372 cfg['end-box-plainlinks'] = 'plainlinks'
373 
374 -- cfg['toolbar-class']
375 -- Class added for toolbar links.
376 cfg['toolbar-class'] = 'documentation-toolbar'
377 
378 -- cfg['clear']
379 -- Just used to clear things.
380 cfg['clear'] = 'documentation-clear'
381 
382 
383 ----------------------------------------------------------------------------------------------------
384 -- Tracking category configuration
385 ----------------------------------------------------------------------------------------------------
386 
387 -- cfg['display-strange-usage-category']
388 -- Set to true to enable output of cfg['strange-usage-category'] if the module is used on a /doc subpage
389 -- or a /testcases subpage. This should be a boolean value (either true or false).
390 cfg['display-strange-usage-category'] = true
391 
392 -- cfg['strange-usage-category']
393 -- Category to output if cfg['display-strange-usage-category'] is set to true and the module is used on a
394 -- /doc subpage or a /testcases subpage.
395 cfg['strange-usage-category'] = 'Wikipedia pages with strange ((documentation)) usage'
396 
397 --[[
398 ----------------------------------------------------------------------------------------------------
399 -- End configuration
400 --
401 -- Don't edit anything below this line.
402 ----------------------------------------------------------------------------------------------------
403 --]]
404 
405 return cfg