time-link / timelink-kleio

Provides translation of files in Kleio notation into XML and other formats. Part of Timelink.
1 stars 0 forks source link

Add a generic group to hold source transcriptions #33

Open joaquimrcarvalho opened 6 months ago

joaquimrcarvalho commented 6 months ago

With the available of github -copilot transcriptions in kleio using VSCode provide many useful auto-complete hints.

These hints are really valuable when the source transcription is available. co-pilot is able to learn the kleio coding conventions very quickly and autocomplete, dates, generate ids. Etc...

So it is useful to transcribe the source verbatim and code. Or use text scan in published sources, include the OCR result in the kleio document (even with errors) and then produce the kleio transcription with the help of co-pilot.

For this it is useful to have a generic way to add long pieces of text in kleio documents. This would be useful inside:

This group would be defined as

part name=transcript; position=text; also=source, loc

And aliased

part name=nota; source=transcript

Examples:

  ls$estadia-x/Coimbra# @wikidata:Q442/1678000
        nota$
          """
        'o jesuíta belga Antoine Thomas (1644-1709) ensinou Matemática no
        Colégio das Artes antes de partir para o Oriente, onde, tal
        como Tomás Pereira, chegou à direcção do Observatório
        Astronómico. Em 1678 Thomas observou um eclipse da Lua em Coimbra,
        tendo os resultados sido enviados ao seu confrade
        jesuíta Jean de Fontenay, do Colégio de Clermont, França,
        e publicados no Journal des Savants'
        """/source=Fiolhais and Franco, 2016, Os jesuítas em Portugal e a ciência (séculos XVI-XVIII). p.19
    nota$"""
        O DHCJ indica a sua presença em Coimbra em 1678, mas não
           menciona a observação do eclipse da Lua. Contém bibliografia
        """/source=Dominguez, J. M., & O’Neill, C. (2001), vol.IV:3719
joaquimrcarvalho commented 4 months ago

At this point we could diverge from the original Kleio notation and simplify allow the three quote syntax anywhere

   """
    Anything
  """

The semantics would be: generate a note$ group with the same ancestor as the current group an auto id and the content of the triple quotes.

joaquimrcarvalho commented 1 month ago

This used in local str files (https://github.com/joaquimrcarvalho/china-cronologia/blob/63dd5114a4e4840cc8e5b2d1b9971c35bdb883e0/structures/sources.str)

note Synonyms can be used to introduce fragment of texts
note before the transcription to help co-pilot inteligence
note that these are not imported into the database, currently

part name=fragment; source=end; position=text
part name=next; source=end