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\u2013110. 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 \u2022 Software \u2022 Updated 3 days ago
Platform-Specific Guidelines
Academic Journals
- \u2022 Place near DOI in metadata block
- \u2022 Include in reference lists
- \u2022 Add to PDF metadata
- \u2022 Include in XML/JATS markup
Repositories
- \u2022 Display prominently on item pages
- \u2022 Include in OAI-PMH metadata
- \u2022 Add to search result snippets
- \u2022 Include in API responses
Personal Websites
- \u2022 Add to CV/resume sections
- \u2022 Include in publication lists
- \u2022 Link from project descriptions
- \u2022 Add to social media profiles
Social Media
- \u2022 Use full HTTPS URL format
- \u2022 Include in bio sections
- \u2022 Add to post descriptions
- \u2022 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