Запуск приложения, основные возможности
 
<span lang="ru">
ITEM:   Основная работа 
 
Создайте папку и поместите в нее графические файлы. Скрипт приложения album, 
как и какую-либо другую программу помещать в этот каталог не нужно. 
Надо просто запустить приложение album из любого места, просто указав папку 
с изображениями: 
 
<code>% album /example/path/to/images/ </code>
 
Или, если, к примеру вы находитесь в /example/path/to каталоге: 
 
<code>% album images/ </code>
 
Когда все это будет сделано, вы получите готовый фотоальбом внутри папки 
images/index.html. 
 
Если это путь на вашем web-сервере, то вы сможете увидеть созданную галерею 
в браузере, указав этот путь (в данном случае адрес). Если этого не произойдет - 
свяжитесь с системным администраторов сервера, на котором находится ваш ресурс. 
 
ITEM:   Опции 
Имеется три типа опций.  Булевы опции (они могут иметь только два значения), 
строковые и числовые опции и опции в форме массивов. Булевы опции могут выключены 
при помощи написания префикса -no_: 
 
<code>% album -no_image_pages </code>
 
Строковые или числовые значение опций указываются после строки самой опции: 
 
<code>% album -type gif </code>
<code>% album -columns 5 </code>
 
Множества опций могут быть заданы двумя способами, с одним аргументов за один раз: 
 
<code>% album -exif hi -exif there </code>
 
Или с несколькими аргументами с использованием формы '--': 
 
<code>% album --exif hi there -- </code>
 
Вы можете убрать указанные опции конструкцией -no_&lt;option&gt; 
и отчистить все множества опций конструкцией -clear_&lt;option&gt;. 
Для отчиски множества опций (например, чтобы отчистить конфигурации из 
предыдущего запуска приложения album), введите: 
 
<code>% album -clear_exif -exif "new exif" </code>
 
(здесь опция -clear_exif вычистит все предыдущие exif установки и затем 
следующая опция -exif добавит новый exif комментарий) 
 
И в итоге, вы можете удалить множество опции путем написание префикса 'no_', 
к примеру: 
 
<code>% album -no_exif hi </code>
 
здесь будет удалено 'hi' exif значение, а значение 'there' (к примеру) останется 
нетронутым. 
 
Посмотрите также раздел по <a href='Section_4.html#Saving_Options'>сохранению опций. </a>
 
Получить краткое пояснение по опциям можно командой: 
 
<code>% album -h </code>
 
Чтобы увидеть больше возможной введите: 
 
<code>% album -more </code>
 
А, чтобы получить еще больше введите: 
 
<code>% album -usage=2 </code>
 
Вы можете указать любое число больше, и получить тот же результат 
(к примеру написать 100) 
 
Дополнения (plugin) могут <a href="Section_7.html#Plugin_Options">иметь собственные опции</a>, со своим собственными 
особенностями использования. 
 
 
ITEM:   Темы 
 
Темы - это та часть галереи, которая делает альбом с фотографиями 
особенным и интригующим. Вы можете можете сами определять как 
будет выглядеть ваша галерея фотографий путем скачивания тем с ресурса 
MarginalHacks или даже путем написания ваших собственных так, чтобы 
они соответствовали стилевому оформлению вашего сайта. 
 
Для использования темы, загрузите файл архива темы .tar илиr .zip и 
распакуйте его. 
 
Темы находятся приложения посредством указания опции -theme_path, которая 
представляет собой место где помещены папки с темами.  В принципе, это 
место может быть где угодно на вашем компьютере или web-сервере, но только 
не внутри папки с фотографиями. 
 
Вы можете либо переместить тему по указанному в опции theme_paths пути 
для галереи, которая уже используется или создать новый путь, который 
тоже надо будет указать как аргумент все той же опции -theme_path. 
 (-theme_path может быть папкой внутри другой папки с темой, единственное 
требование только, чтобы это была собственно отдельная папка) 
 
Затем выполните приложение album с опцией -theme option, с указанием или без 
опции -theme_path: 
 
<code>% album -theme Dominatrix6 my_photos/ </code>
<code>% album -theme Dominatrix6 -theme_path /home/httpd/album/Themes/ my_photos/ </code>
 
 
Вы можете также создать ваши собственные темы очень легко, об этом будет рассказано 
в последующих разделах этой документации. 
 
ITEM:   Галереи более низких уровней. 
 
Если сделать папки внутри первой папки и поместить в них изображения то 
можно получить галереи второго уровня. Для этого просто надо запустить 
приложение album, указав папку верхнего уровня, после чего будет 
создана одна галерея, с входящим в нее галереями более низких уровней. 
 
Причем если вы только измените одну из галерей более низкого уровня, и затем 
снова запустите приложение album, проверит и обновит все ссылки на родительские 
галереи, и сгенерирует, при необходимости, все заново. 
 
Если же вы не хотите, чтобы приложение album создавало галереи более низких уровней, 
целесообразно указать глубину анализа, при помощи опции. Например, так: 
 
<code>% album images/ -depth 1 </code>
 
В этом случае будут генерироваться галереи только в папке images. 
 
Если же у вас много галерей низкого уровня, и вы хотите добавить новую галерею 
фотографий без генерации всех предыдущих галерей второго уровня, вы можете 
использовать опцию -add: 
 
<code>% album -add images/new_album/ </code>
 
В этом случае будет добавлено new_album к HTML в 'images/' и затем 
будут сгенерированы иконки и HTML для всего, что находится внутри 'images/new_album/' 
 
ITEM:   Повторная генерация иконок предпросмотра 
 
Приложение album спроектировано так, чтобы не делать лишней работы.  Он создает 
иконки предпросмотра только если они не существуют в данный момент или были изменены 
графические файлы прототипы. При таком подходе скорость существенно увеличивается, 
особенно при обработке больших объемов графических файлов. 
 
Правда, такой подход может стать причиной и проблем, если вы измените размер или 
вырежете что-то из изображение самих иконок предпросмотра, поскольку в приложении 
albom нет реализовано какое-либо действие, если вы меняете сами иконки предпросмотра 
Но, вы можете использовать опцию принудительно генерации иконок предпросмотра, если 
вы с ними все же что-то делали: 
 
<code>% album -force images/ </code>
 
Но, вам нет нужды использоваться -force все время, естественно. 
 
ITEM:   Удаление иконок предпросмотра 
 
Если вы хотите удалить изображения из вашей галереи, то вам так же надо будет 
удалить и иконки предпросмотра и откорректировать HTML файл. 
Вы может все это сделать при помощи всего одного запуска приложения album, 
с опцией -clean option: 
 
<code>% album -clean images/ </code>
 
ITEM:   Изображения среднего размера 
 
Когда вы нажимаете на изображение иконки предпросмотра вы попадаете 
на страницу с полноразмерным изображением. По умолчанию эта страница показывает 
изображение полного размера (примерно так же как кнопки навигации и т.п.). Естественно, 
если вы нажмете на изображение полного размера, то получите только его. 
 
Но, если вы хотите, чтобы после нажатия на иконку предпросмотра выводилось окно с 
уменьшенным изображением, можно использовать опцию -medium и указать геометрический размер этого изображения. Вы может указать любой размер, который сможет нормально интерпретировать утилита ImageMagick (для более полной информации - посмотрите инструкцию 
к этому пакету). К примеру: 
 
# Изображение, которое будет половину от полного размера 
<code>% album -medium 50% </code>
 
# Изображение, которое будет вписано в прямоугольник 640x480 (по наибольшей стороне) 
<code>% album -medium 640x480 </code>
 
# Изображение, которое будет уменьшено и вписано в прямоугольник 640x480 
# (но не увеличено, если оно меньше 640x480) 
<code>% album -medium '640x480&gt;' </code>
 
Вам необходимы 'кавычки' в последнем примере, т.к. большинство оболочек операционных систем трактует символ '&gt;' как элемент другой команды. 
 
ITEM:   Подписи под фотографиями 
 
Изображения и иконки предпросмотра часто имеют названия и разные поясняющие надписи. И есть много способов, чтобы указать или изменить названия или надписи под     изображениями в ваших галереях. 
 
<img src='../Pics/Caption.ru.gif' alt='caption example' align='left'>В качестве примера надписи может выступать название изображения, которое может быть 
ссылкой на страницу с полноразмерным изображением,  комментарий же может быть ниже: 

По умолчанию имя изображение это имя файла, без расширения. Например: 
  "Kodi_Cow.gif"  =&gt;  "Kodi Cow" 
 
Один из способов написать комментарий к изображению в галерее, использовать .txt файл, с 
тем же самым именем файла, что и изображение. Для примера, указанного выше, это может быть файл "Kodi_Cow.txt", который вполне может содержать "Kodi takes down a cow!" 
 
Вы можете переименовать ваши файлы с изображения и указать комментарии в отдельном файле, но для всех изображения сразу, расположим его в той же папке и назвав его captions.txt. 
 
Каждая линия этого файла должна быть именем изображения, расположенного в папке галереи или именем папки более низкого уровня, написанного в форме таблицы. 
Вы можете так же указать (отделяя при помощи знаков табуляции, т.е. клавиши TAB), дополнительные пояснительные надписи или альтернативные метки. (чтобы пропустить поле надписи просто используйте 'tab' 'space' 'tab') 
 
Вот примеры: 
 
001.gif	 Моя первая фотография 
002.gif	 Мама и папа Мои родители в горах 
003.gif	 Ani DiFranco	My fiancee	Yowsers! 
 
Все изображения в папке будут отсортированы в том порядке, в котором они указаны в файле с надписями. Вы может изменить этот порядок путем использования опций '-sort date' и '-sort name' 
 
Если ваш редактор не дает возможность использовать знаки табуляции (tabs) вы можете отделить поля при помощи двойного использования знака двоеточия, но только если пояснения к изображениям не будут содержать двоеточий и символов табуляции (tabs): 
 
003.gif :: Ani DiFranco :: My fiancee :: Yowsers! 
 
Если вы хотите только видеть пояснения на страницах с полноразмерными изображениями (не на главной странице галереи с иконками предпросмотра) используйте опцию: 
 
<code>% album -no_album_captions </code>
 
Если вы хотите иметь web доступ для создания/редактирования ваших пояснения, ознакомьтесь с файлом <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/caption_edit'>caption_edit.cgi</a> CGI скрипта (но не забудьте удостовериться, что доступ к этому файлу будет ограничен, чтобы кто угодно не смог внести  в него ненужные изменения или правки!) 
 
ITEM:   EXIF информация для комментариев в фотографиям 
 
Вы можете также сделать комментарии, которые основываются на EXIF данных 
(дословный перевод аббревиатуры EXIF - формат файлов, пригодный для обмена), 
которые формирует практически любой современный цифровой фотоаппарата. 
 
Чтобы осуществить это, вам нужно установить 'jhead' так, чтобы можно было его 
запустить и увидеть информацию о JPG файле. 
 
Комментарии, с EXIF информацией добавляются к обычным комментарием, после 
добавления опции -exif при запуске приложения album, например: 
 
<code>% album -exif "&lt;br&gt;File: %File name% taken with %Camera make%" </code>
 
Любой указанный %ярлык% будет замещен информация из EXIF. Если любой из %ярлыков% 
не будет найдет в EXIF информации, то строка EXIF комментария будет пропущена. 
Так же вы можете указать несколько строк для вывод EXIF информации, вот таким 
образом: 
 
<code>% album -exif "&lt;br&gt;File: %File name% " -exif "taken with %Camera make%" </code>
 
В этом случае, если поле данных 'камеры' не будет найдено вы можете получить 
комментарий с информацией из поля 'имя файла'. 
 
Подобно и другим опциям, чтобы добавить комментарий с EXIF информацией, можно 
использовать формат опции --exif, примерно так: 
 
<code>% album --exif "&lt;br&gt;File: %File name% " "taken with %Camera make%" -- </code>
 
Заметим, однако, что как и в случае, указанном выше вы можете включить HTML код 
в ваш ярлык поля EXIF: 
 
<code>% album -exif "&lt;br&gt;Aperture: %Aperture%" </code>
 
Чтобы увидеть все возможные EXIF поля (разрешение, дата/время, диафрагма и т.п.) 
можно запустить программу 'jhead' с интересующим файлом, как аргумент. Также 
для просмотра информации в полях EXIF можно использовать любую другую программу, 
которая выводит значения полей структуры EXIF. Обратите внимание, что значения 
полей надо писать на английском языке. 
 
Вы может также указывать EXIF комментарии только для страницы с иконками предпросмотра или страниц с полноразмерными изображениям. Для этого надо добавить 
необходимые опции при вызове приложения album:  -exif_album или -exif_image. 
 
ITEM:  Верхний и нижний колонтитулы на страницах 
 
В каждой папке с графическими файлами можно поместить текстовый файлы header.txt и footer.txt. При сборке альбома информация из них будет отражаться как верхний и нижний колонтитулы на странице с галереей, конечно, если используемая тема поддерживает эту возможность. 
 
ITEM:  Скрытие файлов и папок 
 
Любой тип файлов, который приложение album на опознает как графическое изображение 
будет проигнорирован. Чтобы включить возможность отражения на странице с галерей 
этих файлов, можно применить опцию -no_known_images.  (-known_images - установлено 
по умолчанию) 
 
Вы можете так же пометить изображения как не файл не изображения, путем создания 
пустого файла с тем же самым именем, что и изображение с графикой, но с 
расширением: .not_img . 
 
Таким же образом можно включить полное игнорирование, путем создания пустого 
файла с тем же самым названием и расширением: .hide_album . 
 
Если по каким-то причинам не хотите добавлять фотографии из какой-либо папки 
в общую галерею фотографий, аналогично подходу с отдельными 
файлами, можно добавить пустой файл  &lt;dir&gt;/.no_album. Где &lt;dir&gt; - название 
папки, которую не надо включать в общую галерею. 
 
Точно так же можно полностью игнорирвать создание галерей для отдельных 
папок, для этого создается пустой файл &lt;dir&gt;/.hide_album. Где &lt;dir&gt; - название 
папки, которую надо игнорировать. 
 
В Windows версиях приложения album нельзя создать файл, название которого 
начиналось бы с точки, поэтому используется те же названия но без точек. 
 
ITEM:  Обрезка изображений для создания иконок предпросмотра 
 
Если ваши изображение очень большие и имеют различные соотношение по ширины 
и высоте (к примеры, когда имеется много изображени форматов вертикальной и 
горизонтальной ориентации) или если ваша тема позволяет работать с изображениями 
только какой-то определенной ориентации, то вам может понадобиться сделать так, 
чтобы иконки предпросмотра все были подрезаны в одном стиле с одним и тем же 
соотношением ширины к высоте, то, для этого существует опция:. 
 
<code>% album -crop </code>
 
По умолчанию все изображения вырезаются по центру. Но если вас это не 
устраивает, то можно задать место откуда будет производится вырезка нужного 
фрагмента для создания иконок предпросмотра. Для этого надо слегка изменить 
названия изображений, так, чтобы при сборке галереи у приложения 
album была информация о том, с какого места надо вырезать изображение, 
для создания иконки предпросмотра. К примеру, у вас есть файл "Kodi.gif" c 
горизонтальной ориентацией, чтобы при создании иконки предпросмотра была 
вырезана верхняя часть из графического файла приведите название 
файла к виду "Kodi.CROPtop.gif"  (для удаления старых иконок предпросмотра 
не забудьте воспользоваться опцией -clean).   
Слово CROP будет убрано из название файла, когда он будет использоваться 
для создания HTML страницы. 
 
По умолчанию соотношение сторон иконок предпросмотра 133x133.  Т.е. для 
изображений с вертикальной ориентаций иконки будут создаваться как 133x100, 
а с для горизонтальной - 100x133. Если вы используете опцию для обрезки 
изображений и хотите, чтобы соотношения оставались те ми же самыми, 
используйте такую команду: 
 
<code>% album -crop -geometry 133x100 </code>
 
Но, помните, что если вы измените -crop или -geometry установки 
на ранее собранных галереях, вам потребуется указать опцию -force 
(один раз, естественно), чтобы вся галерея была собрана заново. 
 
ITEM:  Видео 
 
Приложение album может генерировать скриншоты с многих форматов видео, 
конечно, если вы установили пакет <a href='http://MarginalHacks.com/redir.cgi?ffmpeg.org/'>ffmpeg</a>.
 
Если вы работаете на linux-машине с процессором x86, то вы можете просто 
взять <a href='/bin/ffmpeg'>бинарные</a> файлы этого пакета с ресурса <a href='http://MarginalHacks.com/redir.cgi?ffmpeg.org/'>ffmpeg.org</a> (это проще установки). 
 
ITEM:  Запись на  CD (путем использования file://) 
 
Если вы используете приложение album для записи на CD ваших галерей через 
file://, то вам нет необходимости создавать "index.html".  Более того, если 
вы используете темы вам необходимы относительные пути. В данном случае 
вы не можете использоваться опцию -theme_url, поскольку не знаете где же будет 
конечный адрес вашей страницы.  На Windows-машинах путь к теме может быть 
похож на "C:/Themes" или на UNIX- или OSX-машинах он может быть 
похож на что-то типаe "/mnt/cd/Themes", все будет зависеть от точки 
монтирования привода CD. Чтобы решить все эти проблемы используйте 
опцию -burn: 
 
  % album -burn ... 
 
В результате должно получится, что пути к теме будут одни и те же. 
Очень удобно это сделать, если папки с темами разместить на 
верхнем уровне, как и папку с фотографиями галереи: 
 
  myISO/Photos/ 
  myISO/Themes/Blue 
 
Теперь можно запустить приложение album со следующими опциями: 
 
  % album -burn -theme myISO/Themes/Blue myISO/Photos 
 
Теперь можно записать образ CD из папки myISO папки (или из любой точки выше). 
 
Для Windows-пользователей можно также точно запустить и <a href='http://MarginalHacks.com/redir.cgi?www.squirrel.nl/people/jvromans/software/sw_shellrun.html'>оболочку</a>, 
например, автоматически запустить браузер для просмотра галереи (или посмотрите <a href='http://MarginalHacks.com/redir.cgi?duckware.com/winopen/'>winopen</a>)
 
ITEM:  Индексирование всей галереи 

Чтобы просматривать всю галерею под одной странице можно использовать опцию 
<a href='http://MarginalHacks.com/Hacks/album/tools/caption_index'>caption_index</a>. Он использует те же самые опции, что и приложение album 
в обычном режиме запуска (несмотря на то, что многие из них все же 
игнорируются). В результат получится HTML файл, с описанием всего, что 
есть в галерее. 
 
Для того, чтобы понять что это такое посмотрите примеры альбомов, <a href='http://DavePics.com/Examples/Blue_Index.html'>example index</a> на сайте 
 для <a href='http://DavePics.com/Examples/Blue.html'>галереи-примера</a>. 
 
ITEM:  Обновление галерей с использованием CGI 
 
Первое, что вам будет необходимо для работы с CGI - это возможность 
загрузки фотографий в папки ваших галерей. Обычно для этой цели 
везде принято использовать ftp. Хотя вы может написать java-скрипт, 
который загрузит файлы 
 
Затем вам необходимо будет удаленно запустить приложение album (т.е. 
запустить его на удаленной машине). Чтобы исключить возможные злоупотребления, 
обычно CGI скрипт ставится так, чтобы только касаться файла (или будет 
иметься доступ только по ftp) и затем будет выполнена работа по расписанию, 
которая проверяет файлы каждые несколько минут, и если обнаружит, что один 
из них был заменен, то запустит приложение album. 
[только для unix] (Вероятно вам необходимо будет установить значение 
переменной окружения $PATH или использоваться абсолютные пути в скрипте 
при конвертации) 
 
Если вы хотите мгновенного запуска приложения album, то для этого 
надо просто использовать скрипт именно для его запуска, например, <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/run_album'>one.</a>. 
 
Если фотографии не собственно пользователя web-сервера, то вам 
необходимо запустить setud-скрипт, который запустит вам приложение 
через CGI [только для unix]. Разместите setud-скрипт в безопасном месте, 
измените его владельца, на того же самого, что и владелец фотографий, 
затем запустить "chmod ug+s". Здесь имеются примеры 
<a href='http://MarginalHacks.com/Hacks/album/tools/cgi/run_setuid_album'>setuid</a> - и <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/setuid_album'>CGI</a> <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/setuid_album'>CGI</a>-скриптов. Просто подредактируйте их, как вам нужно. 
 
Также посмотрите <a href='http://MarginalHacks.com/Hacks/album/tools/cgi/caption_edit'>caption_edit.cgi</a> который позволит вам (или другим) 
удаленно (через web) редактировать captions/names/headers/footers 
 
 
ITEM: Переведено
Чубаровым И.Ю. (Tchubarov I, aka krolik, ceramic64@yandex.ru)
</span>

