2020-06-21 17:11:01 +02:00
|
|
|
# Lite XL
|
2019-12-28 12:16:32 +01:00
|
|
|
|
2020-06-21 17:11:01 +02:00
|
|
|
![screenshot-dark](https://user-images.githubusercontent.com/433545/85227778-b42abc80-b3df-11ea-9dd3-e788f6c71882.png)
|
2019-12-28 12:16:32 +01:00
|
|
|
|
2020-06-21 17:11:01 +02:00
|
|
|
A lightweight text editor written in Lua, adapted from [Lite](https://github.com/rxi/lite)
|
|
|
|
|
2020-06-21 23:54:51 +02:00
|
|
|
* **[Get lite](https://github.com/franko/lite-xl/releases/latest)** — Download
|
2020-05-08 21:07:15 +02:00
|
|
|
for Windows and Linux
|
|
|
|
* **[Get plugins](https://github.com/rxi/lite-plugins)** — Add additional
|
|
|
|
functionality
|
|
|
|
* **[Get color themes](https://github.com/rxi/lite-colors)** — Add additional colors
|
|
|
|
themes
|
|
|
|
|
2020-06-28 18:28:00 +02:00
|
|
|
The differences between Lite XL and rxi/lite are listed in the [changelog](https://github.com/franko/lite-xl/blob/master/changelog.md).
|
|
|
|
|
2019-12-28 12:16:32 +01:00
|
|
|
## Overview
|
2020-06-21 17:11:01 +02:00
|
|
|
Lite XL is a lightweight text editor written mostly in Lua — it aims to provide
|
|
|
|
something practical, pretty, *small* and fast easy to modify and extend, or to use without doing either.
|
|
|
|
|
|
|
|
The aim of Lite XL compared to Lite is to be more user friendly, improve the quality of the font rendering and reduce CPU usage.
|
2019-12-28 12:16:32 +01:00
|
|
|
|
2020-05-08 21:07:15 +02:00
|
|
|
## Customization
|
|
|
|
Additional functionality can be added through plugins which are available from
|
|
|
|
the [plugins repository](https://github.com/rxi/lite-plugins); additional color
|
|
|
|
themes can be found in the [colors repository](https://github.com/rxi/lite-colors).
|
|
|
|
The editor can be customized by making changes to the
|
|
|
|
[user module](data/user/init.lua).
|
2019-12-28 12:16:32 +01:00
|
|
|
|
|
|
|
## Building
|
2020-05-09 12:01:28 +02:00
|
|
|
You can build the project yourself on Linux using the provided `build.sh`
|
2020-06-21 17:11:01 +02:00
|
|
|
script or using the Meson build.
|
|
|
|
|
|
|
|
The following libraries are required:
|
|
|
|
|
|
|
|
- freetype2
|
|
|
|
- libagg
|
|
|
|
- SDL2
|
|
|
|
- Lua 5.2
|
|
|
|
|
|
|
|
On a debian based system the required library and Meson can be installed using the commands:
|
2019-12-28 12:16:32 +01:00
|
|
|
|
2020-06-21 17:11:01 +02:00
|
|
|
```sh
|
|
|
|
# To install the required libraries:
|
|
|
|
sudo apt install libfreetype6-dev libagg-dev libsdl2-dev liblua5.2-dev
|
|
|
|
|
|
|
|
# To install Meson:
|
|
|
|
sudo apt install meson
|
|
|
|
# or pip3 install --user meson
|
|
|
|
```
|
|
|
|
To build Lite XL with Meson use the commands:
|
|
|
|
```sh
|
|
|
|
# configure
|
|
|
|
meson setup build
|
|
|
|
|
|
|
|
# build
|
|
|
|
ninja -C build
|
|
|
|
|
|
|
|
# install
|
|
|
|
ninja -C build install
|
|
|
|
```
|
2019-12-28 12:16:32 +01:00
|
|
|
## Contributing
|
|
|
|
Any additional functionality that can be added through a plugin should be done
|
2019-12-28 12:21:45 +01:00
|
|
|
so as a plugin, after which a pull request to the
|
2020-06-21 17:11:01 +02:00
|
|
|
[plugins repository](https://github.com/rxi/lite-plugins) can be made.
|
|
|
|
|
|
|
|
Pull requests to improve or modify the editor itself are welcome.
|
2019-12-28 12:16:32 +01:00
|
|
|
|
|
|
|
## License
|
|
|
|
This project is free software; you can redistribute it and/or modify it under
|
|
|
|
the terms of the MIT license. See [LICENSE](LICENSE) for details.
|