本文会说两个话题,

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. 干货:Wireshark使用技巧-显示规则

    - 显示规则使用 在Wireshark界面对已经抓取的报文在界面的显示进行控制的规则,称为显示规则,显示规则只是让一部分不符合规则的报文不被显示,但未被丢弃,这些报文仍然存在在Wireshark的系统 ...

  2. 记录C#-WPF线程中如何修改值

    new Thread(() => { Application.Current.Dispatcher.BeginInvoke(DispatcherPriority.Normal, new Acti ...

  3. Git的使用(2)

    一.git在不同平台下的安装 (1)在linux上安装 如果以centos为例,可以使用yum安装,如下命令: sudo yum install git 如果你在基于debian的发行版上,尝试使用: ...

  4. [PHP] Ubuntu快速安装起PHP7.4

    先安装一下这个命令 add-apt-repositoryapt-get install software-properties-common 添加第三方源:add-apt-repository ppa ...

  5. Wireshark抓包笔录--之指定IP地址筛选捕获结果

    Wireshark安装 1.去官网下载相应的安装包 地址如下:https://www.wireshark.org/ 2.安装步骤,一路next,需要同意的地方点同意 3.安装完成后打开软件,如下: W ...

  6. 【洛谷P4589】[TJOI2018]智力竞赛(二分+最小链覆盖)

    洛谷 题意: 给出一个\(DAG\),现在要选出\(n+1\)条可相交的链来覆盖,最终使得未被覆盖的点集中,权值最小的点的权值最大. 思路: 显然最终的答案具有单调性,故直接二分答案来判断: 直接将小 ...

  7. UML图示样例

  8. TestNG参数化测试之Excel读取数据

    1.新建Excel文档,准备好测试数据 在当前工程的resources目录下,新建文件名为testdata的Excel文档 打开Excel,将当前sheet重命名为calculator,构造num1. ...

  9. 2019.6.11_MySQL进阶一:索引

    所谓索引就是为特定的mysql字段进行一些特定的算法排序,比如二叉树的算法和哈希算法,哈希算法是通过建立特征值,然后根据特征值来快速查找.MySQL索引的建立对于MySQL的高效运行是很重要的,索引可 ...

  10. Vue.js面试整理

    Vue项目结构介绍 build 文件夹:用于存放 webpack 相关配置和脚本. config 文件夹:主要存放配置文件,比如配置开发环境的端口号.开启热加载或开启gzip压缩等. dist 文件夹 ...