Skip to content

Support cross-referencing within the template text #350

Description

@OliverTod

Feature request:
Based on the existing practice of using automatic cross references in MSword, it would be good to have a way to easily and dynamically cross reference within the contract text. This could be references to a heading (for example, the title of the document, a schedule or a clause), a specific numbered paragraph or even a span of text within a paragraph (though this is rare).

This may already be possible using html tags or the markdown syntax: [link title](link)

The main requirement is that the link title text should match the paragraph number of the text it references. That is, editing the text (ie adding or deleting lines so that the referenced paragraph number changes) should result in the link title changing also. The link is to the particular paragraph text and not the position of that text in the document.

We need to be cautious that adding this functionality will not disrupt the readability of the raw-markdown file. I am not sure that adding html tags will be an encouraging step for many people.

My initial thoughts are:

  • this could be achieved by allocating (and then hiding) an id to every line of text which can then be referenced (I think this is how MSword does it) OR requiring users to add their own reference ids to text that they want to link to; and
  • whether as part of the editor or separately, there will need to be a way for the link title to be updated when the paragraph number changes.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions