Files

T

snark13 46553f4e07 mdview2: фоновая сборка второго набора кодировки в паузах между клавишами; версия v1.0 (b3)

- индексатор порезан на резюмируемые шаги index_begin/index_step/index_finish;
  межшаговое состояние в статиках модуля, в docset_t не входит
- bg_build_start/bg_step: второй набор (UTF-8 при 8-битном первичном и
  наоборот) строится в idle главного цикла; холдаун после клавиш, спиннер
  погашен (g_bg_building) — фон незаметен
- F8 до готовности докручивает начатое фоном (ветка resume в build_doc),
  а не строит заново; общий setup вынесен в doc_setup
- кодировка в статус-баре показывается сразу (детект/F8), не дожидаясь
  конца индексации
- побочный фикс: UTF-конвертация впереди проверки останова — >4КБ абзац
  больше не обрывает конвертацию остатка
- README.md (новый, v1.0 b3), CHANGELOG.md; дискета: README/DEMO/CHANGES
  в трёх кодировках (пути автодетекта)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-05 19:33:34 +03:00

11 KiB

Raw Blame History

MDView v1.0 (b3) — просмотрщик Markdown для Sprinter

MDView — программа просмотра документов Markdown для компьютера Sprinter-2000 (Z80, ОС ESTEX). Файл загружается в расширенную память (EMM) и один раз «прогоняется» через парсер: готовые к показу строки (пары символ+атрибут) складываются в рендер-кэш в EMM, после чего прокрутка в любую сторону — это просто копирование готовых строк на экран, без повторного парсинга. Даже на файлах в сотни килобайт листание остаётся мгновенным.

Текстовый режим 80×32, цветное оформление элементов разметки, три режима просмотра (MD / RAW / HEX) и четыре кодировки с автоопределением.

Возможности

Markdown-рендеринг с цветовым оформлением:
- заголовки #…###### (H5/H6 отображаются как H4);
- жирный (**текст**), курсив (*текст*), подчёркнутый (_текст_), ~~зачёркнутый~~ (~~текст~~), встроенный код (`текст`);
- экранирование \*, \_, \` и любой ASCII-пунктуации;
- чекбоксы [x] / [ ] в списках;
- ненумерованные (-, *, +) и нумерованные (1., 1)) списки с базовой вложенностью по отступам;
- цитаты > (склейка многострочных, маркер │ на переносах);
- fenced-блоки кода ``` (без переносов, горизонтальный скролл);
- таблицы | … | … | — рисуются псевдографической рамкой, ширины колонок вычисляются по содержимому (до 16 колонок);
- горизонтальные разделители --- / *** / ___;
- жёсткие переносы (два пробела или \ в конце строки);
- мягкая склейка абзацев с переносом по словам под ширину экрана.
Кодировки: CP866, CP1251, KOI8-R, UTF-8.
- автоопределение при открытии (BOM → UTF-8; валидность multibyte-структуры; частотный анализ ходовых русских букв для 8-битных);
- переключение по кругу клавишей F8 в любой момент;
- 8-битные кодировки отличаются только перекодировкой глифов на отрисовке — переключение мгновенно;
- UTF-8 декодируется в CP866 в отдельный набор (файл + индекс + кэш); второй набор готовится в фоне, пока вы читаете документ, — обычно к первому нажатию F8 он уже построен и переключение мгновенно, с сохранением позиции. Если фон не успел, F8 докручивает начатую сборку (со спиннером), а не начинает её заново.
Три режима просмотра:
- MD — форматированный Markdown (по умолчанию);
- RAW (F2) — исходный текст без разметки: перенос строк кратно 80 (F3 — режим панорамы с горизонтальным скроллом);
- HEX (F4) — дамп оригинального файла: 0x012340 │ 16 байт hex │ 16 печатных символов. Печатная колонка интерпретируется текущей кодировкой; для UTF-8 глиф ставится на позиции лид-байта, continuation-байты показываются точкой.
Единая позиция при любых переключениях: MD ↔ RAW ↔ HEX и смена кодировки сохраняют текущее место в документе (между наборами разного размера — пропорционально, с точностью до строки).
Прогрессивная загрузка: первый экран показывается сразу, индексация продолжается в фоне; по готовой части документа уже можно листать, Esc/F10 прерывают загрузку.
Фоновая работа незаметна: второй набор кодировки строится только в паузах между клавишами (после нажатия выдерживается пауза), поэтому скролл — в том числе с автоповтором — не теряет плавности.

Запуск

MDVIEW2.EXE <файл.md>

Без аргумента открывается README.MD из текущего каталога.

Клавиши

Клавиша	Действие
↑ / ↓	прокрутка на одну строку
PgUp / PgDn	прокрутка на экран (30 строк)
Home / End	в начало / в конец документа
← / →	горизонтальный сдвиг: код/таблицы в MD, панорама в RAW
F1	справка
F2	RAW-режим ↔ MD
F3	в RAW: перенос строк ↔ панорама
F4	HEX-режим ↔ прежний вид
F8	кодировка: CP866 → CP1251 → KOI8-R → UTF-8 → …
Esc / F10	выход (во время загрузки — прервать её)

Статус-бар (верхняя строка): имя файла, кодировка, диапазон видимых строк и процент прокрутки. Нижняя строка — меню доступных F-клавиш.

Ограничения

Параметр	Значение
Размер файла	до 256 КБ (больший — обрезается с предупреждением)
Логических строк (после переносов)	до 18 432
Длина строки в рендер-кэше	255 ячеек (RAW/HEX ограничения не имеют)
Колонок в таблице	до 16
Шаг табуляции	4

При исчерпании любого лимита документ завершается строкой-сообщением с указанием причины обрыва; всё, что вошло, доступно для просмотра.

Требования

Sprinter-2000 с ОС ESTEX;
расширенная память (EMM): в худшем случае (файл 256 КБ + оба набора кодировок) — до ~150 страниц по 16 КБ (~2,4 МБ). Для типичных файлов в десятки килобайт достаточно нескольких десятков страниц.

Код, данные, стек и куча программы занимают окна W1+W2 (32 КБ, режим памяти small); окно W3 используется только для доступа к EMM-страницам.

Сборка

Требуется тулчейн этого репозитория (обёртка sprinter-cc над SDCC 4.5). Из каталога examples/mdview2:

make            # собрать mdview2.exe
make floppy     # собрать и упаковать дискету для MAME (mc.img)
make run        # floppy + запуск MAME

На дискету кладутся: MDVIEW2.EXE и три документа, каждый в своей кодировке (заодно покрывают все пути автодетекта): README.MD — этот файл, как есть (UTF-8); DEMO.MD — демонстрация всех элементов разметки (CP1251); CHANGES.MD — история версий (CP866).

Структура исходников

Файл	Назначение
`mdview2.c`	ядро: EMM-аллокации, рендер-кэш, наборы кодировок, загрузка файла, главный цикл
`mdview2_index.c`	парсер/индексатор Markdown — единственный проход по файлу
`mdview2_md.c`	MD-вид: отрисовка из кэша, прокрутка
`mdview2_raw.c`	RAW-вид (F2/F3)
`mdview2_hex.c`	HEX-вид (F4)
`mdview2_enc.c`	кодировки: детект, ремап-таблицы, конвертер UTF-8 → CP866
`mdview2_table.c`	отрисовка таблиц
`mdview2_status.c`	статус-бар, меню, спиннер
`mdview2_help.c`	справка (F1)
`mdview2_conf.h`	конфигурация: `WITH_RAW` / `WITH_HEX` (модули отключаемы)
`mdview2.h`	общие константы, атрибуты, межмодульный API

Подробности архитектуры — в docs/mdview2-plan.md.

11 KiB Raw Blame History Unescape Escape