Odcey — преобразователь odc в плоский текст [Оберон / Компонентный Паскаль / Вики]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.

====== Odcey — преобразователь odc в плоский текст ======

.odc - родной для [[:blackbox|BlackBox]] двоичный формат для предcтавления насыщенного текста. Утилита позволяет преобразовать его в обычный utf8-текст, что удобно для работы с форматом вне IDE, особенно, в связке с инструментами для сравнения текстов, в том числе, с git.

[[https://github.com/Vostok-space/odcey]]

===== Установка =====

==== Ветвь Debian GNU/Linux ====
После добавления [[:repo|репозитория]]:
	/usr/bin/sudo apt install odcey

==== macOS и Linux Homebrew-пакет ====
	brew tap vostok-space/oberon # установка хранилища
	brew install odcey

==== Linux snap-пакет ====
В Ubuntu достаточно ввести
	/usr/bin/sudo snap install odcey

Для других дистрибутивов лучше ознакомиться со [[https://snapcraft.io/odcey|страницей]] snap-пакета

==== NPM-пакет (Windows,Linux,macOS,...) ====
	/usr/bin/sudo npm install --global odcey

Из-за ограничений доступа при этом способе установки не работает команда <code>odcey git</code>

==== Windows exe-файл ====
[[https://github.com/Vostok-space/odcey/releases/download/v0.3/odcey.exe|odcey.exe]] для 64-битной
или
[[https://github.com/Vostok-space/odcey/releases/download/v0.3/odcey_i386.exe|odcey_i386.exe]] для 32-битной системы, подходит также для 64-битной версии.

Установить можно, например, такими командами powershell:
  $edir = "$env:USERPROFILE\Executables"; mkdir "$edir"
  Invoke-WebRequest -Uri https://github.com/Vostok-space/odcey/releases/download/v0.3/odcey.exe -OutFile "$edir\odcey.exe"
  [Environment]::SetEnvironmentVariable('PATH', "$env:PATH;$edir", 'User')
  
==== Сборка с нуля вместе с транслятором в POSIX ====
  gcl () { git clone https://github.com/Vostok-space/$1.git --depth 1; } &&
  gcl vostok && gcl odcey &&
  
  cd vostok && ./init.sh &&
  result/bs-ost run 'make.Build; make.Self' -infr . -m source &&
  
  result/ost to-bin odcey.Cli result/odcey -infr . -cc 'cc -O -s' -m ../odcey &&
  result/odcey help

===== Использование =====

Для вывода содержимого документа достаточно передать полное имя интересующего файла после команды text:
	odcey text path/to/document.odc

Чтобы позволить git выводить изменения в файлах .odc так же, как он это делает для обычных текстовых файлов, в каталоге git-репозитория нужно выполнить команду
	odcey git

Что аналогично выполнению команд:
	echo '*.odc diff=cp' >> .git/info/attributes
	git config diff.cp.binary   true
	git config diff.cp.textconv 'odcey text <'

Справку можно получить командой help
	odcey help

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

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

Инструменты страницы