rawdog md

rawdog-MD

Caveman 级别的简单 Markdown 到 HTML 静态站点工具，配置最少。

受到 motherfuckingwebsite.com 的启发，在底层使用 Go 模板和 HTML。

特征

• 易于快速设置、定制和部署。
• 没有臃肿的依赖项/框架代码。
• HTML、CSS、JS、SVG、JSON 和 XML 缩小
• 支持语法高亮，无需JavaScript，可使用可定制的 CSS。
• 支持开箱即用地嵌入 YouTube、Twitter 和 Bilibili 视频。
• 用于本地开发的实时重新加载服务器。
• 各种入门模板可立即上手

？如果出现以下情况，您可能需要使用它：

• 您希望专注于创建网站而不是学习该工具。
• 您想要使用 Markdown 和自定义 HTML/CSS 构建网站。
• 您更喜欢简单的设置，而不需要不必要的安装。

？核心概念

• 最小配置：rawdog-md 被设计为以最小配置使用。选择一个入门模板并立即开始用 Markdown 编写帖子。
• 意见：该工具并不是通用静态站点生成器。它旨在用于非常具体的用例，这是一个带有一些简单模板页面的静态站点。如果您想要更通用和更高级的东西，请查看 Hugo 或 Jekyll。
• 带来您自己的样式：rawdog-md 提供最小的样式。然而，它很容易调整，因为它只是一个简单的 CSS 和 HTML 文件。
• 跨平台：您可以在 Windows、Linux 和 MacOS 上使用它。

安装

rawdog-md 可在 Windows、Linux 和 MacOS 上使用。您可以通过包管理器手动安装它，或者从源代码构建它。

视窗

通过 PowerShell 安装（单击展开）

1. 以管理员身份打开 PowerShell
2. 运行这个命令

   Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
   iex (irm https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/powershell/install.ps1)

3. 完毕！您现在可以在终端中将其用作rawd命令。

通过勺子安装

1. 安装勺子
2. 安装 rawdog-md

   scoop install https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/scoop/rawdog-md.json

3. 完毕！您现在可以在终端中将其用作rawd命令。

如何卸载：

scoop uninstall rawdog-md

手动安装

1. 进入最新发布页面
2. 下载文件名为rawd-{version}-windows-amd64.zip的版本
3. 将 zip 文件解压到您喜欢的任何位置
4. 将解压的文件夹添加到您的路径中。如果您不知道如何操作，请查看本指南
5. 完毕！您现在可以在终端中将其用作rawd命令。

Linux

通过 Bash 安装（单击展开）

1. 在终端中运行此命令

   curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash

2. 完毕！您现在可以在终端中将其用作rawd命令。

手动安装

1. 进入最新发布页面
2. 复制rawd-{version}-linux-{architecture}.tar.gz文件名的 URL
3. 在终端中运行此命令

   wget {copied-url} -O rawd.tar.gz
   tar -xvf rawd.tar.gz
   sudo mv rawd /usr/local/bin
   rm rawd.tar.gz

4. 完毕！您现在可以在终端中将其用作rawd命令。

苹果系统

通过 Bash 安装（单击展开）

1. 在终端中运行此命令

   curl -fsSL https://raw.githubusercontent.com/dwiandhikaap/rawdog-md/main/.installer/bash/install.sh | bash

2. 完毕！您现在可以在终端中将其用作rawd命令。

手动安装

1. 进入最新发布页面
2. 复制rawd-{version}-darwin-{architecture}.tar.gz文件名的 URL
3. 在终端中运行此命令

   wget {copied-url} -O rawd.tar.gz
   tar -xvf rawd.tar.gz
   sudo mv rawd /usr/local/bin
   rm rawd.tar.gz

4. 完毕！您现在可以在终端中将其用作rawd命令。

从源代码构建

使用 Go 构建（点击展开）

1. 安装Go

2. 安装 rawdog-md

   go install github.com/dwiandhikaap/rawdog-md

   这会将二进制文件安装为rawdog-md而不是rawd如果您想将其更改为rawd ，您可以在 Go bin 目录中重命名该二进制文件。

   有关go install的更多信息，请参阅此参考资料。

3. 完毕！

用法

1. 创建一个新项目并选择预设模板

   rawd init

   它会询问您要使用的项目名称和模板。

2. 然后，进入项目目录

    cd < your-project-name >

3. 启动开发服务器

   rawd watch

4. 打开浏览器并访问http://localhost:3000

5. 要创建新帖子，请在pages目录中创建一个新文件。您可以使用 Markdown、Go Template 或 HTML。

6. 要编辑模板，请转到template目录。

7. 每次保存更改时，服务器都会重建站点并刷新浏览器。

8. 完成后，构建网站

   rawd build

？贡献

欢迎请求请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。