怎样写文章pdf 【bilibili专栏 × Markdown】撰写B站专栏的新方式
前言
哔哩哔哩()专栏功能上线已经好一段时间了,本抱持观望态度的UP也开始尝试着拣一些个人博客上的文章发布到B站专栏上。尝试过几次之后,UP个人感受:B站专栏的富文本编辑器实在是又坑又难用...
虽说富文本编辑器所见即所得()的特性使得编辑器的使用门槛可以变得非常的低,也足够满足基本的文章排版润色需求,但对于科技写作而言,UP个人还是更加偏爱或类似的文本标记语言,也非常推崇结构与样式分离这一理念。
可惜的是,B站专栏文章并不支持书写,短期来看也没有要支持的意向...这应该也是很多小伙伴苦恼的地方吧。
既然人家不支持,那我们就亲自动手,写个凑合能用的解决方案呗。UP花了大概两天的时间,写出来个小玩具,基本能用,也算是解决了使用撰写B站专栏文章这一需求吧。
图: 撰写B站专栏的新方式
如果你对结构与样式分离的写作理念有所认同,或者也想尝试使用撰写B站专栏文章,那么请继续往下看吧。
---tool
这是一款可以让你使用撰写哔哩哔哩()专栏文章的外部辅助工具。
长长的名字看着可能有点奇怪(UP不会起名字...),但无关紧要,下文都将使用"此工具"指代。
以下篇幅,UP将教大家如何使用此工具。
使用流程
开始实例讲解之前,我们先简要梳理一下此工具的使用流程。
本机安装Node.js环境。
获取项目源码,使用npm 安装项目依赖。
前往哔哩哔哩()专栏投稿区,建立一篇专栏文章草稿。
取得文章aid与页面,写配置文件。
使用写作。
运行node src/cli.js [] []提交文章至B站专栏。
如果你一眼就看明白了上述流程,大概你也是一位开发者吧:)
实例讲解
我们通过一个实例,一步接一步,详细地教你应该如何使用此工具。
步骤1 - Node.js 安装与配置
此工具使用Node.js写成,所以要想使用它,你需要先在本机上安装好Node.js环境。下详细的安装流程,请参看这篇教程,UP就不写了。
这是外部超链接(B站专栏目前好像不让写外链的说)
步骤2 - 获取项目源码并安装依赖
这是项目地址,如何获取项目源代码,安装项目依赖。UP也不多做赘述,请利用搜索引擎自行完成。
获取上的项目源码,我们可以使用git,也可以直接下载zip压缩包。对于Node.js项目,我们一般使用npm 来安装项目依赖。
步骤3 - 建立专栏文章草稿
再完成了上述两步后,你的计算机上应该有了能正常运行的Node.js,以及此工具的源码包。以上两步都是常规动作,我们来讲解步骤3。
图: 建立专栏文章草稿
我们先前往哔哩哔哩()专栏投稿区,建立一篇专栏文章草稿。键入任意文章标题均可,这里文章标题并不重要,可以随意写(但不写不行,不写标题无法存草稿),我们的目的只是让一篇专栏文章成功保存草稿(即: 在B站服务器留下**)。如果你不确定是否成功保存,可以点击专栏编辑区下方的存草稿按钮。
图: 存专栏文章草稿步骤4 - 获取目标参数并写入配置文件
这是是至关重要的一步。我们需要手动取得两枚关键参数,aid与,再把它们写入配置文件。其中,aid是专栏文章的标识号,是用户个人身份认证信息。只有正确取得这两枚关键参数,此工具才可与B站专栏服务器正常交互。
获取这两枚参数的方式都非常简单,aid在浏览器地址栏的URL参数上就已经写明,而则可以使用浏览器开发者工具取得。
图: 获取关键参数 aid
图: 获取关键参数
接下来,我们将这两枚关键参数组合写入到一个.json格式的配置文件中,配置文件的名字可以随意取。为了方便起见,UP这里将配置文件命名为.json。
图: 组合参数写配置文件步骤5 - 写作
至此,所有预备工作均已完成。现在,我们就可以告别B站专栏富文本编辑器,转而使用撰写文章了。拿起你最钟爱的一支编辑器,愉快地写文章吧!
图: 使用写作
顺带一提,UP个人最钟爱的编辑器是Vim 🙂
步骤6 - 命令提交
最后,我们来将这篇格式的文章变身成为B站专栏文章。此工具正是帮助你完成这项任务的。我们通过运行如下命令来提交文章,请将你的文章与配置文件一并输入,注意先后顺序。如果命令没有报错,那说明提交成功。
node src/cli.js [] []
这时候,我们再回到B站专栏草稿箱看一看,你会惊讶地发现,你写的文章已经变身成为B站专栏文章,排版、样式丝毫不差,正静静地躺在专栏草稿箱之中,专栏文章的大标题正是文件名。
图: 变身成为专栏文章
预览文章,添加头图,选择分类,写专栏推荐语,这些都是文章发布前的要做的准备工作。自己完成后就可以提请发布文章啦。
(注意事项)
相信你用过几遍此工具后,就非常得心应手了。但有一些注意事项你一定要知悉。
不支持的语法
目前,B站专栏所能提供的功能选项还非常有限,甚至连基本语法标准都无法达到完全支持。对于下列功能选项(有些是常用选项),B站专栏目前还无法提供支持。对于扩展功能,更是没有可能。
所以,如果你考虑将文章发布到B站专栏上时,请谨慎使用上述语法格式,并考虑替代方案(如: 使用图片替换表格,代码块)。
专有功能
另外,B站也针对自家的专栏添加了一些专有功能选项,这些选项大多含有B站专栏的特色。
但是,这些功能选项大多没有合适的语法与之对应,只能通过内联HTML实现。
如果你分析过B站专栏的文章结构,你会发现,这些专有功能大多是通过class样式 + 行内css样式实现的,不具备可移植性,也不符合结构与样式分离的原则。UP个人对B站专栏专有功能的看法是:花哨且不实用。
所以,此工具并不对这些专有功能提供支持。
当然,如果你想为你的文章添加专有功能,完全可以在使用此工具提交文章后回到B站专栏富文本编辑器中手动修改。
参考资料