How to - paths, references, backlinks

Im confused a bit with how to "properly" use SiYuan to take notes and ask for examples and/or advices.

Assume i want to take notes about... variables in different languages. So i make following structure:

  • notebook C#
    • nested document variable
  • notebook Java
    • nested document variable
  • and 10 times more

Later (as an example example) while in a daily note, i want to write down something about variables in Java. I start with ((variable, SiYuan gives me a list of blocks containing "variable" and i have to scroll through, reading each entry to find the one i need. Yet i cant specify path. Or i can manually find required document, copy block ref, paste it... Or can use global search, find and copy block ref from there... So why can't i specify path while searching for block through ((variable? Or am i supposed to call document variable located under Java as variable (Java)? Or give it a name attribute?

Another example would be referring block of document. Assuming i know exact document and its path and i just to need to find specific paragraph, containing blah-blah. I can type ((bla-blah and search that paragraph in a given list, but ill have to scroll through paragraphs of other documents too - cause i cant specify the document. Again - is this intended because impossible otherwise? Why cant i do something like ((Programming/Java/variable/...)) ?

    Welcome to here!

    Here we can learn from each other how to use SiYuan, give feedback and suggestions, and build SiYuan together.

    Signup About
    Please input reply content ...
    • ACai

      I think you can give a variable an alias, such as java variable; c# variable. Shift+click the icon to the left of the document title to open the properties view. It’s worth mentioning that Siyuan (思源) supports not only document-level aliases but also block-level aliases.

      image.png

      image.png

    • MiscReply
    • hurr
      Author

      @ACai

      I meant if we have document Java with subdocument variable (so Java/variable) another document CSharp with subdocument variable (CSharp/variable) and when we need to ref variable under Java we cant type something like Java/variable - we type variable, look through avaiable options, checking paths and selecting the proper one.

      Of course we can assign a Name attribute like Variable (Java) with alias Java Variable, but it means we retype Java again and again and... But its already under Java, thats what i mean. We can see breadcrumbs when searching and embedding, we can specify path at search, but we cant specify path when linking and we dont see path in backlinks (unless hover cursor over document title) and in graph.

      image.png

    • ACai

      You can even do this: create a dedicated terminology document, merge each term (multi-paragraph blocks) into a single super-block—or a heading, list, etc.—and then reference them via the blocks' properties

      image.png

    • hurr
      Author

      image.png