OODA WIKI - User contributions [en]

OODA loop

2025-08-15T06:43:25Z

Converti: Manual edit: Converted passive voice to active with the Scribal Assistant.

{{short description|Observe–orient–decide–act cycle}}
{{redirect|Ooda|the Japanese city|Ōda, Shimane}}
{{Use dmy dates|date=August 2021}}

The '''OODA loop''' (observe, orient, decide, act) is a decision-making model developed by [[United States Air Force]] Colonel [[John Boyd (military strategist)|John Boyd]]. He applied the concept to the [[combat operations process]], often at the operational level during military campaigns. Analysts often apply the model to understand commercial operations and learning processes. The approach explains how agility can overcome raw power in dealing with human opponents.

==The OODA loop==
As can be seen from the diagram, the OODA loop includes continuous collection of feedback and observations. This enables late commitment, which is an important element of agility. This is in contrast to the [[PDCA]] (plan–do–check–act) cycle which requires early commitment.

==Use in law and business==
The OODA loop has become an important concept in [[litigation strategy|litigation]],{{sfn|Dreier|2012|pp=20–85}} business,{{sfn|Richards|2004|pp=162–171}} [[law enforcement]],<ref>{{cite web |last1=Papenfuhs |first1=Steve (Pappy) |title=The OODA loop, reaction time, and decision making |date=15 February 2012 |url=https://www.police1.com/use-of-force/articles/the-ooda-loop-reaction-time-and-decision-making-fEOcXtsXFutU07cY/ |publisher=PoliceOne.com |archive-url=https://web.archive.org/web/20210125183753/https://www.police1.com/use-of-force/articles/the-ooda-loop-reaction-time-and-decision-making-fEOcXtsXFutU07cY/ |access-date=3 November 2016 |archive-date=25 January 2021 }}</ref> management education,<ref>{{cite journal |last1=Ryder |first1=Mike |last2=Downs |first2=Carolyn |title=Rethinking reflective practice: John Boyd's OODA loop as an alternative to Kolb |journal=The International Journal of Management Education |date=November 2022 |volume=20 |issue=3 |page=100703 |doi=10.1016/j.ijme.2022.100703 |doi-access=free }}</ref><ref>{{cite book |last1=Ryder |first1=Mike |editor1-last=Wall |editor1-first=Tony |editor2-last=Trevisan |editor2-first=Laís Viera |editor3-last=Filho |editor3-first=Walter Leal |editor4-last=Shore |editor4-first=Adam |title=Sustainability in Business Education, Research and Practices |date=2024 |publisher=Springer |isbn=978-3-031-55995-2 |pages=77–89 |chapter-url=https://link.springer.com/chapter/10.1007/978-3-031-55996-9_6 |chapter=Using OODA Loops to Build Sustainable Practice into Business Education|series=World Sustainability Series |doi=10.1007/978-3-031-55996-9_6 }}</ref> [[military strategy]] and [[Computer security|cyber security]], and [[cyberwarfare]].<ref>{{Cite book|title=The Fifth Domain: Defending Our Country, Our Companies, and Ourselves in the Age of Cyber Threats|last=Clarke|first=Richard|publisher=Penguin Press|year=2019|isbn=978-0525561965|pages=81}}</ref> According to Boyd, [[decision-making]] occurs in an iterative cycle of "observe, orient, decide, act". An entity (whether an individual or an organization) that can process this cycle quickly, observing and reacting to unfolding events more rapidly and/or more effectively than an opponent, can thereby get inside the opponent's decision cycle and gain the advantage.

[[Jamie Dimon]], chairman and CEO of [[JPMorgan Chase]], has said he uses the OODA loop in scenario evaluation.<ref>{{Cite web|url=https://fortune.com/2024/04/09/jamie-dimon-jpmorgan-military-leadership-tactic-ooda-loop/|title=Jamie Dimon says he runs JPMorgan with a military tactic in mind named the 'OODA loop'|first=Eleanor|last=Pringle|website=Fortune|date=4 April 2024}}</ref><ref>{{Cite web|url=https://fortune.com/2024/10/29/jamie-dimon-world-war-three-fears-nuclear-proliferation/|title=Jamie Dimon says World War III may have already begun|first=Eleanor|last=Pringle|website=Fortune|date=29 October 2024}}</ref><ref>{{Cite web|url=https://www.jpmorganchase.com/ir/annual-report/2023/ar-ceo-letters#management-lessons|title=Jamie Dimon's Letter to Shareholders, Annual Report 2023 | JPMorganChase|website=www.jpmorganchase.com}}</ref>

==Criticism==
Some scholars are critical of the concept. Aviation historian Michael Hankins, for example, writes that "the OODA loop is vague enough that its defenders and attackers can each see what they want to see in it. For some, the OODA concept's flexibility is its strength, but for others it becomes so generalized as to lose its usefulness." He concludes that "The OODA loop is merely one way among a myriad of ways of describing intuitive processes of learning and decision making that most people experience daily. It is not incorrect, but neither is it unique or especially profound."<ref>{{cite book |first=Michael W. |last=Hankins |title=Flying Camelot: The F-15, the F-16, and the Weaponization of Fighter Pilot Nostalgia |series=Battlegrounds: Cornell Studies in Military History |location=Ithaca, NY |publisher=Cornell University Press |date=2021 |pages=134–135 |isbn=9781501760655 |oclc=1245345653}}</ref>

==See also==
{{div col|colwidth=30em}}
* [[Decision cycle]]
* [[Double-loop learning]]
* [[Feedback loop]]
* Improvement cycle
** [[DMAIC]]
** [[PDCA]]
* [[Learning cycle]]
* [[Maneuver warfare]]
* [[Mental model]]
* [[Nursing process]]
* [[Problem solving]]
* [[Situation awareness]]
* [[SWOT analysis]]
* [[United States Army Strategist]]
{{div col end}}

==References==
{{reflist}}

===Bibliography===
* {{cite journal |last=Bazin |first=Aaron A. |date=January–February 2005 |title=Boyd's O-O-D-A loop and the infantry company commander |journal=[[Infantry (magazine)|Infantry]] |volume=94 |issue=1 |pages=17–19 |id={{ProQuest|219733932}} |url=https://d-n-i.net/fcs/pdf/bazin_ooda.pdf}}
* {{cite book |last = Boyd |first = John R. |url = https://upload.wikimedia.org/wikipedia/commons/a/a6/Destruction_%26_Creation.pdf |title = Destruction and Creation |publisher = U.S. Army Command and General Staff College |date = 3 September 1976}}
* {{cite web |last=Boyd |first=John, R. |date=28 June 1995 |title=The Essence of Winning and Losing |url=https://danford.net/boyd/essence.htm |website=danford.net}} A supposed five-slide set by Boyd.
* {{cite book |last=Dreier |first=A. S. |title=Strategy, Planning & Litigating to Win: Orchestrating Trial Outcomes with Systems Theory, Psychology, Military Science, and Utility Theory |date=2012 |location=Boston, MA |publisher=Conatus Press |isbn=978-0615676951 |oclc=917563752}}
* {{cite web |last=Greene |first=Robert |author-link=Robert Greene (American author) |date=24 February 2007 |title=OODA and You |url=https://powerseductionandwar.com/ooda-and-you/ |website=powerseductionandwar.com}}
* {{cite magazine |last=Hillaker |first=Harry |author-link=Harry Hillaker |date=July 1997 |title=Tribute To John R. Boyd |magazine=Code One Magazine |url=https://www.codeonemagazine.com/article.html?item_id=156 |archive-url=https://web.archive.org/web/20070917232626/http://www.codeonemagazine.com/archives/1997/articles/jul_97/july2a_97.html |archive-date=2007-09-17 |url-status=live}}
* {{cite book |last=Osinga |first=Frans P. B. |date=2007 |orig-year=2005 |title=Science, strategy and war: the strategic theory of John Boyd |series=Strategy and history |volume=18 |location=London |publisher=Routledge |isbn=978-0415371032 |oclc=67773991 |doi=10.4324/9780203088869}} [http://www.projectwhitehorse.com/pdfs/ScienceStrategyWar_Osinga.pdf PDF of the dissertation version].
* {{cite book |last1=Owen |first1=Jillian |last2=Burstein |first2=Frada |last3=Hall |first3=William P. |date=2004 |chapter=Knowledge reuse in project management |editor1-last=Linger |editor1-first=Henry |editor2-last=Fisher |editor2-first=Julie |editor3-last=Wojtkowski |editor3-first=Wita |editor4-last=Wojtkowski |editor4-first=W. Gregory |editor5-last=Zupančič |editor5-first=Jože |editor6-last=Vigo |editor6-first=Kitty |editor7-last=Arnold |editor7-first=Josie |title=Constructing the Infrastructure for the Knowledge Economy: Methods and Tools, Theory and Structure |location=New York |publisher=Kluwer Academic/Plenum Publishers |pages=443–454 |isbn=0306485540 |oclc=55877281 |doi=10.1007/978-1-4757-4852-9_33}}
* {{cite book |last=Richards |first=Chet |date=2004 |title=Certain to Win: The Strategy of John Boyd, Applied to Business |location=Philadelphia |publisher=[[Xlibris]] |isbn=1413453775 |oclc=57207751}}
* {{cite web |last=Schuck |first=Tod |date=11 May 2017 |title=OODA Loop 2.0: Information, Not Agility, Is Life |url=https://breakingdefense.com/2017/05/ooda-loop-2-0-information-not-agility-is-life/ |website=Breaking Defense}}
* {{cite journal |last=Ullman |first=David G. |date=April 2007 |title='OO-OO-OO!': the sound of a broken OODA loop |journal=CrossTalk: The Journal of Defense Software Engineering |volume=20 |issue=4 |pages=22–25 |citeseerx=10.1.1.170.5341 |url=http://crosstalkonline.org/storage/issue-archives/2007/200704/200704-Ullman.pdf |archive-url=https://web.archive.org/web/20120728010539/http://crosstalkonline.org/storage/issue-archives/2007/200704/200704-Ullman.pdf |archive-date=2012-07-28}}

== External links ==
* [https://danford.net/boyd/ The John Boyd Library] (archived documents by Boyd)

{{DEFAULTSORT:Ooda Loop}}
[[Category:Feedback]]
[[Category:Intelligence analysis]]
[[Category:Strategy]]
[[Category:Systems analysis]]
[[Category:United States Air Force]]

Converti (AetherOS)

2025-08-15T06:37:29Z

Converti:

{{AetherOS_Component}}
'''Converti''' is a command-line utility suite designed to manage the lifecycle of templates and modules within the AetherOS ecosystem. It serves as the primary toolkit for the [[Collegium (AetherOS)]], enabling the analysis, controlled importation, and quality assurance of the wiki's structural components.

The tool was developed by [[User:Isidore Lands|Isidore Lands]] and [[User:Silas Corvus|Silas Corvus]].

== Purpose in Symbiotic Learning ==
The core purpose of Converti is to ensure the structural integrity and maneuverability of the wiki's knowledge base. A lean, well-documented, and minimally dependent codebase is essential for the symbiotic learning between users and their [[Wingman AI|Wingman AIs]].

By providing tools to analyze and gracefully import components, Converti prevents "dependency hell" and ensures the wiki does not become cluttered with the unmanaged complexity of its source wikis.

== The Converti Toolkit ==
Converti is comprised of a single command-line interface (main.py) that provides several commands, each serving a specific function in the Collegium's review process.

=== Stage 1: Map Dependencies ===
The first step is to map the full dependency tree of a set of root templates from a source wiki (like Wikipedia) to a named JSON file.

'''map command''': Scans a list of templates on a specified source wiki (--source-family) and recursively maps every sub-template and Lua module they depend on. The result is saved to a specified output file (--output).

=== Stage 2: Audit & Analyze ===
The second step is to analyze the generated dependency map to assess its technical debt.

'''audit command''': Ingests a dependency map (--map-file) and generates a human-readable report (dependency_report.txt) and an interactive graph (dependency_graph.html). This command calculates a '''[[Wiki Maneuverability Score]]''' for each component based on its complexity, dependency count, and documentation quality, highlighting the most foundational and complex pages.

=== Stage 3: Deploy to Wiki ===
After the Collegium has reviewed the analysis and created a curated approved_list.txt, this command imports only the necessary components to the target wiki.

'''deploy command''': Reads the approved list and a dependency map. It then resolves the full dependency tree and surgically imports only the required pages from the source wiki to the target (ooda.wiki), skipping any that already exist. A --dry-run flag allows for simulating the deployment without making any edits.

== Future Development ==

'''refactor command''': (Under Development) An assistant that uses an LLM to review low-scoring templates and suggest simplifications or alternative implementations.

'''Active Voice Assistant''': An on-wiki tool to help editors convert passive voice to active voice, further improving the clarity and readability of the knowledge base.

Template:Template other

2025-08-15T06:29:40Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{#switch:

{{#if:{{{demospace|}}}
| {{lc: {{{demospace}}} }} 
| {{#ifeq:{{NAMESPACE}}|{{ns:Template}}
| template
| other
}}
}}
| template = {{{1|}}}
| other
| #default = {{{2|}}}
}}<noinclude>

{{documentation}}

</noinclude>

Template:Str left

2025-08-15T06:29:29Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

<includeonly>{{safesubst:padleft:|{{{2|1}}}|{{{1}}}}}</includeonly><noinclude>
{{documentation}}

</noinclude>

Template:SUBPAGENAME

2025-08-15T06:29:19Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{<includeonly>safesubst:</includeonly>SUBPAGENAME:{{{1|}}}}}<includeonly>[[Category:Pages which use a template in place of a magic word|K{{PAGENAME}}]]</includeonly><noinclude>
{{Documentation}}</noinclude>

Template:Remove first word

2025-08-15T06:29:09Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{<includeonly>safesubst:</includeonly>#invoke:String|replace|source={{{1}}}|pattern=^[^{{{sep|%s}}}]*{{{sep|%s}}}*|replace=|plain=false}}<noinclude>{{Documentation}}</noinclude>

Template:PAGENAME

2025-08-15T06:28:59Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{#if:{{{1|}}}|{{PAGENAME:{{{1|}}}}}|{{PAGENAME}}}}<includeonly>[[Category:Pages which use a template in place of a magic word|H{{PAGENAME}}]]</includeonly><noinclude>
{{documentation}}</noinclude>

Template:Ombox

2025-08-15T06:28:49Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{#invoke:Message box|ombox}}<noinclude>
{{documentation}}

</noinclude>

Template:NAMESPACE

2025-08-15T06:28:39Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

#redirect[[Template:Namespace]]

Template:Ambox/category

2025-08-15T06:28:29Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

<noinclude>{{pp-template|small=yes}}</noinclude>{{#if:{{{cat|}}}
|{{#if:{{{date|}}}
|[[Category:{{{cat}}} {{{preposition|from}}} {{{date}}}]]{{#ifexist:Category:{{{cat}}} {{{preposition|from}}} {{{date}}}|
|[[Category:Articles with invalid date parameter in template]]
}}
|[[Category:{{{cat}}}]]
}}
}}{{#if:{{{all|}}}
|[[Category:{{{all}}}]]
}}

Template:Ambox

2025-08-15T06:25:51Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

{{#invoke:Message box|ambox}}<noinclude>
{{documentation}}

</noinclude>

Module:Message box

2025-08-15T06:25:41Z

Converti: Bot batch install from 'wikipedia:en' via Converti SDK.

require('strict')
local getArgs
local yesno = require('Module:Yesno')
local lang = mw.language.getContentLanguage()

local CONFIG_MODULE = 'Module:Message box/configuration'
local DEMOSPACES = {talk = 'tmbox', image = 'imbox', file = 'imbox', category = 'cmbox', article = 'ambox', main = 'ambox'}

--------------------------------------------------------------------------------
-- Helper functions
--------------------------------------------------------------------------------

local function getTitleObject(...)
-- Get the title object, passing the function through pcall
-- in case we are over the expensive function count limit.
local success, title = pcall(mw.title.new, ...)
if success then
return title
end
end

local function union(t1, t2)
-- Returns the union of two arrays.
local vals = {}
for i, v in ipairs(t1) do
vals[v] = true
end
for i, v in ipairs(t2) do
vals[v] = true
end
local ret = {}
for k in pairs(vals) do
table.insert(ret, k)
end
table.sort(ret)
return ret
end

local function getArgNums(args, prefix)
local nums = {}
for k, v in pairs(args) do
local num = mw.ustring.match(tostring(k), '^' .. prefix .. '([1-9]%d*)$')
if num then
table.insert(nums, tonumber(num))
end
end
table.sort(nums)
return nums
end

--------------------------------------------------------------------------------
-- Box class definition
--------------------------------------------------------------------------------

local MessageBox = {}
MessageBox.__index = MessageBox

function MessageBox.new(boxType, args, cfg)
args = args or {}
local obj = {}

-- Set the title object and the namespace.
obj.title = getTitleObject(args.page) or mw.title.getCurrentTitle()

-- Set the config for our box type.
obj.cfg = cfg[boxType]
if not obj.cfg then
local ns = obj.title.namespace
-- boxType is "mbox" or invalid input
if args.demospace and args.demospace ~= '' then
-- implement demospace parameter of mbox
local demospace = string.lower(args.demospace)
if DEMOSPACES[demospace] then
-- use template from DEMOSPACES
obj.cfg = cfg[DEMOSPACES[demospace]]
elseif string.find( demospace, 'talk' ) then
-- demo as a talk page
obj.cfg = cfg.tmbox
else
-- default to ombox
obj.cfg = cfg.ombox
end
elseif ns == 0 then
obj.cfg = cfg.ambox -- main namespace
elseif ns == 6 then
obj.cfg = cfg.imbox -- file namespace
elseif ns == 14 then
obj.cfg = cfg.cmbox -- category namespace
else
local nsTable = mw.site.namespaces[ns]
if nsTable and nsTable.isTalk then
obj.cfg = cfg.tmbox -- any talk namespace
else
obj.cfg = cfg.ombox -- other namespaces or invalid input
end
end
end

-- Set the arguments, and remove all blank arguments except for the ones
-- listed in cfg.allowBlankParams.
do
local newArgs = {}
for k, v in pairs(args) do
if v ~= '' then
newArgs[k] = v
end
end
for i, param in ipairs(obj.cfg.allowBlankParams or {}) do
newArgs[param] = args[param]
end
obj.args = newArgs
end

-- Define internal data structure.
obj.categories = {}
obj.classes = {}
-- For lazy loading of [[Module:Category handler]].
obj.hasCategories = false

return setmetatable(obj, MessageBox)
end

function MessageBox:addCat(ns, cat, sort)
if not cat then
return nil
end
if sort then
cat = string.format('[[Category:%s|%s]]', cat, sort)
else
cat = string.format('[[Category:%s]]', cat)
end
self.hasCategories = true
self.categories[ns] = self.categories[ns] or {}
table.insert(self.categories[ns], cat)
end

function MessageBox:addClass(class)
if not class then
return nil
end
table.insert(self.classes, class)
end

function MessageBox:setParameters()
local args = self.args
local cfg = self.cfg

-- Get type data.
self.type = args.type
local typeData = cfg.types[self.type]
self.invalidTypeError = cfg.showInvalidTypeError
and self.type
and not typeData
typeData = typeData or cfg.types[cfg.default]
self.typeClass = typeData.class
self.typeImage = typeData.image
self.typeImageNeedsLink = typeData.imageNeedsLink

-- Find if the box has been wrongly substituted.
self.isSubstituted = cfg.substCheck and args.subst == 'SUBST'

-- Find whether we are using a small message box.
self.isSmall = cfg.allowSmall and (
cfg.smallParam and args.small == cfg.smallParam
or not cfg.smallParam and yesno(args.small)
)

-- Add attributes, classes and styles.
self.id = args.id
self.name = args.name
if self.name then
self:addClass('box-' .. string.gsub(self.name,' ','_'))
end
if yesno(args.plainlinks) ~= false then
self:addClass('plainlinks')
end
for _, class in ipairs(cfg.classes or {}) do
self:addClass(class)
end
if self.isSmall then
self:addClass(cfg.smallClass or 'mbox-small')
end
self:addClass(self.typeClass)
self:addClass(args.class)
self.style = args.style
self.attrs = args.attrs

-- Set text style.
self.textstyle = args.textstyle

-- Set image classes.
self.imageRightClass = args.imagerightclass or args.imageclass
self.imageLeftClass = args.imageleftclass or args.imageclass

-- Find if we are on the template page or not. This functionality is only
-- used if useCollapsibleTextFields is set, or if both cfg.templateCategory
-- and cfg.templateCategoryRequireName are set.
self.useCollapsibleTextFields = cfg.useCollapsibleTextFields
if self.useCollapsibleTextFields
or cfg.templateCategory
and cfg.templateCategoryRequireName
then
if self.name then
local templateName = mw.ustring.match(
self.name,
'^[tT][eE][mM][pP][lL][aA][tT][eE][%s_]*:[%s_]*(.*)$'
) or self.name
templateName = 'Template:' .. templateName
self.templateTitle = getTitleObject(templateName)
end
self.isTemplatePage = self.templateTitle
and mw.title.equals(self.title, self.templateTitle)
end

-- Process data for collapsible text fields. At the moment these are only
-- used in {{ambox}}.
if self.useCollapsibleTextFields then
-- Get the self.issue value.
if self.isSmall and args.smalltext then
self.issue = args.smalltext
else
local sect
if args.sect == '' then
sect = 'This ' .. (cfg.sectionDefault or 'page')
elseif type(args.sect) == 'string' then
sect = 'This ' .. args.sect
end
local issue = args.issue
issue = type(issue) == 'string' and issue ~= '' and issue or nil
local text = args.text
text = type(text) == 'string' and text or nil
local issues = {}
table.insert(issues, sect)
table.insert(issues, issue)
table.insert(issues, text)
self.issue = table.concat(issues, ' ')
end

-- Get the self.talk value.
local talk = args.talk
-- Show talk links on the template page or template subpages if the talk
-- parameter is blank.
if talk == ''
and self.templateTitle
and (
mw.title.equals(self.templateTitle, self.title)
or self.title:isSubpageOf(self.templateTitle)
)
then
talk = '#'
elseif talk == '' then
talk = nil
end
if talk then
-- If the talk value is a talk page, make a link to that page. Else
-- assume that it's a section heading, and make a link to the talk
-- page of the current page with that section heading.
local talkTitle = getTitleObject(talk)
local talkArgIsTalkPage = true
if not talkTitle or not talkTitle.isTalkPage then
talkArgIsTalkPage = false
talkTitle = getTitleObject(
self.title.text,
mw.site.namespaces[self.title.namespace].talk.id
)
end
if talkTitle and talkTitle.exists then
local talkText
if self.isSmall then
local talkLink = talkArgIsTalkPage and talk or (talkTitle.prefixedText .. (talk == '#' and '' or '#') .. talk)
talkText = string.format('([[%s|talk]])', talkLink)
else
talkText = 'Relevant discussion may be found on'
if talkArgIsTalkPage then
talkText = string.format(
'%s [[%s|%s]].',
talkText,
talk,
talkTitle.prefixedText
)
else
talkText = string.format(
'%s the [[%s' .. (talk == '#' and '' or '#') .. '%s|talk page]].',
talkText,
talkTitle.prefixedText,
talk
)
end
end
self.talk = talkText
end
end

-- Get other values.
self.fix = args.fix ~= '' and args.fix or nil
local date
if args.date and args.date ~= '' then
date = args.date
elseif args.date == '' and self.isTemplatePage then
date = lang:formatDate('F Y')
end
if date then
self.date = string.format(" (%s)", date)
end
self.info = args.info
if yesno(args.removalnotice) then
self.removalNotice = cfg.removalNotice
end
end

-- Set the non-collapsible text field. At the moment this is used by all box
-- types other than ambox, and also by ambox when small=yes.
if self.isSmall then
self.text = args.smalltext or args.text
else
self.text = args.text
end

-- Set the below row.
self.below = cfg.below and args.below

-- General image settings.
self.imageCellDiv = not self.isSmall and cfg.imageCellDiv
self.imageEmptyCell = cfg.imageEmptyCell

-- Left image settings.
local imageLeft = self.isSmall and args.smallimage or args.image
if cfg.imageCheckBlank and imageLeft ~= 'blank' and imageLeft ~= 'none'
or not cfg.imageCheckBlank and imageLeft ~= 'none'
then
self.imageLeft = imageLeft
if not imageLeft then
local imageSize = self.isSmall
and (cfg.imageSmallSize or '30x30px')
or '40x40px'
self.imageLeft = string.format('[[File:%s|%s%s|alt=]]', self.typeImage
or 'Information icon4.svg', imageSize, self.typeImageNeedsLink and "" or "|link=" )
end
end

-- Right image settings.
local imageRight = self.isSmall and args.smallimageright or args.imageright
if not (cfg.imageRightNone and imageRight == 'none') then
self.imageRight = imageRight
end

-- set templatestyles
self.base_templatestyles = cfg.templatestyles
self.templatestyles = args.templatestyles
end

function MessageBox:setMainspaceCategories()
local args = self.args
local cfg = self.cfg

if not cfg.allowMainspaceCategories then
return nil
end

local nums = {}
for _, prefix in ipairs{'cat', 'category', 'all'} do
args[prefix .. '1'] = args[prefix]
nums = union(nums, getArgNums(args, prefix))
end

-- The following is roughly equivalent to the old {{Ambox/category}}.
local date = args.date
date = type(date) == 'string' and date
local preposition = 'from'
for _, num in ipairs(nums) do
local mainCat = args['cat' .. tostring(num)]
or args['category' .. tostring(num)]
local allCat = args['all' .. tostring(num)]
mainCat = type(mainCat) == 'string' and mainCat
allCat = type(allCat) == 'string' and allCat
if mainCat and date and date ~= '' then
local catTitle = string.format('%s %s %s', mainCat, preposition, date)
self:addCat(0, catTitle)
catTitle = getTitleObject('Category:' .. catTitle)
if not catTitle or not catTitle.exists then
self:addCat(0, 'Articles with invalid date parameter in template')
end
elseif mainCat and (not date or date == '') then
self:addCat(0, mainCat)
end
if allCat then
self:addCat(0, allCat)
end
end
end

function MessageBox:setTemplateCategories()
local args = self.args
local cfg = self.cfg

-- Add template categories.
if cfg.templateCategory then
if cfg.templateCategoryRequireName then
if self.isTemplatePage then
self:addCat(10, cfg.templateCategory)
end
elseif not self.title.isSubpage then
self:addCat(10, cfg.templateCategory)
end
end

-- Add template error categories.
if cfg.templateErrorCategory then
local templateErrorCategory = cfg.templateErrorCategory
local templateCat, templateSort
if not self.name and not self.title.isSubpage then
templateCat = templateErrorCategory
elseif self.isTemplatePage then
local paramsToCheck = cfg.templateErrorParamsToCheck or {}
local count = 0
for i, param in ipairs(paramsToCheck) do
if not args[param] then
count = count + 1
end
end
if count > 0 then
templateCat = templateErrorCategory
templateSort = tostring(count)
end
if self.categoryNums and #self.categoryNums > 0 then
templateCat = templateErrorCategory
templateSort = 'C'
end
end
self:addCat(10, templateCat, templateSort)
end
end

function MessageBox:setAllNamespaceCategories()
-- Set categories for all namespaces.
if self.invalidTypeError then
local allSort = (self.title.namespace == 0 and 'Main:' or '') .. self.title.prefixedText
self:addCat('all', 'Wikipedia message box parameter needs fixing', allSort)
end
if self.isSubstituted then
self:addCat('all', 'Pages with incorrectly substituted templates')
end
end

function MessageBox:setCategories()
if self.title.namespace == 0 then
self:setMainspaceCategories()
elseif self.title.namespace == 10 then
self:setTemplateCategories()
end
self:setAllNamespaceCategories()
end

function MessageBox:renderCategories()
if not self.hasCategories then
-- No categories added, no need to pass them to Category handler so,
-- if it was invoked, it would return the empty string.
-- So we shortcut and return the empty string.
return ""
end
-- Convert category tables to strings and pass them through
-- [[Module:Category handler]].
return require('Module:Category handler')._main{
main = table.concat(self.categories[0] or {}),
template = table.concat(self.categories[10] or {}),
all = table.concat(self.categories.all or {}),
nocat = self.args.nocat,
page = self.args.page
}
end

function MessageBox:export()
local root = mw.html.create()

-- Add the subst check error.
if self.isSubstituted and self.name then
root:tag('b')
:addClass('error')
:wikitext(string.format(
'Template <code>%s[[Template:%s|%s]]%s</code> has been incorrectly substituted.',
mw.text.nowiki('{{'), self.name, self.name, mw.text.nowiki('}}')
))
end

local frame = mw.getCurrentFrame()
root:wikitext(frame:extensionTag{
name = 'templatestyles',
args = { src = self.base_templatestyles },
})
-- Add support for a single custom templatestyles sheet. Undocumented as
-- need should be limited and many templates using mbox are substed; we
-- don't want to spread templatestyles sheets around to arbitrary places
if self.templatestyles then
root:wikitext(frame:extensionTag{
name = 'templatestyles',
args = { src = self.templatestyles },
})
end

-- Create the box table.
local boxTable = root:tag('table')
boxTable:attr('id', self.id or nil)
for i, class in ipairs(self.classes or {}) do
boxTable:addClass(class or nil)
end
boxTable
:cssText(self.style or nil)
:attr('role', 'presentation')

if self.attrs then
boxTable:attr(self.attrs)
end

-- Add the left-hand image.
local row = boxTable:tag('tr')
if self.imageLeft then
local imageLeftCell = row:tag('td'):addClass('mbox-image')
if self.imageCellDiv then
-- If we are using a div, redefine imageLeftCell so that the image
-- is inside it. Divs use style="width: 52px;", which limits the
-- image width to 52px. If any images in a div are wider than that,
-- they may overlap with the text or cause other display problems.
imageLeftCell = imageLeftCell:tag('div'):addClass('mbox-image-div')
end
imageLeftCell
:addClass(self.imageLeftClass)
:wikitext(self.imageLeft or nil)
elseif self.imageEmptyCell then
-- Some message boxes define an empty cell if no image is specified, and
-- some don't. The old template code in templates where empty cells are
-- specified gives the following hint: "No image. Cell with some width
-- or padding necessary for text cell to have 100% width."
row:tag('td')
:addClass('mbox-empty-cell')
end

-- Add the text.
local textCell = row:tag('td'):addClass('mbox-text')
if self.useCollapsibleTextFields then
-- The message box uses advanced text parameters that allow things to be
-- collapsible. At the moment, only ambox uses this.
textCell:cssText(self.textstyle or nil)
local textCellDiv = textCell:tag('div')
textCellDiv
:addClass('mbox-text-span')
:wikitext(self.issue or nil)
if (self.talk or self.fix) then
textCellDiv:tag('span')
:addClass('hide-when-compact')
:wikitext(self.talk and (' ' .. self.talk) or nil)
:wikitext(self.fix and (' ' .. self.fix) or nil)
end
textCellDiv:wikitext(self.date and (' ' .. self.date) or nil)
if self.info and not self.isSmall then
textCellDiv
:tag('span')
:addClass('hide-when-compact')
:wikitext(self.info and (' ' .. self.info) or nil)
end
if self.removalNotice then
textCellDiv:tag('span')
:addClass('hide-when-compact')
:tag('i')
:wikitext(string.format(" (%s)", self.removalNotice))
end
else
-- Default text formatting - anything goes.
textCell
:cssText(self.textstyle or nil)
:wikitext(self.text or nil)
end

-- Add the right-hand image.
if self.imageRight then
local imageRightCell = row:tag('td'):addClass('mbox-imageright')
if self.imageCellDiv then
-- If we are using a div, redefine imageRightCell so that the image
-- is inside it.
imageRightCell = imageRightCell:tag('div'):addClass('mbox-image-div')
end
imageRightCell
:addClass(self.imageRightClass)
:wikitext(self.imageRight or nil)
end

-- Add the below row.
if self.below then
boxTable:tag('tr')
:tag('td')
:attr('colspan', self.imageRight and '3' or '2')
:addClass('mbox-text')
:cssText(self.textstyle or nil)
:wikitext(self.below or nil)
end

-- Add error message for invalid type parameters.
if self.invalidTypeError then
root:tag('div')
:addClass('mbox-invalid-type')
:wikitext(string.format(
'This message box is using an invalid "type=%s" parameter and needs fixing.',
self.type or ''
))
end

-- Add categories.
root:wikitext(self:renderCategories() or nil)

return tostring(root)
end

--------------------------------------------------------------------------------
-- Exports
--------------------------------------------------------------------------------

local p, mt = {}, {}

function p._exportClasses()
-- For testing.
return {
MessageBox = MessageBox
}
end

function p.main(boxType, args, cfgTables)
local box = MessageBox.new(boxType, args, cfgTables or mw.loadData(CONFIG_MODULE))
box:setParameters()
box:setCategories()
return box:export()
end

function mt.__index(t, k)
return function (frame)
if not getArgs then
getArgs = require('Module:Arguments').getArgs
end
return t.main(k, getArgs(frame, {trim = false, removeBlanks = false}))
end
end

return setmetatable(p, mt)

Module:Documentation/config

2025-08-10T19:47:37Z