6
Przenoszę dokumentację projektu z otwartym źródłem do stron Github, ale utknąłem na przenoszeniu plików .rst.Wyświetlanie .rst w witrynie "github pages"
Mamy ReadMe.rst, który można zobaczyć here w kodzie. Chciałbym link do tej strony z naszego main documentation page, ale GitHub nie renderuje .rst jako HTML, więc przeglądarka po prostu pobiera tekst pliku .rst po kliknięciu na the link).
Istnieją oczywiście narzędzia do renderowania .rst jako HTML, ale to poważny dodatkowy krok. Cały powód, dla którego zaczęliśmy używać .rst, w całości wynikał z tego, że GitHub automatycznie renderuje go na stronach kodowych. Można by pomyśleć, że istnieje jakiś sposób, aby uzyskać to authomatic rendering dla Github Pages ...
Znalazłeś coś? Mam do czynienia z tym samym problemem – dmeu
Nie - po prostu zrezygnowaliśmy z tego niestety. :-(Zaktualizuj nas tutaj, jeśli masz jakieś wyniki –
@TomSwirly Podążając za twoimi linkami, wygląda na to, że zdecydowałeś się użyć sfinksa do renderowania plików README.rst. To jest właśnie rozwiązanie, które wybrałem dla [one] (https://github.com/mangalam-research/wed) moich repozytoriów. (Nie zaimplementowano jeszcze). – Louis