Описание

CineWriter - это расширение для Apache OpenOffice Writer, которое предназначено для написания, редактирования и форматирования сценариев в американском формате. Кроме того с помощью дополнительных функций в CineWriter'e можно выполнять импорт и экспорт сценариев (форматы Софокл и Fountain), резервное копирование файла, автоформат, очистку, выделение жирным, нумерацию и хронометрию сцен и т.д.

CineWriter умеет работать с форматами текстовых файлов odt, doc и docx.

В русской версии CineWriter использует названия стилей популярного макроса для Microsoft Word ПИСАРЬ. Но при желании можно написать шаблон, который будет использовать другие названия стилей (см. раздел Локализация).

Расширение CineWriter распространяется по лицензии LGPL.


Инсталляция

Для установки расширения необходимо скачать пакет CineWriter и запустить его на выполнение. Пакет будет установлен в текстовый процессор Writer. Другой способ установки - запустить редактор Writer и открыть (CtrlO) в нем файл CineWriter.oxt.

Для обновления пакета перейдите в меню Сервис — Управление расширениями, кликните на строке CineWriter'a правой кнопкой мыши и в контекстном меню выберите Обновить... (N.B. Этот вариант обновления удобнее и проще, чем скачивать и переустанавливать пакет заново).

Для удаления (или отключения) пакета перейдите в меню Сервис — Управление расширениями, выберите строку CineWriter'a и кликните на кнопке Удалить (или Отключить).


Начало работы

После установки CineWriter'a в редакторе добавится новое меню CineWriter (между меню Сервис и Окно) и панель инструментов с кнопками форматирования Кнопки форматирования, статистики текста Статистика, нумерации сцен Нумерация и восстановления файла MS Word'а Восстановление doc-файла. (Они станут видны после перезапуска Writer'a).

(Так выглядят кнопки, если у Вас в ОО выбрана тема Галактика).

Панель инструментов можно передвинуть в удобное для Вас место и зафиксировать его позицию. Можно, например, сдвинуть меню вправо и убрать редко используемые кнопки Writer'a. (См. скриншот на сайте CineWriter'a).

Теперь нажмите F5 - слева появится боковое окошко Навигатора.

В Навигаторе будет отражен список заголовков сцен, т.е., абзацев, отформатированных стилем МЕСТО И ВРЕМЯ ДЕЙСТВИЯ. Это облегчает переход к нужной сцене и позволяет проще ориентироваться в сценарии. Для перехода к сцене сделайте двойной щелчок по ее строке. Чтобы закрыть окно Навигатора, снова нажмите F5.

(Вместо Навигатора можно использовать Боковое меню, которое появилось в 4-ой версии AOO).

В окне Навигатора нам нужны Заголовки. Чтобы убрать ненужные объекты навигации, нажмите кнопку Содержание в панели инструментов Навигатора. Если у вас не отображаются заголовки сцен, попробуйте выбрать в кнопке Показать заголовки до уровня в выпадающем меню цифру 1.

Теперь все готово к работе.


Форматирование

Для форматирования абзацев сценария используйте соответствующие кнопки, пункты меню или клавиатурные сокращения:

Сцена
Действие
Персонаж
Ремарка
Диалог
Ctrl1
Ctrl2
Tab или Ctrl3
Ctrl4
Ctrl5
(МЕСТО И ВРЕМЯ ДЕЙСТВИЯ)
(ОПИСАНИЕ ДЕЙСТВИЯ)
(ИМЯ ГЕРОЯ)
(РЕМАРКА)
(РЕПЛИКА ГЕРОЯ)

При наборе текста некоторые операции выполняются автоматически:

а. Если в начале строки ОПИСАНИЕ ДЕЙСТВИЯ начать набирать локацию, то при введении точки после инт, нат, int или ext, строка автоматически отформатируется в МЕСТО И ВРЕМЯ ДЕЙСТВИЯ. Еще проще после трехбуквенного обозначения локации вместо точки ввести пробел. В этом случае кроме форматирования в строку будут добавлены и точка и пробел.

б. Если в конце строки МЕСТО И ВРЕМЯ ДЕЙСТВИЯ нажать Enter, то автоматически будет добавлен дополнительный пустой абзац.

в. Если в начале строки ОПИСАНИЕ ДЕЙСТВИЯ нажать Tab, то абзац будет отформатирован в ИМЯ ГЕРОЯ. Но если курсор находится не в начале абзаца, то будет добавлена табуляция без форматирования. (При нажатии сочетания Ctrl3, абзац будет отформатирован в ИМЯ ГЕРОЯ в любом случае).

г. Нажатие Enter в строке с ИМЕНЕМ ГЕРОЯ добавляет новую строку и форматирует ее в РЕПЛИКУ.

д. Если набрать открывающую скобку, находясь в РЕПЛИКЕ, абзац будет отформатирован в РЕМАРКУ. Если курсор в это время находится в конце строки РЕПЛИКА, то будет добавлен новый абзац со скобками и отформатирован в РЕМАРКУ.

е. При нажатии Enter в конце реплики курсор добавляет ниже пустой абзац ОПИСАНИЕ ДЕЙСТВИЯ. Это поведение используется по умолчанию. В Настройках существует возможность выбора другого поведения программы - при первом нажатии Enter создается новый абзац ИМЯ ГЕРОЯ. Если после этого не вводить имя, а нажать Enter второй раз, то вместо ИМЕНИ ГЕРОЯ абзац будет отформатирован в ОПИСАНИЕ ДЕЙСТВИЯ.

Данное описание приведено скорее для справки, т.к. понять поведение программы намного проще на практике, чем в теории. Просто сделайте это.


Импорт и Экспорт

Импорт файла Софокла. Для импортирования сценария из Софокла следует сохранить сценарий в текстовом формате (В Софокле: Print / Preview (CtrlP) - Export... (CtrlF) - Тип файлов: Plain Text (*.txt)). После этого в Writer'e перейдите к пункту меню CineWriter - Импорт / Экспорт - Импорт файла Софокла. Откройте файл - тот самый, который Вы экспортировали из Софокла. (Не редактируйте этот файл в других текстовых редакторах!) Файл откроется и будет отформатирован в течение нескольких секунд.

Экспорт в Софокл. Если Вы захотите вернуть сценарий из Writer'a в Софокл, то Вам может пригодится эта функция. (меню CineWriter - Импорт / Экспорт - Экспорт в Софокл). Она создает текстовой файл, который может быть более или менее точно импортирован в Софокл. Правда, если Ваш сценарий побывал в жестоких руках редактора и(или) главного автора, то, вероятно, в него были внесены изменения и кое-где могло быть изменено стандартное форматирование (т.е. утрачены стили абзацев). Поэтому учитывайте, что чем больше изменений без использования стилей CineWriter'a было в сценарии произведено, тем менее точным будет экспорт в Софокл (это относится и к экспорту в Fountain). Качество экспорта может улучшить, предварительно использовав функции Автоформат и Очистка.

Поскольку эта функция приемлемо работает только для текстов на английском, то для текстов на русском необходимы дополнительные манипуляции. После экспорта в начала и концы строк будет добавлен символ "^" (на цифре 6 в англ.раскладке). Поэтому после импорта получившегося файла в Софокл, Вам нужно будет удалить этот символ, т.е. попросту заменить его на пустую строку (меню Edit - Replace... (CtrlH)).

Импорт файла Fountain. Формат Fountain - это простейшая разметка текстового файла, с помощью которой можно писать сценарии в текстовом формате и потом форматировать нужным образом.

Подробнее об этом формате можно прочитать (на английском) на сайте: https://fountain.io
Перевод Руководства на русский находится здесь: https://akawah.ru/cinewriter/fountain.html

Чтобы импортировать сценарий из Fountain'a, откройте его файл с помощью пункта меню CineWriter - Импорт / Экспорт - Импорт файла Fountain. В процессе открытия Вам будет предложено указать Кодировку и Разрыв абзаца открываемого файла. В зависимости от операционной системы, в которой был создан файл Fountain'a, Вам вероятнее всего нужно будет использовать следующие опции:

Windows
Mac OS X
Unix
Кириллица (Windows-1251) или Юникод (UTF-8)
Кириллица (Apple Macintosh)
Юникод (UTF-8)
CR & LF
CR
LF

После выбора опций и нажатия OK, файл Fountain'a будет отформатирован в Writer'e.

N.B. Если файл редактировался и сохранялся в разных OS и разных кодировках, то лучше заранее узнаеть его кодировку и формат окончания строки. Это можно сделать с помощью большинства текстовых редакторов, напр. под Windows AkelPad. В нем также можно изменить кодировку и формат окончания строки файла прямо в статусной строке.

Экспорт в Fountain. Для экспорта сценария в Fountain воспользуйтесь пунктом меню CineWriter - Импорт / Экспорт - Экспорт в Fountain. Как уже упоминалось, чем меньше в тексте участков, отформатированных нестандартными стилями, тем точнее будет экспорт. При этом должен предупредить, что при работе с Fountain'ом злоупотребление выделениями (жирным, курсивом, подчеркиванием), особенно если они сопрягаются и(или) пересекаются, также чревато ошибками экспорта.

Резервная копия. Создается копия файла с датой-временем в его имени. Формат остается таким же, как и исходный, но при желании файл можно сохранить в другом текстовом формате (doc, docx, odt, rtf и т.д.). Также можно изменить имя файла и его расположение.

Сохранить как txt-файл. Сценарий сохраняется в простом тестовом формате (без сохранения форматирования). В имя txt-файла по умолчанию добавляется дата-время. Т.е., Вы можете использовать эту функцию для резервного копирования сценария. Если дата-время не нужны - изменяйте имя файла на свое усмотрение.


Дополнительные функции

Автоформат. Эта функция пытается исправить различные ошибки форматирования и привести сценарий к стандартному виду. Следует учесть, что ошибок бывает много, разного характера, поэтому автоматически исправить их все невозможно. Перед использованием функции Автоформат поместите курсор в абзац ИМЯ ГЕРОЯ. Желательно выбрать наиболее характерные блоки ИМЯ ГЕРОЯ и следующие за ним РЕМАРКА и РЕПЛИКА ГЕРОЯ, поскольку макрос будет ориентироваться по ним для вычисления отступов. После этого выберите пункт меню CineWriter - Дополнительно - Автоформат.

С помощью функции Автоформат можно попытаться отформатировать любой текст, имеющий признаки американского формата сценария. Отформатированный сценарий будет открыт в новом окне.

Автоформат не очищает выделение цветом, жирным, курсивом и подчеркивание. Это на тот случай, если Вам нужно сохранить пометки в тексте. Чтобы очистить сценарий полностью, воспользуйтесь функцией Очистка.

Очистка.Удаляет все форматирование, кроме стандартного (шрифт, выделения жирным, цветом и т.д.) и устанавливает язык для всего документа - Русский.

В отличие от Автоформата, обрабатывает файлы с уже загруженным шаблоном CW. Т.е., если файл ранее не редактировался с использованием CineWriter'а, то сначала нужно попробовать воспользоваться функцией Автоформат или просто загрузить шаблон с помощью любой из функций форматирования (Ctrl1 .. Ctrl5)

Выделить заголовки сцен. Выделяет заголовки сцен жирным шрифтом.

Убрать выделение заголовков сцен.

Нумерация и длительность сцен. Позволяет добавить нумерацию сцен, с префиксом (напр., номер серии) или без него. Также можно добавить длительность сцен - в конец каждого абзаца МЕСТО И ВРЕМЯ ДЕЙСТВИЯ. (По умолчанию эта опция отключена). Чтобы очистить сценарий от нумерации и хронометража, воспользуйтесь кнопкой Очистить. Тот же результат получится, если нажать ОК когда поле префикс будет пустым и сняты галочки с нумерации и длительности.

Если нумерация и(или) длительность уже есть в сценарии, то не обязательно их удалять, при повторном использовании функции старые пометки будут удалены и сцены будут перенумерованы заново (и пересчитано время, если выбрана соответствующая опция).

N.B. Операция потенциально опасна, пользуйтесь ею с осторожностью.

Списки участников сцен. Добавляет списки участников сцен (персонажей, участвующих в конкретных сценах) - сразу под заголовками сцен в скобках.

Удалить списки участников сцен. N.B. Операция потенциально опасна, пользуйтесь ею с осторожностью. Она удаляет строки в скобках, находящиеся а абзаце сразу под абзацем МЕСТО И ВРЕМЯ ДЕЙСТВИЯ.

Титульная страница (шаблон). Создает титульную страницу сценария (по шаблону, как отдельный файл).


Настройки

В этом окне можно выбрать следующие настройки:

а. Шаблон по умолчанию.

При первом использовании CineWriter'a автоматически будет применен шаблон на основании настроек Writer'a - язык интерфейса и формат бумаги (A4 или Letter). Если подходящего шаблона нет, то будут использованы - язык английский и размер бумаги A4. (Как добавить новый шаблон - см. в разделе Локализация).

Вы можете выбрать другой шаблон, его параметры вступят в силу после переоткрытия Writer'a. Но эти настройки будут применятся только для новых файлов, старые останутся в прежнем формате. Если нужно перегнать их в новый формат, воспользуйтесь функцией Автоформат.

б. Поведение по умолчанию.

Меняет поведение программы в ситуации, когда курсор находится в конце абзаца РЕПЛИКА ГЕРОЯ. (См. раздел Форматирование, пункт е).

в. Путь к папке установки CineWriter'a.

Путь в вашей системе к каталогу, в который было установлено расширение. Просто чтобы знать, где лежат файлы CineWriter'a.


Файлы .doc и .docx

Файлы MS Word'a doc и docx не поддерживают (или поддерживают по-другому) некоторые возможности AOO Writer'a. Поэтому при их использовании могут возникнуть проблемы. Для устранения таких проблем после открытия файла doc или docx воспользуйтесь функцией Восстановление doc-файла в меню Импорт / Экспорт (или соответствующей кнопкой на панели).

После использования этой функции с файлом можно будет работать так же, как и с обычным файлом odt.

Существует возможность автоматического "ремонта" doc и docx файлов при их открытии. Чтобы это использовать, нужно зайти в меню Сервис - Настройка - закладка События, внизу окна в выпадающем меню Сохранить в выбрать пункт OpenOffice, после этого в списке событий выделить пункт Открытие файла и нажать кнопку Макрос... справа вверху. В открывшемся окне в Библиотека выбрать Мои макросы - CineWriter - Main, и справа Имя макроса - DocRepairAuto. Закрыть все окна нажатием OK. После этого файлы doc и docx будут восстанавливаться автоматически при их открытии.


Локализация

Возможны два варианта локализации CineWriter'a:

а. Минимальная. Для этого достаточно создать шаблон для Вашего языка по образцу шаблона cw_en_a4.ott.sample (находится в папке <CW_INSTALL>/Locale), переименовать его (напр., в cw_es_a4.ott - язык испанский, формат бумаги A4) и отредактировать для своего языка. Редактирование состоит в переименовании (переводе) названий стилей (если нужно) на свой язык. Также надо отредактировать пользовательские поля - меню Файл - Свойства - закладка Свойства пользователя.

В поле enc нужно вписать кодировку ANSI Windows для своего языка и символ разделителя (если символы Вашего языка отличаются от ASCII).

В поле locs - трехбуквенные обозначения локаций на Вашем языке. Они разделяются вертикальной чертой.

В поле styles - названия стилей для Вашего языка (если Вы их изменили).

Пришлите мне свой шаблон и я включу его в следующую версию программы.

б. Полная. Для этого кроме действий из пункта а, нужно перевести текстовые файлы из папки <CW_INSTALL>/Locale/en и прислать их мне для включения в программу. Также можно перевести файл Справки (вы его сейчас читаете) - <CW_INSTALL>/Help/en/cw_help.html.


Bugs

В своих сообщениях об ошибках при работе с программой обязательно указывайте ситуацию, в которой эта ошибка произошла. Также можно присылать скриншоты с сообщением программы об ошибке. Желательно также указать версию офисного пакета и Вашу операционную систему.


Ссылки

Сайт программы:
(ru) https://akawah.ru/cinewriter

Адрес форума на screenwriter.ru для обсуждений и вопросов о работе CineWriter'a:
(ru) http://forum.screenwriter.ru/showthread.php?p=443428


Форумы, где можно найти ответы и задать вопросы по OpenOffice:

(ru) Открытые офисные пакеты: http://forumooo.ru/index.php

(en, ru) The Apache OpenOffice Wiki: http://wiki.openoffice.org/wiki/Main_Page

(en) Apache OpenOffice community forum: http://forum.openoffice.org/en/forum/index.php

(en) The OpenOffice.org Forum: http://www.oooforum.org


Участники проекта

Программирование:
Тестирование:
Рисунок логотипа:
Перевод на английский:
Виктор Айсин
Константин Ленов
Ильгиз Сайфутдинов
Дмитрий Захаров