Bg Text

bg-text — Качество на българския текст

Справочник за качествен български текст в съвременно писане, локализация, интерфейсни текстове и редакторски преглед.

Приоритет на стила: ако потребителят изрично поиска конкретен стил (разговорен, академичен, SEO, художествен, технически, UI, локализация за игри и т.н.), това има предимство пред общите правила тук. Тези правила са подразбиране, не догма.

Източникова дисциплина: не представяй редакторска практика или UX евристика като твърда книжовна норма. За норма се опирай първо на Института за български език при БАН, BERON и Службата за езикови справки. За стилови и продуктови решения ги маркирай като редакторска, локализационна или проектна практика. Ако трябва да цитираш опора, започвай от references/sources.md.

Проверено срещу външни източници:

• „…“ и ‚…‘, десетичната запетая, редните числителни с точка или дефисно окончание и пунктуационните правила са в обхвата на ИБЕ/БЕРON.
• ѝ е част от книжовната употреба и се среща последователно в материалите на ИБЕ.
• правила като - вместо — в дигитален текст, кратък UI текст, ограничена пунктуация в интерфейс и избягване на бюрократичен изказ са редакторска и UX практика, не академична норма.
• corpusbdr.info е полезен научен ресурс за диалектология, но не е първичен нормативен източник за книжовен правопис и пунктуация.

Кратки опорни връзки:

• ИБЕ, Езикови справки: https://ibl.bas.bg/ezikovi-spravki/
• ИБЕ, пример за кавички: https://ibl.bas.bg/ezikovispravki/vaprosi/kavichki-8
• ИБЕ, Речник на българския език, „запетая“: https://ibl.bas.bg/rbe/lang/bg/запетая/
• ИБЕ, редни числителни с арабски цифри: https://ibl.bas.bg/ezikovispravki/vaprosi/chislitelni-imena-sheyset-i-shestdeset-7-klas-7-i-klas-vii-klas-39-oto-2014-a-5/294
• BERON: https://beron.mon.bg/beron

Винаги активни: типография

Прилагай тези правила към всеки български текст, освен ако потребителят изрично не иска друго. Таблицата по-долу съдържа само високоуверени правила; по-спорните или стилови предпочитания са в references/typography.md.

Пълен справочник по типография: references/typography.md

/bg-text:bg-score — оценка за качество на текста (0-10, 5 измерения).

Основни приоритети за български език

Българският трябва да се третира като самостоятелен език, а не като руски с други думи.

Предпочитай:

• естествен съвременен български
• утвърдени български термини, когато има такива
• ясна и директна формулировка
• културно естествен превод вместо механична транслитерация
• деятелен залог, когато прави текста по-ясен
• кратък и четим UI текст
• тон и обръщение, съобразени с контекста, без автоматично преминаване към формално „Вие“
• съгласуване по род и контекст, когато е нужно
• превод на техническите термини според функцията им, а не според английската дума сама по себе си

Избягвай:

• руска лексика и руски словоред
• руски типографски навици в стандартен български текст
• буквален превод от английски, когато има естествен български вариант
• бюрократичен изказ
• раздут номинален стил
• неоснователен дрейф към формално „Вие“ в UI, локализация, игри, общности и неформални продукти
• тромави неутрални конструкции, когато родът е ясен или може да се изрази по-чисто
• механично превеждане на hook, fix, module, handler и други технически думи без проверка какво реално правят

Технически термини и заемки

Статут: редакторска и локализационна практика; терминът в изходния код може да остане непроменен.

При технически текст първо установи ролята на термина, после избери българската формулировка:

1. Запази английския термин, ако е идентификатор, име на API, команда, формат или установено име на технология.
2. Преведи го, ако е видим за играч или потребител и има естествен български еквивалент.
3. Ако няма единен еквивалент, предпочети кратко функционално описание пред буквална заемка.
4. Не добавяй техническа точност, която липсва в източника. hook не означава автоматично „модул“, „прихващач“ или „кука“.

Пример за compatibility hook:

Пример: The journal level label was corrected through the compatibility hook. може да стане „Надписът за нивото в дневника е коригиран чрез механизма за съвместимост.“ Не избирай „прихващач“ или „кука“, ако читателят не е разработчик и терминът не е обяснен.

Проверявай изрично и многозначни технически думи. Те не бива да се превеждат по първото им възможно значение:

При повтарящ се термин предложи кратък глосар или задай въпрос при първата неясна употреба. Не сменяй избрания превод в останалия текст без причина.

Чести слаби думи и конструкции

Пълен списък със слаби формулировки: references/clear-writing.md

Кога да се зареждат справочните файлове

Справочни файлове (пътищата са относителни към този SKILL.md): references/<filename> Ако пътят не се разреши, търси Glob("**/bg-text/references/scoring.md") и използвай родителската директория.

Контролен списък за качество

Преди да върнеш български текст:

• Кавичките са „“, а вложените кавички са ‚‘
• Средното тире (–) се използва за диапазони, когато контекстът е редактиран текст
• Няма двойни интервали и няма интервал преди пунктуация
• Има по един интервал след пунктуация, когато е нужно
• Използва се … само когато е нужно
• Abbreviations: т. н., т. е., т. п.
• Десетичната запетая е използвана правилно
• Българското ѝ е използвано правилно
• Редакторските и UX предпочитания не са представени като твърда езикова норма
• Няма руска лексика или руски словоред
• Няма буквален английски превод, когато има естествен български вариант
• Няма бюрократичен или раздут изказ
• UI текстът е кратък и четим
• Обръщението е последователно и подходящо за контекста: „ти“, „Вие“ или неутрална конструкция
• Предпочетен е деятелен залог, когато е уместно
• Тонът съответства на аудиторията и контекста