Text Forge Menus

Introduction

In TextForge, we use menus as the main way to edit with the help of Action Scripts and dynamic command structure. This guide has tried to explore the tips for menu options.

All actions support multi-caret editing, if not, action will show a popup and request caret selection. You can click on a text without selection (caret) when hold Alt to add new caret.

Note

If there was something you didn't find in this list, check the Not Available Options section; if it wasn't there either, please report it.

File

This menu includes regular actions with working with files and the editor window.

New

Opens a new file. It doesn't activate any mode, so it's recommended to save it after creating a new file and then continue editing.

New Window

Opens another window of the editor. Due to the lack of support for multi-file editing (currently), this is a good way to work with multiple files.

New With Template

It lists all templates, clicking on any template will create new file with that template.

Open

Creates a pop-up to select and open an existing file.

Recent Files

It lists recently opened files, clicking on any file will open that file.

Save

Saves the open file, if the file doesn't have a specific location (e.g. created with the New option) it will be the same as Save.

Save As

It creates a pop-up to choose a location and name to save the open file.

Reload

It reloads the open file, similar to reopening the same file.

Note

If some functions don’t work properly after saving, please report the issue and use Reload as a temporary workaround.

Close

It closes the open file, without closing the editor.

Create Backup

Saves a manual backup of the open file, use Load From Backup to restore. Go to Preferences for automatic backups.

Load From Backup

It displays a list of available backups by file and time, restored by clicking on the file version.

Warning

This is an experimental feature.

Copy Path

Copies the path of the open file to the clipboard.

Show In FileSystem

It displays the open file in the system files.

Secure Delete

It deletes the file completely, fills the entire content of the file with zero bits, and then deletes.

Restart

Similar to New Window but closes the current window.

Exit

Closes the editor.

Project

This menu includes commands and actions related to projects.

New Project

Opens the New Project window to create a new project.

Tip

See Setup > Create New Project for a guide to .tfproj fields and workflow.

Open Project

Opens a file dialog to select a .tfproj file and load it as the current project.

Note

While you can open a .tfproj via File > Open, it is discouraged because it won’t initialize full project context (e.g. last opened file). Prefer Project > Open Project for proper .tfproj handling.

Recent Projects

Opens a list of recent projects. Click a project to open it.

Note

This list is limited to 15 items. Non-existent files will be removed automatically.

Close Project

Closes the current project.

Note

When you open a file that isn't in the project's files, the editor will run this action. To add a new file to the project, use Project > Project Settings > Include > Add Files....

Project Settings

Opens the Project Settings window, where you can modify the current project's configuration. You can use the Add Files... and Add Folder... buttons in the Include and Exclude sections to manage project files.

For each folder in the include list, the editor adds that folder and all its subfolders and files to the project. When you exclude a subfolder, its contents are ignored as well.

Edit

This menu contains commands and actions related to editing the content of the file.

Undo

It takes a step back in memory.

Redo

It returns the last Undo.

Cut

Copies the selected text to the clipboard and deletes it in the file. It does this for the entire line if no text is selected. This option is also available in the context menu.

Copy

Copies the selected text (or entire line) to the clipboard. This option is also available in the context menu.

Paste

Paste the latest clipboard content (instead of the selected text). This option is also available in the context menu.

Delete

Deletes the selected text or the next character.

Select All

Selects all file content.

Select Next Occurrence

The next occurrence selects the selected text and keeps the current selections. If no text is selected, it selects the current word.

Select All Occurrences

This operation repeats the Select next occurrence until there is an occurrence.

Duplicate Selection

Duplicates the selected text and selects duplicated text.

Evaluate Selection

Evaluates the selected text.

Line (Submenu)

It puts the actions related to the line in a group.

Move Lines Up

Lines with caret or selection move up one line.

Move Lines Down

Lines with caret or selection move down one line.

Indent

The selected lines are taken one block further in.

Unindent

It brings out the selected lines one block further.

Delete Lines

Removes the entire content of selected lines.

Toggle Comment

It converts the line into a comment or vice versa.

Warning

This is an experimental feature.

Duplicate Lines

It duplicates the selected lines and selects the duplicated lines.

Select Whole Line

Extends the selection to the entire line(s).

Select Paragraph

It expands the selection to the point where there is a blank line.

Join Lines

It joins the selected lines, leaving a space between each line.

Move To New File

Opens a new file and moves the selected lines to that file.

Completion Query

Sends a completion query (request), editor will send request when you stop typing as default, but you can do this manually with this option.

Indention (Submenu)

It puts the actions related to indention in a group.

Auto Indent

Will automaticly indent whole file content.

Note

Some modes don’t support Auto Indent; this option is enabled only for supported modes.

Convert Indent To Spaces

Converts indention of currently selected line(s) to spaces and sets indention mode to spaces.

Convert Indent To Tabs

Converts indention of currently selected line(s) to tabs and sets indention mode to tabs.

Convert Case (Submenu)

Provides options to convert selected text case, these options are simple, so we will not explain them here.

This menu includes commands and actions related to sreaching in file content and replace actions.

Find and Replace

Opens Find panel. You can find this panel in right side of editor and open it manually.

Find Next

Selects next match, or first match when current match is last one.

Find Previous

Selects previous match, or last match when current match is first one.

Replace All

Replaces all matches, it's same as Replace All button in Find panel.

Go To

This menu includes commands and actions related to fast navigation in file content and sections.

Go To Line

Shows a popup to go to selected line, line numbers start from 1.

Command

This menu includes commands and actions related to commands that you can run.

Command Palette

Shows command palette. You can run all commands here by clicking on them and there is a search box. When you type, command items order updates based on similarity of they name with your search, and matching segments will be highlighted. If exists, you can see command shortcut in right side of command name.

Format

This menu includes commands and actions related to formatting file content.

Auto Format

Will automaticly format whole file content.

Note

Some modes don’t support Auto Format; this option is enabled only for supported modes.

Auto Indention

When enabled, editor will try to calculate indention level when you add new line; Otherwise, will apply last line indention level for new line.

Note

This feature is experimental and may behave unexpectedly.

Remove All Indents

Removes all indention and white spaces in both side of all lines.

Continue Placeholder Completion

Returns you to Placeholder completion mode (when current file has any placeholder).

Save As Template

Saves current file as a template with given name.

Templates

Shows Template Manager window to view, edit, and remove templates.

View

This menu includes options and actions related to editor layout and visible items.

Increase Font Size

Increases content font size by 2px.

Reduce Font Size

Reduces content font size by 2px.

Reset Font Size

Resets content font size to default (16px).

Focus On Editor

Will move focus from everywhere to main editor. For example you can open notification panel to see notifications and then use Esc (This action shortcut) to back to editor very fast and easy.

Line Length Guides

Opens a popup to configure line length guide lines. You can have zero or more line length guides and add them as a comma-separated list, first item will be main and hard guide line and will draw with more contrast.

Show Bookmarks

When enabled, shows bookmarks in gutter.

Note

Bookmarks feature isn't yet available.

Show Line Numbers

When enabled, shows line numbers in gutter (from 1).

Show Fold Gutter

When enabled, shows fold / unfold buttons in foldable lines gutter.

Show Minimap

When enabled, shows minimap in right side of editor.

Block Type Caret

When enabled, shows caret as block.

Important

This isn’t the Replace edit mode (which overwrites the next character). To switch between Insert and Replace modes, press the Insert key.

Highlight All Occurrences

When enabled, highlightes other occurrences of currently selected text.

Highlight Current Line

When enabled, highlightes lines with caret.

Show Control Characters

When enabled, shows control characters.

Tip

You can insert control characters from the context menu.

Show Tabs

When enabled, shows each tab with a transparent.

Show Spaces

When enabled, shows each space with a transparent center-dot.

Full Screen

When enabled, makes editor window fullscreen.

Tools

This menu includes tools, them settings, and extensions options.

Color Picker

Shows a color picker window to help you work with colors.

By Extensions

Keeps options provided by extensions.

Settings

This menu includes options and actions related to editor data and configuration.

Preferences

Shows Preferences window.

Mode Manager

Shows Mode Manager window.

Extensions

Shows Extensions window.

Open Data Folder

Opens editor data folder.

Help

This menu includes options related to manuals and online resources.

GitHub Repository

Opens editor source GitHub repository in browser.

Mode Library

Opens official Mode Library repository in browser.

Forum

Opens official forum in browser.

Share Feedback

Opens create topic window in forum in browser.

Submit Issue

Opens issue template selection window in GitHub repository in browser.

Online Docs

Opens home page of online documentation in browser.

About

Opens about dialog.

Not Available Options

There are some options that are always disabled in menus and are not yet available, these are listed below:

  • Go To > Code Regions
  • Go To > Insert Navigation Mark
  • Go To > Navigation Marks
  • Go To > Table Of Contents
  • Go To > Bookmarks
  • Go To > Toggle Bookmark
  • Go To > Remove All Bookmarks
  • Tools > Security
  • Tools > Counter
  • Tools > Translation
  • Tools > Clipboard History
  • Tools > Function Creator
  • Tools > Documentation
  • Tools > Auto Completion
  • Tools > Time Management
  • Tools > Calendar