Prepare 1.16.12.7 release

README_OS4.md

@@ -1,9 +1,6 @@
 # Lite XL for AmigaOS 4.1 FE
 
-Lite XL is coming to AmigaOS 4.1.
-
-A few things are not quite working. Please have a look at the "Known issues" 
-section below.
+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* 
@@ -28,6 +25,142 @@ 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 
@@ -36,7 +169,7 @@ https://git.walkero.gr/walkero/lite-xl/issues
 
 # Changelog
 
-## [1.16.12.7] - future
+## [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.
@@ -47,6 +180,8 @@ https://git.walkero.gr/walkero/lite-xl/issues
   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)
 
 ## [1.16.12.6] - 2022-01-04
 ### Fixed

src/platform/amigaos4.h

@@ -4,7 +4,7 @@
 #include <proto/dos.h>
 #include <proto/exec.h>
 
-#define VSTRING     "Lite XL 1.16.12.6 (04.01.2022)"
+#define VSTRING     "Lite XL 1.16.12.7 (11.01.2022)"
 #define VERSTAG     "\0$VER: " VSTRING
 
 static CONST_STRPTR stack USED = "$STACK:102400";
@@ -14,3 +14,4 @@ char *_fullpath(const char *);
 
 
 #endif
+