Pragtical plugins¶

Pragtical can use plugins to extend its features. Those can be found
at https://github.com/pragtical/plugins and other websites. Not all
of them will work fine on AmigaOS 4 or MorphOS, because of missing
dependencies or filesystem issues.

To make it easier for you, I gathered some of the plugins that are working
well, and I included them under addons/plugins. For you to install the
ones you would like to use, you have to copy the .lua files into the
folder .config/pragtical/plugins/ and restart the editor.

Please, choose wisely because adding all the plugins might make the editor
slower on your system. I would recommend you add only those that you really
need.

The included plugins are the following:

amimodkeys
This plugin enables the Right Amiga and Right Alt to behave like Control,
for those that are used to using them.

autoinsert
Automatically inserts closing brackets and quotes. Also allows selected
text to be wrapped with brackets or quotes.

autosaveonfocuslost
Automatically saves files that were changed when the main window loses
focus by switching to another application

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.

custom_caret
Customize the caret in the editor, setting it to underline, block or
line in the init.lua file in your config folder.
For example, add:
config.plugins.custom_caret.shape = "block"

dragdropselected
Provides drag and drop of selected text (in same document)

EditorConfig
EditorConfig (https://editorconfig.org/) implementation for Pragtical

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

exterm
Allows to open an external console in current project directory

ghmarkdown
Opens a preview of the current markdown file in a browser window.
On AmigaOS 4 it uses urlopen and on MorphOS it uses openurl to load
the generated HTML in the browser. It requires a GitHub application token
because it uses its Rest API. Add it to the init.lua file in your config
folder like below:
config.plugins.ghmarkdown.github_token = "<token here>"

indentguide
Adds indent guides

keyhud
Simple key HUD display for pragtical.

language_cmake
Syntax for the CMake build system language

language_glsl
Syntax for the GLSL programming language

language_guide
Syntax for the AmigaGuide scripting language

language_hws
Syntax for the Hollywood language

language_ignore
Syntax for .gitignore, .dockerignore and some other .*ignore files

language_json
Syntax for the JSON language

language_make
Syntax for the Make build system language

language_sh
Syntax for shell scripting language

language_yaml
Syntax for YAML serialization 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. Please note that
this plugin will make the editor slower on file loading and scrolling.

navigate
Allows moving back and forward between document positions, reducing the
amount of scrolling

nonicons
File icons set for TreeView. Download TTF font to your config/fonts
folder from https://github.com/yamatsum/nonicons/tree/master/dist

opacity
Change the opaqueness/transparency of pragtical using LAmiga+mousewheel
or a command.

openfilelocation
Opens the parent directory of the current file in the file manager

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

smallclock
It adds a small clock in the bottom-right corner.

sort
Sorts selected lines alphabetically

sortcss
Sort selected CSS properties alphabetically or using the concentric model.

sticky_scroll
Keep track of the current scope at the top of the view

tab_switcher
Switch between open tabs by searching by name

tetris
Play Tetris inside Pragtical.

titleize
Titleizes selected string (hello world => Hello World)

todotreeview
Todo tree viewer for annotations in code like TODO, BUG, FIX,
IMPROVEMENT

togglesnakecamel
Toggles symbols between snake_case and camelCase

typingspeed
Displays your current typing speed in characters and words per minute in the status bar

unboundedscroll
Allows scrolling outside the bounds of a document

wordcount
Adds in a word count to the statusview

Disclaimer¶

YOU MAY USE IT AT YOUR OWN RISK!

I will not be held responsible for any data loss or problems you might get
by using this software.