====== Преобразование ======
Работы начаты в апреле 2019 года. Отправной точкой был архив **%%MSX%% Programmer Ref (ru).rar** ([[https://mirrors.pdp-11.ru/_msx/books/MSX%20Programmer%20Ref%20(ru).rar|ссылка 1]], [[http://msx2.org/MSX%20Books/RU/MSX%20Programmer%20Ref%20(ru).rar|ссылка 2]]).
2022-09-07 стало известно настоящее название книги:
\\ **Диалоговый язык программирования %% MSX-BASIC %%** (%% MSX-BASIC %% — Dialogue programming language)
до этого дня, её рабочее название было:
\\ **Пособие по программированию на %% MSX BASIC %%** (%% MSX BASIC %% Programming Guide).
Ниже описан процесс преобразования [[start|книги]] из формата [[msx:russification:russification|MSX]] в [[#DokuWiki]].
Список изменений:
* Убраны лишние пробелы используемые для раздвижки слов.
* Исправлены слова в которых вместо буквы **ё** была буква **е** ((буква **ё** отсутствует на компьютерах MSX, подробнее [[msx:russification:russification|здесь]])).
* Слова написанные в р а з б и в к у отображены //курсивным шрифтом//.
* Исправлены орфографические ошибки
* В списках буквы α, β, γ, δ (альфа, бета, гамма, дельта) заменены на • или цифры (в зависимости от контекста).
* Таблицы, списки переделаны в соответствие с [[dokuwiki:syntax|синтаксисом]] DokuWiki.
* В некоторых случаях для схем использованы [[drawing_symbols:drawing_symbols|]].
* Для обозначения материалов, добавленных в наше время используется значок: 8-)
Список замен:
^ Исходный вариант ^ Замена ^ Примечание ^
| %% MSX-Disk BASIC %% | %% MSX Disk BASIC %% |Убран символ - (дефис-минус)|
| %% MSX-1 %% | [[msx:msx_1]] |Убран символ - (дефис-минус) и сделана ссылка|
| %% MSX-2 %% | [[msx:msx_2]] |:::|
| %% MSX-BASIC %% | [[msx:basic:]] |:::|
| %% MSX DISK BASIC %% | [[msx:disk_basic]] |:::|
| %% MSX-VDP %% | VDP |
| %% MSX-MOUSE %% | %% "мышь" %% |
| %% RAM-диск %% | %% RAM диск %% |
| байтов | байт |
| битов | бит |
| %% ... %% (три точки) | … |
| Вам | вам |
| ╳ | × |
| · | × |Если по контексту нужен символ "умножить"|
| · | ␣ |Если по контексту нужен "пробел"|
| - (дефис-минус) | — и – |Использованы эти [[rules:rules#Использование тире|правила]]|
| ÷ | - |Короткое тире|
|Символ c кодом 0x1B (Esc)| %%^%% | Применено в разделе [[007#n74|VII.4. Работа с принтером]]|
|Основание системы исчисления 2| ₂ |
|Основание системы исчисления 10| ₁₀ |
|Звёздочка %% "*" %%| ∗ |
| Клавиша "RETURN" | 'Ввод '⏎ |
| ≤ | ⩽ |Более "красивый" вариант|
| ≥ | ⩾ |:::|
| %%""%% | %%""%%
| Особенности DokuWiki|
| %%"#"%% | «#»
|:::|
| %%"-"%% | «-»
|:::|
| %%"/"%% | «/»
|:::|
| %%";"%% | «;»
|:::|
| %%"="%% | «=»
|:::|
| %%>>%% | %%>>%%
|:::|
|
{ Выражение 1 }
{ Выражение 2 }
{ Выражение 3 }
|
⎧
⎪
⎨
⎪
⎩
|Фигурные скобки в которые заключены многострочные выражения|
Сообщения об ошибках (текст по центру):
"Redimensioned array" \\ (//"Переопределение массива"//).
"Redimensioned array" \\ (//"Переопределение массива"//).
Используемые расширения:
* Правила оформления эпиграфа описаны [[rules:rules#Эпиграф|здесь]];
* Выделение текстовых блоков: [[dokuwiki:plugins#warp]];
* Для переходов между страницами: [[dokuwiki:plugins#Page Navigation]];
* Для ссылок в произвольное место страницы [[dokuwiki:plugins#anchor]];
* Для клавиш [[dokuwiki:plugins#keyboard]];
* Для отображение математических формул: [[dokuwiki:plugins#mathpublish]];
* Для отображение колонок и блоков: [[dokuwiki:plugins#Wrap]].;
* Запуск примера внутри [[webmsx:webmsx|WebMSX]] в новой вкладке: [[dokuwiki:plugins#Target Link]];
* Размер шрифта ([[006#VI.1. Описание команд MML|ноты]]): [[dokuwiki:plugins#fontsize2]].
* Мягкий перенос [[dokuwiki:plugins#Shy Syntax]], символы: %% \- %%
{{anchor:files}}
====== Файлы ======
Оригинальные [[.files:files|файлы]], сконвертированые в UTF-8, для этого был использован [[msx:russification:converter:|]]
[[msx:basic_dialogue_programming_language:author_files:|]]
[[msx:basic_dialogue_programming_language:files:|]]
[[msx:basic_dialogue_programming_language:files:diff|]]
{{anchor:originalfiles}} {{.files:msx-basic_programming_guide-original.zip|Архив}} с оригинальными файлами которым даны новые имена.
====== Разделы ======
Для удобства каждый раздел имеет якорь вида:
{{anchor:n123}}
,
где 123 это номер раздела включая номер главы
====== Примеры ======
Каждый диск содержит все примеры соответствующей главы.
[[?do=media&ns=msx:basic_dialogue_programming_language:examples|Все файлы примеров]]
[[examples|Списки примеров]]
Формат: ''SS12-nn.bas'', где:
* ''ss'' — Глава (номера до 9 дополняются нулём слева)
* 1 — номер раздела внутри главы
* 2 — номер подраздела внутри раздела
* ''nn'' — Порядковый номер
Примеры элементов:
* якорь{{anchor:e01-01}} __//Пример 1//__. \\ {{.examples:01-01.bas|}} \\ [[+tab|wmsxbpge>01-01.bas]]
{{anchor:e01-01}} __//Пример 1//__. \\ {{.examples:01-01.bas|}} \\ [[+tab|wmsxbpge>01-01.bas|]]
* ссылки [[01#e01-01|Пример 1]]
Для извлечения текстов примеров используется [[midnight_commander:midnight_commander|]], в честности его редактор [[midnight_commander:mcedit|mcedit]] и [[openmsx:openmsx|]].
Порядок действий:
* открываем файл нужной главы (все файлы находятся [[.files:files|здесь]])
* находим текст примера
* выделяем фрагмент текста (клавиша F3)
* входим в меню по F9
* в меню ''Правка'' выбираем пункт ''Копировать в файл буфера обмена C-Ins''
* теперь выделенный фрагмент текста находится в файле ''~/.local/share/mc/mcedit/mcedit.clip''
* копируем файл ''~/.local/share/mc/mcedit/mcedit.clip'' в рабочую папку
* редактируем файл с примером
* открываем его в [[openmsx:openmsx|]] командой new
load "0246-04.bas"
* проверяем работоспособность, если нужно, то исправляем ошибки
* сохраняем файл в виде текста командой save "0246-04.bas",a
{{anchor:bibliography}}
====== Библиографический список ======
[[bibliography|]]
|Пример вставки ссылки на [14]
[[bibliography#b14|[14]]]
|
====== Рисунки ======
Закладка:
{{anchor:pict_04_01}}
Ссылка:
[[#pict_04_01|рис.1]]
====== Список служебных слов ======
FIXME
[[201|]]
Закладка:
{{anchor:print}}
{{anchor:missing}}
====== Список отсутствующего материала ======
* [[005#V.6.2. Вывод спрайта на экран]]
- рисунки с 1 по 4
====== Ссылки ======
[[github>/mr-GreyWolf/MSX-BASIC-Programming-Guide-Russian|Проект на GitHub (только файлы)]]
Выражаем огромную благодарность тем, кто помог найти файлы:
* {{bas3_1.zip|Оригинал файла BAS3_1.MET: глава III (разделы 1,2)}}. Нормальный файл найден благодаря пользователю **caro** на форуме [[msxorg>node/56902#comment-356500|msx.org]]
* {{bas11.zip|Файлы BAS11-1.MET, BAS11-2.MET, BAS11-3.MET: глава (разделы XI. XI.2,XI.1.3,XI.1.4)}}. Файлы найден благодаря пользователю **АIеks** на форуме [[msxorg>node/56902#comment-356616|msx.org]]
* {{bas.zip|Полный архив книги}}. Получен благодаря пользователю **АIеks** на форуме [[msxorg>node/56902#comment-356654|msx.org]]
* Приложение **1.8. Возможность расширения программного обеспечения на MSX–компьютерах** (1.8.1. и 1.8.2.) нашёл **Артем Читайло**
* V.6.2. Вывод спрайта на экран, примеры с 3 по 11 нашёл **Артем Читайло**
{{tag>msxbdpl}}