search

suttacentral / bilara-data

Content for Bilara translation webapp.
https://bilara.suttacentral.net
29 stars 37 forks source link

naming convention for blurbs #947

Open sujato opened 3 years ago

sujato commented 3 years ago

Currently blurb files use two naming conventions:

  1. uid-blurbs_root-en.json
  2. uid-blurbs_root-en-blurb.json

The former is used for the root, the latter for the pt blurbs, while de blurbs have both.

Strangely, the blurbs that appear on bilara include both forms, even when they do not exist in bilara-data; there are 12 de-blurb files in bilara-data, and 27 on bilara. Disconcerting!

First we need to settle on a form for the file names.

Form 1 has the advantage of brevity. But form 2 is consistent with other site naming, where we have eg. foo_translation-de-site.json or foo_root-en-name.json.

So I guess that for the sake of consistency we should standardize on form 2?

This would mean that:

sabbamitta commented 3 years ago

Strangely, the blurbs that appear on bilara include both forms, even when they do not exist in bilara-data; there are 12 de-blurb files in bilara-data, and 27 on bilara. Disconcerting!

This, I think, comes because in bilara-data, a new file is only created when a translation has started. So bilara-data shows all blurb files where translations have been made, while Bilara has all blurb files.

By today (Oct 24), there are 15 files in bilara-data "unpublished" and 12 in "published", which will change as soon as I press the "publish" button.

So I guess that for the sake of consistency we should standardize on form 2?

That's what I'd also guess. But note that form 1 is the older one and has been created first, and it is this one that, in the case of duplicates, has the German translations. Those should not get lost in the process of deleting them!!! :warning:

root blur files should be renamed de blurbs have duplicates deleted ensure that the same files are present on bilara and bilara-data

I'd still like to add: Please notify Sabbamitta before starting work on this to give her a chance for synchronizing the "unpublished" and "published" branches and stopping making more edits to the files. :pray:

sujato commented 3 years ago

The form with no extra blurb is correct.

sabbamitta commented 3 years ago

In this case, there are still a few files that need some attention.