Module:Naval Vessel Register URL

Module documentation[view] [edit] [history] [purge]

Summary

This module generates links to ships in the Naval Vessel Register (nvr.navy.mil) database. Intended to be used by:

• {{Naval Vessel Register URL}}
• {{Naval Vessel Register service craft URL}}

NVR have, over time, adopted several different conventions to link to a ship's data base on the ship's hull classification symbol.

To get round 'new' conventions, this version of the module adopts a brute-force mechanism by using a local database that maps a ship's hull classification symbol to its associated NVR ship-data identifier. The database is two large Lua tables maintained at Module:Naval Vessel Register URL/data. Previous versions of this module and its associated data module ignored T- prefixes that are part of several hull designators. As of the 2025-07-16 version, this module does not ignore the prefix; if NVR uses the T- prefix, this module expects to see that prefix in its |id= parameter.

Using this module from templates

nvr_url_make

This function returns a link to a ship's page at the Naval Vessel Register website.

Usage:

{{#invoke:Naval Vessel Register URL|nvr_url_make |id=|title=}}

{{#invoke:Naval Vessel Register URL|nvr_url_make}} — uses the calling template's parameters

Parameters:

1 or id — the ship's case-insensitive hull classification symbol in one of four forms:

1. SSBN-659 – the preferred format because it matches the format for hull classification symbols generally used for US Navy ships throughout Wikipedia
2. SSBN 659 – the form used in the NVR
3. SSBN659
4. SSBN_659

There are exceptions. There are three ships listed at the NVR website that do not have hull classification symbols. These are: USS Constitution, USS Maine, and USS Texas. For these three ships, use the ship's name for this parameter. The code word OLDIRON, previously used to identify Constitution is no longer supported.

2 or title — A title or label for the link.

Examples:

{{#invoke:Naval Vessel Register URL|nvr_url_make|DDG_1000}} produces

{{#invoke:Naval Vessel Register URL|nvr_url_make|constitution}} produces

{{#invoke:Naval Vessel Register URL|nvr_url_make|maine|USS ''Maine''}} produces

This function can also return a link to a service craft in the Naval Vessel Register.

Usage:

{{#invoke:Naval Vessel Register URL|nvr_url_make|id=|title=}}

{{#invoke:Naval Vessel Register URL|nvr_url_make}} — uses the calling template's parameters

Parameters:

1 or id — the ship's case-insensitive hull classification symbol in one of four forms:

1. YTB-760 – the preferred format because it matches the format for hull classification symbols generally used for US Navy ships throughout Wikipedia
2. YTB 760 – the form used in the NVR
3. YTB760
4. YTB_760

There are exceptions. NVR has separate pages for some single and some multiple sections of some floating drydocks. For these, this module adopts a convention similarly used by NVR where each section is distinguished by a letter designator; that letter must be appended to the hull classification symbol used in this parameter; see the examples

2 or title — A title or label for the link.

Examples:

{{#invoke:Naval Vessel Register URL|nvr_url_make|AFDB-7F}} produces

{{#invoke:Naval Vessel Register URL|nvr_url_make|ytb-760|''Natick''}} produces

The above documentation is transcluded from Module:Naval Vessel Register URL/doc. (edit | history)
Editors can experiment in this module's sandbox (edit | diff) and testcases (edit | run) pages.
Subpages of this module.

--[[  
 
This module generates links to ships in the Naval Vessel Register (nvr.navy.mil) database.  
It is used by Template:NVR_url and Template:NVR_SC_url
 
Please do not modify this code without applying the changes first at Module:NVR/sandbox and testing 
at Module:NVR/sandbox/testcases and Module talk:NVR/sandbox/testcases.
 
Authors and maintainers:
* User:RP88
 
]]

local p = {}

-- =======================================
-- === Public Functions ==================
-- =======================================

--[[
MakeShipLink
 
This function returns a link to a ship in the Naval Vessel Register.
 
Usage:
{{#invoke:NVR|MakeShipLink|id=|title=}}
{{#invoke:NVR|MakeShipLink}} - uses the caller's parameters
 
Parameters
    1, id: The 'file name' portion of the url path (typically the ship's hull designation) without the .HTM/.HTML extension. 
    2, title: A title or label for the link.
]]
function p.MakeShipLink( frame )
	-- if no argument provided than check parent template/module args
	local args = frame.args
	if args[1]==nil then
		args = frame:getParent().args 
	end
	
	local nvrid = args["id"] or args[1] or ''; 
	local title = args["title"] or args[2] or '';
	local debug = yesno(args["debug"] or '', false) -- debugging can be true, or false

	local output = p._MakeShipLink(nvrid, title, debug)

	return output
end

--[[
MakeServiceShipLink
 
This function returns a link to a service ship in the Naval Vessel Register.
 
Usage:
{{#invoke:NVR|MakeServiceShipLink|id=|title=}}
{{#invoke:NVR|MakeServiceShipLink}} - uses the caller's parameters
 
Parameters
    1, id: The 'file name' portion of the url path (typically the ship's hull designation) without the .HTM/.HTML extension. 
    2, title: A title or label for the link.
]]
function p.MakeServiceShipLink( frame )
	-- if no argument provided than check parent template/module args
	local args = frame.args
	if args[1]==nil then
		args = frame:getParent().args 
	end
	
	local nvrid = args["id"] or args[1] or ''; 
	local title = args["title"] or args[2] or '';
	local debug = yesno(args["debug"] or '', false) -- debugging can be true, or false

	local output = p._MakeServiceShipLink(nvrid, title, debug)

	return output
end


--[[
This function returns a link to a ship in the Naval Vessel Register. 

Parameters
	nvrid: The 'file name' portion of the url path (typically the ship's hull designation) without the .HTM/.HTML extension, as a string.
	title: Title for link, set to '' for a bare link without a title.
]]
function p._MakeShipLink( nvrid, title )	
	local output = ''
	
	-- if the id appears to be an old id, convert it to a new id, if possible.
	nvrid = mw.ustring.upper(nvrid)
	
	if (nvrid == 'MAINE') then
		nvrid = '939'
	elseif (nvrid == 'MARCOS') then
		nvrid = '940'
	elseif (nvrid == 'OLDIRON') then
		nvrid = '1315'
	elseif (nvrid == 'AFSB15') then
		nvrid = 'AFSB_(I)_15'
	elseif (mw.ustring.find(nvrid, "^[A-Z]+[0-9]+$") ~= nil) then
		nvrid = mw.ustring.gsub(nvrid, "^([A-Z]+)([0-9]+)$", "%1_%2", 1);
	end
	
	output = nvr_link(nvrid, false, false, title)
		
	return output
end

--[[
This function returns a link to a service ship in the Naval Vessel Register. 

Parameters
	nvrid: The 'file name' portion of the url path (typically the ship's hull designation) without the .HTM/.HTML extension, as a string.
	title: Title for link, set to '' for a bare link without a title.
]]
function p._MakeServiceShipLink( nvrid, title )	
	local output = ''
	local oldid = false
	
	-- if the id appears to be an old id, convert it to a new id, if possible.
	nvrid = mw.ustring.upper(nvrid)
	
	if (nvrid == 'AFDB7_1') then
		nvrid = 'AFDB_7'
	elseif (nvrid == 'AFDB1_1') then
		oldid = true
	elseif (nvrid == 'AFDB1_3') then
		oldid = true
	elseif (nvrid == 'AFDB1_4') then
		oldid = true
	elseif (nvrid == 'AFDB7_2') then
		oldid = true
	elseif (mw.ustring.find(nvrid, "^[A-Z]+[0-9]+$") ~= nil) then
		nvrid = mw.ustring.gsub(nvrid, "^([A-Z]+)([0-9]+)$", "%1_%2", 1);
	end
	
	output = nvr_link(nvrid, oldid, true, title)
		
	return output
end


-- =======================================
-- === Private Functions =================
-- =======================================

--[[
Generate link to NVR database.
]]
function nvr_link( nvrid, oldid, supportship, title )
	
	local link = ''
	local url_str = ''
	
	if oldid then
		if supportship then
			url_str = 'http://www.nvr.navy.mil/NVRSERVICECRAFT/DETAILS/' .. nvrid .. '.HTM'
		else
			url_str = 'http://www.nvr.navy.mil/NVRSHIPS/DETAILS/' .. nvrid .. '.HTM'
		end
	else
		url_str = 'http://www.nvr.navy.mil/SHIPDETAILS/SHIPSDETAIL_' .. nvrid .. '.HTML'
	end

	if (title == '') then
		link = url_str
	else
		link = '[' .. url_str .. ' ' .. title .. ']'
	end
	
    return link
end


return p