Leiningen与静态站点生成：使用Clojure构建博客与文档-优快云博客

Leiningen与静态站点生成：使用Clojure构建博客与文档

【免费下载链接】leiningen Moved to Codeberg; this is a convenience mirror 项目地址: https://gitcode.com/gh_mirrors/le/leiningen

Leiningen不仅是Clojure项目构建工具，还能通过Clojure生态系统中的库实现静态站点生成。本文将展示如何利用Leiningen创建和管理静态网站项目，从环境搭建到最终生成HTML页面的完整流程，帮助开发者快速上手使用Clojure构建博客或文档站点。

项目初始化与依赖配置

使用Leiningen创建新的静态站点项目，需先设置项目结构和核心依赖。通过lein new命令生成基础项目框架，并在project.clj中添加静态站点生成所需的库。

lein new app static-site-generator
cd static-site-generator

项目配置文件project.clj需包含Enlive（HTML模板引擎）、Cheshire（JSON处理）和Markdown解析库，示例配置如下：

(defproject static-site-generator "1.0.0"
  :description "Static site generator using Clojure and Leiningen"
  :dependencies [[org.clojure/clojure "1.10.1"]
                 [enlive "1.0.1"]    ; HTML模板引擎
                 [cheshire "5.10.0"] ; JSON处理
                 [markdown-clj "1.10.5"]] ; Markdown解析
  :main static-site-generator.core)

官方项目模板参考：sample.project.clj

目录结构设计

合理的目录结构是静态站点项目可维护性的关键。推荐按"源文件-模板-输出"分离的原则组织项目，典型结构如下：

static-site-generator/
├── src/                 # Clojure源代码
│   └── static_site_generator/
│       ├── core.clj     # 主程序入口
│       ├── renderer.clj # HTML渲染逻辑
│       └── parser.clj   # Markdown解析
├── resources/           # 静态资源
│   ├── templates/       # HTML模板
│   │   ├── base.html    # 基础模板
│   │   ├── post.html    # 文章模板
│   │   └── index.html   # 首页模板
│   ├── css/             # 样式表
│   └── js/              # JavaScript文件
├── content/             # 内容源文件
│   ├── posts/           # Markdown文章
│   └── pages/           # 静态页面
└── target/              # 生成的HTML输出

Leiningen项目结构规范可参考：doc/TUTORIAL.md

核心功能实现

Markdown转HTML

使用markdown-clj库将Markdown文件转换为HTML。创建parser.clj实现文件读取和转换逻辑：

(ns static-site-generator.parser
  (:require [markdown.core :as md]
            [clojure.java.io :as io]))

(defn md->html [md-file]
  (with-open [r (io/reader md-file)]
    (md/md-to-html r)))

;; 示例调用
(md->html "content/posts/hello-world.md")

HTML模板渲染

通过Enlive库实现模板引擎功能，创建renderer.clj处理模板与数据的结合：

(ns static-site-generator.renderer
  (:require [net.cgrand.enlive-html :as html]
            [clojure.java.io :as io]))

;; 加载基础模板
(html/deftemplate base "templates/base.html"
  [title content]
  [:title] (html/content title)
  [:div.content] (html/html-content content))

;; 渲染文章页面
(defn render-post [post-data]
  (base (:title post-data) (:html-content post-data)))

模板文件示例（resources/templates/base.html）：

<!DOCTYPE html>
<html>
<head>
  <title></title>
  <link rel="stylesheet" href="/css/style.css">
</head>
<body>
  <header><h1>My Blog</h1></header>
  <div class="content"></div>
  <footer>© 2025 My Blog</footer>
</body>
</html>

Enlive模板引擎文档：Enlive官方指南

站点生成主流程

在core.clj中实现完整的站点生成流程，包括内容解析、模板渲染和文件输出：

(ns static-site-generator.core
  (:require [static-site-generator.parser :as parser]
            [static-site-generator.renderer :as renderer]
            [clojure.java.io :as io])
  (:gen-class))

(defn generate-site []
  ;; 创建输出目录
  (io/make-parents "target/index.html")
  
  ;; 处理首页
  (let [index-content (parser/md->html "content/index.md")
        html-output (renderer/base "Home" index-content)]
    (spit "target/index.html" html-output))
  
  ;; 处理文章
  (doseq [post-file (file-seq (io/file "content/posts"))
          :when (and (.isFile post-file)
                     (.endsWith (.getName post-file) ".md"))]
    (let [post-content (parser/md->html post-file)
          post-title (extract-title post-file)
          output-path (str "target/posts/" (.getName post-file) ".html")]
      (io/make-parents output-path)
      (spit output-path (renderer/render-post {:title post-title :html-content post-content})))))

(defn -main [& args]
  (generate-site)
  (println "Site generated successfully in target/ directory"))

静态资源与样式

项目中的静态资源（CSS、JS、图片）需放置在resources目录下，构建时会自动复制到输出目录。推荐使用Skeleton CSS框架快速搭建响应式布局，示例样式文件resources/css/style.css：

/* 基础样式 */
body {
  font-family: 'Inconsolata', monospace;
  line-height: 1.6;
  margin: 0 auto;
  max-width: 800px;
  padding: 20px;
}

/* 文章样式 */
.post {
  margin-bottom: 40px;
  padding-bottom: 20px;
  border-bottom: 1px solid #eee;
}

.post h2 {
  color: #333;
}

项目中可用的字体资源：web/inconsolata.ttf

构建与部署

使用Leiningen的run命令执行站点生成，输出文件将保存在target目录。生成的静态文件可直接部署到任何Web服务器或静态托管服务。

lein run  # 生成站点
cd target
python -m http.server  # 本地预览

生成的站点目录结构：

target/
├── index.html          # 首页
├── posts/              # 文章页面
│   ├── hello-world.md.html
│   └── clojure-tips.md.html
├── css/                # 样式表
└── js/                 # JavaScript文件

部署指南参考：doc/DEPLOY.md

高级功能扩展

自动化构建与预览

通过Leiningen插件lein-ring实现自动监控文件变化并重新生成站点：

;; 添加到project.clj
:plugins [[lein-ring "0.12.5"]]
:ring {:handler static-site-generator.server/handler
       :auto-reload? true}

创建简单的开发服务器server.clj：

(ns static-site-generator.server
  (:require [ring.adapter.jetty :as jetty]
            [ring.middleware.file :refer [wrap-file]]))

(defn handler [request]
  (wrap-file request "target"))

(defn start-server []
  (jetty/run-jetty handler {:port 3000}))

启动开发服务器：

lein ring server

插件生态与工具链

Leiningen丰富的插件生态可进一步增强静态站点开发体验，推荐插件：

lein-watch：监控文件变化自动执行任务
lein-scss：编译SCSS到CSS
lein-deps-tree：可视化依赖关系

插件列表参考：doc/PLUGINS.md

总结与最佳实践

使用Leiningen和Clojure构建静态站点的核心优势在于函数式编程的简洁性和生态系统的灵活性。推荐以下最佳实践：

内容与表现分离：使用Markdown管理内容，HTML模板控制布局
自动化工作流：配置Leiningen任务简化构建流程
增量构建：实现文件变化检测，只重新生成修改的页面
版本控制：使用Git管理内容和代码，配合CI/CD自动部署

通过本文介绍的方法，开发者可以快速搭建功能完善的静态站点生成系统，充分利用Clojure的强大功能和Leiningen的项目管理能力，构建高效、可维护的博客或文档站点。

项目完整示例代码：test_projects/sample/

扩展资源

官方文档：README.md
Clojure静态站点生成器：Cryogen
Enlive教程：Enlive Template Tutorial
Leiningen任务开发：doc/TUTORIAL.md

【免费下载链接】leiningen Moved to Codeberg; this is a convenience mirror 项目地址: https://gitcode.com/gh_mirrors/le/leiningen

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考