README: Add description of assumed place holder format

[DonMischo]

CSV:

Feldtrenner: Komma , Zeichenkettentrenner: Anführungszeichen " UTF8

Beispiel: "Mathematik","Beschreibung",3,,,,

place holder: Hashtag + Bezeichnung in Caps Beispiel: #MATHEMATIK

[ArchibaldBienetre]

Could you paste the whole header of an example file, and a snippet of the tex file with the placeholders? :see_no_evil:

I'm not sure I'm getting it yet :sweat_smile:

[ArchibaldBienetre]

This relates to https://github.com/DonMischo/csv2tex/issues/6

[ArchibaldBienetre]

Ok, one thing I saw in our knowledge share:

• booleans are "x" or empty for true resp. false
• the subject name is part of the header line, not in the CSV's content

[DonMischo]

CSV:

Feldtrenner: Komma , Zeichenkettentrenner: Anführungszeichen " UTF8

Beispiel: "Mathematik","Beschreibung",3,,,,

place holder: Hashtag + Bezeichnung in Caps Beispiel: #MATHEMATIK

NACHNAME,#VORNAME,#BDAY,#DEUTSCH,#MATHEMATIK,#ENGLISCH

[ArchibaldBienetre]

Now that I saw it once, I see that your definition was actually complete :sweat_smile:

Thank you.

[ArchibaldBienetre]

CSV format was finalized here: https://github.com/SergelsOrg/csv2tex/issues/27

Placeholder format may be subject to definition in https://github.com/SergelsOrg/csv2tex/issues/6 latest - or here

[ArchibaldBienetre]

After we now have the proper CSV format and it seems to work out quite well for various edge cases, I suggest we revisit the placeholders.

This is what our CSV header may look like - there are multiple columns for one subject, one for each (sub)competency.

E.g.

• Competency 1
  • Subject: "Deutsch"
  • Competency: "Texte rezipieren"
  • Sub-competency: "Lese- und Hörverstehen"
  • (Description - ignored here)
• Competency 2
  • Subject: "Deutsch"
  • Competency: "Texte produzieren"
  • Sub-competency: "Sprechen"
  • (Description - ignored here)

So, the subject alone is not enough, it should rather be a composed key that can be calculated from subject, competency and sub-competency.

E.g., in this case:

• Competency 1: #DEUTSCH__TEXTE_REZIPIEREN__LESE_UND_HOERVERSTEHEN
• Competency 2: #DEUTSCH__TEXTE_PRODUZIEREN__SPRECHEN

Calculation:

• replace all umlauts and ß with the common German transliterations (ä -> ae, ö -> oe, ü -> ue, ß -> ss)
• replace all "special characters" and spaces with "_"
• merge parts using "__" as delimiter
• capitalize

---

However, all this still leaves a lot of work to the tex template designer.

I wonder if this is intentional, or if we should aim for an iteration approach in the future. This may add additional constraints, maybe that's not something for the MVP.

[ArchibaldBienetre]

:information_source: For version 1.0.0 we are now working with fixed placeholders.

We should documen these alongside the CSV documentation from https://github.com/SergelsOrg/csv2tex/issues/66