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

Issue with reference to programming languages table in example.md #102

Open
cthoyt opened this issue Feb 13, 2025 · 0 comments · May be fixed by #103
Open

Issue with reference to programming languages table in example.md #102

cthoyt opened this issue Feb 13, 2025 · 0 comments · May be fixed by #103

Comments

@cthoyt
Copy link
Contributor

cthoyt commented Feb 13, 2025

There appears to be a bug in the way the programming languages table is referenced in the example paper on the following lines:

inara/example/paper.md

Lines 423 to 424 in 92554be

: Comparison of programming languages used in the publishing tool.
[]{label="proglangs"}

using the label="proglangs" syntax appears to not generate a reference that is compatible with either the \ref{} nor \autoref{} commands used in

inara/example/paper.md

Lines 420 to 421 in 92554be

`\autoref{proglangs}` yields "\autoref{proglangs}", while
`\ref{proglangs}` gives "\ref{proglangs}".

This is confirmed in the latest build log from the 1.1.5 release of Inara at https://github.com/openjournals/inara/actions/runs/12199377342/job/34033120544#step:4:5419. Despite this, it still builds the draft and production PDFs. The draft PDF is downloadable from https://github.com/openjournals/inara/actions/runs/12199377342 as it renders like:

Image

Potential Solution

I think the correct syntax in the markdown file would be:

: Comparison of programming languages used in the publishing tool. 
   []{#proglangs}

This matches the syntax for assigning references to images, such as in

inara/example/paper.md

Lines 404 to 406 in 92554be

![View of coastal dunes in a nature reserve on Sylt, an island in the
North Sea. Sylt (Danish: *Slid*) is Germany's northernmost
island.](images/sylt.jpg){#sylt width="100%"}

Trying the Solution

I haven't been able to test this locally since I'm on macOS and there's no usable docker builds from pandoc 3.2, which is the one used in Inara currently.

I opened a PR that triggered this workflow, but it created several other unrelated issues.

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

Successfully merging a pull request may close this issue.

1 participant