bombuzal/neo-akkadian
1
Fork 0
Code Issues Pull Requests Releases Activity
9 Commits 1 Branch 0 Tags
main
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA

README.md

Neo-Akkadian

Neo-Akkadian is a constructed language which aims to be a modern vernacular based on (Classical) Akkadian, with:

  • Layer A (Heritage): conservative, Akkadian-anchored reference forms.
  • Layer B (Vernacular): simplified, learner-first modern usage (default in lessons and corpus).

Project control docs:

  • AGENT_RULES.md
  • ROADMAP.md
  • dir-structure.md

Build

Prerequisites:

  • Python 3

Generate (or regenerate) all course unit manuscripts (A1-C2):

python3 tools/build-third-pass-course.py

Build the compiled book package in book/ (parts + appendices + combined manuscript):

python3 tools/build-book.py

Build outputs:

  • Course manuscripts: course/a1/ ... course/c2/ (unit files + answer keys)
  • Book package: book/parts/, book/appendices/, book/neo-akkadian-complete-book.md

Optional: refresh the CEFR course lexicon packs from targets and sources:

python3 tools/refresh-course-lexicon.py

Manual QA checklist and conventions:

  • tools/consistency-checks.md
  • spec/02-orthography.md

Navigation

Area Entry points Notes
Book book/neo-akkadian-complete-book.md, book/parts/, book/appendices/ Built output suitable for web/print pipelines.
Spec (Grammar) spec/00-goals-and-scope.md ... spec/12-dialects-standard.md Normative rules for orthography/grammar/usage.
Full Grammar Plan grammar/README.md, grammar/GRAMMAR_PLAN.md Routledge-style comprehensive grammar blueprint and chapter sequencing.
Lexicon lexicon/LEXICON.md, lexicon/domains/, lexicon/glossary/, lexicon/roots/ Domain lists + glossaries + root index.
Corpus corpus/ Phrasebooks, dialogues, and short texts.
Courses course/README.md, course/a1/ ... course/c2/ Unit manuscripts and answer keys by CEFR.
Tests tests/ Paradigms, syntax sentences, minimal pairs, coverage checklists.
Sources sources/SOURCES.md, sources/LOCAL_SOURCES_INDEX.md Academic + local source tracking.

Contributing

Before you change anything:

  1. Read AGENT_RULES.md.
  2. Follow orthography exactly: spec/02-orthography.md (NAK-Plain + NAK-Scholar).
  3. Keep Layer B as the default in course/corpus; use Layer A as a reference/parallel where relevant.
  4. For any new non-trivial decision, update sources: sources/SOURCES.md and (if applicable) sources/BIBLIOGRAPHY.bib.

Contribute to Grammar (Spec)

  • Edit the relevant chapter(s) in spec/.
  • If you change a rule, update corresponding tests in tests/ (paradigms + syntax sentences).
  • Regenerate course + book if the change affects examples or pedagogy:
    • python3 tools/build-third-pass-course.py
    • python3 tools/build-book.py

Contribute to Lexicon

  • Add entries to the appropriate domain list in lexicon/domains/ (course packs, core lists, modern domains).
  • Keep glossaries usable and in sync:
    • lexicon/glossary/EN_to_NAK.md
    • lexicon/glossary/NAK_to_EN.md
  • If you introduce new high-frequency items or neologisms, record donor language/source and rationale (see spec/09-loanwords-and-neologisms.md) and update sources/SOURCES.md.

Contribute to Lessons (Course Units)

Most unit manuscripts are generated; prefer editing the generator and then regenerating:

  • Generator: tools/build-third-pass-course.py
  • Blueprints: course/A1.md ... course/C2.md
  • Output: course/a1/ ... course/c2/

When editing dialogue/input, target natural colloquial usage (Teach Yourself-style unit rhythm), and keep the required example fields (Plain/Scholar/Gloss/English/Tags).

Course Planning

  • Master course plan: COURSE_PLAN.md
  • CEFR blueprints: course/A1.md, course/A2.md, course/B1.md, course/B2.md, course/C1.md, course/C2.md
  • Lexicon growth by CEFR: lexicon/domains/course-level-targets.md

Course Index

Level Units Book part Unit manuscripts Answer key Unit index
A1 14 book/parts/a1.md course/a1/ book/appendices/answer-key-a1.md course/a1/README.md
A2 14 book/parts/a2.md course/a2/ book/appendices/answer-key-a2.md course/a2/README.md
B1 16 book/parts/b1.md course/b1/ book/appendices/answer-key-b1.md course/b1/README.md
B2 16 book/parts/b2.md course/b2/ book/appendices/answer-key-b2.md course/b2/README.md
C1 16 book/parts/c1.md course/c1/ book/appendices/answer-key-c1.md course/c1/README.md
C2 16 book/parts/c2.md course/c2/ book/appendices/answer-key-c2.md course/c2/README.md

Course Units

A1 units (14)
Unit File Theme
1 unit-01.md Script and Sounds
2 unit-02.md People and Family
3 unit-03.md Home and Things
4 unit-04.md Food and Drink
5 unit-05.md Time and Routine
6 unit-06.md Places and Movement
7 unit-07.md Numbers and Prices
8 unit-08.md Study and Work
9 unit-09.md Health and Feelings
10 unit-10.md Weather and Nature
11 unit-11.md Requests and Commands
12 unit-12.md Past Events
13 unit-13.md Review and Repair
14 unit-14.md A1 Capstone
A2 units (14)
Unit File Theme
1 unit-01.md A1 Reactivation
2 unit-02.md Plans and Intentions
3 unit-03.md Experiences
4 unit-04.md Requests and Obligations
5 unit-05.md Opinions
6 unit-06.md Conditions
7 unit-07.md Time Linking
8 unit-08.md Cause and Reason
9 unit-09.md Relative Clauses
10 unit-10.md Procedure Language
11 unit-11.md Messages and Reports
12 unit-12.md Public and Civic Life
13 unit-13.md Emergencies and Safety
14 unit-14.md A2 Capstone
B1 units (16)
Unit File Theme
1 unit-01.md Narrative time
2 unit-02.md Reported perspective
3 unit-03.md Comparison
4 unit-04.md Processes
5 unit-05.md Problem-solving
6 unit-06.md Social issues
7 unit-07.md Knowledge discourse
8 unit-08.md Work communication
9 unit-09.md Culture and identity
10 unit-10.md Public communication
11 unit-11.md Media reading
12 unit-12.md Argument basics
13 unit-13.md Procedure writing
14 unit-14.md Data description
15 unit-15.md Review
16 unit-16.md Capstone
B2 units (16)
Unit File Theme
1 unit-01.md Advanced clause design
2 unit-02.md Nuanced stance
3 unit-03.md Formal correspondence
4 unit-04.md Evidence framing
5 unit-05.md Debate
6 unit-06.md Interpretation
7 unit-07.md Definition and exemplification
8 unit-08.md Narrative craft
9 unit-09.md Policy language
10 unit-10.md Media rhetoric
11 unit-11.md Synthesis reading
12 unit-12.md Precision rewrite
13 unit-13.md Lexical derivation lab
14 unit-14.md Project workshop I
15 unit-15.md Project workshop II
16 unit-16.md Capstone
C1 units (16)
Unit File Theme
1 unit-01.md Cohesion architecture
2 unit-02.md Semantic nuance
3 unit-03.md Scholarly style
4 unit-04.md Public rhetoric
5 unit-05.md Legal style
6 unit-06.md Cross-register mediation
7 unit-07.md Literary adaptation
8 unit-08.md Argument under constraints
9 unit-09.md Source synthesis
10 unit-10.md Genre transfer
11 unit-11.md Lexical finesse
12 unit-12.md Pragmatic subtlety
13 unit-13.md Analytic commentary
14 unit-14.md Project workshop I
15 unit-15.md Project workshop II
16 unit-16.md Capstone
C2 units (16)
Unit File Theme
1 unit-01.md Mastery diagnostics
2 unit-02.md Deep style control
3 unit-03.md Heritage mediation
4 unit-04.md Advanced translation
5 unit-05.md Counterargument design
6 unit-06.md Specialist discourse
7 unit-07.md Authorial voice
8 unit-08.md Nuance transfer
9 unit-09.md Multi-source synthesis
10 unit-10.md Critical review
11 unit-11.md Editorial transformation
12 unit-12.md Formal oral defense
13 unit-13.md Research integration
14 unit-14.md Project workshop I
15 unit-15.md Project workshop II
16 unit-16.md Capstone
Reference in New Issue View Git Blame Copy Permalink
Description
A modern Akkadian vernacular
Readme 6.5 MiB
Languages
Python 98.6%
TeX 1.4%