minimal下載 - minimal原始碼下載

minimal

其他源碼

v0.2.0

下載

最小主題

Minimal 是 GitHub Pages 的 Jekyll 主題。您可以預覽主題以查看它的外觀，甚至可以立即使用它。

最小的縮圖

用法

要使用最小主題：

將以下內容新增至您網站的_config.yml ：

 remote_theme : pages-themes/[email protected]
plugins :
- jekyll-remote-theme # add this line to the plugins list if you already have one

或者，如果您想在電腦上預覽站點，請將以下內容新增至站點的Gemfile ：
```
 gem "github-pages" , group : :jekyll_plugins 
```

客製化

配置變數

如果在網站的_config.yml中設置，Minimal 將遵循以下變數：

 title : [The title of your site]
description : [A short description of your site's purpose]

此外，您可以選擇設定以下可選變數：

 show_downloads : ["true" or "false" (unquoted) to indicate whether to provide a download URL]
google_analytics : [Your Google Analytics tracking ID]

樣式表

如果您想新增自己的自訂樣式：

在您的網站中建立一個名為/assets/css/style.scss的文件
將以下內容新增至文件頂部，如圖所示：
```
---
---

@import " {{ site.theme }} " ;
```
在@import行之後立即添加您想要的任何自訂 CSS（或 Sass，包括導入）

注意：如果您想更改主題的 Sass 變量，則必須在樣式表中的@import行之前設定新值。

佈局

如果您想要變更主題的 HTML 版面：

對於某些變更（例如自訂favicon ，您可以在本機_includes資料夾中新增自訂檔案。隨主題提供的文件提供了一個起點，並包含在原始佈局模板中。
要進行更廣泛的更改，請從主題存儲庫複製原始模板
（專業提示：按一下「原始」使複製更容易）
在您的網站中建立一個名為/_layouts/default.html的文件
貼上第一步複製的預設版面內容
根據需要自訂佈局

自訂 Google Analytics 程式碼

自從這個主題首次創建以來，多年來 Google 已經發布了 Google Analytics 程式碼的多次迭代。如果您想利用最新程式碼，請將其貼上到 Jekyll 網站的_includes/head-custom-google-analytics.html中。

覆蓋 GitHub 產生的 URL

範本通常依賴 GitHub 提供的 URL，例如儲存庫的連結或下載專案的連結。如果您想要覆寫一個或多個預設 URL：

查看範本來源以確定變數的名稱。它將採取{{ site.github.zip_url }}的形式。
指定您希望範本在網站的_config.yml中使用的 URL。例如，如果變數是site.github.url ，您需要加入以下內容：
```
 github :
  zip_url : http://example.com/download.zip
  another_url : another value
```
當您的網站建置完成後，Jekyll 將使用您指定的 URL，而不是 GitHub 提供的預設 URL。

注意：您必須刪除site.前綴，每個變數名稱（在github.之後）應該在github:下面縮排兩個空格。

有關更多信息，請參閱 Jekyll 變數文件。

路線圖

請參閱未決問題以取得建議功能（和已知問題）的清單。

專案理念

Minimal 主題旨在讓 GitHub Pages 使用者快速輕鬆地創建他們的第一個（或第 100 個）網站。主題應該滿足絕大多數用戶的開箱即用需求，避免簡單性而不是靈活性，並為用戶提供選擇額外複雜性的機會（如果他們有特定需求或希望進一步定制他們的體驗）（例如添加自定義CSS 或修改預設佈局）。它看起來也應該很棒，但這是不言而喻的。