Common Kit
FREE/LINE/PLUS

собственные приложения
для iPhone без программирования


Мануал
V1.3



Управление в демонстрационном режиме:
- щелчок 1 пальцем переворачивает
  страницу с вопроса на ответ и наоборот;
- горизонтальное касание 1 пальцем
  листает страницу;
- горизонтальное касание 2 пальцами
  быстро листает страницы;
- вертикальное касание 1 пальцем
  прокручивает текст;
- вертикальное касание 2 пальцами (на
  левой стороне экрана) меняет
  прозрачность картинки или (на правой
  стороне экрана) текста;
- касание 3 пальцами меняет цвет фона и
  теней текста;
- касание 4 пальцами меняет цвет текста;
- двойной щелчок 1 пальцем временно
  показывает картинку, текст, номер
  страницы, и приостанавливает /
  возобновляет воспроизведение звука;
- тройной щелчок 1 пальцем начинает
  последнее воспроизведение звука заново;
- щелчок двумя пальцами или нажатие
  i-кнопки вызывает внешнюю интернет
  ссылку и панель установок;
- p-кнопка показывает колесико для быстрого
  выбора проекта, запускает выбранный проект;
- встряхивание переключает режимы
  случайного перелистывания (@) и
  воспроизведения без остановки ($).



Этот универсальный инструмент позволяет любому пользователю iPhone безо всякого программирования создавать собственные интерактивные книги, тестовые карточки, вопросники, загадки, аудиовизуальные учебные пособия, бизнес презентации, фотоальбомы, альбомы живописи и музыки и т.п., т.е. любые Ваши интерактивные аудиовизуальные коллекции, базы знаний и медиа базы данных для развлечения, образования или бизнеса.

Каждый из Вас имеет уникальный опыт, знания и вкус! Создайте Ваши проекты и выставьте их на Вашем сайте для себя и своих друзей.

Вы легко и быстро можете сделать это в режиме редактирования на Вашем компьютере и затем использовать в демонстрационном режиме на Вашем iPhone/iPod/iPad с WiFi/интернетом или даже без него. 

Как это сделать? Просто посмотрите прямо в этой программе мой мануал и другие экземпляры из моей коллекции на http://barixa.net/kit (нажмите i-button).




Любые наши знания можно разбить на базовые понятия размером с карточку и обычно можно сформулировать как двойную информацию (вопрос/ответ или понятие/пояснение). Поэтому каждая страница Вашего альбома имеет две стороны, и каждая сторона может включать любой текст, картинку, звук и внешнюю ссылку, для того, чтобы полностью видеть, слышать и понимать эту информацию. Вы должны только вставить необходимые данные, а этот Common Kit сделает все остальное автоматически.


Просто выполните следующие шаги:

1. запустите Web сервер на Вашем компе;

2. создайте директорию для Вашего проекта;


3. добавьте конфигурационный файл;


4. добавьте фоновую картинку;


5. добавьте картинки, тексты, звуки и ссылки

    для каждой стороны каждой страницы;

6. укажите iPhone путь к Вашему проекту

    и настройте Ваш проект, повторяя шаги 3-5;

7. если нужно, загрузите проект прямо в iPhone.



1. 
запустите Web сервер на Вашем компе
2. 
создайте директорию для Вашего проекта

Вы можете использовать любой Web сервер  или сайт в Интернете (конечно, если Вы имеете к нему доступ), но лучше для быстрой и удобной разработки Ваших проектов использовать локальный Web сервер прямо на Вашем компьютере. Например, при работе на Windows XP Вы можете использовать WWW Service на встроенном Internet Information Services (IIS).

Если у Вас MAC, то просто идите в "System Preferences", "Sharing", и установите флажок для "Web Sharing" (смотри картинку ниже). Тогда интернет адрес http://<IP address> на правой стороне этой панели укажет Вам URL Вашего локального Web сервера в Вашей локальной сети, причем корневой каталог этого сервера  будет находиться в директории "Library / WebServer / Documents" Вашего компьютера.

Например, если Вы хотите создать проект с именем "myProject", то я рекомендую просто создать в этой корневой директории поддиректорию "kit/myProject" для Ваших будущих разработок.

Нажмите i-button для более подробных пояснений.




3. добавьте конфигурационный файл


Не обязательный конфигурационный файл с фиксированным именем "ckit.cfg" определяет несколько стартовых величин, используемых в дальнейшем по умолчанию в Вашем проекте. Например, этот мануал (в виде проекта Common Kit) имеет следующий конфигурационный файл:
--------------------------
10,Arial,
jpg,txt,m4a,url,
0.05,0.26,0.82,1.00,
1.00,0.95,0.34,1.00,
#end
--------------------------

Что означает:

"10" - максимальный номер страницы в этом проекте (по умолчанию было бы 999),
"Arial" - шрифт, используемый по умолчанию,
"jpg" - расширение (и формат) файлов картинок,
"txt" - расширение файлов текста,
"m4a" - расширение (и формат) файлов звука,
"url" - расширение файлов ссылок,
"0.05,0.26,0.82,1.00" - цвет фона и теней текста,
"1.00,0.95,0.34,1.00" - цвет текста.



Цвета заданы в формате HSBA (Hue, Saturation, Brightness, Alpha). Common Kit использует эти новые цвета из конфигурационного файла при загрузке нового проекта, если цвета в предыдущем проекте были тоже цветами по умолчанию (даже если они в предыдущем проекте были другими). Однако, если Вы  уже изменяли цвета вручную (управлением пальцами), эти старые цвета все еще будут использоваться пока Вы не нажмете кнопку "Restore original screen colors" в панели установок Settings (смотри картинку ниже).




Если конфигурационный файл отсутствует, то Common Kit будет использовать глобальные установки по умолчанию (те же что и в данном проекте за исключением максимального номера страницы, который будет 999).

Вы можете использовать другие расширения (особенно для картинок и звуков) чтобы использовать другие форматы файлов, поддерживаемые iPhone OS, но в любом случае Ваш проект должен использовать только те типы файлов, которые явно указаны в конфигурационном файле.



4. добавьте фоновую картинку


Не обязательная фоновая картинка  - это файл с фиксированным именем "bgnd.png". Например, этот мануал использует в качестве фона фотографию моего лабрадора Бари. Этот файл всегда должен быть в формате PNG, потому что он должен включать в себя информацию Альфа канала (данные прозрачности).

Вы можете использовать любую собственную картинку, сконвертировав ее для фона. Я рекомендую использовать замечательный и бесплатный софт GIMP (нажмите i-button, чтобы перейти на их сайт). Откройте любую Вашу картинку в GIMP и добавьте Альфа канал (Layer / Transparency / Add Alpha Channel). После чего Вы можете настроить прозрачность (Colors / Levels) путем установки Output Levels для Alpha Channel и сохранить файл как PNG с именем "bgnd.png".

Имейте в виду, что в отличие от картинок переднего плана, Вы не можете настраивать прозрачность фоновой картинки на ходу путем управления пальцами в демо режиме.



5. 
добавьте картинки, тексты, звуки и ссылки
    для каждой стороны каждой страницы


Любые файлы Вашего проекта не являются обязательными и имеют фиксированные имена , формируемые по следующим правилам:

1. первый символ указывает на сторону
    страницы: "q" (Question, "вопрос", передняя
    сторона страницы) и "a" (Answer, "ответ",
    обратная сторона страницы);

2. номер страницы из трех цифр от "000"
    (титульная страница
) до "999"
    (максимальная страница по умолчанию
);

3. соответствующее расширение файла из
    конфигурационного файла или по
    умолчанию
("jpg" - картинка, "txt" - текст,
    "m4a" - звук,
и "url" - ссылка на внешний URL).

Например, "q000.txt" - это текст на титульной странице 0, "a002.jpg" - картинка на обратной стороне страницы 2, "q000.m4a" - звук для титульной страницы 0 (в проекте звучит Моцарт, Маленькая ночная серенада), и "a002.url" - внешняя ссылка на обратной стороне страницы 2.


5.1 добавьте картинку переднего плана


Не обязательная картинка переднего плана -- это файл с фиксированным именем для соответствующей стороны соответствующей страницы и фиксированным расширением из конфигурационного файла или расширением по умолчанию. Например, "a002.jpg" - это картинка в формате JPG на обратной стороне (Answer side) страницы номер 2.

Вы можете использовать любую собственную картинку, сконвертировав ее в соответствующий формат. По умолчанию используется формат JPG, потому что он обычно обеспечивает минимальный размер файла и сетевой трафик. 
Я рекомендую использовать замечательный и бесплатный софт GIMP (нажмите i-button, чтобы перейти на их сайт) для обработки и конвертации Ваших картинок.

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



Текущая версия Common Kit не поддерживает масштабирование картинок на ходу и просто помещает подготовленную картинку "как есть" в центр экрана. Поэтому Вы должны тщательно подготовить картинку заранее. Обычно это предполагает ее кадрирование (Tools / Transform Tools / Crop) и масштабирование (Image / Scale Image).


Кадрирование позволяет вырезать необходимую часть Вашей исходной картинки. Если Вы предполагаете использовать картинку на весь экран iPhone (320 x 480), то Вам нужно при кадрировании просто сохранить соответствующее соотношение сторон (2/3).

Затем полученное изображение следует привести к размеру экрана iPhone (320 x 480) путем масштабирования. Неплохо также оставить небольшую кромку в качестве рамки. Если Ваша картинка не соотносима с экраном, то Вам следует по крайней мере смасштабировать ее пропорционально и подогнать по вертикали или горизонтали к размеру экрана. Кроме того, можно получить интересные эффекты путем создания зон прозрачности и наложения их на фоновую картинку и текст. Пробуйте!



5.2 добавьте текст переднего плана


Не обязательный текст переднего плана -- это файл с фиксированным именем для соответствующей стороны соответствующей страницы и фиксированным расширением из конфигурационного файла или расширением по умолчанию. Например, "q000.txt" - это текст в универсальном формате Юникод (UTF-8) на передней стороне (Question side) титульной страницы с номером 0.

Вы можете использовать любой текстовый редактор (например, TextEdit на MAC), чтобы приготовить текст, который будет покрывать фон и картинку переднего плана. По умолчанию этот текст будет использовать выравнивание по центру, шрифт и цвета текста и теней из конфигурационного файла (или глобальных установок).

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


По умолчанию Common Kit автоматически вычисляет размер шрифта так, чтобы покрыть Вашим текстом весь экран. Поэтому Вы всегда можете получить необходимый размер шрифта и размещение текста на экране iPhone путем вставки нескольких дополнительных пробелов или символов возврата каретки.


Кроме того Вы можете:

1. изменить выравнивание для данной страницы
    с помощью специального первого символа

    ("<" для выравнивания влево или
    
">" для выравнивания вправо);

2. установить необходимое имя и размер шрифта
    для данной страницы вставкой в начало текста
    имени и размера нужного шрифта в квадратных
    скобках 
"[font_name, font_size]" (к сожалению,
    это выполняется не для всех шрифтов
).

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

Например, текст этой страницы начинается со следующей  управляющей последовательности
"<[Times New Roman,17] . . ."


Также Вы всегда можете с помощью касания 3 и 4 пальцами на ходу изменить цвета текста и теней, чтобы дополнительно выделить текст на фоне картинки. Пробуйте!


5.3 добавьте звук


Не обязательный звук -- это файл с фиксированным именем для соответствующей стороны соответствующей страницы и фиксированным расширением из конфигурационного файла или расширением по умолчанию. Например, "q000.m4a" - это звук в формате M4A для передней стороны (Question side) титульной страницы с номером 0.

Вы можете использовать любую звуковой файл, сконвертировав его в соответствующий формат. По умолчанию используется формат M4A, потому что он обычно обеспечивает минимальный размер файла и сетевой трафик. Я рекомендую использовать замечательный и бесплатный софт Audacity (нажмите i-button, чтобы перейти на их сайт) для обработки и конвертации Ваших звуков.

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



Для приемлемого качества звука (обычно для голосовых комментариев) Вы можете использовать моно звучание в формате M4A с частотой сэмплирования 16000 Гц. Например, для записи голосовых комментариев для соответствующей страницы Вы можете использовать стандартное приложение Диктофон. После чего загрузите Ваши комментарии (Voice Memo) в компьютер и откройте эти файлы в Audacity.


1. Измените в левом нижнем углу
    Project Rate к 16000 Гц;


2. Сконвертируйте стерео в моно (Tracks /
    Stereo Track to Mono);

3. При необходимости нормализуйте звук
    (Effects /
Normalize) и используйте другие
    способы обработки звука
(например,
    Fade In/Out, и т.п.);

4. Экспортруйте звук в формат "M4A (ACC)
    Files (FFmpeg)" в файл с соответствующим
    именем
(например, "a007.m4a" для этой
    страницы)




5.4 добавьте внешнюю ссылку


Не обязательная внешняя ссылка -- это файл с фиксированным именем для соответствующей стороны соответствующей страницы и фиксированным расширением из конфигурационного файла или расширением по умолчанию. Например, "a002.url" - это внешняя ссылка для обратной стороны (Answer side) страницы с номером 2.

В действительности внешняя ссылка - это просто текст в формате Юникод (
UTF-8), указывающий на соответствующий URL, т.е. ссылка типа "http://..." Вы можете использовать любой текстовый редактор (например, TextEdit на MAC), чтобы подготовить такую ссылку, которая будет вызвана при нажатии на кнопку i-button на этой странице. По умолчанию (если такой ссылки нет) Common Kit вызывает собственную страницу (http://barixa.net/ckit.html).

Имейте в виду, что точно также Вы можете вызвать и любую собственную Web страницу на Вашем Web сервере, где Вы можете разместить любую дополнительную информацию (включая другие Ваши собственные или внешние Web ссылки, информацию Wikipedia, видео YouTube, и т.п.), т.е. любые необходимые ресурсы Интернета.


Наконец, помните, что нажав на кнопку i-button, Вы всегда просто вызываете встроенный Web браузер, который можете использовать и вне зависимости от этой предписанной внешней ссылки. Просто нажмите справа на верхней панели кнопку "goGoogle" (значок "лупы", смотри картинку) и Вы сможете найти любые другие необходимые интернет ресурсы по Вашему запросу.




Также Вы можете использовать кнопку "Назад" ("goBack", значок слева от "лупы"), для того чтобы вернутся при необходимости к предыдущей Web странице. Чтобы закончить прогулки по Интернету и вернуться к Вашей интерактивной книжке, просто нажмите кнопку "Done" ("Готово").

Пробуйте на здоровье!


6. 
укажите iPhone путь к Вашему проекту

При первом запуске Common Kit использует как исходный ресурс (Source URL) путь к этому мануалу (который также является просто примером проекта): "barixa.net/kit/manual".




Чтобы использовать Ваш проект, просто нажмите кнопку установок ("Settings") и измените путь на URL Вашего проекта. Например, если Ваш компьютер с Вашим Web сервером имеет IP адрес "192.168.1.60", Вы можете скорректировать URL так, как показано на картинке (префикс "http://" можно опустить).









После
нажатия
"Done", Ваш
Common Kit
будет
автоматически
стартовать этот новый
проект
, т.е. использовать
Ваши данные из директории
"kit/myProject" Вашего Web сервера.
Вам нужно просто смотреть результат,
тестировать Ваш проект страницу за страницей, и корректировать Ваши данные, если необходимо. Конечно, в первый раз Вы потратите довольно много времени (особенно на редактирование и выравнивание текста, вставку дополнительных пробелов и возвратов каретки, и подгонку картинок к тексту), но все же это креативная работа дизайнера, а не тяжкий труд программиста. Расслабьтесь и получите удовольствие!



7. загрузите проект прямо в iPhone
(LINE версия не поддерживает такую загрузку)

Итак, этот мануал является также одним из примеров проекта и содержит как раз 11 страниц, т.е. Вы можете прочитать его прямо из сети on-line или можете загрузить в Ваш iPhone, чтобы потом использовать без сети off-line (даже во FREE версии). Поэтому неплохо начать как раз с загрузки этого мануала.


1. Перед загрузкой любой проект должен быть
    сначала запущен из сети
on-line;

2. Затем нажмите кнопку i-button и потом на
    верхней панели кнопку загрузки ("папка со
    стрелкой" справа от кнопки "Settings"
),
    которая должна быть активной;

3. После копирования ("Copying...") нажмите
    кнопку установок ("Settings") и выключите
    переключатель
"Source URL".

После нажатия "Done", Common Kit будет автоматически стартовать этот уже загруженный проект. Теперь (в зависимости от состояния переключателя "Source URL") Вы можете использовать либо этот загруженный проект (даже без WiFi и Интерента), либо любой сетевой on-line проект, путь к которому указан в Source URL.


В моей общедоступной коллекции (barixa.net/kit) Вы можете найти некоторые уже готовые примеры проектов, которые также можно найти как отдельные приложения в AppStore:


- manual, This Quick Start Guide
  (11 pages);
- music, The Best Classical Music
  (102 pages);
- zagadki, Загадки, Russian folklore riddles for Kids
  (151 pages);
- prikoly, Приколы, Russian folklore riddles for Adult
  (61 pages).

Я могу рекомендовать использовать эти примеры как образцы для старта Ваших собственных проектов. Просто скопируйте ZIP архивы этих проектов на Ваш локальный Web сервер и попробуйте сначала запустить их, а потом уже корректировать эти файлы под Ваши коллекции.

После создания Ваших собственных коллекций (и если Вы хотели бы сделать их общедоступными), Вы можете послать их мне как ZIP архив, чтобы я мог добавить их к этой коллекции.

Ваш АК