# [GDL-sublime](https://github.com/runxel/GDL-sublime) > 将GDL集成到[Sublime Text](https://text.sublime.net.cn/)的集合。[](https://github.com/runxel/GDL-sublime/releases/latest) [](https://packagecontrol.sublime.net.cn/packages/GDL) [](https://discord.gg/6R4a5qQ)

什么是GDL？

GDL意为“几何描述语言”。ArchiCAD用它来定义部件库。

许多ArchiCAD用户正在制作自己的部件库，出售它们，甚至在一些网站如BIMComponents上免费发布，而其他人只是想修改提供的版本。但它们都与一个——不幸地相当糟糕——内置对象编辑器相关联，该编辑器陷入80年代左右的状态。它甚至没有行号！

但拯救在这里！
此包的目的是让您能够舒适地在Sublime Text中编写代码。

此包提供了一切：从 语法高亮（带有良好的颜色方案）到 自动完成、全局跳转、片段，以及最后但同样重要的是脚本 构建系统。

安装

使用Sublime Package Control

:whitecheck_mark: _推荐
如果您使用Sublime Package Control，您可以通过菜单项“Sublime Text -> Preferences -> Package Control: Install Package”轻松安装此包。

使用Git

机器人: 或者，您可以安装软件包，并通过直接将仓库克隆到 Sublime Text 应用程序设置区域的 软件包 目录中来保持更新。

转到您的 Sublime Text 软件包 目录，并使用以下命令克隆仓库
git clone https://github.com/runxel/GDL-sublime "GDL"

手动下载

:arrow_down: 不建议 – 您将无法获得更新！ :rotating_light
手动下载文件 - 使用 GitHub .zip 下载选项下载文件 - 解压文件并将文件夹重命名为 'GDL' - 将文件夹复制到您的 Sublime Text 软件包 目录，例如 - Windows C:\Users\<你的名字>\AppData\Roaming\Sublime Text 3\Packages\GDL - OS X: ~/Library/Application Support/Sublime Text 3/Packages/GDL

用法

从现在起，您可以在 ST 右下角选择 GDL 作为当前语言，并享受所有好处。对于扩展名为 .gdl 的文件，它将自动激活。
对于配色方案（即正确的突出显示），有两种选择。默认情况下，将应用浅色方案。
我个人更喜欢深色配色方案，提供疲劳防护的编码。要更改配色方案的使用，请转到 首选项 > 软件包设置 > GDL > 设置。

将以下 一个 复制到右侧文件中并保存

深色

{  
    "color_scheme": "Packages/GDL/GDL-dark.sublime-color-scheme"  
}

浅色

{  
    "color_scheme": "Packages/GDL/GDL-light.sublime-color-scheme"  
}

不喜欢主题？

您可以直接编辑 .sublime-color-scheme 文件 – 事实上，它们基本上是 .json 文件。但请记住将您自己的配色方案复制到 用户 目录！否则，更新会覆盖您的更改。（当然，您需要像上面那样指向 Sublime Text 的新配色方案。）

前往，自动完成，片段

Sublime Text 的“前往”功能非常强大。要想完全访问，您必须使用 Sublime 项目。例如，如果您想快速转到子程序的位置，请将光标放在名称上并按 F12。然后您将直接跳转到定义。
如果您在键入，将自动进行自动完成。您可以通过 ctrl + 空格 强制自动完成。
我已经包括了一些示例片段。尝试输入 comline 并然后按 TAB ↹。
万岁！有一个分隔符。
! ---------------------------------------------------------------------- !

我很少鼓励您修改并扩展片段，以使其符合您的需求。
您将在 片段 文件夹中找到所有发行的片段。

工作流程

随着 ARCHICAD 23 的推出，我们不再需要像 GDLnucleus 这样的第三方应用程序来实现 Sublime Text 驱动的工作流程。每台 Archicad 安装都包括的 LP_XMLConverter 现在可以直接将 .gsm 转换为随后的 .gdl 脚本，反之亦然。这意味着结束了过去大量复制粘贴的狂欢。

要使用此功能，首先需要设置您的 ARCHICAD 安装路径。再次打开软件包设置，并将左侧相应项复制到右侧窗格。相应更改路径。

之后，将包含您的 'gsm'（我建议为不同的 gsm 保存不同的文件夹）的文件夹拖放到 Sublime Text 中，然后通过 项目 > 存储项目为… 创建一个 Sublime 项目。其他好处是更好的“前往”功能、自动完成，以及快速切换到不同 gsm 的不同编码会话。您可以将您刚刚拖放到 Sublime Text 中的文件夹中的所有文件都放在侧边栏中，也可以轻松通过快速打开调色板访问它们。
有关所有可能的文件夹结构方式，请见 下方

现在您可以使用 工具 > GDL 中的两个转换选项。为了快速访问，这两个项都可通过在编辑器窗格上右击鼠标访问。每个都有相应的快捷键。
默认情况下，转换为脚本（gsm → hsf/gdl） 的快捷键是 ctrl+shift+H。 从 HSF（hsf/gdl → gsm）构建 GSM 默认分配了 ctrl+shift+alt+G。当然，这些可以根据您的喜好进行调整。

位置

如果您在 HSF 和 GSM 之间进行转换，默认位置将是相邻的。但是，您可以定义一个 全局默认路径（见下面示例），将任何 GSM 部署到那里。如果您已经将中央库链接到 Archicad，这将非常有用。
当然，您可以通过在 基于项目的方式 中设置路径来覆盖此行为。这可以通过打开相应的 .sublime-project 文件并添加来实现。

{
    "cmdargs":
    {
        "proj_gsm_path": "C:/Users/runxel/gsm-dev"
    }
}

如果您将以 "default" 替换路径，可以模拟标准行为：GSM 将在 HSF 旁边构建。如果您已在包设置中设置全局路径，这将非常有用。请记住：项目设置会覆盖全局设置。

注意：目前未实现路径检查！您必须自己注意，您有权相应地向路径写入。

结构

让我们看看您如何组织文件夹结构！
_{（请注意，名称仅为例子。）}

基本结构如下所示： “ ├─ example object.. # <- 这就是 HSF；包含脚本部分的文件夹 └─ example object.gsm

Simple, right?

But what if you deploy a nested folder structure, like below? In this case you can make use of the 'sub root' feature, which let's you dig into a nested structure (can be arbitrarily deep, but keep in mind you might run in the hard 255 path character limit of Windows).

├─ .editorconfig ├─ README.md ├─ docs.. ├─ images.. └─ Objects\ ├─ Object-1.. ├─ Object-2.. └─ Object-3\ ## 确保外部及内部文件夹及│ └─（所有脚本） └─ Object-3.gsm ## 的.gsm 具有相同的名称！

What you can do is to declare a new 'root'.  
All you need to do is to put the following statement into your `.sublime-project` file:
```jsonc
{
    "root": "Objects"
    // for deeper nesting use forward slashes: "Objects/deeper"
}

您甚至可以指向对象之一以绕过选择对话框。

另一种非常方便的方法是告诉 GDL-Sublime，每次您保存 GDL 时都应将其转换为当前编辑的 GDL。
”jsonc { “convert_on_save”: true }

_Note: Multi root environments are not supported at the moment._



### Syntax Settings Example:
```json
{
    "AC_path": "C:/Program Files/GRAPHISOFT/ARCHICAD 23",
    "color_scheme": "Packages/GDL/GDL-dark.sublime-color-scheme",
    "global_gsm_path": "D:/office/aclibrary"
}

可以在 .sublime-project 文件中覆盖 AC_path。

支持

这个插件是否帮助了您日常工作，还是只是想要说谢谢？
countless hours were spent on developing GDL-Sublime.
请考虑捐助以支持此插件的开发！