DSpace 6.2 XMLUI Mirage2：修改communitylist.xsl添加社区Logo求助

我之前维护DSpace 6.2的Mirage2主题时，刚好做过社区Logo展示的修改，完全匹配你想要的效果，下面是具体步骤：

1. 定位并修改communitylist.xsl文件 #

首先找到主题核心XSL文件，路径一般是：
[你的DSpace源码目录]/dspace-xmlui/src/main/webapp/themes/Mirage2/xsl/core/communitylist.xsl

打开文件后，找到渲染社区列表条目的循环部分（通常是<xsl:for-each select="dri:item">或者匹配dri:list[@id='community-browser']的模板）。在每个社区名称的前面，添加以下代码来渲染Logo：

<!-- 渲染社区Logo -->
<xsl:if test="dri:metadata[@element='description'][@qualifier='logo']">
  <img 
    src="{concat($context-path, '/bitstream/', dri:metadata[@element='description'][@qualifier='logo']/text(), '/')}"
    alt="{dri:label/text()}"
    class="community-logo"
    loading="lazy"
  />
</xsl:if>

代码说明： #

• dri:metadata[@element='description'][@qualifier='logo']：DSpace会将社区上传的Logo对应的Bitstream ID存储在这个元数据字段中
• $context-path：XSL内置变量，自动获取你的DSpace站点上下文路径（比如/dspace）
• loading="lazy"：可选，优化页面加载性能

2. 添加自定义CSS样式 #

为了让Logo和社区名称排版美观，打开Mirage2的自定义CSS文件：
[你的DSpace源码目录]/dspace-xmlui/src/main/webapp/themes/Mirage2/css/custom.css

添加以下样式（可以根据你的需求调整尺寸、间距）：

/* 社区列表Logo样式 */
.community-logo {
  width: 75px;
  height: auto;
  margin-right: 12px;
  vertical-align: middle;
  border-radius: 4px; /* 可选：添加圆角效果 */
}

/* 适配移动端 */
@media (max-width: 768px) {
  .community-logo {
    width: 50px;
    margin-right: 8px;
  }
}

3. 验证和测试 #

• 确保你已经为目标社区上传了Logo（在DSpace后台的社区编辑页面，找到"Logo"上传选项）
• 重新编译并部署DSpace主题（如果是源码部署，执行mvn package后重新部署；如果是war包部署，替换对应的主题文件）
• 刷新首页，就能看到社区列表旁显示对应的Logo了

常见问题排查： #

• 如果Logo不显示：检查社区的dc.description.logo元数据是否存在，或者Bitstream ID是否正确
• 路径错误：确认$context-path变量是否正确，或者直接替换为你的站点根路径（比如/dspace）

内容的提问来源于stack exchange，提问作者Alejandro