Справочник по Рефалу-5λ

38 views
Skip to first unread message

Александр Коновалов a.v.konovalov87_AT_mail.ru

unread,
Apr 20, 2020, 10:37:11 AM4/20/20
to re...@botik.ru

Добрый день всем!

В рассылке я часто упоминал Рефал-5λ, иногда публиковал ссылку на репозиторий с исходниками. Но вот нормальной документации к нему пока не было.

И вот она появилась:

https://bmstu-iu9.github.io/refal-5-lambda/B-reference.html

В справочнике есть почти полное описание языка (не раскрыты только $DRIVE и $SPEC), инструкция по использованию компилятора и описание отладочных средств. Библиотека встроенных функций там не описана, поскольку она та же самая, что и у классического Рефала-5.

Ну, в общем, теперь на Рефале-5λ может программировать не только автор 😀.

 

С уважением,
Александр Коновалов

 

Boyko Bantchev boykobb_AT_gmail.com

unread,
Apr 21, 2020, 3:51:33 AM4/21/20
to re...@botik.ru
Поздравляю Вас, Александр!

Появление документации – важная веха в развитии любой программы,
тем более такой непростой как в Вашем случае.

Вероятно, стоит снабдить текст содержанием (оглавлением),
и тем лучше, если с гиперссылками.

Бойко

Александр Коновалов a.v.konovalov87_AT_mail.ru

unread,
Apr 21, 2020, 4:49:31 AM4/21/20
to re...@botik.ru

Добрый день, Бойко!

Спасибо за отзыв! Согласен, оглавления не хватает.

Страница сделана на GitHub Pages — в репозитории в папке docs создаётся файл в разметке Markdown и по нему автоматически создаётся web-страница. Но стандартной функциональности для создания оглавлений в GH Pages нет.

Сейчас я изучаю сторонние утилиты, которыми можно добавлять оглавление. Потому что вручную писать оглавление мне лень.

 

С уважением,
Александр Коновалов

Александр Коновалов a.v.konovalov87_AT_mail.ru

unread,
Apr 22, 2020, 5:42:05 AM4/22/20
to re...@botik.ru

Доброе утро всем!

По совету Бойко я добавил содержание в справочник:

https://bmstu-iu9.github.io/refal-5-lambda/B-reference.html

Стало гораздо лучше! Самому нравится!

Но добавил я оглавление не только в справочник, но и в другие страницы руководства:

https://bmstu-iu9.github.io/refal-5-lambda/

А также в документацию к другим своим проектам:

https://mazdaywik.github.io/Refal-05/
https://mazdaywik.github.io/refal-5-framework/

(да, это небольшая реклама)

 

С уважением,
Александр Коновалов

Reply all
Reply to author
Forward
0 new messages