GitHub README.html

Question

Ho una vasta documentazione per un progetto che vorrei rendere open source (tramite github).

Il problema è che github README non supporta i file .html.

Ho provato html2text con risultati assolutamente orrendi.

C'è un modo facile e veloce per convertire l'output di tipo naturalDocs (o qualsiasi documentazione html) in un readme git?

Grazie ragazzi.

Answer 1

È possibile utilizzare GitHub Pages per pubblicare la documentazione e scrivere una breve informazione con un collegamento a quello nel file README utilizzando il formato RDoc o Markdown.

Answer 2

Si potrebbe convertire "indietro" per Markdown tramite uno dei seguenti metodi:

1. http://fvsch.com/code/remarkdown/
2. https://tibastral.github.io/markdownify/
3. http://johnmacfarlane.net/pandoc/try

Buona fortuna