【问题标题】:In Github when creating github.io profile what the difference of .md .html .rmd files?在 Github 中创建 github.io 配置文件时 .md .html .rmd 文件有什么区别?
【发布时间】:2021-12-28 08:37:26
【问题描述】:

我正在尝试创建github.io 个人资料。

我可以知道 .md .html .rmd 文件之间的区别吗?

例如,我看到相同的文件名具有不同的文件类型,例如 Readme.md vs Readme.html XXX.rmd vs XXX.html

【问题讨论】:

  • 在我把这个作为答案之前,仍在为你寻找一个好的资源——但简而言之,github.io(又名 Github 页面)使用名为 Jekyll 的软件来收集 html(以及 css)文件来构建网站(通常由 html 和 css 文件描述的网站)。 Markdown 文件(.md.rmd 用于相关的 R-markdown)是在 github 和其他地方用于生成文档的文件,Jekyll 也会读取这些文件来为生成的网站的其他页面构建 html。
  • 谢谢@SamBob 我几乎不明白这一点:) — 为了简单起见,我可以知道如果我只创建 HTML 文件并将它们上传到 GitHub,我可以创建个人资料吗?我还需要创建其他文件吗?
  • 你不需要使用 markdown 文件——它们可以替代 html (尽管它们比 html 更容易编写来生成文档)。这里的说明:jmcglone.com/guides/github-pages 向您展示如何使用 html 制作 github pages 站点。当您到达Using Jekyll with GitHub Pages 部分时停止,因为这里介绍了使用 markdown 代替 html 或与 html 并排使用,您不需要使用它!
  • 如果您以后确实想尝试创建 Markdown 文件而不是 html,stackedit.io 是一个有用的创建工具。
  • 没问题,我总结了这些cmets作为答案,如果对你有帮助,如果你能接受它作为答案,我将不胜感激!

标签: html github markdown


【解决方案1】:

github.io(又名 Github 页面)可以从任何一个创建网站

  • html 可选 css
  • Markdown 文件(.md.rmd
  • 以上的组合

它使用一组名为 Jekyllkramdown 的工具将 markdown 文件转换为 html 以作为网站的一部分显示。

Markdown 文件是一种文件格式,通常用于在类似网站上的 github 中生成文档,并且为此目的比 html 具有 mopre 简化的语法。你可以试试https://stackedit.io

然而,Github 页面的降价使用是完全可选的,如果你愿意,你可以只使用 html。您可以按照https://jmcglone.com/guides/github-pages 的指南向您展示如何使用 html 制作 github 页面站点。如果您不想合并任何降价,请在到达将 Jekyll 与 GitHub Pages 结合使用部分时停止。

【讨论】:

    猜你喜欢
    • 2014-09-12
    • 2014-02-02
    • 1970-01-01
    • 2022-01-22
    • 1970-01-01
    • 1970-01-01
    • 2019-10-17
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多