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

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

[[https://github.com/Vostok-space/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-пакет ====
	/usr/bin/sudo npm install --global odcey


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

Для вывода содержимого документа достаточно передать полное имя интересующего файла после команды 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