编辑“Gallery:整合的相关帮助指导”（章节）

=== 实际的修改 ===
==== 将relativeG2Path要求替换为绝对g2Uri ====
引入'''g2Uri'''的原因：
* embedPath和g2Uri会变成绝对的（稳定性）
* 绝对路径比相对路径要易懂
* 启用新特点：不同子域上的G2和emApp（见后文）
* （如未使用短url），我们可再次将embedUri和embedPath合并到一个参量中去（embedUri）
g2Uri的格式：''/path/'' OR ''HOST_STRING/path/'' 第一个斜线之前的字串被解释为G2的host，而第一个斜线之后的字串就是路径（你还可以包括进http:// bit，它也能被正确地解析）。
* HOST_STRING是可选的。如未经指定，我们使用$_SERVER[HTTP_HOST]来建立直接指向G2的URL。
* 因此，大部分的用户会有g2Uri = '/gallery2/'。 
* 举例：如果G2安装在<nowiki>http://www.example.com/gallery2/</nowiki> 上，那么g2Uri就是'/gallery2/'
*举例：如果G2出在相同的位置而emApp位于<nowiki>http://portal.example.com/</nowiki>（注意不同的子域）上，那么g2Uri就会是'www.example.com/gallery2/'或<nowiki>'http://www.example.com/gallery2/'</nowiki>

==== 移除embedPath并将其并入embedUri ====
取代embedUri和embedPath，并合并为一个参量，名为'''embedUri'''
* 在G2中，我们需要设法找到embedPath。它可以作为一个参量，或自当前REQUEST_URI中解析出来
* 旧式embedUri也包括有embedPath，我们可以解析最后一条斜线以找到embedPath
** 举例：embedUri = '/portal/index.php?module=gallery2'，那么我们就会解析最后的一条'/'并找到'/portal/'
* 这回比分别询问embedUri和embedPath要更令人困扰吗？尤其是目前我们有了g2Path，它具有与当前embedPath相同的样式。
* 短URL又如何？短URL仍只进行一次配置，而且不需要任何其他的输入。但我们还引入了一个特点，就是当前的embedPath可以覆盖经存储的embeddedLocation（在重写模块配置时存储的embedPath）。我们引入它就是为了允许从多个vHost访问启用重写的嵌入G2。如给定了embedUri是否还能够实现？我们仍会解析embedUri中的最后一个'/'来获取embedPath。但embedUri很可能是短URL的格式，如embedUri = '/portal/gallery2/'。那么在此特例中的embedPath = embedUri，baseFile会是''。无法想出会出现问题的情况。

[[Category:Gallery 2:Development|Integration Howto]]