2013-02-25 3 views
6

오픈 소스 프로젝트의 설명서를 Github Pages로 옮길 예정이지만 .rst 파일을 옮기는 데 어려움이 있습니다."github pages"사이트에서 .rst보기

코드에 here이 표시되는 ReadMe.rst가 있습니다. 해당 페이지에 우리의 main documentation page에서 링크하고 싶습니다. 그러나 GitHub은 .rst를 HTML로 렌더링하지 않으므로 the link을 클릭하면 브라우저가 .rst 파일의 텍스트를 다운로드하기 만합니다.

물론 .rst를 HTML로 렌더링하는 도구가 있지만 심각한 추가 단계입니다. .rst를 사용하기 시작한 이유는 GitHub가 코드 페이지에서 자동으로 렌더링하기 때문입니다. Github Pages에서 자동 렌더링이 발생하는 방법이있을 것이라고 생각합니다 ...

+0

찾았습니까? 나는 똑같은 문제에 직면 해있다. – dmeu

+0

아니, 우리는 불행히도 그것을 포기했다. :-(결과가있는 경우 여기에 업데이트하십시오. –

+0

@TomSwirly 링크를 따라 가면 README.rst 파일을 렌더링하기 위해 스핑크스를 사용하기로 결정한 것처럼 보입니다. https://github.com/mangalam-research/wed) (아직 구현되지 않았습니다.) – Louis

답변

2

GitHub Pages에는 .rst/RestructuredText가 지원되지 않습니다. HTML에 대한 Markdown 및 Textile 변환 만 지원합니다.