232 lines
7.0 KiB
Markdown
232 lines
7.0 KiB
Markdown
# Lite XL for AmigaOS 4.1 FE
|
|
|
|
Lite XL is a lightweight text editor written in Lua.
|
|
|
|
## Installation
|
|
You can extract the Lite XL archive wherever you want and run the *lite*
|
|
editor.
|
|
|
|
## Configuration folder
|
|
This editor creates a `.config` folder where the configuration is saved, as
|
|
well as plugins, themes etc.. By default this AmigaOS 4.1 FE version uses the
|
|
executable folder, but if you want to ovveride it, create an ENV variable
|
|
named `HOME` and set there your path.
|
|
|
|
You can check if there is one already set by executing the following command
|
|
in a shell
|
|
```
|
|
GetEnv HOME
|
|
```
|
|
If there is one set, then you will see the path at the output.
|
|
|
|
Otherwise, you can set your home path be executing the following command.
|
|
Change the path to the one of your preference.
|
|
```
|
|
SetEnv SAVE HOME "Sys:home/"
|
|
```
|
|
|
|
## Addons
|
|
### Colors
|
|
Colors are lua files that set the color scheme of the editor. There are
|
|
light and dark themes for you to choose.
|
|
|
|
To install and use them you have to copy the ones you would like from
|
|
`addons/colors/light` or `addons/colors/dark` into the folder
|
|
`.config/lite-xl/colors/`. Don't add light or dark folders. Just copy the
|
|
.lua files in there.
|
|
|
|
Then you have to start Lite XL and open your configuration by clicking
|
|
at the cog icon at the toolbar (bottom left sixth icon). Go at the line
|
|
that looks like below
|
|
```
|
|
-- core.reload_module("colors.summer")
|
|
```
|
|
and change the `summer` with the name of your color theme. Also, remove
|
|
the two dashes `--` at the start of the line and save the file. If you
|
|
did everything right, the color schema should change instantly.
|
|
|
|
The themes can also be found at
|
|
https://github.com/lite-xl/lite-xl-colors
|
|
|
|
### Plugins
|
|
The Lite XL that you are using on AmigaOS 4 is based on version 1.16.12
|
|
and not the latest version that is available by the development team.
|
|
This means that the latest plugins are not working at all or need some
|
|
modifications to work.
|
|
|
|
To make it easier for you, I gathered some of the plugins that are working
|
|
well, and I included them at the `addons/plugins`. For you to install the
|
|
ones you would like to use, you have to copy the `.lua` files into the
|
|
folder `.config/lite-xl/plugins/` and restart the editor.
|
|
|
|
The included plugins are the following:
|
|
|
|
**autoinsert**
|
|
Automatically inserts closing brackets and quotes. Also allows selected
|
|
text to be wrapped with brackets or quotes.
|
|
|
|
**autowrap**
|
|
Automatically hardwraps lines when typing
|
|
|
|
**bigclock**
|
|
Shows the current time and date in a view with large text
|
|
|
|
**bracketmatch**
|
|
Underlines matching pair for bracket under the caret
|
|
|
|
**colorpreview**
|
|
Underlays color values (eg. `#ff00ff` or `rgb(255, 0, 255)`) with their
|
|
resultant color.
|
|
|
|
**eofnewline**
|
|
Make sure the file ends with one blank line.
|
|
|
|
**ephemeraldocviews**
|
|
Preview tabs. Opening a doc will replace the contents of the preview tab.
|
|
Marks tabs as non-preview on any change or tab double clicking.
|
|
|
|
**ghmarkdown**
|
|
Opens a preview of the current markdown file in a browser window
|
|
|
|
**hidelinenumbers**
|
|
Hides the line numbers on the left of documents
|
|
|
|
**indentguide**
|
|
Adds indent guides
|
|
|
|
**language_make**
|
|
Syntax for the Make build system language
|
|
|
|
**language_sh**
|
|
Syntax for shell scripting language
|
|
|
|
**lfautoinsert**
|
|
Automatically inserts indentation and closing bracket/text after newline
|
|
|
|
**markers**
|
|
Add markers to docs and jump between them quickly
|
|
|
|
**memoryusage**
|
|
Show memory usage in the status view
|
|
|
|
**minimap**
|
|
Shows a minimap on the right-hand side of the docview.
|
|
|
|
**motiontrail**
|
|
Adds a motion-trail to the caret
|
|
|
|
**navigate**
|
|
Allows moving back and forward between document positions, reducing the
|
|
amount of scrolling
|
|
|
|
**rainbowparen**
|
|
Show nesting of parentheses with rainbow colours
|
|
|
|
**restoretabs**
|
|
Keep a list of recently closed tabs, and restore the tab in order on
|
|
cntrl+shift+t.
|
|
|
|
**selectionhighlight**
|
|
Highlights regions of code that match the current selection
|
|
|
|
**todotreeview**
|
|
Todo tree viewer for annotations in code like `TODO`, `BUG`, `FIX`,
|
|
`IMPROVEMENT`
|
|
|
|
## Tips and tricks
|
|
|
|
### Transitions
|
|
|
|
If you want to disable the transitions and make the scrolling a little faster,
|
|
open your configuration by clicking at the cog icon at the toolbar
|
|
(bottom left sixth icon) and add the followline at the end of the file and
|
|
save it.
|
|
|
|
```
|
|
config.transitions = false
|
|
```
|
|
|
|
### Hide files from the file list
|
|
|
|
If you would like to hide files or whole folder from the left side bar list,
|
|
open your configuration by clicking at the cog icon at the toolbar
|
|
(bottom left sixth icon) and add the followline at the end of the file and
|
|
save it. This hides all the files that start with a dot, and all the `.info`
|
|
files.
|
|
|
|
```
|
|
config.ignore_files = {"^%.", "%.info$"}
|
|
```
|
|
|
|
You can add as many rules as you want in there, to hide fore files or
|
|
folders, as you like.
|
|
|
|
|
|
## Know issues
|
|
You can find the known issues at
|
|
https://git.walkero.gr/walkero/lite-xl/issues
|
|
|
|
|
|
# Changelog
|
|
|
|
## [1.16.12.7] - 2022-01-11
|
|
## Added
|
|
- Added config.scroll_past_end that when its true lets the user scroll
|
|
further than the end of the file. By default is set to true.
|
|
- Added "SDL_RENDERER_ACCELERATED" and "SDL_RENDERER_PRESENTVSYNC" on
|
|
SDL_CreateRenderer() since this reduces the CPU usage when the user
|
|
scrolls and seems to work pretty good on my systems (X5000, A1222 and
|
|
microAmigaOne). This is exeprimental. If this brings problems on your
|
|
system, you can disable them using SDL ENV variable, like below:
|
|
setenv SDL_RENDER_VSYNC 0
|
|
setenv SDL_RENDER_DRIVER "software"
|
|
- Added plugins and color schemas in addons folder and information at
|
|
the README_OS4 file (#10)
|
|
|
|
## Changed
|
|
- Compiled Lite XL with gcc 8.4.0
|
|
|
|
## [1.16.12.6] - 2022-01-04
|
|
### Fixed
|
|
- Fixed a problem introduced in previous version when LiteXL was executed
|
|
from the root path of a partition or from ram disk (#13)
|
|
|
|
## [1.16.12.5] - 2022-01-03
|
|
### Changed
|
|
- Changed the Gfx memory leak solution to a fix that was applied by the
|
|
editor development team on Lua scripts at a later version. Less custom
|
|
code for AmigaOS 4 port.
|
|
- Now, when return from fullscreen, there is no extra header visible
|
|
at the top of the window content
|
|
|
|
### Fixed
|
|
- Fixed the assertion error and crash when the window is resized (#2)
|
|
- Fixed the resolution on fullscreen toggle to be like the workbench (#4)
|
|
- Fixed loading the current folder from terminal using the dot, like
|
|
`lite .` or without it (#3)
|
|
|
|
## [1.16.12.4] - 2021-12-31
|
|
### Fixed
|
|
- Fixed the Gfx memory leak. Now LiteXL frees the reserved memory from the
|
|
gfx card.
|
|
|
|
## [1.16.12.3] - 2021-12-29
|
|
### Changed
|
|
- Compiled with an experimental version of the latest Anti-Grain Geometry
|
|
library. This is might have issues and crash LiteXL
|
|
|
|
## [1.16.12.2] - 2021-12-26
|
|
### Added
|
|
- Added Amiga version. This version of LiteXL is based on v1.16.12 source code
|
|
which will not change. I will use the fourth digit to distinguish different
|
|
AmigaOS 4 releases, until a new port of the latest available source (v2.x)
|
|
is made.
|
|
|
|
### Fixed
|
|
- The keyboard shortcuts are now working
|
|
|
|
### Changed
|
|
- Now the `HOME` ENV variable is optional. If this is not set, the LiteXL
|
|
folder will be used to create user's `.config` folder
|
|
|