Qonlang · User guide

中文版

Qonlang (千语集) is a desktop application for every conlanger (a portable Windows build and an installer, plus macOS; the same code also runs in a browser). It ships with no terminology from any particular language: parts of speech, cases, dimensions, abbreviations, dialects and scripts are all defined by you, inside the project. The software only ties them together — entering words and roots, writing sound-change rules, deriving pronunciations from your phonology, glossing example sentences automatically, building custom scripts and exporting dictionaries.

• Source code and downloads: github.com/Kinnuch/Qonlang (MIT)
• Interface languages: 中文 / English (Chinese by default); light and dark themes
• Project file: a single *.laim.json, which can also be exported as a folder split by collection (handy for git)

Every page in the app has a User guide button next to its title. It first runs an illustrated tour on the interface itself — highlighting the key parts with arrows and captions, step by step (1/N) — and at the end asks whether you want to open the matching chapter on this site. Each module’s tour runs automatically only once; after that the button opens this site directly. If you want the tour every time, tick the option in that final dialog, or turn it on in Settings. The User guide button in the left column of the start page leads here. When the interface is in English, these buttons open this English guide.

Module guides

In the order of the navigation bar, top to bottom:

How the modules feed each other

Phonology (phonemes / classes / digraphs) ─→ usable in sound-change rules, orthography rules and script mapping rules
Orthography rules (spelling → IPA) ────────→ Lexicon "pronunciation" column, corpus IPA, phrase pronunciations
Script mapping rules (transcription → glyphs) → Lexicon "script" column, entry cards, script lines in corpus and phrasebook, dictionary export
Morphemes (roots / affixes) ───────────────→ @morpheme in paradigm generators, automatic corpus segmentation, etymology sources
Paradigms (dimensions × slots × generators) → slot panel in the lexicon's Edit mode, inflected forms on entry cards, morphological labels in corpus glosses
Sound-change rule sets (stages bound to languages) → the "run sound changes" pipeline step, lexicon evolution
Lexicon (headwords / senses / inflected forms) → automatic glossing, hover cards, [[headword]] links in docs, dictionary export

Every page has a dismissible blue hint at the top saying which other pages use its data. Once closed it stays closed; you can bring the hints back in Settings.

Keyboard shortcuts

Common conventions

• Three columns: navigation on the left, the main area in the middle, the Inspector on the right. Drag the divider to resize the inspector. Clicking the current module again in the navigation bar keeps you where you are; clicking Skin or Settings again returns to the previous page.
• Everything can be undone: Ctrl+Z undoes the last change to the project (editing a field, deleting an entry, writing derived forms, evolving the lexicon… each counts as one step), Ctrl+Y redoes it, up to 60 steps back. Deletions also show an Undo toast for 8 seconds. There are no “are you sure?” dialogs.
• Right-click menu: anywhere in the app — cut / copy / paste, undo / redo / back, command palette, character panel, save and user guide.
• Drop-down menus open on click and close when you click elsewhere or press Esc.
• Horizontal scrolling: areas that only overflow sideways (tables, chain graphs) scroll horizontally with the ordinary mouse wheel — no need to hold Shift.
• Automation only drafts: automatic pronunciation, inflection and glossing can all be overridden cell by cell with irregular values. Overridden cells are marked, and re-running the automation does not overwrite them.
• Everything is project data: parts of speech, dimensions, abbreviations, dialects and export templates are all stored in the project file, so they travel with it to another computer. The skin and the interface language are application settings and are not stored in the project.
• Every text box can call up the character panel: press Ctrl+I inside any input and click a symbol to insert it at the cursor.
• The search box lives in the top bar, to the right of the project name and save status, and every module has one. Its placeholder and what it filters follow the current module (languages, phonemes and classes, glyphs, rule lines, morphemes, entries, slots, sentences, phrases, docs, fonts, settings), and it clears when you switch pages. Advanced syntax: field=text searches a single field (e.g. gloss=PL, word=kam; Chinese field names such as 释义= work too), field==text requires an exact match, and /regex/ searches with a regular expression. Separate several conditions with spaces (all must match) and put quotes around text that contains spaces. The ? next to the search box lists the fields available on the current page.
• One rule syntax everywhere: sound changes, orthographies, script mappings, paradigm adjustments and morpheme allomorph environments all use the same rule notation. Rule syntax on the start page, or the open-book icon at the top right (between the inspector toggle and Close project), opens the full reference in the inspector; opened from the Sound changes, Paradigms, Script, Phonology or Morphemes page, it scrolls straight to the relevant section.
• Bookmark tabs: the sets you create yourself in Script, Sound changes and Paradigms (each script, each rule set, each paradigm) appear as bookmark tabs to the right of the page title; the selected tab merges with the page below, and the New button is always at the far right. Hovering a tab shows a pencil on its right — click it to focus the Name field in the inspector and rename it directly; paradigm variants work the same way, renamed in place. Press and drag a tab sideways and drop it on another tab to move it there.
• Drag to reorder: ordered rows of small chips — paradigm dimensions and pipeline steps, the components of a part of speech and the parts of speech a dimension applies to, the languages an inspector module applies to, phonemes in the inventory, orthographies, classes and digraphs in sound-change rules, tags everywhere, and phrase and sentence cards — can be pressed and dragged onto another item to take its place. While dragging, the dragged item fades and the drop target gets a dashed outline; pressing inside an input or drop-down within a chip still lets you type and select as usual.
• Collapsible sections: long sections (parts of speech & dimensions, the phoneme and vowel tables, syllable packing and auto-mapping in Script, the entry card and font library in Skin…) have a triangle next to their title that appears on hover; click it to collapse the whole section, and it stays collapsed next time. In Parts of speech & dimensions, each part of speech, dimension and inspector module can also be collapsed to a single line.
• Long lists render in batches: the lexicon, morphemes, corpus, paradigm slots and glyph table draw one screenful first and draw the next batch as you near the bottom, so switching pages and changing filters stays fast.
• The first time you open the app, the start page runs a tour (new / open, starter templates, recent projects, the row at the bottom) and ends by pointing out Rule syntax at the top right; to see a tour again later, click User guide next to a page title.
• Table headers (Lexicon, Morphemes): clicking a column name cycles ▼ descending → ▲ ascending → off; the funnel to the right of a column name opens a filter panel (select all / none / one value; the first column filters by initial letter). If a filter leaves nothing, the header stays so you can clear it. The small button at the far left of the header switches to a custom order, which adds move up / down buttons in that column. Double-click a row to open it in the inspector’s Edit mode.
• Import previews: every import (lexicon and morpheme CSV, corpus and phrasebook tables and JSON, glyphs, Lexicanter, sound-change rule files) first shows what the result will look like in the inspector. Changing a setting updates the preview immediately, with the changed parts highlighted and slowly fading; click Import once it looks right.
• Statistics panels (one each in Lexicon, Morphemes and Corpus) share one layout — number cards, distribution bars and rankings. Clicking an item in a distribution returns to the list filtered or searched by it. Panels side by side are aligned to the shorter one, the longer one scrolls inside, and the panel under the mouse gets a slightly brighter border.

Example projects

The Example projects button on the start page opens two fictional language projects directly (your edits never overwrite the example files). They are two completely different language types that, together, show every module:

• Aelith: an agglutinative language — a proto-language → modern language family with a sister language, Merun (open the relation graph of kaso or teli and click Compare to see how the cognates’ sound changes and meanings differ), vowel harmony, multi-slot suffixes and every kind of pipeline step, variants (the base set renamed to 书面, “written”) and inheritance, sandhi voicing that applies to all words, compound parts of speech and per-sense parts of speech, inspector modules (a cultural note, and runic variants shown in the runic font), etymology chains and the relation graph, a runic script and glossed, confirmed example sentences (the personal name Mira is deliberately missing from the lexicon, so its hover card says “not found”).
• Tsahun: an isolating tone language — tones, two orthographies, syllabary packing and vertical text, bracket settings in the script, @entry references producing inflected forms with spaces (ngo21 tui55), candidates for the homograph hok33, and a “variant characters” module shown in the syllabary font.

Both project files are also in the repository’s examples/ folder.

Feedback

Please report problems and suggestions on GitHub Issues, or contact the author through the Friends links on this site.