编辑“Gallery Remote:常见问题”

==如何安装GR？==
:1. 从[http://gallery.menalto.com/wiki/Gallery_Remote Gallery Remote下载页面]下载最新版本。
:2. 在Windows中，双击下载下来的文件即可。对其他的操作系统来说，请遵照给出的指导。

==如何升级GR？==
# 从[http://www.gallery2.hu/ nightly站点]为Gallery Remote下载[http://www.gallery2.hu/download/GalleryRemote/current_gallery_remote.zip 最新的补丁压缩包]。''这些为非官方的nightly版本。''
# 在继续之前确保你退出了GR。
# 将下载下来的压缩包文件解压到GR中（你需要事先安装完整版本的Gallery Remote）并覆盖已存在的所有文件。
# 重启Gallery Remote。

==G2中如何升级GR小程序？==

# 从[http://www.gallery2.hu/ nightly站点]为Gallery Remote小程序下载[http://www.gallery2.hu/download/GalleryRemote/current_gallery_remote_applets.zip 最新的小程序补丁压缩包]。''这些为非官方的nightly版本。''
# 在你的Gallery2服务商将压缩包解压到以下两个位置：	
#*  <code><i>gallery2</i>/modules/uploadapplet/applets</code>
#*  <code><i>gallery2</i>/modules/slideshowapplet/applets</code>
# 你需要清除Java小程序的缓存：重启浏览器或在Java控制台中点击<code>C X</code>
# 重新载入小程序

==发现了一个bug该怎么办？==
# 在Gallery Remote中报告bug之前：
## 确认你在Gallery Remote中尝试进行的操作可以使用web界面完成。
## 许多报告的GR bug实际上是安装问题，这些问题甚至并没有牵涉到GR时仍对Gallery造成影响。
## 这些可包括不正确的上传权限和PHP设定等。
# 对于任何bug报告，你应当提供以下信息：
## 试图与其进行互动的Gallery版本。
## Gallery Remote的版本，以及供Gallery Remote运行用的虚拟机和操作系统。
## 如果bug是Gallery Remote不按常理运作的话：它没有使你登录，图片无法正确上传，你得到奇怪的错误消息，请在bug报告中附带相应的错误日志或该日志的一部分。

==日志？什么日志？==
如果你遇上问题，日志记录系统就能帮上忙了，而且在你想我们寻求支持时，我们肯定会要求你提供日志的。默认情况下，GR将大部分日志信息写入到平台上临时目录的文件<tt>GalleryRemoteLog.txt</tt>中。如果你希望在该文件中看到更详细的信息，你可以在Gallery Remote偏好设定对话框中将''日志等级（log level）''设置为"详细且包含细枝末节（Detailed, very verbose）" 。

如果你希望在使用应用程序时日志打开而不是写入文件的话，你需要做如下修改：

* 在文件<tt>GalleryRemote.properties</tt>中（此为偏好设定文件，在偏好部分有解释），设置
 toSysOut=true
* 在文件 <tt>Gallery Remote.lax</tt> 中（位于Gallery Remote的安装目录下），设置 
 lax.stdout.redirect=console
								
'''注意：''' 在整个日志中你的密码会被打印在某些地方，因此在论坛发贴之前或将此日志寄予某人之前要慎重行事。

==我还是找不到日志文件==
不要再服务器中寻找Gallery Remote日志文件，它是在客户端中！

日志文件在你所使用的平台的临时目录之中：

* 对于Windows，打开Windows Explorer并在地址栏中输入<tt>%TEMP%</tt>。然后就会打开此目录，在此可以找到<tt>GalleryRemoteLog.txt</tt>日志文件。
* 对于Unix，它在 <tt>/tmp</tt>中。
* 对于MacOS X，它在<tt>/tmp/GalleryRemoteLog.txt</tt>中。

当你安装Gallery Remote1.4.1版本并稍后在Windows上安装时，它会安装两个可执行文件：<tt>Gallery Remote</tt>和<tt>Gallery Remote Debug</tt>。你可以运行后者来打开一个日志窗口。在日志的顶部会有信息告知你日志文件的存放位置。

==建立缩略图和显示预览的过程很慢（Linux和MacOS）==
在Windows系统上，ImageMagick和jpegtran由安装程序进行安装；但在其他的操作系统上，它们无法自动被安装，而是需要终端用户进行安装。

请确保在你的Unix PATH变量中存在这两个产品。使用如下命令行就能够运行它们了：

*jpegtran
*convert

如果上面的命令无效的话，你就应该下载这些软件包并安装它们：http://jpegclub.org/和http://www.imagemagick.org.

另见[[Gallery Remote:Bundled]]。

==似乎可以旋转相片（缩略图被旋转），但是上传之后这些之前被旋转的相片还是原来的样子==
同上。

==使用HTTPS==

Gallery Remote允许你使用https:// 类型的URL，从而连接到安全的网站。此功能仅于Java 1.4及更新的版本中可用。如果你试图连接的网站使用的服务器证书没有经过某权威认证的话，Gallery Remote将无法连接。如果出现了这种情况，你需要将该站点的证书添加到Java被信任证书的注册表中：

'''对于Windows:'''
# 通过IE浏览器连接到该网站
# 打开菜单文件（File）>属性（Properties）
# 在属性窗口中点击证书（Certificates）
# 在Details标签中，点击复制到文件…（click Copy to File...）
# 在向导中，选择DER-encoded X.509证书并将其保存到一个文件中
# 打开控制台窗口（cmd.exe）
# 输入如下命令行：
      keytool -import -trustcacerts -file path_to_cer_file -keystore %JAVA_HOME%/jre/lib/security/cacerts -alias arbitrary_name
:: 你会被询问store密码，默认为 
      changeit

'''对于OSX:'''
# 将证书（例子中的''mycacert''）保存在你的硬盘上（''路径''）
# 打开一个端子
# 输入下面的命令行：
      cd /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home/lib/security
      sudo keytool -import -keystore cacerts -trustcacerts -alias ''mycacert'' -file ''path''/''mycacert.crt''
:: 它先会询问你的Finder密码
:: 接着是keystore密码，默认为 
      changeit
:: 你会被要求导入''mycacert''
      yes（是）

'''对于Linux（debian和ubuntu）'''
# 保存上面例子中的样本
      sudo keytool -import -keystore /etc/java-1.5.0-sun/security/cacerts -trustcacerts -alias myalias -file myfile


==编辑偏好==

尽管有一个偏好（Preferences）对话框，但偏好设置文件仍可通过一些隐藏选项进行编辑。你不应修改<tt>defaults.properties</tt>文件，但可以阅读它以明确各偏好都有什么作用。然后你就可以编辑 <tt>GalleryRemote.properties</tt>（该文件创建于GR首次运行时），并根据需要添加或替换偏好设定。

确保在你编辑<tt>GalleryRemote.properties</tt> 文件时，Gallery Remote不处于运行状态，否则的话你的修改都会被覆盖掉。

偏好设定文件都位于当前用户home目录（较新版本的Windows中，这是启动分区中的<tt>Documents and Settings/<i>username</i></tt>目录）下的一个名为<tt>.GalleryRemote</tt>的目录中。Mac和Linux用户一般都知道home目录的位置。

==不使用安装程序在平台上运行GR==

Gallery Remote是使用Java语言编写的。如果你的系统中安装有Java 1.4或更新版本的话，就有可能可以使用java -jar GalleryRemote.jar命令来运行--这是假设与GalleryRemote.jar文件在同一个目录下的情况。

这将不包括GR有效运行所需的一些库，比较显见的是会看不到图标，文件的保存被禁用而EXIF信息也可能会被忽略。这仅在Gallery Remote 1.3和更新版本中可用。

==（非）捆绑软件==

如果有错误提示你ImageMagick或jpegtran没有安装的话，请参看[[Gallery Remote:Bundled]]。

==连接到G2：<tt>服务器已连接，但在此URL中没有找到Gallery</tt>==

如果你在运行Gallery2，请确保安装了'Remote'模块。它包含有'远程控制协议的实现'并启用remote小程序。此模块没有被包括在（目前的）'典型'安装包中。

如你设置成当某页面未找到时显示一个具有漂亮外观的丢失页面提示页而不是GR所希望的404错误消息时，你就会得到此消息：

* 在你的<tt>gallery2</tt>目录下创建一个仿冒的<tt>gallery_remote2.php</tt> 页面，内容是：
 <?php
   header("HTTP/1.0 404 Not Found");
   exit;
 ?>
:这就会保证URL返回的是404错误，这样GR就能使用了。

* 迫使GR不检查Gallery是否为G1而直接连接到G2：在你的[[GalleryRemote:FAQ#编辑偏好|GalleryRemote属性]]文件中，加入如下语句：
 forceGalleryVersion.''n''=2
: 其中的<tt>''n''</tt>符合文件中Gallery URL的数字。

Mac用户需要打开Terminal（shock horror），因为此目录为隐藏的。请确保至少运行过一次Gallery Remote但程序在你开始之前就关闭了。那么请打开Terminal app并输入：

pico .GalleryRemote/GalleryRemote.properties

接着你就会在PICO文本编辑器中看到GalleryRemote.properties文件了。使用键盘上的方向键下拉到文件底部并粘贴上面的代码。将代码中的字母n改为你url的数字（我的是0因为我只添加了一个url）。

接着使用组合键[ctrl] – O保存你做出的修改

再使用组合键[ctrl] – X退出PICO

现在关闭Terminal app并重启Gallery Remote。我这么做就能解决问题: )

==非拉丁语系的GR==

大部分情况下，GR（1.5.1-b5和更新版本）解决了非拉丁语系情况出现的问题，但有时也有必要将以下语句添加到你的GalleryRemote.properties文件中去：

 fontOverrideName=SimSun
 fontOverrideSize=12
 fontOverrideStyle=0

如果上面的3行缺失任何一行的话，GR将无法应用正确的字体设定。比如如果仅仅设置了fontOverrideName的话，字体将不会有任何变化。

==Gallery Remote的安装程序无法运行==

Gallery Remote是使用由Macromedia开发的[http://www.macrovision.com/products/flexnet_installshield/installanywhere/index.shtml Install Anywhere]进行安装的。在很少的情况下，安装程序会无法运行。当这种情况发生时，请尝试安装.jar版本：从SourceForge上将它下载下来并运行安装程序（你得安装好了Java 1.5或更新版本才行）。

 java -jar GalleryRemote.jar

（你所下载文件的文件名会有些微出入）

==内存耗尽的错误==

一般来讲独立版本的Gallery Remote不会耗尽内存，因为其设置就是为了获取更多内存。但Gallery Remote的小应用程序需要按照web浏览器的指示来完成任务，因此内存常常是个问题。

如果你碰上了内存耗尽的错误，这里给出一些可能方案使你能够安心使用小程序而不会出问题：

# 在你的本地计算机上[[Gallery Remote:Bundled|安装ImageMagick]]：ImageMagick将处理有关大图片重设尺寸的繁重工作，因此Java小程序就可以不必亲自做这项工作了。这也会显著加速幻灯片和上传的速度。
# 为Java小程序分配更多的内存。在不同的操作平台上，操作方式也不尽相同。在Windows上：
#* 打开Java控制面板
#* 在Java标签中，点击顶部（Applet Runtime Settings）View...按钮
#* 在（最近）活动JRE的Java Runtime Parameters中输入 <code>-Xmx128M</code>

==我想实现一个新的Gallery客户端应用程序==

那么就有必要看看有关[[Gallery_Remote:Protocol|Gallery Remote协议的指导手册]]。

你还可以试试看是否能重新使用[[Other_Clients|已有的此类应用程序]]（大多为开源的）。

==错误："Gallery Remote can find no protocol implementation at the URL ..."==

你需要在你的web服务器上安装Gallery Remote模块。要完成此操作，以管理员身份登录
到你的Gallery，打开"站点管理（Site Admin），" 然后是"插件（Plugins），" "获取更多插件（Get More Plugins），" 在底部附近找到"远程控制（remote control）"然后再下载该模块。这样就好了！

==启用加速转换==

Java 1.6之后，你可以通过向Java命令行添加 <code>-Dsun.java2d.opengl=true</code>来启用更流畅的转换；这将允许Java 2D使用OpenGL来创建图片。对于小应用程序和Windows来说，此操作是在Java控制面板，Java标签， Java Applet Runtime Settings （点击View...）中完成的。将上面的片段添加到Java Runtime Parameters中去（为了安全起见，将其添加到所有涉及1.6.0或更高版本的语句行中）。