فهرست منبع

change to macros for kbd menu and btn

mitm001 5 سال پیش
والد
کامیت
c06fa99eab
1فایلهای تغییر یافته به همراه42 افزوده شده و 46 حذف شده
  1. 42 46
      docs/modules/sdk/pages/code_editor.adoc

+ 42 - 46
docs/modules/sdk/pages/code_editor.adoc

@@ -1,16 +1,12 @@
 = jMonkeyEngine SDK: Code Editor and Palette
-:author: 
-:revnumber: 
-:revdate: 2016/03/17 20:48
+:revnumber:2.0
+:revdate: 2020/07/09
 :keywords: documentation, sdk, editor
-:relfileprefix: ../
-:imagesdir: ..
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]
 
 
 The Source Code Editor is the central part of the jMonkeyEngine SDK. This documentation shows you how to make the most of the jMonkeyEngine SDK's assistive features.
 
-Note: Since the jMonkeyEngine SDK is based on the NetBeans Platform framework, you can learn about certain jMonkeyEngine SDK features by reading the corresponding NetBeans IDE tutorials (in the “see also links). 
+Note: Since the jMonkeyEngine SDK is based on the NetBeans Platform framework, you can learn about certain jMonkeyEngine SDK features by reading the corresponding NetBeans IDE tutorials (in the "`see also`" links).
 
 
 == Code Completion and Code Generation
@@ -23,21 +19,21 @@ image::sdk/netbeans_code_completion.png[netbeans_code_completion.png,width="",he
 
 *Code Completion*
 
-*  Complete keyword / method / variable: *Ctrl-Space* +
-Alternatively you can also use *Ctrl-\*.
-**  Customize Code Completion options: Tools > Options > Editor > Code Completion 
+*  Complete keyword / method / variable: kbd:[Ctrl+Space] +
+Alternatively you can also use kbd:[Ctrl+\]
+**  Customize Code Completion options: menu:Tools[Options > Editor > Code Completion]
 
-*  Show expected parameters of this method in a tooltip: *Ctrl-P* 
-*  Complete any string (even non-Java) that has been used before: *(Shift-)Ctrl-K*
+*  Show expected parameters of this method in a tooltip: kbd:[Ctrl+P]
+*  Complete any string (even non-Java) that has been used before: kbd:[Shift+Ctrl+K]
 
 *Code Generation*
 
-*  Auto-fix import statements: *Ctrl-Shift-I*
-*  Auto-generate getters/setters, try/catch, equals/hashCode: *Alt-Insert*
-**  Customize code completion: Choose Tools > Options > Editor > Code Completion
+*  Auto-fix import statements: kbd:[Ctrl+Shift+I]
+*  Auto-generate getters/setters, try/catch, equals/hashCode: kbd:[Alt+Insert]
+**  Customize code completion: Choose menu:Tools[Options > Editor > Code Completion]
 
-*  Auto-generate common code snippets such as loops, declarations, println, by typing the *template name + TabKey* 
-**  Customize code templates: Choose Tools > Options > Editor > Code Templates
+*  Auto-generate common code snippets such as loops, declarations, println, by typing the *template name* + kbd:[Tab]
+**  Customize code templates: Choose menu:Tools[Options > Editor > Code Templates]
 
 *  Rename, move, or introduce methods, fields, and variables, without breaking the project: *Refactoring menu*
 
@@ -52,8 +48,8 @@ The text color in the editor gives you important hints how the compiler will int
 
 Examples:
 
-*  Java keywords are *blue*, variables and fields are *green*, parameters are *orange*. 
-*  +++<strike>Strikethrough</strike>+++ means deprecated method or field. 
+*  Java keywords are *blue*, variables and fields are *green*, parameters are *orange*.
+*  +++<strike>Strikethrough</strike>+++ means deprecated method or field.
 *  +++<u>Gray underline</u>+++ means unused variable or method.
 *  Place the caret in a method or variable and all its ocurrences are marked *tan*.
 *  Place the caret in a method's return type to highlight all exit points
@@ -61,42 +57,42 @@ Examples:
 
 To customize Colors and indentation:
 
-*  Tools &gt; Options &gt; Editor &gt; Formatting.
-*  Tools &gt; Options &gt; Fonts and Colors.
+*  menu:Tools[Options > Editor > Formatting]
+*  menu:Tools[Options > Fonts and Colors]
 
 
 == Editor Hints and Quick Fixes (a.k.a. Lightbulbs)
 
-Editor hints and quick fixes show as lightbulbs along the left edge of the editor. They point out warnings and errors, and often propose useful solutions! 
+Editor hints and quick fixes show as lightbulbs along the left edge of the editor. They point out warnings and errors, and often propose useful solutions!
 
-*  Execute a quick fix: Place the caret in the line next to the lightbulb and press *Alt-Enter* (or click the lightbulb)
-**  Customize hints: Choose Tools &gt; Options &gt; Editor &gt; Hints.
+*  Execute a quick fix: Place the caret in the line next to the lightbulb and press kbd:[Alt+Enter] (or click the lightbulb)
+**  Customize hints: Choose menu:Tools[Options > Editor > Hints]
 
 
 
 == Javadoc
 
-*  Place the caret above a method or a class that has no Javadoc, type 
+*  Place the caret above a method or a class that has no Javadoc, type
 +
 [source,html]
 ----
 /**
 ----
-and press Enter: The editor generates skeleton code for a Javadoc comment. 
-*  Right-click the project in the Projects window and choose Generate Javadoc.
-*  Right-click a file and choose Tools &gt; Analyze Javadoc
+and press Enter: The editor generates skeleton code for a Javadoc comment.
+*  btn:[RMB] click the project in the Projects window and choose Generate Javadoc.
+*  btn:[RMB] click a file and choose menu:Tools[Analyze Javadoc]
 
-To display a javadoc popup in the editor, place the caret in a line and press *Ctrl-Space* (Alternatively use *Ctrl-\*).
+To display a javadoc popup in the editor, place the caret in a line and press kbd:[Ctrl+Space] (Alternatively use kbd:[Ctrl+\]).
 
 *  If the javadoc popup doesn't work, make certain that
-**  You have the Java JDK documentation installed and set up: Tools &gt; Java Platforms 
-**  You downloaded and set up javadoc for third-party libraries: Project properties &gt; Libraries &gt; Edit
+**  You have the Java JDK documentation installed and set up: menu:Tools[Java Platforms]
+**  You downloaded and set up javadoc for third-party libraries: menu:Project properties[Libraries > Edit]
 
 
 
 == Navigating the jME3 Source
 
-When the JavaDoc does not deliver enough information, you can have a look at the source of every method or object of jME3 that you use. Just right-click the variable or method, select “Navigate &gt; Go to source.. and an editor will open showing you the source file of jME3.
+When the JavaDoc does not deliver enough information, you can have a look at the source of every method or object of jME3 that you use. Just btn:[RMB] click the variable or method, select menu:Navigate[Go to source] and an editor will open showing you the source file of jME3.
 
 
 == Palette
@@ -107,14 +103,14 @@ When the JavaDoc does not deliver enough information, you can have a look at the
 image::sdk/jmonkeyplatform-docu-4.png[jmonkeyplatform-docu-4.png,width="421",height="298"]
 
 
-Choose Windows &gt; Palette to open the context-sensitive Palette. The jMonkeyEngine SDK provides you with jme3 code snippets here that you can drag and drop into your source files.
+Choose menu:Windows[Palette] to open the context-sensitive Palette. The jMonkeyEngine SDK provides you with jme3 code snippets here that you can drag and drop into your source files.
 
 *  Examples: Node and Model creation code snippets.
 --
 
 [TIP]
 ====
-Choose Tools &gt; Add to Palette… from the menu to add your own code snippets to the Palette. (not available yet in beta build)
+Choose menu:Tools[Add to Palette] from the menu to add your own code snippets to the Palette. (not available yet in beta build)
 ====
 
 
@@ -122,26 +118,26 @@ Choose Tools &gt; Add to Palette… from the menu to add your own code snippets
 
 Keyboard Shortcuts save you time when when you need to repeat common actions such as Build&amp;Run or navigation to files.
 
-*  Go to File: *Alt-Shift-O*
-*  Go to Type: *Ctrl-O*
-*  Open in Projects / Files / Favorites window: *Ctrl-Shift-1 / 2 / 3*
-*  Build&amp;Run the main class of the Project: *F6* 
-*  Run the open file: *Shift-F6* 
-*  Switch to Editor / Projects / Files / Navigator: *Ctrl-0 / 1 / 3 / 7*
-*  Indent code: *Ctrl-Shift-F*
+*  Go to File: kbd:[Alt+Shift+O]
+*  Go to Type: kbd:[Ctrl+O]
+*  Open in Projects / Files / Favorites window: kbd:[Ctrl+Shift+1]/ kbd:[2] / kbd:[3]
+*  Build&amp;Run the main class of the Project: kbd:[F6]
+*  Run the open file: kbd:[Shift+F6]
+*  Switch to Editor / Projects / Files / Navigator: kbd:[Ctrl+0] /kbd:[1] / kbd:[3] / kbd:[7]
+*  Indent code: kbd:[Ctrl+Shift+F]
 
 By default, jMonkeyEngine uses the same link:http://netbeans.org/project_downloads/www/shortcuts-6.5.pdf[Editor Shortcuts] as the NetBeans IDE, but you can also switch to an Eclipse Keymap, or create your own set.
 
-*  Customize keyboard shortcuts: Tools &gt; Options &gt; Keymap
+*  Customize keyboard shortcuts: menu:Tools[Options > Keymap]
 
 
 == Tips and Tricks
 
-*  To browse the physical file structure of your project, use the Files window: *Ctrl-2*
-*  To open a file that is not part of a Java project, add it to the Favorites window: *Ctrl-3*
-*  If you cannot find a particular menu item or option panel, use the IDE Search box in the top right! *Ctrl-i*
+*  To browse the physical file structure of your project, use the Files window: kbd:[Ctrl+2]
+*  To open a file that is not part of a Java project, add it to the Favorites window: kbd:[Ctrl+3]
+*  If you cannot find a particular menu item or option panel, use the IDE Search box in the top right! kbd:[Ctrl+i]
 *  If a code block, class, or javadoc is quite long and you don't want to scroll over it, click the *+/-* signs to collapse (fold) the code block temporarily.
-*  Press *F1* for Help
+*  Press kbd:[F1] for Help
 
 '''