Add anchors in document

[P1409332]

Hey there,

I've been using Sysreptor for my certifications writing and the tool is great !

However, I've found myself wanting to reference precise parts of my report. I know you can reference findings, but I sometimes would like to send the reader to the specific section of it.

My suggestion would be to add the ability to set an anchor tag at any point and the ability to reference it in the document, the same way it is done with findings (with a list to choose from).

Thanks !

[MWedl]

Hi,
it is possible to reference arbitrary anchors in the design's HTML/Vue code and in project's markdown fields. A target element with the referenced id/anchor needs to exist in the final rendered HTML for references to work. See https://docs.sysreptor.com/reporting/references/

<section><h1 id="section-id">Section title</h1> ... </section>
Section heading reference: [](#section-id)

![SQL Injection](/assets/name/image.png){#sqli}
Figure reference: [](#sqli) (e.g. rendered as "Figure 3")

Generic reference: [Reference](#element-id)

It is not possible to provide a full list of anchors to reference in a dropdown menu, because the full list of anchors is only known during PDF rendering. The reason is that anchors can be defined anywhere in findings, sections, designs and can also be dynamically generated via the design's HTML/Vue template language.

[P1409332]

Hey,

Thank you for your reply and for letting me know of this possiblity !

Would it be feasable to add an "anchor" (and "anchor reference") icon(s) in the toolbar to insert one in the text ? If I'm understanding correctly, the user would need to memorize and write the correct ID when referencing it later.

Thank you.

[MWedl]

I'm not sure if this really helps users that much. The toolbar action would need to generate unique IDs to avoid duplicate IDs. We could use a random name. The downside to random IDs is that you do not know at first sight what is referenced when seeing only the (random) reference link. You have to search for the ID of the referenced element. In order to have descriptive names, users have to change the generated random IDs, which makes the whole ID generation useless.

Because of that, I think it is better to not offer an toolbar action and let users define their reference IDs manually, allowing them to follow their own naming conventions.