Can it handle org-roam-v2 ID's?

[buhtz]

Do I understand the documentation and the great examples right, that ox-hugo is able to handle the ID-links created by org-roam version2 correct?

Because ox-publish (org-mode in-build) is currently not able to handle that correct; sometimes yes, sometimes no. It is a known bug.

Let me give you an example of an org file with two links in it

:PROPERTIES:
:ID:       cb53b5cc-31b8-40ad-87c4-4cf3c6e3cec6
:END:
#+title: foobar
+date: [2022-03-09 Mi 10:20]
Two links to foo and bar
Link to foo: [[id:13ec1e89-abc9-4d43-a4a4-3005a1c9dfc7][foo]]
Link to bar: [[id:0c66c239-5b88-40bb-a0f1-0e15d8477c47][bar]]

But org-hugo-export-wim-to-md generates this where can see at the end that there are no links.```

+++
title = "foobar"
draft = false
+++

+date: <span class="timestamp-wrapper"><span class="timestamp">[2022-03-09 Mi 10:20]</span></span> <br/>
Two links to foo and bar <br/>
Link to foo:  <br/>
Link to bar:  <br/>

[kaushalmodi]

Can you provide a complete example with all the Org files that have those IDs assigned? If the ID targets are not found, you should be seeing an error by default. So I am surprised that it exported with no links.

Once you share a complete minimal reproducible example, we can debug.

Also, look at this example of linking Org documents using IDs: https://github.com/kaushalmodi/ox-hugo/tree/main/test/site/content-org/org-roam. That example is part of the ox-hugo test suite and it is passing.

[buhtz]

Thanks for your feedback. Good to hear that it should be possible. ;)
Before providing a good example I have to learn some ox-hugo basics. See my other questions.

[buhtz]

example.zip

Here you see an example with three org-roam-v2 nodes as org-, md- and html-file. As you see in the org-files "Foo" links to "Bar" and "Foobar" links to "Foo" and "Bar".

This happens from time to time with example projects (only this three files) sometimes in my original org-roam notes. Sometimes mixed where some links are present and some not.

This is not ox-hugo related because this happend also in the past where I used ox-publish.el only. But without reproducable steps it is hard to explain that to the org-roam people.

I am sitting down now, sleeping some nights over this and maybe have to do my own stuff via Python.

[kaushalmodi]

Note: I don't use org-roam or org-id's, but here's what I understand just by read the variable docstrings (C-h v).

• C-h v org-id-extra-files

  When Org reparses files to remake the list of files and IDs it is tracking,
  it will normally scan the agenda files, the archives related to agenda files,
  any files that are listed as ID containing in the current register, and
  any Org file currently visited by Emacs.
  You can list additional files here.
  This variable is only relevant when ‘org-id-track-globally’ is set.

  • So "extras" would be any file that's not part of your Org agenda? The default value of org-id-extra-files is org-agenda-text-search-extra-files, so that explains.
  • If there's any file you need Org to search for when resolve id: links, those files need to be added to org-id-extra-files. So in your emacs config, you would need to add all the Org files you plan to link in that list variable.

what this has to do with my config

If you plan to use the Org files for links and you don't set org-id-extra-files, that's a user-config error. Again, I don't use org-id based links and don't set that variable. So I could be wrong.

Relevant comment: #447 (comment)

[buhtz]

In short: I do not need to set it because I have only one directory where org files are in.

[kaushalmodi]

In short: I do not need to set it because I have only one directory where org files are in.

But you mentioned that org-id links don't work if you don't set that org-id-extra-files list.
The docstring doesn't say that you don't need to set it if you have only one directory.

[buhtz]

But you mentioned that org-id links don't work if you don't set that org-id-extra-files list.
No. I never touched that variable. And as I described in some cases the ID-links are there and sometimes not - no matter if org-id-extra-files is set or not.

And which value should I set if there is no other folder with org-files in it?

The docstring doesn't say that you don't need to set it if you have only one directory.
That wouuld be a bug. ;)

[kaushalmodi]

as I described in some cases the ID-links are there and sometimes not

Sorry, I couldn't help much here. It might have to do with the Org id locations cache being correct at times when you are interactively adding the Org id links. It will be good to raise this question on a wider forum. I'd assume that that issue is unrelated to ox-hugo. You'd get the exact same behavior with any other exporter too.

And which value should I set if there is no other folder with org-files in it?

That's a list variable: a list of all the Org files containing Org IDs.

That wouuld be a bug. ;)

By setting the variable correctly all the Org ID linking tests are passing consistently. If you feel it's a bug please provide a reproducible example and post it in the Org mailing list.

[kaushalmodi]

If org-id-extra-files is set correctly, this issue should not occur. Marking this as solved as this issue cannot be reproduced in the ox-hugo test suite (see https://github.com/kaushalmodi/ox-hugo/tree/main/test/site/content-org/org-roam) or locally.