如何将TYPO3 tx_news详情视图拆分至独立内容区域？

你已经完成了后端布局和模板布局的基础配置，接下来只需要通过模板拆分、TypoScript关联和插件配置这几步，就能实现把详情视图拆分到两个独立内容区域的需求，具体操作如下：

1. 拆分新闻详情模板 #

先把tx_news默认的详情模板复制到你自己的模板目录（推荐放在fileadmin/templates/News/或者你的站点扩展模板目录），然后拆分成两个针对性的模板文件：

• DetailHeadOnly.html：只保留需要放在「News-Head」区域的内容，比如标题、副标题、封面图等，示例代码参考：

<f:layout name="Default" />
<f:section name="Main">
    <h1 class="news-title">{news.title}</h1>
    <f:if condition="{news.subtitle}">
        <h2 class="news-subtitle">{news.subtitle}</h2>
    </f:if>
    <f:if condition="{news.falMedia}">
        <div class="news-cover">
            <f:image image="{news.falMedia.0}" alt="{news.falMedia.0.alternative}" class="cover-img" />
        </div>
    </f:if>
</f:section>

• Detail.html：保留剩余的详情内容，比如正文、发布日期、作者、标签等，示例代码参考：

<f:layout name="Default" />
<f:section name="Main">
    <div class="news-detail-content">
        <div class="meta-info">
            <span class="publish-date"><f:format.date format="Y-m-d">{news.datetime}</f:format.date></span>
            <f:if condition="{news.author}">
                <span class="author">作者：{news.author}</span>
            </f:if>
        </div>
        <div class="news-body">
            <f:format.html>{news.bodytext}</f:format.html>
        </div>
        <!-- 可添加标签、相关新闻等模块 -->
    </div>
</f:section>

2. 用TypoScript关联模板布局与模板文件 #

在你的站点TypoScript配置中，指定自定义模板路径，并把你配置的模板布局20映射到对应的模板文件：

plugin.tx_news {
    view {
        # 自定义模板路径，优先级高于tx_news默认模板
        templateRootPaths {
            10 = fileadmin/templates/News/
        }
        # 保持你已配置的模板布局名称
        templateLayouts {
            20 = Detail (Head only)
        }
    }
    settings {
        # 将模板布局20关联到我们的DetailHeadOnly模板
        templateLayouts {
            20 = DetailHeadOnly
        }
    }
}

3. 配置两个新闻插件 #

回到后端内容编辑界面，分别设置两个区域的插件：

• 「News-Head」区域（colPos=0）的插件：选择「模板布局」为Detail (Head only)，并设置插件的新闻来源：如果是动态详情页（从列表页跳转过来），选择「使用请求中的新闻」；如果是固定单条新闻，直接选中对应的新闻记录。
• 「News without Head」区域（colPos=22）的插件：保持默认的详情模板布局，同样设置新闻来源为「使用请求中的新闻」或固定新闻记录，确保和第一个插件指向同一个新闻条目。

4. 关键注意事项 #

• 清理缓存：修改模板和TypoScript后，一定要清理TYPO3的前端和后端缓存，避免旧内容影响显示效果。
• 避免重复渲染：仔细核对两个模板的内容，不要让相同元素（比如标题）在两个区域重复出现。
• 样式适配：根据你的前端样式需求，给两个模板的元素添加对应的CSS类，确保布局显示正常。

这样配置完成后，新闻详情就会分别在两个独立内容区域渲染标题部分和正文部分了！

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