DEDECMS内容页模板通常位于/templets/default/目录下，文件名为article_article.htm，自定义时需修改该文件并利用DEDECMS标签调用数据，结合CSS和JavaScript优化样式与交互，修改后必须通过后台“更新HTML”功能重新生成页面才能生效；若修改不生效，常见原因包括未更新HTML、浏览器或CDN缓存、模板路径错误、文件权限不足或标签语法错误；调用自定义字段需先在后台创建字段，再通过{dede:field.字段名/}在模板中调用，相关文章可通过{dede:likearticle}标签按关键词、标签或栏目智能推荐；模板结构优化建议包括使用HTML5语义化标签、模块化设计（配合{dede:include}引用头部、底部等公共部分）、外链CSS和JS文件、提升SEO（合理使用H标签、添加图片alt属性、正确调用关键词和描述）、实现响应式布局，并保持代码简洁与良好注释，以提升维护效率与用户体验。
DEDECMS的内容页模板通常位于你的网站根目录下的
/templets/default/文件夹里，文件名一般是
article_article.htm。当然，如果你的网站使用了其他模板，那么
default就会是那个模板文件夹的名字。自定义内容页，主要是通过修改这个HTML文件，利用DEDECMS的标签系统来调用数据，再结合一些CSS和JavaScript来控制样式和交互。
解决方案
要自定义DEDECMS的内容页，你得先找到对应的模板文件。最常见的文章内容页模板就是
templets/你的模板目录/article_article.htm。如果你有图片集、软件下载等特殊内容模型，它们会有各自对应的模板文件，比如
article_image.htm或
article_soft.htm。
找到文件后，你可以用任何文本编辑器（比如Sublime Text, VS Code, Notepad++）打开它。内容页的自定义主要围绕以下几点展开：
- 直接修改HTML结构： 这是最基础的，你可以添加、删除或调整HTML元素，比如把标题放在H1标签里，正文放在div里。
-
利用DEDECMS标签调用数据： 这是核心。DEDECMS有一套自己的标签系统，用来从数据库里提取内容。
- 调用文章标题：
{dede:field.title/} - 调用文章正文：
{dede:field.body/} - 调用发布时间：
{dede:field.pubdate function="GetDateTimeMK(@me)"/} - 调用作者：
{dede:field.writer/} - 调用点击量：
{dede:field.click/} - 调用缩略图：
{dede:field.litpic/} - 调用所属栏目名称：
{dede:field.typename/} - 如果你有自定义字段，比如
{dede:field.my_custom_field/}也能直接调用。
- 调用文章标题：
-
整合CSS和JavaScript： 你可以在模板文件里直接写
<style>
和<script>
标签，但我个人更推荐把CSS和JS文件外链进来，这样管理起来方便，也利于浏览器缓存。比如在<head>
里引入CSS：<link href="/templets/你的模板目录/css/style.css" rel="stylesheet" type="text/css" />
。 - 保存并更新HTML： 修改完模板文件后，记得保存。然后进入DEDECMS后台，找到“生成”菜单下的“更新HTML”或“更新文档”，选择“更新所有文档”或“更新特定栏目”来重新生成内容页的HTML文件。这一步是关键，否则你的修改不会生效。
我记得刚开始接触DEDECMS时，光是找到那个对的模板文件就花了不少时间，因为不同内容模型会对应不同的模板，而且模板文件夹名也不是固定的。所以，动手前最好先在后台的“核心”->“频道模型”->“内容模型管理”里，看看你的文章模型对应的“内容页模板”路径是什么，这样能少走很多弯路。
DEDECMS内容页模板修改后不生效怎么办？
这几乎是每个DEDECMS使用者都会遇到的问题，有时候改了半天，刷新页面一看，一点变化都没有，那种感觉真是让人抓狂。遇到这种情况，别急，通常有几个常见的原因和对应的解决办法。
首先，最最常见的问题就是没有更新HTML。DEDECMS是静态化CMS，你修改了模板文件，只是修改了“蓝图”，并没有把基于这个蓝图生成好的“房子”（HTML页面）更新掉。所以，你得去后台，找到“生成”菜单，然后点击“更新HTML”或者“更新文档”，选择“更新所有文档”或者针对你修改的那个栏目进行“更新文档HTML”。这一步是强制性的，必须做。
其次，浏览器缓存也是个“坑”。你可能更新了HTML，但浏览器却还在显示旧的缓存页面。这时，你需要强制刷新浏览器（Ctrl+F5 或 Cmd+Shift+R），或者清理浏览器缓存。如果你使用了CDN，那可能还需要去CDN服务商那里刷新一下缓存。
再来，就是模板路径或文件名错误。你是不是改错了文件？或者在后台设置的模板路径不对？比如，文章内容页模板默认是
article_article.htm，如果你改成了
article_news.htm，但后台配置的还是
article_article.htm，那肯定不生效。去“核心”->“频道模型”->“内容模型管理”里，检查一下你对应内容模型的“内容页模板”路径是否正确。
最后，文件权限问题也可能导致修改不生效。如果你修改了模板文件，但保存时提示权限不足，或者修改后文件内容并没有真正写入，那你的修改就白费了。确保你的FTP客户端或者服务器上的文件有写入权限（通常是755或777，但777不推荐用于生产环境）。另外，模板文件里如果存在一些语法错误，尤其是Dede标签写错了，也可能导致页面渲染不完整或直接报错，让你误以为没生效。检查一下
data/runtime/目录下的缓存文件，如果有很多错误日志，那多半是模板语法问题。
DEDECMS内容页如何调用自定义字段和相关文章？
在DEDECMS的内容页模板里，调用自定义字段和显示相关文章是提升内容丰富度和用户体验的关键。这块功能用好了，能让你的文章页看起来更专业，也更具互动性。
调用自定义字段： 自定义字段是DEDECMS非常实用的一个功能，它允许你为文章添加除了标题、正文之外的更多属性，比如“来源”、“作者简介”、“产品参数”等等。
-
创建自定义字段： 首先，你得在DEDECMS后台创建这些字段。路径是“核心”->“频道模型”->“内容模型管理”，找到你对应的“文章模型”或“图片模型”，点击后面的“字段管理”，然后“增加新字段”。在这里你可以设置字段名（比如
source
、author_intro
）、字段类型（文本、图片、多行文本等）以及是否允许空值等。 -
在模板中调用： 一旦字段创建并填充了数据，在内容页模板中调用它们就非常简单了。使用
{dede:field.你的字段名/}的格式即可。- 例如，你创建了一个名为
source
的字段来记录文章来源，那么在模板中这样调用：文章来源：{dede:field.source/}。 - 如果是一个多行文本字段，比如
author_intro
：作者简介：<p>{dede:field.author_intro/}</p>。 - 如果是图片字段，可能会需要一些额外的处理来控制大小：
<img src="{dede:field.my_image_field/}" alt="{dede:field.title/}" width="200" />。
- 例如，你创建了一个名为
调用相关文章： 相关文章的展示可以有效增加用户在网站上的停留时间，引导他们阅读更多内容。DEDECMS提供了
dede:likearticle标签来轻松实现这个功能。
dede:likearticle标签可以根据文章的关键词、标签、栏目等来智能推荐相关内容。
一个典型的用法是这样的：
<div class="related-articles">
<h3>相关推荐</h3>
<ul>
{dede:likearticle row='8' titlelen='50' orderby='rand'}
<li><a href="[field:arcurl/]" title="[field:title/]">[field:title/]</a></li>
{/dede:likearticle}
</ul>
</div>row='8'
：表示显示8篇文章。titlelen='50'
：表示文章标题截取50个字符。orderby='rand'
：表示随机排序，你也可以设置为click
（按点击量）、pubdate
（按发布时间）等。[field:arcurl/]
：调用文章的URL。[field:title/]
：调用文章的标题。
你还可以通过
typeid（指定栏目ID）或
tagid（指定标签ID）来更精确地控制相关文章的范围。比如，只显示同一栏目下的相关文章：
{dede:likearticle row='8' typeid='[field:typeid/]'}。
DEDECMS内容页模板结构优化建议有哪些？
优化DEDECMS内容页模板结构，不仅仅是为了美观，更重要的是为了提升用户体验、搜索引擎优化（SEO）效果以及网站的维护效率。一个好的模板结构，能让你的网站在竞争中脱颖而出。
-
采用语义化HTML5标签： 告别大量的
div
，拥抱HTML5的语义化标签，如<header>
、<nav>
、<main>
、<article>
、<section>
、<aside>
、<footer>
。这不仅让代码结构更清晰，也更有利于搜索引擎理解页面内容。比如，文章主体内容就放在<article>
标签里，侧边栏内容放在<aside>
里。 -
模块化设计与
dede:include
： 将页面中重复出现的部分，如头部（header）、底部（footer）、侧边栏（sidebar）等，独立成单独的HTML文件。然后，在内容页模板中通过{dede:include filename='header.htm'/}这样的标签来引用。这样做的好处是显而易见的：修改一次，全站生效，大大提高维护效率，也让主模板文件更简洁。 -
CSS和JavaScript外链： 避免在模板文件内部写大量的
<style>
或<script>
代码。将CSS样式和JavaScript脚本分别存放在外部.css
和.js
文件中，并通过<link>
和<script src="">
标签引用。这有助于浏览器缓存这些文件，减少页面加载时间，也让内容页模板本身更干净。 -
SEO友好结构：
-
标题（H标签）： 确保文章标题使用
<h1>
标签，子标题使用<h2>
、<h3>
等，且层级清晰。 -
图片优化： 所有图片都应该包含
alt
属性，描述图片内容，这不仅对SEO有帮助，也提升了无障碍访问性。alt="{dede:field.title/}"或alt="[field:title function='html2text(@me)'/]"
是常用的做法。 -
关键词和描述： 虽然DEDECMS会自动生成，但你可以在模板中确保它们被正确调用，通常在
<head>
标签内：<meta name="keywords" content="{dede:field.keywords/}" />和<meta name="description" content="{dede:field.description function='cn_substrR(@me,200)'/}" />。
-
标题（H标签）： 确保文章标题使用
- 响应式设计： 考虑到移动设备的普及，内容页模板必须是响应式的。这意味着你需要使用CSS媒体查询（Media Queries）或者采用Bootstrap、Foundation等前端框架来确保页面在不同屏幕尺寸下都能良好显示。虽然DEDECMS本身不提供响应式功能，但模板设计时必须考虑。
- 代码简洁与注释： 保持模板代码的简洁性，去除不必要的空格和注释。但对于复杂的逻辑块，适当的注释是必要的，可以帮助未来的你或团队成员理解代码。
一个好的模板结构，就像盖房子时打下的坚实地基，虽然初期投入精力多一点，但长远来看，无论是扩展新功能，还是应对未来的挑战，都会显得游刃有余。
