Substitutions in customized TOC?

[Kevin Cole]

TL;RL: Substitutions are working in all my .rst files except for the titles listed in my index.rst table of contents. What am I doing wrong?

Details:

I am using Sphinx and LilyPond to make an online songbook. My song page templates are all roughly the same with only the song title, score, and optionally, notes changing:

_________________________________

.. Dupont Circle Songbook

.. include:: <isonum.txt>
.. include:: /_static/isonum.txt

.. rst-class:: obscure

##############
The Song Title
##############

.. score:: song_title

.. note::

   Notes about the song.

_________________________________

"obscure" is a class that sets <h1> to "display:none" because the song title is embedded in the SVG generated by my ".. score::" directive.

Which brings me to the table of contents. I'm also using custom bullets for songs (and regular bullets for text chapters like "Preface" or "Introduction")

__________________________________________________________

Table of Contents
=================

.. toctree::
   :hidden:
   :maxdepth: 2

   Preface to the Online Edition <online>

   The Song 1 Title   <song_1_title>
   The Song 2 Title   <song_2_title>

   ...

   Cruisc |iacute|  L |aacute| n   <cruiscin_lan>

   ...

   The Song N Title   <song_n_title>

* :doc:`Preface to the Online Edition <online>`

  - :doc:`The Song 1 Title   <song_1_title>`
  - :doc:`The Song 2 Title   <song_2_title>`

  ...

  - :doc:`Cruisc |iacute|  L |aacute| n   <cruiscin_lan>`

  ...
  - :doc:`The Song N Title   <song_n_title>`

__________________________________________________________

Using the |iacute| and |aacute| substitutions works in the 

.. note:: directive in the song.rst file, but the Table of Contents in index.rst does not do the substitution.

The song title on the song_title.rst file uses the subtitutions also. i.e.

#############################
Cruisc |iacute|  L |aacute| n

#############################

What am I doing wrong?

Thanks.