# [GDL-sublime](https://github.com/runxel/GDL-sublime) > A bundle to make GDL available in [Sublime Text](http://www.sublimetext.com/). [![Version](https://img.shields.io/github/release/runxel/GDL-sublime.svg?style=flat-square)](https://github.com/runxel/GDL-sublime/releases/latest) [![Downloads](https://img.shields.io/packagecontrol/dt/GDL?logo=sublime%20text&style=flat-square)](https://packagecontrol.io/packages/GDL) [![Discord](https://img.shields.io/discord/700328186642432040?color=738ad6&label=Join%20the%20Discord%20server&logo=discord&logoColor=ffffff)](https://discord.gg/6R4a5qQ)
--- # What is GDL? GDL means 'Geometric Description Language'. [ArchiCAD](http://www.graphisoft.com/) uses it to define a library part. Many ArchiCAD users are making their own library parts, sell them or even publish them for free on sites like [BIMComponents](https://bimcomponents.com/), while others just want to modify the provided ones. But they are all tied to the – unfortunately horrible – built-in object editor which is stuck in the 80's or so. It doesn't even have line numbers! But salvation is here! The purpose of this package is to give you the chance to comfortably write code in[Sublime Text](https://www.sublimetext.com/). This package provides the whole thing: from **syntax highlighting** (with a well aligned **color schemes**) to **auto completion**, **global goto**, **snippets**, and last but not least a **build system** for your scripts. ## Installation ### Using Sublime Package Control :white_check_mark: _recommended_ If you are using [Sublime Package Control](http://wbond.net/sublime_packages/package_control), you can easily install the bundle via the `Sublime Text -> Preferences > Package Control: Install Package` menu item. ### Using Git :robot: Alternatively you can install the bundle and keep up to date by cloning the repo directly into your `Packages` directory in the Sublime Text application settings area. Go to your Sublime Text `Packages` directory and clone the repository using the command below: `git clone https://github.com/runxel/GDL-sublime "GDL"` ### Download Manually :arrow_down: _not recommended – you won't get updates!_ :rotating_light: - Download the files using the GitHub .zip download option - Unzip the files and rename the folder to 'GDL' - Copy the folder to your Sublime Text `Packages` directory i.e. - Windows `C:\Users\\AppData\Roaming\Sublime Text 3\Packages\GDL` - OS X: `~/Library/Application Support/Sublime Text 3/Packages/GDL` ## Usage From now on you can select `GDL` as the current language in the bottom right corner of ST and enjoy all the benefits. For files with the `.gdl` extension it will be automatically active. For the coloring (meaning the proper highlighting) there are two choices. By default a light color scheme will be applied. I personly like the dark coloring more, providing fatigue-proof coding. To change the use of a color scheme go to `Preferences > Package Settings > GDL > Settings`. Copy _one_ of these into the file on the right and save: #### **Dark:** ```json { "color_scheme": "Packages/GDL/GDL-dark.sublime-color-scheme" } ``` ![dark color scheme](https://i.imgur.com/OEurk9A.png) #### **Light:** ```json { "color_scheme": "Packages/GDL/GDL-light.sublime-color-scheme" } ``` ![light color scheme](https://i.imgur.com/OQx2IF2.png) #### Don't like the themes? You can edit the `.sublime-color-scheme` files directly – they are nothing else than `.json` files basically. But remember to copy your own color scheme into the `User` folder! Otherwise an update would overwrite your changes. (Of course you then need to point Sublime Text to your new color scheme like above.) ### GoTo, Auto completion, Snippets The "Goto" feature of Sublime Text is pretty powerful. To gain full access you must use [Sublime projects](#workflow). If you e.g. quickly want to got to a subroutine place your cursor into the name and press F12. You will then jump directly to the definition. Auto completion takes place automatically, if you're typing. You can force auto completion via ctrl + space. I have included some example snippets. Try it out by typing in: `comline` and then press TAB ↹. Voilá! There's a divider. `! ---------------------------------------------------------------------- !` I hardly encourage you to modify and extend the snippets, so they will suit your needs. You will find all the shipped snippets in the `Snippets` folder. ## Workflow With the advent of ARCHICAD 23 we don't longer need third-party apps like [GDLnucleus](http://www.opengdl.org/Default.aspx?tabid=9748) for a Sublime Text driven workflow. The **LP_XMLConverter**, which is part of every Archicad installation, can now convert `.gsm` directly into subsequent `.gdl` scripts and vice-versa. This means an end to the abundant copy & pasting orgy of the past. To use this feature you first need to set the path to where your ARCHICAD is installed. Open the package settings again and copy the respective item from the left to the right pane. Change the path accordingly. Afterwards drag and drop a folder with your 'gsm' (I recommend different folders for different gsm's) into Sublime Text and then create a Sublime project via `Project > Save Project As…`. Other benefits are a better working 'goto', 'auto completion', and the possibility to fast switch between different coding sessions on various gsm's. All the files inside the folder you just dragged into Sublime Text will be visible in the sidebar, and can also easily be accessed via the quick open palette. For all the possible ways to structure your folders see [below](#structure) You can now use the the two conversion options in `Tools > GDL`. For a quick access both items are reachable via a right mouse click on the editor pane. There are also key bindings on each. The default for `Convert to script (gsm → hsf/gdl)` is ctrl+shift+H. `Build GSM from HSF (hsf/gdl → gsm)` has ctrl+shift+alt+G assigned OOTB. Of course these can be adjusted to your taste. ### Places If you convert between [HSF](http://gdl.graphisoft.com/tips-and-tricks/hsf-source-format) and GSM the default place will be next to each other. However you can define a _global default path_ (see [example](#syntax-settings-example) below) where any GSMs should be deployed to. This is useful if you have a central library already linked in Archicad. Of course you can overwrite this behavior by having a path on _project basis_. This can be set by opening the corresponding `.sublime-project` file and adding: ```json { "cmdargs": { "proj_gsm_path": "C:/Users/runxel/gsm-dev" } } ``` If you substitute the path with `"default"` you can mimic the standard behavior: the GSM will be built next to the HSF. This is useful if you have set a global path in the package settings. Remember: **Project settings override global settings**. Note: There's no path checking implemented at the moment! You have to take care by yourself that you're allowed to write at the paths accordingly. #### Structure Let's have a look on how you can organize your folder structure! (Please note: the names are just examples.) The basic structure looks like this: ``` ├─ example object\.. # <- this is the HSF; the folder with the script parts └─ 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\ ## be sure that the outer AND ├─ Object-3\ ## the inner folder AND also │ └─ (all scripts) └─ Object-3.gsm ## the .gsm share exactly the same name! ``` 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" } ``` You could even point to one of the objects directly to circumvent the selection dialog. Another and very comfortable way is to tell GDL-Sublime it should convert the current GDL being edited everytime you save the 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" } ``` The `AC_path` can be overwritten in your `.sublime-project` file. ## Getting started with Sublime Text New to Sublime? Then I can recommend this excellent and free video tutorial by nettuts: [Perfect Workflow in Sublime Text](http://net.tutsplus.com/articles/news/perfect-workflow-in-sublime-text-free-course/). ## Support Does this plugin help you in your daily work, or you just want to say thanks? Countless hours went into the development of GDL-Sublime. Please consider donating to sustain working on this plugin! [![ko-fi](https://www.ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Y8Y5VOOM)