view.love/README.md

78 lines
2.7 KiB
Markdown
Raw Permalink Normal View History

# A read-only viewer for plain text.
2022-08-14 16:17:53 +00:00
Not very useful by itself, but it's a fork of [lines.love](http://akkartik.name/lines.html)
that you can take in other directions, while easily sharing patches between
forks.
2022-05-30 00:03:01 +00:00
2022-06-07 01:33:44 +00:00
Designed above all to be easy to modify and give you early warning if your
modifications break something.
2023-01-25 02:46:40 +00:00
## Getting started
Install [LÖVE](https://love2d.org). It's just a 5MB download, open-source and
extremely well-behaved. I'll assume below that you can invoke it using the
`love` command, but that might vary depending on your OS.
To run from the terminal, [pass this directory to LÖVE](https://love2d.org/wiki/Getting_Started#Running_Games),
optionally with a file path to edit.
Alternatively, turn it into a .love file you can double-click on:
```
$ zip -r /tmp/view.love *.lua
```
2022-06-07 01:33:44 +00:00
2023-04-22 06:10:09 +00:00
By default, it reads/writes the file `lines.txt` in
2023-04-22 05:53:40 +00:00
[a directory relative to this app](https://love2d.org/wiki/love.filesystem.getSourceBaseDirectory).
2022-06-07 01:33:44 +00:00
2022-08-14 16:17:53 +00:00
To open a different file, drop it on the app window.
2022-06-07 01:33:44 +00:00
## Keyboard shortcuts
While editing text:
* `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
2022-06-17 17:28:25 +00:00
* `alt+right`/`alt+left` to jump to the next/previous word, respectively
2022-11-19 08:11:39 +00:00
* mouse drag or `shift` + movement to select text, `ctrl+a` to select all
* `ctrl+e` to modify the sources
2022-06-07 01:33:44 +00:00
2022-08-14 16:17:53 +00:00
Exclusively tested so far with a US keyboard layout. If
2022-06-07 20:48:59 +00:00
you use a different layout, please let me know if things worked, or if you
2022-06-09 19:16:03 +00:00
found anything amiss: http://akkartik.name/contact
2022-06-07 20:48:59 +00:00
2022-05-30 00:03:01 +00:00
## Known issues
2022-05-21 17:36:27 +00:00
2022-05-18 05:05:00 +00:00
* No support yet for Unicode graphemes spanning multiple codepoints.
2022-05-21 17:36:27 +00:00
2022-07-08 21:16:48 +00:00
* No support yet for right-to-left languages.
* Can't scroll while selecting text with mouse.
* No scrollbars yet. That stuff is hard.
2022-06-07 01:33:44 +00:00
## Mirrors and Forks
2023-01-19 04:30:37 +00:00
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.
2023-01-23 08:36:01 +00:00
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:
2023-01-23 08:36:01 +00:00
* https://git.sr.ht/~akkartik/view.love
* https://repo.or.cz/view.love.git
* https://tildegit.org/akkartik/view.love
* https://git.tilde.institute/akkartik/view.love
2024-03-11 04:37:14 +00:00
* https://git.merveilles.town/akkartik/view.love
* https://github.com/akkartik/view.love
2023-01-23 08:36:01 +00:00
* https://codeberg.org/akkartik/view.love
* https://notabug.org/akkartik/view.love
* https://pagure.io/view.love
2023-06-26 05:46:23 +00:00
* https://nest.pijul.com/akkartik/view.love (using the Pijul version control system)
2022-07-02 22:23:44 +00:00
2022-08-14 16:17:53 +00:00
Further forks are encouraged. If you show me your fork, I'll link to it here.
2022-07-02 22:23:44 +00:00
2022-06-07 01:33:44 +00:00
## Feedback
[Most appreciated.](http://akkartik.name/contact)