Docusaurus 是 Faecbook 专门为开源项目开发者提供的一款易于维护的静态网站创建工具,使用 Markdown 即可更新网站。青小蛙实验了一下,构建一个带有主页、文档、API、帮助 以及博客页面的静态网站,真的没用上 5 分钟。@Appinn

来自微博好友 @Easy 同学的推荐:

FB 搞了一个专门给开源项目架网站用的 docusaurus ,用 Markdown 写,生成静态网站,可以发布到 GitHub pages。logo 还挺萌的。

说了只需要五分钟,那么来看一下怎么个 5 分钟大法:

首先,去 Vultr (此链接带返利) 开一台最便宜的 VPS,目前只有 5 刀款了,青小蛙幸运的开到了可用的日本服务器(Ubuntu)。

然后安装 npm,这里青小蛙走了弯路,因为 apt install npm 安装的版本过低,于是使用下面几句就可以更新到最新版本了:

npm install -g npm
npm install -g n
n stable
ln -sf /usr/local/n/versions/node/9.2.1/bin/node /usr/bin/node

然后,就可以安装 Docusaurus 了,其实官网有教程啦:

git clone https://github.com/facebook/Docusaurus.git
cd Docusaurus
npm install --global docusaurus-init
docusaurus-init

好了,已经装完了,配置一下,先用 demo 跑起来:

在 Docusaurus 目录下,将 docs-examples-from-docusaurus 改名 docs,进入 website 目录,将blog-examples-from-docusaurus 改名为 blog。

然后,在 website 目录中执行 npm start,Docusaurus 就会顺利的运行在 3000 端口了,直接访问 ip:3000,就能看到下面的页面了:

嗯,非常简单,所有内容由使用 markdown 书写的 .md 文档构成,修改起来也简单,同样官方提供了教程,比如修改 website/siteConfig.js 文件就可以更改标题、描述内容。

有开源项目,又懒得自己写主页的同学,可以去 Docusaurus  试试啦。

后记:青小蛙最终删掉了 Vultr 的测试机器,花费 0.02 刀,嗯。


©2017 青小蛙 for 小众软件 | 加入我们 | 投稿 | 订阅指南 | 反馈 | 代理(优惠码 Appinn)
b27c41ad47c2611d60d7452a4c02dd52
Site Meter

apppackge:

Related Posts

iOS

这不是段子,这不是段子,真是真游戏,TrapAdventure 2 让你生无可恋!

TrapAdventure 2 是一款变态游戏,很变态很变态,比养青蛙的佛系游戏变态多了,玩法简单,就是花样虐死你。@Appinn 这货不是超级马里奥,这货是你… 呃,青小蛙实在无法描述,还是来看视频吧: 事情是这样的,青小蛙在这里发现了这个变态游戏的视频,然后搬运到了微博上,最后在 @BIBibi_V 同学的帮助下,喜得 App Store 链接,并且还提到: 最骚的是,这游戏可以花 6 块钱解锁 normal mode 开发者在主页上只放了一张截图: 嗯,iOS 平台的同学可以去虐一下自己了,不想被虐去花 6 块钱吧 ©2017 青小蛙 for 小众软件 | 加入我们 | 投稿 | 订阅指南 | 反馈 | 代理(优惠码 Read more…

在线应用

Wallt.co -在同一个地方展示超过 1400 种数字货币的收款地址

Wallt.co 是一款极其简单的在线服务,它可以帮你记录并在公开网络种展示数字货币的收款地址,一共支持超过 1400 种数字货币。@Appinn 数字货币有一个非常不爽的地方,就在于其钱包地址没有任何创意,清一色的一串乱码。   至今 1000 多种货币,没有一个能改变这种现状,为什么这么多的开发者就没有考虑下美感呢?于是就有第三方服务决定稍微改变一下。 比如 Wallt.co,它仅仅是帮你把地址列在一起,就像上图这样,你可以将超过 1400 种数字货币放在上面,然后坐等收款 好像说的简单了点,但的确是这样的,数字货币并没有一个更好的收付款方式,以及清一色一个款式的钱包… 嗯,注册可用,非常简单,会得到一个 http://wallt.co/name 的地址。  wallt.co ©2017 青小蛙 for 小众软件 | 加入我们 | 投稿 | 订阅指南 | 反馈 | 代理(优惠码 Appinn) b27c41ad47c2611d60d7452a4c02dd52 apppackge:

Mac OS X

还有 25 天,文本编辑与比较工具 UltraEdit 和 UltraCompare 将取消中国特惠,这是你最后的机会

来自「数码荔枝」的消息,一直以来在中国以特惠价格 ¥119 和 ¥79 销售的 UltraEdit 和 UltraCompare 两款工具,即将在2月10日取消优惠,你还有还有 25 天的机会。@Appinn 以下为消息原文: UltraEdit 和 UltraCompare 均来自开发商 IDM Computer Solutions,前者是老牌强大的文本编辑工具,后者能够帮你轻松对比多个文件或文件夹之间的结构和内容差异。 「数码荔枝」一直以中国特惠价格 ¥119 和 ¥79 在销售 UltraEdit 和 UltraCompare。很遗憾,我们接到了开发商通知,这两款软件会在 2018.2.10 恢复官网原价 ¥599 和 ¥299。如果你对这两款老牌实用的工具感兴趣,这是你最后的机会特惠购入它们。 UltraEdit 作为一款老牌而久负盛名的编辑工具,UltraEdit 以全面的功能和强大的性能深受许多专业人士的喜爱。如果你也在找一款表现不俗的文本编辑工具,UltraEdit 会是一款不错的选择。 Read more…