Markup: readme.rst suddenly not rendering, not even old versions which were rendering previously

Created on 17 Mar 2017  路  7Comments  路  Source: github/markup

The repo is here: https://github.com/Karplus-Lab-OSU/ensemblator

Previously, even this version of the readme was rendering correctly. Now, I can't get it to render at all, even if I try old versions of the readme.

rst2html.py and pandoc both process the rst file with no errors.

Converting the rst file to md causes it to render correctly, but really if I wanted to use markdown I would just use markdown.

Any ideas why this is happening?

Most helpful comment

@vmg Can you please take a look at the fix again? I don't think it's acceptable to ask people maintaining several (open source) projects to touch near all of their READMEs just to make them render correctly again (as default READMEs).

All 7 comments

Same here:

  • old rst that were rendering are not rendering... I notice that certain tags are rendered (in cache ?) but if I take a commit before (even if README.rst is not changed), then it is not rendered (probably out of cache, if you are using a cache).
  • I have check with rst2html.py AND the current master of github's version of rest2html.py found here:
    https://github.com/github/markup/blob/master/lib/github/commands/rest2html , of course no problems nor warning of any type.
  • I checked on other project of mine that I didn't touch for a while, same symptoms: it doesn't render anymore. Checked on well-known project, same problem: here on cpython's repository: https://github.com/python/cpython/tree/1bb0f3762ec5104014aeed0ae6e9d64598d8fcac (this commit is the current last commit on master, that would display correctly if you'd ask the front page on master despite being the same commit).

Apparently this if fixed now: https://twitter.com/vmg/status/842697017830850561

I believe (and have experimented on other branches) that a new push will re render things :+1:

EDIT Doesn't look like it's fixed on our master branch.

Fixed after I forced a change in the file.

I hope this is really going to be fixed properly. I have loads of repositories with README.rst files that are now broken. I don't plan to touch them all just to make them appear nicely again.

Interestingly, the files display correctly when displayed as blob, though not as a default README:

Okay as discussed the issue seems to be fixed. Made a small (insignificant) change and did a push, suddenly the readme renders correctly!

Great!

@vmg Can you please take a look at the fix again? I don't think it's acceptable to ask people maintaining several (open source) projects to touch near all of their READMEs just to make them render correctly again (as default READMEs).

Was this page helpful?
0 / 5 - 0 ratings