Module:OpenHistoricalMap/News

Documentation

This documentation is transcluded from Module:OpenHistoricalMap/News/doc. (Edit | history)
Note to editors: Please don't categorize this template by editing it directly. Instead, place the category in its documentation page, in its "includeonly" section.

Usage

This module populates {{OpenHistoricalMap/News}} with a list of OpenHistoricalMap project news from Module:OpenHistoricalMap/News/data.json.

main

|date_format =

The date format for the header of each event in the list.

|historical = yes

Formats the list for a historical archive. The list includes old news and is sorted chronologically (instead of reverse-chronologically).

See also

• Module:OpenHistoricalMap/Events

local p = {}
local languages = require("Module:Languages")

function p.main(frame)
	local title = mw.title.getCurrentTitle()
	local lang = mw.getLanguage(languages.languageFromTitle(title))
	local langCode = lang:getCode()
	-- MediaWiki abnormally lowercases ISO 3166 and ISO 15924 codes in locales.
	langCode = langCode:gsub("-(%w%w%w%w)", function (script)
		return "-" .. script:sub(1, 1):upper() .. script:sub(2)
	end):gsub("-(%w%w)$", function (country)
		return "-" .. country:upper()
	end)
	
	local dateFormat = frame.args.date_format and #frame.args.date_format > 0 and frame.args.date_format or "F j, Y"
	local historical = frame.args.historical == "yes"

	local events = mw.loadJsonData("Module:OpenHistoricalMap/News/data.json")
	if not historical then
		-- Clone the read-only JSON data in order to manipulate it; mw.clone() requires write permissions.
		events = mw.text.jsonDecode(mw.text.jsonEncode(events))
		-- Sort the data reverse-chronologically.
		table.sort(events, function (a, b)
			return a.date > b.date
		end)
	end
	
	local aLongTimeAgo = lang:formatDate("c", "-6 months")
	local list = mw.html.create("dl")
	for i, event in ipairs(events) do
		-- Omit old news.
		if not historical and (i > 5 or event.date < aLongTimeAgo) then
			break
		end
		
		list:tag("dt")
			:wikitext(lang:formatDate(dateFormat, event.date))
		list:tag("dd")
			:wikitext(frame:preprocess(event.description[langCode] or event.description.en))
	end
	
	return list
end

return p