Установка из архива

Архив релиза на GitHub: oxl-1.0.0-beta-linux-x86_64.tar.xz (рядом лежит файл с контрольными суммами SHA256SUMS).

curl -LO https://github.com/DesCaldnd/OxwaldLink/releases/download/v1.0.0-beta/oxl-1.0.0-beta-linux-x86_64.tar.xz
curl -LO https://github.com/DesCaldnd/OxwaldLink/releases/download/v1.0.0-beta/SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing          # oxl-1.0.0-beta-linux-x86_64.tar.xz: OK

sudo mkdir -p /opt && sudo tar -C /opt -xJf oxl-1.0.0-beta-linux-x86_64.tar.xz     # или в ~/opt без sudo
export PATH=/opt/oxl-1.0.0-beta/bin:$PATH
oxl --version

Чтобы PATH настраивался в каждой оболочке, добавьте строку export в ~/.bashrc или ~/.zshrc. Предварительно установите системные зависимости.

Что внутри#

oxl-1.0.0-beta/
  bin/oxl                    компилятор и все инструменты: build, run, test, dev, fmt, doc, lsp, dap, db, …
  bin/oxl-docs               сервер документации (написан на OxL, сайт встроен в бинарник)
  lib/oxl/                   исходники стандартной библиотеки (std/) и библиотеки рантайма (liboxlrt.a, заголовки)
  share/oxl/vscode/*.vsix    расширение для VS Code
  share/oxl/tree-sitter-oxl/ грамматика tree-sitter (Neovim, Helix, Zed, Emacs)
  share/oxl/lldb/            pretty-printers значений OxL для lldb
  share/oxl/examples/        примеры: hello, streams, bank-saga, shop, …
  share/doc/oxl/site/        документация: статический сайт (откройте index.html)

Если архив распакован в другое место, oxl находит стандартную библиотеку и рантайм рядом с собой. При нестандартной раскладке укажите их явно (OXL_STD_DIR, OXL_RUNTIME_LIB).

Документация#

Сайт, который вы читаете, лежит в архиве. Два способа его открыть:

xdg-open /opt/oxl-1.0.0-beta/share/doc/oxl/site/index.html    # статические файлы, поиск работает и по file://
oxl-docs --port 8080                                          # HTTP-сервер: http://127.0.0.1:8080/

oxl-docs — программа на OxL (std.web, файлы сайта встроены и сжаты): порт задаёт --port или OXL_DOCS_PORT, адрес — --host или OXL_DOCS_HOST (по умолчанию 0.0.0.0:8080); GET /healthz отвечает для проверок живости. Для публикации за обратным прокси достаточно проксировать на этот порт. PDF-версии (полная и по разделам, ru и en) — отдельные файлы oxl-<версия>-<язык>[-<раздел>].pdf на странице релиза.

Расширения для редакторов#

Файл share/oxl/vscode/oxl-lang-*.vsix ставится командой code --install-extension — подробности в VS Code. Грамматика tree-sitter и настройки других редакторов — в разделе IDE.

Обновление и удаление#

Каждая версия лежит в своём каталоге oxl-<версия>: чтобы обновиться, распакуйте новый архив рядом и переключите PATH (или symlink /opt/oxl). Удаление — rm -rf /opt/oxl-1.0.0-beta и строки PATH из профиля оболочки. Расширение VS Code: code --uninstall-extension oxwaldlink.oxl-lang. Кэш сборки и пакетов лежит в домашнем каталоге OxL ($OXL_HOME, иначе $XDG_CACHE_HOME/oxl или ~/.cache/oxl) — его можно удалить отдельно.