doi for html document

[aloboa]

Description

I see in
https://quarto.org/docs/reference/formats/html.html
that the YAML header for html document includes a doi field.

Nevertheless, I cannot find anywhere the way to create a doi for an html document.
Could anyone let me know how to do it?

[rgaiacs]

Quarto does not support the creation of DOI. You can pre-register a DOI with https://zenodo.org/ or https://figshare.com/ or another DOI issuer. You can add the pre-register DOI to your Quarto document. Later, you need to upload the HTML to your DOI provider and complete the registration.

[mcanouil]

To add to this, it's highly unlikely that Quarto will ever be a DOI registrar.

Also, note that this particular subject is already discussed in another discussion:

• Minting of DOIs (and archival?) for blog posts #7174

[aloboa]

I had checked the zenodo way. Unfortunately, the resulting doi points to a zenodo page where the item is treated as a file, there is no way to include a link to display the actual HTML document. The HTML file is listed, but if you click on it you get it downloaded instead of displayed.

[mcanouil]

This is how Zenodo works as described in their documentation.

[aloboa]

Yes, just emphasizing that this is not the way I could generate a doi for an HTML report made with quarto.

[rgaiacs]

This is a over simplification! Sorry for the important but missing details. DOI is a URL shortening. If you operate your own URL shortening, you can define it's operation. If you are using a free service, you are limited to their rules.

@aloboa the DOI specification defines some responsibilities for the DOI issuer, for example, that the metadata will always be available although the data itself might not be available any more. This is to virtually match the physical experience with bibliography section. The reader knows that [1] references the article titled Lorem ipsum from Jane Doe but the reader might not be able to read the Lorem ipsum article because the reader's library does not have a copy of it.

A DOI issuer can configure the DOI to resolve to any page as long as the DOI issuer complies with their responsibilities. For Zenodo and figshare, the reliable way is for the DOI only to resolve to pages they host.

At my working place, we operate a DOI issuer and the team running the DOI issuer were happy to provide us with DOIs that would resolve to pages that we built with Quarto.

[aloboa]

At my working place, we operate a DOI issuer and the team running the DOI issuer were happy to provide us with DOIs that would resolve to pages that we built with Quarto.

@rgaiacs as my working place does not offer such a service, is there, to your knowledge, an organization that would actually provide such a service (sort of zenodo but including this service?)

[rgaiacs]

@aloboa I'm not aware of any DOI issuer that will allow you to select the destination of the DOI resolution.

[mfenner]

Rogue Scholar (the service I am running) registers DOIs with a flexible destination. The service is only for science blogs and currently has 18 Quarto blogs participating https://rogue-scholar.org/communities/search?q=quarto&f=type%3Ablog. Rogue Scholar uses the same repository software as Zenodo, so the look and feel are very similar. For Quarto-generated content that is not a blog, Rogue Scholar can't help. Part of the reason is that it is a free service and costs resources, the other reason is that Rogue Scholar uses the RSS feed to extract the metadata needed for DOI registration.