欧美国产日韩a在线视频,18video性欧美19sex高清

之前文章探討了是否應(yīng)該使用靜態(tài)網(wǎng)站生成器的理由。簡而言之，靜態(tài)網(wǎng)站生成器從模板和原始數(shù)據(jù)（通常包含在 Markdown 文件中）構(gòu)建僅包含 HTML 的頁面文件。它提供了一些 CMS 的好處，而沒有托管、性能和安全方面的開銷。

靜態(tài)網(wǎng)站可能適合各種項(xiàng)目，包括：

小型網(wǎng)站或個(gè)人博客。擁有幾十個(gè)頁面、不頻繁的帖子和一兩個(gè)作者的網(wǎng)站可能是理想的選擇。
技術(shù)文檔，例如 REST API。
需要一系列網(wǎng)頁視圖的應(yīng)用程序原型。
電子書——Markdown 文件可以轉(zhuǎn)換為 PDF 或其他格式以及 HTML。

本質(zhì)上，靜態(tài)網(wǎng)站生成器是一個(gè)構(gòu)建工具。您可以像使用 Grunt 或 Gulp 一樣，使用它來運(yùn)行任務(wù)或項(xiàng)目腳手架。

關(guān)鍵要點(diǎn)

Metalsmith 是一款靈活的可插入靜態(tài)網(wǎng)站生成器，非常適合創(chuàng)建輕量級(jí)網(wǎng)站，而無需傳統(tǒng) CMS 的開銷。
Metalsmith 的安裝和設(shè)置需要 Node.js，此過程涉及初始化新的項(xiàng)目目錄并通過 npm 安裝必要的插件。
Metalsmith 中的項(xiàng)目結(jié)構(gòu)涉及組織源文件、模板和資產(chǎn)，并明確區(qū)分開發(fā)和生產(chǎn)構(gòu)建。
Metalsmith 利用各種插件來擴(kuò)展功能，例如處理 Markdown 文件、創(chuàng)建 RSS 提要和生成站點(diǎn)地圖，這些都配置在構(gòu)建文件中。
可以創(chuàng)建自定義插件來處理特定任務(wù)，例如設(shè)置元數(shù)據(jù)或添加調(diào)試信息，從而增強(qiáng) Metalsmith 在管理網(wǎng)站內(nèi)容和結(jié)構(gòu)方面的多功能性。
Metalsmith 的構(gòu)建過程可以與 Gulp 等任務(wù)運(yùn)行器集成，以應(yīng)對(duì)更復(fù)雜的場景，盡管對(duì)于更簡單的流程，Metalsmith 本身就足夠了。

為什么選擇 Metalsmith？

無可爭議的靜態(tài)網(wǎng)站冠軍是 Jekyll——一個(gè) 2008 年啟動(dòng)的 Ruby 項(xiàng)目。您不一定需要 Ruby 專業(yè)知識(shí)來使用 Jekyll，但這會(huì)有所幫助。幸運(yùn)的是，大多數(shù)流行語言都有各種各樣的開源靜態(tài)網(wǎng)站生成器。JavaScript 選項(xiàng)包括 Hexo、Harp 和 Assemble。對(duì)于更簡單的項(xiàng)目，您也可以使用 Gulp 等構(gòu)建工具。

我選擇 Metalsmith 用于本教程是因?yàn)樗?/p>

不針對(duì)特定類型的項(xiàng)目（例如博客）
支持各種模板和數(shù)據(jù)格式選項(xiàng)
輕量級(jí)
依賴項(xiàng)很少
使用模塊化結(jié)構(gòu)
提供簡單的插件架構(gòu)，以及
易于上手。

本教程已經(jīng)構(gòu)建了一個(gè)演示網(wǎng)站。它不會(huì)贏得任何設(shè)計(jì)獎(jiǎng)項(xiàng)，但它說明了基本概念。Metalsmith 構(gòu)建代碼可以從 GitHub 存儲(chǔ)庫中檢查和安裝?；蛘撸梢园凑沾颂幍恼f明操作并創(chuàng)建您自己的基本站點(diǎn)。

我已經(jīng)使用過幾次 Metalsmith 了——請(qǐng)不要認(rèn)為這是構(gòu)建每個(gè)靜態(tài)網(wǎng)站的最終方法！

安裝 Metalsmith

確保您已安裝 Node.js（例如使用 nvm），然后創(chuàng)建一個(gè)新的項(xiàng)目目錄，例如 project 并初始化您的 package.json 文件：

<code>cd project && cd project
npm init -y
</code>

現(xiàn)在安裝 Metalsmith 和我們將用于構(gòu)建站點(diǎn)的各種插件。這些是：

metalsmith-assets — 在您的 Metalsmith 構(gòu)建中包含靜態(tài)資產(chǎn)
metalsmith-browser-sync — 將 BrowserSync 集成到您的工作流程中
metalsmith-collections — 將文件集合添加到全局元數(shù)據(jù)
metalsmith-feed — 為集合生成 RSS 提要
metalsmith-html-minifier — 使用 kangax/html-minifier 壓縮 HTML 文件
metalsmith-in-place — 在源文件中呈現(xiàn)模板語法
metalsmith-layouts — 將布局應(yīng)用于您的源文件
metalsmith-mapsite — 生成 sitemap.xml 文件
metalsmith-markdown — 轉(zhuǎn)換 Markdown 文件
metalsmith-permalinks — 將自定義永久鏈接模式應(yīng)用于文件
metalsmith-publish — 支持草稿、私有和未來日期的帖子
metalsmith-word-count — 計(jì)算 HTML 文件中所有段落的字?jǐn)?shù)/平均閱讀時(shí)間

<code>npm install --save-dev metalsmith metalsmith-assets metalsmith-browser-sync metalsmith-collections metalsmith-feed metalsmith-html-minifier metalsmith-in-place metalsmith-layouts metalsmith-mapsite metalsmith-markdown metalsmith-permalinks metalsmith-publish metalsmith-word-count handlebars
</code>

項(xiàng)目結(jié)構(gòu)

我們將在項(xiàng)目中使用以下結(jié)構(gòu)作為源 (src) 和構(gòu)建 (build) 目錄。

您可以按照以下說明創(chuàng)建示例文件，也可以直接從演示 src 目錄復(fù)制它們。

頁面

頁面 Markdown 文件包含在 src/html 中。這可以包含每個(gè)網(wǎng)站部分的一級(jí)子目錄，即

src/html/start — 按特定順序描述項(xiàng)目的頁面
src/html/article — 按反時(shí)間順序排列的各種文章
src/html/contact — 單個(gè)聯(lián)系頁面

每個(gè)目錄包含一個(gè) index.md 文件，它是該部分的默認(rèn)頁面。其他頁面可以使用任何唯一名稱。

構(gòu)建過程會(huì)將這些文件轉(zhuǎn)換為基于目錄的永久鏈接，例如

src/html/start/index.md 變成 /start/index.html
src/html/start/installation.md 變成 /start/installation/index.html

每個(gè) Markdown 文件都提供內(nèi)容和元信息，稱為“前題”位于 --- 標(biāo)記之間的頂部，例如

<code>---
title: My page title
description: A description of this page.
layout: page.html
priority: 0.9
date: 2016-04-19
publish: draft
---

This is a demonstration page.

## Example title
Body text.</code>

大多數(shù)前題都是可選的，但您可以設(shè)置：

priority：介于 0（低）和 1（高）之間的數(shù)字，我們將使用它來排序菜單和定義 XML 站點(diǎn)地圖。
publish：可以設(shè)置為草稿、私有或未來日期，以確保它不會(huì)在需要之前發(fā)布。
date：文章的日期。如果沒有設(shè)置，我們將使用任何未來的發(fā)布日期或文件創(chuàng)建日期。
layout：要使用的 HTML 模板。

模板

HTML 頁面模板包含在 src/template 中。已定義兩個(gè)模板：

src/html/template/page.html 默認(rèn)布局
src/html/template/article.md 顯示日期、前后鏈接等的文章布局

雖然支持其他選項(xiàng)，但使用了 Handlebars 模板系統(tǒng)。典型的模板需要一個(gè) {{{ contents }}} 標(biāo)記來包含頁面內(nèi)容以及任何前題值，例如 {{ title }}：

<code>cd project && cd project
npm init -y
</code>

對(duì) {{> meta }}、{{> header }} 和 {{> footer }} 的引用是部分……

部分

部分——或 HTML 代碼片段文件——包含在 src/partials 中。這些主要用于模板中，但也可以使用以下代碼包含在內(nèi)容頁面中：

<code>npm install --save-dev metalsmith metalsmith-assets metalsmith-browser-sync metalsmith-collections metalsmith-feed metalsmith-html-minifier metalsmith-in-place metalsmith-layouts metalsmith-mapsite metalsmith-markdown metalsmith-permalinks metalsmith-publish metalsmith-word-count handlebars
</code>

其中 partialname 是 src/partials 目錄中文件的名稱。

靜態(tài)資產(chǎn)

靜態(tài)資產(chǎn)（例如圖像、CSS 和 JavaScript 文件）包含在 src/assets 中。所有文件和子目錄都將按原樣復(fù)制到網(wǎng)站的根目錄。

自定義插件

構(gòu)建站點(diǎn)所需的自定義插件包含在 lib 目錄中。

構(gòu)建目錄

網(wǎng)站將在構(gòu)建目錄中構(gòu)建。我們將通過兩種方式構(gòu)建網(wǎng)站：

開發(fā)模式：HTML 不會(huì)被壓縮，并且會(huì)啟動(dòng)測試 Web 服務(wù)器。
生產(chǎn)模式：如果 NODE_ENV 設(shè)置為 production，則會(huì)清除構(gòu)建目錄并生成最終壓縮的文件。

定義您的第一個(gè)構(gòu)建文件

可以在項(xiàng)目目錄的根目錄中創(chuàng)建一個(gè)名為 build.js 的基本示例：

<code>---
title: My page title
description: A description of this page.
layout: page.html
priority: 0.9
date: 2016-04-19
publish: draft
---

This is a demonstration page.

## Example title
Body text.</code>

使用 node ./build.js 運(yùn)行它，一個(gè)靜態(tài)網(wǎng)站將在構(gòu)建目錄中創(chuàng)建。Markdown 將被解析為 HTML，但它不可用，因?yàn)槲覀儧]有在構(gòu)建過程中包含模板。

Metalsmith 插件

從表面上看，Metalsmith 構(gòu)建文件看起來類似于 Gulp 中使用的構(gòu)建文件（盡管它不使用流）。通過使用任何適當(dāng)?shù)膮?shù)將其傳遞給 Metalsmith use 方法來調(diào)用插件。插件本身必須返回另一個(gè)函數(shù)，該函數(shù)接受三個(gè)參數(shù)：

一個(gè) files 數(shù)組，包含有關(guān)每個(gè)頁面的信息
一個(gè) metalsmith 對(duì)象，包含全局信息，例如元數(shù)據(jù)，以及
一個(gè) done 函數(shù)，在插件完成工作后必須調(diào)用該函數(shù)

這個(gè)簡單的示例將所有元數(shù)據(jù)和頁面信息記錄到控制臺(tái)（它可以在 build.js 中定義）：

<code>
 lang="en">
  >
    {{> meta }}
  >
  >

  {{> header }}

  <main>></main>
    >

      {{#if title}}
        <h1>></h1>{{ title }}>
      {{/if}}

      {{{ contents }}}

    >
  >

  {{> footer }}

>
>
</code>

Metalsmith 構(gòu)建代碼可以更新為使用此插件：

<code>{{> partialname }}</code>

此調(diào)試函數(shù)可以幫助您創(chuàng)建自己的自定義插件，但是您可能需要的絕大多數(shù)功能都已經(jīng)編寫好了——Metalsmith 網(wǎng)站上列出了很長的插件列表。

制作更好的構(gòu)建

下面解釋了演示站點(diǎn)構(gòu)建文件的主要部分。

如果 NODE_ENV 環(huán)境變量已設(shè)置為 production（在 Mac/Linux 上導(dǎo)出 NODE_ENV=production 或在 Windows 上設(shè)置 NODE_ENV=production），則變量 devBuild 將設(shè)置為 true：

<code>cd project && cd project
npm init -y
</code>

主目錄在 dir 對(duì)象中定義，以便我們可以重復(fù)使用它們：

<code>npm install --save-dev metalsmith metalsmith-assets metalsmith-browser-sync metalsmith-collections metalsmith-feed metalsmith-html-minifier metalsmith-in-place metalsmith-layouts metalsmith-mapsite metalsmith-markdown metalsmith-permalinks metalsmith-publish metalsmith-word-count handlebars
</code>

加載 Metalsmith 和插件模塊。注意：

優(yōu)秀的 Browsersync 測試服務(wù)器僅在創(chuàng)建開發(fā)構(gòu)建時(shí)才需要
htmlmin 引用的 HTML 壓縮程序模塊僅在創(chuàng)建生產(chǎn)構(gòu)建時(shí)才需要
已定義三個(gè)自定義插件：setdate、moremeta 和 debug（下面將更詳細(xì)地解釋）

<code>---
title: My page title
description: A description of this page.
layout: page.html
priority: 0.9
date: 2016-04-19
publish: draft
---

This is a demonstration page.

## Example title
Body text.</code>

siteMeta 對(duì)象使用應(yīng)用于每個(gè)頁面的信息定義。重要的值是 domain 和 rootpath，它們根據(jù)開發(fā)或生產(chǎn)構(gòu)建進(jìn)行設(shè)置：

<code>
 lang="en">
  >
    {{> meta }}
  >
  >

  {{> header }}

  <main>></main>
    >

      {{#if title}}
        <h1>></h1>{{ title }}>
      {{/if}}

      {{{ contents }}}

    >
  >

  {{> footer }}

>
>
</code>

還定義了一個(gè) templateConfig 對(duì)象來設(shè)置模板默認(rèn)值。這將由 metalsmith-in-place 和 metalsmith-layouts 插件使用，它們啟用使用 Handlebars 的頁面內(nèi)和模板渲染：

<code>{{> partialname }}</code>

Metalsmith 對(duì)象現(xiàn)在像以前一樣初始化，但我們還將 siteMeta 對(duì)象傳遞給 metadata 方法，以確保該信息可用于每個(gè)頁面。因此，我們可以在任何頁面中引用諸如 {{ name }} 之類的項(xiàng)目以獲取站點(diǎn)名稱。

<code>// basic build

'use strict';

var
  metalsmith = require('metalsmith'),
  markdown   = require('metalsmith-markdown'),

  ms = metalsmith(__dirname) // the working directory
    .clean(true)            // clean the build directory
    .source('src/html/')    // the page source directory
    .destination('build/')  // the destination directory
    .use(markdown())        // convert markdown to HTML
    .build(function(err) {  // build the site
      if (err) throw err;   // and throw errors
    });
</code>

我們的第一個(gè)插件調(diào)用調(diào)用 metalsmith-publish，它刪除任何其前題 publish 值設(shè)置為草稿、私有或未來日期的文件：

<code>function debug(logToConsole) {
  return function(files, metalsmith, done) {
    if (logToConsole) {
      console.log('\nMETADATA:');
      console.log(metalsmith.metadata());

      for (var f in files) {
        console.log('\nFILE:');
        console.log(files[f]);
      }
    }

    done();
  };
};
</code>

setdate 是包含在 lib/metalsmith-setdate.js 中的自定義插件。它確保每個(gè)文件都設(shè)置了“date”值，即使在前題中沒有定義任何值，也可以通過盡可能回退到發(fā)布日期或文件創(chuàng)建時(shí)間來實(shí)現(xiàn)：

<code>ms = metalsmith(__dirname) // the working directory
  .clean(true)             // clean the build directory
  .source('src/html/')     // the page source directory
  .destination('build/')   // the destination directory
  .use(markdown())         // convert Markdown to HTML
  .use(debug(true))        // *** NEW *** output debug information
  .build(function(err) {   // build the site
    if (err) throw err;    // and throw errors
  });
</code>

metalsmith-collections 是最重要的插件之一，因?yàn)樗鶕?jù)頁面在源目錄中的位置或其他因素將每個(gè)頁面分配給類別或分類法。它可以使用前題（例如日期或優(yōu)先級(jí)）重新排序文件，并允許您為該集合設(shè)置自定義元數(shù)據(jù)。代碼定義：

src/html/start 目錄中每個(gè)文件的 start 集合。它按文件中前題中設(shè)置的優(yōu)先級(jí)值對(duì)它們進(jìn)行排序。
src/html/article 目錄中每個(gè)文件的 article 集合。它按反時(shí)間順序?qū)λ鼈冞M(jìn)行排序
每個(gè)名為 index.* 的默認(rèn)頁面的 page 集合。它按文件中前題中設(shè)置的優(yōu)先級(jí)值對(duì)它們進(jìn)行排序。

<code>devBuild = ((process.env.NODE_ENV || '').trim().toLowerCase() !== 'production')
</code>

接下來是 Markdown 到 HTML 的轉(zhuǎn)換，然后是 metalsmith-permalinks 插件，它為構(gòu)建定義了目錄結(jié)構(gòu)。請(qǐng)注意，moremeta 在下面為每個(gè)文件設(shè)置了 :mainCollection：

<code>dir = {
  base:   __dirname + '/',
  lib:    __dirname + '/lib/',
  source: './src/',
  dest:   './build/'
}
</code>

metalsmith-word-count 計(jì)算文章中的字?jǐn)?shù)并計(jì)算大約需要多長時(shí)間才能閱讀。參數(shù) { raw: true } 僅輸出數(shù)字：

<code>metalsmith  = require('metalsmith'),
markdown    = require('metalsmith-markdown'),
publish     = require('metalsmith-publish'),
wordcount   = require("metalsmith-word-count"),
collections = require('metalsmith-collections'),
permalinks  = require('metalsmith-permalinks'),
inplace     = require('metalsmith-in-place'),
layouts     = require('metalsmith-layouts'),
sitemap     = require('metalsmith-mapsite'),
rssfeed     = require('metalsmith-feed'),
assets      = require('metalsmith-assets'),
htmlmin     = devBuild ? null : require('metalsmith-html-minifier'),
browsersync = devBuild ? require('metalsmith-browser-sync') : null,

// custom plugins
setdate     = require(dir.lib + 'metalsmith-setdate'),
moremeta    = require(dir.lib + 'metalsmith-moremeta'),
debug       = consoleLog ? require(dir.lib + 'metalsmith-debug') : null,
</code>

moremeta 是包含在 lib/metalsmith-moremeta.js 中的另一個(gè)自定義插件。它將其他元數(shù)據(jù)附加到每個(gè)文件：

root：到根目錄的絕對(duì)或計(jì)算出的相對(duì)文件路徑
isPage：對(duì)于名為 index.* 的默認(rèn)部分頁面設(shè)置為 true
mainCollection：主要集合名稱，即 start 或 article
layout：如果未設(shè)置，則可以從主集合的元數(shù)據(jù)中確定布局模板
navmain：頂級(jí)導(dǎo)航對(duì)象的數(shù)組
navsub：二級(jí)導(dǎo)航對(duì)象的數(shù)組

插件代碼比較復(fù)雜，因?yàn)樗幚韺?dǎo)航。如果您需要更簡單的層次結(jié)構(gòu)，則有更簡單的選項(xiàng)。

<code>cd project && cd project
npm init -y
</code>

metalsmith-in-place 和 metalsmith-layouts 插件分別控制頁面內(nèi)和模板布局。傳遞上面定義的相同 templateConfig 對(duì)象：

<code>npm install --save-dev metalsmith metalsmith-assets metalsmith-browser-sync metalsmith-collections metalsmith-feed metalsmith-html-minifier metalsmith-in-place metalsmith-layouts metalsmith-mapsite metalsmith-markdown metalsmith-permalinks metalsmith-publish metalsmith-word-count handlebars
</code>

如果設(shè)置了 htmlmin（在生產(chǎn)構(gòu)建中），我們可以壓縮 HTML：

<code>---
title: My page title
description: A description of this page.
layout: page.html
priority: 0.9
date: 2016-04-19
publish: draft
---

This is a demonstration page.

## Example title
Body text.</code>

debug 是包含在 lib/metalsmith-debug.js 中的最終自定義插件。它類似于上面描述的 debug 函數(shù)：

<code>
 lang="en">
  >
    {{> meta }}
  >
  >

  {{> header }}

  <main>></main>
    >

      {{#if title}}
        <h1>></h1>{{ title }}>
      {{/if}}

      {{{ contents }}}

    >
  >

  {{> footer }}

>
>
</code>

啟動(dòng) Browsersync 測試服務(wù)器，以便我們可以測試開發(fā)構(gòu)建。如果您以前沒有使用過它，它看起來就像魔法：每次您進(jìn)行更改時(shí)，您的網(wǎng)站都會(huì)神奇地刷新，并且當(dāng)您滾動(dòng)或?yàn)g覽網(wǎng)站時(shí)，兩個(gè)或多個(gè)瀏覽器中的視圖會(huì)同步：

<code>{{> partialname }}</code>

最后，我們可以使用：

metalsmith-mapsite 生成 XML 站點(diǎn)地圖
metalsmith-feed 為 article 集合中的頁面生成 RSS 提要
metalsmith-assets 直接將 src/assets 中的文件和目錄復(fù)制到 build，而無需修改。

<code>// basic build

'use strict';

var
  metalsmith = require('metalsmith'),
  markdown   = require('metalsmith-markdown'),

  ms = metalsmith(__dirname) // the working directory
    .clean(true)            // clean the build directory
    .source('src/html/')    // the page source directory
    .destination('build/')  // the destination directory
    .use(markdown())        // convert markdown to HTML
    .build(function(err) {  // build the site
      if (err) throw err;   // and throw errors
    });
</code>

剩下的就是最后的 .build() 步驟來創(chuàng)建網(wǎng)站：

<code>function debug(logToConsole) {
  return function(files, metalsmith, done) {
    if (logToConsole) {
      console.log('\nMETADATA:');
      console.log(metalsmith.metadata());

      for (var f in files) {
        console.log('\nFILE:');
        console.log(files[f]);
      }
    }

    done();
  };
};
</code>

完成后，您可以再次運(yùn)行 node ./build.js 來構(gòu)建您的靜態(tài)網(wǎng)站。

需要注意的地方

我在構(gòu)建簡單的 Metalsmith 網(wǎng)站時(shí)學(xué)到了很多東西，但請(qǐng)注意以下問題：

不兼容的插件

插件可能會(huì)與其他插件沖突。例如，計(jì)算相對(duì)根路徑的 metalsmith-rootpath 與創(chuàng)建自定義構(gòu)建目錄結(jié)構(gòu)的 metalsmith-permalinks 不太兼容。我通過在 lib/metalsmith-moremeta.js 插件中編寫自定義根路徑計(jì)算代碼解決了此問題。

插件順序至關(guān)重要

如果插件放置的順序錯(cuò)誤，則插件可能會(huì)相互依賴或沖突。例如，生成 RSS 的 metalsmith-feed 插件必須在 metalsmith-layouts 之后調(diào)用，以確保不會(huì)在頁面模板中生成 RSS XML。

Browsersync 重新構(gòu)建問題

當(dāng) Browsersync 運(yùn)行并編輯文件時(shí)，集合會(huì)被重新解析，但舊數(shù)據(jù)似乎仍然存在。這可能是 lib/metalsmith-moremeta.js 自定義插件的問題，但菜單和前后鏈接可能會(huì)不同步。要修復(fù)它，請(qǐng)使用 Ctrl/Cmd C 停止構(gòu)建并重新啟動(dòng)構(gòu)建。

您是否仍然需要 Gulp？

使用 Gulp 等任務(wù)管理器的人會(huì)注意到 Metalsmith 提供了一個(gè)熟悉的構(gòu)建過程。有用于使用 Sass 進(jìn)行 CSS 預(yù)處理、圖像壓縮、文件連接、丑化和更多功能的插件。對(duì)于更簡單的流程，它可能就足夠了。

但是，Gulp 具有更廣泛的插件范圍，并允許進(jìn)行復(fù)雜的構(gòu)建活動(dòng)，例如 lint、部署和使用 auto-prefixer 的 PostCSS 處理。有一些 Gulp/Metalsmith 集成插件，盡管我遇到了一些問題，并且它們不應(yīng)該是必要的，因?yàn)?Gulp 任務(wù)可以直接運(yùn)行 Metalsmith，例如

<code>cd project && cd project
npm init -y
</code>

此過程可以防止上面提到的 Browsersync 重新構(gòu)建問題。請(qǐng)記住使用 .clean(false) 以確保當(dāng)其他任務(wù)處于活動(dòng)狀態(tài)時(shí)，Metalsmith 永遠(yuǎn)不會(huì)清除構(gòu)建文件夾。

Metalsmith 適合您嗎？

如果您有簡單或高度定制的網(wǎng)站需求，Metalsmith 是理想的選擇。也許可以嘗試使用文檔項(xiàng)目并一次添加一個(gè)功能。Metalsmith 并不像 Jekyll 等替代方案那樣功能齊全，但它并非旨在如此。您可能需要編寫自己的插件，但這樣做很容易，這對(duì) JavaScript 開發(fā)人員來說是一個(gè)巨大的好處。

創(chuàng)建 Metalsmith 構(gòu)建系統(tǒng)需要時(shí)間，我們還沒有考慮 HTML 模板和部署所涉及的工作量。但是，一旦您擁有一個(gè)可用的流程，添加、編輯和刪除 Markdown 文件就會(huì)變得非常簡單。它可能比使用 CMS 更容易，并且您擁有靜態(tài)網(wǎng)站的所有好處。

關(guān)于使用 Metalsmith 創(chuàng)建靜態(tài)網(wǎng)站的常見問題

什么是 Metalsmith，為什么我應(yīng)該使用它來創(chuàng)建靜態(tài)網(wǎng)站？

Metalsmith 是一款簡單易用的可插入靜態(tài)網(wǎng)站生成器。它基于 Node.js，并使用模塊化結(jié)構(gòu)，允許您通過插件根據(jù)需要添加功能。這使其具有令人難以置信的靈活性和可定制性。您應(yīng)該使用 Metalsmith 創(chuàng)建靜態(tài)網(wǎng)站，因?yàn)樗试S您完全按照自己的意愿構(gòu)建網(wǎng)站，而無需受傳統(tǒng) CMS 的限制。此外，靜態(tài)網(wǎng)站比動(dòng)態(tài)網(wǎng)站更快、更安全且更易于維護(hù)。

如何安裝 Metalsmith？

要安裝 Metalsmith，您需要在計(jì)算機(jī)上安裝 Node.js 和 npm。安裝這些后，您可以通過在終端中運(yùn)行命令 npm install metalsmith 來安裝 Metalsmith。這將安裝 Metalsmith 及其所有依賴項(xiàng)。

如何創(chuàng)建一個(gè)新的 Metalsmith 項(xiàng)目？

要?jiǎng)?chuàng)建一個(gè)新的 Metalsmith 項(xiàng)目，首先在終端中導(dǎo)航到要?jiǎng)?chuàng)建項(xiàng)目的目錄。然后，運(yùn)行命令 metalsmith 創(chuàng)建一個(gè)新項(xiàng)目。這將創(chuàng)建一個(gè)新的目錄，其名稱為您的項(xiàng)目名稱，在此目錄內(nèi)，它將為您的靜態(tài)網(wǎng)站創(chuàng)建一個(gè)基本結(jié)構(gòu)。

如何在我的 Metalsmith 項(xiàng)目中添加插件？

要向您的 Metalsmith 項(xiàng)目添加插件，您需要通過 npm 安裝它們，然后在您的 Metalsmith 配置文件中引用它們。例如，要添加 markdown 插件，您首先需要運(yùn)行 npm install metalsmith-markdown，然后在您的配置文件中，您需要添加 var markdown = require('metalsmith-markdown'); 并將 .use(markdown()) 添加到您的 Metalsmith 構(gòu)建鏈中。