Marmite静态站点生成器安装与配置指南

Marmite静态站点生成器安装与配置指南

marmite Markdown makes sites - A Static Site Generator for Blogs 项目地址: https://gitcode.com/gh_mirrors/ma/marmite

1. 项目基础介绍

Marmite是一个简单的静态站点生成器，它使用Markdown文件来生成静态HTML网站。该项目主要面向博客作者，适合编写并发布按时间顺序排列的文章。Marmite的特点是零配置起步，支持多种Markdown扩展，并且拥有一系列实用的特性，如内置的HTTP服务器、自动重建功能、支持多种主题等。

主要编程语言：Rust

2. 项目使用的关键技术和框架

• Rust：一种系统编程语言，强调安全性、性能和并发性。
• CommonMark：一个Markdown的标准化解析器。
• GitHub Flavoured Markdown (GFM)：GitHub定制的Markdown语法。
• 多种Markdown扩展：支持额外的Markdown功能，如表情符号、隐藏内容等。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统中已经安装了以下工具：

• Cargo：Rust的包管理器和构建工具。
• Docker（可选）：用于容器化应用。

安装步骤

使用Cargo安装

1. 打开命令行工具。
2. 输入以下命令安装Marmite：

cargo install marmite

或者使用以下命令：

cargo binstall marmite

使用预编译二进制文件

1. 访问Marmite的发布页面下载预编译的二进制文件。
2. 解压下载的文件到指定的目录。

使用Docker安装

1. 打开命令行工具。
2. 创建一个包含Markdown文件的目录。
3. 运行以下命令来生成静态站点：

docker run -v $(pwd):/input ghcr.io/rochacbruno/marmite

如果需要使用内置服务器来服务生成的站点，可以运行：

docker run -p 8000:8000 -v $(pwd):/input ghcr.io/rochacbruno/marmite --serve

配置指南

1. 在项目目录中创建一个名为marmite.yaml的配置文件，用于自定义项目设置。
2. 根据需要编辑配置文件，配置项可能包括站点信息、主题设置、Markdown解析选项等。
3. 使用以下命令启动Marmite并应用配置：

marmite <input_folder> <output_folder> --config <path_to_config_file>

替换<input_folder>为包含Markdown文件的目录，<output_folder>为生成静态站点的目录，<path_to_config_file>为配置文件的路径。

以上就是Marmite静态站点生成器的详细安装和配置指南。按照这些步骤操作，即使是编程小白也可以轻松搭建自己的静态网站。

marmite Markdown makes sites - A Static Site Generator for Blogs 项目地址: https://gitcode.com/gh_mirrors/ma/marmite