Sto spostando la documentazione di un progetto open source su Github Pages ma sono bloccato sullo spostamento dei file .rst.Visualizzazione di .rst all'interno di un sito "github pages"
Abbiamo un ReadMe.rst che è possibile vedere nel codice here. Vorrei collegarmi a quella pagina dal nostro main documentation page ma GitHub non rende il .rst come HTML, quindi il browser scarica semplicemente il testo del file .rst quando fai clic su the link.
Esistono naturalmente strumenti per il rendering. Il primo come HTML, ma è un ulteriore passo importante. L'intero motivo per cui abbiamo iniziato a utilizzare .rst è stato interamente perché GitHub lo rende automaticamente nelle code page. Penseresti che ci sarebbe un modo per ottenere questo rendering automatico per Github Pages ...
Hai trovato qualcosa? Sto affrontando lo stesso numero – dmeu
No - ci siamo arresi, purtroppo. :-(Aggiorna qui se hai dei risultati –
@TomSwirly Seguendo i tuoi link, sembra che tu abbia deciso di usare la sfinge per rendere i tuoi file README.rst. Questa è esattamente la soluzione che ho scelto per [uno] (https://github.com/mangalam-research/wed) dei miei repository (non ancora implementato) – Louis