Skip to content

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

Open
@cthoyt

Description

@cthoyt

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions