00:00
那么呢,经过刚才这两个案例,大家可能发现啊,就是我每次去声明一个什么东西,或者说引入一个插件的时候呢,啊,就需要这个去写一套配置文件,然后呢,每个插件的配置呢,啊其实都不一样,你比如说这个process.convert。你就不可能把它用在输入组件里面是吧?呃,所以说呢,当我们要用到telegraph里面的组件的时候呢,我们要怎么才能知道它哪些配置,该怎么填呢?这个就必须借助于官方提供的这个文档。那么先打开我们的文档。在这个这一节。其实我们我给大家放了一个这个telegraph官方文档的一个链接。我们打开它,其实你可以看到呢,这是因拉斯蒂塔公司,它底下这个,你看这里可以选择它的产品,我们选择这个telegraph的文档,然后在右边呢,可以选择telegraph的版本,那么我们呢,啊,你看这个插件文档的时候也要注意啊,就是你要看哪个版本,你就点哪个版本,点这个版本之后呢,在左边有一个plug directory就是插件的目录,在这里就是我们的这个V 1.23这个版本,它底下所有支持的插件,呃,那么在这上面呢,这个呃,一进来这个地方呢,它其实是一个过滤器,就是在下面的话,其实我们可以看到所有的插件啊,是这样一一罗列出来的,那么一共300多个插件,你这样一个个看的是非常费劲的,你其实可以在这里面进行勾选,那么它呢,就会在底下只保留啊,你刚才选的这个输入插件,你比如说我现在点一下,我只想看这个聚合插件。
01:46
啊,那么也可以看到这些就被折叠了,现在剩下的呢,就只有这个聚合插件了啊,通过这种方式呢,我们可以快速的定位一些,就是过滤一些我们想看的这个插件的信息,那么找一下我们刚才呢,是选择了一个处理插件叫convert啊可以看到呢。
02:04
这是第二个convert,第二个这个信息卡片呢,就是我们关于convert的一个呃介绍,然后这个地方它会告诉你,呃,从telegraph哪个版本之后呢,是可以使用这个插件的啊,包括你这个配置文件的这个,呃,插件的ID应该怎么弄,然后包括底下一个最简单的介绍,那么最关键的是呢,我们要点击右边这个view按钮去看convert的详细用法。那么现在点过来。呃,那么可以看到呢,它其实是把我们导航到了这个,呃,Github上就是这个插件的一个read me文档。那么接下来呢,我们可以看到就是整个插件的一个解释,包括它的配置文件,这是它的一个示例,配置文件就包括整个配置文件,所有可配置的内容都在这里面罗列出来了啊,我们刚才呢,实际上只用到了一个啊这个tag完了之后没什么等于什么什么,其实呢,你可以看到这里面可以涉及到类型转换啊一些操作,包括对字段的一些操作,然后这里面呢,还有一个示例就是说呃。
03:12
当你用这个配置的时候,你出来的这个数据效果是什么?你比如说它这里面就是我们刚才说的这个convert.tags然后它这里面呢,是把这个portt这个tag转成了字符串,我们可以看它的效果,首先呢,就是原来的数据呢,实际上是在这里portt等于80,后来呢,转完之后成这样了,诶port等于加了个双引号80啊所以说呢,这里面的事例呢,就是告诉你啊,给你写几个最简单的例子,让你参考一下这个使用相应的这个呃配置之后这个数据会怎么样,帮助你更好的理解这个插件如何使用,呃所以说呢,呃,以后如果你想呃使用一个我们没有介绍过的插件,那么你可以在这里面先过滤一把,然后到底下找信息卡片,再点will去看它的详细。用法。
04:00
不过这个地方我们需要单独强调一下,就是为什么说让你看插件的时候呢,就是看T寡插件文档的时候呢,也要对应这个,呃T寡你正在使用的这个版本,我们可以看一下这个过往几期的这个他的寡PH文档,你会发现呢啊,刚才这里是221是吧,你再看二,呃1.23,你看它变成237,也就是说不同版本它对这个插件的支持能力是不同的啊这个主要是为什么呢?主要是因为啊我们的这个t graph呢,它是一个购员写的项目,那么构员写项目呢,有个特点啊,就是说它整个项目编译下来之后呢,呃,不像是我们说,呃,我们可以在像Java项目里面一样用这个呃JA包,然后放在一个路径下,然后做这个Java Java这个class pass是吧?它其实呢是呃,雇员是把整个项目,包括这个telegraph框架代码和这个插件代码全部放在一个项目底下,然后一块编译成一个telegraph的可执行文件,也就是说整个构言项目编译为一个总的文。
05:00
店啊,那么这样的话呢,这个框架代码就和差异代码都编译在一块了,于是呢,就是不同的这个telegraph版本呢,实际上它啊,只能用它编译时的那些存在的插件啊,所以说呢,你越往后呢,这个插件越多啊,但是呢,你要是看相应的这个呃插件文档的时候呢,还必须得和你telegraph的版本保持一致。那么最后呢,除了这个官方的文档,其实我们还可以用telegraph命令呢,来查看一些帮助性的信息。嗯,我们还是去自己的那个配置的目录底下,嗯,其实这个telegraph命令呢,它有一个有一个这个。啊,Config这个选项,你可以敲这个,然后敲这个之后呢,呃,它打印出来的这么长一大串呢,实际上是呃当前这个telegraph里面的所有的呃参考就是视力配置,那么这个视力配置呢,实际上会按照这个开发规规范哈,就社区的规范,呃他每一个配置呢,他都会给出一个这个嗯可以参考的一个注释啊,解释性的注释,那么你可以根据这个注释呢,来粗来这个粗略的了解一下,就是每一个选项是干什么用的,你该怎么配,呃那么这个东西呢,你输到控制台肯定不方便看,你可以把这个呃,Conflict。
06:20
来重定向到一个呃文件里面,然后呢,通过这个编辑器。是吧,你就可以在这里面啊,你去正则匹配啊,匹配一些这个你想用的这个convert啊。是吧,你就可以快速的找到你想用的这个插件的一个,呃,参考的配置,而且呢,这里面的这个注释已经告诉你了啊,每一个选项它有什么用,可以怎么配,当然呢,还是不如这个官方文档更加详细。
我来说两句