配置与链接

站点配置、站内链接与静态资源地址。

站点配置 config

读取后台「平台设置」的键值，输出时已做 HTML 转义。

调用格式

{pycms:config name="site_description" /}

参数

完整示例

<p>{pycms:config name="site_description" default="盘云CMS 内容管理系统" /}</p>
<a href="mailto:{pycms:config name="contact_email" /}">联系我们</a>

配置键在后台「平台设置」中维护；输出已转义，不要用于输出富文本。

配置中的链接 config_url

读取配置值并按站内地址生成可访问 URL，适合 Logo、Banner、备案链接等。

调用格式

{pycms:config_url name="site_logo" /}

参数

完整示例

<img src="{pycms:config_url name="site_logo" /}" alt="{pycms:config name="site_name" /}">
<a href="{pycms:config_url name="beian_link" /}" target="_blank">{pycms:config name="beian_no" /}</a>

输出会经过 py_url() 处理，自动带上部署子目录前缀。

站内链接 url

生成带部署子目录前缀的站内地址。

调用格式

{pycms:url path="/about" /}

参数

完整示例

<a href="{pycms:url path="/" /}">首页</a>
<a href="{pycms:url path="/list/news" /}">新闻中心</a>
<a href="{pycms:url path="/show/12.html" /}">文章详情</a>

不要直接写死 / 开头的链接，否则子目录部署会 404。

全局资源地址 asset

输出核心 public 资源目录下的文件地址，自动带部署前缀。

调用格式

{pycms:asset path="assets/site.css" /}

参数

完整示例

<link rel="stylesheet" href="{pycms:asset path="assets/site.css" /}">
<script src="{pycms:asset path="assets/site.js" /}"></script>

主题自己的 CSS、JS 请使用 theme_asset，避免升级主题时资源混淆。

主题资源地址 theme_asset

输出当前主题目录下的资源地址，并自动附带文件版本号，适合主题 CSS、JS 与图片。

调用格式

{pycms:theme_asset path="style.css" /}

参数

完整示例

<link rel="stylesheet" href="{pycms:theme_asset path="style.css" /}">
<script src="{pycms:theme_asset path="assets/home.js" /}"></script>

更换主题后会自动指向新主题资源，不需要修改模板中的域名。