89 lines
3.6 KiB
Markdown
89 lines
3.6 KiB
Markdown
# Example "freewheeling" app that can be modified without being restarted
|
|
|
|
Running this repo in isolation won't be very helpful. If you haven't yet,
|
|
first check out [the driver app](https://git.sr.ht/~akkartik/driver.love).
|
|
This repo is a template you can copy to create your own live apps that juggle
|
|
text editor widgets. The editors support copy/paste, search, infinite undo,
|
|
etc. You can't modify editor functionality live (yet?).
|
|
|
|
[More information about the on-disk representation of freewheeling apps.](representation.md)
|
|
|
|
This repo is a fork of [lines.love](http://akkartik.name/lines.html), an
|
|
editor for plain text where you can also seamlessly insert line drawings.
|
|
Designed above all to be easy to modify and give you early warning if your
|
|
modifications break something.
|
|
|
|
## Invocation
|
|
|
|
Run this app from the terminal, [passing its directory to LÖVE](https://love2d.org/wiki/Getting_Started#Running_Games)
|
|
|
|
To modify it live without restarting the app each time, install [the driver
|
|
app](https://git.sr.ht/~akkartik/driver.love). Here's an example session
|
|
using a fork of this repo:
|
|
|
|
![making changes without restarting the app](assets/2.gif)
|
|
|
|
## Keyboard shortcuts
|
|
|
|
Up to you! But within the included editor widget if you use it:
|
|
|
|
* `ctrl+f` to find patterns within a file
|
|
* `ctrl+c` to copy, `ctrl+x` to cut, `ctrl+v` to paste
|
|
* `ctrl+z` to undo, `ctrl+y` to redo
|
|
* `ctrl+=` to zoom in, `ctrl+-` to zoom out, `ctrl+0` to reset zoom
|
|
* `alt+right`/`alt+left` to jump to the next/previous word, respectively
|
|
* mouse drag or `shift` + movement to select text, `ctrl+a` to select all
|
|
|
|
Exclusively tested so far with a US keyboard layout. If
|
|
you use a different layout, please let me know if things worked, or if you
|
|
found anything amiss: http://akkartik.name/contact
|
|
|
|
## Known issues
|
|
|
|
* Both freewheeling apps and the driver for them currently benefit from being
|
|
launched in terminal windows rather than by being clicked on in a desktop
|
|
OS. See [the driver app](https://git.sr.ht/~akkartik/driver.love/src/branch/main/README.md)
|
|
for details.
|
|
|
|
* No support yet for Unicode graphemes spanning multiple codepoints.
|
|
|
|
* No support yet for right-to-left languages.
|
|
|
|
* Undo/redo may be sluggish in large files. Large files may grow sluggish in
|
|
other ways. Works well in all circumstances with files under 50KB.
|
|
|
|
* If you kill the process, say by force-quitting because things things get
|
|
sluggish, you can lose data.
|
|
|
|
* Long wrapping lines can't yet distinguish between the cursor at end of one
|
|
screen line and start of the next, so clicking the mouse to position the
|
|
cursor can very occasionally do the wrong thing.
|
|
|
|
* Can't scroll while selecting text with mouse.
|
|
|
|
* No scrollbars yet. That stuff is hard.
|
|
|
|
## Mirrors and Forks
|
|
|
|
This repo is a fork of [lines.love](http://akkartik.name/lines.html), an
|
|
editor for plain text where you can also seamlessly insert line drawings.
|
|
Its immediate upstream is [text.love](https://git.sr.ht/~akkartik/text.love),
|
|
a version without support for line drawings. Updates to it can be downloaded
|
|
from the following mirrors:
|
|
|
|
* https://git.sr.ht/~akkartik/template-live-editor
|
|
* https://codeberg.org/akkartik/template-live-editor
|
|
|
|
Further forks are encouraged. If you show me your fork, I'll link to it here.
|
|
|
|
* https://git.sr.ht/~akkartik/luaML.love - a "browser" for a Lua-based
|
|
markup language, loosely analogous to HTML except it's all Lua.
|
|
* https://git.sr.ht/~akkartik/bf.love - a toy environment for working with
|
|
[BF](https://en.wikipedia.org/wiki/Brainfuck) programs.
|
|
* https://git.sr.ht/~akkartik/broadsheet.love - a multi-column paginator that
|
|
uses all available width while remaining readable.
|
|
|
|
## Feedback
|
|
|
|
[Most appreciated.](http://akkartik.name/contact)
|