Tell Jekyll（在github頁面上）將README.md轉換爲README.html，而不是index.html

我正在使用Jekyll在Github Pages上使用「Dinky」主題構建項目網頁，。Tell Jekyll（在github頁面上）將README.md轉換爲README.html，而不是index.html

README.md會自動轉換爲index.html，這對快速入門非常有幫助。

不過，我想有一個單獨編寫的主頁index.md，而是轉換到README.mdREADME.html（因爲它與大多數*.md文件一樣）。當我添加我的index.md時，Jekyll將其轉換爲index.html，但希望現在完全沒有轉換，因此README.md可能會有index.html作爲README.md和index.md的目標，後者將獲勝。

我該如何告訴Jekyll返回使用README.html作爲其轉換目標README.md？

優選地，我想，不需要在README.md本身加入配置數據，讓我能繼續保持README.md同步與在master分支人類可讀版本的溶液。

重現它的注意事項：所有這些都是在通過Github Pages在線構建和當地的jekyll build。我正在使用的唯一定製jekyll設置是該網站的Gemfile中的gem 'github-pages', group: :jekyll_plugins，以及該網站的_config.yml中的theme: jekyll-theme-dinky。

它似乎是特定於Github Pages主題，但不是Dinky主題：Dinky旁邊的其他主題展現出相同的行爲，但似乎並不是Jekyll站點。

編輯：感謝@wasthishelpful提供了非常有用的評論和部分答案。添加YAML frontmatter塊到README.md設置permalink: README.html做我正在尋找。不幸的是，我仍然無法通過修改_config.yml找到實現相同效果的方法：例如，添加一個frontmatter默認那裏

defaults: 
    - 
    scope: 
     path: "README.md" 
    values: 
     permalink: "README.html"

似乎沒有任何效果。（我之前和行theme: jekyll-theme-dinky後都試過有和沒有周圍的文件名引號，和）

來源

2017-05-10 PLL

訪問Github上時Readme.md顯示在回購的根簡要概述，但他們都不在哲基爾網站 – marcanuy

生成的index.html @marcanuy：我知道Jekyll通常不會將'README.md'轉換爲'index.html'，但是當使用帶有主題的Github Pages時，我向你保證。我將編輯我的答案以澄清我嘗試過的內容，但是簡要地說，這發生在本地構建中，並且通過Github Pages提供時，除了用於Github Pages主題的設置之外，我沒有任何本地自定義設置。 – PLL

我無法複製它，從來沒有看到README.md被轉換爲'index.html'。 – marcanuy

您可以使用permalink在README.md：

--- 
permalink: README.html 
--- 

TypeTheory: the mathematical study of type theories, in univalent foundations 
========== 

Code on C-systems, D-systems, ...

您也可以使用front matter defaults在_config.yml：

defaults: 
    - 
    scope: 
     path: "README.md" 
    values: 
     permalink: "README.html"

但你仍然需要在README.md一個前面的問題，使之由傑基爾（即使是空的）解析：

--- 
--- 

TypeTheory: the mathematical study of type theories, in univalent foundations 
========== 

Code on C-systems, D-systems, ...

來源

2017-05-11 19:59:43 wasthishelpful

我瞭解到，如果添加任何 frontmatter自述，它停止轉動README.md到的index.html。我發現這個意外加入這個frontmatter我README.md

--- 
title: Design Your Bot 
---

來源

2017-11-06 20:36:14 Melissa

Tell Jekyll（在github頁面上）將README.md轉換爲README.html，而不是index.html

回答

相關問題