Содержание
Преобразование
Работы начаты в апреле 2019 года. Отправной точкой был архив MSX Programmer Ref (ru).rar (ссылка 1, ссылка 2).
2022-09-07 стало известно настоящее название книги:
Диалоговый язык программирования MSX-BASIC ( MSX-BASIC — Dialogue programming language)
до этого дня, её рабочее название было:
Пособие по программированию на MSX BASIC ( MSX BASIC Programming Guide).
Ниже описан процесс преобразования книги из формата MSX в DokuWiki.
Список изменений:
- Убраны лишние пробелы используемые для раздвижки слов.
- Исправлены слова в которых вместо буквы ё была буква е 1).
- Слова написанные в р а з б и в к у отображены курсивным шрифтом.
- Исправлены орфографические ошибки
- В списках буквы α, β, γ, δ (альфа, бета, гамма, дельта) заменены на • или цифры (в зависимости от контекста).
- Таблицы, списки переделаны в соответствие с синтаксисом DokuWiki.
- В некоторых случаях для схем использованы Символы для оформления текста.
- Для обозначения материалов, добавленных в наше время используется значок:
Список замен:
| Исходный вариант | Замена | Примечание |
|---|---|---|
| MSX-Disk BASIC | MSX Disk BASIC | Убран символ - (дефис-минус) |
| MSX-1 | MSX 1 | Убран символ - (дефис-минус) и сделана ссылка |
| MSX-2 | MSX 2 | |
| MSX-BASIC | MSX BASIC | |
| MSX DISK BASIC | MSX Disk BASIC | |
| MSX-VDP | VDP | |
| MSX-MOUSE | "мышь" | |
| RAM-диск | RAM диск | |
| байтов | байт | |
| битов | бит | |
| ... (три точки) | … | |
| Вам | вам | |
| ╳ | × | |
| · | × | Если по контексту нужен символ «умножить» |
| · | ␣ | Если по контексту нужен «пробел» |
| - (дефис-минус) | — и – | Использованы эти правила |
| ÷ | - | Короткое тире |
| Символ c кодом 0x1B (Esc) | ^ | Применено в разделе VII.4. Работа с принтером |
| Основание системы исчисления 2 | ₂ | |
| Основание системы исчисления 10 | ₁₀ | |
| Звёздочка "*" | ∗ | |
| Клавиша «RETURN» | Ввод ⏎ | |
| ≤ | ⩽ | Более «красивый» вариант |
| ≥ | ⩾ | |
| "" | %%""%% | Особенности DokuWiki |
| "#" | «#» |
|
| "-" | «-» |
|
| "/" | «/» |
|
| ";" | «;» |
|
| "=" | «=» |
|
| >> | %%>>%% |
|
{ Выражение 1 }
{ Выражение 2 }
{ Выражение 3 }
| ⎧ ⎪ ⎨ ⎪ ⎩ | Фигурные скобки в которые заключены многострочные выражения |
Сообщения об ошибках (текст по центру):
«Redimensioned array»
(«Переопределение массива»).
<WRAP centeralign>"Redimensioned array" \\ (//"Переопределение массива"//).</WRAP>
Используемые расширения:
- Правила оформления эпиграфа описаны здесь;
- Выделение текстовых блоков: warp;
- Для переходов между страницами: Page Navigation;
- Для ссылок в произвольное место страницы anchor;
- Для клавиш keyboard;
- Для отображение математических формул: mathpublish;
- Для отображение колонок и блоков: Wrap.;
- Запуск примера внутри WebMSX в новой вкладке: Target Link;
- Мягкий перенос Shy Syntax, символы: \-
Файлы
Оригинальные файлы, сконвертированые в UTF-8, для этого был использован Конвертер текстов созданных на MSX в кодировку UTF-8
Архив с оригинальными файлами которым даны новые имена.
Разделы
Для удобства каждый раздел имеет якорь вида:
{{anchor:n123}}
,
где 123 это номер раздела включая номер главы
Примеры
Библиографический список
Пример вставки ссылки на [14][[bibliography#b14|[14]]] |
Рисунки
Закладка:
{{anchor:pict_04_01}}
Ссылка:
[[#pict_04_01|рис.1]]
Список служебных слов
Список отсутствующего материала
-
- рисунки с 1 по 4
Ссылки
Проект на GitHub (только файлы)
Выражаем огромную благодарность тем, кто помог найти файлы:
- Оригинал файла BAS3_1.MET: глава III (разделы 1,2). Нормальный файл найден благодаря пользователю caro на форуме msx.org
- Файлы BAS11-1.MET, BAS11-2.MET, BAS11-3.MET: глава (разделы XI. XI.2,XI.1.3,XI.1.4). Файлы найден благодаря пользователю АIеks на форуме msx.org
- Полный архив книги. Получен благодаря пользователю АIеks на форуме msx.org
- Приложение 1.8. Возможность расширения программного обеспечения на MSX–компьютерах (1.8.1. и 1.8.2.) нашёл Артем Читайло
- V.6.2. Вывод спрайта на экран, примеры с 3 по 11 нашёл Артем Читайло
1)
буква ё отсутствует на компьютерах MSX, подробнее здесь