Comment changer l'apparence des fichiers en mode org sur Github?

8

Github prend en charge les fichiers en mode org et dispose d'un moteur de rendu qui analyse les fichiers .org et les convertit au format HTML. Les en-têtes apparaissent dans une police plus grande, les tableaux de texte sont convertis en tableaux HTML graphiques, etc.

Existe-t-il un moyen de contrôler la façon dont les fichiers .org apparaissent sur Github?

J'ai essayé d'ajouter des options d'exportation de la manière habituelle

#+OPTIONS:   H:2 toc:t 

mais les options ne sont pas reflétées.

Est-ce possible? Sinon, existe-t-il une solution de contournement pour afficher les fichiers en mode organisation via Github?

incandescentman
la source
1
Par curiosité, avez-vous un lien vers une page de projet GitHub qui montre comment GitHub rend les fichiers en mode org?
sschuberth

Réponses:

7

Le balisage github utilise org-ruby pour convertir le mode organisation en HTML. Il est assez basique et son README dit:

[...] Actuellement, vous ne pouvez pas faire grand-chose pour personnaliser la conversion. La conversion textile fournie est optimisée pour extraire le «contenu» du fichier org par opposition aux «métadonnées».

Ce n'est pas très précis, mais il semble que ce que vous essayez de faire n'est pas possible. Si vous regardez la source, vous voyez qu'elle utilise très peu d'options comme «f» ou «num». Mais «toc» et «H» ne sont pas utilisés.

Je ne connais aucune solution de contournement, sauf pour étendre org-ruby .

ahilsend
la source