Add README

This commit is contained in:
Nathan Lovato
2020-01-14 21:46:33 +01:00
parent 72de1b30d5
commit d936e5ce09

58
README.md Normal file
View File

@@ -0,0 +1,58 @@
# GDScript mode for Emacs #
This package adds support for the GDScript programming language from the Godot game engine in Emacs. It gives syntax highlighting and indentations.
This is currently a work in progress, and my first time creating an Emacs package. Feedback, tips, and contributions are more than welcome!
## How to install ##
As it is in development, the package is not available yet on Emacs package managers.
To install it:
1. Clone the repository to your computer.
1. In your init.el file, add a call to load and require the package.
```lisp
(add-to-list 'load-path "/path/to/gdscript-mode.el")
(require 'gdscript-mode)
```
### Installing in Spacemacs ###
1. Clone the repository to the `private/local` subdirectory of your `.emacs.d` directory, where you installed spacemacs.
2. Add the package to the `dotspacemacs-additional-packages` and mark is as local. That's Spacemacs' feature to make it easy to load locally installed packages.
```lisp
dotspacemacs-additional-packages '((gdscript-mode :location local))
```
1. In your user-config function, require the package.
```lisp
(defun dotspacemacs/user-config ()
(require 'gdscript-mode))
```
## Planned features ##
1. Fixing the support for indentations.
1. Functions to open the project in Godot.
For auto-competition, we should rely on the GDScript language server coming in Godot 3.2. Another developer is working on it.
## Customization ##
Set the following variables to customize gdscript-mode:
```lisp
(setq gdscript-tabs-mode t) ;; If true, use tabs for indents. Default: t
(setq gdscript-tab-width 4) ;; Controls the width of tab-based indents
```
## Credits ##
This is based on the [gdscript-mode](https://github.com/akoaysigod/gdscript-mode) package that is not in active development anymore.