Emlog 是一个轻量级的开源博客系统,模板文件和目录结构清晰,便于用户自定义和扩展。以下是 Emlog 模板文件及目录的详细说明:
1. 模板目录结构
Emlog 的模板文件通常存放在 content/templates/
目录下,每个模板为一个独立的文件夹。例如,模板名为 mytemplate
,则其路径为:
content/templates/mytemplate/
2. 模板核心文件及说明
以下是模板文件夹中常见的文件及其作用:
文件名 | 作用 |
---|---|
index.php |
模板的主入口文件,定义博客首页的显示逻辑。 |
header.php |
页面头部文件,通常包含 <head> 部分、导航栏等。 |
footer.php |
页面底部文件,通常包含版权信息、备案号等。 |
sidebar.php |
侧边栏文件,用于显示侧边栏内容(如分类、标签、文章等)。 |
archive.php |
归档页面文件,用于显示文章归档列表。 |
post.php |
文章详情页文件,用于显示单篇文章的内容。 |
page.php |
自定义页面文件,用于显示独立页面(如关于我、联系我们等)。 |
search.php |
搜索结果页面文件,用于显示搜索结果。 |
404.php |
404 错误页面文件,用于显示页面未找到时的提示。 |
style.css |
模板的样式文件,定义模板的 CSS 样式。 |
screenshot.png |
模板的预览图,用于在后台模板选择界面显示。 |
3. 模板文件夹中的其他文件
除了上述核心文件外,模板文件夹中还可能包含以下文件或目录:
-
images/
存放模板所需的图片资源,如背景图、图标等。 -
js/
存放模板所需的 JavaScript 文件。 -
css/
存放额外的 CSS 文件(除style.css
外)。 -
lang/
存放语言包文件,用于支持多语言。 -
config.php
模板的配置文件,用于定义模板的自定义选项(如颜色、布局等)。 -
functions.php
模板的功能文件,用于定义模板的自定义函数或过滤器。
4. 模板文件的基本结构
以下是一个简单的模板文件结构示例:
content/templates/mytemplate/
├── index.php
├── header.php
├── footer.php
├── sidebar.php
├── archive.php
├── post.php
├── page.php
├── search.php
├── 404.php
├── style.css
├── screenshot.png
├── images/
│ └── logo.png
├── js/
│ └── custom.js
├── css/
│ └── responsive.css
└── lang/
└── zh_CN.php
5. 模板文件中的常用变量
在模板文件中,可以通过 Emlog 提供的全局变量获取博客信息。例如:
-
$blog_title
博客标题。 -
$blog_description
博客描述。 -
$site_url
博客的根 URL。 -
$log_title
当前文章的标题(在post.php
中使用)。 -
$log_content
当前文章的内容(在post.php
中使用)。 -
$logs
文章列表数组(在index.php
或archive.php
中使用)。
6. 模板开发注意事项
-
模板命名
模板文件夹名称应使用英文或数字,避免使用中文或特殊字符。 -
文件编码
模板文件应使用 UTF-8 编码,避免出现乱码。 -
兼容性
确保模板兼容 Emlog 的版本,避免使用已废弃的函数或变量。 -
安全性
避免在模板中直接输出用户输入的内容,防止 XSS 攻击。
7. 模板的安装与启用
- 将模板文件夹上传到
content/templates/
目录。 - 登录 Emlog 后台,进入“模板管理”页面。
- 找到新上传的模板,点击“启用”即可。
(牛站网络)