Lairdubois-opencutlist-sketchup-extension 开源项目使用教程

1. 项目的目录结构及介绍

lairdubois-opencutlist-sketchup-extension 项目目录结构如下：

lairdubois-opencutlist-sketchup-extension/
├── CutList.rb
├── CutListUI.rb
├── CutListUI.html
├── CutListUI.js
├── en-US/
│   ├── CutList translates.ini
│   └── CutListUI translates.ini
├── ja-JP/
│   ├── CutList translates.ini
│   └── CutListUI translates.ini
├── locale/
│   ├── CutList translates.ini
│   └── CutListUI translates.ini
├── resources/
│   ├── icons/
│   │   ├── cutlist_icon_16.png
│   │   ├── cutlist_icon_24.png
│   │   ├── cutlist_icon_32.png
│   │   └── cutlist_icon_48.png
│   └── templates/
│       └── CutList Template.skp
└── sketches/
    └── sample.skp

• CutList.rb：项目的 Ruby 主文件，包含了 SketchUp 插件的核心逻辑。
• CutListUI.rb：用于定义和加载用户界面的 Ruby 脚本。
• CutListUI.html 和 CutListUI.js：用户界面的 HTML 和 JavaScript 文件，用于构建插件的图形用户界面。
• en-US/、ja-JP/ 和 locale/：包含不同语言翻译的文件夹。
• resources/：存放项目资源，如图标和模板文件。
  • icons/：插件图标文件。
  • templates/：SketchUp 模板文件。
• sketches/：示例 SketchUp 文件。

2. 项目的启动文件介绍

项目的启动文件为 CutList.rb。这个 Ruby 脚本负责初始化插件，定义插件的菜单项，并加载用户界面。以下是启动文件的关键代码片段：

require 'sketchup.rb'
require ' CutListUI.rb'

# 插件菜单项
menu = UI.menu('Plugins')
menu.add_item('Lairdubois CutList') { CutListUI.show }

# 插件初始化
Sketchup.title = "Lairdubois CutList"

3. 项目的配置文件介绍

项目的配置文件主要位于 locale/ 目录下的 CutList translates.ini 文件。这个文件包含了插件的文本翻译，用于国际化支持。以下是配置文件的一个示例：

[General]
Language=zh-CN

[CutList]
WindowTitle=裁切列表
MenuTitle=裁切列表

[CutListUI]
Label=裁切列表

在这个配置文件中，可以定义插件在不同语言环境下的显示文本，如窗口标题、菜单项标题等。通过修改这些文本，可以为不同语言的用户提供本地化支持。