专家设置指南

Tip

NoteToMP v1.3.0版本新增了专家设置功能，用于对插件进行一些深度配置。⚠️专家设置如果配置错误可能会引发异常，务必详细阅读本指南后再进行设置。

1、什么是专家设置

专家设置主要为了解决部分“专家”用户的深度定制需求，比如定义标题的渲染HTML实现特殊的样式效果，或者根据自己笔记系统定义部分属性，实现文章标题、作者的配置等。

2、如何使用专家设置

新建一篇笔记，如专家设置，然后通过将专家设置填入到NoteToMP设置——专家笔记设置中。

3、详细设置选项

专家设置采用YAML格式，不能使用Tab缩进，只能使用空格缩进。如遇到“读取专家设置失败”的提示，请检查配置中是否使用了Tab缩进。对于aliases这种列表类型的属性，会取列表中的第一个值。

自定义渲染

支持将一级标题、二级标题、三级标题、代码块、标注等直接渲染为小部件，也可以自定义一级标题、二级标题、三级标题的渲染HTML。使用该功能就需要手动插入小部件了，可以简化笔记排版，且保持笔记在Obsdian中的可读性。

文档属性重映射

通过文档属性可以在发草稿的同时设置文章的标题、作者、摘要、原文地址、封面、封面裁剪、打开评论等选项，提升文章发布效率。原来的文档属性使用的是中文，但有部分用户反馈，他们的笔记系统不会为笔记设置有意义的文件名，而是使用文档属性title来设置笔记标题，这样在使用插件的时候还需要单独设置标题等。现在可以通过文档属性重映射来安装自己的笔记体系设置相关属性名，简化发布。

来看一下完整的配置示例：

render: 
  h1: <h1><span>✨</span><span>{content}</span></h1>
  h2:  
    id: 1066
    counter: true
    len: 2
    style:
      text-color: "#FF0000"
  h3: 1004
  code: 5001
  callout:
    tldr: 6123
    note:
      id: 6124
      style:
        text-color: "#FF0000"
   
frontmatter:  
  title: title
  author: author
  digest: 摘要
  content_source_url: 原文地址
  cover: cover
  thumb_media_id: 封面素材ID
  need_open_comment: 打开评论
  only_fans_can_comment: 仅粉丝可评论
  appid: 公众号
  theme: 样式
  highlight: 代码高亮
  crop: 封面裁剪

我们来逐行看一下配置的具体含义

• 第1行，render是自定义渲染相关的配置；
• 第2行，定义了一级标题的渲染html，这段html为标题内容前增加了一个emoji表情✨，其中的{content}表示Markdown中标题实际内容。有一定html基础的用户可以使用该功能定义自己喜欢的标题风格；
• 第3~8行，将二级标题映射为1066号小部件，因为1066号小部件是序号+文字标题的形式，所以第5行counter表示启用计数，第6行的len表示数字序号的长度，这里是2位，即会将序号1补全为01。第7〜8行是对小部件的样式进行自定义，关于小部件样式自定义可以参考：小部件样式自定义指南 ；
• 第9行，将三级标题映射为1004号小部件，这是简化写法，适用于不需要额外定义且不带数字序号的标题小部件；
• 第10行，将代码块映射为5001号小部件即苹果风格代码的小部件；
• 第11~16行，是将标注映射为卡片类型小部件（注意：目前只能使用卡片类型小部件）。其中第12行是将tldr类型的标注映射为6123号小部件。第13〜16行是将note类型标注映射为6124号小部件，且使用style定义了文字颜色；
• 第18〜30行，是文档属性重映射配置，示例中主要是将标题的文档属性改为title（第19行）作者的文档属性改为author（第20行），封面的文档属性改为cover（第23行）；

Tip

每个小部件都有一个ID，在插入小部件后会有类似> [#1024] 内容，其中1024就表示1024号小部件。

Tip

如果使用苹果风格代码块，建议将代码高亮主题设置为深色主题。

4、配置实战

下面来以实际需求为例，展示具体的配置内容。

实战1

我希望将二级标题渲染为1038号小部件，将Obsidian中Note类型的标注映射为6130号小部件，那么配置文件如下：

render: 
  h2: 1038
  callout: 
    note: 6130

效果如下：

实战2

我希望将二级标题渲染为1038号小部件，然后将代码块渲染为苹果风格代码块，并且我希望将文档属性中的aliases字段作为文章标题，那么最终的配置文件如下：

render: 
  h2: 1038
  code: 5001
 
frontmatter:  
  title: aliases

是不是非常简单？ 配置文件为YAML语法，推荐在专家配置笔记中使用代码块插入。

如有问题可联系微信：Genius35Plus