Это старая версия документа!

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

Работы начаты в апреле 2019 года.

Здесь описан процесс преобразования книги Пособие по программированию на MSX BASIC из формата MSX в DokuWiki.

Список изменений:

Убраны лишние пробелы используемые для раздвижки слов.
Исправлены слова в которых вместо буквы ё была буква е ¹⁾.
Слова написанные в р а з б и в к у отображены курсивным шрифтом.
Исправлены орфографические ошибки
В списках буквы α, β, γ, δ (альфа, бета, гамма, дельта) заменены на • или цифры (в зависимости от контекста).
Таблицы, списки переделаны в соответствие с синтаксисом 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;
Размер шрифта (ноты): fontsize2.
Мягкий перенос Shy Syntax, символы: \-

Короткая ссылка на книгу

Файлы

Оригинальные файлы, сконвертированые в UTF-8, для этого был использован этот скрипт.

Архив с оригинальными файлами которым даны новые имена.

Примеры

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

Все файлы примеров

Списки примеров

Нажмите, чтобы отобразить

Нажмите, чтобы скрыть

Формат: SS12-nn.bas, где:

ss — Глава (номера до 9 дополняются нулём слева)
- 1 — номер раздела внутри главы
- 2 — номер подраздела внутри раздела
nn — Порядковый номер

Примеры элементов:

якорь

{{anchor:e01-01}} __//Пример 1//__. \\ {{.examples:01-01.bas|}} \\ [[+tab|wmsxbpge>01-01.bas]]

Пример 1.
01-01.bas
01-01.bas

ссылки
```
[[01#e01-01|Пример 1]]
```

Для извлечения текстов примеров используется GNU Midnight Commander, в честности его редактор mcedit и openMSX. Порядок действий:

открываем файл нужной главы (все файлы находятся здесь)
находим текст примера
выделяем фрагмент текста (клавиша F3)
входим в меню по F9
в меню Правка выбираем пункт Копировать в файл буфера обмена C-Ins
теперь выделенный фрагмент текста находится в файле ~/.local/share/mc/mcedit/mcedit.clip
копируем файл ~/.local/share/mc/mcedit/mcedit.clip в рабочую папку
редактируем файл с примером
открываем его в openMSX командой
```
new
load "0246-04.bas"
```
проверяем работоспособность, если нужно, то исправляем ошибки
сохраняем файл в виде текста командой
```
save "0246-04.bas",a
```

Список литературы

Пример вставки ссылки на [14]

[[bibliography#b14|[14]]]

Рисунки

Закладка:

{{anchor:pict_04_01}}

Ссылка:

[[#pict_04_01|рис.1]]).

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

201

Закладка:

{{anchor:print}}

Ссылки

Проект на GitHub (только файлы и примеры)

Обсуждения:

Book msxbpg, Проект на GitHub

¹⁾

буква ё отсутствует на компьютерах MSX, подробнее здесь

Мозаика системного администрирования

Инструменты пользователя

Инструменты сайта