Pigeon For Typecho 使用文档

在简洁的外表下，隐藏着一颗强大的心

 Pigeon 主题演示

这是一款适用于文字编辑的 Typecho 主题，主题所有的功能都围绕着写作来服务，在简约的外表下可以使文字的优美更加突出，去除所有对阅读干扰的板块！

快速上手

安装主题和插件

Pigeon主题压缩包里包含了主题、插件两项内容，其目录结构如下：

主题安装压缩包
  -- 1.主题文件
  -- 2.插件文件

安装主题文件

将压缩包内1.主题文件文件夹中的Pigeon文件夹完整上传到服务器上 Typecho 的/usr/themes/文件夹内，然后到 Typecho 后台，启用主题即可。

安装主题插件

将压缩包内2.插件文件文件夹中的Notes文件夹完整上传到服务器上 Typecho 的/usr/plugins/文件夹内，然后到 Typecho 后台，启用插件即可 注意：插件文件必须为 Notes。

必须的配置项

归档页面

新建方法：

新建一个独立页面（管理-独立页面-新增）：

• 标题根据自身喜好填写即可。例如：归档 或 Archive 等；
• slug（标题下面的那个）填写为：archives。
• 自定义模板选择文章归档。
• 发布页面

关于页面

新建方法：

新建一个独立页面（管理-独立页面-新增）：

• 标题根据自身喜好填写即可。例如：关于 或 About 等；
• slug（标题下面的那个）填写为：about。
• 内容部分按需发挥
• 发布页面

外观设置

主题样式

主题一共有两种样式卡片样式和普通样式，修改方法 外观设置

主题皮肤

主题新增加一款 新拟物 皮肤 ，修改方法 外观设置 — 主题皮肤

图片位置

首页和分类列表的图片位置共有 3 种显示效果可选 图片在左 图片再右 和图片交叉，修改方法 外观设置 — 图片位置

一言样式

一言共有两种显示效果，大图样式和小图样式，设置方法 外观设置 — 一言样式

分页样式选择

主题分页共有两个效果，分别为 Ajax 翻页 和分页式翻页 设置方法 外观设置 — Ajax翻页

归档分页和分类背景图片滤镜效果

滤镜效果分别为 颜色滤镜和磨砂滤镜，设置方法 外观设置 — 归档 分类滤镜效果

归档分页和分类背景图片添加

归档图片的添加方法：主题设置 — 归档页面背景图

分类图片设置方法：首先在基础设置 — 分类背景，然后把 jpg 格式的图片添加到主题目录下的 images/category 文件夹下，命名为 分类的 mid 编号，搜索的图片图片名称命名为 other

网站背景

背景设置方法： 主题设置 —网站背景

背景图片设置方法 ： 主题设置 —背景图片

独立页面

归档页面

新建一个独立页面，自定义模板选择 文章归档即可 即可。

独立页面支持 以月份归档和年份归档，并且支持展开和关闭

设置方法：基础设置 —归档年份 基础设置 — 归档折叠

豆瓣清单

主题的豆瓣清单并不是基于 js 来调取的，而是把 书单 和 影单 数据直接放到本地，这样我们加载节省了很多时间

新建一个独立页面，自定义模板选择 豆瓣清单 即可。

设置方法： 在建立独立页面的底部选择 添加字段 左边的框填写 doubanID 右边的框填写 你的豆瓣ID

时光机

主题的 时光机 可以通过 时光机页面和微信公众号添加，时光机微信公共账号 XXXX

微信时光机设置方法： 先关注微信公众号，发送绑定，这时微信公共号会发送 点击绑定 点击它会跳转到绑定页面

时光机的分页有两种显示方式：Ajax 和 分页样式

设置方法： 外观设置 — 时光机分页

留言

新建一个独立页面，自定义模板选择 留言板 即可。

留言板会显示最新 7 天的留言人的信息。

友情链接

新建一个独立页面，自定义模板选择 友情链接 即可。

友情链接设置方法， 管理 —友情链接 添加即可，输出位置可选 友情链接 ， 推荐链接

友情链接有两个样式可选

设置方法： 外观设置 —友情链接样式

文章页面

首页显示样式

文章页面设置了 4 种文章类型， 分别为 多图 ，一言和文字，其中文字样式在文章头图 填写要显示的图片的时候首页就会自动显示文图样式。

文章目录

如果想选用文章目录 在文章页下方的 文章目录 选择显示即可， 文章目录支持 H2~H4 标签

图片说明

在正常情况图片显示图片说明，会让图片更加明了，也有一些朋友感觉图片说明会影响图片的显示效果，所以主题也增加了 图片说明关闭的功能

设置方法：基础设置 — 文章图片说明

文章首行缩进

文章内置了首行缩进的短代码按钮，但为了 有些朋友并不是刚开始就使用本主题，一篇篇的修改是非常麻烦的事情，所以主题增加了全站首行缩进的设置

设置方法：基础设置 — 文章首行缩进

阅读次数

文章阅读次数设置方法：基础设置 — 阅读次数

当开启阅读次数的时候 归档也会是显示文章的阅读次数

百度收录

为了更好的收录主题添加了百度收录反馈和百度提交，当打开文章页面的时候就会自动提交至百度

设置方法：高级设置 — 百度收录 在此处填写 百度推送接口的API即可，不填写就不会开启此功能

导航设置

分类和独立页面顺序

主题的分类和独立页面是支持自定义排序的

设置方法：导航设置 — 分类与独立页面顺序

分类设置

分类支持展开、关闭、合并 三种样式

设置方法： 导航设置 — 分类选项

合并的时候可以自定义合并后显示的名称，展开的时候支持二级菜单

独立页面

独立页面也是支持合并的，合并后显示的合并名称

自定义链接

为了方便朋友们的外联设置，主题支持在导航定义链接，并且支持合并

设定方法： 导航设置 — 自定义导航栏链接

格式如下

<a href="地址">名称</a>
<a href="地址">名称</a>

切记为每行一个链接

相册设置

在新建一个分类 缩略名必须为 image

以后更新直接在文章中添加 md 图片标签即可，在分类直接选择 相册

比如

![图片名称](图片接连)

PJAX 设置

PJAX 开关

主题是支持 PJAX 无刷新体验的

开启方法： 高级设置 —PJAX

PJAX 动画

主题新增加的 PJAX 过渡动画，效果为淡入淡出

设置方法： 高级设置 — PJA动画

PJAX 回调

pjax 对一些基于JS 的功能设置起来会比较麻烦，但大多数的作者都会把 回调函数 告诉我们

添加回调函数的方法： 其他函数 — PJAX回调函数

音乐设置

主题的音乐支持自选音乐和 QQ音乐 网易云 歌单解析 两种模式选择

设置方法：高级设置 — 音乐播放器

自选音乐设置

自选音乐比如我们在其他网站下载的音乐其他音乐网站没有的，这时候我们就需要自选音乐了

设置方法：打开主题配套的插件 在 背景音乐类表中 添加音乐

比如

5276818 #*# 小星星变奏曲 - 莫扎特,
http://music.163.com/song/media/outer/url?id=2177197.mp3 #*# Moon River - Audrey Hepburn,

歌单解析

添加方法：高级设置 — 音乐链接

https://music.163.com/#/playlist?id=924680166

幻灯片和置顶

置顶设置

置顶设置：高级功能 — 文章置顶

置顶的文章cid，按照排序输入, 请以半角逗号或空格分隔

幻灯片设置

设置方法 ：高级设置 —首页轮显文章ID

填入轮显文章ID,支持多填