Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Should we have a better \index macro? #90

Open
kbeyls opened this issue Feb 18, 2022 · 0 comments
Open

Should we have a better \index macro? #90

kbeyls opened this issue Feb 18, 2022 · 0 comments

Comments

@kbeyls
Copy link
Member

kbeyls commented Feb 18, 2022

When writing, it's easy to forget that the text in an \index{} entry is not also put in the main text.

For example,
The content of the \index{cache} is...
will render as
The content of the is.

Maybe we could construct a better macro where the content between the curly braces is also present in the main text?
Probably one of the hard parts to implement that is that the \index{} macro is only processed when LaTeX/PDF is produced, not when the HTML version of the book is produced.
We'd have to find a mechanism that works for both PDF and HTML production.

At the moment, we do not have an index in the HTML version of the book. Implementing the above idea might also help in making sure we have an index in the HTML version of the book?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant