Почему ReadTheDocs не показывает дату последнего обновления

У меня есть документация, подготовленная и размещенная на ReadTheDocs. Он по-прежнему показывает хэш коммита Git вместо строки «Последнее обновление», тогда как в моей локальной HTML-документации указана сегодняшняя дата.

Локальная версия: введите здесь описание изображения

Интернет-версия: введите здесь описание изображения

В файле docs/conf.py я настроил html_last_updated_fmt на значение, отличное от None -> пустая строка.
Источник: https://github.com/VLSI-EDA/PoC/blob/master/docs/conf.py#L173-L176

Почему ReadTheDocs игнорирует мои настройки? Как я могу получить последнюю обновленную дату?


python-sphinx read-the-docs configuration-files
person Paebbels    schedule 17.08.2016    source источник

Ответы (1)


arrow_upward
3
arrow_downward

Тема ReadTheDocs по умолчанию заменяет информацию Last updated информацией о версии, если она доступна (здесь фиксацию, в которой было внесено изменение).

Чтобы исправить это, вы можете создать и использовать пользовательскую тему. Это не тривиально. Действуйте следующим образом:

  • Создайте форк темы ReadTheDocs.
  • «Отменить» изменения коммита, на которые я ссылался выше.
  • Ссылка на ответвление в файле requirements вашей документации. Здесь вы можете увидеть пример файла требований . Однако файл обычно должен находиться в корневом каталоге вашего репозитория и иметь имя requirements.txt.
  • Убедитесь, что ваш проект настроен на поддержку установка пользовательских требований.
  • Отправьте все изменения на GitHub.
  • Перестройте свой проект в ReadTheDocs.
person Timotheus.Kampik    schedule 19.08.2016