Я начал с проекта, в котором три книги. Мы конвертировали его в Sphinx/RST из Flare. Первоначально мы были удовлетворены простой структурой из трех книг, которые выводятся в PDF, и трех отдельных веб-стеков. Несмотря на простоту, этот метод недостаточен: поиск по сети должен повторяться на каждом из трех "сайтов" (по одному для каждой книги), чтобы выполнить полный поиск.
Я попытался построить вокруг этого и объединить три книги в общей иерархии: три книги теперь находятся в каталоге Docs. Они прекрасно работают как LaTeX/PDF и HTML. Изменение tox.ini для использования Docs в качестве корневого каталога приводит меня к тому, что я получаю успешное начало сборки (reading sources... [100%]) прежде чем я получу ошибку:
/Users/william/<Repo>/Docs/<Book1>/Configuration/Optional_Configuration.rst:210:image file not readable: Resources/Images/image_name.png
make: *** [html] Error 2
ERROR: InvocationError for command '/usr/bin/make html' (exited with code 2)
Проблема заключается в том, что ссылка в документе RST указывает на /Resources/Images/image_name.png: для заданий, которые создают отдельные книги, корень находится в каталоге, а Sphinx ищет графику в /Resources /Images /image_name .png. Я подозреваю, но не могу доказать, что на полном сайте, который я создаю, Sphinx рассматривает root как Docs /, но RST жестко указывает на /Resources / без значения между ними, и это вызывает беда. Если это правда, как я могу сказать Sphinx (или tox, или make), чтобы предвосхитить (или иным образом вести себя так, как если бы он был правильно информирован), что root - это Docs / и что путь должен включать как часть пути? Я довольно много разбирался с tox.ini и Makefile на разных уровнях исходного кода, и я продолжаю получать эту ошибку "файл не читается".
Спасибо,
--William