update at 2025-09-25 22:35:01
This commit is contained in:
70
README.md
70
README.md
@@ -6,11 +6,50 @@
|
||||
>
|
||||
> 注意:如果修改过主题文件请做备份后再操作。
|
||||
|
||||
完整历史变更请查看: [CHANGELOG](./CHANGELOG.md)
|
||||
|
||||
## 1、简介
|
||||
|
||||
这是一个Obsidian插件,针对微信公众号编缉器进行了优化,通过本插件复制笔记可以把笔记样式同步到公众号编缉器,轻轻松松搞定文章格式,一劳永逸,而且支持代码高亮、代码行数显示、主题背景颜色等。针对微信公众号不能放链接也专门处理了,提供直接展示链接地址和文末脚注展示两种方式。本项目初衷仅是为了能够将Obsidian中笔记的样式完美同步到微信公众号的编辑器中,因此项目重点在于保证文章格式的一致性,而不是成为一个微信公众号编辑器。
|
||||
|
||||

|
||||
### 图片方向自动处理
|
||||
|
||||
为了优化微信公众号图片上传体验,插件新增了 EXIF 方向自动处理功能:
|
||||
|
||||
**功能说明:**
|
||||
- 自动检测 JPEG 图片的 EXIF Orientation 信息
|
||||
- 对存在方向问题的图片自动旋转并转换为 PNG 格式
|
||||
- 确保上传到微信公众号的图片显示方向正确
|
||||
|
||||
**支持的方向类型:**
|
||||
- `Orientation=1`:正常方向(无需处理)
|
||||
- `Orientation=3`:需旋转 180°
|
||||
- `Orientation=6`:需顺时针旋转 90°(右旋 90°)
|
||||
- `Orientation=8`:需逆时针旋转 90°(左旋 90°)
|
||||
|
||||
**处理流程:**
|
||||
1. 检测图片文件类型(仅处理 JPEG/JPG 格式)
|
||||
2. 读取 EXIF 方向信息
|
||||
3. 如有方向问题,使用 Canvas 进行旋转处理
|
||||
4. 将处理后的图片转换为 PNG 格式上传
|
||||
|
||||
**用户体验:**
|
||||
- 本地 Obsidian 中显示正常的图片,上传到公众号后也会保持正确方向
|
||||
- 自动处理,无需用户手动调整
|
||||
- 转换为 PNG 格式可避免 EXIF 信息导致的显示问题
|
||||
|
||||
### 调试日志
|
||||
|
||||
在控制台(开发者工具)可看到:
|
||||
```
|
||||
[note2mp] active file path: your/file/path.md
|
||||
[note2mp] use default cover: cover.png -> ![[cover.png]]
|
||||
[note2mp] EXIF orientation detected: 6
|
||||
[note2mp] Image converted to PNG with rotation
|
||||
```
|
||||
路径日志做了节流:同一文件 3 秒内不重复打印。后续可加"调试开关"以完全关闭。
|
||||
|
||||
### 摘要、封面裁剪、原文链接等ges/screenshot.png)
|
||||
|
||||
## 2、安装
|
||||
首先,**请确认已关闭了Obsidian的安全模式**。如未关闭,请通过**设置——第三方插件——关闭安全模式**关闭。
|
||||
@@ -315,12 +354,30 @@ https://www.bilibili.com/video/BV15XWVeEEJa/
|
||||
![[002.jpg]]
|
||||
```
|
||||
|
||||
可选参数新增:
|
||||
|
||||
`mppickall=1` 选取目录中所有图片(忽略“Gallery 选取图片数”限制);`mppickall=0` 或缺省时按配置的数量限制。支持写法:`mppickall=1`、`mppickall='1'`、`mppickall="1"`(0 同理)。
|
||||
|
||||
示例:
|
||||
|
||||
```
|
||||
{{<gallery dir="/img/guanzhan/1" mppickall=1/>}}{{<load-photoswipe>}}
|
||||
```
|
||||
|
||||
或属性顺序不同、带 figcaption:
|
||||
|
||||
```
|
||||
{{<gallery dir="/img/guanzhan/1" figcaption="毕业展" mppickall=1/>}}{{<load-photoswipe>}}
|
||||
```
|
||||
|
||||
在 `mppickall=1` 情况下,仍保持文件名排序(同原逻辑)。
|
||||
|
||||
配置项:
|
||||
|
||||
- Gallery 根路径(galleryPrePath):指向本地实际图片根目录,用于拼接短代码中的 dir 得到真实磁盘路径。
|
||||
- Gallery 选取图片数(galleryNumPic):每个 gallery 最多展开前 N 张图片(按文件名排序)。
|
||||
|
||||
可在插件设置界面直接修改,无需重启。若希望随机选取或按时间排序,可后续在 issue 中反馈需求。
|
||||
可在插件设置界面直接修改,无需重启。若希望随机选取或按时间排序,可后续在 issue 中反馈需求。若需要永久“全部图片”效果,可同时将“选取图片数”设为一个足够大的值,或在需要的单个 gallery 上使用 `mppickall=1` 精确控制。
|
||||
|
||||
### Gallery 块与 figure 支持
|
||||
|
||||
@@ -379,15 +436,6 @@ https://www.bilibili.com/video/BV15XWVeEEJa/
|
||||
|
||||
避免因为缓存未就绪导致标题/作者缺失。若需复杂 YAML(数组、多行字符串)建议等待官方缓存,或后续考虑引入完整 YAML 解析库。
|
||||
|
||||
### 调试日志
|
||||
|
||||
在控制台(开发者工具)可看到:
|
||||
```
|
||||
[note2mp] active file path: your/file/path.md
|
||||
[note2mp] use default cover: cover.png -> ![[cover.png]]
|
||||
```
|
||||
路径日志做了节流:同一文件 3 秒内不重复打印。后续可加“调试开关”以完全关闭。
|
||||
|
||||
### 摘要、封面裁剪、原文链接等
|
||||
```yaml
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user