The Menubar

Robert Nickel

    robert@artnickel.com

Christopher Hornbaker

    chrishornbaker@earthlink.net

Reviewer
Fabrice Mous

    fabrice@kde.nl

Reviewer

# The Menubar

This chapter explains all the various functions that can be found in the menubar.

## The File Menu

&Ctrl;N File New

  Create a new, blank file.

&Ctrl;O File Open...

  Search the file system to open an existing file.

File Open Recent

  Quick list of the last several files you've opened. This list will change each time you open a file that is not on it, with the oldest being bumped off first.

&Ctrl;S File Save

  Save the active file's changes.

File Save As...

  Save the active file with another name.

File Save as Template

  This allows you to save code snippets and entire files as a template for later use. See the section on templates. If you try to save the selected text/file outside of the local/project template dir, then you will receive an error.

  File Save as Template Save as Local Template...

    Allows you to save a file as a template within the local scope.

  File Save as Template Save as Project Template...

    Allows you to save a file as a template within the project scope.

  File Save as Template Save Selection to Local Template File...

    Allows you to save the selected text (⪚ a code snippet) in a local template file.

  File Save as Template Save Selection to Project Template File...

    Allows you to save the selected text (⪚ a code snippet) in a project template file.

&Ctrl;&Shift;S File Save All...

  Save all modified files in the editor.

&Ctrl;F5 File Reload

  Reloads the current focused document.

&Ctrl;P File Print...

  You can actually print out your documents. Uses the kprinter interface.

&Ctrl;W File Close

  Close the currently displayed file.

File Close All

  Close all open files. Prompts you to save if any files have been modified.

&Ctrl;Q File Quit

  Exit &quantaplus;

## The Edit Menu

&Ctrl;Z Edit Undo

  Undo the last action performed.

&Ctrl;&Shift;Z Edit Redo

  Redo the last action undone.

&Ctrl;X Edit Cut

  Cut the current block of text and place its contents on the clipboard.

&Ctrl;C Edit Copy

  Copy the current block of text to the clipboard.

&Ctrl;V Edit Paste

  Paste the contents of the clipboard at the current cursor position.

Edit Paste Special

  Edit Paste Special Paste HTML Quoted

    Converts the clipboard text &HTML; special characters to &HTML; entities before pasting into the text body, so they show up properly when viewed and aren't picked up as tags by the client browser.

  Edit Paste Special Paste &URL; Encoded

    Converts the clipboard text into &URL; encoding, which is the correct way to include special characters and spaces into &URL;s. Used primarily when pasting a &URL; into an anchor tag.

&Ctrl;A Edit Select All

  Select all of the text in the current document.

&Ctrl;&Shift;A Edit Deselect

  Unselect all text in the current document.

F4 Edit Toggle Block Selection

  Turn on/off block highlighting. Allows you to select text blocks with your keyboard without holding down the shift key.

Inset Edit Toggle Insert

  Overrides the Insert key.

&Ctrl;F Edit Find...

  String or regular expression pattern to find in the current document.

F3 Edit Find Next

  Repeat the find downward in the document from the current location.

&Shift;F3 Edit Find Previous

  Repeat the find upward in the document from the current location.

&Ctrl;R Edit Replace...

  String or regular expression replacement of text in the current file.

&Alt;&Ctrl;F Edit Find in Files...

  Find a string or expression in files in the selected folder. Sort of a &GUI; `grep` or `sed` with some predefined pattern spaces to help you out.

&Ctrl;I Edit Indent

  Move the selected block of text one tab width to the right.

&Ctrl;&Shift;I Edit Unindent

  Move the selected block of text one tab width to the left.

Edit Clean Indentation

  Removes all indentation.

&Ctrl;# Edit Comment

  Comments selected text.

&Ctrl;&Shift;# Edit Uncomment

  Uncomments selected text.

&Ctrl;J Edit Expand Abbreviation

  Expands the abbreviations.

Edit Apply Word Wrap

  Wrap the text in the current window to a predefined width.

&Ctrl;G Edit Go to Line...

  Go directly to a specific line number. This is really helpful when your &PHP; script is breaking unexpectedly!

Edit Spelling...

  Check the spelling in the current document.

## The View Menu

View Tree Views
  View Tree Views Show Files Tree

    Toggle display of the files tree.

  View Tree Views Show Project Tree

    Toggle display of the project tree.

  View Tree Views Show Templates Tree

    Toggle display of the template tree.

  View Tree Views Show Scripts Tree

    Toggle display of the scripts tree.

  View Tree Views Show Structure Tree

    Toggle display of the document structure tree.

  View Tree Views Show Attribute Tree

    Toggle display of the attribute tree.

  View Tree Views Show Documentation Tree

    Toggle display of the documentation tree.

View Show Toolbar

  Toggle on and off the display of the toolbar.

View Show DTD Toolbar

  Toggle on and off the display of the &DTD; specific toolbar.

View Show Statusbar

  Toggle on and off the display of the status bar at the bottom of the main &quantaplus; window.

&Ctrl;M View Show Messages

  Toggle display of the message window. This is the window where you see the output of any scripting actions and the debugger.

View Show Problem Reporter

  Toggle display of the Problem Reporter at the bottom of the main &quantaplus; window. The Problem Reporter activates when you switch to the Structure Tree.

&Shift;F9 View Show Icon Border

  Toggle display of the icon border to the left of the main editor window. This bar allows for click toggling of bookmarks.

F11 View Show Line Numbers

  Toggles the display of line numbers along the side of the main editor window.

F10 View Dynamic Word Wrap

  Toggle on and off reformatting of text to a specific width as you type.

&Alt;F9 View Source Editor

  Switch to the source of a document to edit.

&Ctrl;&Shift;F9 View &VPL; Editor

  Switch to the &VPL; Editor to edit a document.

F9 View &VPL; & Source Editors

  Switch to split screen mode to edit a document.

F6 View Preview

  Preview the current document.

&Alt;Left Arrow View Back

  Navigate back one step in the preview.

&Alt;Right Arrow View Forward

  Navigate forward one step in the preview after having gone back in the preview.

F5 View Reload Preview

  Reload the preview from disk.

&Ctrl;F6 View View with &konqueror;

  View the current file with &konqueror;.

&Alt;F6 View View with Mozilla

  View the current file with Mozilla.

&Alt;&Ctrl;F6 View View with &Netscape;

  View the current file with &Netscape;.

&Ctrl;&Shift;F6 View View with Opera

  View the current file with Opera.

&Shift;F6 View View with Lynx

  View the current file with Lynx (a text based browser).

## The Bookmarks Menu

&Ctrl;B Bookmarks Toggle Bookmark

  Toggle a bookmark at the current line location in the current file.

Bookmarks Clear Bookmarks

  Clears all set bookmarks.

## The Project Menu

How to use projects in &quantaplus; is described in .

Project New Project...

  Launch the project creation wizard.

Project Open Project...

  Open an existing project file from disk. &quantaplus; projects are saved with the .webprj extension.

Project Open Recent Project

  Gives you a list of your most recently used projects for quick access.

Project Close Project

  Close the current project.

Project Open Project View...

  Open a View, a specific combination of open files that you have previously saved.

Project Save Project View

  Save the current set of open files as a View.

Project Save Project View As...

  Save the current set of open files as a View under another name.

Project Delete Project View...

  Delete a View.

Project Insert Files...

  Presents a dialog that allows you to select files to add to your current project. These files will then be copied into the project folder for editing.

Project Insert Folder...

  Insert a folder and all of its contents into the current project.

Project Rescan Project Folder

  Scan the project folder for any new files you may have there. This allows you to copy graphics into your project folder or a subfolder thereof and then add them to the project.

F8 Project Upload Project

  Upload the files in your project to the hosting server. The list of available transports depends on the version of &kde; you are running and whether or not you've downloaded extra KIO slaves.

F7 Project Project Options

  Settings affecting the way &quantaplus; manages your project. See the &quantaplus; projects section for details.

## The Toolbars Menu

Toolbars Load Toolbars
  Toolbars Load Toolbars Load Global Toolbar...

    Loads a globally defined toolbar. These are kept in `$`KDEDIR`/share/apps/quanta/toolbars` by default.

  Toolbars Load Toolbars Load Local Toolbar...

    Loads a locally defined toolbar. These are kept in `$`HOME`/.kde/share/apps/quanta/toolbars` by default.

  Toolbars Load Toolbars Load Project Toolbar

    Loads a project toolbar. These are kept in `ProjectDir/toolbars` and are only available in this menu if they have been assigned to this project.

Toolbars Save Toolbars

  Dialog for saving your toolbars. Allows you to pick the type of toolbar; Local or Project.

  Toolbars Save Toolbars Save as Local Toolbar...

    Save as a local toolbar to `$`HOME`/.kde/share/apps/quanta/toolbars`

  Toolbars Save Toolbars Save as Project Toolbar...

    Save as a project toolbar in `ProjectDir/toolbars`

Toolbars Add User Toolbar

  Brings up a dialog to create a new toolbar. This only creates the name. Actions must be added from the Settings Configure Actions menu item. Toolbars are saved via the Toolbars Save Toolbars menu or on close unsaved toolbars will prompt for you to save.

Toolbars Remove User Toolbar

  Remove a toolbar from usage. This does not remove it from the disk. If you've not saved the toolbar you are removing, you will be prompted to save it.

Toolbars Rename User Toolbar

  Allows you to rename a toolbar.

Toolbars Send Toolbar in E-Mail

  This is a hook to email your custom toolbar to someone (maybe the &quantaplus; team for inclusion in the next release!) for their use. It spawns an email window and attaches your toolbar file to it automatically.

## The Tags Menu

This menu contains a list of the elements that are in the currently loaded toolbars. If you have the Standard (&HTML;) toolbar loaded, the Tags menu will contain a submenu Standard which will contain the list of tags/actions on that toolbar.

&Ctrl;E Tags Edit Current Tag...

  Allows you to access the current markup tag settings dialog if one exists. This entry is always present, followed by the &DTD; specific submenus.

The &DTD; Menu

Christopher Hornbaker

    chrishornbaker@earthlink.net

## The &DTD; Menu

&DTD; Change the &DTD;...

  Pops up a dialog box that allows you to change the current documents &DTD;

&DTD; Load & Convert &DTD;...

  Load a &DTD; that you or someone else made and convert it to &quantaplus;' native description format.

&DTD; Load &DTD; Package (&DTEP;)...

  Load a your own &DTEP;.

&DTD; Send &DTD; (&DTEP;) Package in E-Mail...

  Send your &DTEP; to a friend via &kmail;.

## The Plugins Menu

Plugins Edit

  Pops up a dialog box that allows you to load plugins (KParts) into &quantaplus;.

Plugins Validate

  Validates that &quantaplus; is able to load the plugins the user has entered.

Plugins Plugin

  The Plugins menu lists the available plugins under the above menu items. Clicking them will activate them. Clicking an activated plugin will deactivate it.

## The Tools Menu

Tools Document Properties

  Edit specific properties of a currently loaded document when using the &VPL; Editor.

Tools Convert Tag & Attribute Case...

  Convert all tags and/or attributes character cases to another.

&Alt;0 Tools List Opened Files...

  Opens a dialog that highlights all opened files.

&Alt;&Ctrl;T Tools HTML Tidy Syntax Checking

  Checks the syntax of the current document against the selected &DTD;.

## The Settings Menu

Settings Configure Quanta...

  Setup the behavior of &quantaplus;.

Settings Configure Editor...

  Setup the behavior of the editor window. See the documentation on &kate; for details.

Settings Configure Actions...

  This is where you define the actions for use on toolbars.

Settings Configure Toolbars...

  Dialog that allows you to add/delete items to/from toolbars and change the order the icons appear in.

Settings Configure Shortcuts...

  Allows you to configure the many editor shortcuts available to &quantaplus;.

Settings Highlight Mode

  Choose the syntax highlighting mode for the current file. The list of available highlighting schemes varies depending on your version of &kate;.

Settings End of Line

  Select the end of line encoding type. Useful if you have folks using other &OS; platforms to develop on. Choose from Unix, Windows/DOS or Macintosh.

## The Help Menu

&quantaplus; contains a standard &kde; Help menu with the addition of these items:

&Ctrl;H Help Context Help

  This should produce help based on the current pointer context. At the time of this writing this feature is not implemented.

Help Make A Donation

  &quantaplus; is a high quality product that is freely available, and freely licensed, but like any open source project, its developers can always use help. If you would like to support &quantaplus; development in a financial manner, you can find out how to here.

The standard &kde; help menu items are as follows:

&help.menu.documentation;