本文会说两个话题,

1,如何将 Github 上的文档(如:dotnet-campus/doraemon-pocket: 哆啦A梦的口袋 - 收集效率工具与站点)发布到语雀。

2,如何在本地使用 Markdown 编辑博客,再推送到博客园。
在我使用的方案中,这两者都使用到了 MWeb 这个 Markdown 编辑器,所以就放在一起啦。
这篇博客就是在本地编辑,然后使用 MWeb 推送到博客园的。

废话

  • 为什么将 Github 上的文档放在语雀上?

为了更好地阅读体验,还可以有评论等互动。不失为一种自由(可以本地编辑 Markdown,不一定要使用在线编辑工具)而且方便(不用搭建静态博客,如使用 hexo 等。)的文档/博客发布方式。当然,如何你想搭建个人站点,可以折腾更多的内容,那随意啦。

  • 语雀是什么?

阿里巴巴的一个文档平台,详情请点击:语雀 - 专业的云端知识库;一共有四个层级:空间-团队-知识库-文档。
其中空间属于收费项目,一般是企业使用,个人或小团队使用,后面三项足够。

  • 为什么是 MWeb?

因为 MWeb 可以推送文章到语雀(这也是在语雀的文档中发现的),后来发现也可以推送到博客园。但 MWeb 仅限苹果的平台(macOS + iPadOS + iOS),且收费(¥128)。如果有相应 Windows 平台的软件,留言告诉我。

MWeb发布到博客园配置 - 狸猫酱 - 博客园
Mac下如何使用MWEB发布博客到博客园 - 佳佳牛 - 博客园

如何操作与注意事项

其实操作很简单,不过有些小点,新手可能会遇到一点点问题。

  • MWeb 的设置

在 MWeb 偏好设置 - 发布服务中,添加语雀和博客园的相关设置即可,博客园的设置,在上方有链接。

另外,MWeb 默认是在线文档库的形式启动,如果想加载本地 Markdown 文件,需要打开本地模式,使用 Command + E 可以切换,也可以在 偏好设置 - 通用设置 中,设置在启动时,默认以本地模式启动。

  • 发布

编辑 Markdown 可以使用任何趁手的工具,当然也可以直接用 MWeb 。
编辑完成之后,点击右上角的分享/发布按钮,选择发布到语雀,设置好标题,需要发布到的知识库即可。记得现在语雀上新建知识库,知识库类似于一个专栏或文件夹,用于给文档分类的,你可以新建很多知识库,存放不同类型的文档。

  • 图片外链

如果你的 Github 中使用的图片(包括其他文件链接)使用的就是完整的外链,那发布到语雀上,就可以直接打开,如果图片是相对路径,在需要先将图片放到图床上。
现在 MWeb 上设置好图床,在发布文档之前,点击分享/发布按钮, 选择“将本地图片上传至图床...” 。然后复制新的文章,在发布,使用 MWeb 发布文章到博客园时也是如此。

另外,图片记得先压缩。
macOS上图片压缩软件 ImageOptim - Mac知道

应该就这些。

参考链接:

博文与文档发布玩法:Github + MWeb + 语雀 + Cnbolgs的更多相关文章

  1. 使用dumi生成react组件库文档并发布到github pages

    周末两天玩了下号称西湖区东半球最牛逼的react文档站点生成工具dumi,顺带结合github pages生成了react-uni-comps文档站, 一套弄下来,感觉真香,现在还只是浅尝,高级的特性 ...

  2. 把 MWeb Lite 的文档库文档和数据搬到 MWeb 正式版中

    MWeb Lite 版的文档库中的文档要搬到 MWeb 正式版中,如果 Lite 版的文档中没有图片或者只有少量图片,可以用导入导出为 Markdown 的方法. 否则的话请用以下方式(注意下面这个方 ...

  3. showdoc 文档管理系统

    ==========================showdoc 简介==========================在线文档管理系统很多, 比如阿里的语雀.腾讯的 TAPD 平台也包括文档管理 ...

  4. 为什么不使用github的wiki而是使用mkdocs做文档管理?

    为什么不使用github的wiki而是使用mkdocs做文档管理? 目前 KSFramework 是使用mkdocs来做在线文档 而非使用github的wiki,这是为什么呢? 在windows下搭建 ...

  5. 使用ghpage(github服务)搭建文档网站几种方式

    可以通过github提供的ghpage服务来搭建网站,有以下三种方式来实现: 1.文档放在master分支,作为一个子目录. 仓库:https://github.com/Ourpalm/ILRunti ...

  6. 【毕业设计】基于Android的家校互动平台开发(内含完整代码和所有文档)——爱吖校推(你关注的,我们才推)

    ☆ 写在前面 之前答应大家的毕业答辩之后把所有文档贡献出来,现在答辩已过,LZ信守承诺,把所有文档开源到了GitHub(这个地址包含所有的代码和文档以及PPT,外层为简单的代码).还望喜欢的朋友们,不 ...

  7. 微软开源全新的文档生成工具DocFX

    微软放弃Sandcastle有些年头了,微软最近开源了全新的文档生成工具DocFX,目前支持C#和VB,类似JSDoc或Sphinx,可以从源代码中提取注释生成文档之外,而且还有语法支持你加入其他的文 ...

  8. .NET操作RabbitMQ组件EasyNetQ使用中文简版文档。

    本文出自EasyNetQ官方文档,内容为自己理解加翻译.文档地址:https://github.com/EasyNetQ/EasyNetQ/wiki/Quick-Start EasyNetQ简介 Ea ...

  9. Python爬虫、自动化常用库&帮助文档URL

    一.Python下载地址 Windows终端Cmder.exe下载--->http://cmder.net/ Python下载(Windows)        ---> https://w ...

随机推荐

  1. 「SAP技术」SAP MM 事务代码ME17的用法

    SAP MM 事务代码ME17的用法 1,如下采购信息记录需要被归档: PIR号码,5300007816   2, ME12打上删除标记,   3, 事务代码ME17做归档 3.1 创建archive ...

  2. Kotlin介绍(非原创)

    文章大纲 一.Kotlin简介二.Kotlin相比Java优势三.Kotlin与Java混合使用四.参考文章   一.Kotlin简介 1. 什么是Kotlin 安卓和Java,前者是最受欢迎的移动开 ...

  3. express 将 Router 实例模块化

    为了更好的组织代码,将 Router 实例进行模块化,将 get / post 等快捷方式放在Router上,而不是 App 上,然后将该 Router 作为中间件,use 到 server.js 上 ...

  4. Linux的启动过程的分析

    Linux的启动过程 Linux系统从启动大哦提供服务的基本过程为:首先机器家电,然后通过MBR或者UEFI装载GRUB,再启动内核,再由内核启动服务,最后开始对外服务 CentOS7要经历四个主要阶 ...

  5. java.sql.SQLException: Incorrect string value: '\xF0\x9F\x98\x8E' for column 'name' at row 1

    我的错误案例: ,这个后台插不进去,就姓名那栏的中文编码问题. 遇到这个错误,应该是创建表的时候没有设置好编码,这个错误不用多想,我也试过在更改表那里设置编码,但还是不行,还是有残留 直接drop t ...

  6. 04-align-content 它对于当单行是没有效果的

    /* 运用在父级元素上  align-content:   它通产与子元素的div{margin:10px 一起联合使用 }*/ ps==>用在子项出现换行的情况下,并是多行的情况下哦.运用在子 ...

  7. 经典损失函数:交叉熵(附tensorflow)

    每次都是看了就忘,看了就忘,从今天开始,细节开始,推一遍交叉熵. 我的第一篇CSDN,献给你们(有错欢迎指出啊). 一.什么是交叉熵 交叉熵是一个信息论中的概念,它原来是用来估算平均编码长度的.给定两 ...

  8. lua 9 parttern 字符极其简要的介绍

    摘自:https://www.lua.org/pil/20.2.html 所有的字符和含义包括: . all characters %a letters %c control characters % ...

  9. luoguP3346 [ZJOI2015]诸神眷顾的幻想乡

    题意 学习了广义后缀自动机. 广义后缀自动机与普通后缀自动机的区别在于它是对多个串建的,于是可以处理多个串. 广义后缀自动机和普通后缀自动机的区别在于两个特判,可以见这篇题解 对于这题,因为叶子数量小 ...

  10. select使用css居右对齐

    select{ direction: rtl; } 下面的方法无效 select{ text-align: right; }