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

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


msx:basic_programming_guide:converting

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

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

Здесь описан процесс преобразования книги Пособие по программированию на MSX BASIC из формата 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;
  • Размер шрифта (ноты): 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]]).

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

Ссылки

1)
буква ё отсутствует на компьютерах MSX, подробнее здесь
msx/basic_programming_guide/converting.txt · Последние изменения: 2020-04-03 16:11 — GreyWolf