Projects/Plasma/PIG (zh CN)

本指南涵盖内容（以及将要涵盖）

文档记录了一系列好，不好的使用方法，以及如何使用Plasma的接口,特别是Applets和Plasmoids。

分类命名

The following are acceptable known entries for plasmoids and applets. If your applet does not fall within one of the following categories, leave the category field empty (it will be automatically categories under "Miscellaneous" for the time being) and contact the Plasma development team to have a suitable category added to the list (at which point you may then use that category).

• 应用程序加载器 程序启动以及文件打开。
• 天文 星空模拟或天文相关。
• 日期时间 时钟，日历，计划，等。
• 开发工具 软件开发工具。
• 教育 教学和教育用。
• 环境和天气 显示天气或其它环境相关事宜。
• 举例 非生产系统。
• 文件系统 所有在文件系统上的操作，诸如列举目录和文件状态监视。简单的把文件作为存储介质并不是这个插件的主题。
• 游戏 游戏和玩具。
• 图形 显示图片，照片或其他图形事务，用于饱眼福。
• 语言 语言相关插件，如字典，翻译器等。
• 地图 地理信息和地理信息相关插件。
• 多媒体 音频和视频。
• 在线服务 add-ons that provide an interface to online services such as social networking or blogging sites. If there is another more appropriate category for the add-on given the topic (例如， mapping if the applet's purpose is to show maps), even if the data is retrieved from the Internet prefer that other category over this one.
• 系统信息 获取并显示系统信息，如网络活动情况, 硬件情况, 内存使用等。
• 工具 计算有用工具。
• 窗口和任务 管理应用程序窗口和任务，如任务条。

打包常规

命名

Since your plugins and packages will co-exist with everyone else's, it is a good idea to use a naming scheme that eliminates possibility of accidental name collisions.

In the examples below where it referse to [name], consider including an element unique to your project or organization in it. For instance, if your packages accompany an application, consider including the name of the application. Using an organizational or domain name are also possibilities.

例如, 如果你的Plasmoid名叫"SuperWidget", 他的[名字]可能就是：

• myapp_superwidget if it comes with the MyApp program
• myorg_superwidget if it is associated with the MyOrg project/company/entity
• net_myorg_foo_superwidget if the domain name associated with the plasmoid's origin is foo.myorg.net

.desktop文件

Plasma uses a "general to specific" naming system for .desktop files. Following this practice makes it easy to find entries in the file system and keeps things nicely ordered.

In the list below, [name] would most commonly be the plugin name as found in the file. Files autogenerated by ScriptEngines may include additional namespacing information in the file name.

• Animators: plasma-animator-[name].desktop
• Applets: plasma-applet-[name].desktop. 实现语言无关,只要有plasma-applet的前缀。
• Containments: plasma-containment-[name].desktop
• DataEngines: plasma-dataengine-[name].desktop
• Runners: plasma-runner-[name].desktop
• ScriptEngines: plasma-scriptengine-[type]-[name].desktop where type may be one or more of Applet, DataEngine and/or Runner.