mirror of https://github.com/buggins/dlangide.git
177 lines
5.2 KiB
Markdown
177 lines
5.2 KiB
Markdown
[](https://gitter.im/buggins/dlangide?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/buggins/dlangide) [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=H2ADZV8S6TDHQ "Donate once-off to this project using Paypal")
|
|
|
|
Dlang IDE
|
|
=========
|
|
|
|
Cross platform D language IDE written using DlangUI library.
|
|
|
|
Currently supported features:
|
|
|
|
* Can open DUB (dub.json) projects
|
|
* Shows tree with project source files
|
|
* Can open and edit source files from project or file system in multi-tab editor
|
|
* Build and run project with DUB
|
|
* Build log highlight and navigation to place of error or warning by clicking on log line (contributed by Extrawurst)
|
|
* DUB dependencies update
|
|
* DUB package configuration selection (contributed by NCrashed)
|
|
* Dependency projects are shown in workspace tree
|
|
* New project wizard
|
|
* Toolchain settings for DMD, LDC, GDC
|
|
* Project specific settings
|
|
* Basic debugger support using GDB (work in progress)
|
|
|
|
|
|
Source editor features:
|
|
|
|
* D language source code, json, dml syntax highlight
|
|
* Indent / unindent text with Tab and Shift+Tab or Ctrl+\[ and Ctrl+\]
|
|
* Toggle line or block comments by Ctrl+/ and Ctrl+Shift+/
|
|
* D source code autocompletion by Ctrl+Space or Ctrl+Shift+G (using DCD)
|
|
* D source code Go To Definition by Ctrl+G or F12 (using DCD)
|
|
* D source Doc comments display on mouse hover (using DCD)
|
|
* D source code Smart Indents
|
|
* Select word by mouse double click
|
|
|
|
|
|
|
|
|
|
GitHub page: [https://github.com/buggins/dlangide](https://github.com/buggins/dlangide)
|
|
|
|
Wiki: [https://github.com/buggins/dlangide/wiki](https://github.com/buggins/dlangide/wiki)
|
|
|
|
DlangUI project GitHub page: [https://github.com/buggins/dlangui](https://github.com/buggins/dlangui)
|
|
|
|
Mago debugger GitHub page: [https://github.com/rainers/mago](https://github.com/rainers/mago)
|
|
|
|
|
|
Build tools
|
|
===========
|
|
|
|
DlangIDE uses DUB as build tool, and its dub.json as project file format.
|
|
You can select DMD, LDC or GDC compiler toolchain.
|
|
|
|
|
|
DCD integration
|
|
===============
|
|
|
|
Symbol lookup and autocompletion is using DCD (D completion daemon).
|
|
|
|
Hans-Albert Maritz (Freakazo) implementated DCD integration using DCD client/server.
|
|
|
|
Keywan Ghadami improved it to use DCD as a library.
|
|
|
|
Now DCD is embedded into DlangIDE, and no separate executables are needed.
|
|
|
|
|
|
Debugger support
|
|
================
|
|
|
|
* Windows: use mago-mi debugger (https://github.com/buggins/dlangide/blob/master/libs/windows/x86/mago-mi.exe) or GDB
|
|
* Linux: use GDB or lldb-mi debugger
|
|
* OSX: use GDB or LLDBMI2 debugger
|
|
|
|
|
|
Building DlangIDE
|
|
=================
|
|
|
|
Build and run with DUB:
|
|
|
|
git clone https://github.com/buggins/dlangide.git
|
|
cd dlangide
|
|
dub run
|
|
|
|
If you see build errors, try to upgrade dependencies:
|
|
|
|
dub clean-caches
|
|
dub upgrade --force-remove
|
|
dub build --force
|
|
|
|
|
|
Needs DMD 2.066.1 or newer to build.
|
|
|
|
|
|
HINT: Try to open sample project Tetris, from workspaces/tetris with DlangIDE.
|
|
|
|
To develop in VisualD together with DlangUI, put this project on the same level as dlangui repository, and its dependencies.
|
|
|
|
|
|
Keyboard shortcut settings
|
|
===========================
|
|
|
|
Keyboard shortcuts settings support is added.
|
|
|
|
For linux and macos settings are placed in file
|
|
|
|
~/.dlangide/shortcuts.json
|
|
|
|
For Windows, in directory like
|
|
|
|
C:\Users\user\AppData\Roaming\.dlangide\shortcuts.json
|
|
|
|
If no such file exists, it's being created on DlangIDE start,
|
|
filling with default values to simplify configuration.
|
|
|
|
Just edit its content to redefine some key bindings.
|
|
|
|
File format is simple and intuitive. Example:
|
|
|
|
{
|
|
"EditorActions.Copy": "Ctrl+C",
|
|
"EditorActions.Paste": "Ctrl+V",
|
|
"EditorActions.Cut": "Ctrl+X",
|
|
"EditorActions.Undo": "Ctrl+Z",
|
|
"EditorActions.Redo": [
|
|
"Ctrl+Y",
|
|
"Ctrl+Shift+Z"
|
|
],
|
|
"EditorActions.Indent": [
|
|
"Tab",
|
|
"Ctrl+]"
|
|
],
|
|
"EditorActions.Unindent": [
|
|
"Shift+Tab",
|
|
"Ctrl+["
|
|
],
|
|
"EditorActions.ToggleLineComment": "Ctrl+/",
|
|
"EditorActions.ToggleBlockComment": "Ctrl+Shift+/"
|
|
}
|
|
|
|
|
|
Development environment setup
|
|
=============================
|
|
|
|
Howto hack DlangIDE.
|
|
|
|
For Windows, install MS Visual Studio (e.g. Community 2013) + VisualD plugin
|
|
|
|
Install GIT, DUB, DMD.
|
|
|
|
|
|
For Linux and OSX, install MonoDevelop + Mono-D plugin.
|
|
|
|
For Linux / OSX, additionally install libSDL2 and X11 development packages.
|
|
|
|
|
|
Create some folder to place sources, e.g. ~/src/d/
|
|
|
|
Clone DlangUI and DlangIDE repositories into source folder
|
|
|
|
git clone --recursive https://github.com/buggins/dlangui.git
|
|
git clone --recursive https://github.com/buggins/dlangide.git
|
|
|
|
Windows: open solution file with Visual-D
|
|
|
|
dlangui/dlangui-msvc.sln
|
|
|
|
Linux: open solution file with Mono-D
|
|
|
|
dlangide/dlangide-monod-linux.sln
|
|
|
|
OSX: open solution file with Mono-D
|
|
|
|
dlangide/dlangide-monod-osx.sln
|
|
|
|
Choose dlangide as startup project.
|
|
|
|
Coding style: [https://github.com/buggins/dlangui/blob/master/CODING_STYLE.md](https://github.com/buggins/dlangui/blob/master/CODING_STYLE.md)
|