noob-core

功能

这是一个思源笔记的"大型"代码片段.

主要功能是对你的笔记中的代码片段进行管理|分发等等.

同时也为一些特殊的代码片段(服务和插件)提供了一些简单的接口和依赖支持.

核心插件pluginsInNote能够将笔记内代码作为插件安装,方便通过社区发帖的方式来交流和分发思源的扩展代码。

安装方式

使用noobInstaller进行安装

noobInstaller是一个小安装工具,分为主题版和插件版.

主题版的installer主要是供主题作者使用.

主题作者可以通过它自动拉取noob核心代码并安装.

方法是将noobInstaller放置于主题文件夹内,然后通过import的方式进行引入.

直接内置于主题中

需要将noobcore文件夹（包括npm install之后的node_modules）放置到主题文件目录，

并且在theme.js中通过import('./noobcore/index.js')引入。

这会在用户的snippets中也有noobcore时造成一些问题，不建议使用这种方式安装。

一些约定

命名

noob的插件应该以noob-plugin-<插件名字>的形式作为包名，便于大家直接通过npmjs.org搜索插件和查看插件的说明等。

屏蔽

有非常严重隐患或者恶意的代码包将会被列入noob-bazzar包中，noob并不会阻止用户加载这些插件包，仅仅作为提醒使用。

安全性

noob默认用户知道自己安装的所有内容能够用来做什么。

如果这不够明确的话，这些内容的能力包括：

1. 删除你的笔记或者向你的笔记中添加你并不知情也并不一定喜爱的内容.

2. 删除你设备上的其他文件(这包括一些系统文件),或者添加一些其他文件.

3. 将你的笔记内容或者设备上的其他内容发送给你没有授权可以获取它们的人.

4. 浪费你的精力在挑选一些看起来很花哨的功能上而放弃了对你来说真正重要的东西.

作者没有能力审核来自社区提交的插件源代码仓库内容,所以你要谨记这些内容可能造成的后果,在运行其他人分发给你的代码之前, 一定记得这代表着你对他某种程度上的信任。

noob不会自动启用新安装的插件或者服务，你必须手动启用它们。