核心概念

在开始之前,需要理解 DedeCMS 模板的基本构成：

  • 模板目录: DedeCMS 的模板文件通常存放在 /templets/ 目录下，为了管理方便，强烈建议在此目录下为你的网站创建一个专属的文件夹，/templets/your_site_name/。
  • 模板文件: 这些是 .htm 后缀的 HTML 文件，包含了网站页面的结构和样式，并嵌入了 DedeCMS 的模板标签（如 {dede:arclist}、{dede:field} 等）。
  • 模板位置: 后台中的“模板管理”或“模板设置”里，每个可设置模板的地方（如首页、列表页、文章页）都有一个默认的模板位置（如 default/index.htm），你需要将你创建的新模板文件关联到这些位置上。

创建模板文件

这是在前台进行的文件操作,相当于“画”出你的网页。

步骤 1：规划你的模板

明确你需要哪些页面模板,最常见的模板包括：

  • 首页模板: index.htm - 网站的门面。
  • 列表页模板: list_article.htm - 文章列表页面。
  • 页模板: article_article.htm - 显示单篇文章详细内容的页面。
  • 其他页面模板: 如搜索页、TAG页、单页文档（关于我们、联系我们）等。

步骤 2：创建模板目录

为了不干扰系统默认模板,建议创建自己的模板目录。

  1. 通过 FTP 或文件管理器，登录你的网站服务器。
  2. 进入 /dede/templets/ 目录。
  3. 创建一个新的文件夹,命名为你喜欢的名字，my_theme。
  4. 之后你所有的模板文件都将放在 /templets/my_theme/ 目录下。

步骤 3：编写或修改模板内容

你可以通过以下两种方式创建模板文件：

方法 A：复制并修改现有模板（推荐新手）

  1. 找到系统默认的模板文件,它们通常在 /templets/default/ 目录下。
  2. 复制你需要的模板文件（index.htm）到你刚刚创建的新目录 /templets/my_theme/ 中。
  3. 使用代码编辑器（如 VS Code、Sublime Text、Dreamweaver）打开复制的文件。
  4. 修改 HTML 结构、CSS 样式和 JS 代码，并嵌入或修改 DedeCMS 的模板标签来调用数据。
    • 常用标签示例:
      • {dede:global.cfg_webname/}：调用网站名称。
      • {dede:arclist row='8' titlelen='24'}：调用文章列表。
      • {dede:field.title/}：在文章页调用文章标题。
      • {dede:field.body/}：在文章页调用文章正文。

方法 B：从零开始创建模板

  1. 在 /templets/my_theme/ 目录下，新建一个 .htm 文件，index.htm。
  2. 用代码编辑器打开它,编写一个完整的 HTML5 结构。
  3. 在需要显示动态内容的地方,嵌入 DedeCMS 的模板标签。
  4. 为了让模板能被 DedeCMS 识别，必须在文件顶部加入模板引擎识别代码：
    <!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{dede:global.cfg_webname/}</title>
    <!-- 其他 head 内容 -->
</head>
<body>
    <!-- 你的页面内容 -->
</body>
</html>

    注意：虽然很多教程会提到 {dede:config} 等标签，但对于新版本的 DedeCMS，只要文件是 .htm 后缀且在 templets 目录下，通常不需要特别的头部声明即可被识别，保持一个干净的 HTML 结构即可。

在后台关联模板

这是将你创建的“画”应用到网站实际显示位置的过程。

步骤 1：登录 DedeCMS 后台

使用你的管理员账号登录网站后台。

步骤 2：进入模板管理

  1. 在左侧菜单栏中找到 【系统】 -> 【系统基本参数】。
  2. 在弹出的页面中,切换到 【核心设置】 选项卡。
  3. 找到 “模板默认目录” 这一栏，将其值修改为你刚刚创建的模板目录名，my_theme。
    • 这样做的好处：之后所有新设置的模板都会默认从这个目录中查找，方便管理。

步骤 3：为各个页面指定模板

你需要为具体的页面（如首页、列表页）指定你创建的模板文件。

A. 设置首页模板

  1. 在左侧菜单栏找到 【主页】 -> 【主页管理】。
  2. 在“模板文件名”一栏，输入你的首页模板文件名，my_theme/index.htm。
    • 注意：这里需要填写相对于 /templets/ 目录的完整路径，如果你在步骤2中设置了默认目录，也可以只写 index.htm，但推荐写全路径以避免混淆。
  3. 点击 “更新主页” 按钮即可。

B. 设置列表页模板

  1. 在左侧菜单栏找到 【核心】 -> 【频道模型】 -> 模型管理】。
  2. 点击你正在使用的模型（通常是“文章”模型）后面的 【列表】 按钮。
  3. 在“列表命名规则”中，你可以设置列表页的文件名（如 list_{tid}.htm）。
  4. 在“列表模板”一栏，输入你的列表页模板文件名，my_theme/list_article.htm。
  5. 点击 “保存”。

C. 设置文章内容页模板

  1. 同样在 模型管理】 中，点击“文章”模型后面的 【文档】 按钮。
  2. 在“文章命名规则”中，设置内容页的文件名（如 {aid}.htm）。
  3. 在“文章内容页模板”一栏，输入你的内容页模板文件名，my_theme/article_article.htm。
  4. 点击 “保存”。

D. 设置其他页面模板

  • 单页文档: 进入 【核心】 -> 【单页文档管理】，编辑对应的单页，在“模板选择”中选择你创建的模板。
  • 搜索页: 进入 【核心】 -> 【搜索设置】，在“搜索模板”中选择或输入你的搜索页模板。
  • TAG页: 进入 【核心】 -> 【标签管理】，在“标签列表模板”和“标签内容页模板”中进行设置。

步骤 4：生成页面

模板设置好后,网站并不会立即显示新模板，因为页面是静态生成的。

  1. 进入 【生成】 -> 【一键生成网站】。
  2. 点击 “开始生成”，系统会重新生成首页、栏目页和内容页。
  3. 生成完成后,清空浏览器缓存，然后访问你的网站，就能看到应用了新模板的效果了。

总结与注意事项

  1. 文件权限: 确保 /templets/ 目录及其子目录和文件具有正确的读写权限（通常是 755 或 644），否则后台可能无法保存模板或生成页面。
  2. 路径正确: 在后台设置模板时，文件路径一定要写对，my_theme/index.htm 而不是 /my_theme/index.htm。
  3. 缓存问题: 如果修改了模板但前台没有更新，尝试在后台 【系统】 -> 【清除缓存】 中清除所有缓存。
  4. 标签使用: 熟练掌握 DedeCMS 常用标签是模板制作的关键，可以多参考默认模板的写法。
  5. 备份: 在修改任何文件之前，请务必备份原始文件，以防出错。

按照以上流程,你就可以顺利地在 DedeCMS 中添加并应用新的模板了。