Sunday, February 22, 2009

Formatting README.rdoc on github

Github has a neat feature that displays a README file, that it finds in the root directory of a project, on the project page. The README formatting page describes a number of different formats that it will render based on the file extension. I tried renaming to README.rdoc but it still rendered as plain text. The trouble was that the file was intended to be used with a full RDOC site for the source. When I removed the "link" tags from the file and pushed ... Github renders it correctly ... Hurrah!

6 comments :

  1. The following code rendered for me ok:

    {demo app}[http://github.com/neworganizing/rails_vip_demo]

    ReplyDelete
  2. Matt, my problem links were of the form:

    {Operations}[link:classes/Nobbie/Wx/Operations.html]

    that is, they were RDoc relative links to generated pages that don't exist in Github.

    ReplyDelete
  3. Even without 'link:' I can't get that rendered correctly...

    ReplyDelete
  4. @Schneider: If you have a question I might be able to help.

    ReplyDelete
  5. OK, here it is: http://github.com/dudektria/ruby-finance
    It can't be rendered well, and there's no 'link:'.

    ReplyDelete
  6. @Schneider: For a README.rdoc to render on github apparently the lines cannot begin with Ruby comment characters. Who knew!

    ReplyDelete