모듈:CodexRecommend

이 모듈에 대한 설명문서는 모듈:CodexRecommend/설명문서에서 만들 수 있습니다

-- ============================================================
-- 모듈:CodexRecommend
--   코덱스 추천 히어로 목록을 렌더링하는 Lua 모듈.
--   쉼표로 구분된 히어로 이름을 받아 인원 제한 없이 처리합니다.
--
-- [상호작용]
--   - 호출:  틀:Codex/Recommend  →  이 모듈의 render 함수를 호출
--   - 출력:  각 히어로마다 [[파일:{이름} 포트레이트.png]] + [[{이름}]] 링크
--   - 스타일: 틀:Codex/Recommend/styles.css 의 .codex-rec__* 클래스 사용
--             (이 모듈은 HTML 구조만 생성하고, 색·여백은 CSS가 담당)
--
-- [파일명 규칙]
--   포트레이트 = "{히어로 이름} 포트레이트.png" (한글 '포트레이트', 고정)
-- ============================================================

local p = {}

function p.render(frame)
	-- 부모 틀(틀:Codex/Recommend)이 받은 인수를 가져옴
	local args = frame:getParent().args
	-- 첫 번째 무명 인수에 "마케나, 스칼리오네, ..." 형태로 들어옴
	local raw = args[1] or ''

	-- 쉼표로 분리하여 히어로 이름 배열 생성
	local heroes = {}
	for name in mw.text.gsplit(raw, ',') do
		local trimmed = mw.text.trim(name)   -- 앞뒤 공백 제거
		if trimmed ~= '' then
			table.insert(heroes, trimmed)
		end
	end

	-- 이름이 하나도 없으면 아무것도 출력하지 않음
	if #heroes == 0 then
		return ''
	end

	-- 각 히어로를 카드 조각으로 변환
	local parts = {}
	for _, hero in ipairs(heroes) do
		-- 포트레이트는 클릭 시 히어로 문서로, 이름도 동일 링크
		local piece = string.format(
			'<span class="codex-rec__hero">[[파일:%s 포트레이트.png|56px|link=%s]]<span class="codex-rec__name">[[%s]]</span></span>',
			hero, hero, hero
		)
		table.insert(parts, piece)
	end

	-- 조각들을 이어붙여 반환 (바깥 틀·CSS·제목은 틀 쪽에서 감쌈)
	return table.concat(parts)
end

return p