readme improvements (#101)

This commit is contained in:
liquidev 2021-03-13 16:20:36 +01:00 committed by GitHub
parent c0ad86de8c
commit 97f8442195
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 40 additions and 37 deletions

View File

@ -2,7 +2,7 @@
![screenshot-dark](https://user-images.githubusercontent.com/433545/85227778-b42abc80-b3df-11ea-9dd3-e788f6c71882.png) ![screenshot-dark](https://user-images.githubusercontent.com/433545/85227778-b42abc80-b3df-11ea-9dd3-e788f6c71882.png)
A lightweight text editor written in Lua, adapted from [Lite](https://github.com/rxi/lite) A lightweight text editor written in Lua, adapted from [lite](https://github.com/rxi/lite)
* **[Get Lite XL](https://github.com/franko/lite-xl/releases/latest)** — Download * **[Get Lite XL](https://github.com/franko/lite-xl/releases/latest)** — Download
for Windows and Linux for Windows and Linux
@ -12,42 +12,47 @@ A lightweight text editor written in Lua, adapted from [Lite](https://github.com
* **[Get color themes](https://github.com/rxi/lite-colors)** — Add additional colors * **[Get color themes](https://github.com/rxi/lite-colors)** — Add additional colors
themes themes
Please note that Lite XL is compatible with Lite for all the plugins and color themes. Please note that Lite XL is compatible with lite for most plugins and all color themes.
Yet we provide a specific lite-plugins directory for Lite XL because in some cases some adaptations may be needed to make them work better with Lite XL. We provide a separate lite-plugins repository for Lite XL, because in some cases some adaptations may be needed to make them work better with Lite XL.
The address for modified plugins is http://github.com/franko/lite-plugins. The repository with modified plugins is http://github.com/franko/lite-plugins.
Currently only the "workspace" plugin needs a minor adjustment to restore the workspace when the command `core:restart` is used.
The changes and differences between Lite XL and rxi/lite are listed in the [changelog](https://github.com/franko/lite-xl/blob/master/changelog.md). The changes and differences between Lite XL and rxi/lite are listed in the [changelog](https://github.com/franko/lite-xl/blob/master/changelog.md).
## Overview ## Overview
Lite XL is derived from Lite. It is a lightweight text editor written mostly in Lua — it aims to provide Lite XL is derived from lite. It 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. 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. The aim of Lite XL compared to lite is to be more user friendly, improve the quality of font rendering, and reduce CPU usage.
## Customization ## Customization
Additional functionality can be added through plugins which are available from Additional functionality can be added through plugins which are available in
the [plugins repository](https://github.com/rxi/lite-plugins) or from the [plugin repository adapted to Lite XL](https://github.com/franko/lite-plugins); additional color the [plugins repository](https://github.com/rxi/lite-plugins) or in the [Lite XL-specific plugins repository](https://github.com/franko/lite-plugins).
themes can be found in the [colors repository](https://github.com/rxi/lite-colors).
The editor can be customized by making changes to the Additional color themes can be found in the [colors repository](https://github.com/rxi/lite-colors).
[user module](data/user/init.lua). These color themes are bundled with all releases of Lite XL by default.
The editor can be customized by making changes to the [user module](data/user/init.lua).
## Building ## Building
You can build the project yourself using the Meson build. You can build Lite XL yourself using Meson.
In addition the script `build-packages.sh` can be used to compile Lite XL and create a package adapted to the OS, Linux, Windows or Mac OS X. In addition, the `build-packages.sh` script can be used to compile Lite XL and create an OS-specific package for Linux, Windows or macOS.
The following libraries are required: The following libraries are required:
- freetype2 - freetype2
- SDL2 - SDL2
The libraries libagg and Lua 5.2 are optional. The following libraries are optional:
If they are not found they will be automatically downloaded and compiled by the Meson build system.
Otherwise, if they are present they will be used to compile Lite XL.
On a debian based systems the required library and Meson can be installed using the commands: - libagg
- Lua 5.2
If they are not found, they will be downloaded and compiled by Meson.
Otherwise, if they are present, they will be used to compile Lite XL.
On Debian-based systems the required libraries and Meson can be installed using the following commands:
```sh ```sh
# To install the required libraries: # To install the required libraries:
@ -65,43 +70,41 @@ meson compile -C build
meson install -C build meson install -C build
``` ```
When performing the "meson setup" command you may enable the "portable" option to choose the When performing the `meson setup` command you may enable the `-Dportable=true` option to specify whether a portable build should be done.
kind of install.
If the portable option latter is enabled Lite XL is built to use a "data" and a "user" directory If `portable` is enabled, Lite XL is built to use `data` and `user` directories placed next to the executable.
from the same directory of the executable. Otherwise, Lite XL will use Unix-like directory locations.
If "portable" is not enabled (this is the default) Lite XL will use unix-like In this case, the `data` directory will be located in `$prefix/share/lite-xl`, and the `user`
directory locations.
In this case the "data" directory will be `$prefix/share/lite-xl` and the "user"
directory will be `$HOME/.config/lite-xl`. directory will be `$HOME/.config/lite-xl`.
The `$prefix` is determined as the directory such as `$prefix/bin` corresponds to `$prefix` is determined such that `$prefix/bin` corresponds to the location of the executable.
the location of the executable. `$HOME` is determined from the corresponding environment variable.
The `$HOME` is determined from the corresponding environment variable.
As a special case on Windows the variable `$USERPROFILE` will be used instead. As a special case on Windows the variable `$USERPROFILE` will be used instead.
If you compile lite-xl yourself it is recommended to use the script `build-packages.sh`: If you compile Lite XL yourself, it is recommended to use the script `build-packages.sh`:
```sh ```sh
bash build-packages.sh <arch> bash build-packages.sh <arch>
``` ```
It will run meson and create two zip files, one for the portable version and The script will run Meson and create two .zip files, one for the portable version, and
one for the unix-like version. Lite XL can be easily installed by unpacking one another one for the Unix-like version. Lite XL can be easily installed by unpacking one
of the zip archive in a directory of your choice. of these .zip archives in some directory of your choice.
Please note that no directory is not hard-coded in the exectuable so that the Please note that there aren't any hard-coded directories in the executable, so that the
package can be extracted and used in any directory. package can be extracted and used in any directory.
Note also that the unix-like package can work on windows as well. Note that the Unix-like package can also work on Windows.
Please note that while compiling Lite XL on Mac OS X should work Mac OS X is not Please note that while compiling Lite XL on macOS should work, macOS is not officially supported.
officially supported.
## Contributing ## Contributing
Any additional functionality that can be added through a plugin should be done Any additional functionality that can be added through a plugin should be done
so as a plugin, after which a pull request to the as a plugin, after which a pull request to the
[plugins repository](https://github.com/rxi/lite-plugins) can be made. [plugins repository](https://github.com/rxi/lite-plugins) can be made.
If the plugin uses any Lite XL-specific functionality, please open a pull request to the
[Lite XL plugins repository](https://github.com/franko/lite-plugins).
Pull requests to improve or modify the editor itself are welcome. Pull requests to improve or modify the editor itself are welcome.
## License ## License