fullcircle-ru team mailing list archive

[Олег Кулик <helh-saintman@xxxxxxxxx>]

Моё почтение, уважаемые добровольцы!

Вот и увидел свет первый релиз программы для вычитки PDF.
Версия 0.1 далека от идеала, это понятно (на то она и 0.1). Но работать в ней уже можно. Как? А вот об этом напишу несколько слов.

Итак, сначала надо обзавестись самой программой. Думаю, инструкций из Документации для этого достаточно: http://fullcirclemagazine.ru/node/8658

Для чего прога вообще? С её помощью хотим избавиться от нудных "табличек" с баг-репортами в виде:

стр. 2, 1 колонка: "Скринеты" на "Скринлеты"
стр. 4, 4 колонка, "Запущенный в ноябре 2008-ого": "2008-ого" на "2008-го"
стр. 5, 4 колонка, "... то я не буду на нем останавливаться": "нем" на "нём"
стр. 5, 4 колонка, внизу, "... а если еще и перенаправить": "еще" на "ещё"
стр. 7, 1 колонка, врезка:"FCM#27-36 - Python Части 1 - 10" на "FCM#27–36 — Python Части 1–10"
стр. 7, 3 колонка, 3 абзац:"... (прогноз) - в другой.": "-" на "—" (длинное тире)
стр. 7, 4 колонка, 1 абзац:"... попробуйте город, страну -": "-" на "—" (длинное тире)
стр. 9, 1 колонка, 3 абзац:"... Далласе, Техас введите -l "Dallas, Texas".": "Далласе, Техас" на "Далласе (США, Техас)"
..
..

Это довольно утомительно. А если ещё приходится учитывать репорты других участников вычитки во избежание дублирования в отчётах... Кто ещё не делал финвычитку, тот может попробовать себе это представить. Тот, кто с этим уже знаком, сейчас улыбается, уверен ;)

"Ганнибал" призван избавить участников финвычитки от подобных изнурений. Идея его создания принадлежит уважаемому frio. Созданием программы занимается специально созданная команда. В этой команде я занимаюсь разработкой клиентской части (в идеале скоро будет серверная часть со всеми плюшками). Так как же мы избавимся от "табличек"?

1. Запускаем программу.
1.а Если вы впервые запустили программу, то она предложит ввести необходимые данные для идентификации. Достаточно ввести ваш аккаунт на Карфагене (http://fullcirclemagazine.ru). Email можно вообще не вводить, это задел на будущее и сейчас эта информации нигде не используется программой. ВАЖНО! Для подтверждения жмите "Закрыть".
2. Открываем нужный pdf-документ (какой именно — можно узнать из рассылки, когда объявляется начало финвычитки).
3. Приступаем к финвычитке (ищем опечатки и мелкие ошибки, косяки вёрстки и т.д.).
4. Найденную ошибочку обводим рамочкой с помощью "мышки" (зажатие левой кнопки — начало рамочки, отпускаем левую кнопочку — получаем рамочку).
5. Как только рамочка создана, вам будет предложено тут же ввести комментарий (заметку) в текстовом поле. Если вы передумали (или создали рамочку случайно), то просто нажмите <Esc>. Если введённый вами (если в поле был какой-то текст — замените его своим!) комментарий вас устраивает, то нажатие <Enter> создаст так званое "облако" — рамочку, к которой есть комментарий. ВНИМАНИЕ! Отнеситесь к созданию "облака" серйозно — однажды созданное облако удалить в данной версии программы нельзя!
6. Созданное облако попадает в список, который находится в правой панели (нажмите F9, если вы её не видите). Каждый рядок в списке имеет такой вид:

# Committer

# — номер страницы, на которой размещено облако
Committer — автор комментария (см. пункт 1.а)
7. У каждого облака есть статус. При создании каждое облако получает статус "New" и окрашивается соответствующим цветом. Этот же цвет является фоновым в списке облаков: рядок, связанный с облаком, окрашивается в тот же цвет что и само облако.
8. Изменить статус можно с помощью выпадающего списка — сразу под списком облаков.
Подробнее о статусах:

New
On discuss
On correction
Fixed and is on discuss
Fixed and closed
False

New — новое облако. Требуется внести поправки.
On discuss — ведётся обсуждение. Спорное замечание. Нет окончательного решения о его правильности. Используется в случае, когда автор или кто-либо другой сомневается в правильности заметки.
On correction — коррекция. Вносятся изменения в соответствии с заметкой. На практике будет использоваться крайне редко, ибо внесения изменений делаются довольно быстро и оперативно. Задел на будущее.
Fixed and is on discuss — исправлено и обсуждается. Исправлено, но есть сомнения о правильности заметки. Это скорее задел на будущее. Не рекомендуется использовать в данной версии.
Fixed and closed — исправлено. В идеале так должно быть с каждой заметкой.
False — он и в Африке False. Заметка однозначно неверная и не представляет особого интереса. Или служит сигналом для других, чтобы больше не рапортовали эту "заметку".

Самые "ходовые" статусы — New, Fixed and closed, False. Наличие остальных статусов — это ещё не повод для их использования.

9. Комментарии к облаку "живут" в текстовом поле сразу под выпадающим списком со статусами. К выделенному облаку можно добавлять комментарии в поле, которое размещено под текстовым полем с комментариями. Для добавления жмём "Добавить".

10. Для сохранения всех облаков (заметок) воспользуйтесь експортом (File->Export remarks...)
11. Для импорта (открытия) облаков (заметок) из файла воспользуйтесь импортом (File->Import remarks...)

ВНИМАНИЕ! Чаще сохраняйтесь! Автосохранения нет!
ВНИМАНИЕ! Убедитесь, что файл экспорта появился в папке с программой.
ВНИМАНИЕ! Программа не будет переспрашивать, если вы указали имеющийся файл для экспорта. Он будет перезаписан автоматически!
ВНИМАНИЕ! Перед выходом убедитесь, что экспортировали заметки! Программа беспрекословно закрывается без лишних слов!

И что теперь? Понимаю, много текста, но ИМХО это лучше чем "таблички":
Экспортируем, отсылаем в рассылку верстальщику. Верстальщик импортирует ваши заметки и вносит по ним поправки.
Как вы уже понимаете, экспорт-импорт позволяет сохранять и загружать заметки: есть возможность "сохраниться" и продолжить вычитку позже.

Пока финвычитка не началась, дружно осваиваемся с программой :)

Вопросы, замечания и _конструктивная_ критика принимаются в ответ на эту тему.
Всем спасибо за внимание!

P.S.: Облака, меньше чем 10х10 не отрисовываются. Для "ювелирной" работы есть масштабирование.

--
С уважением,
Олег «Eleidan» Кулик