Snapic Paper 使用文档
版本型号：Snapic Paper v3
适用程序：Typecho
皮肤类型：主题模板
模板作者：Lopwon
作者博客：Lopwon.com
发布页面：Lopwon.com/snapic-paper.html
官方演示：Snapic paper
我要购买：55元/域名，价格为单个授权域名（不可变更）下使用主题的费用。
协议须知：协议 / 须知
著作权号：登记中……
我要升级：升级 Snapic Paper v3
重要提示：付款时别忘了留下邮箱收取文件包，勿留 Gmail 邮箱，会被退信。
主题说明
主题 Snapic Paper 适用于文字阅读和图像记录，没有多余页面元素，可以呈现干净文本，可以展示大幅图像，能够专注于安静浏览博客图志，简洁、纯粹、实用。还有一些彩蛋小功能，详见（这里）介绍。
主题 Snapic Paper 重制由来，浏览。
主题更新
2025年09月23日 发布 Snapic Paper v3
2023年08月30日 Snapic Paper v2.0 新增一些功能，修正已知问题，优化不少样式。
2022年04月25日 发布 Snapic Paper
使用方法
重要：主题 Snapic Paper v3 独立运作，与旧版主题无关联，主题 Snapic Paper v3 的所有配置以本页为准。
A 部署文件
一、全新安装
将主题文件夹 SnapicPaper 及其内部所有文件上传至目录 usr/themes/ 中，后台》控制台》外观，启用 Snapic Paper
二、升级安装
1. 停用旧版 Snapic Paper 主题，删除 usr/themes/ 中的 SnapicPaper 文件夹，及其内部所有文件。
2. 将新版主题文件夹 SnapicPaper 及其内部所有文件上传至目录 usr/themes/ 中，后台》控制台》外观，启用 Snapic Paper
B 配置页面
一、创建首页「幻灯片」（必选项）。
1. 后台》管理》标签，新增标签，该标签将用于标记需要呈现在首页幻灯片的文章。其中，标签名称自定义（如：置顶），在标记文章时，要使用该标签。标签缩略名，必须填入 topic，乱填无效！
2. 给需要成为首页幻灯片的文章，添加在上一步新增的标签（如：置顶）。这些文章的内容中，至少要有一张图片，幻灯片的图片读取自该篇文章中的随机一张图，否则，会以 noPicture.png 代替。
3. 注意：首页幻灯片的最大数量为 3 篇文章，如果标记文章的数量大于 3 篇，则以最新发布且用标签（如：置顶）标记的 3 篇文章呈现。如果标记文章的数量小于 3 篇时，则显示对应的文章数量。如果没有标记任何文章时，首页幻灯片则不显示。
4. 提示：首页幻灯片使用乱序排序，即每次刷新页面时，首屏随机展示。
二、创建「索引」页面（可选项）。
1. 后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。
2. 页面缩略名必须填入 catalog，乱填无效！
3. 提示：该页面用于（索引）图标唤出滑窗时 Fetch 数据使用，不提供给浏览者直接访问。
三、创建「心绪」页面（可选项）。
1. 后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。
2. 页面缩略名必须填入 mood，乱填无效！
3. 此编辑页面右侧的“高级选项”，请勾选“权限控制”的“允许评论”。
4. 选择性启用 for Snapic Paper 插件，作用是：
· 限制浏览者在心绪 mood 页面创建父级评论，只允许回复博主的心绪；
· 博主心绪内容中的图片使用延迟加载和灯箱看图功能；
· 博主在登录状态下，在心绪 mood 页面可以使用表情包功能；
5. 鉴于以上，建议启用插件，如下：
· 将压缩包里的文件夹 forSnapicPaper 及其内部的所有文件，上传至目录 usr/plugins/ 中。
· 后台》控制台》插件，找到 fot Snapic Paper 并启用。
6. 重要：请勿与使用相同接口的其他评论插件同时启用，以免冲突失效。
四、创建「图志」页面（可选项）。
1. 后台》管理》独立页面》新增，新建独立页面，除以下提到的事项外，其余正常操作即可。
2. 页面缩略名必须填入以 log- 为前缀的名称（如 log-cat），乱填无效！以此方式可以创建更多的「图志」页面，如：
log-cat
log-travel
log-2025-08
……
3. 此编辑页面右侧的“附件”里，请上传你需要展示的图片，不需要插入“内容文本框”中。
4. 在上传后，选择性添加图片描述：点击图片附件的“编辑”（铅笔状图标），进入图片信息的编辑页面，在右侧的“描述”里，输入你对这张图片的介绍，提交修改即可。
5. 在完成新增（图志）页面后，返回该页面的编辑页，在自定义字段区域，可用布局（瀑布流/时间轴）功能。
C 文章内容
一、创建「系列」文章（可选项）。
在文章编辑页的标题区域，选择性使用指定格式的前缀（如下），将这些文章聚合为系列，则该系列的每篇文章文末（Series）项将显示这些文章的标题信息。
#字符串：标题名称
其中，前缀为 #字符串：
其中，冒号可用全角也支持半角
示例：
#征途一夏：重返康区，续梦之行
#征途一夏：声声入耳，历历在目
#征途一夏：寻得一片，荒野花田
#视频：重庆，加载完成
#视频：2017，征途一夏
#视频：万里赴疆踩线路
#一季山河：对旅行的期待
#一季山河：旅行能催人思索
#一季山河：凡所际遇，绝非偶然
#一季山河：保持对未知的好奇心
二、给文内图片添加「描述」（可选项）。
在文章编辑器中插入图片后，使用字符 ·（中文输入状态下的 ~ 键）为前缀标记的图片描述，将在图片下方显示。
1) Markdown 语法插入图片时
2) 使用编辑器功能按键插入图片时
[·有前缀的图片描述会显示][5]
[无前缀的图片描述不显示][6]
[1]: 图片链接
[2]: 图片链接
三、在文内添加「图集」（可选项）。
在文章编辑器中使用 [fotos][/fotos] 包裹多张图片时，这些图片以图集的方式呈现。注意：[fotos][/fotos] 内禁止有空行，否则，会被 Typecho 自带的 AutoP 自动拆分为 <p></p> 段落，输出不如预期的内容。提示：可以在同一篇文章中，同时使用多个 [fotos][/fotos] 创建多个图集。
1) Markdown 语法插入图片时
[fotos]
[/fotos]
2) 使用编辑器功能按键插入图片时
[fotos]
[·有前缀的图片描述会显示][7]
[无前缀的图片描述不显示][8]
[/fotos]
[1]: 图片链接
[2]: 图片链接
四、创建「相册」（可选项）。
依照以上（在文内添加「图集」）的方式，可以在文章（或独立页）创建只包含图片的文章，即是相册。理论上，相册数量不限。
五、在文内添加「链接卡片」（可选项）。
在文章编辑器中使用 [links][/links] 包裹指定格式内容（如下）时，这些内容以链接卡片的方式呈现。提示：可以在同一篇文章中，同时使用多个 [links][/links] 创建多个分组链接卡片。
[links]
[卡片名称](卡片链接)(图标链接)
[/links]
其中，卡片名称必填。
示例：
[links]
[作者博客](http://www.lopwon.com)(http://www.lopwon.com/AppIcon.png)
[联系作者](mailto:lopwon@qq.com)(http://snapic.cn/demo/paper/usr/themes/SnapicPaper/usr/static/img/mail.png)
[订阅博客](http://www.lopwon.com/feed/)(http://snapic.cn/demo/paper/usr/themes/SnapicPaper/usr/static/img/rss.png)
[Typecho 相关](http://www.lopwon.com/store.html)(http://snapic.cn/demo/paper/usr/themes/SnapicPaper/usr/static/img/typecho.png)
[/links]
六、在文内添加「代码高亮」（可选项）。
使用连续三个 ``` 反引号 + 语言（如：html）开始，并以另外连续三个 ``` 反引号结束，如下：
```html
默认支持语言：css / js / php / markdown / html
反引号为：英文输入状态下的 ~ 键
```
七、在文内使用「文章章节」（可选项）。
在文内插入格式 <!--part 章节描述--> 即可自动生成文章章节列表，可快速定位到文内锚点：
这里是文章内容 A
<!--part 这里是章节 B 描述-->
这里是文章内容 B
<!--part 这里是章节 C 描述-->
这里是文章内容 C
说明：相对于常见的通过识别文内 h2 h3 等标题标签创建文章章节的方式，作者 Lopwon 使用了 Html 注释划分章节，好处是，不需要对每个章节绞尽脑汁的起标题，因为 Html 注释不会在文内渲染显示，也不会因为章节标题的存在，而破坏了文章的版式结构。
当然：文章章节，也可以作为类似标签卡片的功能，只不过是将标签卡由横向排列变为了纵向排列，以此，可以创建诸如时间轴、建站历程等文章或单页内容，演示：
http://snapic.cn/demo/paper/index.php/start-page.html
八、给文章添加「地点名称」（可选项）。
在文章编辑页面的自定义字段区域，选择性在（地点）项输入地点名称（如：昆明），则在该篇文章的标题下方显示。
九、给文章添加「授权信息」（可选项）。
在文章编辑页面的自定义字段区域，选择性在（授权）项自选授权信息，则在该篇文章的文末右下方显示。
十、给文章添加「背景音乐」（可选项）。
在需要添加背景音乐的文章新增自定义字段，字段名称填入 bgmUrl，乱填无效，字段值填入音频直链，支持格式如下：
.mp3/.ogg/.wav/.aac/.webm/.opus
提示：仅限带有以上后缀格式的音频直链，请勿使用存在跨域限制的链接。
十一、给文章指定评论「置顶」显示（可选项）。
在需要使用评论置顶的文章新增自定义字段，字段名称填入 pinCoid，乱填无效，字段值填入评论编码，如下：
· 仅限填入该篇文章下的评论 coid 编码；
· 仅限填入父级评论 coid 编码，该父级评论下的子级评论也会一并置顶显示；
· 仅限填入一个评论 coid 编码；
十二、给文章添加「地理位置」（可选项）。
在需要添加地理位置的文章新增自定义字段，字段名称填入 poiUrl，乱填无效，字段值填入地点链接，如下：
· 打开网页版百度地图或高德地图，搜索地点名称，在搜索结果里选择匹配的地点；
· 点击分享按键获取链接；
· 将链接录入字段 poiUrl 的字段值中；
D 侧栏导航
1. 侧栏导航默认显示 5 项独立页面和（还有）项。
2. 在后台》管理》独立页面，通过鼠标左键长按单行后上下拖放排序，放置在（最上方）的五行独立页面项，将在侧栏导航里显示。
3. 提示：心绪和索引不在侧栏导航里显示。
E 设置外观
后台》控制台》外观》设置外观，依喜好设置即可。
F 使用技巧
如何更换浏览器标签页的小图标？
替换 SnapicPaper/usr/static/img/ 文件夹的 favicon.ico 和 AppIcon.png 两张图标即可。
如何显示侧栏、索引滑窗中的小图标？
假设独立页（单页）的 cid = 2 那么请将诸如 cid-2.png 的图标放至 SnapicPaper/usr/static/img/ 文件夹中，即可。
提示：支持为分类（mid）、独立页（cid）和标签（mid）添加小图标，仅支持 png 格式的图片。
如何给羞羞图做模糊化处理？
此灵感来自 Quora 对色情、暴力、血腥等图片的模糊化处理，如下：
在插入图片后，在自定义图片描述时，只要包含字符（羞）则该图片初始做模糊化处理，当点击图片时，即可查看原图（演示：页面第二张图像）。
http://snapic.cn/demo/paper/index.php/archives/13/
如何使用 Glightbox 扩展功能？
主题 Snapic Paper 使用 Glightbox 灯箱系统展示图像，同时，也支持显示视频、内联、框架等，演示：
http://snapic.cn/demo/paper/index.php/archives/17/
如何优雅的对文章图文进行排版？
1. Typecho 默认换行输出 <br> 空一行输出 <p> 所以，行文本之间、图文之间等，建议使用空一行的方法划分为段落，也可以搭配分割线，将关联度高的图文进行分割，如：
这里是单图 A
这里间隔一行
这里是针对单图 A 的文本
这里间隔一行
这里是分割线
这里间隔一行
这里是单图 B
这里间隔一行
这里是针对单图 B 的文本
这里间隔一行
这里是分割线
这里间隔一行
这里是图集 C
这里间隔一行
这里是针对图集 C 的文本内容
2. 此外，可以通过 Markdown 语法对文本做样式和版式定义，以达到优雅排版的效果，以下为 Markdown 效果及书写方式：
http://snapic.cn/demo/paper/index.php/archives/18/
如何发布心绪？
1. 在按照以上（创建「心绪」页面）操作，且以博主身份登录博客后，打开心绪 mood 页面，正常操作发布评论即可。
2. 其中，评论框一侧的图像，来自心绪 mood 页面在后台所上传的最新一张图片附件，点击可快捷的将该图像插入评论框中。
2. 如需手动插入单张或多张图像，使用以下格式即可，插件 for Snapic Paper 会自动转换为支持延迟加载和灯箱看图的格式：
<img src="图像一链接">
<img src="图像二链接">
使用空行可对图文内容进行舒适的排版。
如何新增心绪表情包？
1. 将包含表情图标的文件夹（如 myEmoji ）放入插件 for Snapic Paper 的 mood 文件夹内，即可。
2. 重要：表情图标支持 .png .jpg .jpeg .gif .webp .svg 格式的图片，且文件名仅限使用包含：大小写字母、数字、短横线、下划线。
如何使用主题的备份配置功能？
1. 主题 Snapic Paper 使用 Cookie 存储配置（不涉及数据库）。
2. 当点击（备份配置，确认备份）且停用主题后，在再次启用主题时，会自动从浏览器 Cookie 中获取配置，并恢复。
特别鸣谢
主题 Snapic Paper 使用以下开源项目：
GLightbox Plyr Microtip Prism Google Fonts OpenMoji Pangu.js Exif.js