check_readability
Analyze Czech text readability using PONK metrics, grammatical rules, lexical surprise, and speech acts. Identify complex sentences, rare vocabulary, and sentence types to improve official communication.
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 | |||