简体   繁体   English

在Github创建github.io配置文件时.md.ZFC35FDC70D5FC69D236988.A文件有什么区别?

[英]In Github when creating github.io profile what the difference of .md .html .rmd files?

I'm trying to create a github.io profile.我正在尝试创建一个github.io配置文件。

May I know the difference between of.md.html.rmd files?我可以知道 of.md.html.rmd 文件之间的区别吗?

For example, I see the same file name with different filetypes like Readme.md vs Readme.html XXX.rmd vs XXX.html例如,我看到具有不同文件类型的相同文件名,例如Readme.md vs Readme.html XXX.rmd vs XXX.html

github.io (aka Github pages) can create a website from either github.io(又名 Github 页面)可以从任一

  • html with optional css html带可选css
  • Markdown files ( .md and .rmd ) Markdown 文件( .md.rmd
  • A combination of the above以上的组合

It uses a set of tools called Jekyll and kramdown to translate markdown files into html to be displayed as part of the website.它使用一组名为Jekyllkramdown的工具将 markdown 文件转换为 html 以显示为网站的一部分。

Markdown files are a file format generally used for producing documentation in github on similar websites, and has a mopre streamlined syntax for that purpose than html. Markdown 文件是一种文件格式,通常用于在类似网站上以 github 生成文档,并且具有比 html 更简洁的语法。 You can try it out at https://stackedit.io您可以在https://stackedit.io尝试一下

The use of markdown for Github Pages is however completely optional and you may use only html if you wish.然而,markdown 用于 Github 页面是完全可选的,如果您愿意,您可以仅使用 html。 You can follow the guide at https://jmcglone.com/guides/github-pages show you how to make a github pages site with html.您可以按照https://jmcglone.com/guides/github-pages上的指南向您展示如何使用 html 制作 github 页面站点。 Stop when you get to the section Using Jekyll with GitHub Pages if you don't wish to incorporate any markdown.如果您不想合并任何 markdown,请在到达将 Jekyll 与 GitHub 页面结合使用部分时停止。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM