本文会说两个话题,

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. Java生鲜电商平台-电商支付流程架构实战

    Java生鲜电商平台-电商支付流程架构实战 说明:我一直秉承的就是接地气的业务架构实战.我的文章都有一个这样的核心. 1. 业务场景 2. 解决问题. 3.代码实现. 4.代码重构. 5.总结与复盘. ...

  2. Define the Data Model and Set the Initial Data 定义数据模型并设置初始数据

    This topic describes how to define the business model and the business logic for WinForms and ASP.NE ...

  3. Hystrix失败处理逻辑解析

    在上篇文章Hystrix工作流程解析中,我们整体介绍了Hystrix的工作流程,知道了Hystrix会在下面四种情况下发生降级: 熔断器打开 线程池/信号量跑满 调用超时 调用失败 本篇文章则介绍一下 ...

  4. Json互相序列化对象

    using System.ServiceModel; using System.ServiceModel.Web; using System.Runtime.Serialization.Json; u ...

  5. JS基础语法---函数---介绍、定义、函数参数、返回值

    函数: 把一坨重复的代码封装,在需要的时候直接调用即可 函数的作用: 代码的重用 函数需要先定义,然后才能使用 函数名字:要遵循驼峰命名法 函数一旦重名,后面的会把前面的函数覆盖 Ctrl +鼠标左键 ...

  6. ms sql事务输出错误

    begin try 语句 end trybegin catch --ERROR_NUMBER() 返回错误号. --ERROR_SEVERITY() 返回严重性. --ERROR_STATE() 返回 ...

  7. 生成前N个自然数随机置换的3个程序

    问题描述: 假设需要生成前N个自然数的一个随机置换.例如,{4,3,1,5,2}和{3,1,4,2,5}就是合法的置换,但{5,4,1,2,1}却不是,因为数1出现两次而数3却没有.这个程序常常用于模 ...

  8. CodeForces - 1256D (贪心+思维)

    题意 给定一个长度为n的二进制串(即由n个'0'和'1'构成的字符串),你最多可以进行k次交换相邻两个字符的操作,求字典序最小的串. 思路 大致就是找0的位置,然后贪心的放到最前面,这样字典序会最小: ...

  9. show()和隐藏hide() slideDown()和 slideUp() fadeIn()和fadeOut()

    1==>显示show()和隐藏hide() 是一组动画 与切换toggle()$("div").show():当不传递参数时,没有动画效果,它将某个元素瞬间显示出来 $(&q ...

  10. vue+node+elementUI实现分页功能

    第1===>收集当前页码 和 每页显示条数 第2==>发送ajax请求页码 和 每页显示条数发送给后端 第3===>接收后端返回的数据总条数 total 和 当前页码的数据 data ...