logigate/app/components/editor/Help.vue

100 lines
6.6 KiB
Vue
Raw Normal View History

<script setup lang="ts">
const ed = useEditor()
const SHORTCUTS: [string, string][] = [
['Esc (nothing selected)', 'Pause menu: save, save as copy, load, settings, main menu'],
['Click switch', 'Flip an input between 0 and 1 (give it a keyboard key in its settings)'],
['Click anything', 'A panel on the right shows its settings and what you can do with it: swap the part, clock speed, colours, keys, position'],
['Select several', 'Change them all at once: swap, rename D0, D1, …, switch all to 0 or 1, line up'],
['Pins (panel on the left)', 'Every input and output in one list: rename them one after another with Enter'],
['Drag from a pin', 'Draw a wire to another pin; dropping it on a part uses that part’s next free pin'],
['Click a pin, then another', 'The same without holding the mouse button'],
['Select parts, then W', 'Connect one by one: click where each of their pins goes, in order (Shift+W: their inputs)'],
['Drag a wire segment', 'Move that segment; drag a corner square to move a bend'],
['Alt + drag a wire', 'Pull a new bend out of it'],
['Ctrl + drag a wire', 'Start a new wire from the same signal'],
['Double-click a wire', 'Select the whole signal'],
['Shift + click', 'Add parts or wires to the selection'],
['Arrow keys', 'Move the selection one step (Shift: four)'],
['Double-click a component', 'Open it and see inside'],
['Drag on empty space', 'Select parts; across wires (no parts in the box) it selects every wire it crosses'],
['Drag right to left', 'Select everything the box touches, parts and wires (green box)'],
['Right click (or the menu key)', 'Everything you can do with what is under the pointer or selected; on empty space: paste, add a part here'],
['Right or middle drag, Space + drag', 'Move the view'],
['Mouse wheel', 'Zoom'],
['N, I, O, L, B, C, H, T, P, X', 'Place NAND, input, output, lamp, button, clock, hex display, note, input panel, pixel'],
['Bar at the bottom', 'Point at a kind of part to see them all; click to place, drag onto the canvas, pin the ones you use most to the bar itself (right-click a pinned part to unpin it)'],
['Main (top bar)', 'Back to the main circuit; the names after it lead back to each component you entered'],
['[', 'Hide or show the panel on the left (This and Pins)'],
['Connectors (bottom bar)', 'Make a cable type of your own (HDMI, RJ45): its lines; place its Out and In ports; one cable joins them'],
['Select wires, Ctrl+G', 'Bundle them into one cable; an end whose wires all meet one part plugs straight into it'],
['Select a component, cable button beside its pins', 'A cable plugged onto S0–S3 (or any group); drop its free end on the next part\'s pins'],
['Drag a part from the list onto pins', 'It lands on them and connects (green rings show where); Alt just places it'],
['Drag a plugged cable end away', 'Pull it out; drop its pins on a part\'s pins to plug it in again'],
['Drag a part onto a pin', 'Connects there when dropped (a green ring shows where); hold Alt to just place it'],
['Drag a wire by its end', 'Moves that end to another pin (grab it near the pin, or by the small circle)'],
['Drop a wire on a wire', 'From an input: it taps that wire\'s signal. From an output: it feeds what that wire fed'],
['Alt + click an input pin', 'Inverts it (a bubble); counted honestly as one NAND'],
['Send signal / Use signal', 'Name a signal (CLK, RESET) once and use it anywhere in the circuit without a wire'],
['Ctrl+F', 'Find a part, signal or component in every circuit, and where a component is used'],
['Shift+A or Ctrl+K', 'Add a part at the mouse: type a few letters, arrows to choose, Enter to place'],
['/', 'The same: find a part by name and place it'],
['Ctrl+P', 'Print the circuit as a sheet with a title block, or save it as PDF'],
['Select switches or buttons, Combine', 'One input panel (all rows can become buttons); lamps or output pins combine into an output panel'],
['Select panels, Merge', 'One panel with all their rows; inside a component input panel rows are inputs, output panel rows outputs'],
['Design the box (This, As a component)', 'Move lamps, displays and the name on a component\'s box, draw lines, boxes, circles and text'],
['Select several lamps, pins or switches', 'Green boxes show free pins in a row they fit; point along one, click to wire them all'],
['Shift + click on canvas', 'Keep placing the same part'],
['Ctrl+C, Ctrl+V, Ctrl+D', 'Copy, paste, duplicate; names continue their series (D0 → D1)'],
['Delete', 'Remove the selection'],
['Ctrl+Z, Ctrl+Shift+Z', 'Undo, redo'],
['Logo (top left), Esc', 'Pause menu: save, load, settings, back to the main menu. Your work is saved'],
['F', 'Fit the circuit to the screen'],
['Enter', 'Open the selected component'],
]
function close() {
ed.showHelp.value = false
try {
localStorage.setItem('logigate:help-seen', '1')
} catch {}
}
</script>
<template>
<div class="modal-backdrop" @click.self="close">
<div class="modal" role="dialog" aria-labelledby="help-title">
<div class="flex items-start justify-between gap-4">
<h2 id="help-title">From one NAND gate to a computer</h2>
<button class="tb-btn" title="Close" @click="close"><Icon name="lucide:x" class="size-4" /></button>
</div>
<ol class="steps">
<li>
<strong>NAND is the only gate.</strong> Its output is 0 only when both inputs are 1. Everything else (NOT, AND, OR, adders, memory) can be built from it.
</li>
<li>
<strong>Every circuit is a component.</strong> Inputs and outputs you place inside a circuit become its pins. Place it in another circuit and it shows up as one block; double-click to look inside.
</li>
<li>
<strong>It runs while you draw.</strong> Green wires carry a 1, grey wires a 0. Flip switches, press buttons, or start the clock in the top bar.
</li>
<li>
<strong>Try the challenges</strong> (top bar), or open the examples (NOT up to a 4-bit counter) to see how each step is made of the previous one.
</li>
<li>
<strong>Select parts and press "Make component"</strong> in the panel on the right to turn a piece of your drawing into a reusable block.
</li>
</ol>
<h3>Controls</h3>
<dl class="shortcuts">
<template v-for="[k, v] in SHORTCUTS" :key="k">
<dt>{{ k }}</dt>
<dd>{{ v }}</dd>
</template>
</dl>
<p class="hint">Your work is saved in this browser. Sign in (top right) to have it on every computer; use Share to get a link or export a file.</p>
<button class="btn btn-primary mt-4" @click="close">Start building</button>
</div>
</div>
</template>