NOBLEID Display Guidelines

Aligns with community DOI display guidance, but for NOBLEID. Following the same clarity/persistence principles.

Core Display Requirements

Always display as a full HTTPS URL:

https://nobleid.org/ark:/nobleid/<shoulder>/<blade>[:vN]

Make the whole URL clickable:

Don't hide it behind generic "link" text.

Version linking:

Link exact versions when citing a specific release:
https://nobleid.org/ark:/nobleid/20092025/7X9K2Q:v2
Use the root when you intend "latest":
https://nobleid.org/ark:/nobleid/20092025/7X9K2Q
Technical Requirements
  • In HTML metadata, add sameAs for any other PIDs (e.g., DOI) to reduce duplication in indexes.
  • Keep letter case exactly as issued by the resolver (IDs can be case-sensitive in segments).
  • Never truncate, wrap mid-token, or add punctuation inside the URL.
Visual Examples

Academic Paper Citation

Rossi A, Khan M. Sample Article. Journal of Examples. 2025;12(3):100–110. NOBLEID: https://nobleid.org/ark:/nobleid/20092025/7X9K2Q:v2

With DOI (showing sameAs relationship)

Smith J, Johnson A. Climate Research Dataset. 2025.

Repository Display

S

ClimateAnalyzer v2.1

Wilson R • Software • Updated 3 days ago

Platform-Specific Guidelines

Academic Journals

  • • Place near DOI in metadata block
  • • Include in reference lists
  • • Add to PDF metadata
  • • Include in XML/JATS markup

Repositories

  • • Display prominently on item pages
  • • Include in OAI-PMH metadata
  • • Add to search result snippets
  • • Include in API responses

Personal Websites

  • • Add to CV/resume sections
  • • Include in publication lists
  • • Link from project descriptions
  • • Add to social media profiles

Social Media

  • • Use full HTTPS URL format
  • • Include in bio sections
  • • Add to post descriptions
  • • Use in research announcements
Do's
  • Always display as full HTTPS URL
  • Make the entire URL clickable
  • Preserve exact case as issued
  • Use monospace fonts for identifiers
  • Include sameAs metadata for other PIDs
Don'ts
  • Don't truncate or modify the URL
  • Don't wrap mid-token or add punctuation inside
  • Don't hide behind generic "link" text
  • Don't change letter case
  • Don't use non-monospace fonts for IDs