ReadTheDocs에 "Last updated on"이 표시되지 않는 이유

Question

ReadTheDocs에서 렌더링되고 호스팅 한 documentation이 있습니다. 로컬 HTML 문서가 오늘 날짜를 표시하는 반면, "Last updated on"행 대신 Git commit 해시를 보여줍니다.

로컬 버전 :

온라인 버전 다음 docs/conf.py 파일에서

, 나는 비 None 값으로 html_last_updated_fmt 구성 -> 빈 문자열입니다.
출처 : https://github.com/VLSI-EDA/PoC/blob/master/docs/conf.py#L173-L176

왜 내 설정이 ReadTheDocs에서 무시됩니까? 마지막으로 업데이트 된 날짜를 얻으려면 어떻게해야합니까?

Answer 1

수정 정보가있는 경우 ReadTheDocs 기본 테마는 Last updated 정보를 개정 정보로 바꿉니다 (here's the commit that introduced the change).

이 문제를 해결하려면 사용자 지정 테마를 만들고 사용할 수 있습니다. 이것은 사소하지 않습니다. 다음과 같이 진행하십시오 :

• 포크 the ReadTheDocs 테마.
• 위에서 언급 한 커밋의 변경을 "실행 취소"합니다.
• 설명서의 requirements 파일에서 포크를 참조하십시오. Here, 요구 사항 파일의 예를 볼 수 있습니다. 그러나 파일은 일반적으로 저장소의 루트 디렉토리에 있고 이름은 requirements.txt이어야합니다.
• 프로젝트가 installation of custom requirements을 지원하도록 구성되어 있는지 확인하십시오.
• 모든 변경 사항을 GitHub에 푸시합니다.
• ReadTheDocs에서 프로젝트를 다시 빌드하십시오.