search

christopherkenny / ctk-article

A general purpose article template for Quarto with a Typst backend
MIT License
4 stars 2 forks source link

References placement #1

Open aloport opened 1 month ago

aloport commented 1 month ago

Title: References Placement and Formatting Issue with citeproc Settings

Current Behavior

The template currently includes the following note about references:

### References
Reference are automatically placed at the end of the document.
The magic refs div does not current working in typst when `citeproc: false`, see [this issue](https://github.com/quarto-dev/quarto-cli/issues/8710).
To move the refs, set `citeproc: true` in the YAML.
::: {#refs}
:::

This accurately describes the behavior, but it leads to a trade-off in functionality.

Problem

When setting citeproc: true in the YAML as suggested:

  1. References are correctly placed where they are supposed to.
  2. However, the reference links are not clickable.
  3. The references do not appear in a distinct color, reducing their visibility.

When keeping citeproc: false:

  1. The magic refs div doesn't work as expected in Typst.
  2. But the reference links remain clickable and distinctly colored.

Desired Behavior

Ideally, we would like to:

  1. Keep the references at their right place in the document.
  2. Maintain clickable reference links.
  3. Preserve the distinct coloring of references.

Question

Is there a way to achieve this desired behavior? Perhaps a configuration or workaround that allows us to keep the references in place while maintaining the functionality and styling of the reference links?

Thank you for your time and effort in developing this template! I really like it.

christopherkenny commented 1 month ago

Hi @aloport. Thank you for reporting your issue. Unfortunately, this is directly a function of the upstream issue https://github.com/quarto-dev/quarto-cli/issues/8710. When citeproc: true, the text of the @example becomes (Example YYYY) and drops the link, so it can't be styled in the same way.