How can I links to places in files that are not in the current file?

So, I have an ASCIIDOC project which I am trying to (mostly) automatically convert to typst. All going fairly well, but having a problem with links.

The project has one main file at the top, and this include lots of “chapters” which seems to be working. However, I cannot figure out a way for one chapter to link to a heading or location in another chapter. There’s lots of this cross referencing going on as the resulting doc is technical documentation and our users like to bounce around in the doc.

I really don’t want to rearchitect the entire structure of the project i.e. collate all the files in to one big file - this wont work for possible future projects with 1000+ pages. The only other solution I have come across is that one chapter must include the chapter that has the target, but that requires chained chapters, rather than our overriding file.

In case that’s unclear, imagine one parent file that include lots of chidren files. I need to be able to link between children.

TIA!

Are you using the include command for all the children files in your parent file? If that is the case, links and references should work between all files in your entire project.

Do you have a specific error that is raised with your current project structure? Your question is unfortunately very vague in that regard. If you were already using the include command, please include an error message or even create a minimum working example that reproduces your problem.

Sorry I was so unclear.

That said, I think I now have it working. It was useful to know that what I was trying to do was actually possible, so thanks for that!

So, from my point of view at the moment this is working as hoped. Sorry for the noise.