Citation from/to another Metanorma document

[ronaldtse]

Right now we cite like this:

* [[[ISO9001,ISO 9001:2015]]], _AUTOFILL_

Cite: 
<<ISO9001,clause="10.1">>

But we will also want to cite from another Metanorma document on disk or in a registry.

Here's a proposed syntax.

* [[[myanchor,repo:(myrepo/mydoc)]
* [[[myanchor,path:(relative-filepath)]

<<myanchor,clause="10.1">>
<<myanchor,anchor="special-anchor">>
# or
<<myanchor,#special-anchor>>

Something like this.

Thoughts @opoudjis ?

[opoudjis]

Will leave [[[myanchor,repo:(myrepo/mydoc)]]] unprocessed by standoc: it is an "identifier" that needs to be picked up in postprocessing, since there is no generic list of repositories or how to handle them. Metanorma collections processing are assuming repo:(current-metanorma-collection/{{ document identifier }}

[opoudjis]

I will adopt the <<myanchor,anchor="special-anchor">> syntax, for consistency.

[opoudjis]

* [[[myanchor,path:(relative-filepath)] still needs a document identifier; so make it

* [[[myanchor,path:(relative-filepath,id)]. Ditto repo:(). We can't get intelligible citations otherwise.

[ronaldtse]

* [[[myanchor,path:(relative-filepath,id)] is this id used as a bibliographic reference? Or is it supposed to read the MN AsciiDoc "root" file and therefore have Relaton bibdata already?

[opoudjis]

Bibliographic reference. I haven't worked out where the bibliographic details of path:() references come from yet; currently, I'm not fetching them from Relaton.

We will use repo:() instead for collections, and that will resolve the bibliography locally. I will add path and have it behave the same way, for consistency.

[ronaldtse]

Why can't we just do [[[myanchor,path:(relative-filepath)]]]? The myanchor is the bibliographic id. As long as (relative-filepath) points to a Metanorma document, we have its bibdata.

[opoudjis]

Not doing that. Consistency requires us to provide the document identifier in citations consistently.

[ronaldtse]

Not doing that. Consistency requires us to provide the document identifier in citations consistently.

The document identifier can be given by that particular document's bibdata? This is just like "auto-fetching" but the auto-fetched copy is local.

[opoudjis]

The document identifier remains mandatory, that is consistent with all of metanorma, it is good practice, and I will not brook further discussion.

I will search for *.rxl and *.xml at the nominated location and ingest Relaton XML if available.

[opoudjis]

Citation URLs (provided by path citations) are suffixless in Metanorma XML; they are suffixed with doc for Word, and with html for HTML.