check_readability
Analyze readability of Czech texts with metrics, grammatical rule violations, lexical rarity distribution, and sentence types. Identify complex sentences, rare words, and missing verbs to improve clarity.
Instructions
Analyzuje čitelnost českého textu pomocí PONK — 4 feature sety (v0.7.0).
PONK byl navržen pro úřední komunikaci s občany. V0.7.0 wrapper vystavuje
všechny 4 jeho feature sety, ne jen metriky:
1. **Overall metrics** — ARI (years of education needed), Verb Distance,
Activity, Lexical diversity. (Always returned.)
2. **Grammatical rules** (``include_rules=True``) — list pravidel které se
v textu aktivovala. Každé pravidlo má český název a popis. Aktuálně PONK
detekuje: Nedostatek sloves, Přemíra podstatných jmen, Dlouhé věty,
Sloveso příliš daleko v klauzi, ...
3. **Lexical surprise** (``include_lexical_surprise=True``) — distribuce
sémantické překvapivosti slov (1=běžné, 16=velmi vzácné/odborné).
Vrátí summary: kolik slov je common / surprising / very_surprising.
4. **Speech acts** (``include_speech_acts=True``) — typy vět (Situace,
Kontext, Postup, Proces, Podmínky, Doporučení, Odkazy, Prameny).
Args:
text: Vstupní text.
input_format: ``txt`` (default), ``md``, ``docx``.
include_rules: Default ``True``. List aktivovaných gramatických pravidel.
include_lexical_surprise: Default ``True``. Distribuce vzácnosti slov.
include_speech_acts: Default ``True``. Typy vět/řečové akty.
include_highlighted_html: Default ``False`` (úspora bandwidthu — HTML
má 100+ KB). Zapni pro vizualizační report/PDF.
Returns:
``metrics``, ``counts``, ``version``, ``processing_time_s``,
+ volitelné ``rules`` (list), ``lexical_surprise`` (dict),
``speech_acts`` (dict), ``highlighted_html`` (str).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| input_format | No | txt | |
| include_rules | No | ||
| include_lexical_surprise | No | ||
| include_speech_acts | No | ||
| include_highlighted_html | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||