Add "How to Cite" Tab to Dandiset Landing Page #2671

bendichter · 2025-12-14T04:51:21Z

Fixes "How to Cite" page for each Dandiset #2670

Description

This PR adds a dedicated "How to Cite" tab to each Dandiset landing page, making citation information more prominent and accessible to users. The design is inspired by SPARC's cite tab approach.

Changes

New File:

web/src/components/DLP/HowToCiteTab.vue - New component displaying citation information including:
- Full citation with copy-to-clipboard functionality
- Clickable DOI chip linking to doi.org
- Materials and Methods suggested text
- Data Availability Statement suggested text
- DANDI Identifier with RRID
- License information
- Link to DOI Citation Formatter

Modified Files:

web/src/views/DandisetLandingView/DandisetMain.vue - Simplified tabs to just "Overview" and "How to Cite", moved tab navigation above content
web/src/views/DandisetLandingView/DandisetActions.vue - Removed redundant "Cite As" dialog from the actions menu

Screenshots

The new tab provides a clean, user-friendly interface with:

Subtle gray background (#f5f5f5) for copyable text blocks
Copy buttons for easy clipboard access
Clear section headers and helpful descriptions
Links to external resources (DOI, citing guide)

Testing

Tested with published dandisets containing DOIs
Verified copy-to-clipboard functionality
Confirmed DOI links open correctly in new tabs

bendichter · 2025-12-14T04:52:30Z

Before:

After:

satra · 2025-12-14T11:31:26Z

thanks for initiating this @bendichter - we need to have something for a non-published dataset as well. including a broad admonition at the top saying citing draft dandisets are not recommended as the content may change and to contact the author to publish it.

@waxlamp - i note here that for this last bit to work fully we need to have zarr publishing in place. this is going to hold us back on some datasets. for many neurophysiology datasets, we can simply publish zarr just as we would have a non-zarr dataset. they don't have the same implications as the large microscopy ones. we just need to determine whether a draft version of a published dataset should have copy on write enabled or not and what the criteria for that should be.

bendichter · 2025-12-14T14:26:28Z

@satra Done.

Also see #2667, which would pair nicely with this

…hed version

bendichter · 2025-12-14T14:30:50Z

If the Dandiset has a published version:

web/package-lock.json

yarikoptic · 2025-12-16T01:02:12Z

web/src/components/DLP/HowToCiteTab.vue

+          <a
+            href="https://citation.doi.org/"
+            target="_blank"
+            rel="noopener"
+          >
+            DOI Citation Formatter
+            <v-icon size="small">mdi-open-in-new</v-icon>
+          </a>


unfortunately this one seems to not allow to prepopulate the DOI, thus kinda rendering it much less useful. May be we could switch to use here

Suggested change

<a

href="https://citation.doi.org/"

target="_blank"

rel="noopener"

>

DOI Citation Formatter

<v-icon size="small">mdi-open-in-new</v-icon>

</a>

<a

href="https://citeas.org/cite/${doi}"

target="_blank"

rel="noopener"

>

citeas.org formatter/exporter (e.g., to BiBTeX)

<v-icon size="small">mdi-open-in-new</v-icon>

</a>

?

Yes, I am fine with that, however citeas.org is not working for me right now. It is throwing a bunch of JS errors:

Failed to load resource: net::ERR_CONNECTION_REFUSEDUnderstand this error
ajax.googleapis.com/ajax/libs/angular_material/1.1.0-rc4/angular-material.min.css:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-animate.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-route.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-aria.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-messages.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-resource.js:8 Uncaught TypeError: Cannot read properties of undefined (reading '$$minErr')Understand this error
angular-sanitize.js:19 Uncaught TypeError: Cannot read properties of undefined (reading '$$minErr')Understand this error
angular-animate.js:9 Uncaught TypeError: Cannot read properties of undefined (reading 'noop')Understand this error
angular-material.min.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
angular-cookies.js:1 Failed to load resource: net::ERR_NAME_NOT_RESOLVEDUnderstand this error
zenodo.160400:109 Uncaught ReferenceError: angular is not defined
at zenodo.160400:109:9Understand this error
ti.js:1 Uncaught ReferenceError: angular is not defined
at ti.js:1:1Understand this error
ui-bootstrap-tpls-2.5.0.js:7 Uncaught ReferenceError: angular is not defined

ourresearch/citeas-webapp#26

I agree we should have a better solution here but I don't think it should hold up the PR

yarikoptic · 2025-12-16T14:06:30Z

I think this would at large also close

improve ease of citation for dandisets #1555

satra · 2025-12-16T16:48:39Z

can we adjust this so that we merge into this a cff generator from the dandiset metadata, which can then be rendered into different formats for citation?

… citation generation

bendichter · 2025-12-16T18:43:55Z

@satra how's this?

satra · 2025-12-16T19:01:04Z

love it @bendichter - perhaps an add to reference manager ? kind of like this part in biorxiv.

bendichter · 2025-12-16T19:02:37Z

In my experience citation managers support bibtex import, which is one of the options here

yarikoptic · 2025-12-16T19:15:24Z

can we adjust this so that we merge into this a cff generator from the dandiset metadata, which can then be rendered into different formats for citation?

I think this should be a separate issue and IMHO should be automatically produced as top level CITATION.cff, which is compatible with BIDS already, which would then automagically appear in any DataLad dandiset etc.

yarikoptic · 2025-12-16T20:26:00Z

web/src/utils/cff.ts

+    return String(value);
+  }
+  return String(value);
+}


FWIW -- this is already a notable amount of code worthy dedicated unit testing etc to avoid user facing errors etc...

do we want to make that a requirement of this PR? Do we have a testing framework I can integrate with?

well, that all will be largely up to @dandi/archive-maintainers , I would have preferred at least some unittests to ensure on robust conversion performance since it would be driven by user entered data and that is a "zoo"... there are some end-to-end tests for frontend under e2e/

bendichter · 2025-12-16T20:40:13Z

@satra

satra · 2025-12-17T01:38:16Z

@bendichter - since i can't play with it myself, are you saying the drop down does bibtex and cff/yaml in addition to apa/ieee etc.,.?

bendichter · 2025-12-17T01:39:54Z

@satra yes, that's right. I included screenshots of this here: #2671 (comment)

Add how to cite tab

dfc7101

Add warning for citing draft dandisets and remove CiteAsDialog component

83b748e

Enhance draft citation warnings to include links to the latest publis…

c0f7c75

…hed version

kabilar requested review from satra and yarikoptic December 15, 2025 19:27

yarikoptic reviewed Dec 16, 2025

View reviewed changes

web/package-lock.json Show resolved Hide resolved

Revert accidental web/package-lock.json changes

50ba3b0

yarikoptic reviewed Dec 16, 2025

View reviewed changes

Implement citation format selection and add CFF utility functions for…

9d7d72b

… citation generation

yarikoptic mentioned this pull request Dec 16, 2025

Auto populate/update CITATION.cff file #2677

Open

yarikoptic reviewed Dec 16, 2025

View reviewed changes

Add "How to Cite" Tab to Dandiset Landing Page #2671

Are you sure you want to change the base?

Add "How to Cite" Tab to Dandiset Landing Page #2671

Conversation

bendichter commented Dec 14, 2025 • edited by yarikoptic Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changes

Screenshots

Testing

Uh oh!

bendichter commented Dec 14, 2025

Uh oh!

satra commented Dec 14, 2025

Uh oh!

bendichter commented Dec 14, 2025

Uh oh!

bendichter commented Dec 14, 2025

Uh oh!

Uh oh!

yarikoptic Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

bendichter Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bendichter Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

yarikoptic commented Dec 16, 2025

Uh oh!

satra commented Dec 16, 2025

Uh oh!

bendichter commented Dec 16, 2025

Uh oh!

satra commented Dec 16, 2025

Uh oh!

bendichter commented Dec 16, 2025

Uh oh!

yarikoptic commented Dec 16, 2025

Uh oh!

yarikoptic Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

bendichter Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

yarikoptic Dec 16, 2025

Choose a reason for hiding this comment

Uh oh!

bendichter commented Dec 16, 2025

Uh oh!

satra commented Dec 17, 2025

Uh oh!

bendichter commented Dec 17, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

bendichter commented Dec 14, 2025 •

edited by yarikoptic

Loading

bendichter Dec 16, 2025 •

edited

Loading

bendichter Dec 16, 2025 •

edited

Loading