Cryogen静态站点生成器入门指南

Cryogen静态站点生成器入门指南

cryogen A simple static site generator written in Clojure 项目地址: https://gitcode.com/gh_mirrors/cr/cryogen

Cryogen是一个基于Clojure编写的简单静态站点生成工具。本指南将指导您了解其基本结构、启动方法以及配置详情。

1. 项目目录结构及介绍

Cryogen的项目结构通常遵循以下模式，当通过Leiningen、clj-new或deps-new创建新项目时自动生成：

• content: 此目录存放站点的内容，包括博客文章（默认在posts子目录）和页面（默认在pages子目录）。Markdown或AsciiDoc格式的文件位于这里。
• themes: 包含不同的主题模板，如base.html是布局的基础，其它如tag.html用于标签页等。
• config.edn: 站点的核心配置文件。
• project.clj 或 deps.edn: Clojure项目的构建配置，依赖项定义等。
• src/leiningen/new 或 src/clj-new/new 或 deps-new模板: 这些是根据不同初始化方式提供的模板代码。
• resources: 可以存放静态资源，比如图片、图标等。
• cljs-repl.js, cljsBUILD.cljs, 和其他ClojureScript相关文件: 用于支持特定功能或开发环境配置。

2. 项目的启动文件介绍

Cryogen不直接有一个“启动文件”，但提供了命令来运行服务器进行开发:

• 使用Leiningen时，执行 lein serve 或 lein serve:fast 来启动服务器。后者更快但只重新编译变化的部分。
• 若采用Clojure CLI工具，可以通过 clojure -X:serve 或 clojure -X:serve:fast 启动。

此外，使用 lein run 或 clojure -M:build 可以在不开启服务器的情况下生成静态站点内容。

3. 项目的配置文件介绍

• config.edn: 是Cryogen的心脏，其中包含了站点的基本信息和行为配置。
  • :site-title: 网站标题。
  • :author, :description, 和 :site-url: 提供SEO相关的元数据。
  • :post-root, :page-root, :post-root-uri, 等: 控制文章和页面的存储路径前缀。
  • :theme: 设定当前使用的主题。
  • 更多配置项如RSS设置、Disqus集成、页面预览、布局选项等，详细配置可以在Cryogen的官方文档找到每个键值的具体意义。

通过以上三部分的了解，开发者可以快速上手Cryogen，定制自己的静态网站。记得调整配置并探索不同主题及插件来满足个性化需求。

cryogen A simple static site generator written in Clojure 项目地址: https://gitcode.com/gh_mirrors/cr/cryogen