IntraLAN 模板机制:如何自定义 LAN Party 站点界面

IntraLAN 的界面可以自定义，核心方式就是修改它的 Text::Templates 模板文件。模板把 HTML 展示层与数据库、数据解析逻辑分开，因此即使你只懂 HTML，也能完成换配色、改布局、替换文字这类基础改动；如果你会 Perl，还能在模板体系里做更复杂的定制。前提是你已经有一套能跑起来的 IntraLAN 环境（Apache + Perl，推荐搭配 MySQL），并且能找到它的模板目录。

模板机制是怎么运作的

IntraLAN 用 Perl 编写，早期版本通过 SSI 在 cgi-bin 中调用 Perl 脚本，后来转向直接运行在 mod_perl 下的 Perl 脚本。无论哪种运行方式，页面输出都交给 Text::Templates 处理。

这个机制的关键在于职责分离：

• 数据层：Perl 脚本从数据库读取内容（日程、私信、链接、比赛信息等），完成解析和业务逻辑。
• 展示层：模板文件只负责“长什么样”，里面基本就是 HTML，加上少量模板标记用来插入数据。
• 结果：改模板不会碰数据库结构，也不会改坏脚本逻辑；反过来，脚本升级时你的外观改动通常也能保留。

一个贴切的例子：假设你想把站点顶部的活动名称改成自己 LAN party 的名字。你不需要去翻 Perl 脚本里拼接 HTML 的代码，只要打开对应模板，找到那段标题 HTML，直接改文字即可。数据仍然由脚本照常注入，页面其他部分不受影响。

基础自定义：只改 HTML

适合不写 Perl 的组织者。原文明确说明，模板“little more than just html”，可以“easily hack up”。

前提

• IntraLAN 已部署并可访问。
• 你能通过文件管理或 SSH 编辑服务器上的模板文件。
• 改动前备份原模板目录。

步骤

1. 定位模板目录：在 IntraLAN 安装目录中找到存放模板文件的子目录（模板与脚本分离存放，这是 Text::Templates 的用法）。
2. 确认页面与模板的对应关系：打开站点某个页面，对照模板文件名和其中的 HTML 结构，找到负责该页面的模板。
3. 复制一份原文件作为备份，例如 index.tmpl.bak。
4. 编辑 HTML：修改颜色、字体、Logo 图片路径、页头页脚文字、栏目顺序等纯展示内容。
5. 保存后刷新浏览器验证。若页面报错或空白，先恢复备份，再检查是否误删了模板标记（形如插入变量的占位符），这些标记不能当普通文字删掉。

验证方法

• 逐页刷新：首页、日程、链接、私信、比赛页面各看一遍。
• 检查动态内容是否仍在：日程条目、链接列表是否正常显示，说明数据注入未被破坏。
• 用不同浏览器或强制刷新，排除缓存干扰。

常见卡点

• 删掉了模板标记：页面结构在，但动态数据消失或报错。恢复备份，只改标记之外的 HTML。
• 改了模板但页面没变：确认改的是当前运行实例使用的模板目录，而不是源码包里的另一份副本；mod_perl 环境下有时需要重启服务。
• 图片不显示：模板里的资源路径是相对 Web 根目录的，换图时路径要对应实际存放位置。

进阶自定义：会 Perl 能做什么

原文提到，如果你自认是 Perl 程序员，模板机制“allow you to do some really neat stuff”。结合其架构，可行的方向包括：

• 在模板中配合脚本输出更复杂的条件展示，例如按比赛状态显示不同区块。
• 基于现有模板改造出全新的页面布局，而不只是换皮。
• 把自己写的模板、补丁或 hack 回馈给项目——原文明确欢迎提交 templates、patches、hacks。

需要注意：进阶改动涉及 Perl 脚本与模板的配合，改错可能影响整个站点。建议在副本环境先试，确认无误再上线。

要不要走自定义这条路

原文没有提供在线演示站点（作者表示有人愿意提供才会挂链接），所以自定义效果只能在自己的部署上验证。另外，项目页面还提到后续可能增加“Leech resources list”和更多比赛功能，这意味着模板结构未来可能变化，深度改动时保留好备份和改动记录会更稳妥。