relaton / relaton-ccsds

Implement relaton-ccsds for www.ccsds.org Standards
1 stars 0 forks source link

Support multi-format (DOC, PDF) bibliographic entries: CCSDS 720.4-Y-1, CCSDS 720.5-Y-1, CCSDS 720.6-Y-1 #4

Closed ronaldtse closed 1 year ago

ronaldtse commented 1 year ago

https://public.ccsds.org/Publications/AllPubs.aspx

These entries are duplicated because they are of different formats:

The first one is DOC format, the second one is PDF format

Screenshot 2023-08-17 at 8 02 00 PM
andrew2net commented 1 year ago

@ronaldtse do you mean we should use multi-format references like CCSDS 720.4-Y-1 (DOC) and CCSDS 720.4-Y-1 (PDF)

ronaldtse commented 1 year ago

@andrew2net I think we should support multiple formats within a bibliographic item. We already use that for OGC, right?

andrew2net commented 1 year ago

@ronaldtse we support multi-format links. Why do we need almost identical documents with only a difference in the link? OGC doesn't handle multiple formats. I just found out that the earlier version OGC source dataset has only URL's but URI's were null for all the documents. No PDF links were provided:

{
  "1": {
    "title": "OGC SensorThings API Part 1: Sensing Version 1.1",
    "alternative": "SensorThings API Part 1: Sensing",
    "URI": null,
    "identifier": "18-088",
    "URL": "https://docs.ogc.org/is/18-088/18-088.html",
    ...

However, in the latest version of the dataset, all the documents have both URI and URL links. Some of the documents have a PDF link:

{
  "1": {
    "title": "OGC Abstract Specification Topic 2: Referencing by coordinates (Including corrigendum 1 and corrigendum\t2)",
    "alternative": "OGC Abstract Specification Topic 2: Referencing by coordinates",
    "URI": "http://www.opengis.net/doc/AS/topic-2/6.0",
    "identifier": "18-005r8",
    "URL": "https://docs.ogc.org/as/18-005r8/18-005r8.pdf",
    ...

It seems we need to update the RelatonOgc::DataFetcher.

ronaldtse commented 1 year ago

Why do we need almost identical documents with only a difference in the link?

For completeness, in case the citation user wants to cite a specific format.

Do we have to update relaton.org to show and explain how these work:

andrew2net commented 1 year ago

Do we have to update relaton.org to show and explain how these work:

  • multiple formats
  • multiple languages

@ronaldtse Yes, it's certainly good to have these terms be explained

andrew2net commented 1 year ago

@ronaldtse I'm thinking about not to create copy of documents with different type of links in our repository. Instead, if a reference specifies format like CCSDS 720.6-Y-1 (DOC), find CCSDS 720.6-Y-1, remove PDF link, and return the document. If a reference specifies format but the document doesn't have that type of link then return not found. If format not specified, return document as is. What do you think?

andrew2net commented 1 year ago

Implemented in v.1.16.2 https://github.com/relaton/relaton-ccsds#get-specific-format