This library is the first step of a journey that every markup file in a repository goes on before it is rendered on GitHub.com:
github-markup
selects an underlying library to convert the raw markup to HTML. See the list of supported markup formats below.script
tags, inline-styles, and class
or id
attributes.Please note that only the first step is covered by this gem — the rest happens on GitHub.com. In particular, markup
itself does no sanitization of the resulting HTML, as it expects that to be covered by whatever pipeline is consuming the HTML.
Please see our contributing guidelines before reporting an issue.
The following markups are supported. The dependencies listed are required if
you wish to run the library. You can also run script/bootstrap
to fetch them all.
gem install commonmarker
(https://github.com/gjtorikian/commonmarker)gem install RedCloth
(https://github.com/jgarber/redcloth)gem install rdoc -v 3.6.1
gem install org-ruby
(https://github.com/wallyqs/org-ruby)gem install creole
(https://github.com/larsch/creole)gem install wikicloth
(https://github.com/nricciar/wikicloth)pip install docutils
gem install asciidoctor
(http://asciidoctor.org)Pod::Simple::XHTML
comes with Perl >= 5.10. Lower versions should install Pod::Simple from CPAN.Pod::To::HTML
(in stdlib)gem install github-markup
or
bundle install
from this directory.
Basic form:
require 'github/markup'
GitHub::Markup.render('README.markdown', "* One\n* Two")
More realistic form:
require 'github/markup'
GitHub::Markup.render(file, File.read(file))
And a convenience form:
require 'github/markup'
GitHub::Markup.render_s(GitHub::Markups::MARKUP_MARKDOWN, "* One\n* Two")
See Contributing.
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。