To avoid Sphinx parsing included files as standalone reStructuredText documents, use a non-.rst
extension for include files. Using .inc
(e.g. planet.inc
) is fine.
planet.inc
Hello |planet|.
earth.rst
.. |planet| replace:: Earth
.. include:: planet.inc