|
|
@@ -1,6 +1,6 @@
|
|
|
# Free Oberon programming environment
|
|
|
|
|
|
-Oberon is a general-purpose programming language–the simplest of them all, yet fully powerful. It is the improved (and perfect) Pascal.
|
|
|
+Oberon is a general-purpose programming language–the simplest of them all, yet fully powerful. It is Pascal, developed and perfected.
|
|
|
|
|
|
Free Oberon is a cross-platform integrated development environment for programming in Oberon, made in the classical pseudo-graphic style (the famous blue Pascal screen).
|
|
|
|
|
|
@@ -10,129 +10,113 @@ Free Oberon is a cross-platform integrated development environment for programmi
|
|
|
|
|
|
*See English text below.*
|
|
|
|
|
|
-[Как собрать новую версию под Линукс](README_build_rus.md)
|
|
|
-
|
|
|
# Среда программирования Free Oberon
|
|
|
|
|
|
Оберон — самый простой, и при этом всецело мощный, язык программирования общего назначения. Это развитый и доведённый до совершенства Паскаль.
|
|
|
|
|
|
Free Oberon представляет собой кроссплатформенную интегрированную среду разработки на языке программирования Оберон, выполненную в классическом псевдографическом стиле — знаменитого синего экрана Паскаля).
|
|
|
|
|
|
-* Версия 1.0.3
|
|
|
-* Рига, 1 июля 2021 г.
|
|
|
+* Версия 1.1.0-alpha.2
|
|
|
+* Рига, 27 января 2022 г.
|
|
|
* Сайт: [free.oberon.org](https://free.oberon.org)
|
|
|
|
|
|
# Установка
|
|
|
|
|
|
## Установка под Линукс
|
|
|
|
|
|
-1. Скачайте исходные коды Free Oberon в виде архива tar.gz с сайта [free.oberon.org](https://free.oberon.org) или с репозитория на GitHub. Архив с версией для ОС Windows тоже подойдёт, потому что он содержит исходные коды. Распакуйте архив в свой домашний каталог или в другое место на диске. (Ниже предполагается, что архив распакован в домашний каталог.)
|
|
|
-2. Используя терминал или каким-либо иным образом, установите следующие пакеты программного обеспечения:
|
|
|
- * libsdl2-dev
|
|
|
- * libsdl2-image-dev
|
|
|
- * binutils
|
|
|
- * gcc
|
|
|
- * make
|
|
|
+1. На сайте https://github.com/kekcleader/FreeOberon.git
|
|
|
+ нажмите зелёную кнопку «Code» и «Download ZIP»,
|
|
|
+ распакуйте архив в домашнем каталоге.
|
|
|
+ Вы можете переименовать каталог `FreeOberon-master` в `FreeOberon`.
|
|
|
|
|
|
- Названия пакетов даны в соответствии с их наименованием в ОС Дебиан. Они подойдут для пользователей Убунту и т. п.
|
|
|
- Для их установки, выполните команду:
|
|
|
- ```
|
|
|
- apt-get install -y libsdl2-dev libsdl2-image-dev binutils gcc make
|
|
|
- ```
|
|
|
- (Эту команду необходимо выполнить с правами суперпользователя, т. е. предварительно необходимо запустить `su` и ввести пароль.)
|
|
|
- На ОС Fedora, Red Hat, CentOS и других, команда и названия пакетов будут отличаться (возможно, также необходимо установить один из двух пакетов: glibc-static или glibc-devel-static):
|
|
|
- ```
|
|
|
- sudo yum install SDL2-devel SDL2_image-devel binutils gcc make (не проверено!)
|
|
|
- ```
|
|
|
-3. Войдите в подкаталог `src` и запустите компиляцию:
|
|
|
- ```
|
|
|
- cd ~/FreeOberon/src
|
|
|
- make -f Makefile_linux
|
|
|
- ```
|
|
|
-4. (по желанию) Допишите в конец файла `~/.bashrc` строчку:
|
|
|
+2. Находясь в распакованном каталоге, запустите `install.sh` с правами администратора.
|
|
|
+```
|
|
|
+su
|
|
|
+./install.sh
|
|
|
+```
|
|
|
+
|
|
|
+Альтернативный вариант — [собрать Free Oberon вручную](README_build_rus.md).
|
|
|
+
|
|
|
+3. (по желанию) Допишите в конец файла `~/.bashrc` строчку:
|
|
|
```
|
|
|
alias fo='cd ~/FreeOberon;./FreeOberon'
|
|
|
```
|
|
|
- чтобы Free Oberon можно было запускать командой `fo`.
|
|
|
+ Это позволит запускать Free Oberon командой `fo`.
|
|
|
+
|
|
|
|
|
|
## Установка под Windows
|
|
|
|
|
|
Скачайте установщик в формате EXE с сайта [free.oberon.org](https://free.oberon.org), запустите его и следуйте инструкциям.
|
|
|
|
|
|
-Кроме того, можно скачать версию Free Oberon для Windows в ZIP-архиве (с [free.oberon.org](http://free.oberon.org)) и распаковать его в любое место на диске, после чего (по желанию) создать ярлык на рабочем столе.
|
|
|
+Кроме того, можно скачать версию Free Oberon для Windows в ZIP-архиве (с [free.oberon.org](https://free.oberon.org)) и распаковать его в любое место на диске, при желании создав ярлык на рабочем столе.
|
|
|
|
|
|
Примечание. Если вы хотите самостоятельно собрать версию Free Oberon под ОС Windows из исходных кодов, обратитесь к приложению A [документации Free Oberon на free.oberon.org](http://free.oberon.org/files/FreeOberon_v1.0.3_ru.pdf).
|
|
|
|
|
|
|
|
|
# Использование
|
|
|
|
|
|
-Запустите Free Oberon и наберите текст программного модуля на языке Оберон (или же откройте файл с примером программы, например `Book.Mod`) и нажмите `F9`, чтобы скомпилировать и запустить программу.
|
|
|
-Файлы с исходными кодами модулей сохраняются в подкаталоге `Programs`, а скомпилированные исполняемые файлы сохраняются в `bin`. Сценарии `Data/bin/compile.sh` и `Data\bin\compile.bat` используются соответственно на Линуксе и Windows'е для компиляции и могут при необходимости быть отредактированы.
|
|
|
+Запустите Free Oberon и наберите текст программного модуля на языке Оберон (или откройте файл с примером программы, например `ReadText.Mod`). Нажмите `F9`, чтобы скомпилировать и запустить программу.
|
|
|
+Файлы с исходным кодом ваших программ сохраняются в подкаталоге `Programs`, а скомпилированные исполняемые файлы сохраняются в подкаталоге `bin`. Сценарий `Data/bin/compile.sh` (`Data\bin\compile.bat`) используется на Линуксе (Виндоусе) для компиляции программ на Обероне. Вы можете править эти сценарии.
|
|
|
+
|
|
|
+Можно писать программы, состоящие из нескольких модулей. Откройте главный модуль и нажмите `F9`. Free Oberon автоматически компилирует их в правильном порядке.
|
|
|
|
|
|
-Начиная с версии 1.0.3 есть возможность компилировать и запускать программы, состоящие из нескольких модулей. Поместите все модули в каталог `Programs`, откройте главный модуль и нажмите `F9`.
|
|
|
-Если в одном из модулей программы будет найдена ошибка, соответствующий файл откроется и будет указано на место ошибки. Чтобы перекомпилировать, снова перейдите к окну главного модуля и нажмите `F9`.
|
|
|
-Если в программе используется модуль Graph, к программе будет автоматически прикомпонована библиотека SDL2 (будет использован сценарий `Data/bin/link_graph.sh` (или `.bat`).
|
|
|
+Если вы компилируете программу, файл главного модуля которой не находится непосредственно в подкаталоге `Programs`, то скомпилированный исполнимый файл будет находится рядом с ним, а не в подкаталоге `bin`.
|
|
|
|
|
|
-Начиная с версии 1.1.0 можно компилировать проекты, находящиеся в других каталогах.
|
|
|
+Если в одном из модулей программы будет найдена ошибка, соответствующий файл откроется, место и характер ошибки будут указаны. Чтобы перекомпилировать, снова перейдите к окну главного модуля и нажмите `F9`.
|
|
|
+Если в программе используется модуль Graph, к ней будет автоматически прикомпонована библиотека Allegro5 — будет использован сценарий `Data/bin/link_graph.sh` (`.bat`) вместо `Data/bin/link_console.sh`.
|
|
|
|
|
|
-___________________________________
|
|
|
+______
|
|
|
|
|
|
|
|
|
*ENGLISH*
|
|
|
|
|
|
-* Version 1.0.3
|
|
|
-* Riga, July 1, 2021
|
|
|
+* Version 1.1.0-alpha.2
|
|
|
+* Riga, January 27, 2022
|
|
|
* Website: [free.oberon.org](https://free.oberon.org/en)
|
|
|
|
|
|
+# Install
|
|
|
|
|
|
-# Installation
|
|
|
+## Install on Linux
|
|
|
|
|
|
-## Installation under OS GNU/Linux.
|
|
|
+1. On the https://github.com/kekcleader/FreeOberon.git website
|
|
|
+ click the green button labeled «Code» and then click «Download ZIP»,
|
|
|
+ unpack the archive inside your home directory.
|
|
|
+ You can rename directory `FreeOberon-master` to `FreeOberon`.
|
|
|
|
|
|
-1. Download Free Oberon source code from [free.oberon.org](https://free.oberon.org) in tar.gz format or from the GitHub repo. Note that the archive with the version for Windows is also suitable, because it contains the source code. Extract the archive to your home directory or to another location on the disk. (This tutorial will assume the files are extracted to the home directory.)
|
|
|
-2. Using terminal or in any other way, install the following packages:
|
|
|
- * libsdl2-dev
|
|
|
- * libsdl2-image-dev
|
|
|
- * binutils
|
|
|
- * gcc
|
|
|
- * make
|
|
|
+2. Inside the unpacked directory, run `install.sh` with root privileges.
|
|
|
+```
|
|
|
+su
|
|
|
+./install.sh
|
|
|
+```
|
|
|
|
|
|
- The names of the packages are given in accordance with their names in the Debian GNU/Linux operating system. They are also suitable for Ubuntu, Linux Mint, Raspbian and other.
|
|
|
- To install them, run the following command:
|
|
|
- ```
|
|
|
- apt-get install -y libsdl2-dev libsdl2-image-dev binutils gcc make
|
|
|
- ```
|
|
|
- (This command must be executed with superuser privileges, that is, you must first run `su` and enter the password.)
|
|
|
- On OS Fedora, Red Hat, CentOS and others, the command and package names will differ (one the packages glibc-static or glibc-devel-static might also be required):
|
|
|
- ```
|
|
|
- sudo yum install SDL2-devel SDL2_image-devel binutils gcc make (not tested!)
|
|
|
- ```
|
|
|
-3. Go to the `src` subdirectory and start the compilation:
|
|
|
- ```
|
|
|
- cd ~/FreeOberon/src
|
|
|
- make -f Makefile_linux
|
|
|
- ```
|
|
|
-4. (optional) Append the following line to the end of file `~/.bashrc`:
|
|
|
+Alternatively, you can [build Free Oberon manually](README_build_eng.md).
|
|
|
+
|
|
|
+3. (optional) Append the following line to the end of file `~/.bashrc`:
|
|
|
```
|
|
|
alias fo='cd ~/FreeOberon;./FreeOberon'
|
|
|
```
|
|
|
This will allow you to launch Free Oberon using the `fo` command.
|
|
|
|
|
|
-## Installation under Windows.
|
|
|
|
|
|
-Download the setup porgram in EXE format from [free.oberon.org](https://free.oberon.org), run it and follow the instructions.
|
|
|
+## Install on Windows
|
|
|
+
|
|
|
+Download the setup porgram in EXE format from [free.oberon.org](https://free.oberon.org/en), run it and follow the instructions.
|
|
|
|
|
|
-Alternatively, you can download a version of Free Oberon in a ZIP-archive (from [free.oberon.org](http://free.oberon.org)), extract it to any place on the disk and (optionally) create a desktop shortcut.
|
|
|
+Alternatively, you can download a version of Free Oberon in a ZIP-archive (from [free.oberon.org](https://free.oberon.org/en)), extract it to any place on the disk and (optionally) create a desktop shortcut.
|
|
|
+
|
|
|
+Note. If you want to recompile Free Oberon under Windows from the source code, refer to Appendix A of the [Free Oberon documentation on free.oberon.org](https://free.oberon.org/files/FreeOberon_v1.0.3_en.pdf).
|
|
|
|
|
|
-Note. If you want to recompile Free Oberon under Windows from the source code yourself, refer to Appendix A of the [Free Oberon documentation on free.oberon.org](http://free.oberon.org/files/FreeOberon_v1.0.3_en.pdf).
|
|
|
|
|
|
# Usage
|
|
|
|
|
|
-Run Free Oberon and type in an Oberon program (or open an example program like `Book.Mod`) and press `F9` to compile and run the program.
|
|
|
+Run Free Oberon and type the text of an Oberon module (or open a sample program such as `ReadText.Mod`) and press `F9` to compile and run the program.
|
|
|
+The source code files of your programs are saved in the `Programs` subdirectory, and the compiled executables are saved in the `bin` subdirectory. The script `Data/bin/compile.sh` (`Data\bin\compile.bat`) is used on Linux (Windows) to compile an Oberon program. You can edit these scripts.
|
|
|
+
|
|
|
+You can write programs consisting of several modules. Open the main module and press `F9`. Free Oberon automatically compiles them in the correct order.
|
|
|
|
|
|
-The module source code files are saved in subdirectory `Programs` and the compiled executable files are saved in `bin`. Scripts `Data/bin/compile.sh` and `Data\bin\compile.bat` are used to compile a program on GNU/Linux and Windows accordingly and can be edited if required.
|
|
|
+If you compile a program whose main module file is not directly in the `Programs` subdirectory, the compiled executable will be located next to it and not in the `bin` subdirectory.
|
|
|
|
|
|
-Since version 1.0.3, it is also possible to compile and run programs that consist of several modules. Put all modules into `Programs` directory, open the main module and press `F9`. If there is an error in one of the modules of your program, the corresponding file will open up and the error will be highlighted. To recompile, focus the main module window again and press `F9`.
|
|
|
-If module Graph is used, SDL2 library will be automatically linked to your program (script `Data/bin/link_graph.sh` (or `.bat`) will be used).
|
|
|
+If an error occurres during the compilation of one of the modules, the corresponding file will be open and error position and message will be indicated. To recompile, go to the main module window again and press `F9`.
|
|
|
+Если в программе используется модуль Graph, к ней будет автоматически прикомпонована библиотека Allegro5 (будет использован сценарий `Data/bin/link_graph.sh` (`.bat`) вместо `Data/bin/link_console.sh` (`.bat`).
|
|
|
+If module Graph is used in the program, Allegro5 will be automatically linked to it – `Data/bin/link_graph.sh` (`.bat`) will be used instead of `Data/bin/link_console.sh`.
|
|
|
|
|
|
-Since version 1.1.0 you can compile projects that are located in other directories.
|
Arthur Yefimov