\documentclass{article}
\usepackage{ulem}
\usepackage{graphicx}
\usepackage{hyperref}
\pagestyle{headings}
\begin{document}
\part{Ansel, the Horde Photo Application}
Ansel is a full featured photo management application, with support for multiple upload options, content embedding, tagging/geotagging, and multiple styles. For more information, or a more complete feature list, see <a href="http://horde.org/ansel">http://horde.org/ansel</a>.

This Is for Horde 4 and before. It does not comply to Horde 5 versions.

\section{Adding images to Ansel}
Ansel supports many upload options:

\subsubsection{Browser based upload}
\begin{itemize}
\item Upload single, multiple images, as well as compressed zip archives


\end{itemize}
\subsubsection{OS Specific upload methods}
\begin{itemize}
\item Windows XP Publish - Upload images directly to Ansel using Window XP's XP Publish feature. TODO: Need to add instructions for setting that up here.


\item Mac - There are image export plugins for both iPhoto ('08 and later), and Aperture (2.1 and later). The plugins' source code is available from our source code repository, and binary installers will be available via FTP soon.


\end{itemize}
\subsubsection{Command line tools on both server and client machines.}
\begin{itemize}
\item \textit{ansel/scripts/recursive\_import.php} - If you have images on the server box, and have command line access, you can use this script to add the images directly to Ansel.


\item For similar functionality to the recursive\_import script, there is the //ansel/scripts/remote\_import.php script that can be run from any client machine. There is even an applescript helper application, AnselPublish.scpt that lets you drag and drop a folder onto the script's icon to create a new gallery (named after the folder), and upload all images to the new gallery.


\end{itemize}
\section{Embedding Ansel content in external websites}
Ansel supports embedding it's content in external websites. For examples, see <a href="http://rubinskyfamily.com">http://rubinskyfamily.com</a> and <a href="http://mrubinsk.blogspot.com">http://mrubinsk.blogspot.com</a>.

\subsubsection{Examples}
\paragraph{A single image that links to an ansel gallery:}
The following will embed the key images (the image shown in the gallery thumbnail) from two different galleries and they will be styled as polaroid stacks. Each image will be linked to the gallery view for each gallery.

<pre><code>
<script src="http://domain.com/horde/ansel/xrequest.php?requestType=Embed/gallery\_view=GalleryLink/
gallery\_slug=gallery\_one:gallery\_two/container=example/thumbsize=prettythumb/style=ansel\_polaroid" type="text/javascript">
<div id="example"></div>
</code></pre>
In the above, the gallery\_slug parameter is a colon delimited list of gallery slugs. You could also use a colon delimited list of gallery ids by using the paremeter gallery\_id in place of gallery\_slug. The \textit{container} parameter is the dom id of the element where the content should be embedded. The parameter \textit{style} is a style name (from ansel/config/styles.php) to use.

\paragraph{A series of images from a single gallery:}
The following will embed 3 thumbnail images from the \textit{venice} gallery, starting at the second image in the gallery. It will be displayed in the gallery's style. The thumbnails will not be linked to anything.

<pre><code>
<script type="text/javascript" src="http://domain.com/horde/ansel/xrequest.php?
requestType=Embed/gallery\_slug=venice/container=anseldiv2/thumbsize=prettythumb/
start=2/count=3/hidelinks=true"></script><div id="anseldiv2"></div>
</code></pre>
\paragraph{A single, screen sized image}
This will embed a singe, screen sized image with no links.

<pre><code>
<script type="text/javascript" src="http://domain.com/horde/ansel/xrequest.php?requestType=Embed/
thumbsize=screen/images=7199/container=ansel4d83671f5c8dc8262f0db4c9aab6f20e/hidelinks=true">
<div id="ansel4d83671f5c8dc8262f0db4c9aab6f20e"></div>
</code></pre>
\paragraph{Arbitrary images from any number of galleries}
The following will embed 6 different images, each from a different gallery. Clicking on each image will open a lightbox overlay containing the selected picture, with navigation controls to view the rest of the embedded images on the page.

<pre><code>
<script src="http://domain.com/horde/ansel/xrequest.php?requestType=Embed/images=5122:1851:5153:2072:3049:4894/
container=multiple\_example/thumbsize=thumb/lightbox=true" type="text/javascript">
<div id="multiple\_example"></div>
</code></pre>
In addition to the main choices listed above, the following pairs can be added to the request's parameters

\begin{itemize}
\item thumbsize


\item style


\item start


\item count


\item perpage


\item hidelinks


\item lightbox


\end{itemize}
\section{Creating/Editing Ansel gallery styles (Ansel 1.x)}
\section{Hacking custom gallery views (Ansel 1.x)}
\end{document}
