search

todogroup / ospology

📖 OSPOlogy - The Study of OSPOs
https://todogroup.org
Creative Commons Attribution 4.0 International
184 stars 82 forks source link

[OSPO Book] Table of contents #360

Open cornelius opened 11 months ago

cornelius commented 11 months ago

The table of content contains the list of chapters and some notes about their content. It would be good to link the entries in the table of content to the actual chapters.

I'm not sure how to do this with hugo in a way that it shows up on the generated site correctly. If you have a hint for me how to do it, I can also come up with a pull request.

For the chapters which aren't completed yet there is no content on the generated site yet. So it would be good to add a note that it is work in progress instead of the link.

alice-sowerby commented 1 month ago

I am repurposing this issue to represent the Table of Contents (TOC) on the Project Board as the TOC will need to be updated regularly.

alice-sowerby commented 1 month ago

I think it would also be worth including "Chapter X" at the start of each chapter, as it's unclear in the live book which chapter is which (and the chapters are numbered in the TOC). The alternative would be to remove chapter numbers altogether, but I think that is less useful.

koozz commented 1 month ago

I thought it was just the page link + the anchor (just like what you get on hovering a heading in the GitHub markdown docs):

image

02-chapter.md#supply-chain-and-open-source is the link according to GitHub, but Hugo will render it as 02-chapter/#supply-chain-and-open-source.