如何在GitHub Pages中使用2个Markdown文件创建简单的2页网站?

12

我正在尝试在GitHub Pages上制作一个非常简单的网站,它只有两个页面:主页和关于页面。

我希望每个页面都可以从Markdown文件生成。

主页很容易,我只需将主页的Markdown放入README.md中,然后它就会显示在myusername.github.io上。

是否有一种简单的方法添加第二个Markdown页面?

我知道GitHub Pages使用Jekyll,并且我可以通过创建整个Jekyll博客来实现此目标,但是对于我想做的事情来说,那似乎有些大题小做。有没有最简单的方法将Markdown文件添加到GitHub存储库中,并拥有渲染它的工作URL。

这不是博客。永远不会超过这两页。


只需阅读此内容并按照说明操作:https://help.github.com/categories/github-pages-basics/ 这应该已经足够了。不必直接使用Jekyll,GitHub会为您完成。 - Pavel S.
3个回答

7
我解决了这个问题。 关键是在关于Markdown的顶部包含此内容。
---
title: Title
---

这可以帮助 Github Pages 知道该页面是需要呈现的 Markdown 文件。

About 页面可以放在仓库里的 about.md 文件中,并从主 README.md 文件中链接到它。


5

在GH-Pages上可以创建多个.MD页面

  1. 创建一个新文件,命名为about.md
  2. 在该文件的顶部添加以下内容:
---
title: ABOUT PAGE
layout: template
filename: about.md
--- 
  1. 使用以下代码将 about.md 链接到我们的 Readme.md 文件中:
Go to [about page](about.md)
  1. 提交你的更改并将它们推送到gh-pages分支

现在,当你访问YOURGITHUBNAME.github.io/YOURPROJECTNAME/about.md时,你应该能看到你的about.md的内容,使用你选择的主题格式化过。


你好,Amit。感谢你的回答,非常有帮助。但是,你能告诉我如何更改第二个md文件的布局吗?在这里,你使用了“template”作为布局,但是否有其他可用的布局选项?我尝试过写“Cayman”和“Dinky”,但它们都没有起作用。非常感谢你的帮助。 - Soumyadip Sarkar
@SoumyadipSarkar 你尝试过在设置中使用“选择模板”选项或在about.md中提及它们来设置这些模板吗? - Amit Pathak
你可能也想查看这个链接 - Amit Pathak
我猜你在谈论“更改主题”选项,我试了一下,然后生成了一个index.md和_config.yml文件,在那个_config.yml文件中,jekyll-theme-cayman已经设置为主题。但正如你所提到的,我尝试从那个链接设置为theme: minima,但整个布局变成了空白,并且就像一个空白的标记预览。链接 - Soumyadip Sarkar
1
我认为除非我们创建两个不同的存储库并使用不同的主题,否则我们无法做到这一点。您可以利用layouts,需要自己定义或从jekyll主题派生。以下是一些链接,可帮助您解决问题:链接1 链接2 链接3 链接4 - Amit Pathak

2

只需创建一个名为about.md的文件,并填写内容。
然后,您可以通过以下方式从README.md链接到about.md:
[关于此文本的链接文本](about.md)


1
这个不起作用。这显示了Markdown的原始文本,而没有对其进行编辑。 - quantumbutterfly
@quantumbutterfly 我觉得现在这个可以了 - Abdelrahman Shoman

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接