====== Преобразование ======

Работы начаты в апреле 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"  |  <key>'Ввод '⏎</key>  |
|  ≤  |  ⩽  |Более "красивый" вариант|
|  ≥  |  ⩾  |:::|
|  %%""%%  |  <code>%%""%%</code>  | Особенности DokuWiki|
|  %%"#"%%  |  <code>«#»</code>  |:::|
|  %%"-"%%  |  <code>«-»</code>  |:::|
|  %%"/"%%  |  <code>«/»</code>  |:::|
|  %%";"%%  |  <code>«;»</code>  |:::|
|  %%"="%%  |  <code>«=»</code>  |:::|
|  %%>>%%  |  <code>%%>>%%</code>  |:::|
| <code>
{ Выражение 1 }
{ Выражение 2 }
{ Выражение 3 }
</code>  |<code>
⎧
⎪
⎨
⎪
⎩
</code>|Фигурные скобки в которые заключены многострочные выражения|


Сообщения об ошибках (текст по центру):
<WRAP centeralign>"Redimensioned array" \\ (//"Переопределение массива"//).</WRAP>
<code><WRAP centeralign>"Redimensioned array" \\ (//"Переопределение массива"//).</WRAP></code>

Используемые расширения:
  * Правила оформления эпиграфа описаны [[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|Архив}} с оригинальными файлами которым даны новые имена.

====== Разделы ======

Для удобства каждый раздел имеет якорь вида:
<WRAP group>
<WRAP half column>
<code>
{{anchor:n123}}
</code>
</WRAP>
,
<WRAP half column>
</WRAP>
</WRAP>
где 123 это номер раздела включая номер главы 

====== Примеры ======

Каждый диск содержит все примеры соответствующей главы.

[[?do=media&ns=msx:basic_dialogue_programming_language:examples|Все файлы примеров]]

[[examples|Списки примеров]]

<hidden>
Формат: ''SS12-nn.bas'', где:
  * ''ss'' — Глава (номера до 9 дополняются нулём слева)
    * 1 — номер раздела внутри главы
    * 2 — номер подраздела внутри раздела
  * ''nn'' — Порядковый номер

Примеры элементов:
  * <WRAP>якорь<code>{{anchor:e01-01}} __//Пример 1//__. \\ {{.examples:01-01.bas|}} \\ [[+tab|wmsxbpge>01-01.bas]]</code> {{anchor:e01-01}} __//Пример 1//__. \\ {{.examples:01-01.bas|}} \\ [[+tab|wmsxbpge>01-01.bas|]]</WRAP>
  * ссылки <code>[[01#e01-01|Пример 1]]</code>

Для извлечения текстов примеров используется [[midnight_commander:midnight_commander|]], в честности его редактор [[midnight_commander:mcedit|mcedit]] и [[openmsx:openmsx|]].
Порядок действий:
  * открываем файл нужной главы (все файлы находятся [[.files:files|здесь]])
  * находим текст примера
  * выделяем фрагмент текста (клавиша <key>F3</key>)
  * входим в меню по <key>F9</key>
  * в меню ''Правка'' выбираем пункт ''Копировать в файл буфера обмена  C-Ins'' 
  * теперь выделенный фрагмент текста находится в файле ''~/.local/share/mc/mcedit/mcedit.clip''
  * копируем файл ''~/.local/share/mc/mcedit/mcedit.clip'' в рабочую папку
  * редактируем файл с примером
  * открываем его в [[openmsx:openmsx|]] командой <code>new
load "0246-04.bas"</code>
  * проверяем работоспособность, если нужно, то исправляем ошибки
  * сохраняем файл в виде текста командой <code>save "0246-04.bas",a</code>
</hidden>

{{anchor:bibliography}}
====== Библиографический список ======

[[bibliography|]]


|Пример вставки ссылки на [14]<code>
[[bibliography#b14|[14]]]
</code>|


====== Рисунки ======
Закладка:
<code>
{{anchor:pict_04_01}}
</code>

Ссылка:
<code>
[[#pict_04_01|рис.1]]
</code>

====== Список служебных слов ======
FIXME

[[201|]]

Закладка: 
<code>
{{anchor:print}}
</code>


{{anchor:missing}}
====== Список отсутствующего материала ======

  * [[005#V.6.2. Вывод спрайта на экран]]
    - рисунки с 1 по 4

====== Ссылки ======

<del>[[github>/mr-GreyWolf/MSX-BASIC-Programming-Guide-Russian|Проект на GitHub (только файлы)]]</del>

Выражаем огромную благодарность тем, кто помог найти файлы:
  * {{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}}