Skip to content

Latest commit

 

History

History
74 lines (49 loc) · 2.56 KB

MANUAL.md

File metadata and controls

74 lines (49 loc) · 2.56 KB

PyDeck 使用说明

  • PyDeck.yaml

    Port: Web 服务侦听端口，防火墙要开放这个端口，否则其他设备无法连接 Web 服务。
Title: 面板名称
Theme: 页面主题，对应 static\css 下的 css 文件名，不包含后缀 (.css)
Icons Per Line: 每行应用图标个数
Show Label: 是否显示应用名称，true|false
Pre-action: 启动 app 前执行命令，可有可无可为空。
Post-action: 启动 app 后执行命令，可有可无可为空。
Apps: 应用列表
-   id: 应用ID，纯英文字符串
    name: 应用显示名称
    icon: 应用图标文件名，存放目录：PyDeck\icon
    command: 应用实际执行命令
    workdir: 应用起始路径

    • App id 有两个特殊值：

      <RELOAD> : 重新载入后台设置按钮，点击可以重新载入 PyDeck.yaml 和 PyDeck.stpl，对应 URL: /reload

      <BR> : 强制换行

    • 所有字符串值最好都加英文单引号(')，字符串里有双引号 (") 的一定要加单引号。

    • Pre-action、Post-action、command、workdir 中，如果文件名或路径中有空格，需要加双引号。

    • command 和 workdir 的正确格式：

      可以认为在 PyDeck 服务器中有一个隐藏的 cmd 窗口，执行

      START "[PyDeck] CMD" /I /D workdir command

      因此，如果将 command 和 workdir 填入其中后，在普通 cmd 窗口中可以运行成功，那么基本上 PyDeck 也可以成功执行命令。

    • Pre-action、Post-action、command、workdir 支持以下宏：

      {PYDECK_PATH} : 运行时会替换成 PyDeck 根目录

      {APPID} : 运行时会替换成相应的 appid

  • PyDeck.stpl

    Deck 页面模板 (HTML)，可以自己修改。

    注意： {{ }} 中和 % 后的是 Python 代码。

  • icon\ 目录

    子目录 icon 里放的是应用图标文件，浏览器支持显示的格式都行，最好是正方形图片。

    icon\RELOAD.png 是 PyDeck 自用的，不要删除，除非修改了 PyDeck.stpl。

  • static\ 目录

    会映射到 http:\\IP:Port\static\，包括下面所有子目录和文件。

  • 客户端浏览器要求

    页面用了 jQuery 1.12.4 和简单的 CSS，至少在我的 iPad 1 (iOS 5.1.1) 的 Safari 浏览器上没问题。

感谢