摘要:是一個(gè)文檔生成工具,用于生成文檔網(wǎng)站或簡(jiǎn)單的博客網(wǎng)站。簡(jiǎn)單到你只需寫(xiě)文件就可以幫助你生成網(wǎng)站。官方網(wǎng)站開(kāi)源下圖官方網(wǎng)站,是生成的基于的快速靜態(tài)站點(diǎn)生成器,只需編寫(xiě)文件即可。訪問(wèn)網(wǎng)站獲取更多信息。部署網(wǎng)站恭喜你,你已經(jīng)生成了一個(gè)網(wǎng)站。
RDoc 是一個(gè)文檔生成工具,用于生成文檔網(wǎng)站或簡(jiǎn)單的博客網(wǎng)站。
簡(jiǎn)單到你只需寫(xiě) Markdown 文件就可以幫助你生成網(wǎng)站。
同時(shí)可以方便的集成到你的項(xiàng)目工程中。
官方網(wǎng)站
開(kāi)源Github
下圖官方網(wǎng)站,是 rdoc 生成的:
基于React的快速靜態(tài)站點(diǎn)生成器,只需編寫(xiě)Markdown文件即可。 訪問(wèn)react-doc.github.io網(wǎng)站獲取更多信息。
快速開(kāi)始在您的系統(tǒng)上全局安裝rdoc。需要在本地開(kāi)發(fā)機(jī)器上具有Node> = 8。 您可以使用 n 來(lái)輕松切換不同項(xiàng)目之間的Node版本。
全局安裝npm install rdoc -g初始化網(wǎng)站
rdoc init my-project # Init project運(yùn)行網(wǎng)站
cd my-project && npm start # Into the directory, start the service. ## Compiled successfully! ## You can now view doc-example in the browser. ## Local: http://localhost:5858/ ## On Your Network: http://192.168.188.109:5858/ ## Note that the development build is not optimized. ## To create a production build, use npm run build.編譯生成HTML
npm run build修改部署配置
在 package.json 中配置部署URL
{ "scripts": { "deploy": "rdoc --publish <您的GitHub倉(cāng)庫(kù)地址>" ... }, ... }
例如:
{ "scripts": { "deploy": "rdoc --publish https://github.com/react-doc/react-doc.github.io.git --branch master" ... }, ... }
上面 deploy 實(shí)例,將當(dāng)前工程生成的靜態(tài) push 到 https://github.com/react-doc/react-doc.github.io.git 倉(cāng)庫(kù)的 master 分支中。
--branch master 參數(shù)指定分支,默認(rèn)沒(méi)有這個(gè)參數(shù),推向指定網(wǎng)站的 gh-pages 分支。
部署網(wǎng)站npm run deploy
恭喜你,你已經(jīng)生成了一個(gè)網(wǎng)站。?
文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址:http://www.ezyhdfw.cn/yun/92708.html
摘要:讀完本文,你將學(xué)會(huì)如何使用靜態(tài)網(wǎng)站生成器,搭建一個(gè)屬于自己的博客,用來(lái)展示數(shù)據(jù)科學(xué)作品。靜態(tài)網(wǎng)站基本上,一個(gè)靜態(tài)網(wǎng)站就是一個(gè)全是文件的文件夾。建立靜態(tài)網(wǎng)站的一種方法是手寫(xiě),然后上傳所有的文件到服務(wù)器。 這是「打造數(shù)據(jù)科學(xué)作品集」系列文章的第二篇。如果你喜歡該系列,而且想知道下一篇文章什么時(shí)候發(fā)布,你可以訂閱我們。讀完本文,你將學(xué)會(huì)如何使用 Pelican 靜態(tài)網(wǎng)站生成器,搭建一個(gè)屬于...
摘要:是一套描述標(biāo)準(zhǔn),和一樣,屬于一種標(biāo)記語(yǔ)言,可以把標(biāo)記文稿轉(zhuǎn)換成漂亮的接口文檔。還可以創(chuàng)建,進(jìn)行本地調(diào)試。一語(yǔ)法只要用寫(xiě)過(guò)東西基本很快就能掌握語(yǔ)法。參考文檔使用編寫(xiě)文檔用生成優(yōu)雅的文檔指導(dǎo)手冊(cè)用生成優(yōu)雅的文檔 前后端配合開(kāi)發(fā)的時(shí)候,常常會(huì)有這樣一種需求:你接口定義好了嗎?能不能先幫我起一個(gè) Mock Server 先跑起來(lái)?那么,如何才能避免前后端開(kāi)發(fā)在時(shí)間差上的無(wú)謂等待呢?api-bl...
摘要:而且通常來(lái)說(shuō),是用來(lái)介紹項(xiàng)目,而不是展示文檔。如果不確定系統(tǒng)中是否已經(jīng)安裝了,使用下面的命令檢查如果出現(xiàn)了的版本號(hào),則不需要再安裝了。例如我執(zhí)行的命令如下然后使用進(jìn)入項(xiàng)目目錄,并創(chuàng)建一個(gè)名為的目錄目錄將存放我們的文檔。 當(dāng)我們發(fā)布一個(gè)開(kāi)源項(xiàng)目的時(shí)候,最重要的事情之一就是要?jiǎng)?chuàng)建項(xiàng)目文檔。對(duì)使用項(xiàng)目的用戶來(lái)說(shuō),文檔是非常有必要的,通常我們可以使用下面這些方式來(lái)創(chuàng)建文檔: GitHub W...
摘要:內(nèi)容包括翻譯環(huán)境搭建項(xiàng)目管理與自動(dòng)化構(gòu)建三部分。博客首頁(yè)聲明官方文檔翻譯稿發(fā)布托管在七牛上的翻譯文檔倉(cāng)庫(kù)環(huán)境搭建翻譯與寫(xiě)作一樣,首要之事均為專(zhuān)注于翻譯寫(xiě)作本身,而不考慮樣式等方面。安裝完成后,運(yùn)行即可在啟動(dòng)一個(gè)本地的。 感興趣的同學(xué)可以關(guān)注這個(gè)翻譯項(xiàng)目 、 我的博客原文 和 我的Github showImg(/img/remote/1460000006776466); 前段時(shí)間翻譯的S...
閱讀 4241·2021-11-23 10:09
閱讀 1488·2021-11-23 09:51
閱讀 3127·2021-11-23 09:51
閱讀 1814·2021-09-07 09:59
閱讀 2534·2019-08-30 15:55
閱讀 2470·2019-08-30 15:55
閱讀 3100·2019-08-30 15:52
閱讀 2701·2019-08-26 17:04