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

Convey information when a footnote label rendered in the text differs from the label in the note #11

Open
gimsieke opened this issue Jul 24, 2017 · 3 comments

Comments

@gimsieke
Copy link
Contributor

In OOXML: <w:footnoteReference w:customMarkFollows="1" w:id="…"/>, followed by w:t with the label that is rendered in the text.
It is not clear whether DocBook’s label attribute is intended to convey the label rendered in the note or in the text. Since we only use phrase[@role='hub:identifier'] to mark up the note label, we could use @label for the differing text label. Otherwise we can maybe use @xreflabel.

@mkraetke
Copy link
Member

mkraetke commented Jul 24, 2017

The DocBook documentation states that @label identifies the desired footnote mark. In this sense, it would be an appropriate choice. The term footnote mark is commonly used for marks in the text (e.g. LaTeX \footnotemark).

@gimsieke
Copy link
Contributor Author

gimsieke commented Jul 24, 2017

I think DocBook’s label attribute is meant to set both marks at once.

@mkraetke
Copy link
Member

mkraetke commented Jul 24, 2017

If you are afraid that the semantics of label is too ambiguous, then I would suggest to use xreflabel. Here is a brief example:

<footnote>
  <para role="Funotentext" css:text-align="left">
    <phrase role="hub:identifier" xreflabel="*">1</phrase>
    <phrase role="hub:separator" xml:space="preserve"> </phrase>
      Footnote text
  </para>
</footnote>

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

2 participants