文章

在本主题中，我们扩展了 Typecho 的文章概念，产生了如下三个类别，你可在新建文章的自定义字段中看到。

站内文章

顾名思义，单纯的站内内容和普通博客一样，可以用来撰写教程、图文。

因此后续的自定义字段如 跳转地址、图标URL 等对其无效

网址导航

本主题的核心，点击图标前往详情页，点击其他位置直接打开对应的 跳转地址

小程序

作为网址导航的扩展，不同的是点击会直接进入详情页，而其 跳转地址 应填写小程序的二维码用于扫码访问

分类

展示方式
一级分类将展示在页面左侧菜单栏，子分类则根据主题设置中的 子分类的展示方式 而有所不同

选择 平铺 则二级分类同样显示在左侧菜单栏
选择 收纳 则二级分类以选项的形式展示在左侧导航块的左侧，在点击切换时动态加载
如果文章较多推荐使用 收纳，可减少首页数据查询从而提高加载速度

图标
本站使用 FontAwesome 作为图标。分类略缩名表示对应图标名称

例如：要使用 <i class="fas fa-vihara"></i> 作为某个分类的图标，那么分类的略缩名应设置为 vihara

快捷搜索
主页的快捷搜索在外观设置中的 搜索引擎配置 中设置，其格式为 JSON 有如下示例

[
      {
          "name": "站内",
          "url": "/search/",
          "icon": "fas fa-search-location"
      },
      {
          "name": "谷歌",
          "url": "https://www.google.com/search?q=",
          "icon": "fab fa-google"
      },
      {
          "name": "Github",
          "url": "https://github.com/search?q=",
          "icon": "fab fa-github"
      }
  ]

每项有三个字段，其中 url 为搜索引擎的访问地址，发起搜索时关键字将拼接在 url 后，故目前只支持 GET 方式。
icon 为搜索项的图标，同样使用 FontAwesome 和分类图标的区别是需要使用完整类名，即形如 fas fa-search-location 而非 search-location

工具直达
即主页右侧工具直达模块，对应主题设置中 工具直达配置 格式同样为 JSON 示例如下

[
  {
    "name": "热榜速览",
    "url": "https://www.hsmy.fun",
    "icon": "fas fa-fire",
    "background": "linear-gradient(45deg, #97b3ff, #2f66ff)"
  },
  {
    "name": "地图",
    "url": "https://ditu.amap.com/",
    "icon": "fas fa-fire",
    "background": "red"
  },
  {
    "name": "微信文件助手",
    "url": "https://filehelper.weixin.qq.com",
    "icon": "fab fa-weixin",
    "background": "#1ba784"
  }
]

和搜索引擎配置类似，多出 background 字段用于控制其背景色，接受 css 格式的颜色值

独立页面

时间线
请在后台 管理 > 独立页面 > 新增，将其模板设置为 目录/时间线，文章类型设置为 站内文章
时间线页面分页页大小配置，在外观设置 时间线每页文章数。

其他
对应首页顶部其他导航项，

当 文章类型 为 网址导航 并配置 跳转地址 时，点击会直接跳转，故页面内容留空即可。
当 文章类型 为 站内文章 或 小程序 时，点击会进入该页面

主体

也即首页主体部分，每个块对应一个分类

  • 块中项目数量在 后台 设置 > 阅读 > 每页文章数目 中设置。
  • 文章的图标使用创建文章时的 图标URL 如图标为空则使用第三方API自动获取，可在主题设置中更改要使用的API

热榜速览

文章排名
展示点击量前5的文章，暂不支持自定义

天气
数据由必应天气提供，目前来看没有调用限制，但请不要滥用。
为避免频繁调用，数据会浏览器中缓存15分钟
由于该 API 采用动态跨域策略，即相同的 API Key 会在一段时间内只允许初次请求的域，故推荐使用不同的API Key，获取方式如下：

浏览器访问 https://www.msn.com/zh-cn/weather/forecast
打开 DevTools 在网络中找到任意包含 apikey 参数的 Fetch/XHR 请求，该参数值即为我们需要的 API Key
暂不清楚该 Key 是否会过期。

14
0