title link error for some lectures

[shlff]

There is a title link error for some lectures:

some lectures don't have links to their titles.

Please find an example as follows (left: without title links (in black), right: with title links (in blue)):

[jstac]

Thanks @shlff , nice spot.

[shlff]

Thanks for your comments during the meeting @mmcky . It would be great to get your advice here.

[chappiewuzefan]

Hi Team, I can't push my changes to this repository.

Below is what I found:

Normally, Sphnix will automatically create each title heading with the anchor link, like below (the little icon):

But if you want the title to be blue and clickable, should add codes below (remove the / ):

/```{contents} The Solow-Swan Growth Model
:depth: 2
/```

and it will generate below table:

depth means how many levels subtitles you have (if you have ####, then it should put 4 here)

below code will exist in some of the lectures:

/```{contents} The Solow-Swan Growth Model
:depth: 2
/```

/```{index} single: credits
/```

In this case, there is no table anymore, onle blue titles.

Both cases using depth, the titles are blue and clickable, but it will always point to the first subtitle. So I'm wondering what is we want? We want it all black (default rendered page have the little icon for anchor links) or the table shows in the picture

[shlff]

Thanks @chappiewuzefan .

IMO, the first priority is to have a uniform standard for the title links across all lectures.

Second, the related style we adopted in other lecture series (intermedia, advanced) is the one with blue and clickable titles but without the table.

So from my point of view, one good solution is only to have blue and clickable titles.

Also as @mmcky mentioned in last week's sprint it would be a more elegant solution to put the control code in the _config.yml or _toc.yml so that we don't need to update the style control in every lecture.

It is helpful to discuss different solutions and outcomes here. Once we decide, updating the standard to the manual would be great.

[chappiewuzefan]

Thanks for clarifying, in this case , only add below code to each lec will solve it (through yml)

/{contents} The Solow-Swan Growth Model :depth: 2 /

Need to decide the depth automatically or just put a big number for example 9 (cause it is rare for the subtitles go to the level 9)