Mini Micro code editor - Revision history

JoeStrout: /* Toolbar */

2023-07-04T04:36:40Z

Toolbar

JoeStrout: /* Customization */

2023-07-03T21:27:36Z

Customization

JoeStrout: /* Search & Replace */

2023-07-03T21:27:23Z

Search & Replace

JoeStrout at 21:17, 3 July 2023

2023-07-03T21:17:13Z

JoeStrout: /* General Usage */

2023-07-03T21:13:01Z

General Usage

JoeStrout: /* Customization */

2023-02-25T21:37:06Z

Customization

JoeStrout: Created page with "Mini Micro comes with a built-in code editor, accessed with the edit command. == General Usage == == Toolbar Buttons == == Search & Replace == == Customization..."

2023-02-25T21:34:42Z

Created page with "Mini Micro comes with a built-in code editor, accessed with the <c>edit</c> command. == General Usage == == Toolbar Buttons == == Search & Replace == == Customization..."

New page

[[Mini Micro]] comes with a built-in code editor, accessed with the <c>edit</c> command.

== General Usage ==

== Toolbar Buttons ==

== Search & Replace ==

== Customization ==

As of Mini Micro version 1.2, you can customize the colors used by the code editor by creating a map of color names to colors, and assigning this to <c>env.editorColors</c>. The following example shows how to use this to create a "dark mode" color theme.

<ms>// Set up a dark theme for the editor.
m = {}
m.codeBackground = "#333333"
m.noCodeBackground = "#000000"
m.lineNumber = "#666666"
m.caret = "#CCCCCCCC"
m.toolbarTint = "#CCCCFF" // (keep light for best results)

m.text = {}
m.text.default = "#BBBBBB"
m.text.operator = "#AAAADD"
m.text.string = "#DDAAAA"
m.text.openString = "#FF0000"
m.text.identifier = "#BBBBBB"
m.text.comment = "#FFFFCC"
m.text.number = "#88FF88"
m.text.keyword = "#FF99FF"
m.text.colon = color.fuchsia
m.text.paren = ["#00FFFF", "#FF8800", "#CC44FF", "#00FF00"]
m.text.bracket = m.text.paren

env.editorColors = m</ms>

The above example shows all the supported color keys. Note that <c>text.paren</c> and <c>text.bracket</c> are lists of colors, rotated through to indicate deeper levels of nested parentheses or square brackets. These lists may be as long or short as you like.

{{template:stub}}

[[Category:Mini Micro]]

@@ Line 20: / Line 20: @@
 * '''Close''' (keyboard shortcut: Control-W): closes the code editor, returning you to the MiniScript prompt.  If '''Auto-Save''' is checked, and there is a '''File path''' shown, the contents of the editor will also be saved to that file.
-* '''Save''' (control-S): saves the contents of the editor to the path shown in '''File path'''.  If there currently is no path set, or if you hold the Alt or Option key while clicking this button or pressing control-S, then you will be prompted for a path (relative to the current directory) in which to save.
+* '''Save''' (control-S): saves the contents of the editor to the path shown in '''File path'''.  If there currently is no path set, or if you hold the Shift key while clicking this button or pressing control-S, then you will be prompted for a path (relative to the current directory) in which to save.
 * '''Revert''': replaces the contents of the editor with a fresh reload of the file shown in '''File path'''.
@@ Line 41: / Line 41: @@
 * '''Help''': opens the web browser on your host machine to the Mini Micro section of this wiki.
 == Find & Replace ==

← Older revision		Revision as of 21:27, 3 July 2023
Line 91:		Line 91:

	The above example shows all the supported color keys. Note that <c>text.paren</c> and <c>text.bracket</c> are lists of colors, rotated through to indicate deeper levels of nested parentheses or square brackets. These lists may be as long or short as you like.		The above example shows all the supported color keys. Note that <c>text.paren</c> and <c>text.bracket</c> are lists of colors, rotated through to indicate deeper levels of nested parentheses or square brackets. These lists may be as long or short as you like.
−
−	~~{{template:stub}}~~

	[[Category:Mini Micro]]		[[Category:Mini Micro]]

← Older revision		Revision as of 21:27, 3 July 2023
Line 43:		Line 43:


−	== ~~Search~~ & Replace ==	+	== Find & Replace ==
		+
		+	Clicking the magnifying class in the toolbar, or pressing control-F, summons or dismisses the ''Find and Replace dialog'':
		+
		+	[[File:findReplaceDialog.png\|968px\|frameless\|center\|find/replace dialog in Mini Micro code editor]]
		+
		+	This is a simple but powerful tool for both finding and replacing selected occurrences of some text in your program. Usage is as follows:
		+
		+	# Type the text you want to search for in the "Find" field. As soon as you press Return (or click any of the buttons in step 2), the search results appear below.
		+	# Use any combination of the three buttons to the right of the "Find" field to restrict your search:
		+	## Match case
		+	## Match whole words
		+	## Match only within the selected text
		+	# Double-click any search result to jump to that line and select the matching text. OR,
		+	# Type new text to replace the matched result in the "Replace with" field.
		+	# To replace only ''some'' matches, but not all, click the checkbox to the right of any search result. (Holding Alt or Option while clicking a checkbox will turn all the checkboxes on/off at once.)
		+	# Click the "Replace" button to replace only the checkmarked matches with the new text.
		+
		+	When done, press control-F or click the magnifying glass again to dismiss the Find and Replace dialog.

	== Customization ==		== Customization ==

@@ Line 5: / Line 5: @@
 [[File:CodeEditor.png|800px|frameless|center|Screen shot of the Mini Micro code editor.]]
 At the top of the screen is the <b>toolbar</b>, containing various buttons and menus as follows:
@@ Line 34: / Line 42: @@
 * '''Help''': opens the web browser on your host machine to the Mini Micro section of this wiki.
 == Search & Replace ==

← Older revision		Revision as of 21:13, 3 July 2023
Line 2:		Line 2:

	== General Usage ==		== General Usage ==
		+	The code editor is invoked with the <c>[[edit]]</c> command. This replaces the standard Mini Micro display with a graphical (GUI) code editor, as shown below.
		+
		+	[[File:CodeEditor.png\|800px\|frameless\|center\|Screen shot of the Mini Micro code editor.]]
		+
		+	At the top of the screen is the <b>toolbar</b>, containing various buttons and menus as follows:
		+
		+	[[File:codeEditorToolbar.png\|797px\|frameless\|center\|Code editor toolbar, with widgets labeled.]]
		+
		+	* '''Close''' (keyboard shortcut: Control-W): closes the code editor, returning you to the MiniScript prompt. If '''Auto-Save''' is checked, and there is a '''File path''' shown, the contents of the editor will also be saved to that file.
		+
		+	* '''Save''' (control-S): saves the contents of the editor to the path shown in '''File path'''. If there currently is no path set, or if you hold the Alt or Option key while clicking this button or pressing control-S, then you will be prompted for a path (relative to the current directory) in which to save.
		+
		+	* '''Revert''': replaces the contents of the editor with a fresh reload of the file shown in '''File path'''.
		+
		+	* '''Run''' (control-R or F5): closes the editor and executes the <c>[[run]]</c> command to run the edited source code. If '''Auto-Save''' is checked, and there is a '''File path''' shown, the contents of the editor will also be saved to that file.
		+
		+	* '''Undo''' (control-Z) and '''Redo''' (shift-control-Z): undoes and redoes the last editing action.
		+
		+	* '''Cut''' (control-X), '''Copy''' (control-C), '''Paste''' (control-V): standard text cut/copy/paste operations common to all text editors.
		+
		+	* '''Find/Replace''' (control-F): opens/closes the Find/Replace dialog on the bottom portion of the screen.
		+
		+	* '''Navigate''': a menu containing a "Jump to line..." command, as well as any functions found in your source file; selecting any function name jumps to the start of that function in the code.
		+
		+	* '''Code''': a menu containing Comment/Uncomment Line, Insert Color, and a variety of code snippets (for loops, etc.). Code snippets are loaded from /sys/data/codeSnippets.txt, and /usr/data/codeSnippets.txt (if that exists).
		+
		+	* '''File path''': shows the path of the file currently being edited, if any. This area is blank if you are editing a program in memory that is not yet associated with any disk file.
		+
		+	* '''Auto-save checkbox''': if checked, then the contents of the editor are automatically saved whenever the editor is closed. If not, then any code changes are in memory only; you may <c>[[run]]</c> and test them, but they will not be written to disk unless you manually do a <c>[[save]]</c>.
		+
		+	* '''Help''': opens the web browser on your host machine to the Mini Micro section of this wiki.

	== Toolbar Buttons ==		== Toolbar Buttons ==

@@ Line 9: / Line 9: @@
 == Customization ==
-As of Mini Micro version 1.2, you can customize the colors used by the code editor by creating a map of color names to colors, and assigning this to <c>env.editorColors</c>.  The following example shows how to use this to create a "dark mode" color theme.
+As of Mini Micro version 1.2, you can customize the [[color]]s used by the code editor by creating a map of color names to colors, and assigning this to <c>env.editorColors</c>.  The following example shows how to use this to create a "dark mode" color theme.
 <ms>// Set up a dark theme for the editor.