Skip to content

Commit

Permalink
*
Browse files Browse the repository at this point in the history
  • Loading branch information
@rekkabell
rekkabell committed Dec 11, 2024
1 parent c489bec commit c4b0ee7
Show file tree
Hide file tree
Showing 4 changed files with 148 additions and 200 deletions.
98 changes: 34 additions & 64 deletions site/left.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -49,12 +49,9 @@ <h1>left</h1>
<li><a href='#tutorial'>Tutorial</a></li>
<li><a href='#rename'>Rename</a></li>
<li><a href='#snarf'>Snarf</a></li>
<li><a href='#leap'>Leaping through the text</a></li>
<li><a href='#word'>Finding a word</a></li>
<li><a href='#directory'>Director</a></li>
<li><a href='#counter'>Counter</a></li>
<li><a href='#directory'>Directory</a></li>
<li><a href='#saving'>Saving</a></li>
<li><a href='#linebreak'>Line break</a></li>
</ul>

<img src='../media/content/stream/2024_leftfont.jpg' title='uxn version of left' loading='lazy' />
Expand All @@ -63,7 +60,7 @@ <h1>left</h1>

<p>Left is graphical plain-text editor written in <a href='https://wiki.xxiivv.com/site/uxntal.html' target='_blank'>Uxntal</a>. Left doesn't do much, but packs many useful features in a tiny 13kb rom.</p>

<p>It supports Uxntal syntax highlight, proportional text, inline images and the snarf buffer. The alt key is used as a LEAP key to navigate the body of the text. This version is updated regularly.</p>
<p>It supports Uxntal syntax highlight, proportional text, inline images and the snarf buffer. This version is updated regularly.</p>

<p>To view the documentation for the former version of Left, see <a href='left_electron.html' class='local'>left electron</a>. Both the Uxn and Electron versions are available on itch.io.</p>

Expand All @@ -86,19 +83,36 @@ <h2><a id='setup'>Getting Started</a></h2>
<h3><a id='controls'>Controls</a></h3>

<dl class="col2 shortcut-list" aria-labelledby='controls'>
<div><kbd class='shortcut'><dt>alt + mouse2</dt></kbd><dd>find from top</dd></div>
<div><kbd class='shortcut'><dt>ctrl + mouse2</dt></kbd><dd>cut and find</dd></div>
<div><kbd class='shortcut'><dt>backspace/delete</dt></kbd><dd>erase</dd></div>
<div><kbd class='shortcut'><dt>escape</dt></kbd><dd>deselect</dd></div>
<div><kbd class='shortcut'><dt>arrow</dt></kbd><dd>move</dd></div>
<div><kbd class='shortcut'><dt>ctrl + up</dt></kbd><dd>next label</dd></div>
<div><kbd class='shortcut'><dt>ctrl + down</dt></kbd><dd>prev label</dd></div>
<div><kbd class='shortcut'><dt>ctrl + left</dt></kbd><dd>end of line</dd></div>
<div><kbd class='shortcut'><dt>ctrl + right</dt></kbd><dd>start of line</dd></div>
<div><kbd class='shortcut'><dt>alt + left</dt></kbd><dd>next word</dd></div>
<div><kbd class='shortcut'><dt>alt + right</dt></kbd><dd>prev word</dd></div>
<div><kbd class='shortcut'><dt>shift + arrow</dt></kbd><dd>scale selection</dd></div>
<div><kbd class='shortcut'><dt>ctrl + n</dt></kbd><dd>new</dd></div>
<div><kbd class='shortcut'><dt>ctrl + r</dt></kbd><dd>rename</dd></div>
<div><kbd class='shortcut'><dt>ctrl + o</dt></kbd><dd>open</dd></div>
<div><kbd class='shortcut'><dt>ctrl + s</dt></kbd><dd>save</dd></div>
<div><kbd class='shortcut'><dt>ctrl + p</dt></kbd><dd>send</dd></div>
<div><kbd class='shortcut'><dt>ctrl + b</dt></kbd><dd>build</dd></div>
<div><kbd class='shortcut'><dt>ctrl + q</dt></kbd><dd>exit</dd></div>
<div><kbd class='shortcut'><dt>ctrl + c</dt></kbd><dd>copy</dd></div>
<div><kbd class='shortcut'><dt>ctrl + v</dt></kbd><dd>paste</dd></div>
<div><kbd class='shortcut'><dt>ctrl + s + v</dt></kbd><dd>paste binary</dd></div>
<div><kbd class='shortcut'><dt>ctrl + x</dt></kbd><dd>cut</dd></div>
<div><kbd class='shortcut'><dt>backspace</dt></kbd><dd>erase</dd></div>
<div><kbd class='shortcut'><dt>delete</dt></kbd><dd>delete</dd></div>
<div><kbd class='shortcut'><dt>ctrl + /</dt></kbd><dd>go to directory</dd></div>
<div><kbd class='shortcut'><dt>ctrl + enter</dt></kbd><dd>go to selection</dd></div>
<div><kbd class='shortcut'><dt>ctrl + t</dt></kbd><dd>strip</dd></div>
<div><kbd class='shortcut'><dt>ctrl + i</dt></kbd><dd>trim</dd></div>
<div><kbd class='shortcut'><dt>ctrl + y</dt></kbd><dd>clip</dd></div>
<div><kbd class='shortcut'><dt>ctrl + j</dt></kbd><dd>join</dd></div>
<div><kbd class='shortcut'><dt>tab</dt></kbd><dd>tab</dd></div>
<div><kbd class='shortcut'><dt>s + tab</dt></kbd><dd>untab</dd></div>
<div><kbd class='shortcut'><dt>ctrl + tab</dt></kbd><dd>select word</dd></div>
<div><kbd class='shortcut'><dt>ctrl + g</dt></kbd><dd>select symbol</dd></div>
<div><kbd class='shortcut'><dt>s</dt></kbd><dd>select line start</dd></div>
<div><kbd class='shortcut'><dt>ctrl + a</dt></kbd><dd>select all</dd></div>
<div><kbd class='shortcut'><dt>escape</dt></kbd><dd>select reset</dd></div>
<div><kbd class='shortcut'><dt>ctrl + f</dt></kbd><dd>find selection</dd></div>
<div><kbd class='shortcut'><dt>ctrl + h</dt></kbd><dd>View hint</dd></div>
<div><kbd class='shortcut'><dt>ctrl + spc</dt></kbd><dd>Symbol</dd></div>
<div><kbd class='shortcut'><dt>ctrl + l</dt></kbd><dd>Categories</dd></div>
</dl>

<h2 id='tutorial'>Tutorial</h2>
Expand All @@ -119,51 +133,15 @@ <h3><a id='snarf'>Snarf</a></h3>

<hr />

<h3><a id='leap'>Leap</a></h3>

<p>The <kbd class='shortcut'>alt</kbd> key is used as a <a href='https://www.youtube.com/watch?v=o_TlE_U_X3c' target='_blank'>LEAP key</a>(YouTube) to navigate the body of the text.</p>

<hr />


<h3><a id='word'>Finding a word</a></h3>

<p>Finding a word is done by holding down the <kbd class='shortcut'>alt key</kbd>, and typing characters, and releasing <kbd class='shortcut'>alt</kbd> to jump. Alternatively, you can select a word with <kbd class='shortcut'>mouse2</kbd>, and jump to the next instance with <kbd class='shortcut'>mouse3</kbd>.</p>

<dl class="shortcut-list">
<div><kbd class='shortcut'><dt>1</dt></kbd><dd>select character</dd></div>
<div><kbd class='shortcut'><dt>2</dt></kbd><dd>select word</dd></div>
<div><kbd class='shortcut'><dt>3</dt></kbd><dd>find</dd></div>
</dl>
<p>Find multiple occurences of a word by selecting one, and pressing <kbd class='shortcut'>ctrl + f</kbd>. A menu will appear on the left side showing the various occurences of the selected word, scroll through the list using <kbd class='shortcut'>alt + (up or down)arrows</kbd>. To leave the word finding mode press <kbd class='shortcut'>escape</kbd>.</p>

<hr />

<h3><a id='directory'>Directory</a></h3>

<p>A listing of the files in the active directory can be seen by the sequence <kbd class='shortcut'>ctrl + r del</kbd> , a file from that listing can be opened by the sequence <kbd class='shortcut'>mouse2 ctrl + g</kbd>.</p>

<dl class="col2 shortcut-list">
<div><kbd class='shortcut'><dt>ctrl + n</dt></kbd><dd>new</dd></div>
<div><kbd class='shortcut'><dt>ctrl + s</dt></kbd><dd>save</dd></div>
<div><kbd class='shortcut'><dt>ctrl + o</dt></kbd><dd>open</dd></div>
<div><kbd class='shortcut'><dt>ctrl + g</dt></kbd><dd>open selection</dd></div>
<div><kbd class='shortcut'><dt>ctrl + r</dt></kbd><dd>rename</dd></div>
<div><kbd class='shortcut'><dt>ctrl + c</dt></kbd><dd>copy</dd></div>
<div><kbd class='shortcut'><dt>ctrl + v</dt></kbd><dd>paste</dd></div>
<div><kbd class='shortcut'><dt>ctrl + x</dt></kbd><dd>cut</dd></div>
<div><kbd class='shortcut'><dt>ctrl + h</dt></kbd><dd>toggle syntax</dd></div>
<div><kbd class='shortcut'><dt>ctrl + f</dt></kbd><dd>toggle font</dd></div>
</dl>

<hr />

<h3><a id='counter'>Counter</a></h3>

<img src='../media/content/projects/left_04.png' class='detail'/>

<p>At the top right corner of the window, there are 4 sets of digits (can be either numbers, or letters). Depending on what is selected, this number will mean different things.</p>

<p>If moving forward or backward with the arrow keys, the number will indicate the position of the cursor and of the character in the window. If selecting a bit of text, the number will count up the number of characters in the selection.</p>
<p>A listing of the files in the active directory can be seen by the sequence <kbd class='shortcut'>ctrl + /</kbd>. To open a file, select a word and press <kbd class='shortcut'>ctrl + enter</kbd>.</p>

<hr />

Expand All @@ -173,15 +151,7 @@ <h3><a id='saving'>Saving a file</a></h3>

<p>To save a file, press <kbd class='shortcut'>ctrl + s</kbd>.</p>

<p>At the top left corner of the window is a diamond shape, it changes color to indicate whether or not you have unsaved changes.</p>
<hr />

<h3 id='linebreak'>Linebreak</h3>

<img src='../media/content/projects/left_05.png' class='detail'/>

<p>If you skip a line, a diamond shape will mark the line break.</p>

<p>At the top left corner of the window is a diamond shape, it changes color to indicate whether or not you have unsaved changes. Teal means unsaved, black means saved.</p>
<hr />

<img src='../media/interface/left.turnip.png' title='Hello, I am the baby form of Lefbit' alt='De-evolved Lefbit' style='width: 185px;margin: 0px auto; margin-bottom: 0px;display: block;margin-bottom: 30px;'/>
Expand Down
76 changes: 40 additions & 36 deletions site/left_electron.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ <h2 id='download'>download</h2>

<p>Both the Uxn and Electron versions are available on itch.io.</p>

<iframe frameborder='0' src='https://itch.io/embed/173127?link_color=000000' width='600' height='167'></iframe>
<a class='button' href='https://hundredrabbits.itch.io/left/purchase?popup=1'>Download Left</a>

<h2 id='tutorial'>tutorial</h2>
<p>Launch the app. You'll see a <b>main window</b>, as well as a <b>sidebar</b> on the left. You'll be writing in the main window, the sidebar will list all of the <b>markers</b> and <b>separate files</b> that you create.</p>
Expand All @@ -72,69 +72,73 @@ <h2 id='tutorial'>tutorial</h2>
<li>V for vocabulary</li>
<li>C for character.</li>
</ul>

<p>As you write, these numbers will increase and you'll know exactly how many lines, words, characters and unique words there are in your text. These stats are followed by a <b>percentage</b> to show you where you are in the text, with 0% indicating the beginning, and 100% the end - this is useful when writing large texts.</p>

<h2 id='creating_a_new_file'>creating a new file</h2>
<p>Create a new file with <b>⌘ n</b> (most of the shorts using 'command' combined with a letter or other character).</p>
<p>The main window will now be empty. If you look on the sidebar you will see the <b>splash</b> listed, you can return to it by selecting it or by using <b>⌘ ]</b> and <b>⌘ [</b>.</p>
<p>The file you created, by default is named 'untitled', you can rename it by saving the file using <b>⌘ n</b>.</p>

<p>Create a new file with <kbd class='shortcut'>⌘ + n</kbd> (most of the shorts using 'command' combined with a letter or other character).</p>
<p>The main window will now be empty. If you look on the sidebar you will see the <b>splash</b> listed, you can return to it by selecting it or by using <kbd class='shortcut'>⌘ + ]</kbd> and <kbd class='shortcut'>⌘ + [</kbd>.</p>
<p>The file you created, by default is named 'untitled', you can rename it by saving the file using <kbd class='shortcut'>⌘ + n</kbd>.</p>

<h2 id='importing_an_existing_file'>importing an existing file</h2>
<p>Open a text file by dragging it over Left, or using the shortcut <b>⌘ o</b>. You can close a file, by pressing <b>⌘ w</b>.</p>

<p>Open a text file by dragging it over Left, or using the shortcut <kbd class='shortcut'>⌘ + o</kbd>. You can close a file, by pressing <kbd class='shortcut'>⌘ + w</kbd>.</p>

<h2 id='writing'>writing</h2>
<p>To better organize your text, you can create markers by beginning lines with:</p>
<p><b>#</b> or <b>##</b></p>
<p><kbd class='shortcut'>#</kbd> or <kbd class='shortcut'>##</kbd></p>
<p>Using these will list them on the sidebar in different ways.</p>
<ul>
<li><b>#</b> will create a main header.</li>
<li><b>##</b> will create a sub-header.</li>
<li><kbd class='shortcut'>#</kbd> will create a main header.</li>
<li><kbd class='shortcut'>##</kbd> will create a sub-header.</li>
</ul>
<p>The markers will be listed under your document name on the side bar, and whichever other document that you create will be listed underneath everything.</p>
<p>Once you have more than one marker, you can cycle through them using <b>⌘ ]</b>.</p>
<p>Once you have more than one marker, you can cycle through them using <kbd class='shortcut'>⌘ + ]</kbd>.</p>

<h2 id='features'>features</h2>

<p>Left has many built-in features to help you write more efficiently, these include:</p>
<ul>
<li>A synonyms dictionary</li>
<li>Auto-complete of words</li>
<li>A speed reader</li>
<li>A quick insert mode</li>
</ul>
<p><b>Synonyms</b> - The synonyms of every word, appear on the bottom of the main window, you can cycle through the synonyms of a selected word by keeping <b>shift</b> pressed down, and then pressing <b>tab</b> to cycle through them. When you release the keys, the word will be replaced with the selected word. You can undo this change with <b>⌘ z</b>.</p>
<p><b>Autocomplete</b> - You can press <b>tab</b> to auto-complete a previously used, or common, word.</p>
<p><b>Speed reader</b> - to use it highlight some text and press <b>⌘ k</b> to enable it. Press <b>escape</b> to stop it.</p>
<p><b>Synonyms</b> - The synonyms of every word, appear on the bottom of the main window, you can cycle through the synonyms of a selected word by keeping <kbd class='shortcut'>shift</kbd> pressed down, and then pressing <kbd class='shortcut'>tab</kbd> to cycle through them. When you release the keys, the word will be replaced with the selected word. You can undo this change with <kbd class='shortcut'>⌘ + z</kbd>.</p>
<p><b>Autocomplete</b> - You can press <kbd class='shortcut'>tab</kbd> to auto-complete a previously used, or common, word.</p>
<p><b>Speed reader</b> - to use it highlight some text and press <kbd class='shortcut'>⌘ + k</kbd> to enable it. Press <kbd class='shortcut'>escape</kbd> to stop it.</p>
<ul>
<li>Date - You can insert the current date into your text, by pressing the shortcut <b>⌘ d</b></li>
<li>Time - Insert the current time into your text by pressing the shortcut <b>⌘ t</b></li>
<li>Header - Create a header by pressing <b>⌘ h</b>.</li>
<li>Comment - Create a comment by pressing <b>⌘ /</b>.</li>
<li>Date - You can insert the current date into your text, by pressing the shortcut <kbd class='shortcut'>⌘ + d</kbd></li>
<li>Time - Insert the current time into your text by pressing the shortcut <kbd class='shortcut'>⌘ + t</kbd>.</li>
<li>Header - Create a header by pressing <kbd class='shortcut'>⌘ + h</kbd>.</li>
<li>Comment - Create a comment by pressing <kbd class='shortcut'>⌘ + /</kbd>.</li>
</ul>
<p>You can leave insert mode by pressing the escape key.</p>
<p>You can leave insert mode by pressing the <kbd class='shortcut'>escape</kbd> key.</p>

<img src='../media/content/projects/left_07.png' loading='lazy' />
<img src='../media/content/projects/left_07.png' loading='lazy'/>

<p>You can cycle between 3 fonts, using <b>⌘ <</b> or <b>⌘ ></b>. The font size can also be increased and decreased using <b>⌘ -</b> and <b>⌘ +</b>.</p>
<p>You can cycle between 3 fonts, using <kbd class='shortcut'>⌘ + <</kbd> or <kbd class='shortcut'>⌘ + ></kbd>. The font size can also be increased and decreased using <kbd class='shortcut'>⌘ + -</kbd> and <kbd class='shortcut'>⌘ + +</kbd>.</p>

<h2 id='shortcut_quick_list'>shortcut quick list</h2>
<ul>
<li>Create markers by beginning lines with <b>#</b> or <b>##</b></li>
<li>Navigate quickly between markers with <b>⌘ ]</b> and <b>⌘ [</b></li>
<li>Open a text file by dragging it, or with <b>⌘ o</b></li>
<li>Highlight some text and press <b>⌘ k</b> to enable the speed reader</li>
<li>Press <b>tab</b> to auto-complete a previously used, or common, word</li>
<li>Press <b>shift tab</b> to scroll through the selected word's synonyms</li>
<li><b>⌘ i</b> Quick insert mode</li>
<li><b>⌘ d</b> Date</li>
<li><b>⌘ t</b> Time</li>
<li><b>⌘ p</b> Path</li>
<li><b>⌘ h</b> Header</li>
<li><b>⌘ H</b> Sub-Header</li>
<li><b>⌘ /</b> Comment</li>
<li><b>⌘ l</b> Line</li>
<li>Cycle between font styles using <b>⌘ <</b> and <b>⌘ ></b></li>
<li>Decrease font using <b>⌘ -</b></li>
<li>Increase font using <b>⌘ +</b></li>
<li>Create markers by beginning lines with <kbd class='shortcut'>#</kbd> or <kbd class='shortcut'>##</kbd></li>
<li>Navigate quickly between markers with <kbd class='shortcut'>⌘ + ]</kbd> and <kbd class='shortcut'>⌘ + [</kbd></li>
<li>Open a text file by dragging it, or with <kbd class='shortcut'>⌘ + o</kbd></li>
<li>Highlight some text and press <kbd class='shortcut'>⌘ + k</kbd> to enable the speed reader</li>
<li>Press <kbd class='shortcut'>tab</kbd> to auto-complete a previously used, or common, word</li>
<li>Press <kbd class='shortcut'>shift + tab</kbd> to scroll through the selected word's synonyms</li>
<li><kbd class='shortcut'>⌘ + i</kbd> Quick insert mode</li>
<li><kbd class='shortcut'>⌘ + d</kbd> Date</li>
<li><kbd class='shortcut'>⌘ + t</kbd> Time</li>
<li><kbd class='shortcut'>⌘ + p</kbd> Path</li>
<li><kbd class='shortcut'>⌘ + h</kbd> Header</li>
<li><kbd class='shortcut'>⌘ + H</kbd> Sub-Header</li>
<li><kbd class='shortcut'>⌘ + /</kbd> Comment</li>
<li><kbd class='shortcut'>⌘ + l</kbd> Line</li>
<li>Cycle between font styles using <kbd class='shortcut'>⌘ + <</kbd> and <kbd class='shortcut'>⌘ + ></kbd></li>
<li>Decrease font using <kbd class='shortcut'>⌘ + -</kbd></li>
<li>Increase font using <kbd class='shortcut'>⌘ + +</kbd></li>
</ul>


Expand Down
Loading

0 comments on commit c4b0ee7

Please sign in to comment.