====== 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.2/odcey.exe|odcey.exe]] для 64-битной
или
[[https://github.com/Vostok-space/odcey/releases/download/v0.2/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.2/odcey.exe -OutFile "$edir\odcey.exe"
  [Environment]::SetEnvironmentVariable('PATH', "$env:PATH;$edir", 'User')
===== Использование =====

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

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

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

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