Страницы Github: /README.md относительные ссылки на другие файлы foo / README.md, но не работают, если существует foo / index. html

Question

Мое репо, которое также является github-страницей, имеет свой основной README.md с множеством ссылок на README.md в подкаталогах репозитория:

[models](./models/README.md)

Ghpage работает хорошо. Он преобразует уценку в html.

Но он не работает для каталогов, которые также имеют индекс. html файл! Затем он просто показывает текст уценки, а не его html.

И если я переименую файл index. html, проблема исчезнет!

Мой вопрос: что вызывает этот? Может быть, проблема с Джекилом? Настройка файла конфигурации? Как сделать так, чтобы относительные ссылки на файлы .md работали даже при наличии файла index. html?

Спасибо!

Answer 1

Нашел ответ здесь: https://github.community/t/linking-files-into-folders/115936/2

В частности, если index. html и README.md находятся в одном репо, index. html выигрывает:

Ваш репозиторий содержит как файл README.md, так и файл index. html. Это представляет собой конфликт, так как GitHub Pages предназначен для публикации sh обоих файлов как index. html. В этих условиях файл index. html в вашем репозитории имеет приоритет, а GitHub Pages пропускает процесс преобразования вашего файла README.md в HTML.

Это имеет большой смысл , но, увы, плохо документирован. Надеюсь, люди найдут его здесь.