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

Apple Watch

Cloudy – 带漂亮动画的天气预报应用,Dark Sky 源[iPad/iPhone]

Cloudy 是一款新鲜的天气预报应用,拥有漂亮的动画,以及精确到分钟级别的预报。高级版本可以解锁 Apple Watch、恶略天气警报。@Appinn 作为刚需应用,天气预报拥有数量巨大的应用,不过天气源都集中在几个,而 Dark Sky 拥有自己的源并且慢慢发展起来,也是青小蛙没料到的 不过由于竞争激烈,现在的天气预报应用也越来越漂亮了,毕竟数据方便已经被垄断的差不多了。 Cloudy 的温度动画很赞,来看视频:   Cloudy 还拥有温度地图、降雨量地图、风速地图、云彩地图。 另外,由于地图使用了 Google Maps,似乎需要科学一下才能使用。 相关阅读 像素天气 – 8 位像素风格,天气预报届「皮肤」已经是最大卖点了 [iPad/iPhone] @Leo& : 自用精品 App 整理与推荐 iOS 版 一次玩个够,43 款喵星人游戏 2015 年度 Play 最佳游戏.第二部分[Android] Read more…

Worktile

Worktile憋了个大招?7.0 内测正式启动

最近一段时间,很多人提出 Worktile 为啥有一段时间没有更新了。 虽然七八月的阳光很好,海滨风光也很诱人,但其实 Worktile 的程序员哥哥们并没有去度假。 实际上他们一直在公司——苦逼的加班。 Worktile 最近没有更新的原因是——正在酝酿一次史无前例的巨大改版! 话不多说,先放个局部对比图: Worktile 深耕企业协作领域五年有余,自始至终都面临这样一个问题 —— 如何通过标准化的产品适应客户复杂多样的业务场景? 众所周知,在企业协作的过程中,各部门处理的事务不尽相同 —— 销售面对的是客户、财务面临的是各种报表。事务不同,代表着每一个任务的类型、属性将会完全不同;与此同时,任务的流转、状态以及视图等都有差别。 在过去,不只是 Worktile,而是全行业都通过任务看板去解决不同的项目类型。这就导致,有的部门觉得产品功能太复杂,另一些则认为产品功能太简单。如何用标准化的产品适应客户复杂多样的业务场景,同时又不会过分的增加配置和操作的复杂度,成了协同领域的共同挑战。 而 Worktile 的回答,就在全新的 Worktile 7.0 里,通过将自定义配置下降到数据源级别,以及引入了大量的组件和视图,无论是规模巨大的上市公司,还是几十人的创业团队,无论是程序员还是财务小姐姐,都可以在 Worktile 7.0 上匹配适合您的工作流程。 毫不夸张的讲,Worktile 7.0 几乎可以适配所有的工作流程。 近期,Worktile7.0 已经开启几十家明星企业内测,其他用户可以等待公测。 相关阅读 和青小蛙一起体验 Read more…

Google

猜画小歌 – 来自 谷歌 基于 AI 的猜你画的是什么的「小程序」

猜画小歌 是一款微信小程序,来自谷歌的一款小程序,用来炫耀自己的 AI 技术,可以识别出你画的是什么,趣味性十足。@Appinn 来自青小蛙的好友胡萝卜同学,突然在群里晒出了一张图,青小蛙第一眼就看到了右下角那个像屁股一样的云彩 不过这个猜画小歌的玩法是,自己先出题,然后让你画,画的时候它会实时猜你画的是什么,你有 20 秒的时间画出符合 AI 胃口的画作,成功了就进入下一题。 青小蛙解锁了 21 个词汇: 还可以单独将画作分享给朋友或者朋友圈,然后就没有什么然后了。 想玩么?第一张图有二维码可以扫描。 相关阅读 小历 – 小而美的日历[iOS 限免] 小本 – 随身记忆卡片[iOS] 财禅 – 简约的记账、理财应用[iPhone] 能预报几点几分下雨的「彩云天气Pro」iOS 版本[限免又开始了],原价 25 元 捏捏 – 创建自己的漫画形象,给生活加点料[iOS/Android] ©2017 青小蛙 Read more…