İçeriğe atla

Modül:Redirect hatnote

Vikipedi, özgür ansiklopedi
Modül belgelemesigör değiştir geçmiş temizle
--[[
-- Bu modül "yönlendirme" ilknotunu (hatnote) üretir.
-- Şöyle görünür: '"X" buraya yönlendirilmektedir. Y için Z sayfasına bakınız.'
-- {{Yönlendirme}} (veya {{İlknot}}) şablonunu uygular.
--]]

local mHatnote = require('Modül:İlknot')
local mHatList = require('Modül:İlknot liste')
local mArguments -- Gecikmeli başlatma (lazy initialization)
local libraryUtil = require('libraryUtil')
local checkType = libraryUtil.checkType

local p = {}

--------------------------------------------------------------------------------
-- Yardımcı Fonksiyonlar
--------------------------------------------------------------------------------

local function getTitle(...)
	-- mw.title.new çağrısı yapar; başarılıysa başlık nesnesini, hatada nil döndürür.
	local success, titleObj = pcall(mw.title.new, ...)
	return success and titleObj or nil
end

--------------------------------------------------------------------------------
-- Ana Fonksiyonlar
--------------------------------------------------------------------------------

function p.redirect(frame)
	mArguments = require('Modül:Bağımsız değişkenler')
	local args = mArguments.getArgs(frame, {parentOnly = true})
	-- Yönlendirme sayısını al
	local numRedirects = tonumber(frame.args[1]) or 1
	-- Seçenekler tablosunu oluştur
	local options = {}
	options.selfref = args.selfref
	return p._redirect(args, numRedirects, options)
end

function p._redirect(args, numRedirects, options, currentTitle, redirectTitle, targetTitle)
	-- Girdileri doğrula. currentTitle, redirectTitle veya targetTitle sadece test
	-- amaçlı kullanıldığından kontrol edilmez.
	checkType('_redirect', 1, args, 'table')
	checkType('_redirect', 2, numRedirects, 'number', true)
	numRedirects = numRedirects or 1
	checkType('_redirect', 3, options, 'table', true)
	options = options or {}
	currentTitle = currentTitle or mw.title.getCurrentTitle()
	
	-- Yönlendirmeler tablosunu al
	local redirect = {}
	for i = 1, numRedirects do
		-- Yönlendirme parametresi eksikse hata döndür
		if not args[i] then
			return mHatnote.makeWikitextError(
				'eksik yönlendirme parametresi',
				'Şablon:Yönlendirme#Hatalar',
				args.category
			)
		end
		redirect[i] = args[i]
	end
	
	-- Metni oluştur
	local formattedRedirect = {}
	for k, v in pairs(redirect) do
		formattedRedirect[k] = mHatnote.quote(v)
	end
	
	-- İngilizcedeki "redirects" (tekil/çoğul) ayrımı Türkçede fiil çekimi gerektirmediğinden 
	-- statik "buraya yönlendirilmektedir." dizgesi kullanılmıştır.
	local text = {
		mHatList.andList(formattedRedirect) .. ' buraya yönlendirilmektedir.',
		mHatList._forSee(args, #redirect + 1, {title = redirect[1], extratext = args.text})
	}
	text = table.concat(text, ' ')
	
	-- Kategori ekleme işlevselliği
	local categoryTable = {}
	local function addCategory(cat)
		if cat and cat ~= '' then
			-- Çiftleri önlemek için dizin (index) ile ekle
			categoryTable[string.format('[[Kategori:%s]]', cat)] = true
		end
	end
	
	-- İzleme kategorilerini oluştur
	local mhOptions = {}
	local redirTitle
	for k, v in pairs(redirect) do
		-- Sadece ana madde veya kategori ad alanındaysak izleme kategorisi ekle.
		if (currentTitle.namespace == 0 or currentTitle.namespace == 14) then
			redirTitle = redirectTitle or getTitle(v)
			
			if not redirTitle or not redirTitle.exists then
				addCategory('Eksik yönlendirmeler')
			elseif not redirTitle.isRedirect then
				addCategory('Gözden geçirilmesi gereken yönlendirme ilknotlarına sahip maddeler')
			else
				local target = targetTitle or redirTitle.redirectTarget
				if target and target ~= currentTitle then
					addCategory('Gözden geçirilmesi gereken yönlendirme ilknotlarına sahip maddeler')
				end
			end
		end

		-- [[Modül:İlknot]] modülüne geçirilecek seçenekleri oluştur.
		if currentTitle.namespace == 0 and not mhOptions.selfref
			and redirTitle and redirTitle.namespace ~= 0
		then
			-- Ana ad alanındayız ve ilknot "Vikipedi:X buraya yönlendiriliyor" gibi bir 
			-- başlık içeriyor, bu yüzden otomatik olarak öz-başvuru (self-reference) olarak etiketle.
			mhOptions.selfref = true
		else
			mhOptions.selfref = options.selfref
		end
	end
	
	-- Tüm kategorileri birleştir
	local category = ''
	for k, v in pairs(categoryTable) do
		category = category .. k
	end

	return mHatnote._hatnote(text, mhOptions) .. category
end
 
return p