2020AV天堂网,午夜色色视频,美女黄片免费观看,欧美黄色电影网站,亚洲人在线

新聞資訊

新聞資訊
首頁 > 新聞資訊 > 正文內(nèi)容

余姚做網(wǎng)站哪家好(做網(wǎng)站哪家公司比較好而且不貴)

時間:2023-11-09 信途科技新聞資訊

使用 Docsify 創(chuàng)建文檔網(wǎng)頁并發(fā)布到 GitHub Pages 上。

? 來源:linux.cn ? 作者:Bryant Son ? 譯者:Xingyu.Wang ?

(本文字數(shù):5192,閱讀時長大約:6 分鐘)

文檔是幫助用戶使用開源項目一個重要部分,但它并不總是開發(fā)人員的首要任務,因為他們可能更關注的是使他們的應用程序更好,而不是幫助人們使用它。對開發(fā)者來說,這就是為什么讓發(fā)布文檔變得更容易是如此有價值的原因。在本教程中,我將向你展示一個這樣做的方式:將 Docsify 文檔生成器與 GitHub Pages 結(jié)合起來。

默認情況下,GitHub Pages 會提示用戶使用 Jekyll ,這是一個支持 HTML、CSS 和其它網(wǎng)頁技術的靜態(tài)網(wǎng)站生成器。Jekyll 可以從以 Markdown 格式編碼的文檔文件中生成一個靜態(tài)網(wǎng)站,GitHub 會自動識別它們的 .md 或 .markdown 擴展名。雖然這種設置很好,但我想嘗試一下其他的東西。

幸運的是,GitHub Pages 支持 HTML 文件,這意味著你可以使用其他網(wǎng)站生成工具(比如 Docsify)在這個平臺上創(chuàng)建一個網(wǎng)站。Docsify 是一個采用 MIT 許可證的開源項目,其具有可以讓你在 GitHub Pages 上輕松創(chuàng)建一個有吸引力的、先進的文檔網(wǎng)站的 功能 。

Docsify

開始使用 Docsify

安裝 Docsify 有兩種方法:

通過 NPM 安裝 Docsify 的命令行界面(CLI)。手動編寫自己的 index.html。

Docsify 推薦使用 NPM 方式,但我將使用第二種方案。如果你想使用 NPM,請按照 快速入門指南 中的說明進行操作。

從 GitHub 下載示例內(nèi)容

我已經(jīng)在 該項目的 GitHub 頁面 上發(fā)布了這個例子的源代碼。你可以單獨下載這些文件,也可以通過以下方式 克隆這個存儲庫 。

git clone https://github.com/bryantson/OpensourceDotComDemos

然后 cd 進入 DocsifyDemo 目錄。

我將在下面為你介紹這些代碼,它們克隆自我的示例存儲庫中,這樣你就可以理解如何修改 Docsify。如果你愿意,你也可以從頭開始創(chuàng)建一個新的 index.html 文件,就像 Docsify 文檔中的的 示例 一樣:

<!-- index.html --><!DOCTYPE html><html><head>  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  <meta name="viewport" content="width=device-width,initial-scale=1">  <meta charset="UTF-8">  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css"></head><body>  <div id="app"></div>  <script>    window.$docsify = {      //...    }  </script>  <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script></body></html>探索 Docsify 如何工作

如果你克隆了我的 GitHub 存儲庫 ,并切換到 DocsifyDemo 目錄下,你應該看到這樣的文件結(jié)構:

File contents in the cloned GitHub

index.html 是 Docsify 可以工作的唯一要求。打開該文件,你可以查看其內(nèi)容:

<!-- index.html --><!DOCTYPE html><html><head>  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  <meta name="viewport" content="width=device-width,initial-scale=1">  <meta charset="UTF-8">  <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css">  <title>Docsify Demo</title></head><body>  <div id="app"></div>  <script>    window.$docsify = {      el: "#app",      repo: 'https://github.com/bryantson/OpensourceDotComDemos/tree/master/DocsifyDemo',      loadSidebar: true,    }  </script>  <script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script></body></html>

這本質(zhì)上只是一個普通的 HTML 文件,但看看這兩行:

<link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify/themes/vue.css">... 一些其它內(nèi)容 ...<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>

這些行使用內(nèi)容交付網(wǎng)絡(CDN)的 URL 來提供 CSS 和 JavaScript 腳本,以將網(wǎng)站轉(zhuǎn)化為 Docsify 網(wǎng)站。只要你包含這些行,你就可以把你的普通 GitHub 頁面變成 Docsify 頁面。

<body> 標簽后的第一行指定了要渲染的內(nèi)容:

<div id="app"></div>

Docsify 使用 單頁應用 (SPA)的方式來渲染請求的頁面,而不是刷新一個全新的頁面。

最后,看看 <script> 塊里面的行:

<script>    window.$docsify = {      el: "#app",      repo: 'https://github.com/bryantson/OpensourceDotComDemos/tree/master/DocsifyDemo',      loadSidebar: true,    }</script>

在這個塊中:

el 屬性基本上是說:“嘿,這就是我要找的 id,所以找到它并在那里呈現(xiàn)?!备淖?repo 值,以確定當用戶點擊右上角的 GitHub 圖標時,會被重定向到哪個頁面。 將 loadSideBar 設置為 true 將使 Docsify 查找包含導航鏈接的 _sidebar.md 文件。

你可以在 Docsify 文檔的 配置 部分找到所有選項。

接下來,看看 _sidebar.md 文件。因為你在 index.html 中設置了 loadSidebar 屬性值為 true,所以 Docsify 會查找 _sidebar.md 文件,并根據(jù)其內(nèi)容生成導航文件。示例存儲庫中的 _sidebar.md 內(nèi)容是:

<!-- docs/_sidebar.md -->* [HOME](./)* [Tutorials](./tutorials/index)  * [Tomcat](./tutorials/tomcat/index)  * [Cloud](./tutorials/cloud/index)  * [Java](./tutorials/java/index)* [About](./about/index)* [Contact](./contact/index)

這會使用 Markdown 的鏈接格式來創(chuàng)建導航。請注意 “Tomcat”、“Cloud” 和 “Java” 等鏈接是縮進的;這意味著它們被渲染為父鏈接下的子鏈接。

像 README.md 和 images 這樣的文件與存儲庫的結(jié)構有關,但所有其它 Markdown 文件都與你的 Docsify 網(wǎng)頁有關。

根據(jù)你的需求,隨意修改你下載的文件。下一步,你將把這些文件添加到你的 GitHub 存儲庫中,啟用 GitHub Pages,并完成項目。

啟用 GitHub 頁面

創(chuàng)建一個示例的 GitHub 存儲庫,然后使用以下 GitHub 命令檢出、提交和推送你的代碼:

$ git clone 你的 GitHub 存儲庫位置$ cd 你的 GitHub 存儲庫位置$ git add .$ git commit -m "My first Docsify!"$ git push

設置你的 GitHub Pages 頁面。在你的新 GitHub 存儲庫中,點擊 “Settings”:

Settings link in GitHub

向下滾動直到看到 “GitHub Pages”:

GitHub Pages settings

查找 “Source” 部分:

GitHub Pages settings

點擊 “Source” 下的下拉菜單。通常,你會將其設置為 “master branch”,但如果你愿意,也可以使用其他分支:

Setting Source to master branch

就是這樣!你現(xiàn)在應該有一個鏈接到你的 GitHub Pages 的頁面了。點擊該鏈接將帶你到那里,然后用 Docsify 渲染:

Link to GitHub Pages docs site

它應該像這樣:

Example Docsify site on GitHub Pages

結(jié)論

通過編輯一個 HTML 文件和一些 Markdown 文本,你可以用 Docsify 創(chuàng)建一個外觀精美的文檔網(wǎng)站。你覺得怎么樣?請留言,也可以分享其他可以和 GitHub Pages 一起使用的開源工具。

via: opensource.com

作者: Bryant Son 選題: lujun9972 譯者: wxy 校對: wxy

本文由 LCTT 原創(chuàng)編譯, Linux中國 榮譽推出

點擊“了解更多”可訪問文內(nèi)鏈接

掃描二維碼推送至手機訪問。

版權聲明:本文由信途科技轉(zhuǎn)載于網(wǎng)絡,如有侵權聯(lián)系站長刪除。

轉(zhuǎn)載請注明出處http://www.quickersubmitter.com/xintu/16038.html

相關文章

網(wǎng)絡推廣宣傳引流(網(wǎng)絡推廣宣傳語)

酒香也怕巷子深網(wǎng)絡推廣宣傳引流,做自媒體最怕的就是沒有流量。那么網(wǎng)絡推廣宣傳引流,在保證賬號內(nèi)容高質(zhì)的情況下網(wǎng)絡推廣宣傳引流,如何推廣自媒體賬號,實現(xiàn)引流目標呢網(wǎng)絡推廣宣傳引流?這3種免費的方法可以嘗...

國家對農(nóng)產(chǎn)品網(wǎng)絡營銷的政策,農(nóng)產(chǎn)品網(wǎng)絡營銷存在的問題及對策

制定我國農(nóng)產(chǎn)品網(wǎng)絡營銷的市場規(guī)范準則,并通過對于各項政策標準和規(guī)范的制定推動農(nóng)產(chǎn)品網(wǎng)絡營銷的發(fā)展,只有這樣才能使我國。把資金政策和工作力量下沉到基層,把基礎設施建設和網(wǎng)絡銷售服務前移到鄉(xiāng)到村堅持匯聚眾...

昆山做網(wǎng)站的(昆山千燈做網(wǎng)站)

發(fā)布會現(xiàn)場(央廣網(wǎng)發(fā) 昆山警方供圖)央廣網(wǎng)昆山3月27日消息(總臺央廣記者任夢巖 江蘇臺記者王德儉)江蘇昆山警方調(diào)查歷時近1年,輾轉(zhuǎn)6省9地,近日終于宣布:破獲一起全球最大的游戲外掛案件,涉案人員遍布...

沭陽網(wǎng)絡營銷培訓哪家好的簡單介紹

網(wǎng)絡營銷是其業(yè)務轉(zhuǎn)型中最重要的一環(huán)“我們的客戶主要通過網(wǎng)絡渠道,集中在互聯(lián)網(wǎng)搜索關鍵詞后直接點擊打開我們網(wǎng)站后進行咨。政府在電力網(wǎng)絡培訓金融等方面都在加緊建設交通方面,大力建設村鎮(zhèn)道路,架橋鋪路,解決...

冰箱網(wǎng)絡營銷計劃方案,網(wǎng)絡營銷策劃案1500

本站為您站內(nèi)搜索匹配出關于海爾冰箱網(wǎng)絡營銷策劃書相關報道相關新聞相關動態(tài),希望能夠給您帶來幫助。冰箱網(wǎng)絡營銷廣告策劃書專題聚合頁面,為您提供關于冰箱網(wǎng)絡營銷廣告策劃書相關報道相關新聞相關動態(tài),如果你想...

密云做網(wǎng)站需要多少錢(金泉網(wǎng)做網(wǎng)站多少錢)

中央紀委國家監(jiān)委網(wǎng)站訊據(jù)北京市紀委監(jiān)委消息:密云區(qū)人大常委會副主任李洪山涉嫌嚴重違紀違法,目前正接受紀律審查和監(jiān)察調(diào)查。李洪山簡歷李洪山,男,漢族,1963年12月出生,北京人,1985年2月加入中國...

現(xiàn)在,非常期待與您的又一次邂逅

我們努力讓每一次邂逅總能超越期待

  • 效果付費
    效果付費

    先出效果再付費

  • 極速交付
    極速交付

    響應速度快,有效節(jié)省客戶時間

  • 1對1服務
    1對1服務

    專屬客服對接咨詢

  • 持續(xù)更新
    持續(xù)更新

    不斷升級維護,更好服務用戶