home *** CD-ROM | disk | FTP | other *** search
/ Internet Magazine 2003 September / INTERNET107.ISO / pc / software / windows / building / gallery / readme.txt < prev   
Encoding:
Text File  |  2003-01-15  |  9.8 KB  |  244 lines
  1. CONTENTS
  2.   1. What is Gallery?
  3.   2. How do I install Gallery on Unix if I have shell access?
  4.   3. How do I install Gallery on Unix if I only have FTP access?
  5.   4. How do I install Gallery on Windows?
  6.   5. My webserver doesn't have NetPBM!  Help!  Aiee!
  7.   6. How do I customize Gallery?
  8.   7. How do I use Gallery as a PHP-Nuke 5.0/6.0 or Post-Nuke Module?
  9.   8. I can't upload large files!
  10.   9. Known problems
  11.  10. HELP!!  WHERE DO I GO FOR HELP?
  12.  
  13. 1. WHAT IS GALLERY?
  14.  
  15. Gallery is a web based photo album viewer/creator.  For the latest
  16. information, check out the web site:
  17.  
  18.     http://gallery.sourceforge.net/
  19.  
  20. 2. HOW DO I INSTALL GALLERY IF I HAVE SHELL ACCESS?
  21.  
  22. Installing and configuring Gallery is done via a set of web pages.
  23. To enable these web pages you need to log onto your web server using
  24. telnet or (preferably) ssh, go to the gallery directory and at the
  25. prompt (which usually ends in '%' or '$') type:
  26.  
  27.     sh configure.sh
  28.  
  29. Then go to the main Gallery URL and it will drop you into the
  30. configuration wizard.  This will walk you through the process of 
  31. configuring Gallery.  When you're done, type:
  32.  
  33.     sh secure.sh
  34.  
  35. And it will turn off the configuration application.  Gallery won't run
  36. if it is not in secure mode.
  37.  
  38. 3. HOW DO I INSTALL GALLERY IF I HAVE ONLY FTP ACCESS?
  39.  
  40. The process is pretty much the same as if you have shell access.
  41. The complicating factor is that you can't run the 'configure' and
  42. 'secure' shell scripts.  You'll have to simulate running the 
  43. scripts by using FTP commands.  
  44.  
  45. In order to FTP Gallery up to your web server you'll need to unpack it
  46. locally and then use FTP to copy it file at a time to the web server.
  47. The first time you configure it, you'll need to create two special
  48. files called "config.php" and ".htaccess" on the remote server.  The
  49. easiest way to do this is to create an empty file (we'll call it
  50. "empty-file") on your local machine.  Then upload that file as both
  51. "config.php" and ".htaccess" in your gallery directory using ftp.
  52. ONLY DO THIS THE FIRST TIME you install Gallery or you'll overwrite
  53. your existing config file!
  54.  
  55. YOU TYPE:
  56.     put empty-file config.php
  57.  
  58. YOU SEE:
  59.     local: empty-file remote: config.php
  60.     150 Opening BINARY mode data connection for 'config.php'.
  61.     226 Transfer complete.
  62.  
  63. YOU TYPE:
  64.     put empty-file .htaccess
  65.  
  66. YOU SEE:
  67.     local: empty-file remote: config.php
  68.     150 Opening BINARY mode data connection for '.htaccess'.
  69.     226 Transfer complete.
  70.  
  71. At this point, you need to make both of these files writable.  You
  72. can do this (in the gallery directory)
  73.  
  74.     chmod 777 .htaccess
  75.     chmod 777 config.php
  76.     chmod 755 setup
  77.  
  78. Now you're all set to configure gallery so go to the Gallery web
  79. page.  When you're done and it prompts you to make the gallery secure
  80. again, you need to change your permissions back again:
  81.  
  82.     chmod 644 config.php
  83.     chmod 644 .htaccess
  84.     chmod 0 setup
  85.  
  86. That's all it takes!  If you use CuteFTP or some other FTP program,
  87. you may need to hunt around a bit to find the CHMOD command.  In
  88. CuteFTP, right-click the file you would like to CHMOD, slect "Change
  89. File Attributes", then enter the mode manually (ie. 755) in the
  90. "Manual" text box.  If you can't figure it out, try asking your ISP or
  91. reading the documentation for your FTP client.
  92.  
  93. 4. HOW DO I INSTALL GALLERY ON WINDOWS?
  94.  
  95. Assuming, of course that you have Apache and PHP4 installed, installing
  96. and configuring Gallery on Windows is easy.  Start up a command prompt,
  97. go to the gallery directory and run the "configure.bat" script:
  98.  
  99.     c:\> cd gallery
  100.     c:\gallery> configure.bat
  101.  
  102. Then go to the main Gallery URL and it will drop you into the
  103. configuration wizard.  This will walk you through the process of 
  104. configuring Gallery.  When you're done, type:
  105.  
  106.     c:\gallery> secure.bat
  107.  
  108. And it will turn off the configuration application.  Gallery won't run
  109. unless it is in secure mode.
  110.  
  111. 5. MY WEBSERVER DOESN'T HAVE NETPBM!  HELP!  AIEE!
  112.  
  113. Many servers don't have NetPBM installed on them.  Or if they do, they
  114. have an old version.  Gallery has been tested with version 9.9 and up.
  115. Some older versions are missing a few critical components (like JPEG
  116. or PNG support).
  117.  
  118. To solve this problem, we're making statically compiled binaries of
  119. NetPBM available on the Gallery website.  I'd suggest that you first
  120. go through the Gallery config wizard and see if it complains about
  121. NetPBM.  If it complains, you can hunt around on your machine to see
  122. if NetPBM is installed (it's quite often found in /usr/bin,
  123. /usr/local/bin or /usr/local/netpbm) and provide that path to the
  124. Gallery config wizard.
  125.  
  126. If all that fails, you can download binary versions of NetPBM from the
  127. Gallery download page.  The binaries are compiled statically so they
  128. have no dependencies.  We don't yet have binaries for all systems, but
  129. we're working on it (in fact, if you have a system that isn't
  130. supported and would like to be of assistance, please contact us and
  131. we'll give you instructions on how to make what Gallery needs).
  132.  
  133. The FreeBSD binaries *should* work on most/all flavors of FreeBSD for
  134. intel, and the Linux-RedHat binaries *should* work on most/all flavors
  135. of Linux for intel. However, they haven't been tested extensively. If
  136. you find that they don't work please let us know and we'll compile a
  137. version for the specific software/hardware flavor that you're
  138. running. Download and install these binaries somewhere on your system
  139. (it's perfectly find to upload them via FTP to a virtual server) and
  140. then tell Gallery where to find them in the config wizard.
  141.  
  142. Don't forget to make these files executable!
  143.  
  144. 6. HOW DO I CUSTOMIZE GALLERY?
  145.  
  146. Documentation on this is a bit sketchy right now, sorry.  Online
  147. context-sensitive help is on the way.  But in the meantime, it'd
  148. be nice to change the way that Gallery looks and feels without
  149. having to hack PHP.
  150.  
  151. There are two main ways that you can customize Gallery.  First, you
  152. can change the theme by modifying its style sheets.  In the "css"
  153. directory is a file called "standalone_style.css.default".  Copy
  154. that to (in the "css" directory still) "standalone_style.css".  Tweak
  155. this file to your heart's content.  If you're running Gallery
  156. embedded inside Nuke, you'll want to tweak "embedded_style.css"
  157. instead.
  158.  
  159. The other way is to customize the gallery header and footers.  There
  160. are headers/footers for the main Gallery, for albums and for photos.
  161. In the "html_wrap" directory you can take any file that has ".default"
  162. and make a copy of it with the same name but without the ".default"
  163. at the end and modify it.  
  164.  
  165. If you come up with cool themes feel free to send them to me and I'll
  166. include them in the gallery package (or create a theme library of some
  167. kind).  
  168.  
  169. 7. HOW DO I USE GALLERY AS A PHP-NUKE 5.0+ / POST-NUKE MODULE?
  170.  
  171. It's very easy to make Gallery work with PHP-Nuke 5.0+ or Post-Nuke.
  172. All you have to do is either move your Gallery directory into the
  173. modules directory under Nuke, or create a symlink, ie:
  174.  
  175.     % cd nuke/modules
  176.     % ln -s /path/to/my/gallery gallery
  177.  
  178. If you move your gallery, be sure to run through the config wizard to
  179. make sure that all your paths are correct.
  180.  
  181. Now, you'll be able to get to your gallery directly via its new URL
  182. (ie, http://your.server.com/nuke/modules/gallery) or from your Nuke
  183. site (ie http://your.server.com/nuke/ -- then look for the "gallery"
  184. listing on the main menu).
  185.  
  186. NOTE:  If you want your module to be called something other than
  187. "gallery" (which especially occurs when you have multiple galleries
  188. on a single Nuke site) you can rename the directory or the symbolic 
  189. link.  Gallery will automatically detect the name change and Do The
  190. Right Thing.
  191.  
  192. 8. I CAN'T UPLOAD LARGE FILES!
  193.  
  194. PHP imposes a restriction on the size of a file upload.  This may get
  195. in the way of uploading large zip files.  To increase the limit, you
  196. can set the both the "upload_max_size" and "post_max_size" parameters
  197. in your system's php.ini to a large values (like "1000M" for 1000
  198. megabytes).  Gallery attempts to modify those values in the local
  199. .htaccess file, but not all servers are set up to pay attention to
  200. that file so you may have to do it by hand.
  201.  
  202. Even so, there is a limit to the size of a file that PHP can handle, 
  203. even if you remove this restriction.  Users have reported having issues
  204. uploading files greater than 20MB.  Your mileage may vary.
  205.  
  206.  
  207. 9. KNOWN PROBLEMS
  208.  
  209. * You may experience issues on Win32 if you're using the .DLL version
  210.   of PHP.  Users have reported that the NetPBM commands do not function
  211.   properly.  (thanks to Kwan Skinner)
  212.  
  213. * There are open bugs against every release of Gallery.  We try to
  214.   fix them as fast as we can.  You can find (and add to) the bug list at:
  215.  
  216.       http://sourceforge.net/tracker/?group_id=7130&atid=107130
  217.  
  218. 10. HELP!!  WHERE DO I GO FOR HELP?
  219.  
  220. We're here to help you.  We want you to get Gallery up and running.
  221. But do you know that Gallery has been installed on about 20,000
  222. websites?  Please stop and think for second about how much much email
  223. that generates before you fire off an email to us.  The Gallery
  224. authors are just a couple of working joes with day jobs, we can't
  225. handle the kind of email volume that Gallery generates.  Instead of
  226. emailing us directly, please use the help resources available on
  227. the web:
  228.  
  229.     http://gallery.sourceforge.net/help.php
  230.  
  231. We respond to each and every request for help when we get a chance.
  232. There are very few problems that we have not been able to work
  233. through.  We *will* get you up and running.  But, remember that every
  234. email we respond to robs us of time that we could be spending
  235. improving the quality of Gallery and adding new features.
  236.  
  237. Speaking of quality and features, if you find a bug or want to suggest
  238. a feature, you can do that here:
  239.  
  240.     http://gallery.sourceforge.net/features_and_bugs.php
  241.  
  242. It's a good idea to check through these databases to see if the
  243. bug/feature that you're referring to is already in there.
  244.