1

我的应用程序的文档是一组 HTML 文件。这些 HTML 文件是我的 git repo 的一部分。如果我将这个项目放在 github 上，人们是否能够将 HTML 文档文件视为呈现的 HTML 而不是原始 HTML？

4

2 回答 2

1

简短的回答是否定的，github 不会呈现 HTML 文档/自述文件。

长答案：Github 使用此代码来呈现任何 README 文件。从它的文档可以看出，它只支持以下富文本格式：

  • .markdown、.mdown、.md
  • 。纺织品
  • .rdoc
  • .org
  • .克里奥尔语
  • .mediawiki
  • .rst
  • .asciidoc
  • 。荚

尽管有许多 HTML 到 *MARKUP_LANG* 转换器可以在一定程度上帮助您。

你也可以考虑使用Github Pages，它可以让你完全控制页面的 HTML/CSS/Js。

于 2012-10-16T04:55:47.883 回答
0

AFAIK，Github 文档在 markdown 中。并且作为 repo 一部分的 HTML 文件显示为原始 HTML。

或者，您可以使用Github 页面发布您的文档。

GitHub 支持多种格式，

支持以下标记。如果您希望运行该库，列出的依赖项是必需的。

.markdown, .mdown, .md -- gem install redcarpet (https://github.com/vmg/redcarpet)
.textile -- gem install RedCloth
.rdoc -- gem install rdoc -v 3.6.1
.org -- gem install org-ruby
.creole -- gem install creole
.mediawiki -- gem install wikicloth
.rst -- easy_install docutils
.asciidoc -- brew install asciidoc
.pod -- Pod::Simple::HTML comes with Perl >= 5.10. Lower versions should install Pod::Simple from CPAN.
于 2012-10-16T04:56:16.957 回答