hexagonit.virtualgallery 1.0

嵌入代码

嵌入HTML代码需要嵌入Virtual3DGallery.swf查看器，并将单个名为dataURL的flashvars变量传递给查看器。此变量必须包含配置查看器的JSON配置文件的URL。

如果您在包含其他内容的页面上嵌入查看器，还建议设置wmode=window flash参数，以便HTML元素可以定位在flash内容上方。

默认情况下，此包使用SWFObject JavaScript库来完成嵌入。

JSON配置

Flash查看器由包含要在图库中显示的图像列表、关联的图像元数据（标题、作者、描述）以及UI文本元素的翻译的JSON配置驱动。

{"images": [
    {"url": "http://my.server.com/images/image1.png",
     "title": "Nice scenery",
     "description": "Lorem lipsum..",
     "author": "dokai"},
    {"url": "http://my.server.com/images/image2.png",
     "title": "Screenshot of Foo",
     "description": "Lorem lipsum..",
     "author": "dokai"}
    ],
 "ui": {
    "enterRoomToolTip": "Click to enter",
    "fullscreen": "Fullscreen",
    "loadingImg": "Loading image:",
    "enterRoom": "Entering room [x] of [y]",
    "anaglyph": "Anaglyph"
 },
 "settings": {
    "anaglyphModeEnabled": "false"
 }}

查看器不关心图像和关联的元数据来自何处，因此您可以实现任何自定义逻辑，只要结果是有效的JSON文档（例如，自定义目录查询、结构层次等）。

此包包含一个相关的JSON模式文档，可用于验证JSON配置。

from hexagonit.virtualgallery.schema import GALLERY_DATA_SCHEMA
from validictory import validate
import json

try:
    # Assuming the `my_custom_config` contains the Python
    # data structure with the image information.
    validate(my_custom_config, GALLERY_DATA_SCHEMA)
    json_config = json.dumps(my_custom_config)
except ValueError:
    # Validation failed, do something.
    pass

您可能想在其他地方显示图库或在无工具栏的新窗口中显示。为了将所有Plone内容与虚拟图库隔开，请使用以下URL仅获取图库的标题和显示它的Flash对象

http://<path>/<to>/<your>/<gallery>/<folder>/virtualgallery?ajax_load=1&ajax_include_head=1

1.0 (2011-08-26)

• 添加了对图库中使用的图像比例按上下文配置的支持。[dokai]

• 更新了文档。[dokai]

• 更新了芬兰语翻译。[dokai]

• 添加了对翻译的支持。[zupo]

• 修复了Flash窗口模式，使得Plone下拉菜单在Flash电影上方可见。[dokai]

• 更新了Flash电影到新版本。亮点

  • 墙上不再有空帧。

  • 进入房间时的默认位置显示带有房间号的中间框更清晰。

  • 移除了冗余的工具提示（上一页、下一页、前进、后退等）。

  • 使用鼠标点击通过门。

  • 重新定位了上一页/下一页和全屏按钮。

  • 修复了在全屏模式下图像信息弹出窗口粘性问题的bug。

  • 修复了空相册的bug。

  • 修复了工具提示在不同大小文本上展开不正确的bug。

  • 修复了在某些情况下点击图片会放大错误图片的bug。

  • 通过单击即可穿过门。

  还移除了JSON配置中的冗余条目。

  [dokai]

1.0b4（2011-08-10）

• 真正修复了打包错误。setuptools的unpack_tarfile函数在解包时过滤掉符号链接，因此它们将不会出现在解包的包中。这，加上tar本身或Python tar模块中的某些奇怪之处，导致符号链接的目标从最终的解包包中删除。[dokai]

1.0b3（2011-08-10）

• 修复了1.0b2中的打包错误。[dokai]

• JSON模式验证。[zupo]

1.0b2（2011-08-04）

• 代码清理。[zupo]

• 更多的注释和文档。[zupo]

• 更多的测试。[zupo]

1.0b1（2011-08-04）

• 首次发布。[zupo]