Take the 2-minute tour ×
Web Applications Stack Exchange is a question and answer site for power users of web applications. It's 100% free, no registration required.

Github supports org-mode files, and has a renderer that parses .org files and converts them to HTML form. Headings appear in larger font, text tables are converted to graphical HTML tables, etc.

Is there a way to control the way .org files appear on Github?

I tried adding some export options in the usual manner

#+OPTIONS:   H:2 toc:t 

but the options are not reflected.

Is this possible? If not, is there a workaround to display org-mode files through Github?

share|improve this question

migrated from superuser.com Jun 27 '13 at 5:03

This question came from our site for computer enthusiasts and power users.

1 Answer 1

The github markup uses org-ruby to convert org-mode to HTML. It is fairly basic and its README says:

[...] Currently, you cannot do much to customize the conversion. The supplied textile conversion is optimized for extracting “content” from the orgfile as opposed to “metadata.”

That is not very specific, but it appears what you are trying to do is not possible. If you have a look at the source, you see it uses very few options like 'f', or 'num'. But 'toc', and 'H' are not being used.

I don't know of any workarounds, except to extend org-ruby.

share|improve this answer

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.