墨迹语 CMS

v1.0.0 使用说明

列表页标签

列表页标签用于栏目列表页模板,显示该栏目下的文章列表和相关信息。

常用标签

栏目信息标签

标签 说明 示例
{$category.name} 栏目名称 技术分享
{$category.description} 栏目描述 分享技术文章和经验
{$category.slug} 栏目别名 tech_share
{$category.seo_title} SEO 标题 技术分享 - 编程文章

文章列表标签

{loop $articles $article}
<div class="article-item">
    <h3><a href="{$BASE_URL}/posts/{$article.category_id}/{$article.id}.html">
        {$article.title}
    </a></h3>
    {if $article.thumb}
    <img src="{$article.thumb}" alt="{$article.title}">
    {/if}
    <p>{$article.description}</p>
    <div class="meta">
        <span>作者:{$article.author_name}</span>
        <time>{$article.published_at}</time>
        <span>浏览量:{$article.views}</span>
    </div>
</div>
{/loop}

分页标签 (业务标签)

使用 tag:pagination 标签生成分页,参数支持变量注入:

{tag:pagination 
    total="$art_data.total" 
    per_page="$art_data.per_page" 
    current_page="$art_data.current_page"
    url="?page="}

文章列表 (业务标签)

{tag:articles catid="$category.id" limit="10" return="art_list"}
{loop $art_list.data $article}
<div class="article-item">
    <h3>{$article.title}</h3>
</div>
{/loop}

完整示例

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <title>{$category.seo_title} - {$setting.site_name}</title>
</head>
<body>
    <header>
        <h1>{$category.name}</h1>
        {if $category.description}
        <p>{$category.description}</p>
        {/if}
    </header>
    
    <main>
        {if $articles}
        {loop $articles $article}
        <article class="article-item">
            <h2><a href="{$BASE_URL}/posts/{$article.category_id}/{$article.id}.html">
                {$article.title}
            </a></h2>
            {if $article.thumb}
            <img src="{$article.thumb}" alt="{$article.title}">
            {/if}
            <p>{$article.description}</p>
            <div class="meta">
                <span>作者:{$article.author_name}</span>
                <time>{$article.published_at}</time>
                <span>浏览量:{$article.views}</span>
            </div>
        </article>
        {/loop}
        {else}
        <p>该栏目下还没有文章</p>
        {/if}
        
        {if $pagination}
        <div class="pagination">
            <!-- 分页代码 -->
        </div>
        {/if}
    </main>
</body>
</html>
提示: 更多详细信息请查看 模板标签系统基础语法 文档。