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

？貢獻

歡迎請求請求。對於重大更改，請先開啟一個問題來討論您想要更改的內容。