05bf3ca362
|
||
|---|---|---|
| assets | ||
| 0000-freewheeling-start | ||
| 0001-on | ||
| 0002-Debug_animations_in_progress | ||
| 0002-Editors | ||
| 0003-on.key_release | ||
| 0003-refresh_debug_animations | ||
| 0004-Cursor_editor | ||
| 0004-on.update | ||
| 0005-animate | ||
| 0005-on.mouse_release | ||
| 0006-loiter | ||
| 0006-on.mouse_press | ||
| 0007-on.text_input | ||
| 0007-save_callstack | ||
| 0008-Debug_animation_period | ||
| 0008-Filename | ||
| 0009-Font_height | ||
| 0010-Screen_top | ||
| 0011-on.save_settings | ||
| 0012-on.load_settings | ||
| 0013-on.resize | ||
| 0014-on.keychord_press | ||
| 0015-on.draw | ||
| 0016-resync_editors | ||
| 0017-on.file_drop | ||
| 0018-on.initialize | ||
| 0019-initialize_editors | ||
| LICENSE.txt | ||
| Manual_tests.md | ||
| MemoryReferenceInfo.lua.0 | ||
| MemoryReferenceInfo.lua.unused | ||
| README.md | ||
| app.lua | ||
| button.lua | ||
| default_map | ||
| edit.lua | ||
| file.lua | ||
| json.lua | ||
| keychord.lua | ||
| live.lua | ||
| main.lua | ||
| nativefs.lua | ||
| reference.md | ||
| search.lua | ||
| select.lua | ||
| test.lua | ||
| text.lua | ||
| text_tests | ||
| text_tests.lua | ||
| undo.lua | ||
README.md
A wide-screen reading app
Use all available width to read (no editing).
This repo is an example of a Freewheeling App, designed above all to be easy to run, easy to modify and easy to share.
Getting started
Install LÖVE. It's just a 5MB download, open-source and extremely well-behaved.
To run from the terminal, pass this directory to LÖVE, optionally with a file path to edit.
$ path/to/love path/to/broadsheet.love path/to/file
Alternatively, turn it into a .love file you can double-click on:
$ zip -r /tmp/broadsheet.love *.lua
To load a file, drop it on the broadsheet.love window.
When restarting, broadsheet.love will load the file from the previous session by default.
Hacking
To modify it live without restarting the app each time, download the driver app. Here's an example session with a different freewheeling app:
Some reference documentation on how to create your own apps.
If the app being modified by the driver lives in a .love file, your changes will go into the save directory. If it lives in a directory (like this repo), your changes will go straight into the same directory.
Keyboard shortcuts
pgUp/pgDnto scrollctrl+fto find patterns within a filectrl+=to zoom in,ctrl+-to zoom out,ctrl+0to reset zoom- mouse drag or
shift+ movement to select text,ctrl+ato select all,ctrl+cto copy selection to clipboard
Known issues
-
No support yet for Unicode graphemes spanning multiple codepoints.
-
No support yet for right-to-left languages.
-
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, an editor for plain text where you can also seamlessly insert line drawings. Its immediate upstream is the template repo for freewheeling apps. Updates to it can be downloaded from:
- https://git.sr.ht/~akkartik/broadsheet.love
- https://tildegit.org/akkartik/broadsheet.love
- https://git.merveilles.town/akkartik/broadsheet.love
- https://nest.pijul.com/akkartik/broadsheet.love (using the Pijul version control system)
Further forks are encouraged. If you show me your fork, I'll link to it here.