Publication data

[sujato]

Here is a proposed spec for recording publication data.

This is a proposal only and the spec has evolved. Currently this document is out of date in some respects. We will write a definitive spec when the implementation has settled.

• I have added the file: https://github.com/suttacentral/bilara-data/blob/master/_publication.json. See there for the current form.

It should be adapted to use JSON-LD:

https://discourse.suttacentral.net/t/publication-metadata-for-sc-translations/13904/4

The UI application of this data is proposed at https://github.com/suttacentral/suttacentral/issues/1519

See: https://github.com/suttacentral/suttacentral/issues/1589

One publications file

In line with the SC tendency to gather relevant data into a single JSON file, let us do that here. There is a single JSON file, say at the top level of bilara-data, which includes publication details. Each entry should record a single publication event as a JSON object. Only essential information should be recorded here, we should avoid duplicating data from elsewhere too much. But we should probably put the full name (also found in author_edition.json, as the data here should make sense on a standalone basis.

• There will need to be some kind of number to identify the publication.
• Each text must have a translated title.
• Github handle is included so we can check the commits by that person.
• When is_published field is set to true, this triggers the text being imported into ArangoDB and hence to SuttaCentral.
• Multiple editions are allowed for.
• We can add other fields, perhaps isbn, alt-text-title, etc.
• multiple authors can be handled in the same way as multiple editions.
• Publication status indicates if a project is completed, sometimes translators may want to publish a sutta at a time, or a pannasa at a time, etc.
• I am wondering whether it would be good to automatically copy read-only data for each publication to its respective directory. That way the relevant publication info is kept with the text if anyone copies it.

There's no need to make a GUI at this point. We can simply supply a JSON template for translators to fill in. Information here will supplement that found elsewhere such as the author bios.

[
  {
    "publication_number": "scpub1",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/kn/thag",
    "author_uid": "sujato-walton",
    "author_short_name": "Sujato/Walton",
    "author_full_name": "Bhikkhu Sujato, Jessica Walton",
    "collaborator": [
      {
        "collaborator_uid": "sujato",
        "collaborator_name": "Bhikkhu Sujato",
        "collaborator_github_handle": "sujato"
      },
      {
        "collaborator_uid": "walton",
        "collaborator_name": "Jessica Walton",
        "collaborator_github_handle": ""
      }
    ],
    "text_uid": "thag",
    "text_title": "Verses of the Senior Monks",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2014",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/en/sujato/thag"
      }
    ]
  },
  {
    "publication_number": "scpub2",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/dn",
    "author_uid": "sujato",
    "author_name": "Bhikkhu Sujato",
    "author_github_handle": "sujato",
    "text_uid": "dn",
    "text_title": "Long Discourses",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/en/sujato/dn"
      },
      {
        "edition_number": "2",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "book",
        "url": "lulu.com"
      }
    ]
  },
  {
    "publication_number": "scpub3",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/mn",
    "author_uid": "sujato",
    "author_name": "Bhikkhu Sujato",
    "author_github_handle": "sujato",
    "text_uid": "mn",
    "text_title": "Middle Discourses",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/en/sujato/mn"
      },
      {
        "edition_number": "2",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "book",
        "url": "lulu.com"
      }
    ]
  },
  {
    "publication_number": "scpub4",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/sn",
    "author_uid": "sujato",
    "author_name": "Bhikkhu Sujato",
    "author_github_handle": "sujato",
    "text_uid": "sn",
    "text_title": "Linked Discourses",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/en/sujato/sn"
      },
      {
        "edition_number": "2",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "book",
        "url": "lulu.com"
      }
    ]
  },
  {
    "publication_number": "scpub5",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/an",
    "author_uid": "sujato",
    "author_name": "Bhikkhu Sujato",
    "author_github_handle": "sujato",
    "text_uid": "an",
    "text_title": "Numbered Discourses",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/en/sujato/an"
      },
      {
        "edition_number": "2",
        "publication_date": "2018",
        "publisher": "SuttaCentral",
        "publication_type": "book",
        "url": "lulu.com"
      }
    ]
  },
  {
    "publication_number": "scpub6",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/kn/thag",
    "author_uid": "sujato-walton",
    "collaborator": [
      {
        "collaborator_uid": "sujato",
        "author_name": "Bhikkhu Sujato",
        "author_github_handle": "sujato"
      },
      {
        "collaborator_uid": "walton",
        "author_name": "Jessica Walton",
        "author_github_handle": ""
      }
    ],
    "text_uid": "thig",
    "text_title": "Verses of the Senior Nuns",
    "is_published": "true",
    "publication_status": "Completed, revision is ongoing.",
    "licence": "CC0",
    "edition": [
      {
        "edition_number": "1",
        "publication_date": "2019",
        "publisher": "SuttaCentral",
        "publication_type": "website",
        "url": "https://suttacentral.net/thig/en/sujato"
      }
    ]
  },
  {
    "publication_number": "scpub7",
    "source_url": "https://github.com/suttacentral/bilara-data/tree/master/translation/en/sujato/kn/dhp",
    "author_uid": "sujato",
    "author_name": "Bhikkhu Sujato",
    "author_github_handle": "sujato",
    "text_uid": "dhp",
    "text_title": "Sayings of the Dhamma",
    "is_published": "false",
    "publication_status": "",
    "licence": "",
    "edition": [
      {
        "edition_number": "",
        "publication_date": "",
        "publisher": "",
        "publication_type": "",
        "url": ""
      }
    ]
  }
]