它来了!掘金编辑器主题开发贡献图文教程

简介: 它来了!掘金编辑器主题开发贡献图文教程

前言


国庆节写了一个新的编辑器主题也成功上线了也就是这篇文章的主题,评论区里很多小伙伴都说需要教程,今天就带来一个全流程图文教程。


简单说一下需要什么:

  1. Node.js
  2. Git
  3. 任意编辑器
  4. 一点点CSS基础+一点点审美+一点点模仿再创新的能力


image.png


创建项目



  1. 打开掘金官方的模板,点击绿色的 Use the template 按钮:


image.png

点击之后会让你新建一个仓库,命名尽量使用 juejin-markdown-theme-你的主题名,然后点击绿色的创建即可:


image.png


创建好之后,我们就可以用 git clone 或者编辑器的图形化界面来把项目克隆到本地:


image.png




image.png


第一步就完成了:

image.png


开始Coding



  1. 先修改 LICENSE,容易忘掉(json文件可以自己修改或者删掉,我是直接删掉了):


image.png


  1. 掘金给出了主题开发工具,可以在命令行输入:


cd <yourThemeProject>
npx juejin-theme-devtool <yourStyleFile>
复制代码


  1. 就像这样:

image.png

打开 http://localhost:3000 就可以修改同时预览了:


image.png


  • 然后就可以开始写代码了,可以使用CSS或SCSS,推荐使用SCSS(省事儿,还没有什么学习成本),可以在模板基础上一点点修改,也可以把别人的下载下来参考,比如mancuoj/Chinese-red
  • 找颜色,改样式,看预览三步循环🔥
  • 写完之后,觉得预览效果可以了,就可以推送到Github仓库了(不赘述了)。


image.png


提交PR



  1. fork一下掘金官方仓库,然后克隆到本地修改,或者直接网页中修改也行。


image.png


修改 theme.js,添加下列几项,其中 highlight 可省略,别忘了逗号:


image.png


ref 是你的主题仓库上传生成的 commit hash 值:


image.png


在 README.md 中添加你的大名,照着上面写就行了,仓库地址+掘金主页+MIT:


image.png

然后就可以提交pr了,打开你fork来的仓库点击 Pull requests:


image.png



直接合并到 main ,填写一下描述,就是新增了xx主题:


image.png


打开官方仓库就可以看到你的pr了:


image.png


需要通过一些自动的check来检验你的成果:


image.png


检测不成功会出现×,这时候你就需要对比其他通过的PR来修改了:

image.png

同时也可以点击 Details 来查看部署的结果:


image.png


修改 front-matter 就可以看到了


image.png


接下来就是等待大佬来 merge 了。


image.png



参考主题列表


参考主题 作者
juejin
smartblue Tusi
cyanosis 林小帅
少数派 (sspai.com)
typora-theme-misty etigerstudio
typora-theme-pie kevinzhao2233
typora-theme-ursine noatpad
My-Typora-Themes Theigrams
DrakeTyporaTheme liangjingkanji
typora-vue-theme blinkfox
hydrogen DawnLck
fancy xrr2016
Chinese-red Mancuoj


一些坑


  1. 开发工具预览PR中的预览实际上线后 的三个样式都会有一些细微差别,尽量使用px来作为单位,而不是rem或者em。
  2. 需要注意 行间代码代码框 的区别。
  3. 任务列表- [x] 语法需要格外注意,我就是前车之鉴。
  4. 表格样式以及在黑暗模式下的显示。
  5. 字体样式及大小。
  6. 提交PR后进行的修改,需要同步修改 commit hash
  7. 尽量要做到清爽,不要太花哨,考虑一下整体的兼容性,背景图片什么的能省则省。
  8. PR通过后,掘金线上编辑器是有这个主题了,但是文章没有效果,需要等官方发版,具体发版时间未知(我是中午可以在线上编辑器看到,晚上就能使用了)。
  9. 不能有外链,也不能使用特殊字体,背景图片必须是base64格式的。
  10. 提交PR的时候合并成单条commit记录,不建议连历史一起提交,我是第一次不懂,一直在修改,可以在同一个commit下提交。
  11. 还有一些想到再补充😊


总体还是挺简单的,希望大家多多贡献,也能让我有更多选择。

我是Mancuoj,如果还有什么疑问或者踩了什么坑可以评论留言,我都会回复的,求个赞👍

目录
相关文章
|
1月前
|
存储 搜索推荐 Shell
【Shell 命令集合 文本编辑器】Linux joe 编辑器的使用教程
【Shell 命令集合 文本编辑器】Linux joe 编辑器的使用教程
31 0
|
2月前
|
JSON 数据可视化 图形学
Graphix: 轻量级、可插拔、OOP 式图形编辑器开发引擎
A lightweight, pluggable, object-oriented programming (OOP) style graphic editor development engine / 一个轻量级、可插拔、OOP 式图形编辑器开发引擎
57 2
|
1月前
|
机器学习/深度学习 数据可视化 Unix
2023最全vim编辑器教程(详细、完整)-编辑器之神
2023最全vim编辑器教程(详细、完整)-编辑器之神
|
9月前
|
前端开发 JavaScript API
wangEditor富文本编辑器的调用开发实录(v5版本、获取HTML内容、上传图片、隐藏上传视频)
wangEditor富文本编辑器的调用开发实录(v5版本、获取HTML内容、上传图片、隐藏上传视频)
464 0
|
4月前
|
Linux 开发工具
百度搜索:蓝易云【Linux如何使用Nano编辑器教程。】
需要注意的是,Nano是一款轻量级的文本编辑器,适用于简单的编辑任务。如果你需要进行更复杂的编辑或编程任务,可能需要使用更强大的编辑器,如Vim或Emacs。
30 0
|
4月前
|
存储 前端开发 JavaScript
前后端分离模式开发的BS电子病历编辑器源码(Java)
前后端分离模式开发的BS电子病历编辑器源码(Java)
50 0
|
8月前
|
JavaScript
Vue富文本编辑器使用教程
Vue富文本编辑器使用教程
176 0
|
9月前
|
数据库
wangEditor富文本编辑器的调用开发实录2(V5版本自定义粘贴,去除复制word或网页html冗余样式代码的解决方案)
wangEditor富文本编辑器的调用开发实录2(V5版本自定义粘贴,去除复制word或网页html冗余样式代码的解决方案)
367 0
|
9月前
|
JSON 数据可视化 定位技术
GIS开发:Maputnik地图样式编辑器
GIS开发:Maputnik地图样式编辑器
365 0
|
9月前
|
Ubuntu Linux 开发工具
vim编辑器使用教程
vim 是 Linux 系统内置的「文本编辑器」,用于查看或编辑文件的内容,学会使用 vim 编辑器,将在 Linux 终端中畅通无阻。
895 0