[[251313]]

用這個(gè)有用工具從 Markdown 文件創(chuàng)建一個(gè)基礎(chǔ)的網(wǎng)站。

有很多理由喜歡 Markdown，這是一門簡單的語言，有易于學(xué)習(xí)的語法，它可以與任何文本編輯器一起使用。使用像 Pandoc 這樣的工具，你可以將 Markdown 文本轉(zhuǎn)換為各種流行格式，包括 HTML。你還可以在 Web 服務(wù)器中自動(dòng)執(zhí)行轉(zhuǎn)換過程。由 TimoDörr 創(chuàng)建的名為 MDwiki 的 HTML5 和 JavaScript 應(yīng)用可以將一堆 Markdown 文件在瀏覽器請(qǐng)求它們時(shí)轉(zhuǎn)換為網(wǎng)站。MDwiki 網(wǎng)站包含一個(gè)操作指南和其他信息可幫助你入門：

Mdwiki 網(wǎng)站的樣子。

在 Web 服務(wù)器內(nèi)部，基本的 MDwiki 站點(diǎn)如下所示：

該站點(diǎn)的 web 服務(wù)器文件夾的樣子

我將此項(xiàng)目的 MDwiki HTML 文件重命名為 START.HTML。還有一個(gè)處理導(dǎo)航的 Markdown 文件和一個(gè) JSON 文件來保存一些配置設(shè)置。其他的都是網(wǎng)站內(nèi)容。

雖然整個(gè)網(wǎng)站設(shè)計(jì)被 MDwiki 固定了，但內(nèi)容、樣式和頁面數(shù)量卻沒有。你可以在 MDwiki 站點(diǎn)查看由 MDwiki 生成的一系列不同站點(diǎn)。公平地說，MDwiki 網(wǎng)站缺乏網(wǎng)頁設(shè)計(jì)師可以實(shí)現(xiàn)的視覺吸引力 —— 但它們是功能性的，用戶應(yīng)該平衡其簡單的外觀與創(chuàng)建和編輯它們的速度和簡易性。

Markdown 有不同的風(fēng)格，可以針對(duì)不同的特定目的擴(kuò)展穩(wěn)定的核心功能。MDwiki 使用 GitHub 風(fēng)格 Markdown，它為流行的編程語言添加了格式化代碼塊和語法高亮等功能，使其非常適合生成程序文檔和教程。

MDwiki 還支持 “gimmick”，它增加了如嵌入 YouTube 視頻和顯示數(shù)學(xué)公式等額外功能。如果在某些項(xiàng)目中需要它們，這些值得探索。我發(fā)現(xiàn) MDwiki 是創(chuàng)建技術(shù)文檔和教育資源的理想工具。我還發(fā)現(xiàn)了一些可能不會(huì)立即顯現(xiàn)出來的技巧和 hack。

當(dāng)部署在 Web 服務(wù)器中時(shí)，MDwiki 可與任何現(xiàn)代 Web 瀏覽器一起使用。但是，如果你使用 Mozilla Firefox 訪問 MDwiki，那么就不需要 Web 服務(wù)器。大多數(shù) MDwiki 用戶會(huì)選擇在 Web 服務(wù)器上部署完整的項(xiàng)目，以避免排除潛在用戶，但只需使用文本編輯器和 Firefox 即可完成開發(fā)和測試。任何現(xiàn)代瀏覽器都可以讀取加載到 Moodle 虛擬學(xué)習(xí)環(huán)境（VLE）中的完整的 MDwiki 項(xiàng)目，這在教育環(huán)境中非常有用。 （對(duì)于其他 VLE 軟件，這可能也是如此，但你應(yīng)該測試它。）

MDwiki 的默認(rèn)配色方案并非適用于所有項(xiàng)目，但你可以將其替換為從 Bootswatch.com 下載的其他主題。為此，只需在編輯器中打開 MDwiki HTML 文件，找到 extlib/css/bootstrap-3.0.0.min.css，然后插入下載的 Bootswatch 主題。還有一個(gè) MDwiki gimmick，讓用戶在瀏覽器中載入 MDwiki 后，選擇 Bootswatch 主題來替換默認(rèn)值。我經(jīng)常與有視力障礙的用戶一起工作，他們傾向于喜歡高對(duì)比度的主題，在深色背景上使用白色文字。

MDwiki 頁面使用 Bootswatch Superhero 主題

MDwiki、Markdown 文件和靜態(tài)圖像可以用于許多目的。但是，你有時(shí)可能希望包含 JavaScript 幻燈片或反饋表單。Markdown 文件可以包含 HTML 代碼，但將 Markdown 與 HTML 混合會(huì)讓人感到困惑。一種解決方案是在單獨(dú)的 HTML 文件中創(chuàng)建所需的功能，并將其顯示在帶有 iframe 標(biāo)記的 Markdown 文件中。我從 Twine Cookbook 知道了這個(gè)想法，它是 Twine 交互式小說引擎的支持站點(diǎn)。Twine Cookbook 實(shí)際上并沒有使用 MDwiki，但結(jié)合 Markdown 和 iframe 標(biāo)簽開辟了廣泛的創(chuàng)作可能性。

這是一個(gè)例子：

此 HTML 將顯示由 Markdown 文件中的 Twine 交互式小說引擎創(chuàng)建的 HTML 頁面。

<iframe height="400" src="sugarcube_dungeonmoving_example.html" width="90%"></iframe>

MDwiki 生成的站點(diǎn)結(jié)果如下所示：

簡而言之，MDwiki 是一個(gè)出色的小應(yīng)用，可以很好地實(shí)現(xiàn)其目的。