lite-xl/README.md

69 lines
2.2 KiB
Markdown
Raw Normal View History

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
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
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.