diff --git a/docs/source/usage_notes.rst b/docs/source/usage_notes.rst index 38e6a7ce..b0b46143 100644 --- a/docs/source/usage_notes.rst +++ b/docs/source/usage_notes.rst @@ -24,7 +24,8 @@ Tags in Notes Each new heading in a note can have a tag associated with it. The format of a tag is ``@tag: tagname``, where tagname is a unique identifier. Tags can then be referenced in the novel documents, or cross-referenced in other notes, and will show up in the outline view and in the -back-reference panel when a document is being viewed. +back-reference panel when a document is being viewed. See :ref:`a_struct_tags` for how to reference +notes. The syntax highlighter will alert the user that the keyword is correctly used and that the tag is allowed, that is, the tag is unique. Duplicate tags should be detected as long as the index is up diff --git a/docs/source/usage_structure.rst b/docs/source/usage_structure.rst index 385d16d6..8bfe81d5 100644 --- a/docs/source/usage_structure.rst +++ b/docs/source/usage_structure.rst @@ -86,10 +86,11 @@ more details. Tag References ============== -Each text partition indicated by a heading of any level, can contain references to tags set in the -supporting notes of the project. The references are gathered by the indexer and used to generate -an outline view on the :guilabel:`Outline` tab of how the different parts of the novel are -connected. +Each text partition, indicated by a heading of any level, can contain references to tags set in the +supporting notes of the project. The references are gathered by the indexer and used to generate an +outline view on the :guilabel:`Outline` tab of how the different parts of the novel are connected. +This section covers how to set references to tags. See :ref:`a_notes_tags` for how to define tags +the references can point to. References and tags are also clickable in the document editor and viewer, making it easy to navigate between reference notes while writing. Clicked links are always opened in the view panel.