You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by vi...@apache.org on 2020/01/21 21:19:57 UTC
[netbeans-website] branch master updated: [NETBEANS-1867] java
section cleanup
This is an automated email from the ASF dual-hosted git repository.
vieiro pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/netbeans-website.git
The following commit(s) were added to refs/heads/master by this push:
new f417ebc [NETBEANS-1867] java section cleanup
f417ebc is described below
commit f417ebcc357e3ea15914fd5c919f7e0357ccda54
Author: Antonio Vieiro <vi...@users.noreply.github.com>
AuthorDate: Tue Jan 21 22:19:47 2020 +0100
[NETBEANS-1867] java section cleanup
Markup cleanup of some kb/docs/java tutorials.
---
.../kb/docs/java/annotations-custom.asciidoc | 76 +++--
.../kb/docs/java/annotations-custom_ja.asciidoc | 76 +++--
.../kb/docs/java/annotations-custom_pt_BR.asciidoc | 76 +++--
.../kb/docs/java/annotations-custom_ru.asciidoc | 76 +++--
.../kb/docs/java/annotations-custom_zh_CN.asciidoc | 76 +++--
.../kb/docs/java/annotations-lombok.asciidoc | 56 +++-
.../kb/docs/java/annotations-lombok_ja.asciidoc | 56 +++-
.../kb/docs/java/annotations-lombok_pt_BR.asciidoc | 56 +++-
.../kb/docs/java/annotations-lombok_ru.asciidoc | 56 +++-
.../kb/docs/java/annotations-lombok_zh_CN.asciidoc | 56 +++-
.../src/content/kb/docs/java/code-inspect.asciidoc | 32 +-
.../content/kb/docs/java/code-inspect_ja.asciidoc | 89 ++++--
.../kb/docs/java/code-inspect_pt_BR.asciidoc | 84 ++++--
.../content/kb/docs/java/code-inspect_ru.asciidoc | 84 ++++--
.../kb/docs/java/code-inspect_zh_CN.asciidoc | 84 ++++--
.../kb/docs/java/debug-multithreaded.asciidoc | 76 +++--
.../kb/docs/java/debug-multithreaded_ja.asciidoc | 76 +++--
.../docs/java/debug-multithreaded_pt_BR.asciidoc | 76 +++--
.../kb/docs/java/debug-multithreaded_ru.asciidoc | 76 +++--
.../docs/java/debug-multithreaded_zh_CN.asciidoc | 76 +++--
.../src/content/kb/docs/java/debug-visual.asciidoc | 28 +-
.../content/kb/docs/java/debug-visual_ja.asciidoc | 52 +++-
.../kb/docs/java/debug-visual_pt_BR.asciidoc | 52 +++-
.../content/kb/docs/java/debug-visual_ru.asciidoc | 52 +++-
.../kb/docs/java/debug-visual_zh_CN.asciidoc | 52 +++-
.../kb/docs/java/editor-inspect-transform.asciidoc | 10 +-
.../docs/java/editor-inspect-transform_ja.asciidoc | 46 ++-
.../java/editor-inspect-transform_pt_BR.asciidoc | 44 ++-
.../docs/java/editor-inspect-transform_ru.asciidoc | 44 ++-
.../java/editor-inspect-transform_zh_CN.asciidoc | 44 ++-
.../kb/docs/java/gbcustomizer-advanced.asciidoc | 48 ++-
.../kb/docs/java/gbcustomizer-advanced_ja.asciidoc | 49 ++-
.../docs/java/gbcustomizer-advanced_pt_BR.asciidoc | 48 ++-
.../kb/docs/java/gbcustomizer-advanced_ru.asciidoc | 48 ++-
.../docs/java/gbcustomizer-advanced_zh_CN.asciidoc | 48 ++-
.../kb/docs/java/gbcustomizer-basic.asciidoc | 4 +-
.../kb/docs/java/gbcustomizer-basic_ja.asciidoc | 4 +-
.../kb/docs/java/gbcustomizer-basic_pt_BR.asciidoc | 4 +-
.../kb/docs/java/gbcustomizer-basic_ru.asciidoc | 4 +-
.../kb/docs/java/gbcustomizer-basic_zh_CN.asciidoc | 4 +-
.../kb/docs/java/groovy-quickstart.asciidoc | 40 ++-
.../kb/docs/java/groovy-quickstart_ja.asciidoc | 52 +++-
.../kb/docs/java/groovy-quickstart_pt_BR.asciidoc | 52 +++-
.../kb/docs/java/groovy-quickstart_ru.asciidoc | 52 +++-
.../kb/docs/java/groovy-quickstart_zh_CN.asciidoc | 52 +++-
.../kb/docs/java/gui-automatic-i18n.asciidoc | 132 ++++++---
.../kb/docs/java/gui-automatic-i18n_ja.asciidoc | 132 ++++++---
.../kb/docs/java/gui-automatic-i18n_pt_BR.asciidoc | 132 ++++++---
.../kb/docs/java/gui-automatic-i18n_ru.asciidoc | 132 ++++++---
.../kb/docs/java/gui-automatic-i18n_zh_CN.asciidoc | 132 ++++++---
.../src/content/kb/docs/java/gui-binding.asciidoc | 104 +++++--
.../content/kb/docs/java/gui-binding_ja.asciidoc | 104 +++++--
.../kb/docs/java/gui-binding_pt_BR.asciidoc | 104 +++++--
.../content/kb/docs/java/gui-binding_ru.asciidoc | 104 +++++--
.../kb/docs/java/gui-binding_zh_CN.asciidoc | 104 +++++--
.../content/kb/docs/java/gui-filechooser.asciidoc | 92 ++++--
.../kb/docs/java/gui-filechooser_ja.asciidoc | 88 ++++--
.../kb/docs/java/gui-filechooser_pt_BR.asciidoc | 88 ++++--
.../kb/docs/java/gui-filechooser_ru.asciidoc | 88 ++++--
.../kb/docs/java/gui-filechooser_zh_CN.asciidoc | 88 ++++--
.../kb/docs/java/gui-functionality.asciidoc | 9 +-
.../kb/docs/java/gui-functionality_ja.asciidoc | 13 +-
.../kb/docs/java/gui-functionality_pt_BR.asciidoc | 9 +-
.../kb/docs/java/gui-functionality_ru.asciidoc | 9 +-
.../kb/docs/java/gui-functionality_zh_CN.asciidoc | 9 +-
.../src/content/kb/docs/java/gui-gaps.asciidoc | 44 ++-
.../src/content/kb/docs/java/gui-gaps_ja.asciidoc | 44 ++-
.../content/kb/docs/java/gui-gaps_pt_BR.asciidoc | 44 ++-
.../src/content/kb/docs/java/gui-gaps_ru.asciidoc | 44 ++-
.../content/kb/docs/java/gui-gaps_zh_CN.asciidoc | 44 ++-
.../kb/docs/java/gui-image-display.asciidoc | 32 +-
.../kb/docs/java/gui-image-display_ja.asciidoc | 128 ++++++--
.../kb/docs/java/gui-image-display_pt_BR.asciidoc | 128 ++++++--
.../kb/docs/java/gui-image-display_ru.asciidoc | 128 ++++++--
.../kb/docs/java/gui-image-display_zh_CN.asciidoc | 128 ++++++--
.../kb/docs/java/hibernate-java-se.asciidoc | 108 +++++--
.../kb/docs/java/hibernate-java-se_ja.asciidoc | 108 +++++--
.../kb/docs/java/hibernate-java-se_pt_BR.asciidoc | 108 +++++--
.../kb/docs/java/hibernate-java-se_ru.asciidoc | 108 +++++--
.../kb/docs/java/hibernate-java-se_zh_CN.asciidoc | 108 +++++--
.../content/kb/docs/java/javase-deploy.asciidoc | 56 +++-
.../content/kb/docs/java/javase-deploy_ja.asciidoc | 72 +++--
.../kb/docs/java/javase-deploy_pt_BR.asciidoc | 72 +++--
.../content/kb/docs/java/javase-deploy_ru.asciidoc | 72 +++--
.../kb/docs/java/javase-deploy_zh_CN.asciidoc | 72 +++--
.../content/kb/docs/java/javase-embedded.asciidoc | 68 +++--
.../kb/docs/java/javase-embedded_ja.asciidoc | 68 +++--
.../kb/docs/java/javase-embedded_pt_BR.asciidoc | 68 +++--
.../kb/docs/java/javase-embedded_ru.asciidoc | 68 +++--
.../kb/docs/java/javase-embedded_zh_CN.asciidoc | 68 +++--
.../content/kb/docs/java/javase-intro_ja.asciidoc | 84 ++++--
.../kb/docs/java/javase-intro_pt_BR.asciidoc | 84 ++++--
.../content/kb/docs/java/javase-intro_ru.asciidoc | 84 ++++--
.../kb/docs/java/javase-intro_zh_CN.asciidoc | 84 ++++--
.../src/content/kb/docs/java/javase-jdk7.asciidoc | 32 +-
.../content/kb/docs/java/javase-jdk7_ja.asciidoc | 32 +-
.../kb/docs/java/javase-jdk7_pt_BR.asciidoc | 32 +-
.../content/kb/docs/java/javase-jdk7_ru.asciidoc | 32 +-
.../kb/docs/java/javase-jdk7_zh_CN.asciidoc | 32 +-
.../src/content/kb/docs/java/javase-jdk8.asciidoc | 20 +-
.../content/kb/docs/java/javase-jdk8_ja.asciidoc | 20 +-
.../kb/docs/java/javase-jdk8_pt_BR.asciidoc | 20 +-
.../content/kb/docs/java/javase-jdk8_ru.asciidoc | 20 +-
.../kb/docs/java/javase-jdk8_zh_CN.asciidoc | 20 +-
.../src/content/kb/docs/java/jmx-getstart.asciidoc | 32 +-
.../content/kb/docs/java/jmx-getstart_ja.asciidoc | 32 +-
.../kb/docs/java/jmx-getstart_pt_BR.asciidoc | 32 +-
.../content/kb/docs/java/jmx-getstart_ru.asciidoc | 32 +-
.../kb/docs/java/jmx-getstart_zh_CN.asciidoc | 32 +-
.../kb/docs/java/jmx-manager-tutorial.asciidoc | 50 +++-
.../kb/docs/java/jmx-manager-tutorial_ja.asciidoc | 50 +++-
.../docs/java/jmx-manager-tutorial_pt_BR.asciidoc | 50 +++-
.../kb/docs/java/jmx-manager-tutorial_ru.asciidoc | 50 +++-
.../docs/java/jmx-manager-tutorial_zh_CN.asciidoc | 50 +++-
.../src/content/kb/docs/java/jmx-tutorial.asciidoc | 122 ++++++--
.../content/kb/docs/java/jmx-tutorial_ja.asciidoc | 122 ++++++--
.../kb/docs/java/jmx-tutorial_pt_BR.asciidoc | 122 ++++++--
.../content/kb/docs/java/jmx-tutorial_ru.asciidoc | 122 ++++++--
.../kb/docs/java/jmx-tutorial_zh_CN.asciidoc | 122 ++++++--
.../src/content/kb/docs/java/junit-intro.asciidoc | 124 ++++++--
.../content/kb/docs/java/junit-intro_ja.asciidoc | 140 ++++++---
.../kb/docs/java/junit-intro_pt_BR.asciidoc | 140 ++++++---
.../content/kb/docs/java/junit-intro_ru.asciidoc | 140 ++++++---
.../kb/docs/java/junit-intro_zh_CN.asciidoc | 140 ++++++---
.../kb/docs/java/maven-hib-java-se.asciidoc | 152 +++++++---
.../kb/docs/java/maven-hib-java-se_ja.asciidoc | 152 +++++++---
.../kb/docs/java/maven-hib-java-se_pt_BR.asciidoc | 152 +++++++---
.../kb/docs/java/maven-hib-java-se_ru.asciidoc | 152 +++++++---
.../kb/docs/java/maven-hib-java-se_zh_CN.asciidoc | 152 +++++++---
.../src/content/kb/docs/java/native_pkg.asciidoc | 20 +-
.../content/kb/docs/java/native_pkg_ja.asciidoc | 20 +-
.../content/kb/docs/java/native_pkg_pt_BR.asciidoc | 20 +-
.../content/kb/docs/java/native_pkg_ru.asciidoc | 20 +-
.../content/kb/docs/java/native_pkg_zh_CN.asciidoc | 20 +-
.../kb/docs/java/profile-loadgenerator.asciidoc | 4 +-
.../kb/docs/java/profile-loadgenerator_ja.asciidoc | 4 +-
.../docs/java/profile-loadgenerator_pt_BR.asciidoc | 4 +-
.../kb/docs/java/profile-loadgenerator_ru.asciidoc | 4 +-
.../docs/java/profile-loadgenerator_zh_CN.asciidoc | 4 +-
.../content/kb/docs/java/profiler-intro.asciidoc | 56 +++-
.../kb/docs/java/profiler-intro_ja.asciidoc | 56 +++-
.../kb/docs/java/profiler-intro_pt_BR.asciidoc | 56 +++-
.../kb/docs/java/profiler-intro_ru.asciidoc | 56 +++-
.../kb/docs/java/profiler-intro_zh_CN.asciidoc | 56 +++-
.../kb/docs/java/profiler-profilingpoints.asciidoc | 48 ++-
.../docs/java/profiler-profilingpoints_ja.asciidoc | 48 ++-
.../java/profiler-profilingpoints_pt_BR.asciidoc | 48 ++-
.../docs/java/profiler-profilingpoints_ru.asciidoc | 48 ++-
.../java/profiler-profilingpoints_zh_CN.asciidoc | 48 ++-
.../kb/docs/java/quickstart-gui-legend.asciidoc | 54 ++--
.../kb/docs/java/quickstart-gui-legend_ja.asciidoc | 62 ++--
.../docs/java/quickstart-gui-legend_pt_BR.asciidoc | 64 ++--
.../kb/docs/java/quickstart-gui-legend_ru.asciidoc | 63 ++--
.../docs/java/quickstart-gui-legend_zh_CN.asciidoc | 60 ++--
.../content/kb/docs/java/quickstart-gui.asciidoc | 290 +++++++-----------
.../kb/docs/java/quickstart-gui_ja.asciidoc | 324 ++++++++++----------
.../kb/docs/java/quickstart-gui_pt_BR.asciidoc | 328 ++++++++++-----------
.../kb/docs/java/quickstart-gui_ru.asciidoc | 317 ++++++++++----------
.../kb/docs/java/quickstart-gui_zh_CN.asciidoc | 314 ++++++++++----------
.../src/content/kb/docs/java/quickstart.asciidoc | 16 +-
.../content/kb/docs/java/quickstart_ca.asciidoc | 12 +-
.../content/kb/docs/java/quickstart_ja.asciidoc | 12 +-
.../content/kb/docs/java/quickstart_pt_BR.asciidoc | 12 +-
.../content/kb/docs/java/quickstart_ru.asciidoc | 12 +-
.../content/kb/docs/java/quickstart_zh_CN.asciidoc | 12 +-
165 files changed, 8176 insertions(+), 3483 deletions(-)
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom.asciidoc
index 1b4953c..a6891fe 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom.asciidoc
@@ -62,10 +62,16 @@ In this exercise you will create a class library project.
When you click Finish, the IDE creates the class library project and lists the project in the Projects window.
+
+
[start=3]
-3. Right-click the AnnProcessor project node in the Projects window and choose Properties.
-4. In the Sources category, confirm that either JDK 6 or JDK 7 are specified as the source/binary format.
-5. Select the Libraries tab and confirm that the Java platform is set to either JDK 1.6 or JDK 1.7. Click OK to close the Project Properties window.
+. Right-click the AnnProcessor project node in the Projects window and choose Properties.
+
+[start=4]
+. In the Sources category, confirm that either JDK 6 or JDK 7 are specified as the source/binary format.
+
+[start=5]
+. Select the Libraries tab and confirm that the Java platform is set to either JDK 1.6 or JDK 1.7. Click OK to close the Project Properties window.
In this exercise you will create two Java packages and one Java class in each of the packages.
@@ -77,10 +83,16 @@ After you create the two Java packages, the structure of the project should be s
image::images/packages.png[title="The structure of the project for the annotation processor."]
+
+
[start=4]
-4. Right-click the ``ann`` Java package and choose New > Java class.
-5. Type ``Handleable`` for the Class Name. Click Finish.
-6. Modify the new ``Handleable.java`` file to make the following changes. Save the file.
+. Right-click the ``ann`` Java package and choose New > Java class.
+
+[start=5]
+. Type ``Handleable`` for the Class Name. Click Finish.
+
+[start=6]
+. Modify the new ``Handleable.java`` file to make the following changes. Save the file.
[source,java]
----
@@ -98,10 +110,16 @@ TIP: In annotation declarations, you can also specify additional parameters, for
You now need to add code for the annotation processor to process the ``Handleable`` annotation.
+
+
[start=7]
-7. Right-click the ``proc`` Java package and choose New > Java class.
-8. Type ``HandleableProcessor`` for the Class Name. Click Finish.
-9. Modify the ``HandleableProcessor.java`` class to add the following code. Save your changes.
+. Right-click the ``proc`` Java package and choose New > Java class.
+
+[start=8]
+. Type ``HandleableProcessor`` for the Class Name. Click Finish.
+
+[start=9]
+. Modify the ``HandleableProcessor.java`` class to add the following code. Save your changes.
NOTE: The value of ``@SupportedSourceVersion`` will depend upon the version of the JDK that you are using and will be either ``(SourceVersion.RELEASE_7)`` or ``(SourceVersion.RELEASE_6)`` .
@@ -316,8 +334,10 @@ public class HandleableProcessor extends AbstractProcessor {
}
----
+
+
[start=10]
-10. Build the project by right-clicking the ``AnnProcessor`` project and choosing Build.
+. Build the project by right-clicking the ``AnnProcessor`` project and choosing Build.
== Using the Annotation Processor in the IDE
@@ -330,9 +350,13 @@ In this section you will create a Java Application project in which the annotati
image::images/demo-project-wizard.png[title="Creating the Demo project in the New Project wizard."]
+
+
[start=4]
-4. Open the Project Properties window and confirm that either JDK 6 or JDK 7 are selected as the source/binary format in the Sources panel and that the Java platform is set to JDK 1.6 or JDK 1.7 in the Libraries panel.
-5. Modify the ``Main.java`` class to add the following code. Save your changes.
+. Open the Project Properties window and confirm that either JDK 6 or JDK 7 are selected as the source/binary format in the Sources panel and that the Java platform is set to JDK 1.6 or JDK 1.7 in the Libraries panel.
+
+[start=5]
+. Modify the ``Main.java`` class to add the following code. Save your changes.
[source,java]
----
@@ -363,17 +387,25 @@ In this simple example, the ``handleStuff`` method only prints out the current
After you save the ``Main.java`` code you will see that the IDE reports multiple compilation errors. This is because the annotation processor has not been added yet to the project.
+
+
[start=6]
-6. Right-click the ``Demo`` project node in the Projects window, choose Properties, then select the Libraries category in the Project Properties window.
-7. In the Compile tab, click Add Project and locate the ``AnnProcessor`` project.
+. Right-click the ``Demo`` project node in the Projects window, choose Properties, then select the Libraries category in the Project Properties window.
+
+[start=7]
+. In the Compile tab, click Add Project and locate the ``AnnProcessor`` project.
image::images/demo-properties-compile.png[title="Compile tab in Libraries category of the project's Properties window"]
The Compile tab corresponds to the ``-classpath`` option of the link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Java compiler+]. Because the annotation processor is a single JAR file that contains both the annotation definition and the annotation processor, you should add it to the project's classpath, which is the Compile tab.
+
+
[start=8]
-8. Select the Compiling category in the Project Properties window and select the Enable Annotation Processing and Enable Annotation Processing in Editor checkboxes.
-9. Specify the annotation processor to run by click the Add button next to the Annotation Processors text area and typing * ``proc.HandleableProcessor`` * in the Annotation Processor FQN field.
+. Select the Compiling category in the Project Properties window and select the Enable Annotation Processing and Enable Annotation Processing in Editor checkboxes.
+
+[start=9]
+. Specify the annotation processor to run by click the Add button next to the Annotation Processors text area and typing * ``proc.HandleableProcessor`` * in the Annotation Processor FQN field.
image::images/demo-processor-fqn.png[title="Annotation Processor FQN dialog box"]
@@ -381,13 +413,17 @@ The Compiling category in the Project Properties window should look like the fol
image::images/demo-properties-compiling.png[title="Compiling category in the project's Properties window"]
+
+
[start=10]
-10. Click OK in the Properties window.
+. Click OK in the Properties window.
NOTE: In the ``Main.java`` file you might still see compilation errors. This is because the IDE cannot yet find the ``MainExtras.java`` file that declares the ``handleStuff`` method. The ``MainExtras.java`` file will be generated after you build the Demo project for the first time. If Compile On Save is enabled for you project, the IDE compiled the project when you saved ``Main.java`` .
+
+
[start=11]
-11. Right-click the Demo project and choose Build.
+. Right-click the Demo project and choose Build.
After you build the project, if you look at the project in the Projects window you can see a new ``Generated Sources`` node with the ``demo/MainExtras.java`` file.
@@ -409,8 +445,10 @@ public abstract class MainExtras {
}
----
+
+
[start=12]
-12. Right-click the Demo project and choose Run.
+. Right-click the Demo project and choose Run.
When you click Run you should see the following in the Output window. The Demo project compiles and prints the message.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ja.asciidoc
index 6c2caa0..cd643ee 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ja.asciidoc
@@ -64,9 +64,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="この
「終了」をクリックすると、IDEによってクラス・ライブラリ・プロジェクトが作成され、そのプロジェクトが「プロジェクト」ウィンドウに表示されます。
-3. 「プロジェクト」ウィンドウで「AnnProcessor」プロジェクト・ノードを右クリックし、「プロパティ」を選択します。
-4. 「ソース」カテゴリで、ソース/バイナリ形式としてJDK 6またはJDK 7が指定されていることを確認します。
-5. 「ライブラリ」タブを選択し、「Javaプラットフォーム」がJDK 1.6またはJDK 1.7またはに設定されていることを確認します。「OK」をクリックして、「プロジェクト・プロパティ」ウィンドウを閉じます。
+
+[start=3]
+. 「プロジェクト」ウィンドウで「AnnProcessor」プロジェクト・ノードを右クリックし、「プロパティ」を選択します。
+
+[start=4]
+. 「ソース」カテゴリで、ソース/バイナリ形式としてJDK 6またはJDK 7が指定されていることを確認します。
+
+[start=5]
+. 「ライブラリ」タブを選択し、「Javaプラットフォーム」がJDK 1.6またはJDK 1.7またはに設定されていることを確認します。「OK」をクリックして、「プロジェクト・プロパティ」ウィンドウを閉じます。
この課題では、2つのJavaパッケージを作成し、各パッケージ内に1つのJavaクラスを作成します。
@@ -77,9 +83,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="この
2つのJavaパッケージを作成すると、プロジェクトの構造は次のイメージのようになるはずです。
image::images/packages.png[title="注釈プロセッサのプロジェクトの構造。"]
-4. 「 ``ann`` 」Javaパッケージを右クリックし、「新規」>「Javaクラス」を選択します。
-5. 「クラス名」に「* ``Handleable`` *」と入力します。「終了」をクリックします。
-6. 新しい ``Handleable.java`` ファイルを編集して、次の変更を加えます。ファイルを保存します。
+
+[start=4]
+. 「 ``ann`` 」Javaパッケージを右クリックし、「新規」>「Javaクラス」を選択します。
+
+[start=5]
+. 「クラス名」に「* ``Handleable`` *」と入力します。「終了」をクリックします。
+
+[start=6]
+. 新しい ``Handleable.java`` ファイルを編集して、次の変更を加えます。ファイルを保存します。
[source,java]
----
@@ -97,9 +109,15 @@ public *@interface* Handleable {
ここで、 ``Handleable`` 注釈を処理する注釈プロセッサのコードを追加する必要があります。
-7. 「* ``proc`` *」Javaパッケージを右クリックし、「新規」>「Javaクラス」を選択します。
-8. 「クラス名」に「* ``HandleableProcessor`` *」と入力します。「終了」をクリックします。
-9. ``HandleableProcessor.java`` クラスを変更して次のコードを追加します。変更を保存します。
+
+[start=7]
+. 「* ``proc`` *」Javaパッケージを右クリックし、「新規」>「Javaクラス」を選択します。
+
+[start=8]
+. 「クラス名」に「* ``HandleableProcessor`` *」と入力します。「終了」をクリックします。
+
+[start=9]
+. ``HandleableProcessor.java`` クラスを変更して次のコードを追加します。変更を保存します。
*注意:* ``@SupportedSourceVersion`` (*太字*)の値は使用しているJDKのバージョンによって異なり、 ``(SourceVersion.RELEASE_7)`` または ``(SourceVersion.RELEASE_6)`` になります。
@@ -314,7 +332,9 @@ return new String(c);
}
*}
----
-10. 「 ``AnnProcessor`` 」プロジェクトを右クリックし、「ビルド」を選択することによってプロジェクトをビルドします。
+
+[start=10]
+. 「 ``AnnProcessor`` 」プロジェクトを右クリックし、「ビルド」を選択することによってプロジェクトをビルドします。
== IDEでの注釈プロセッサの使用
@@ -325,8 +345,12 @@ return new String(c);
2. 名前と場所ページで、「プロジェクト名」として* ``「Demo」`` *と入力し、プロジェクトの場所を指定します。
3. 「メイン・クラスの作成」フィールドに「* ``demo.Main`` *」と入力します。「終了」をクリックします。
image::images/demo-project-wizard.png[title="新規プロジェクト・ウィザードでのDemoプロジェクトの作成。"]
-4. 「プロジェクト・プロパティ」ウィンドウを開き、「ソース」パネルでソース/バイナリ形式としてJDK 6またはJDK 7が選択されていること、および「ライブラリ」パネルで「Javaプラットフォーム」がJDK 1.6またはJDK 1.7に設定されていることを確認します。
-5. ``Main.java`` クラスを変更して次のコードを追加します。変更を保存します。
+
+[start=4]
+. 「プロジェクト・プロパティ」ウィンドウを開き、「ソース」パネルでソース/バイナリ形式としてJDK 6またはJDK 7が選択されていること、および「ライブラリ」パネルで「Javaプラットフォーム」がJDK 1.6またはJDK 1.7に設定されていることを確認します。
+
+[start=5]
+. ``Main.java`` クラスを変更して次のコードを追加します。変更を保存します。
[source,java]
----
@@ -357,24 +381,36 @@ public class Main *extends MainExtras* {
``Main.java`` コードを保存した後、IDEによって複数のコンパイル・エラーが報告されたことが表示されます。これは、まだこのプロジェクトに注釈プロセッサが追加されていないためです。
-6. 「プロジェクト・プロパティ」ウィンドウで ``「Demo」`` プロジェクト・ノードを右クリックし、「プロパティ」を選択した後、「プロパティ」ウィンドウで「ライブラリ」カテゴリを選択します。
-7. 「コンパイル」タブで「プロジェクトの追加」をクリックし、「 ``AnnProcessor`` 」プロジェクトを指定します。
+
+[start=6]
+. 「プロジェクト・プロパティ」ウィンドウで ``「Demo」`` プロジェクト・ノードを右クリックし、「プロパティ」を選択した後、「プロパティ」ウィンドウで「ライブラリ」カテゴリを選択します。
+
+[start=7]
+. 「コンパイル」タブで「プロジェクトの追加」をクリックし、「 ``AnnProcessor`` 」プロジェクトを指定します。
image::images/demo-properties-compile.png[title="プロジェクトの「プロパティ」ウィンドウ内の「ライブラリ」カテゴリにある「コンパイル」タブ"]
「コンパイル」タブは、link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Javaコンパイラ+]の ``-classpath`` オプションに相当します。この注釈プロセッサは、注釈定義と注釈プロセッサの両方を含む単一のJARファイルであるため、これをプロジェクトのクラスパス(つまり「コンパイル」タブ)に追加する必要があります。
-8. 「プロジェクト・プロパティ」ウィンドウで「コンパイル」カテゴリを選択し、「注釈処理を有効にする」および「エディタでの注釈処理を有効にする」チェックボックスを選択します。
-9. 「注釈プロセッサ」テキスト領域の横にある「追加」ボタンをクリックし、「注釈プロセッサFQN」フィールドに * ``「proc.HandleableProcessor」`` *と入力することによって、実行する注釈プロセッサを指定します。
+
+[start=8]
+. 「プロジェクト・プロパティ」ウィンドウで「コンパイル」カテゴリを選択し、「注釈処理を有効にする」および「エディタでの注釈処理を有効にする」チェックボックスを選択します。
+
+[start=9]
+. 「注釈プロセッサ」テキスト領域の横にある「追加」ボタンをクリックし、「注釈プロセッサFQN」フィールドに * ``「proc.HandleableProcessor」`` *と入力することによって、実行する注釈プロセッサを指定します。
image::images/demo-processor-fqn.png[title="「注釈プロセッサFQN」ダイアログ・ボックス"]
「プロジェクト・プロパティ」ウィンドウ内の「コンパイル」カテゴリは、次のイメージのように表示されるはずです。
image::images/demo-properties-compiling.png[title="プロジェクトの「プロパティ」ウィンドウ内の「コンパイル」カテゴリ"]
-10. 「プロパティ」ウィンドウで「OK」をクリックします。
+
+[start=10]
+. 「プロパティ」ウィンドウで「OK」をクリックします。
*注意:* ``Main.java`` ファイルでは、依然としてコンパイル・エラーが表示される場合があります。これは、 ``handleStuff`` メソッドを宣言している ``MainExtras.java`` ファイルを、IDEがまだ認識できていないためです。 ``MainExtras.java`` ファイルは、最初にDemoプロジェクトをビルドした後で生成されます。プロジェクトで「保存時にコンパイル」が有効になっている場合は、 ``Main.java`` を保存したときにIDEがプロジェクトをコンパイルしました。
-11. 「Demo」プロジェクトを右クリックし、「ビルド」を選択します。
+
+[start=11]
+. 「Demo」プロジェクトを右クリックし、「ビルド」を選択します。
プロジェクトをビルドした後に「プロジェクト」ウィンドウでそのプロジェクトを見ると、新しい ``「生成されたソース」`` ノードが ``demo/MainExtras.java`` ファイルとともに表示されます。
@@ -395,7 +431,9 @@ public abstract class MainExtras {
}
}
----
-12. 「Demo」プロジェクトを右クリックし、「実行」を選択します。
+
+[start=12]
+. 「Demo」プロジェクトを右クリックし、「実行」を選択します。
「実行」をクリックすると、「出力」ウィンドウに次が表示されるはずです。Demoプロジェクトがコンパイルされ、メッセージが出力されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_pt_BR.asciidoc
index a3cb1b5..dc0e256 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_pt_BR.asciidoc
@@ -64,9 +64,15 @@ Neste exercício, você criará um projeto de biblioteca de classes.
Quando você clica em Finalizar, o IDE cria o projeto de biblioteca de classes e lista o projeto na janela Projetos.
-3. Clique com o botão direito do mouse no nó do projeto AnnProcessor na janela Projetos e escolha Propriedades.
-4. Na categoria Códigos-fonte, confirme se JDK 6 ou JDK 7 está especificado como o formato de código-fonte/binário.
-5. Selecione a guia Bibliotecas e confirme se a plataforma Java está definida como JDK 1.6 ou JDK 1.7. Clique em OK para fechar a janela Propriedades do Projeto.
+
+[start=3]
+. Clique com o botão direito do mouse no nó do projeto AnnProcessor na janela Projetos e escolha Propriedades.
+
+[start=4]
+. Na categoria Códigos-fonte, confirme se JDK 6 ou JDK 7 está especificado como o formato de código-fonte/binário.
+
+[start=5]
+. Selecione a guia Bibliotecas e confirme se a plataforma Java está definida como JDK 1.6 ou JDK 1.7. Clique em OK para fechar a janela Propriedades do Projeto.
Neste exercício, você criará dois pacotes Java e uma classe Java em cada um destes pacotes.
@@ -77,9 +83,15 @@ Neste exercício, você criará dois pacotes Java e uma classe Java em cada um d
Após ter criado os dois pacotes Java, a estrutura do projeto deverá ser similar à seguinte imagem.
image::images/packages.png[title="A estrutura do projeto para o processador de anotação."]
-4. Clique com o botão direito do mouse no pacote Java ``ann`` e selecione Nova > Classe Java.
-5. Digite * ``Handleable`` * para o nome da classe. Clique em Finalizar.
-6. Modifique o novo arquivo ``Handleable.java`` para fazer as alterações a seguir. Salve o arquivo.
+
+[start=4]
+. Clique com o botão direito do mouse no pacote Java ``ann`` e selecione Nova > Classe Java.
+
+[start=5]
+. Digite * ``Handleable`` * para o nome da classe. Clique em Finalizar.
+
+[start=6]
+. Modifique o novo arquivo ``Handleable.java`` para fazer as alterações a seguir. Salve o arquivo.
[source,java]
----
@@ -97,9 +109,15 @@ public *@interface* Handleable {
Agora precisamos adicionar um código para que o processador de anotação processe a anotação ``Handleable`` .
-7. Clique com o botão direito do mouse no pacote * ``proc`` * e selecione Nova > Classe Java.
-8. Digite * ``HandleableProcessor`` * para o Nome da Classe. Clique em Finalizar.
-9. Modifique a classe ``HandleableProcessor.java`` para adicionar o código a seguir. Salve as alterações.
+
+[start=7]
+. Clique com o botão direito do mouse no pacote * ``proc`` * e selecione Nova > Classe Java.
+
+[start=8]
+. Digite * ``HandleableProcessor`` * para o Nome da Classe. Clique em Finalizar.
+
+[start=9]
+. Modifique a classe ``HandleableProcessor.java`` para adicionar o código a seguir. Salve as alterações.
*Observação.* O valor de ``@SupportedSourceVersion`` (em *negrito*) dependerá da versão do JDK que você está usando e será ``(SourceVersion.RELEASE_7)`` ou ``(SourceVersion.RELEASE_6)`` .
@@ -314,7 +332,9 @@ return new String(c);
}
*}
----
-10. Compile o projeto clicando com o botão direito do mouse no projeto ``AnnProcessor`` e escolhendo Compilar.
+
+[start=10]
+. Compile o projeto clicando com o botão direito do mouse no projeto ``AnnProcessor`` e escolhendo Compilar.
== Usando o processador de anotação no IDE
@@ -325,8 +345,12 @@ Nesta seção, você criará um projeto da Aplicação Java no qual o processado
2. Na página Nome e Localização, digite * ``Demo`` * como Nome do Projeto e especifique o local do projeto.
3. Digite * ``demo.Main`` * no campo Criar Classe Principal. Clique em Finalizar.
image::images/demo-project-wizard.png[title="Criando projeto de Demonstração no assistente de Novo Projeto."]
-4. Abra a janela Propriedades do Projeto e confirme se JDK 6 ou JDK 7 está selecionado como o formato de código-fonte/binário no painel Códigos-fonte e se a plataforma Java está definida como JDK 1.6 ou JDK 1.7 no painel Bibliotecas.
-5. Modifique a classe ``Main.java`` para adicionar o código a seguir. Salve as alterações.
+
+[start=4]
+. Abra a janela Propriedades do Projeto e confirme se JDK 6 ou JDK 7 está selecionado como o formato de código-fonte/binário no painel Códigos-fonte e se a plataforma Java está definida como JDK 1.6 ou JDK 1.7 no painel Bibliotecas.
+
+[start=5]
+. Modifique a classe ``Main.java`` para adicionar o código a seguir. Salve as alterações.
[source,java]
----
@@ -357,24 +381,36 @@ Em nosso exemplo simples, o método ``handleStuff`` somente imprime o valor at
Após salvar o código ``Main.java`` , você verá que o IDE relata diversos erros de compilação. Isso acontece porque o processador de anotação ainda não foi adicionado no projeto.
-6. Clique com o botão direito do mouse no nó do projeto ``Demo`` , na janela Projetos, escolha Propriedades e, em seguida, selecione a categoria Bibliotecas na janela Propriedades do Projeto.
-7. Na guia Compilar, clique em Adicionar Projeto e localize o projeto ``AnnProcessor`` .
+
+[start=6]
+. Clique com o botão direito do mouse no nó do projeto ``Demo`` , na janela Projetos, escolha Propriedades e, em seguida, selecione a categoria Bibliotecas na janela Propriedades do Projeto.
+
+[start=7]
+. Na guia Compilar, clique em Adicionar Projeto e localize o projeto ``AnnProcessor`` .
image::images/demo-properties-compile.png[title="Guia Compilar na categoria Bibliotecas da janela Propriedades do projeto"]
A guia Compilar corresponde a opção ``-classpath`` do link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+compilador Java+]. Como o processador de anotação é um arquivo JAR único que contém a definição da anotação e o processador de anotação, ele deve ser adicionado na classpath do projeto, que é a guia Compilar.
-8. Selecione a categoria Compilação na janela Propriedades do Projeto e marque as caixas de seleção Ativar Processamento de Anotações e Ativar Processamento de Anotações no Editor.
-9. Especifique o processador de anotações a ser executado clicando no botão Adicionar ao lado da área de texto Processadores de Anotações e digitando * ``proc.HandleableProcessor`` * no campo FQN do Processador de Anotações.
+
+[start=8]
+. Selecione a categoria Compilação na janela Propriedades do Projeto e marque as caixas de seleção Ativar Processamento de Anotações e Ativar Processamento de Anotações no Editor.
+
+[start=9]
+. Especifique o processador de anotações a ser executado clicando no botão Adicionar ao lado da área de texto Processadores de Anotações e digitando * ``proc.HandleableProcessor`` * no campo FQN do Processador de Anotações.
image::images/demo-processor-fqn.png[title="Caixa de diálogo FQN do Processador de Anotação"]
A categoria Compilação na janela Propriedades do Projeto deve ser semelhante à imagem a seguir.
image::images/demo-properties-compiling.png[title="Categoria compilação na janela Propriedades do projeto"]
-10. Clique em OK na janela Propriedades.
+
+[start=10]
+. Clique em OK na janela Propriedades.
*Observação.* No arquivo ``Main.java`` talvez você ainda veja os erros de compilação. Isso é porque o IDE ainda não pode localizar o arquivo ``MainExtras.java`` que declara o método ``handleStuff`` . O arquivo ``MainExtras.java`` será gerado após você desenvolver o projeto Demo pela primeira vez. Se Compilar ao Salvar estiver ativado para seu projeto, o IDE compilou o projeto quando você salvou o ``Main.java`` .
-11. Clique com o botão direito do mouse no projeto Demo e escolha Construir.
+
+[start=11]
+. Clique com o botão direito do mouse no projeto Demo e escolha Construir.
Após construir o projeto, se você examinar os projetos na janela Projetos, poderá agora ver um novo nó ``Códigos-fonte Gerados`` com o arquivo ``demo/MainExtras.java`` .
@@ -395,7 +431,9 @@ public abstract class MainExtras {
}
}
----
-12. Clique com o botão direito do mouse no projeto Demonstração e escolha Executar.
+
+[start=12]
+. Clique com o botão direito do mouse no projeto Demonstração e escolha Executar.
Quando você clicar em Executar, deverá ver o seguinte na janela Saída. O projeto Demonstração é compilado e imprime a mensagem.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ru.asciidoc
index e495eb1..d978f37 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_ru.asciidoc
@@ -64,9 +64,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="Сод
При нажатии кнопки "Готово" среда IDE создаст проект библиотеки классов, который появится в окне Projects ("Проекты").
-3. Щелкните правой кнопкой мыши узел проекта AnnProcessor в окне Projects ("Проекты") и выберите Properties ("Свойства").
-4. В категории "Источники" подтвердите, что для JDK 6 или JDK 7 указан формат исходного кода/двоичный формат.
-5. Выберите вкладку "Библиотеки" и подтвердите, что платформой Java является JDK 1.6 или JDK 1.7. Нажмите кнопку "ОК", чтобы закрыть окно Project Properties ("Свойства проекта").
+
+[start=3]
+. Щелкните правой кнопкой мыши узел проекта AnnProcessor в окне Projects ("Проекты") и выберите Properties ("Свойства").
+
+[start=4]
+. В категории "Источники" подтвердите, что для JDK 6 или JDK 7 указан формат исходного кода/двоичный формат.
+
+[start=5]
+. Выберите вкладку "Библиотеки" и подтвердите, что платформой Java является JDK 1.6 или JDK 1.7. Нажмите кнопку "ОК", чтобы закрыть окно Project Properties ("Свойства проекта").
В этом упражнении мы создадим несколько пакетов Java и по одному классу Java в каждом из пакетов.
@@ -77,9 +83,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="Сод
После создания двух пакетов Java структура проекта должна быть подобной изображенной ниже.
image::images/packages.png[title="Структура проекта для обработчика аннотаций."]
-4. Щелкните правой кнопкой мыши пакет Java ``ann`` и выберите New ("Создать") > Java class ("Класс Java").
-5. Введите * ``Handleable`` * в поле Class Name ("Имя класса"). Нажмите кнопку "Завершить".
-6. Измените файл ``Handleable.java`` , добавив приведенный ниже код. Сохраните файл.
+
+[start=4]
+. Щелкните правой кнопкой мыши пакет Java ``ann`` и выберите New ("Создать") > Java class ("Класс Java").
+
+[start=5]
+. Введите * ``Handleable`` * в поле Class Name ("Имя класса"). Нажмите кнопку "Завершить".
+
+[start=6]
+. Измените файл ``Handleable.java`` , добавив приведенный ниже код. Сохраните файл.
[source,java]
----
@@ -97,9 +109,15 @@ public *@interface* Handleable {
Теперь необходимо добавить к обработчику аннотаций код для обработки аннотации ``Handleable`` .
-7. Щелкните правой кнопкой мыши пакет* `` Java `` proc* и выберите New ("Создать") > Java class ("Класс Java").
-8. Введите * ``HandleableProcessor`` * в поле Class Name ("Имя класса"). Нажмите кнопку "Завершить".
-9. Измените класс ``HandleableProcessor.java`` , добавив нижеприведенный код. Сохраните изменения.
+
+[start=7]
+. Щелкните правой кнопкой мыши пакет* `` Java `` proc* и выберите New ("Создать") > Java class ("Класс Java").
+
+[start=8]
+. Введите * ``HandleableProcessor`` * в поле Class Name ("Имя класса"). Нажмите кнопку "Завершить".
+
+[start=9]
+. Измените класс ``HandleableProcessor.java`` , добавив нижеприведенный код. Сохраните изменения.
*Примечание.* Значение ``@SupportedSourceVersion`` (выделено *жирным шрифтом*) зависит от используемой версии JDK и может быть двух вариантов: ``(SourceVersion.RELEASE_7)`` или ``(SourceVersion.RELEASE_6)`` .
@@ -314,7 +332,9 @@ return new String(c);
}
*}
----
-10. Создайте проект, щелкнув правой кнопкой мыши проект ``AnnProcessor`` и выбрав 'Сборка'.
+
+[start=10]
+. Создайте проект, щелкнув правой кнопкой мыши проект ``AnnProcessor`` и выбрав 'Сборка'.
== Работа с обработчиком аннотаций в среде IDE
@@ -325,8 +345,12 @@ return new String(c);
2. На странице "Имя и расположение" введите * ``Demo`` * в поле "Имя проекта" и укажите расположение проекта.
3. Введите * ``demo.Main`` * в поле Create Main Class ("Создать главный класс"). Нажмите кнопку "Завершить".
image::images/demo-project-wizard.png[title="Создание проекта Demo в мастере создания проектов."]
-4. Откройте окно 'Свойства проекта' и убедитесь, что JDK 6 или JDK 7 выбран как двоичный формат/формат исходного кода на панели "Исходные коды", а также что JDK 1.6 or JDK 1.7 установлен как платформа Java на панели "Библиотеки".
-5. Измените класс ``Main.java`` , добавив приведенный ниже код. Сохраните изменения.
+
+[start=4]
+. Откройте окно 'Свойства проекта' и убедитесь, что JDK 6 или JDK 7 выбран как двоичный формат/формат исходного кода на панели "Исходные коды", а также что JDK 1.6 or JDK 1.7 установлен как платформа Java на панели "Библиотеки".
+
+[start=5]
+. Измените класс ``Main.java`` , добавив приведенный ниже код. Сохраните изменения.
[source,java]
----
@@ -357,24 +381,36 @@ public class Main *extends MainExtras* {
После сохранения кода ``Main.java`` можно увидеть, что среда IDE сообщает о ряде ошибок компиляции. Это происходит, поскольку обработчик аннотаций еще не добавлен в проект.
-6. Щелкните правой кнопкой мыши узел проекта ``Demo`` в окне "Проекты", выберите "Свойства", затем выберите категорию "Библиотеки" в окне 'Свойства проекта'.
-7. На вкладке Compile ("Компиляция") щелкните Add Project ("Добавить проект") и найдите проект ``AnnProcessor`` .
+
+[start=6]
+. Щелкните правой кнопкой мыши узел проекта ``Demo`` в окне "Проекты", выберите "Свойства", затем выберите категорию "Библиотеки" в окне 'Свойства проекта'.
+
+[start=7]
+. На вкладке Compile ("Компиляция") щелкните Add Project ("Добавить проект") и найдите проект ``AnnProcessor`` .
image::images/demo-properties-compile.png[title="Вкладка 'Компилировать' в категории 'Библиотеки' окна свойств проекта"]
Вкладка "Компиляция" соответствует параметру ``-classpath`` link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+компилятора Java+]. Поскольку обработчик аннотаций является единым файлом JAR, который содержит как определение аннотаций, так и обработчик аннотаций, его следует добавить к пути классов для проекта, которым является вкладка Compile ("Компиляция").
-8. Выберите категорию "Компиляция" в окне "Свойства проекта" и установите флажки "Разрешить обработку аннотаций" и "Разрешить обработку аннотаций в редакторе".
-9. Укажите, какой обработчик аннотаций должен быть запущен, нажав кнопку Add ("Добавить") рядом с текстовой областью обработчиков аннотаций и введя * ``proc.HandleableProcessor`` * в поле FQN ("Полностью определенное имя") обработчика аннотаций.
+
+[start=8]
+. Выберите категорию "Компиляция" в окне "Свойства проекта" и установите флажки "Разрешить обработку аннотаций" и "Разрешить обработку аннотаций в редакторе".
+
+[start=9]
+. Укажите, какой обработчик аннотаций должен быть запущен, нажав кнопку Add ("Добавить") рядом с текстовой областью обработчиков аннотаций и введя * ``proc.HandleableProcessor`` * в поле FQN ("Полностью определенное имя") обработчика аннотаций.
image::images/demo-processor-fqn.png[title="Диалоговое окно 'FQN обработчика аннотаций'"]
Категория Compiling ("Компиляция") в окне Project Properties ("Свойства проекта") должна выглядеть, как на приведенном ниже изображении.
image::images/demo-properties-compiling.png[title="Категория "Компиляция" в окне "Свойства проекта"."]
-10. Нажмите кнопку OK в окне Properties ("Свойства").
+
+[start=10]
+. Нажмите кнопку OK в окне Properties ("Свойства").
*Примечание.* В файле ``Main.java`` все еще могут отображаться ошибки компиляции. Это происходит, поскольку в среде IDE еще не определено местоположение файла ``MainExtras.java`` , в котором объявляется метод ``handleStuff`` . После первого создания проекта Demo будет создан файл ``MainExtras.java`` . Если для проекта включено режим Compile On Save ("Компилировать при сохранении"), среда IDE компилирует проект при сохранении ``Main.java`` .
-11. Щелкните правой кнопкой мыши проект Demo и выберите Build ("Сборка").
+
+[start=11]
+. Щелкните правой кнопкой мыши проект Demo и выберите Build ("Сборка").
Если после сборки проекта взглянуть на него в окне Projects ("Проекты"), то можно будет увидеть новый узел ``Generated Sources`` с файлом ``demo/MainExtras.java`` .
@@ -395,7 +431,9 @@ public abstract class MainExtras {
}
}
----
-12. Щелкните правой кнопкой мыши проект Demo и выберите Run ("Запустить").
+
+[start=12]
+. Щелкните правой кнопкой мыши проект Demo и выберите Run ("Запустить").
При щелчке Run ("Запустить") в окне вывода можно будет увидеть следующее. Выполняется компиляция проекта Demo, и на экран выводится сообщение.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_zh_CN.asciidoc
index 61e545c..a83342a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-custom_zh_CN.asciidoc
@@ -64,9 +64,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="此页
单击 "Finish"（完成），此时 IDE 将创建类库项目，并在 "Projects"（项目）窗口中列出该项目。
-3. 在 "Projects"（项目）窗口中，右键单击 AnnProcessor 项目节点，然后选择 "Properties"（属性）。
-4. 在 "Sources"（源）类别中，确认将 JDK 6 或 JDK 7 指定为源代码/二进制格式。
-5. 选择 "Libraries"（库）标签，然后确认将 Java 平台设置为 "JDK 1.6" 或 "JDK 1.7"。单击 "OK"（确定），以关闭 "Project Properties"（项目属性）窗口。
+
+[start=3]
+. 在 "Projects"（项目）窗口中，右键单击 AnnProcessor 项目节点，然后选择 "Properties"（属性）。
+
+[start=4]
+. 在 "Sources"（源）类别中，确认将 JDK 6 或 JDK 7 指定为源代码/二进制格式。
+
+[start=5]
+. 选择 "Libraries"（库）标签，然后确认将 Java 平台设置为 "JDK 1.6" 或 "JDK 1.7"。单击 "OK"（确定），以关闭 "Project Properties"（项目属性）窗口。
在本练习中，将创建两个 Java 包，并在每个包中创建一个 Java 类。
@@ -77,9 +83,15 @@ image::../../../images_www/articles/71/netbeans-stamp-71-72-73.png[title="此页
创建了这两个 Java 包后，项目结构应类似于下图。
image::images/packages.png[title="标注处理程序项目的结构。"]
-4. 右键单击 ``ann`` Java 包，然后选择 "New"（新建）> "Java Class"（Java 类）。
-5. 键入 * ``Handleable`` * 作为类名。单击 "Finish"（完成）。
-6. 修改新的 ``Handleable.java`` 文件，进行如下更改。保存该文件。
+
+[start=4]
+. 右键单击 ``ann`` Java 包，然后选择 "New"（新建）> "Java Class"（Java 类）。
+
+[start=5]
+. 键入 * ``Handleable`` * 作为类名。单击 "Finish"（完成）。
+
+[start=6]
+. 修改新的 ``Handleable.java`` 文件，进行如下更改。保存该文件。
[source,java]
----
@@ -97,9 +109,15 @@ public *@interface* Handleable {
现在，您需要为标注处理程序添加处理 ``Handleable`` 标注的代码。
-7. 右键单击 * ``proc`` * Java 包，然后选择 "New"（新建）> "Java Class"（Java 类）。
-8. 键入 * ``HandleableProcessor`` * 作为类名。单击 "Finish"（完成）。
-9. 修改 ``HandleableProcessor.java`` 类，以添加如下代码。保存所做的更改。
+
+[start=7]
+. 右键单击 * ``proc`` * Java 包，然后选择 "New"（新建）> "Java Class"（Java 类）。
+
+[start=8]
+. 键入 * ``HandleableProcessor`` * 作为类名。单击 "Finish"（完成）。
+
+[start=9]
+. 修改 ``HandleableProcessor.java`` 类，以添加如下代码。保存所做的更改。
*注：* ``@SupportedSourceVersion`` 的值（*粗体*）将依赖于您正在使用的 JDK 版本，将为 ``(SourceVersion.RELEASE_7)`` 或 ``(SourceVersion.RELEASE_6)`` 。
@@ -314,7 +332,9 @@ return new String(c);
}
*}
----
-10. 右键单击 ``AnnProcessor`` 项目，然后选择 "Build"（构建）以构建项目。
+
+[start=10]
+. 右键单击 ``AnnProcessor`` 项目，然后选择 "Build"（构建）以构建项目。
== 在 IDE 中使用标注处理程序
@@ -325,8 +345,12 @@ return new String(c);
2. 在 "Name and Location"（名称和位置）页中，键入 * ``Demo`` * 作为项目名称，并指定项目位置。
3. 在 "Create Main Class"（创建主类）字段中，键入 * ``demo.Main`` *。单击 "Finish"（完成）。
image::images/demo-project-wizard.png[title="在新建项目向导中创建 "Demo"（演示）项目。"]
-4. 打开 "Project Properties"（项目属性）窗口，确认在 "Sources"（源）面板中选择 "JDK 6" 或 "JDK 7" 作为源代码/二进制格式，然后确认在 "Libraries"（库）面板中将 Java 平台设置为 "JDK 1.6" 或 "JDK 1.7"。
-5. 修改 ``Main.java`` 类，以添加如下代码。保存所做的更改。
+
+[start=4]
+. 打开 "Project Properties"（项目属性）窗口，确认在 "Sources"（源）面板中选择 "JDK 6" 或 "JDK 7" 作为源代码/二进制格式，然后确认在 "Libraries"（库）面板中将 Java 平台设置为 "JDK 1.6" 或 "JDK 1.7"。
+
+[start=5]
+. 修改 ``Main.java`` 类，以添加如下代码。保存所做的更改。
[source,java]
----
@@ -357,24 +381,36 @@ public class Main *extends MainExtras* {
保存 ``Main.java`` 代码后，您会看到 IDE 报告多个编译错误。这是由于标注处理程序尚未添加到项目中。
-6. 在 "Projects"（项目）窗口中，右键单击 ``Demo`` 项目节点，选择 "Properties"（属性），然后在 "Project Properties"（项目属性）窗口中选择 "Libraries"（库）类别。
-7. 在 "Compile"（编译）标签中，单击 "Add Project"（添加项目），然后找到 ``AnnProcessor`` 项目。
+
+[start=6]
+. 在 "Projects"（项目）窗口中，右键单击 ``Demo`` 项目节点，选择 "Properties"（属性），然后在 "Project Properties"（项目属性）窗口中选择 "Libraries"（库）类别。
+
+[start=7]
+. 在 "Compile"（编译）标签中，单击 "Add Project"（添加项目），然后找到 ``AnnProcessor`` 项目。
image::images/demo-properties-compile.png[title="项目的 "Properties"（属性）窗口 "Libraries"（库）类别中的 "Compile"（编译）标签"]
"Compile"（编译）标签对应于 link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Java 编译器+]的 ``-classpath`` 选项。由于标注处理程序是包含标注定义和标注处理程序的单一 JAR 文件，因此，应在 "Compile"（编译）标签中将其添加到项目的类路径中。
-8. 在 "Project Properties"（项目属性）窗口中选择 "Compiling"（编译）类别，然后选中 "Enable Annotation Processing"（启用标注处理）和 "Enable Annotation Processing in Editor"（在编辑器中启用标注处理）复选框。
-9. 单击 "Annotation Processors"（标注处理程序）文本区域旁边的 "Add"（添加）按钮，然后在 "Annotation Processor FQN"（标注处理程序 FQN）字段中键入 * ``proc.HandleableProcessor`` * 以指定要运行的标注处理程序。
+
+[start=8]
+. 在 "Project Properties"（项目属性）窗口中选择 "Compiling"（编译）类别，然后选中 "Enable Annotation Processing"（启用标注处理）和 "Enable Annotation Processing in Editor"（在编辑器中启用标注处理）复选框。
+
+[start=9]
+. 单击 "Annotation Processors"（标注处理程序）文本区域旁边的 "Add"（添加）按钮，然后在 "Annotation Processor FQN"（标注处理程序 FQN）字段中键入 * ``proc.HandleableProcessor`` * 以指定要运行的标注处理程序。
image::images/demo-processor-fqn.png[title=""Annotation Processor FQN"（标注处理程序 FQN）对话框"]
"Project Properties"（项目属性）窗口中的 "Compiling"（编译）类别应如下图所示。
image::images/demo-properties-compiling.png[title="项目 "Properties"（项目属性）窗口中的 "Compiling"（编译）类别"]
-10. 在 "Properties"（属性）窗口中单击 "OK"（确定）。
+
+[start=10]
+. 在 "Properties"（属性）窗口中单击 "OK"（确定）。
*注：*在 ``Main.java`` 文件中，仍可能会看到一些编译错误。这是由于 IDE 仍然找不到声明 ``handleStuff`` 方法的 ``MainExtras.java`` 文件。首次构建 Demo 项目后，将构建 ``MainExtras.java`` 文件。如果为项目启用了 "Compile On Save"（在保存时编译）功能，则在保存 ``Main.java`` 时，IDE 将编译项目。
-11. 右键单击 "Demo" 项目，然后选择 "Build"（构建）。
+
+[start=11]
+. 右键单击 "Demo" 项目，然后选择 "Build"（构建）。
在构建项目后，如果在 "Projects"（项目）窗口中查看该项目，则可以看到包含 ``demo/MainExtras.java`` 文件的新 ``Generated Sources`` （构建的源文件）节点。
@@ -395,7 +431,9 @@ public abstract class MainExtras {
}
}
----
-12. 右键单击 "Demo" 项目，然后选择 "Run"（运行）。
+
+[start=12]
+. 右键单击 "Demo" 项目，然后选择 "Run"（运行）。
单击 "Run"（运行）时，"Output"（输出）窗口中应显示以下内容。Demo 项目编译并打印该信息。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok.asciidoc
index edcddd0..c983fcc 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok.asciidoc
@@ -61,14 +61,20 @@ image::images/newproj.png[title="Creating a new Java project in the NetBeans IDE
When you click Finish, the IDE creates the Java application project and opens the ``TestBooks.java`` class in the editor. You can see that the new project is now visible in the Projects window and that the ``TestBooks.java`` class is in the ``testann`` package under the Source Packages node.
+
+
[start=5]
-5. Right-click the ``testann`` package node in the Projects window and choose New > Java class.
-6. Type ``MyBooks`` for the Class Name and confirm that the class will be created in the ``testann`` package. Click Finish.
+. Right-click the ``testann`` package node in the Projects window and choose New > Java class.
+
+[start=6]
+. Type ``MyBooks`` for the Class Name and confirm that the class will be created in the ``testann`` package. Click Finish.
When you click Finish the IDE opens the new class in the editor.
+
+
[start=7]
-7. In the source editor, add the following three fields to ``MyBooks.java`` .
+. In the source editor, add the following three fields to ``MyBooks.java`` .
[source,java]
----
@@ -83,14 +89,20 @@ public class MyBooks {
}
----
+
+
[start=8]
-8. Place your insert cursor in the class declaration and press Ctrl-Space to invoke the editor's code completion support.
-9. Select ``MyBooks (int year, String title, String author) - generate`` in the code completion list to generate a constructor for ``MyBooks.java`` .
+. Place your insert cursor in the class declaration and press Ctrl-Space to invoke the editor's code completion support.
+
+[start=9]
+. Select ``MyBooks (int year, String title, String author) - generate`` in the code completion list to generate a constructor for ``MyBooks.java`` .
image::images/generate-constructor.png[title="Code completion to generate constructor"]
+
+
[start=10]
-10. Save your changes.
+. Save your changes.
== Enabling Custom Annotations (lombok.jar) for the Project
@@ -105,9 +117,13 @@ image::images/properties1.png[title="Libraries category in Properties window"]
The resources added on the Compile tab correspond to the ``-classpath`` option of the link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Java compiler+]. As ``lombok.jar`` is a single JAR file that contains both annotation definitions and annotation processors, you should add it to the project's classpath, which is the Compile tab.
+
+
[start=5]
-5. Choose the Compiling category in the Project Properties window.
-6. Confirm that the Enable Annotation Processing checkbox is selected (it is enabled by default) and select the Enable Annotation Processing in Editor checkbox.
+. Choose the Compiling category in the Project Properties window.
+
+[start=6]
+. Confirm that the Enable Annotation Processing checkbox is selected (it is enabled by default) and select the Enable Annotation Processing in Editor checkbox.
image::images/properties2.png[title="Compiling category in Properties window"]
@@ -115,8 +131,10 @@ The Enable Annotation Processing checkbox enables annotation processing while bu
By selecting the Enable Annotation Processing in Editor checkbox, you make annotation processing results visible in the editor. Any additional artifacts that are generated by annotation processors (classes, methods, fields, etc.) become visible in the IDE Editor and available in code completion, Navigator, GoTo Type, Find usages, and others.
+
+
[start=7]
-7. Click OK in the Project Properties window and return to the ``MyBooks.java`` file.
+. Click OK in the Project Properties window and return to the ``MyBooks.java`` file.
If you expand the Libraries node in the Projects window, you can see that ``lombok.jar`` is now listed as a project library.
@@ -129,8 +147,10 @@ image::images/projects-window.png[title="Libraries node in Projects window"]
To learn more about what annotations are supported by Project Lombok, refer to the Lombok link:http://projectlombok.org/features/index.html[+Features Overview+].
+
+
[start=2]
-2. Click the hint in the editor's left margin and add import for ``lombok.Data`` .
+. Click the hint in the editor's left margin and add import for ``lombok.Data`` .
image::images/import-lombok.png[title="Hint in editor to import lombok"]
@@ -166,8 +186,10 @@ image::images/nav.png[title="Navigator window showing project members"]
You can also invoke the code completion window (Ctrl-Space) and see that the generated artifacts are available for picking them. Now, let's see that the project compiles and the generated artifacts can be called from other parts of the program.
+
+
[start=3]
-3. Open the ``TestBooks.java`` file with the _main_ method and add the following code (in bold) to create a new object of the ``MyBooks`` class.
+. Open the ``TestBooks.java`` file with the _main_ method and add the following code (in bold) to create a new object of the ``MyBooks`` class.
[source,java]
----
@@ -182,8 +204,10 @@ public class TestBooks {
}
----
+
+
[start=4]
-4. Add the following code to print out the values of the ``books`` variable.
+. Add the following code to print out the values of the ``books`` variable.
To return the values, we call the getter methods that were auto-generated by ``lombok.jar`` . While you are typing, note that the auto-generated artifacts are available from the code completion window.
@@ -202,9 +226,13 @@ public class TestBooks {
}
----
+
+
[start=5]
-5. Save your changes.
-6. Right-click the project node in the Projects window and choose Run (F6).
+. Save your changes.
+
+[start=6]
+. Right-click the project node in the Projects window and choose Run (F6).
When you run the application you should see the following output that shows that the application compiled successfully.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ja.asciidoc
index 27fb513..d54dd87 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ja.asciidoc
@@ -61,12 +61,18 @@ image::images/newproj.png[title="NetBeans IDEでの新しいJavaプロジェク
「終了」をクリックすると、IDEによってJavaアプリケーション・プロジェクトが作成され、 ``TestBooks.java`` クラスがエディタに表示されます。ここで、新しいプロジェクトが「プロジェクト」ウィンドウに表示され、 ``TestBooks.java`` クラスが「ソース・パッケージ」ノードの下にある ``testann`` パッケージに含まれていることが確認できます。
-5. 「プロジェクト」ウィンドウで「 ``testann`` 」パッケージ・ノードを右クリックし、「新規」>「Javaクラス」を選択します。
-6. 「クラス名」に「* ``MyBooks`` *」と入力し、そのクラスが ``testann`` パッケージ内に作成されることを確認します。「終了」をクリックします。
+
+[start=5]
+. 「プロジェクト」ウィンドウで「 ``testann`` 」パッケージ・ノードを右クリックし、「新規」>「Javaクラス」を選択します。
+
+[start=6]
+. 「クラス名」に「* ``MyBooks`` *」と入力し、そのクラスが ``testann`` パッケージ内に作成されることを確認します。「終了」をクリックします。
「終了」をクリックすると、IDEによって新しいクラスがエディタに表示されます。
-7. ソース・エディタで、次の3つのフィールドを ``MyBooks.java`` に追加します。
+
+[start=7]
+. ソース・エディタで、次の3つのフィールドを ``MyBooks.java`` に追加します。
[source,java]
----
@@ -80,10 +86,16 @@ public class MyBooks {
}
----
-8. 挿入カーソルをクラス宣言に置き、[Ctrl]-[Space]を押して、エディタのコード補完サポートを呼び出します。
-9. コード補完リストで「 ``MyBooks (int year, String title, String author) - generate`` 」を選択して、 ``MyBooks.java`` のコンストラクタを生成します。
+
+[start=8]
+. 挿入カーソルをクラス宣言に置き、[Ctrl]-[Space]を押して、エディタのコード補完サポートを呼び出します。
+
+[start=9]
+. コード補完リストで「 ``MyBooks (int year, String title, String author) - generate`` 」を選択して、 ``MyBooks.java`` のコンストラクタを生成します。
image::images/generate-constructor.png[title="コンストラクタを生成するためのコード補完"]
-10. 変更を保存します。
+
+[start=10]
+. 変更を保存します。
== プロジェクトのカスタム注釈(lombok.jar)の有効化
@@ -98,15 +110,21 @@ image::images/properties1.png[title="「プロパティ」ウィンドウ内の
「コンパイル」タブで追加されたリソースは、link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Javaコンパイラ+]の ``-classpath`` オプションに相当します。 ``lombok.jar`` は、注釈定義と注釈プロセッサの両方を含む単一のJARファイルであるため、これをプロジェクトのクラスパス(つまり「コンパイル」タブ)に追加する必要があります。
-5. 「プロジェクト・プロパティ」ウィンドウで「コンパイル」カテゴリを選択します。
-6. 「注釈処理を有効にする」チェックボックスが選択されていることを確認し(デフォルトでは有効)、「エディタでの注釈処理を有効にする」チェックボックスを選択します。
+
+[start=5]
+. 「プロジェクト・プロパティ」ウィンドウで「コンパイル」カテゴリを選択します。
+
+[start=6]
+. 「注釈処理を有効にする」チェックボックスが選択されていることを確認し(デフォルトでは有効)、「エディタでの注釈処理を有効にする」チェックボックスを選択します。
image::images/properties2.png[title="「プロパティ」ウィンドウ内の「コンパイル」カテゴリ"]
「注釈処理を有効にする」チェックボックスを選択すると、プロジェクトのビルドおよびコンパイル時に注釈処理が有効になります。このチェックボックスが選択されていないと、 ``-proc:none`` オプションがJavaコンパイラに渡され、どのような注釈処理もされずにコンパイルが実行されます。このため、コードで注釈を処理する場合は、「注釈処理を有効にする」チェックボックスを選択する必要があります。
「エディタでの注釈処理を有効にする」チェックボックスを選択することにより、エディタに注釈処理の結果が表示されるようになります。注釈プロセッサによって生成されたどの追加アーティファクト(クラス、メソッド、フィールドなど)もIDEエディタに表示されるようになり、コード補完、「ナビゲータ」、「型に移動」、「使用状況を検索」などで使用できるようになります。
-7. 「プロジェクト・プロパティ」ウィンドウで「OK」をクリックして、 ``MyBooks.java`` ファイルに戻ります。
+
+[start=7]
+. 「プロジェクト・プロパティ」ウィンドウで「OK」をクリックして、 ``MyBooks.java`` ファイルに戻ります。
「プロジェクト」ウィンドウで「ライブラリ」ノードを展開すると、 ``lombok.jar`` がプロジェクト・ライブラリとして表示されるようになっていることがわかります。
@@ -119,7 +137,9 @@ image::images/projects-window.png[title="「プロジェクト」ウィンドウ
プロジェクトLombokがサポートする注釈の詳細は、Lombokのlink:http://projectlombok.org/features/index.html[+機能の概要+]を参照してください。
-2. エディタの左マージンにあるヒントをクリックして、 ``lombok.Data`` のインポートを追加します。
+
+[start=2]
+. エディタの左マージンにあるヒントをクリックして、 ``lombok.Data`` のインポートを追加します。
image::images/import-lombok.png[title="lombokをインポートするためのエディタ内のヒント"]
この結果、エディタのコードは次の例のようになっているはずです。
@@ -154,7 +174,9 @@ image::images/nav.png[title="プロジェクト・メンバーが表示された
コード補完ウィンドウを呼び出すと([Ctrl]-[Space])、生成されたアーティファクトも選択可能になっているのが確認できます。ここで、プロジェクトがコンパイルされ、生成されたアーティファクトをプログラムの他の部分からコールできることを確認します。
-3. _main_メソッドで ``TestBooks.java`` ファイルを開き、次のコード(太字)を追加して、 ``MyBooks`` クラスの新規オブジェクトを作成します。
+
+[start=3]
+. _main_メソッドで ``TestBooks.java`` ファイルを開き、次のコード(太字)を追加して、 ``MyBooks`` クラスの新規オブジェクトを作成します。
[source,java]
----
@@ -168,7 +190,9 @@ public class TestBooks {
}
}
----
-4. ``books`` 変数の値を出力するための次のコードを追加します。
+
+[start=4]
+. ``books`` 変数の値を出力するための次のコードを追加します。
値を返すため、 ``lombok.jar`` によって自動生成された取得メソッドをコールします。入力中に、自動生成されたアーティファクトをコード補完ウィンドウから使用できます。
@@ -186,8 +210,12 @@ public class TestBooks {
}
}
----
-5. 変更を保存します。
-6. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」([F6])を選択します。
+
+[start=5]
+. 変更を保存します。
+
+[start=6]
+. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」([F6])を選択します。
このアプリケーションを実行すると、アプリケーションが正常にコンパイルされたことを示す次の出力が表示されるはずです。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_pt_BR.asciidoc
index 21ae694..c2b79af 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_pt_BR.asciidoc
@@ -61,12 +61,18 @@ image::images/newproj.png[title="Criando um novo projeto Java no NetBeans IDE"]
Quando você clica em Finalizar, o IDE cria a aplicação Java e abre a classe ``TestBooks.java`` no editor. Você pode ver que o novo projeto está agora visível na janela Projetos e que a classe ``TestBooks.java`` está no pacote ``testann`` sob o nó Pacotes de Código-fonte.
-5. Clique com o botão direito do mouse no nó do pacote ``testann`` na janela Projetos e escolha Novo > Classe Java.
-6. Digite * ``MyBooks`` * para o Nome da Classe e confirme que a classe será criada no pacote ``testann`` . Clique em Finalizar.
+
+[start=5]
+. Clique com o botão direito do mouse no nó do pacote ``testann`` na janela Projetos e escolha Novo > Classe Java.
+
+[start=6]
+. Digite * ``MyBooks`` * para o Nome da Classe e confirme que a classe será criada no pacote ``testann`` . Clique em Finalizar.
Quando você clicar em Finalizar, o IDE abre a nova classe no editor.
-7. No editor de código-fonte, adicione os seguintes três campos em ``MyBooks.java`` .
+
+[start=7]
+. No editor de código-fonte, adicione os seguintes três campos em ``MyBooks.java`` .
[source,java]
----
@@ -80,10 +86,16 @@ public class MyBooks {
}
----
-8. Coloque o ponteiro do mouse na declaração da classe e pressione Ctrl-Espaço para chamar o suporte de autocompletar código do editor.
-9. Selecione ``MyBooks (int year, String title, String author) - generate`` na lista autocompletar código para gerar um construtor para ``MyBooks.java`` .
+
+[start=8]
+. Coloque o ponteiro do mouse na declaração da classe e pressione Ctrl-Espaço para chamar o suporte de autocompletar código do editor.
+
+[start=9]
+. Selecione ``MyBooks (int year, String title, String author) - generate`` na lista autocompletar código para gerar um construtor para ``MyBooks.java`` .
image::images/generate-constructor.png[title="Recurso autocompletar código para gerar o construtor"]
-10. Salve as alterações.
+
+[start=10]
+. Salve as alterações.
== Ativando Anotações Personalizadas (lombok.jar) para o Projeto
@@ -98,15 +110,21 @@ image::images/properties1.png[title="Categoria das bibliotecas na janela Proprie
Os recursos adicionados à guia Compilar correspondem à opção ``-classpath`` do link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+compilador Java+]. Como ``lombok.jar`` é um arquivo JAR único que contém definições de anotação e processadores de anotações, é recomendado adicioná-lo ao classpath do projeto, que é a guia Compilação.
-5. Escolha a categoria Compilação na janela Propriedades do Projeto.
-6. Confirme se a caixa de seleção Ativar o Processamento de Anotações está selecionada (ela é ativada por default) e selecione a caixa de seleção Ativar o Processamento de Anotações no Editor.
+
+[start=5]
+. Escolha a categoria Compilação na janela Propriedades do Projeto.
+
+[start=6]
+. Confirme se a caixa de seleção Ativar o Processamento de Anotações está selecionada (ela é ativada por default) e selecione a caixa de seleção Ativar o Processamento de Anotações no Editor.
image::images/properties2.png[title="Categoria de compilação na janela Propriedades"]
A caixa de seleção Ativar Processamento de Anotações ativa o processamento de anotação ao construir e compilar o projeto. Se a caixa de seleção não estiver selecionada, a opção ``-proc:none`` é passada para o compilador Java e a compilação ocorre sem qualquer processamento de anotações. Então, se deseja processar anotações no código, a caixa de seleção Ativar Processamento de Anotações deve estar selecionada.
Ao selecionar a caixa de seleção, Ativar Processamento de Anotações no Editor, você faz com que o processamento de anotações fique visível no editor. Quaisquer artefatos adicionais que forem gerados por processadores de anotações (classes, métodos, campos, etc.) ficam visíveis no editor IDE e disponíveis para a conclusão de código, no Navegador, Ir para Tipo, Localizar usos e outros.
-7. Clique em OK na janela Propriedades do Projeto e retorne para o arquivo ``MyBooks.java`` .
+
+[start=7]
+. Clique em OK na janela Propriedades do Projeto e retorne para o arquivo ``MyBooks.java`` .
Caso você expanda o nó Bibliotecas na janela Projetos, verá que a ``lombok.jar`` está agora listada como uma biblioteca do projeto.
@@ -119,7 +137,9 @@ image::images/projects-window.png[title="Nó das bibliotecas na janela Projetos"
Para aprender mais sobre quais anotações são suportadas pelo Projeto Lombok, consulte a link:http://projectlombok.org/features/index.html[+Visão Geral das Funcionalidades+] do Lombok.
-2. Clique na dica na margem direita do editor e adicione importar para ``lombok.Data`` .
+
+[start=2]
+. Clique na dica na margem direita do editor e adicione importar para ``lombok.Data`` .
image::images/import-lombok.png[title="Dica no editor para importar lombok"]
O código resultante no Editor deve ser parecido com o exemplo abaixo.
@@ -154,7 +174,9 @@ image::images/nav.png[title="Janela do Navegador mostrando os membros do projeto
É possível também chamar a janela autocompletar código (Ctrl-Espaço) e ver que os artefatos gerados estão disponíveis para pegá-los. Agora, veremos que o projeto compila e os artefatos gerados podem ser chamados de outras partes do programa.
-3. Abra o arquivo ``TestBooks.java`` com o método _main_ e adicione o código a seguir (em negrito) para criar um novo objeto da classe ``MyBooks`` .
+
+[start=3]
+. Abra o arquivo ``TestBooks.java`` com o método _main_ e adicione o código a seguir (em negrito) para criar um novo objeto da classe ``MyBooks`` .
[source,java]
----
@@ -168,7 +190,9 @@ public class TestBooks {
}
}
----
-4. Adicione o seguinte código para imprimir os valores da variável ``books`` .
+
+[start=4]
+. Adicione o seguinte código para imprimir os valores da variável ``books`` .
Para voltar os valores, chamamos os métodos getter que são autogerados por ``lombok.jar`` . Enquanto estiver digitando, observe que os artefatos autogerados estão disponíveis da janela autocompletar código.
@@ -186,8 +210,12 @@ public class TestBooks {
}
}
----
-5. Salve as alterações.
-6. Clique com o botão direito do mouse no nó na janela Projetos e selecione Executar (F6).
+
+[start=5]
+. Salve as alterações.
+
+[start=6]
+. Clique com o botão direito do mouse no nó na janela Projetos e selecione Executar (F6).
Ao executar a aplicação, você deverá ver a seguinte saída que mostra que a aplicação foi compilada com êxito.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ru.asciidoc
index efa9600..ec531ef 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_ru.asciidoc
@@ -61,12 +61,18 @@ image::images/newproj.png[title="Создание нового проекта Ja
После нажатия кнопки "Готово" среда IDE создаст проект приложения Java и откроет класс ``TestBooks.java`` в редакторе. Как вы можете видеть, теперь новый проект отображается в окне "Проекты", а класс ``TestBooks.java`` находится в пакете ``testann`` в узле "Исходные файлы".
-5. Правой кнопкой мыши щелкните узел с пакетом ``testann`` в окне "Проекты", затем выберите "Создать" > "Класс Java".
-6. Введите * ``MyBooks`` * в поле "Имя класса" и подтвердите создание класса в пакете ``testann`` . Нажмите кнопку "Завершить".
+
+[start=5]
+. Правой кнопкой мыши щелкните узел с пакетом ``testann`` в окне "Проекты", затем выберите "Создать" > "Класс Java".
+
+[start=6]
+. Введите * ``MyBooks`` * в поле "Имя класса" и подтвердите создание класса в пакете ``testann`` . Нажмите кнопку "Завершить".
После нажатия кнопки "Готово" среда IDE откроет новый класс в редакторе.
-7. В редакторе исходного кода добавьте три следующих поля в ``MyBooks.java`` .
+
+[start=7]
+. В редакторе исходного кода добавьте три следующих поля в ``MyBooks.java`` .
[source,java]
----
@@ -80,10 +86,16 @@ public class MyBooks {
}
----
-8. Поместите курсор в объявление класса и нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова функции автозавершения кода редактора.
-9. Выберите ``MyBooks (int year, String title, String author) - generate`` в списке автозавершения кода, чтобы создать конструктор для ``MyBooks.java`` .
+
+[start=8]
+. Поместите курсор в объявление класса и нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова функции автозавершения кода редактора.
+
+[start=9]
+. Выберите ``MyBooks (int year, String title, String author) - generate`` в списке автозавершения кода, чтобы создать конструктор для ``MyBooks.java`` .
image::images/generate-constructor.png[title="Автозавершение кода для создания конструктора"]
-10. Сохраните изменения.
+
+[start=10]
+. Сохраните изменения.
== Активация пользовательских аннотаций (lombok.jar) для проекта
@@ -98,15 +110,21 @@ image::images/properties1.png[title="Категория 'Библиотеки'
Ресурсы, добавленные на вкладке "Компиляция", соответствуют параметру ``-classpath`` link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+компилятора Java+]. Поскольку файл ``lombok.jar`` является отдельным файлом JAR, содержащим определения аннотаций и процессоры аннотаций, его необходимо добавить в путь к классам проекта, соответствующий вкладке "Компиляция".
-5. Выберите в окне "Свойства проекта" категорию "Компиляция".
-6. Убедитесь, что флажок "Включить обработку аннотаций" установлен (параметр активирован по умолчанию). Также установите флажок "Включить обработку аннотаций в редакторе".
+
+[start=5]
+. Выберите в окне "Свойства проекта" категорию "Компиляция".
+
+[start=6]
+. Убедитесь, что флажок "Включить обработку аннотаций" установлен (параметр активирован по умолчанию). Также установите флажок "Включить обработку аннотаций в редакторе".
image::images/properties2.png[title="Выберите в окне "Свойства проекта" категорию "Компиляция"."]
Параметр "Включить обработку аннотаций" активирует обработку аннотаций при построении и компиляции проекта. Если флажок не установлен, параметр ``-proc:none`` передается в компилятор Java, и компиляция выполняется без обработки аннотаций. Таким образом, при необходимости обработки аннотаций необходимо установить флажок "Включить обработку аннотаций".
При установке флажка "Включить обработку аннотаций в редакторе" результаты обработки аннотаций становятся видимыми в редакторе. Дополнительные артефакты, созданные процессорами аннотаций (классы, методы, поля и др.), становятся видимыми в редакторе среды IDE и доступными для функции автозавершения кода, навигатора, перехода к типу, поиска случаев использования и пр.
-7. В окне "Свойства проекта" нажмите кнопку "ОК" и вернитесь в файл ``MyBooks.java`` .
+
+[start=7]
+. В окне "Свойства проекта" нажмите кнопку "ОК" и вернитесь в файл ``MyBooks.java`` .
Развернув узел "Библиотеки" в окне "Проекты", вы увидите, что теперь файл ``lombok.jar`` находится в списке библиотек проекта.
@@ -119,7 +137,9 @@ image::images/projects-window.png[title="узел 'Библиотеки' в ок
Дополнительные сведения об аннотациях, поддерживаемых в проекте Lombok, приведены в разделе link:http://projectlombok.org/features/index.html[+Обзор функций+] Lombok.
-2. Щелкните всплывающую подсказку в левом поле редактора и добавьте импорт для ``lombok.Data`` .
+
+[start=2]
+. Щелкните всплывающую подсказку в левом поле редактора и добавьте импорт для ``lombok.Data`` .
image::images/import-lombok.png[title="Подсказка в редакаторе для импорта lombok"]
Итоговый код в редакторе должен выглядеть следующим образом:
@@ -154,7 +174,9 @@ image::images/nav.png[title="Окно 'Навигатор', в котором о
Можно также вызвать окно автозавершения кода (CTRL+ПРОБЕЛ) и проверить доступность созданных артефактов для выбора. Теперь необходимо убедиться, что проект выполняет компиляцию, а созданные артефакты можно вызвать из других компонентов программы.
-3. Откройте файл ``TestBooks.java`` с методом _main_ и добавьте следующий код (выделен полужирным шрифтом), чтобы создать новый объект класса ``MyBooks`` .
+
+[start=3]
+. Откройте файл ``TestBooks.java`` с методом _main_ и добавьте следующий код (выделен полужирным шрифтом), чтобы создать новый объект класса ``MyBooks`` .
[source,java]
----
@@ -168,7 +190,9 @@ public class TestBooks {
}
}
----
-4. Добавьте следующий код, который выводит на экран значения переменной ``books`` .
+
+[start=4]
+. Добавьте следующий код, который выводит на экран значения переменной ``books`` .
Для возврата значений следует вызвать методы получения, автоматически созданные в файле ``lombok.jar`` . Обратите внимание, что при вводе автоматически созданные артефакты доступны в окне автозавершения кода.
@@ -186,8 +210,12 @@ public class TestBooks {
}
}
----
-5. Сохраните изменения.
-6. Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Выполнить" (F6).
+
+[start=5]
+. Сохраните изменения.
+
+[start=6]
+. Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите команду "Выполнить" (F6).
После запуска приложения на экране должны отобразиться следующие выходные данные, демонстрирующие успешность компиляции.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_zh_CN.asciidoc
index a14e0db..f2474a7 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/annotations-lombok_zh_CN.asciidoc
@@ -61,12 +61,18 @@ image::images/newproj.png[title="在 NetBeans IDE 中创建新 Java 项目"]
单击 "Finish"（完成），此时 IDE 将创建 Java 应用程序项目，并在编辑器中打开 ``TestBooks.java`` 类。您可以看到，新项目现在显示在 "Projects"（项目）窗口中，并且 ``TestBooks.java`` 类位于 "Source Packages"（源包）节点下的 ``testann`` 包中。
-5. 在 "Projects"（项目）窗口中，右键单击 ``testann`` 包节点，然后选择 "New"（新建）> "Java Class"（Java 类）。
-6. 键入 * ``MyBooks`` * 作为类名，并确认将在 ``testann`` 包中创建类。单击 "Finish"（完成）。
+
+[start=5]
+. 在 "Projects"（项目）窗口中，右键单击 ``testann`` 包节点，然后选择 "New"（新建）> "Java Class"（Java 类）。
+
+[start=6]
+. 键入 * ``MyBooks`` * 作为类名，并确认将在 ``testann`` 包中创建类。单击 "Finish"（完成）。
单击 "Finish"（完成）后，IDE 将在编辑器中打开新类。
-7. 在源代码编辑器中，将以下三个字段添加到 ``MyBooks.java`` 中。
+
+[start=7]
+. 在源代码编辑器中，将以下三个字段添加到 ``MyBooks.java`` 中。
[source,java]
----
@@ -80,10 +86,16 @@ public class MyBooks {
}
----
-8. 将插入光标放在类声明中，然后按 Ctrl-空格组合键，以调用编辑器的代码完成支持。
-9. 在代码完成列表中选择 ``MyBooks (int year, String title, String author) - generate`` （MyBooks (int year, String title, String author) - 生成），以生成 ``MyBooks.java`` 的构造函数。
+
+[start=8]
+. 将插入光标放在类声明中，然后按 Ctrl-空格组合键，以调用编辑器的代码完成支持。
+
+[start=9]
+. 在代码完成列表中选择 ``MyBooks (int year, String title, String author) - generate`` （MyBooks (int year, String title, String author) - 生成），以生成 ``MyBooks.java`` 的构造函数。
image::images/generate-constructor.png[title="用于生成构造函数的代码完成功能"]
-10. 保存所做的更改。
+
+[start=10]
+. 保存所做的更改。
== 为项目启用定制标注 (lombok.jar)
@@ -98,15 +110,21 @@ image::images/properties1.png[title=""Properties"（属性）窗口中的 "Libra
在 "Compile"（编译）标签上添加的资源对应于 link:http://download.oracle.com/javase/6/docs/technotes/tools/windows/javac.html#options[+Java 编译器+]的 ``-classpath`` 选项。鉴于 ``lombok.jar`` 是一个同时包含标注定义和标注处理程序的单一 JAR 文件，您应该在 "Compile"（编译）标签中将其添加到项目的类路径中。
-5. 在 "Project Properties"（项目属性）窗口中，选择 "Compiling"（编译）类别。
-6. 确认选中了 "Enable Annotation Processing"（启用标注处理）复选框（默认为启用），然后选择 "Enable Annotation Processing in Editor"（在编辑器中启用标注处理）复选框。
+
+[start=5]
+. 在 "Project Properties"（项目属性）窗口中，选择 "Compiling"（编译）类别。
+
+[start=6]
+. 确认选中了 "Enable Annotation Processing"（启用标注处理）复选框（默认为启用），然后选择 "Enable Annotation Processing in Editor"（在编辑器中启用标注处理）复选框。
image::images/properties2.png[title=""Properties"（属性）窗口中的 "Compiling"（编译）类别"]
"Enable Annotation Processing"（启用标注处理）复选框使构建和编译项目期间可以进行标注处理。如果未选中该复选框，则会将 ``-proc:none`` 选项传递给 Java 编译器，因此，编译时不进行任何标注处理。因此，如果要处理代码中的标注，则必须选中 "Enable Annotation Processing"（启用标注处理）复选框。
通过选中 "Enable Annotation Processing in Editor"（在编辑器中启用标注处理）复选框，可在编辑器中查看标注处理结果。标注处理程序生成的其他任何工件（类、方法、字段等）均会显示在 IDE 编辑器中，并且可用于代码完成、导航器、跳转类型、查找使用实例等。
-7. 在 "Project Properties"（项目属性）窗口单击 "OK"（确定），返回到 ``MyBooks.java`` 文件。
+
+[start=7]
+. 在 "Project Properties"（项目属性）窗口单击 "OK"（确定），返回到 ``MyBooks.java`` 文件。
如果在 "Projects"（项目）窗口中展开 "Libraries"（库）节点，则可以看到 ``lombok.jar`` 现在被列为项目库。
@@ -119,7 +137,9 @@ image::images/projects-window.png[title=""Projects"（项目）窗口中的 "Lib
要了解有关 Project Lombok 支持的标注的详细信息，请参见 Lombok 的link:http://projectlombok.org/features/index.html[+功能概述+]。
-2. 单击编辑器左旁注中的提示，然后为 ``lombok.Data`` 添加 import。
+
+[start=2]
+. 单击编辑器左旁注中的提示，然后为 ``lombok.Data`` 添加 import。
image::images/import-lombok.png[title="编辑器中导入 lombok 的提示"]
编辑器中的生成代码应该类似于下面的示例。
@@ -154,7 +174,9 @@ image::images/nav.png[title="显示项目成员的 "Navigator"（导航器）窗
还可以调用代码完成窗口（Ctrl-空格键），然后查看生成的工件是否可供选择。现在，我们看到项目已编译，生成的工件可以通过程序的其他部分调用。
-3. 打开包含 _main_ 方法的 ``TestBooks.java`` 文件，并添加下面的代码（粗体）以创建 ``MyBooks`` 类的新对象。
+
+[start=3]
+. 打开包含 _main_ 方法的 ``TestBooks.java`` 文件，并添加下面的代码（粗体）以创建 ``MyBooks`` 类的新对象。
[source,java]
----
@@ -168,7 +190,9 @@ public class TestBooks {
}
}
----
-4. 添加以下代码，以输出 ``books`` 变量的值。
+
+[start=4]
+. 添加以下代码，以输出 ``books`` 变量的值。
要返回值，我们调用 ``lombok.jar`` 自动生成的 getter 方法。键入时，请注意代码完成窗口是否提供了自动生成的工件。
@@ -186,8 +210,12 @@ public class TestBooks {
}
}
----
-5. 保存所做的更改。
-6. 在 "Projects"（项目）窗口中，右键单击项目节点，然后选择 "Run"（运行）（F6 键）。
+
+[start=5]
+. 保存所做的更改。
+
+[start=6]
+. 在 "Projects"（项目）窗口中，右键单击项目节点，然后选择 "Run"（运行）（F6 键）。
运行应用程序时，应会显示以下输出，说明应用程序编译成功。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/code-inspect.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/code-inspect.asciidoc
index efa9652..62d6e30 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/code-inspect.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/code-inspect.asciidoc
@@ -71,14 +71,14 @@ The FindBugs plugin should be downloaded and installed into the NetBeans IDE as
--
image::images/inspect-small.png[role="left", link="images/inspect.png"]
--
-[start=3]
+
. In the Installer dialog box, click Next to proceed with the installation.
[.feature]
--
image::images/plugin-small.png[role="left", link="images/plugin.png"]
--
-[start=4]
+
. Review the license agreement, select the license agreement option, and click Install.
. When the installation is complete, click Finish.
@@ -109,7 +109,7 @@ image::images/allconfig-small.png[role="left", link="images/allconfig.png"]
NOTE: You need to install the <<plugin,FindBugs>> plugin to run this configuration for the first time.
-[start=4]
+
. Click Inspect.
The results of the analysis are displayed in the Inspector Window as a tree view on the left.
@@ -145,7 +145,7 @@ The ``NetBeans Java Hints`` configuration available in the IDE enables you to
NOTE: You can define a scope (a file, package, or project(s)) for the ``NetBeans Java Hints`` configuration.
-[start=3]
+
. Select the Configuration radio button and choose ``NetBeans Java Hints`` in the drop-down list.
[.feature]
@@ -153,13 +153,13 @@ NOTE: You can define a scope (a file, package, or project(s)) for the ``NetBean
image::images/hints-small.png[role="left", link="images/hints.png"]
--
-[start=4]
+
. Click Inspect.
The IDE displays the tree view with the results of the analysis with the ``NetBeans Java Hints`` configuration in the Inspector Window.
image::images/hintsconfig.png[]
-[start=5]
+
. In the Inspector Window, click the <<categorize,Categorize>> button in the toolbar on the left to view the problems grouped into categories.
image::images/catview.png[]
@@ -193,7 +193,7 @@ NOTE: You need to install the <<plugin,FindBugs>> plugin to run this configurati
NOTE: You can inspect a file, package, or project(s) with the ``FindBugs`` configuration.
-[start=3]
+
. In the Inspect dialog box, select the ``FindBugs`` configuration.
[.feature]
@@ -201,8 +201,10 @@ NOTE: You can inspect a file, package, or project(s) with the ``FindBugs`` con
image::images/fb-small.png[role="left", link="images/fb.png"]
--
+
+
[start=4]
-4. Click the Inspect button to initiate the static code analysis.
+. Click the Inspect button to initiate the static code analysis.
The result of the static code analysis is displayed in the Inspector Window below the Source Editor.
The description of the selected bug is displayed in the frame on the right.
@@ -211,7 +213,7 @@ The description of the selected bug is displayed in the frame on the right.
image::images/inspector-small.png[role="left", link="images/inspector.png"]
--
-[start=5]
+
. Alternatively, click the <<categorize,Categorize>> button in the toolbar on the left to view the bugs grouped into categories.
image::images/fbcat.png[]
@@ -237,7 +239,7 @@ NOTE: Potential errors are highlighted in the code with exclamation mark icons (
image::images/fb-editor-small.png[role="left", link="images/fb-editor.png"]
--
-[start=4]
+
. Select the Run FindBugs in Editor option.
. Click OK.
If you now press kbd:[Alt+Enter] in the source code where a bug is reported and click the black arrow pointing to the right at the end of the displayed tip, the IDE shows some fixing options for a potential bug.
@@ -261,7 +263,7 @@ The IDE displays the Configurations dialog box.
image::images/configurations-db.png[]
-[start=4]
+
. Ensure ``Default`` is selected in the Configurations drop-down list.
. In the Analyzer drop-down list, select the ``JRE 8 Profiles Conformance`` , ``Netbeans Java Hints`` , or ``FindBugs`` analyzer.
. Depending on the choice of the analyzer in the previous step, select the profile to validate, the inspections, or bugs you need to include into your ``Default`` configuration.
@@ -271,7 +273,7 @@ image::images/configurations-db.png[]
image::images/select-inspections-small.png[role="left", link="images/select-inspections.png"]
--
-[start=7]
+
. Click OK to save your ``Default`` configuration.
== Creating and Deleting Configurations
@@ -291,7 +293,7 @@ A ``newConfig`` configuration is created and added to the Configurations drop-
image::images/newconfig-created.png[]
-[start=5]
+
. In the Analyzer drop-down list, choose ``JRE 8 Profiles Conformance`` , ``Netbeans Java Hints`` , or ``FindBugs`` .
. Specify the profile, inspections, or bugs to be included into your own configuration.
. Click OK to save your edits and close the Configurations dialog box.
@@ -315,7 +317,7 @@ image::images/renamedconfig.png[]
image::images/delete.png[]
-[start=5]
+
. In the Delete Configuration dialog box, click Yes to confirm the deletion of the configuration.
image::images/delete-confirm.png[]
@@ -347,7 +349,7 @@ image::images/single-inspection-small.png[role="left", link="images/single-inspe
image::images/hint-inspection-small.png[role="left", link="images/hint-inspection.png"]
--
-[start=4]
+
. In the Inspect dialog box, click Inspect to perform the source code analysis.
After the Inspect operation is completed, the hints that can be applied to your code or bugs that have been found are displayed in the Inspector Window below the Source Editor.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ja.asciidoc
index 29f2836..3c397ff 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ja.asciidoc
@@ -35,10 +35,7 @@ NetBeans IDE Javaエディタには、ソース・コード内の潜在的な問
このチュートリアルでは、アプリケーションを実際には実行せずに、FindBugsおよびNetBeans Javaヒントを使用してJavaコードの静的分析を実行する方法を学習します。
-
-=== 内容
-
-image::images/netbeans-stamp.png[title="このページの内容は、NetBeans IDE 8.0に適用されます"]
+== 内容
* <<setup,チュートリアルの環境の設定>>
* <<config,構成の使用>>
@@ -92,15 +89,21 @@ image::images/jar.png[]
image::images/inspect-small.png[role="left", link="images/inspect.png"]
--
-3. 「インストーラ」ダイアログ・ボックスで「次」をクリックし、インストールを続行します。
+
+[start=3]
+. 「インストーラ」ダイアログ・ボックスで「次」をクリックし、インストールを続行します。
[.feature]
--
image::images/plugin-small.png[role="left", link="images/plugin.png"]
--
-4. ライセンス契約を確認し、ライセンス契約オプションを選択して、「インストール」をクリックします。
-5. インストールが完了したら、「終了」をクリックします。
+
+[start=4]
+. ライセンス契約を確認し、ライセンス契約オプションを選択して、「インストール」をクリックします。
+
+[start=5]
+. インストールが完了したら、「終了」をクリックします。
== 事前定義された構成の使用
@@ -130,7 +133,9 @@ image::images/allconfig-small.png[role="left", link="images/allconfig.png"]
*注意:* この構成を最初に実行する前に、<<plugin,FindBugs>>プラグインをインストールする必要があります。
-4. 「検査」をクリックします。
+
+[start=4]
+. 「検査」をクリックします。
分析の結果が「インスペクタ・ウィンドウ」の左にツリー・ビューとして表示されます。
[.feature]
@@ -164,19 +169,25 @@ IDEで使用可能な「 ``NetBeans Javaヒント`` 」構成を使用すると
*注意:* 「 ``NetBeans Javaヒント`` 」構成のスコープ(ファイル、パッケージ、またはプロジェクト)を定義できます。
-3. 「構成」ラジオ・ボタンを選択し、ドロップダウン・リストで「 ``NetBeans Javaヒント`` 」を選択します。
+
+[start=3]
+. 「構成」ラジオ・ボタンを選択し、ドロップダウン・リストで「 ``NetBeans Javaヒント`` 」を選択します。
[.feature]
--
image::images/hints-small.png[role="left", link="images/hints.png"]
--
-4. 「検査」をクリックします。
+
+[start=4]
+. 「検査」をクリックします。
IDEでは、「インスペクタ・ウィンドウ」内のツリー・ビューに、「 ``NetBeans Javaヒント`` 」構成を使用した分析の結果が表示されます。
image::images/hintsconfig.png[]
-5. 「インスペクタ」ウィンドウで、左のツールバーの<<categorize,カテゴリ化>>ボタンをクリックし、カテゴリにグループ化された問題を表示します。
+
+[start=5]
+. 「インスペクタ」ウィンドウで、左のツールバーの<<categorize,カテゴリ化>>ボタンをクリックし、カテゴリにグループ化された問題を表示します。
image::images/catview.png[]
@@ -209,14 +220,18 @@ IDEで使用可能な「 ``FindBugs`` 」構成を使用すると、コード内
*注意:* 「 ``FindBugs`` 」構成を使用して、ファイル、パッケージまたはプロジェクトを検査できます。
-3. 「検査」ダイアログ・ボックスで、「 ``FindBugs`` 」構成を選択します。
+
+[start=3]
+. 「検査」ダイアログ・ボックスで、「 ``FindBugs`` 」構成を選択します。
[.feature]
--
image::images/fb-small.png[role="left", link="images/fb.png"]
--
-4. 「検査」ボタンをクリックして、静的コード分析を開始します。
+
+[start=4]
+. 「検査」ボタンをクリックして、静的コード分析を開始します。
ソース・エディタの下にある「インスペクタ・ウィンドウ」に、静的コード分析の結果が表示されます。
右のフレームに、選択したbugの説明が表示されます。
@@ -225,7 +240,9 @@ image::images/fb-small.png[role="left", link="images/fb.png"]
image::images/inspector-small.png[role="left", link="images/inspector.png"]
--
-5. または、左のツールバーの<<categorize,カテゴリ化>>ボタンをクリックし、カテゴリにグループ化されたbugを表示します。
+
+[start=5]
+. または、左のツールバーの<<categorize,カテゴリ化>>ボタンをクリックし、カテゴリにグループ化されたbugを表示します。
image::images/fbcat.png[]
@@ -252,8 +269,12 @@ image::images/source-editor-small.png[role="left", link="images/source-editor.pn
image::images/fb-editor-small.png[role="left", link="images/fb-editor.png"]
--
-4. 「エディタ」オプションで「FindBugsの実行」を選択します。
-5. 「OK」をクリックします。
+
+[start=4]
+. 「エディタ」オプションで「FindBugsの実行」を選択します。
+
+[start=5]
+. 「OK」をクリックします。
ここで、bugが報告されたソース・コード内で[Alt]-[Enter]を押し、表示されたヒントの末尾にある黒い右矢印をクリックすると、IDEでは、潜在的なbugに対するいくつかの修正オプションが表示されます。
[.feature]
@@ -275,16 +296,24 @@ IDEで「構成」ダイアログ・ボックスが表示されます。
image::images/configurations-db.png[]
-4. 「構成」ドロップダウン・リストで「 ``デフォルト`` 」が選択されていることを確認します。
-5. 「アナライザ」ドロップダウン・リストで ``「JRE 8プロファイル準拠」`` 、 ``「NetBeans Javaヒント」`` または ``「FindBugs」`` アナライザを選択します。
-6. 前のステップで選択したアナライザに応じて、検証するプロファイル、 ``デフォルト`` 構成に含める検査またはbugを選択します。
+
+[start=4]
+. 「構成」ドロップダウン・リストで「 ``デフォルト`` 」が選択されていることを確認します。
+
+[start=5]
+. 「アナライザ」ドロップダウン・リストで ``「JRE 8プロファイル準拠」`` 、 ``「NetBeans Javaヒント」`` または ``「FindBugs」`` アナライザを選択します。
+
+[start=6]
+. 前のステップで選択したアナライザに応じて、検証するプロファイル、 ``デフォルト`` 構成に含める検査またはbugを選択します。
[.feature]
--
image::images/select-inspections-small.png[role="left", link="images/select-inspections.png"]
--
-7. 「OK」をクリックして「 ``デフォルト`` 」構成を保存します。
+
+[start=7]
+. 「OK」をクリックして「 ``デフォルト`` 」構成を保存します。
== 構成の作成と削除
@@ -304,9 +333,15 @@ image::images/newconfig.png[]
image::images/newconfig-created.png[]
-5. 「アナライザ」ドロップダウン・リストで ``「JRE 8プロファイル準拠」`` 、 ``「NetBeans Javaヒント」`` または ``「FindBugs」`` 選択します。
-6. 構成に含めるプロファイル、検査またはbugを指定します。
-7. 「OK」をクリックして編集内容を保存し、「構成」ダイアログ・ボックスを閉じます。
+
+[start=5]
+. 「アナライザ」ドロップダウン・リストで ``「JRE 8プロファイル準拠」`` 、 ``「NetBeans Javaヒント」`` または ``「FindBugs」`` 選択します。
+
+[start=6]
+. 構成に含めるプロファイル、検査またはbugを指定します。
+
+[start=7]
+. 「OK」をクリックして編集内容を保存し、「構成」ダイアログ・ボックスを閉じます。
作成された「 ``newConfig`` 」構成が、「検査」ダイアログ・ボックスの「構成」ドロップダウン・リストで選択可能になります。
[.feature]
@@ -327,7 +362,9 @@ image::images/renamedconfig.png[]
image::images/delete.png[]
-5. 「構成の削除」ダイアログ・ボックスで、「はい」をクリックして構成の削除を確認します。
+
+[start=5]
+. 「構成の削除」ダイアログ・ボックスで、「はい」をクリックして構成の削除を確認します。
image::images/delete-confirm.png[]
@@ -359,7 +396,9 @@ image::images/single-inspection-small.png[role="left", link="images/single-inspe
image::images/hint-inspection-small.png[role="left", link="images/hint-inspection.png"]
--
-4. 「検査」ダイアログ・ボックスで、「検査」をクリックしてソース・コード分析を実行します。
+
+[start=4]
+. 「検査」ダイアログ・ボックスで、「検査」をクリックしてソース・コード分析を実行します。
検査操作が完了すると、ソース・エディタの下にある「インスペクタ・ウィンドウ」に、検出されたコードまたはbugに適用可能なヒントが表示されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_pt_BR.asciidoc
index 18dc9a3..8ce39e8 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_pt_BR.asciidoc
@@ -81,15 +81,21 @@ Além do software necessário listado acima, você deve ter instalado em seu com
image::images/inspect-small.png[role="left", link="images/inspect.png"]
--
-3. Na caixa de diálogo Instalador, clique em Próximo para continuar com a instalação.
+
+[start=3]
+. Na caixa de diálogo Instalador, clique em Próximo para continuar com a instalação.
[.feature]
--
image::images/plugin-small.png[role="left", link="images/plugin.png"]
--
-4. Revise o acordo de licença, selecione a opção do contrato de licença e clique em Instalar.
-5. Quando a instalação for concluída, clique em Finalizar.
+
+[start=4]
+. Revise o acordo de licença, selecione a opção do contrato de licença e clique em Instalar.
+
+[start=5]
+. Quando a instalação for concluída, clique em Finalizar.
== Usando Configurações Predefinidas
@@ -119,7 +125,9 @@ image::images/allconfig-small.png[role="left", link="images/allconfig.png"]
*Observação:* você precisa instalar o plug-in <<plugin,Findbugs>> para executar esta configuração pela primeira vez.
-4. Clique em Inspecionar.
+
+[start=4]
+. Clique em Inspecionar.
Os resultados da análise são exibidos na janela Inspetor como uma view em árvore à esquerda.
[.feature]
@@ -153,19 +161,25 @@ A configuração de ``Dicas Java NetBeans`` disponível no IDE permite que voc
*Observação:* você pode definir um escopo (um arquivo, pacote ou projeto) para a configuração de ``Dicas Java NetBeans`` .
-3. Selecione o botão de rádio Configuração e escolha ``Dicas Java NetBeans`` na lista drop-down.
+
+[start=3]
+. Selecione o botão de rádio Configuração e escolha ``Dicas Java NetBeans`` na lista drop-down.
[.feature]
--
image::images/hints-small.png[role="left", link="images/hints.png"]
--
-4. Clique em Inspecionar.
+
+[start=4]
+. Clique em Inspecionar.
O IDE exibe a view em árvore com os resultados da análise, com a configuração ``Dicas Java NetBeans`` na Janela Inspetor.
image::images/hintsconfig.png[]
-5. Na Janela Inspetor, clique no botão <<categorize,Categorizar>> na barra de ferramentas à esquerda para exibir os problemas agrupados em categorias.
+
+[start=5]
+. Na Janela Inspetor, clique no botão <<categorize,Categorizar>> na barra de ferramentas à esquerda para exibir os problemas agrupados em categorias.
image::images/catview.png[]
@@ -198,14 +212,18 @@ A configuração ``FindBugs`` disponível no IDE permite localizar uma ampla v
*Observação:* Você pode inspecionar um arquivo, pacote ou projeto(s) com a configuração ``FindBugs`` .
-3. Na caixa de diálogo Inspecionar, selecione a configuração ``FindBugs`` .
+
+[start=3]
+. Na caixa de diálogo Inspecionar, selecione a configuração ``FindBugs`` .
[.feature]
--
image::images/fb-small.png[role="left", link="images/fb.png"]
--
-4. Clique no botão Inspecionar para iniciar a análise de código estático.
+
+[start=4]
+. Clique no botão Inspecionar para iniciar a análise de código estático.
O resultado da análise de código estático é exibido na Janela do Inspetor abaixo do editor de código-fonte.
A descrição do erro selecionado é exibida no quadro à direita.
@@ -214,7 +232,9 @@ A descrição do erro selecionado é exibida no quadro à direita.
image::images/inspector-small.png[role="left", link="images/inspector.png"]
--
-5. Se preferir, clique no botão <<categorize,Categorizar>> na barra de ferramentas à esquerda para exibir os erros agrupados em categorias.
+
+[start=5]
+. Se preferir, clique no botão <<categorize,Categorizar>> na barra de ferramentas à esquerda para exibir os erros agrupados em categorias.
image::images/fbcat.png[]
@@ -241,8 +261,12 @@ image::images/source-editor-small.png[role="left", link="images/source-editor.pn
image::images/fb-editor-small.png[role="left", link="images/fb-editor.png"]
--
-4. Selecione a opção Executar FindBugs no Editor.
-5. Clique em OK.
+
+[start=4]
+. Selecione a opção Executar FindBugs no Editor.
+
+[start=5]
+. Clique em OK.
Se você agora pressionar Alt-Enter o código-fonte onde um erro é reportado e clique na seta preta apontando para a direita no final da dica exibida, o IDE mostra algumas opções de correção para um possível erro.
[.feature]
@@ -264,16 +288,24 @@ O IDE exibe a caixa de diálogo Configurações.
image::images/configurations-db.png[]
-4. Garantir ``Default`` é selecionado na lista drop-down Configurações.
-5. Na lista drop-down Analisador, selecione o analisador ``Conformidade de Perfis do JRE 8`` , ``Dicas Java Netbeans`` ou ``FindBugs`` .
-6. Dependendo da escolha do analisador na etapa anterior, selecione o perfil a ser validado, as inspeções ou os erros que você precisa incluir na configuração ``Padrão`` .
+
+[start=4]
+. Garantir ``Default`` é selecionado na lista drop-down Configurações.
+
+[start=5]
+. Na lista drop-down Analisador, selecione o analisador ``Conformidade de Perfis do JRE 8`` , ``Dicas Java Netbeans`` ou ``FindBugs`` .
+
+[start=6]
+. Dependendo da escolha do analisador na etapa anterior, selecione o perfil a ser validado, as inspeções ou os erros que você precisa incluir na configuração ``Padrão`` .
[.feature]
--
image::images/select-inspections-small.png[role="left", link="images/select-inspections.png"]
--
-7. Clique em OK para salvar sua configuração ``Default`` .
+
+[start=7]
+. Clique em OK para salvar sua configuração ``Default`` .
== Criando e Deletando Configurações
@@ -293,9 +325,15 @@ Uma configuração ``newConfig`` será criada e adicionada à lista drop-down
image::images/newconfig-created.png[]
-5. Na lista drop-down Analisador, escolha ``Conformidade de Perfis do JRE 8`` , ``Dicas Java Netbeans`` ou ``FindBugs`` .
-6. Especifique o perfil, as inspeções ou os erros a serem incluídos na sua própria configuração.
-7. Clique em OK para salvar suas edições e fechar a caixa de diálogo Configurações.
+
+[start=5]
+. Na lista drop-down Analisador, escolha ``Conformidade de Perfis do JRE 8`` , ``Dicas Java Netbeans`` ou ``FindBugs`` .
+
+[start=6]
+. Especifique o perfil, as inspeções ou os erros a serem incluídos na sua própria configuração.
+
+[start=7]
+. Clique em OK para salvar suas edições e fechar a caixa de diálogo Configurações.
A configuração ``newConfig`` criada está disponível na lista drop-down Configuração da caixa de diálogo Inspecionar.
[.feature]
@@ -316,7 +354,9 @@ image::images/renamedconfig.png[]
image::images/delete.png[]
-5. Na caixa de diálogo Deletar Configuração, clique em Sim para confirmar a exclusão da configuração.
+
+[start=5]
+. Na caixa de diálogo Deletar Configuração, clique em Sim para confirmar a exclusão da configuração.
image::images/delete-confirm.png[]
@@ -348,7 +388,9 @@ image::images/single-inspection-small.png[role="left", link="images/single-inspe
image::images/hint-inspection-small.png[role="left", link="images/hint-inspection.png"]
--
-4. Na caixa de diálogo Inspecionar, clique em Inspecionar para executar a análise de código-fonte.
+
+[start=4]
+. Na caixa de diálogo Inspecionar, clique em Inspecionar para executar a análise de código-fonte.
Após a operação Inspecionar ser concluída, as dicas que podem ser aplicadas a seu código ou erros que foram encontradas são exibidas na janela Inspetor abaixo o Editor de Código-fonte.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ru.asciidoc
index 075af1f..f8635eb 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_ru.asciidoc
@@ -81,15 +81,21 @@ image::images/jar.png[]
image::images/inspect-small.png[role="left", link="images/inspect.png"]
--
-3. В диалоговом окне 'Программа установки' щелкните 'Далее', чтобы продолжить установку.
+
+[start=3]
+. В диалоговом окне 'Программа установки' щелкните 'Далее', чтобы продолжить установку.
[.feature]
--
image::images/plugin-small.png[role="left", link="images/plugin.png"]
--
-4. Прочтите лицензионное соглашение, выберите положение лицензионного соглашения и щелкните 'Установить'.
-5. По завершении установки нажмите кнопку "Готово".
+
+[start=4]
+. Прочтите лицензионное соглашение, выберите положение лицензионного соглашения и щелкните 'Установить'.
+
+[start=5]
+. По завершении установки нажмите кнопку "Готово".
== Использование заранее определенных настроек
@@ -119,7 +125,9 @@ image::images/allconfig-small.png[role="left", link="images/allconfig.png"]
*Примечание.* Необходимо установить подключаемый модуль <<plugin,FindBugs>> для запуска этой конфигурации в первый раз.
-4. Нажмите кнопку "Проверить".
+
+[start=4]
+. Нажмите кнопку "Проверить".
Результаты анализа отображаются в окне 'Инспектор' в представлении дерева слева.
[.feature]
@@ -153,19 +161,25 @@ image::images/suppress-small.png[role="left", link="images/suppress.png"]
*Примечание.* Можно определить область (файлы. пакеты или проекты) для конфигурации ``Подсказки Java NetBeans`` .
-3. Выберите переключатель 'Конфигурация' и выберите ``Подсказки Java NetBeans`` в раскрывающемся списке.
+
+[start=3]
+. Выберите переключатель 'Конфигурация' и выберите ``Подсказки Java NetBeans`` в раскрывающемся списке.
[.feature]
--
image::images/hints-small.png[role="left", link="images/hints.png"]
--
-4. Нажмите кнопку "Проверить".
+
+[start=4]
+. Нажмите кнопку "Проверить".
В среде IDE отображается представление дерева с результатами анализа с конфигурацией ``Подсказки Java NetBeans`` в окне 'Инспектор'.
image::images/hintsconfig.png[]
-5. В окне 'Инспектор' нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
+
+[start=5]
+. В окне 'Инспектор' нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
image::images/catview.png[]
@@ -198,14 +212,18 @@ image::images/catview.png[]
*Примечание.* Можно проверить файлы, пакеты или проекты с помощью конфигурации ``FindBugs`` .
-3. В диалоговом окне 'Проверка' выберите конфигурацию ``FindBugs`` .
+
+[start=3]
+. В диалоговом окне 'Проверка' выберите конфигурацию ``FindBugs`` .
[.feature]
--
image::images/fb-small.png[role="left", link="images/fb.png"]
--
-4. Щелкните кнопку 'Инспектор' для запуска статического анализа кода.
+
+[start=4]
+. Щелкните кнопку 'Инспектор' для запуска статического анализа кода.
Результат статического анализа кода отображается в окне 'Инспектор' ниже редактора исходного кода.
Описание выбранной проблемы отображается в фрейме справа.
@@ -214,7 +232,9 @@ image::images/fb-small.png[role="left", link="images/fb.png"]
image::images/inspector-small.png[role="left", link="images/inspector.png"]
--
-5. В качестве альтернативы нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
+
+[start=5]
+. В качестве альтернативы нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
image::images/fbcat.png[]
@@ -241,8 +261,12 @@ image::images/source-editor-small.png[role="left", link="images/source-editor.pn
image::images/fb-editor-small.png[role="left", link="images/fb-editor.png"]
--
-4. Выберите 'Выполнить FindBugs' в параметре 'Редактор'.
-5. Нажмите кнопку "ОК".
+
+[start=4]
+. Выберите 'Выполнить FindBugs' в параметре 'Редактор'.
+
+[start=5]
+. Нажмите кнопку "ОК".
Если сейчас нажать Alt-Enter в исходном коде, где сообщается о проблеме, и щелкнуть черную стрелку в конце отображаемой подсказки, в IDE показываются некоторые варианты исправления возможных проблем.
[.feature]
@@ -264,16 +288,24 @@ IDE отображает диалоговое окно 'Конфигурации
image::images/configurations-db.png[]
-4. Убедитесь, что в раскрывающемся списке 'Конфигурация' выбрано ``По умолчанию`` .
-5. В раскрывающемся списке 'Средство анализа' выберите средство анализа ``Соответствие профилей JRE 8`` , ``Подсказки Netbeans Java`` или ``FindBugs`` .
-6. В зависимости от выбранного средства анализа в предыдущем шаге выберите профиль, проверки или ошибки, которые необходимо включить в конфигурацию ``по умолчанию`` .
+
+[start=4]
+. Убедитесь, что в раскрывающемся списке 'Конфигурация' выбрано ``По умолчанию`` .
+
+[start=5]
+. В раскрывающемся списке 'Средство анализа' выберите средство анализа ``Соответствие профилей JRE 8`` , ``Подсказки Netbeans Java`` или ``FindBugs`` .
+
+[start=6]
+. В зависимости от выбранного средства анализа в предыдущем шаге выберите профиль, проверки или ошибки, которые необходимо включить в конфигурацию ``по умолчанию`` .
[.feature]
--
image::images/select-inspections-small.png[role="left", link="images/select-inspections.png"]
--
-7. Нажмите ОК, чтобы сохранить конфигурацию ``По умолчанию`` .
+
+[start=7]
+. Нажмите ОК, чтобы сохранить конфигурацию ``По умолчанию`` .
== Создание и удаление конфигурации
@@ -293,9 +325,15 @@ image::images/newconfig.png[]
image::images/newconfig-created.png[]
-5. В раскрывающемся списке 'Средство анализа' выберите ``Соответствие профилей JRE 8`` , ``Подсказки Netbeans Java`` или ``FindBugs`` .
-6. Укажите профиль, проверки или ошибки для включения в вашу конфигурацию.
-7. Нажмите ОК, чтобы сохранить правки и закрыть диалоговое окно 'Конфигурацию'.
+
+[start=5]
+. В раскрывающемся списке 'Средство анализа' выберите ``Соответствие профилей JRE 8`` , ``Подсказки Netbeans Java`` или ``FindBugs`` .
+
+[start=6]
+. Укажите профиль, проверки или ошибки для включения в вашу конфигурацию.
+
+[start=7]
+. Нажмите ОК, чтобы сохранить правки и закрыть диалоговое окно 'Конфигурацию'.
Созданная конфигурация ``newConfig`` доступна в раскрывающемся списке 'Конфигурация' в диалоговом окне 'Инспектор'.
[.feature]
@@ -316,7 +354,9 @@ image::images/renamedconfig.png[]
image::images/delete.png[]
-5. В диалоговом окне 'Удалить конфигурацию' щелкните 'Да', чтобы подствердить удаление конфигурации.
+
+[start=5]
+. В диалоговом окне 'Удалить конфигурацию' щелкните 'Да', чтобы подствердить удаление конфигурации.
image::images/delete-confirm.png[]
@@ -348,7 +388,9 @@ image::images/single-inspection-small.png[role="left", link="images/single-inspe
image::images/hint-inspection-small.png[role="left", link="images/hint-inspection.png"]
--
-4. В диалоговом окне 'Проверка' щелкните 'Проверка', чтобы выполнить анализ исходного кода.
+
+[start=4]
+. В диалоговом окне 'Проверка' щелкните 'Проверка', чтобы выполнить анализ исходного кода.
После завершения операции 'Проверка', подсказки, которые могут быть применены к коду или проблемам, которые были найдены, отображаются в окне 'Инспектор' ниже редактора исходного кода.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_zh_CN.asciidoc
index 7ce79ee..3a2b203 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/code-inspect_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/code-inspect_zh_CN.asciidoc
@@ -81,15 +81,21 @@ image::images/jar.png[]
image::images/inspect-small.png[role="left", link="images/inspect.png"]
--
-3. 在 "Installer"（安装程序）对话框中，单击 "Next"（下一步）以继续安装。
+
+[start=3]
+. 在 "Installer"（安装程序）对话框中，单击 "Next"（下一步）以继续安装。
[.feature]
--
image::images/plugin-small.png[role="left", link="images/plugin.png"]
--
-4. 查看许可证协议，选择许可证协议选项，然后单击 "Install"（安装）。
-5. 安装完成后，单击 "Finish"（完成）。
+
+[start=4]
+. 查看许可证协议，选择许可证协议选项，然后单击 "Install"（安装）。
+
+[start=5]
+. 安装完成后，单击 "Finish"（完成）。
== 使用预定义配置
@@ -119,7 +125,9 @@ image::images/allconfig-small.png[role="left", link="images/allconfig.png"]
*注：*首次运行此配置时，需要安装 <<plugin,FindBugs>> 插件。
-4. 单击 "Inspect"（检查）。
+
+[start=4]
+. 单击 "Inspect"（检查）。
分析的结果以树视图显示在 "Inspector"（检查器）窗口的左侧。
[.feature]
@@ -153,19 +161,25 @@ image::images/suppress-small.png[role="left", link="images/suppress.png"]
*注：*可以为 ``NetBeans Java Hints`` （NetBeans Java 提示）配置定义范围（文件、包或项目）。
-3. 选择 "Configuration"（配置）单选按钮并在下拉列表中选择 ``NetBeans Java Hints`` （NetBeans Java 提示）。
+
+[start=3]
+. 选择 "Configuration"（配置）单选按钮并在下拉列表中选择 ``NetBeans Java Hints`` （NetBeans Java 提示）。
[.feature]
--
image::images/hints-small.png[role="left", link="images/hints.png"]
--
-4. 单击 "Inspect"（检查）。
+
+[start=4]
+. 单击 "Inspect"（检查）。
IDE 显示树视图，使用 ``NetBeans Java Hints`` （NetBeans Java 提示）配置进行分析的结果显示在 "Inspector"（检查器）窗口中。
image::images/hintsconfig.png[]
-5. 在 "Inspector"（检查器）窗口，在左侧的工具栏中单击 <<categorize,Categorize（分类）>>按钮可以按照类别分组查看问题。
+
+[start=5]
+. 在 "Inspector"（检查器）窗口，在左侧的工具栏中单击 <<categorize,Categorize（分类）>>按钮可以按照类别分组查看问题。
image::images/catview.png[]
@@ -198,14 +212,18 @@ image::images/catview.png[]
*注：*可以使用 ``FindBugs`` 配置检查文件、包或项目。
-3. 在 "Inspect"（检查）对话框中，选择 ``FindBugs`` 配置。
+
+[start=3]
+. 在 "Inspect"（检查）对话框中，选择 ``FindBugs`` 配置。
[.feature]
--
image::images/fb-small.png[role="left", link="images/fb.png"]
--
-4. 单击 "Inspect"（检查）按钮可启动静态代码分析。
+
+[start=4]
+. 单击 "Inspect"（检查）按钮可启动静态代码分析。
静态代码分析的结果显示在源代码编辑器下的 "Inspector"（检查器）窗口中。
所选错误的说明将显示在右侧框架中。
@@ -214,7 +232,9 @@ image::images/fb-small.png[role="left", link="images/fb.png"]
image::images/inspector-small.png[role="left", link="images/inspector.png"]
--
-5. 此外，在左侧的工具栏中单击 <<categorize,Categorize>>（分类）按钮可以按照类别分组查看错误。
+
+[start=5]
+. 此外，在左侧的工具栏中单击 <<categorize,Categorize>>（分类）按钮可以按照类别分组查看错误。
image::images/fbcat.png[]
@@ -241,8 +261,12 @@ image::images/source-editor-small.png[role="left", link="images/source-editor.pn
image::images/fb-editor-small.png[role="left", link="images/fb-editor.png"]
--
-4. 在 "Editor"（编辑器）选项中选择 "Run FindBugs"（运行 FindBugs）。
-5. 单击 "OK"（确定）。
+
+[start=4]
+. 在 "Editor"（编辑器）选项中选择 "Run FindBugs"（运行 FindBugs）。
+
+[start=5]
+. 单击 "OK"（确定）。
现在，如果在源代码中报告了错误的位置按 Alt-Enter，并单击所显示提示结尾的指向右侧的黑色箭头，则 IDE 将针对潜在错误显示一些修复选项。
[.feature]
@@ -264,16 +288,24 @@ IDE 将显示 "Configurations"（配置）对话框。
image::images/configurations-db.png[]
-4. 确保在 "Configurations"（配置）下拉列表中选择了 ``Default`` （默认）。
-5. 在 "Analyzer"（分析器）下拉列表中，选择 ``JRE 8 Profiles Conformance`` （JRE 8 配置文件一致性）、 ``Netbeans Java Hints`` （NetBeans Java 提示）或 ``FindBugs`` 分析器。
-6. 根据在上一步选择的分析器，选择要验证的配置文件、需要在 ``Default`` （默认）配置中包含的检查或错误。
+
+[start=4]
+. 确保在 "Configurations"（配置）下拉列表中选择了 ``Default`` （默认）。
+
+[start=5]
+. 在 "Analyzer"（分析器）下拉列表中，选择 ``JRE 8 Profiles Conformance`` （JRE 8 配置文件一致性）、 ``Netbeans Java Hints`` （NetBeans Java 提示）或 ``FindBugs`` 分析器。
+
+[start=6]
+. 根据在上一步选择的分析器，选择要验证的配置文件、需要在 ``Default`` （默认）配置中包含的检查或错误。
[.feature]
--
image::images/select-inspections-small.png[role="left", link="images/select-inspections.png"]
--
-7. 单击 "OK"（确定）可保存 ``Default`` （默认）配置。
+
+[start=7]
+. 单击 "OK"（确定）可保存 ``Default`` （默认）配置。
== 创建和删除配置
@@ -293,9 +325,15 @@ image::images/newconfig.png[]
image::images/newconfig-created.png[]
-5. 在 "Analyzer"（分析器）下拉列表中，选择 ``JRE 8 Profiles Conformance`` （JRE 8 配置文件一致性）、 ``Netbeans Java Hints`` （NetBeans Java 提示）或 ``FindBugs`` 。
-6. 指定要包括到您自己的配置中的配置文件、检查或错误。
-7. 单击 "OK"（确定）保存所做编辑并关闭 "Configurations"（配置）对话框。
+
+[start=5]
+. 在 "Analyzer"（分析器）下拉列表中，选择 ``JRE 8 Profiles Conformance`` （JRE 8 配置文件一致性）、 ``Netbeans Java Hints`` （NetBeans Java 提示）或 ``FindBugs`` 。
+
+[start=6]
+. 指定要包括到您自己的配置中的配置文件、检查或错误。
+
+[start=7]
+. 单击 "OK"（确定）保存所做编辑并关闭 "Configurations"（配置）对话框。
此时所创建的 ``newConfig`` 配置在 "Inspect"（检查）对话框的 "Configuration"（配置）下拉列表中可用。
[.feature]
@@ -316,7 +354,9 @@ image::images/renamedconfig.png[]
image::images/delete.png[]
-5. 在 "Delete Configuration"（删除配置）对话框中，单击 "Yes"（是）以确认删除配置。
+
+[start=5]
+. 在 "Delete Configuration"（删除配置）对话框中，单击 "Yes"（是）以确认删除配置。
image::images/delete-confirm.png[]
@@ -348,7 +388,9 @@ image::images/single-inspection-small.png[role="left", link="images/single-inspe
image::images/hint-inspection-small.png[role="left", link="images/hint-inspection.png"]
--
-4. 在 "Inspect"（检查）对话框中，单击 "Inspect"（检查）以执行源代码分析。
+
+[start=4]
+. 在 "Inspect"（检查）对话框中，单击 "Inspect"（检查）以执行源代码分析。
检查操作完成后，将在源代码编辑器下的 "Inspector"（检查器）窗口中显示可应用于找到的代码或错误的提示。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded.asciidoc
index 423d2d9..bb18041 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded.asciidoc
@@ -47,14 +47,24 @@ You can download the sample projects used in this tutorial in the following ways
2. In the Checkout dialog box, enter the following Repository URL:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Click Next.
-3. Click Browse to open the Browse Repository Folders dialog box.
-4. Expand the root node and select *samples/java/debugging-samples*. Click OK.
-5. Specify the Local Folder for the sources (the local folder must be empty).
-6. Click Finish.
+
+[start=3]
+. Click Browse to open the Browse Repository Folders dialog box.
+
+[start=4]
+. Expand the root node and select *samples/java/debugging-samples*. Click OK.
+
+[start=5]
+. Specify the Local Folder for the sources (the local folder must be empty).
+
+[start=6]
+. Click Finish.
When you click Finish, the IDE initializes the local folder as a Subversion repository and checks out the project sources.
-7. Click Open Project in the dialog that appears when checkout is complete.
+
+[start=7]
+. Click Open Project in the dialog that appears when checkout is complete.
*Note.* For more about checking out sources with Subversion, see the section on link:../ide/subversion.html#settingUp[+Setting up Subversion+] in the link:../ide/subversion.html[+Guide to Subversion in NetBeans IDE+].
@@ -72,10 +82,16 @@ The Gallery application is a simple Java Swing application that plays animated i
When you click Open the IDE opens and displays the project in the Projects window. If you expand the project node in the Projects window you can see that the project is a simple Java Swing application.
-4. Right-click the project node and choosing Run to launch the Gallery application.
-5. In the Gallery application, click 'More' to add images and click 'Less' to remove images.
+
+[start=4]
+. Right-click the project node and choosing Run to launch the Gallery application.
+
+[start=5]
+. In the Gallery application, click 'More' to add images and click 'Less' to remove images.
image::images/debugging-gallery-app.png[title="Gallery application"]
-6. Close the Gallery application window.
+
+[start=6]
+. Close the Gallery application window.
The Gallery project is a simple multi-threaded application that you will debug in this tutorial.
@@ -88,7 +104,9 @@ The Deadlock application contains a ``main`` method that starts a thread that
When you click Open the IDE opens and displays the project in the Projects window. If you expand the project node in the Projects window you can see that the project is a simple Java application.
-3. Right-click the project node and choosing Run to launch the Deadlock application.
+
+[start=3]
+. Right-click the project node and choosing Run to launch the Deadlock application.
When you click Run, the Output window opens and displays the following output.
@@ -101,7 +119,9 @@ Application started
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. Allow the application to end normally (five minutes).
+
+[start=4]
+. Allow the application to end normally (five minutes).
When the Deadlock application ends you will see the following in the Output window.
@@ -126,12 +146,16 @@ In this exercise you start debugging the Gallery application and add some images
When you click Debug, the IDE starts the Gallery application and opens the default debugging windows. The IDE automatically opens the Debugging window in the left side of the main window and opens the Debugger Console in the Output window.
-2. Click 'More' three times in the Gallery application to start three threads displaying animated images.
+
+[start=2]
+. Click 'More' three times in the Gallery application to start three threads displaying animated images.
If you look in the Debugging window you can see that a new thread was started for each animation.
image::images/debugging-start.png[title="Debugging window"]
-3. Suspend two of the threads by clicking the 'Suspend thread' button to the right of the thread in the Debugging window.
+
+[start=3]
+. Suspend two of the threads by clicking the 'Suspend thread' button to the right of the thread in the Debugging window.
When a thread is suspended, the icon for the thread changes to indicate the new state. You can expand the thread node to view the thread's call stack. You can right-click items in the Debugging window to open a pop-up menu with debug commands.
@@ -155,7 +179,9 @@ This exercise demonstrates what happens when you are stepping through an applica
You can see that the Program Counter in the margin of the editor indicates your position as you step through the method.
-6. Click 'More' in the Gallery application to start a new thread that will hit the method breakpoint.
+
+[start=6]
+. Click 'More' in the Gallery application to start a new thread that will hit the method breakpoint.
When the new thread hits the method breakpoint a New Breakpoint Hit notification appears in the Debugging window that informs you that another thread hit a breakpoint while you were stepping through the method.
@@ -166,15 +192,21 @@ When you are stepping through a thread and a breakpoint is hit in another thread
*Note.* If you look in the Debugging window you can see that the current thread (Thread_Jirka) is indicated by a green bar in the margin. The thread that invoked the notification by hitting the breakpoint (Thread_Roman) is indicated by a yellow bar and the thread icon indicates that the thread is suspended by a breakpoint.
image::images/debugging-current-suspended.png[title="New Breakpoint Hit notification"]
-7. Click the arrow in the New Breakpoint Hit notification to switch the current thread to the new thread (Thread_Roman).
+
+[start=7]
+. Click the arrow in the New Breakpoint Hit notification to switch the current thread to the new thread (Thread_Roman).
When you switch to the new thread you can see the following:
* The program counter moves to the position at line 175 in the new current thread (Thread_Roman).
* A 'suspended thread' annotation is now visible in the margin at line 191 indicating that a thread (Thread_Jirka) is suspended at that line.
image::images/debugging-editor-suspendedannot.png[title="Editor showing debugging annotations"]
-8. Click Step Over a few times to step through the new current thread (Thread_Roman).
-9. Right-click the 'suspended thread' annotation in the editor margin and choose Set as Current Thread > Thread_Jirka to switch back to the suspended thread.
+
+[start=8]
+. Click Step Over a few times to step through the new current thread (Thread_Roman).
+
+[start=9]
+. Right-click the 'suspended thread' annotation in the editor margin and choose Set as Current Thread > Thread_Jirka to switch back to the suspended thread.
image::images/debugging-editor-setcurrent.png[title="Editor showing Set as Current Thread pop-up"]
Alternatively, you can invoke the Current Thread Chooser (Alt+Shift+T; Ctrl+Shift+T on Mac) and switch to any of the application threads.
@@ -205,16 +237,22 @@ To demonstrate the IDE's deadlock detection, you will run the sample Deadlock pr
To set the breakpoint, click in the margin of the source editor next to the line where you want to set the breakpoint. The breakpoint annotation appears in the left margin next to the line. If you open the Breakpoints window (Alt-Shift-5; Ctrl+Shift+5 on Mac) you can see that the two breakpoints are set and enabled.
image::images/debug-deadlock-setbkpt.png[title="Editor showing breakpoint set at line 20"]
-3. Right-click the Deadlock project in the Projects window and choose Debug.
+
+[start=3]
+. Right-click the Deadlock project in the Projects window and choose Debug.
The ``main`` method will run the two threads, and both threads will be suspended at one of the breakpoints. You can see the threads suspended by the breakpoints in the Debugging window.
-4. In the Debugging Window, resume the suspended threads ( ``MyThread1`` and ``MyThread2`` ) by clicking the Resume buttons to the right of the suspended threads in the Debugging window.
+
+[start=4]
+. In the Debugging Window, resume the suspended threads ( ``MyThread1`` and ``MyThread2`` ) by clicking the Resume buttons to the right of the suspended threads in the Debugging window.
image::images/debug-deadlock-resume.png[title="Resuming suspended threads in the Debugging window"]
Resuming the threads ``MyThread1`` and ``MyThread2`` will create the deadlock state.
-5. Choose Debug\Check for Deadlock from the main menu to check the suspended threads for deadlocks.
+
+[start=5]
+. Choose Debug\Check for Deadlock from the main menu to check the suspended threads for deadlocks.
image::images/debug-deadlock-detected.png[title="Resuming suspended threads in the Debugging window"]
If you check the application for deadlocks and a deadlock is detected, a message appears in the Debugging Window informing you about the deadlock. You can see that the threads in deadlock are indicated with a red bar in the left margin of the Debugging window.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ja.asciidoc
index 0fc3bbe..106b96d 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ja.asciidoc
@@ -64,14 +64,24 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
2. 「チェックアウト」ダイアログ・ボックスで次のリポジトリURLを入力します。
``https://svn.netbeans.org/svn/samples~samples-source-code``
「次」をクリックします。
-3. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
-4. ルート・ノードを展開し、*samples/java/debugging-samples*を選択します。「OK」をクリックします。
-5. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
-6. 「終了」をクリックします。
+
+[start=3]
+. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
+
+[start=4]
+. ルート・ノードを展開し、*samples/java/debugging-samples*を選択します。「OK」をクリックします。
+
+[start=5]
+. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
+
+[start=6]
+. 「終了」をクリックします。
「終了」をクリックすると、IDEではローカル・フォルダがSubversionリポジトリとして初期化され、プロジェクト・ソースがチェックアウトされます。
-7. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
+
+[start=7]
+. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
*注意:*Subversionを使用したソースのチェックアウトの詳細は、link:../ide/subversion.html[+NetBeans IDEでのSubversionガイド+]のlink:../ide/subversion.html#settingUp[+Subversionの設定+]の項を参照してください。
@@ -91,10 +101,16 @@ Galleryアプリケーションは、アニメーション・イメージを再
「開く」をクリックすると、IDEによりプロジェクトが「プロジェクト」ウィンドウで開かれ、表示されます。「プロジェクト」ウィンドウでプロジェクト・ノードを展開すると、このプロジェクトが単純なJava Swingアプリケーションであることがわかります。
-4. プロジェクト・ノードを右クリックし、「実行」を選択してGalleryアプリケーションを起動します。
-5. Galleryアプリケーションで、「詳細表示」をクリックしてイメージを追加したり、「簡易表示」をクリックしてイメージを除去したりします。
+
+[start=4]
+. プロジェクト・ノードを右クリックし、「実行」を選択してGalleryアプリケーションを起動します。
+
+[start=5]
+. Galleryアプリケーションで、「詳細表示」をクリックしてイメージを追加したり、「簡易表示」をクリックしてイメージを除去したりします。
image::images/debugging-gallery-app.png[title="Galleryアプリケーション"]
-6. Galleryアプリケーションのウィンドウを閉じます。
+
+[start=6]
+. Galleryアプリケーションのウィンドウを閉じます。
Galleryプロジェクトは、このチュートリアルでデバッグする単純なマルチスレッド・アプリケーションです。
@@ -108,7 +124,9 @@ Deadlockアプリケーションには、500000ミリ秒間実行されるスレ
「開く」をクリックすると、IDEによりプロジェクトが「プロジェクト」ウィンドウで開かれ、表示されます。「プロジェクト」ウィンドウでプロジェクト・ノードを展開すると、このプロジェクトが単純なJavaアプリケーションであることがわかります。
-3. プロジェクト・ノードを右クリックし、「実行」を選択してDeadlockアプリケーションを起動します。
+
+[start=3]
+. プロジェクト・ノードを右クリックし、「実行」を選択してDeadlockアプリケーションを起動します。
「実行」をクリックすると、「出力」ウィンドウが開き、次の出力が表示されます。
@@ -121,7 +139,9 @@ Application started
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. アプリケーションが通常どおり終了するのを待ちます(5分)。
+
+[start=4]
+. アプリケーションが通常どおり終了するのを待ちます(5分)。
Deadlockアプリケーションが終了したら、次の内容が「出力」ウィンドウに表示されます。
@@ -148,12 +168,16 @@ Galleryプロジェクトは、アニメーション・イメージを表示す
「デバッグ」をクリックすると、IDEでGalleryアプリケーションが起動し、デフォルトのデバッグ用ウィンドウが表示されます。IDEによって、メイン・ウィンドウの左側に「デバッグ」ウィンドウが自動的に表示され、「出力」ウィンドウに「デバッガ・コンソール」が表示されます。
-2. Galleryアプリケーションで「詳細表示」を3回クリックし、アニメーション・イメージを表示する3つのスレッドを開始します。
+
+[start=2]
+. Galleryアプリケーションで「詳細表示」を3回クリックし、アニメーション・イメージを表示する3つのスレッドを開始します。
「デバッグ」ウィンドウでは、各アニメーションに対して新しいスレッドが開始されたことがわかります。
image::images/debugging-start.png[title="「デバッグ」ウィンドウ"]
-3. 「デバッグ」ウィンドウのスレッドの右にある「スレッドを一時停止」ボタンをクリックして、スレッドのうち2つを一時停止します。
+
+[start=3]
+. 「デバッグ」ウィンドウのスレッドの右にある「スレッドを一時停止」ボタンをクリックして、スレッドのうち2つを一時停止します。
スレッドが一時停止されると、スレッドのアイコンが新しい状態に変わります。スレッド・ノードを展開してスレッドのコール・スタックを表示できます。デバッグ・コマンドを使用してポップアップ・メニューを開くには、「デバッグ」ウィンドウの項目を右クリックします。
@@ -178,7 +202,9 @@ image::images/debugging-window-toolbar.png[title="「デバッグ」ウィンド
エディタのマージンにある「プログラム・カウンタ」に、メソッドのステップ実行での位置が示されます。
-6. Galleryアプリケーションで「詳細表示」をクリックして、メソッド・ブレークポイントをヒットする新しいスレッドを開始します。
+
+[start=6]
+. Galleryアプリケーションで「詳細表示」をクリックして、メソッド・ブレークポイントをヒットする新しいスレッドを開始します。
新しいスレッドがメソッド・ブレークポイントをヒットすると、メソッドのステップ実行中に別のスレッドがブレークポイントをヒットしたことを通知する「新しいブレークポイントのヒット」通知が「デバッグ」ウィンドウに表示されます。
@@ -189,15 +215,21 @@ image::images/debugging-newbreakpointhit.png[title="「新しいブレークポ
*注意:*「デバッグ」ウィンドウでは、現在のスレッド(Thread_Jirka)がマージン内の緑色のバーで示されていることがわかります。ブレークポイント(Thread_Roman)のヒットによって通知が呼び出されたスレッドは黄色のバーで示され、ブレークポイントによって一時停止されたスレッドはスレッド・アイコンで示されます。
image::images/debugging-current-suspended.png[title="「新しいブレークポイントのヒット」通知"]
-7. 「新しいブレークポイントのヒット」通知内の矢印をクリックして、現在のスレッドを新しいスレッド(Thread_Roman)に切り替えます。
+
+[start=7]
+. 「新しいブレークポイントのヒット」通知内の矢印をクリックして、現在のスレッドを新しいスレッド(Thread_Roman)に切り替えます。
新しいスレッドに切り替えるとき、次のことを確認できます。
* 新しい現在のスレッド(Thread_Roman)で、プログラム・カウンタが175行目に移動します。
* 191行目のマージンに一時停止しているスレッドを示す注釈が表示され、スレッド(Thread_Jirka)がその行で一時停止されていることを示します。
image::images/debugging-editor-suspendedannot.png[title="デバッグ注釈が表示されたエディタ"]
-8. 「ステップ・オーバー」を何回かクリックして、新しい現在のスレッド(Thread_Roman)をステップ実行します。
-9. 一時停止しているスレッドを示す注釈をエディタのマージンで右クリックし、「現在のスレッドとして設定」>「Thread_Jirka」を選択して、元の一時停止されたスレッドに切り替えます。
+
+[start=8]
+. 「ステップ・オーバー」を何回かクリックして、新しい現在のスレッド(Thread_Roman)をステップ実行します。
+
+[start=9]
+. 一時停止しているスレッドを示す注釈をエディタのマージンで右クリックし、「現在のスレッドとして設定」>「Thread_Jirka」を選択して、元の一時停止されたスレッドに切り替えます。
image::images/debugging-editor-setcurrent.png[title="「現在のスレッドとして設定」ポップアップが表示されたエディタ"]
または、「現在のスレッド・チューザ」([Alt]+[Shift]+[T]、Macの場合は[Ctrl]+[Shift]+[T])を呼び出して、任意のアプリケーション・スレッドに切り替えることもできます。
@@ -229,16 +261,22 @@ IDEのデッドロック検出を示すために、デバッガにあるサン
ブレークポイントを設定するには、ブレークポイントを設定する行の横で、ソース・エディタ内のマージンをクリックします。ブレークポイント注釈が、行の横の左マージンに表示されます。「ブレークポイント」ウィンドウ([Alt]+[Shift]+[5]、Macの場合は[Ctrl]+[Shift]+[5])を開くと、2つのブレークポイントが設定され、有効になっていることがわかります。
image::images/debug-deadlock-setbkpt.png[title="20行目にブレークポイントが設定されていることを示すエディタ"]
-3. 「プロジェクト」ウィンドウでDeadlockプロジェクトを右クリックし、「デバッグ」を選択します。
+
+[start=3]
+. 「プロジェクト」ウィンドウでDeadlockプロジェクトを右クリックし、「デバッグ」を選択します。
``main`` メソッドによって2つのスレッドが実行され、これらのスレッドは、ブレークポイントの1つで両方とも一時停止されます。「デバッグ」ウィンドウでは、スレッドがブレークポイントによって一時停止されたことがわかります。
-4. 「デバッグ」ウィンドウで、「デバッグ」ウィンドウ内の一時停止されたスレッドの右にある「再開」ボタンをクリックすることによって、一時停止されたスレッド( ``MyThread1`` および ``MyThread2`` )を再開します。
+
+[start=4]
+. 「デバッグ」ウィンドウで、「デバッグ」ウィンドウ内の一時停止されたスレッドの右にある「再開」ボタンをクリックすることによって、一時停止されたスレッド( ``MyThread1`` および ``MyThread2`` )を再開します。
image::images/debug-deadlock-resume.png[title="「デバッグ」ウィンドウでの一時停止されたスレッドの再開"]
``MyThread1`` スレッドおよび ``MyThread2`` スレッドを再開すると、デッドロックの状況が作成されます。
-5. メイン・メニューから「デバッグ」-「デッドロックを確認」を選択して、一時停止されたスレッドにデッドロックがないかを確認します。
+
+[start=5]
+. メイン・メニューから「デバッグ」-「デッドロックを確認」を選択して、一時停止されたスレッドにデッドロックがないかを確認します。
image::images/debug-deadlock-detected.png[title="「デバッグ」ウィンドウでの一時停止されたスレッドの再開"]
アプリケーションのデッドロックを確認してデッドロックを検出した場合、デッドロックについて知らせるメッセージが「デバッグ」ウィンドウに表示されます。デッドロックのあるスレッドは、「デバッグ」ウィンドウの左マージンに赤色のバーで示されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_pt_BR.asciidoc
index 9a61f0f..f6f422f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_pt_BR.asciidoc
@@ -64,14 +64,24 @@ Você pode fazer o download dos projetos de amostra usados neste tutorial das se
2. Na caixa de diálogo Efetuar Check-out, insira o Repositório URL a seguir:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Clique em Próximo.
-3. Clique em Procurar para abrir a caixa de diálogo Procurar Pastas do Repositório.
-4. Expanda o nó raiz e selecione *samples/java/debugging-samples*. Clique em OK.
-5. Especifique a Pasta Local para o códigos-fonte (a pasta local precisa estar vazia).
-6. Clique em Finalizar.
+
+[start=3]
+. Clique em Procurar para abrir a caixa de diálogo Procurar Pastas do Repositório.
+
+[start=4]
+. Expanda o nó raiz e selecione *samples/java/debugging-samples*. Clique em OK.
+
+[start=5]
+. Especifique a Pasta Local para o códigos-fonte (a pasta local precisa estar vazia).
+
+[start=6]
+. Clique em Finalizar.
Quando você clica em Finalizar, o IDE inicializa a pasta local como um repositório Subversion e verifica os códigos-fonte do projeto.
-7. Clique em Abrir Projeto na caixa de diálogo exibida quando o check-out for concluído.
+
+[start=7]
+. Clique em Abrir Projeto na caixa de diálogo exibida quando o check-out for concluído.
*Observação.* Para saber mais sobre como efetuar check-out do Subversion, consulte a seção link:../ide/subversion.html#settingUp[+Configurando o Subversion+] no link:../ide/subversion.html[+Guia do Subversion no NetBeans IDE+].
@@ -91,10 +101,16 @@ A aplicação Gallery é uma aplicação Java Swing simples que reproduz imagens
Quando você clicar em Abrir, o IDE abrirá e exibirá o projeto na janela Projetos. Se você expandir o nó do projeto na janela Projetos, poderá observar que o projeto é uma aplicação Java Swing simples.
-4. Clique com o botão direito do mouse no nó do projeto e escolha Executar para iniciar a aplicação Gallery.
-5. Na aplicação Gallery, clique em 'Mais' para adicionar imagens e clique em 'Menos' para remover as imagens.
+
+[start=4]
+. Clique com o botão direito do mouse no nó do projeto e escolha Executar para iniciar a aplicação Gallery.
+
+[start=5]
+. Na aplicação Gallery, clique em 'Mais' para adicionar imagens e clique em 'Menos' para remover as imagens.
image::images/debugging-gallery-app.png[title="Aplicação Gallery"]
-6. Feche a janela da aplicação Gallery.
+
+[start=6]
+. Feche a janela da aplicação Gallery.
O projeto Gallery é uma aplicação multithread simples que você irá depurar neste tutorial.
@@ -108,7 +124,9 @@ A aplicação Deadlock contém um método ``main`` que inicia um thread, execu
Quando você clicar em Abrir, o IDE abrirá e exibirá o projeto na janela Projetos. Se você expandir o nó do projeto na janela Projetos, observará que o projeto é uma aplicação Java simples.
-3. Clique com o botão direito do mouse no nó do projeto e escolha Executar para iniciar a aplicação Deadlock.
+
+[start=3]
+. Clique com o botão direito do mouse no nó do projeto e escolha Executar para iniciar a aplicação Deadlock.
Quando você clica em Executar, a janela de Saída abre e exibe a saída a seguir.
@@ -121,7 +139,9 @@ Application started
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. Permite que a aplicação seja finalizada normalmente (cinco minutos).
+
+[start=4]
+. Permite que a aplicação seja finalizada normalmente (cinco minutos).
Quando a aplicação Deadlock for finalizada, será exibido o seguinte na janela de Saída.
@@ -148,12 +168,16 @@ Neste exercício, você começa a depuração da aplicação Gallery e adiciona
Quando você clica em Depurar, o IDE inicia a aplicação Gallery e abre as janelas de depuração default. O IDE abre automaticamente a janela Depuração no lado esquerdo da janela principal e abre a Console do Depurador na janela de Saída.
-2. Clique três vezes em "Mais" na aplicação Gallery para iniciar três threads que exibem imagens animadas.
+
+[start=2]
+. Clique três vezes em "Mais" na aplicação Gallery para iniciar três threads que exibem imagens animadas.
Se você observar a janela Depuração, poderá verificar que um novo thread foi iniciado para cada animação.
image::images/debugging-start.png[title="Janela de Depuração"]
-3. Suspenda dois threads clicando no botão "Suspender thread" à direita do thread, na janela Depuração.
+
+[start=3]
+. Suspenda dois threads clicando no botão "Suspender thread" à direita do thread, na janela Depuração.
Quando um thread é suspenso, o ícone do thread é alterado para indicar o novo estado. Você pode expandir o nó thread para exibir a pilha de chamadas do thread. Você pode clicar com o botão direito do mouse nos itens na janela Depuração para abrir um menu pop-up com os comandos de depuração.
@@ -178,7 +202,9 @@ Este exercício demonstra o que acontece quando você está avançando passo a p
Você observará que o Contador do Programa na margem do editor indica sua posição à medida que você avança passo a passo pelo método.
-6. Clique em "Mais" na aplicação Gallery para iniciar um novo thread que atingirá o ponto de interrupção do método.
+
+[start=6]
+. Clique em "Mais" na aplicação Gallery para iniciar um novo thread que atingirá o ponto de interrupção do método.
Quando o novo thread atingir o ponto de interrupção do método, uma notificação de Nova Ocorrência de Ponto de Interrupção atingida será exibida na janela Depuração, informando que outro thread atingiu um ponto de interrupção enquanto você avançava passo a passo pelo método.
@@ -189,15 +215,21 @@ Quando você estiver avançando passo a passo por um thread, e um ponto de inter
*Observação.* Se você verificar a janela Depuração você poderá ver que o thread atual (thread_jirka) é indicado por uma barra verde na margem. O thread que chamou a notificação atingindo o ponto de interrupção (Thread_Roman) é indicado por uma barra amarela e o ícone do thread indica que o thread está suspenso por um ponto de interrupção.
image::images/debugging-current-suspended.png[title="Notificação de Nova Ocorrência de Ponto de Interrupção"]
-7. Clique na seta, na notificação na notificação de Nova Ocorrência de Ponto de Interrupção atingida, para alternar o thread atual para o novo thread (Thread_Roman).
+
+[start=7]
+. Clique na seta, na notificação na notificação de Nova Ocorrência de Ponto de Interrupção atingida, para alternar o thread atual para o novo thread (Thread_Roman).
Quando alternar para o novo thread, você observará o seguinte:
* O contador do programa se move para a posição na linha 175 no novo thread atual (Thread_Roman).
* Uma anotação "thread suspenso" ficará visível na margem, na linha 191, indicando que um thread (Thread_Jirka) está suspenso nessa linha.
image::images/debugging-editor-suspendedannot.png[title="Editor que mostra as anotações de depuração"]
-8. Clique em Fazer Step Over algumas vezes para avançar passo a passo pelo novo thread atual (Thread_Roman).
-9. Clique com o botão direito do mouse na anotação "thread suspenso" na margem do editor e escolha Definir como Thread Atual > Thread_Jirka para voltar ao thread suspenso.
+
+[start=8]
+. Clique em Fazer Step Over algumas vezes para avançar passo a passo pelo novo thread atual (Thread_Roman).
+
+[start=9]
+. Clique com o botão direito do mouse na anotação "thread suspenso" na margem do editor e escolha Definir como Thread Atual > Thread_Jirka para voltar ao thread suspenso.
image::images/debugging-editor-setcurrent.png[title="Editor mostrando a pop-up Definir como Thread Atual"]
Se preferir, você pode chamar o Seletor de Thread Atual (Alt+Shift+T; Ctrl+Shift+T no Mac) e alternar para qualquer um dos threads da aplicação.
@@ -229,16 +261,22 @@ Para demonstrar a detecção de deadlocks do IDE, você executará o projeto de
Para definir o ponto de interrupção, clique na margem do editor de código-fonte, próximo à linha onde você deseja definir o ponto de interrupção. A anotação do ponto de interrupção é exibida na margem esquerda, perto da linha. Se você abrir a janela Pontos de Interrupção (Alt-Shift-5; Ctrl+Shift+5 no Mac), poderá verificar que os dois pontos de interrupção estão definidos e ativados.
image::images/debug-deadlock-setbkpt.png[title="Editor que mostra o ponto de interrupção definido na linha 20"]
-3. Clique com o botão direito do mouse no projeto Deadlock, na janela Projetos, e escolha Depurar.
+
+[start=3]
+. Clique com o botão direito do mouse no projeto Deadlock, na janela Projetos, e escolha Depurar.
O método ``main`` executará os dois threads e ambos serão suspensos em um dos pontos de interrupção. Você pode visualizar os threads suspensos pelos pontos de interrupção na janela Depuração.
-4. Na janela Depuração, retome os threads suspensos ( ``MyThread1`` e ``MyThread2`` ) clicando nos botões Retomar à direita dos threads suspensos na janela Depuração.
+
+[start=4]
+. Na janela Depuração, retome os threads suspensos ( ``MyThread1`` e ``MyThread2`` ) clicando nos botões Retomar à direita dos threads suspensos na janela Depuração.
image::images/debug-deadlock-resume.png[title="Retomando threads suspensos na janela Depuração"]
A retomada dos threads ``MyThread1`` e ``MyThread2`` criará o estado de deadlock.
-5. Escolha Depurar\Verificar Deadlock no menu principal para verificar se há deadlock nos threads suspensos.
+
+[start=5]
+. Escolha Depurar\Verificar Deadlock no menu principal para verificar se há deadlock nos threads suspensos.
image::images/debug-deadlock-detected.png[title="Retomando threads suspensos na janela Depuração"]
Se você verificar a aplicação e detectar um deadlock, uma mensagem será exibida na janela Depuração que o informará sobre o deadlock. Você pode observar que os threads no deadlock são indicados com uma barra vermelha na margem esquerda da janela Depuração.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ru.asciidoc
index 464679f..063c739 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_ru.asciidoc
@@ -64,14 +64,24 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
2. В диалоговом окне "Проверка" введите следующий URL-адрес репозитория:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Нажмите кнопку "Далее".
-3. Нажмите кнопку Browse ("Обзор") для открытия диалогового окна Browse Repository Folders ("Обзор папок репозитория").
-4. Разверните корневой узел и выберите *samples/java/debugging-samples*. Нажмите кнопку "ОК".
-5. Укажите локальную папку для исходных файлов (папка должна быть пустой).
-6. Нажмите кнопку 'Готово'.
+
+[start=3]
+. Нажмите кнопку Browse ("Обзор") для открытия диалогового окна Browse Repository Folders ("Обзор папок репозитория").
+
+[start=4]
+. Разверните корневой узел и выберите *samples/java/debugging-samples*. Нажмите кнопку "ОК".
+
+[start=5]
+. Укажите локальную папку для исходных файлов (папка должна быть пустой).
+
+[start=6]
+. Нажмите кнопку 'Готово'.
После нажатия кнопки "Готово" среда IDE инициализирует локальную папку в качестве репозитория Subversion и выполняет проверку исходных файлов проекта на выходе.
-7. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
+
+[start=7]
+. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
*Примечание.* Дополнительные сведения об изъятии для использования источников с помощью Subversion см. в разделе link:../ide/subversion.html#settingUp[+Настройка Subversion+] в link:../ide/subversion.html[+Руководстве по Subversion в IDE NetBeans+].
@@ -91,10 +101,16 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
При выборе "Open" в среде IDE проект будет открыт и выведен на экран в окне "Projects". После развертывания узла проекта в окне "Projects" видно, что он представляет собой простое приложение на Java для Swing.
-4. Для запуска приложения "Gallery" щелкните правой кнопкой мыши узел проекта и выберите "Run".
-5. В приложении "Gallery" нажмите кнопку "More" для добавления изображений и "Less" для удаления изображений.
+
+[start=4]
+. Для запуска приложения "Gallery" щелкните правой кнопкой мыши узел проекта и выберите "Run".
+
+[start=5]
+. В приложении "Gallery" нажмите кнопку "More" для добавления изображений и "Less" для удаления изображений.
image::images/debugging-gallery-app.png[title="Приложение "Gallery"."]
-6. Закройте окно приложения "Gallery".
+
+[start=6]
+. Закройте окно приложения "Gallery".
Проект Gallery представляет собой простое многопоточное приложение, процесс отладки которого описывается в данном руководстве.
@@ -108,7 +124,9 @@ image::images/debugging-gallery-app.png[title="Приложение "Galler
При выборе "Open" в среде IDE проект будет открыт и выведен на экран в окне "Projects". После развертывания узла проекта в окне "Projects" видно, что он представляет собой простое приложение Java.
-3. Для запуска приложения "Deadlock" щелкните правой кнопкой мыши узел проекта и выберите "Run".
+
+[start=3]
+. Для запуска приложения "Deadlock" щелкните правой кнопкой мыши узел проекта и выберите "Run".
При нажатии кнопки "Run" откроется окно "Output", в котором отображается следующая выходная информация.
@@ -121,7 +139,9 @@ Application started
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. Пусть приложение нормально завершит работу (пять минут).
+
+[start=4]
+. Пусть приложение нормально завершит работу (пять минут).
По завершении работы приложения "Deadlock" в окне "Output" должна отображаться следующая информация.
@@ -148,12 +168,16 @@ Main thread finished
После нажатия кнопки "Debug" в среде IDE запускается приложение "Gallery", и открываются окна отладки по умолчанию. Окно "Debugging" автоматически открывается в левой области главного окна, а окно "Debugger Console" – в окне "Output".
-2. Трижды нажмите кнопку "More" в приложении "Gallery" для запуска трех потоков выполнения для воспроизведения анимированных изображений.
+
+[start=2]
+. Трижды нажмите кнопку "More" в приложении "Gallery" для запуска трех потоков выполнения для воспроизведения анимированных изображений.
В окне "Debugging" отобразится процесс запуска новых потоков выполнения для каждой анимации.
image::images/debugging-start.png[title="Окно отладки"]
-3. Приостановите два потока выполнения путем нажатия кнопки "Suspend thread" справа от каждого потока в окне "Debugging".
+
+[start=3]
+. Приостановите два потока выполнения путем нажатия кнопки "Suspend thread" справа от каждого потока в окне "Debugging".
Если поток выполнения приостановлен, соответствующий значок изменится, отражая его новое состояние. Для просмотра стека вызовов потока выполнения можно развернуть узел этого потока. Щелкните правой кнопкой мыши элементы в окне 'Отладка', чтобы открыть всплывающее меню с командами отладки.
@@ -178,7 +202,9 @@ image::images/debugging-window-toolbar.png[title="Панель инструме
В счетчике строк кода в поле редактора отображается текущее положение в коде при пошаговом выполнении метода.
-6. Нажмите кнопку "More" в приложении "Gallery" для запуска нового потока выполнения, который должен достичь точки останова.
+
+[start=6]
+. Нажмите кнопку "More" в приложении "Gallery" для запуска нового потока выполнения, который должен достичь точки останова.
Когда новый поток выполнения достигнет точки останова, установленной в методе, в окне "Debugging" появится уведомление "New Breakpoint Hit", информирующее о том, что еще один поток выполнения достиг точки останова в процессе последовательного выполнения метода.
@@ -189,15 +215,21 @@ image::images/debugging-newbreakpointhit.png[title="Уведомление 'До
*Примечание.* В окне "Debugging" отобразится текущий поток (Thread_Jirka), который указывается с помощью зеленой полосы на границы. Поток выполнения, инициировавший уведомление при достижении точки останова (Thread_Roman), отмечен желтой полосой, а значок этого потока указывает на то, что данный поток выполнения приостановлен, поскольку достигнута точка останова.
image::images/debugging-current-suspended.png[title="Уведомление 'Достижение новой точки останова'"]
-7. Для переключения между текущим потоком выполнения и новым потоком (Thread_Roman) в уведомлении "New Breakpoint Hit" нажмите кнопку со стрелкой.
+
+[start=7]
+. Для переключения между текущим потоком выполнения и новым потоком (Thread_Roman) в уведомлении "New Breakpoint Hit" нажмите кнопку со стрелкой.
После переключения на новый поток выполнения на экране можно увидеть следующее:
* Счетчик команд переместился в позицию, соответствующую строке 175 в новом текущем потоке выполнения (Thread_Roman).
* В поле строки 191 появилась аннотация приостановки потока, указывающая на то, что поток выполнения (Thread_Jirka) приостановлен на этой строке.
image::images/debugging-editor-suspendedannot.png[title="Редактор, в котором отображаются аннотации отладки"]
-8. Для пошагового выполнения нового текущего потока (Thread_Roman) несколько раз нажмите "Обход процедур".
-9. Щелкните правой кнопкой мыши аннотацию приостановки потока в поле редактора и выберите "Set as Current Thread > Thread_Jirka" для обратного переключения на приостановленный поток.
+
+[start=8]
+. Для пошагового выполнения нового текущего потока (Thread_Roman) несколько раз нажмите "Обход процедур".
+
+[start=9]
+. Щелкните правой кнопкой мыши аннотацию приостановки потока в поле редактора и выберите "Set as Current Thread > Thread_Jirka" для обратного переключения на приостановленный поток.
image::images/debugging-editor-setcurrent.png[title="Редактор, в котором отображается всплывающее окно 'Задан как текущий поток'"]
Также можно вызвать окно 'Средство выбора текущего потока' (Alt+Shift+T; Ctrl+Shift+T на Mac) и переключиться на любой из потоков приложения.
@@ -229,16 +261,22 @@ image::images/debugging-editor-suspendedannot2.png[title="Редактор, в
Для установки точки останова в поле редактора исходного кода щелкните поле напротив строки, в которой требуется установить точку останова. В левом поле напротив этой строки появится аннотация точки останова. Если открыть окно 'Точки останова' (Alt-Shift-5; Ctrl+Shift+5 на Mac), можно увидеть две установленные и активированные точки останова.
image::images/debug-deadlock-setbkpt.png[title="В редакторе отображаются точки останова, заданные в строке 20"]
-3. Щелкните правой кнопкой мыши проект "Deadlock" в окне "Projects" и выберите "Debug".
+
+[start=3]
+. Щелкните правой кнопкой мыши проект "Deadlock" в окне "Projects" и выберите "Debug".
При вызове метода ``main`` будут запущены эти два потока выполнения, при этом оба потока будут приостановлены в одной из точек останова. Потоки, приостановленные в точках останова, можно просмотреть в окне "Debugging".
-4. В окне "Debugging" возобновите приостановленные потоки выполнения ( ``MyThread1`` и ``MyThread2`` ) путем нажатия кнопки "Resume" справа от приостановленных потоков.
+
+[start=4]
+. В окне "Debugging" возобновите приостановленные потоки выполнения ( ``MyThread1`` и ``MyThread2`` ) путем нажатия кнопки "Resume" справа от приостановленных потоков.
image::images/debug-deadlock-resume.png[title="Восстановление приостановленных потоков в окне "Отладка"."]
Возобновление потоков выполнения ``MyThread1`` и ``MyThread2`` приведет к возникновению ситуации взаимоблокировки.
-5. Выберите в главном меню команду "Debug\Check for Deadlock" для проверки приостановленных потоков выполнения на наличие взаимоблокировок.
+
+[start=5]
+. Выберите в главном меню команду "Debug\Check for Deadlock" для проверки приостановленных потоков выполнения на наличие взаимоблокировок.
image::images/debug-deadlock-detected.png[title="Восстановление приостановленных потоков в окне "Отладка"."]
Если в ходе проверки приложения обнаружена взаимоблокировка, в окне "Debugging" появится сообщение, информирующее об этой ситуации. Потоки выполнения, находящиеся во взаимоблокировке, отмечаются красной полосой в левом поле окна "Debugging".
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_zh_CN.asciidoc
index fd9e324..b9b3e43 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-multithreaded_zh_CN.asciidoc
@@ -64,14 +64,24 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
2. 在 "Checkout"（检出）对话框中，输入以下资源库 URL：
``https://svn.netbeans.org/svn/samples~samples-source-code``
单击 "Next"（下一步）。
-3. 单击 "Browse"（浏览）以打开 "Browse Repository Folders"（浏览资源库文件夹）对话框。
-4. 展开根节点，然后选择 *samples/java/debugging-samples*。单击 "OK"（确定）。
-5. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
-6. 单击 "Finish"（完成）。
+
+[start=3]
+. 单击 "Browse"（浏览）以打开 "Browse Repository Folders"（浏览资源库文件夹）对话框。
+
+[start=4]
+. 展开根节点，然后选择 *samples/java/debugging-samples*。单击 "OK"（确定）。
+
+[start=5]
+. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
+
+[start=6]
+. 单击 "Finish"（完成）。
单击 "Finish"（完成），此时 IDE 会将本地文件夹初始化为 Subversion 资源库，并检出项目源代码。
-7. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
+
+[start=7]
+. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
*注：*有关使用 Subversion 检出源的详细信息，请参见 link:../ide/subversion.html[+NetBeans IDE 中的 Subversion 指南+]中有关link:../ide/subversion.html#settingUp[+设置 Subversion+] 的部分。
@@ -91,10 +101,16 @@ Gallery 应用程序是一个简单的 Java Swing 应用程序，它可以播放
单击 "Open"（打开）之后，IDE 将在 "Projects"（项目）窗口中打开并显示该项目。如果在 "Projects"（项目）窗口中展开该节点，您可以看到该项目是一个简单的 Java Swing 应用程序。
-4. 右键单击该项目节点并选择 "Run"（运行）以启动 Gallery 应用程序。
-5. 在 Gallery 应用程序中，单击 "More"（更多）可添加图像，单击 "Less"（更少）可删除图像。
+
+[start=4]
+. 右键单击该项目节点并选择 "Run"（运行）以启动 Gallery 应用程序。
+
+[start=5]
+. 在 Gallery 应用程序中，单击 "More"（更多）可添加图像，单击 "Less"（更少）可删除图像。
image::images/debugging-gallery-app.png[title="Gallery 应用程序"]
-6. 关闭 Gallery 应用程序窗口。
+
+[start=6]
+. 关闭 Gallery 应用程序窗口。
Gallery 项目是一个简单的多线程应用程序，在本教程中，您将对其进行调试。
@@ -108,7 +124,9 @@ Deadlock 应用程序包含一个 ``main`` 方法，该方法可启动一个
单击 "Open"（打开）之后，IDE 将在 "Projects"（项目）窗口中打开并显示该项目。如果在 "Projects"（项目）窗口中展开该节点，您可以看到该项目是一个简单的 Java 应用程序。
-3. 右键单击该项目节点并选择 "Run"（运行）以启动 Deadlock 应用程序。
+
+[start=3]
+. 右键单击该项目节点并选择 "Run"（运行）以启动 Deadlock 应用程序。
单击 "Run"（运行）之后，"Output"（输出）窗口将打开并显示以下输出。
@@ -121,7 +139,9 @@ Application started
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. 等待应用程序正常结束（五分钟）。
+
+[start=4]
+. 等待应用程序正常结束（五分钟）。
当 Deadlock 应用程序结束时，您将在 "Output"（输出）窗口中看到以下内容。
@@ -148,12 +168,16 @@ Gallery 项目是一个简单的 Java Swing 应用程序，它可以播放动画
单击 "Debug"（调试）之后，IDE 将启动 Gallery 应用程序并打开默认的调试窗口。IDE 会自动在主窗口的左侧打开 "Debugging"（调试）窗口，并在 "Output"（输出）窗口中打开调试器控制台。
-2. 在 Gallery 应用程序中单击 "More"（更多）三次以启动显示动画图像的三个线程。
+
+[start=2]
+. 在 Gallery 应用程序中单击 "More"（更多）三次以启动显示动画图像的三个线程。
查看 "Debugging"（调试）窗口，您可看到为每个动画都启动了一个新线程。
image::images/debugging-start.png[title=""Debugging"（调试）窗口"]
-3. 通过单击 "Debugging"（调试）窗口中线程右侧的 "'Suspend thread"（挂起线程）按钮挂起两个线程。
+
+[start=3]
+. 通过单击 "Debugging"（调试）窗口中线程右侧的 "'Suspend thread"（挂起线程）按钮挂起两个线程。
当线程挂起之后，该线程的图标会相应变化以指示新的状态。您可以展开线程节点查看线程的调用堆栈。您可以右键单击 "Debugging"（调试）窗口中的条目以打开一个带调试命令的弹出式菜单。
@@ -178,7 +202,9 @@ image::images/debugging-window-toolbar.png[title=""Debugging"（调试）窗口
单步调试该方法时，您可以看到编辑器旁注中的程序计数器指示了您的位置。
-6. 在 Gallery 应用程序中单击 "More"（更多）以启动一个将遇到该方法断点的新线程。
+
+[start=6]
+. 在 Gallery 应用程序中单击 "More"（更多）以启动一个将遇到该方法断点的新线程。
当新线程遇到方法断点时，"Debugging"（调试）窗口中会显示一个 "New Breakpoint Hit"（遇到新断点）通知，告诉您在单步调试该方法时另一个线程遇到了断点。
@@ -189,15 +215,21 @@ image::images/debugging-newbreakpointhit.png[title="遇到新断点通知"]
*注：*在 "Debugging"（调试）窗口中，使用旁注中的绿色栏指示当前线程 (Thread_Jirka)。因为遇到断点而调用通知的线程 (Thread_Roman) 由一个黄色条指示，该线程图标表示线程因一个断点而挂起。
image::images/debugging-current-suspended.png[title="遇到新断点通知"]
-7. 单击 "New Breakpoint Hit"（遇到新断点）通知中的箭头可从当前线程切换到新线程 (Thread_Roman)。
+
+[start=7]
+. 单击 "New Breakpoint Hit"（遇到新断点）通知中的箭头可从当前线程切换到新线程 (Thread_Roman)。
切换到新线程后，您可以看到以下变化：
* 程序计数器的位置移动到了新的当前线程 (Thread_Roman) 的第 175 行。
* 现在，可以在第 191 行的旁注中看到一个 "suspended thread"（挂起的线程）标注，表示一个线程 (Thread_Jirka) 在该行挂起。
image::images/debugging-editor-suspendedannot.png[title="显示调试标注的编辑器"]
-8. 多次单击 "Step Over"（步过）以单步调试新的当前线程 (Thread_Roman)。
-9. 右键单击编辑器旁注中的 "suspended thread"（挂起的线程）标注并选择 "Set as Current Thread"（设置为当前线程）> "Thread_Jirka" 切换回挂起的线程。
+
+[start=8]
+. 多次单击 "Step Over"（步过）以单步调试新的当前线程 (Thread_Roman)。
+
+[start=9]
+. 右键单击编辑器旁注中的 "suspended thread"（挂起的线程）标注并选择 "Set as Current Thread"（设置为当前线程）> "Thread_Jirka" 切换回挂起的线程。
image::images/debugging-editor-setcurrent.png[title="显示 "Set as Current Thread"（设置为当前线程）弹出窗口的编辑器"]
此外，您也可以调用 "Current Thread Chooser"（当前线程选择器）（Alt+Shift+T 组合键；在 Mac 上为 Ctrl+Shift+T 组合键）并切换到应用程序的任意线程。
@@ -229,16 +261,22 @@ IDE 可以自动在所有挂起的线程间搜索死锁，因而可以帮助您
要设置断点，请在源代码编辑器中单击您要设置断点的行旁边的旁注。断点标注将出现在旁注中该行的左侧。打开 "Breakpoints"（断点）窗口（Alt-Shift-5 组合键；在 Mac 上为 Ctrl+Shift+5 组合键），可以看到已经设置并启用了两个断点。
image::images/debug-deadlock-setbkpt.png[title="显示在第 20 行设置断点的编辑器"]
-3. 在 "Projects"（项目）窗口中右键单击 Deadlock 项目，然后选择 "Debug"（调试）。
+
+[start=3]
+. 在 "Projects"（项目）窗口中右键单击 Deadlock 项目，然后选择 "Debug"（调试）。
``main`` 方法将运行两个线程，这两个线程都将在其中一个断点处挂起。您可以在 "Debugging"（调试）窗口中看到由断点挂起的线程。
-4. 在 "Debugging"（调试）窗口中，可以通过单击挂起的线程右侧的 "Resume"（恢复）按钮来恢复挂起的线程（ ``MyThread1`` 和 ``MyThread2`` ）。
+
+[start=4]
+. 在 "Debugging"（调试）窗口中，可以通过单击挂起的线程右侧的 "Resume"（恢复）按钮来恢复挂起的线程（ ``MyThread1`` 和 ``MyThread2`` ）。
image::images/debug-deadlock-resume.png[title="恢复 "Debugging"（调试）窗口中挂起的线程"]
恢复线程 ``MyThread1`` 和 ``MyThread2`` 将造成死锁状况。
-5. 从主菜单中选择 "Debug\Check for Deadlock"（调试\检查死锁）可检查挂起的线程以查找死锁。
+
+[start=5]
+. 从主菜单中选择 "Debug\Check for Deadlock"（调试\检查死锁）可检查挂起的线程以查找死锁。
image::images/debug-deadlock-detected.png[title="恢复 "Debugging"（调试）窗口中挂起的线程"]
如果您在应用程序中检测到死锁，则 "Debugging"（调试）窗口中会出现一条消息告诉您有关死锁的情况。您可以看到，在 "Debugging"（调试）窗口的左侧旁注中，死锁由红色条指示。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-visual.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-visual.asciidoc
index e8898df..9651673 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-visual.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-visual.asciidoc
@@ -67,12 +67,16 @@ image::images/debug-snapshot.png[]
The IDE also displays the location of the component in the form hierarchy in the Navigator window. If the Navigator window is not visible you can choose Window > Navigator from the main menu to open the window.
image::images/debug-navigator.png[]
+
+
[start=2]
-2. Right-click the Guess button in the snapshot and choose Go to Component Declaration from the popup menu. When you choose Go to Component Declaration, the IDE opens the source file in the editor and moves the cursor to the line in the code where ``guessButton`` is declared.
+. Right-click the Guess button in the snapshot and choose Go to Component Declaration from the popup menu. When you choose Go to Component Declaration, the IDE opens the source file in the editor and moves the cursor to the line in the code where ``guessButton`` is declared.
image::images/debug-gotodeclaration.png[]
+
+
[start=3]
-3. Right-click the Guess button in the snapshot again and choose Go to Component Source. When you choose Go to Component Source, the IDE opens the source file in the editor and moves the cursor to the line in the source code for the JButton component.
+. Right-click the Guess button in the snapshot again and choose Go to Component Source. When you choose Go to Component Source, the IDE opens the source file in the editor and moves the cursor to the line in the source code for the JButton component.
image::images/debug-gotosource.png[]
@@ -96,17 +100,27 @@ This exercise will demonstrate how you can use the GUI snapshot and the Events w
1. Right-click the Guess button in the snapshot and choose Show Listeners from the popup menu. When you choose Show Listeners, the IDE opens the Events window. You can see that the Custom Listeners node is expanded.
image::images/debug-customlisteners.png[]
+
+
[start=2]
-2. Right-click *com.toy.anagrams.ui.Anagrams$3* below the Custom Listeners node and choose Go to Component Source in the popup menu. The source code opens in the editor at the line where the listener is defined.
-3. Select the empty text field in the snapshot. Alternatively, you can select the ``guessedWord`` text field in the Navigator window. When you select the text field, the items in the Events window will change automatically to display the listeners for the selected component.
-4. In the Events window, double-click the Event Log node to open the Select Listener window. Alternatively, you can right-click the Event Log node and choose Set Logging Events from the popup menu.
-5. Select the ``java.awt.event.KeyListener`` listener from the dialog. Click OK.
+. Right-click *com.toy.anagrams.ui.Anagrams$3* below the Custom Listeners node and choose Go to Component Source in the popup menu. The source code opens in the editor at the line where the listener is defined.
+
+[start=3]
+. Select the empty text field in the snapshot. Alternatively, you can select the ``guessedWord`` text field in the Navigator window. When you select the text field, the items in the Events window will change automatically to display the listeners for the selected component.
+
+[start=4]
+. In the Events window, double-click the Event Log node to open the Select Listener window. Alternatively, you can right-click the Event Log node and choose Set Logging Events from the popup menu.
+
+[start=5]
+. Select the ``java.awt.event.KeyListener`` listener from the dialog. Click OK.
image::images/debug-select-listener.png[]
This listener is now listening for keyboard events in the text field.
+
+
[start=6]
-6. In the Anagram Game application, type some characters in the text field. When you type a character in the text field, the event is recorded in the events log. If you expand the Event Log node you can see that each keystroke is now logged. New events appear each time that you type in the Anagram Game application text field. If you expand an individual event, for example ``keyPressed`` , you can see the properties of that event in the log.
+. In the Anagram Game application, type some characters in the text field. When you type a character in the text field, the event is recorded in the events log. If you expand the Event Log node you can see that each keystroke is now logged. New events appear each time that you type in the Anagram Game application text field. If you expand an individual event, for example ``keyPressed`` , you can see the properties of that event in the log.
image::images/debug-eventlog.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ja.asciidoc
index f71de77..7852728 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ja.asciidoc
@@ -60,7 +60,9 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
「終了」をクリックすると、IDEがプロジェクトを作成し、そのプロジェクトが「プロジェクト」ウィンドウで開きます。
-4. ツールバーの「デバッグ」ボタン([Ctrl]-[F5]、Macの場合は[⌘]-[F5])をクリックしてデバッグ・セッションを開始します。
+
+[start=4]
+. ツールバーの「デバッグ」ボタン([Ctrl]-[F5]、Macの場合は[⌘]-[F5])をクリックしてデバッグ・セッションを開始します。
または、「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「デバッグ」を選択します。
@@ -68,7 +70,9 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
デバッガの実行の詳細は、_NetBeans IDEによるアプリケーションの開発_のlink:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG798[+Javaアプリケーション・プロジェクトの実行およびデバッグ+]を参照してください。
-5. メイン・メニューから「デバッグ」>「GUIスナップショットを作成」を選択します。
+
+[start=5]
+. メイン・メニューから「デバッグ」>「GUIスナップショットを作成」を選択します。
「GUIスナップショットを作成」を選択すると、IDEによってGUIのスナップショットが作成され、そのスナップショットがメイン・ウィンドウに表示されます。
@@ -100,12 +104,16 @@ image::images/debug-snapshot.png[title="GUIスナップショット"]
また、IDEでは、コンポーネントの場所が「ナビゲータ」ウィンドウ内に階層形式で表示されます。
image::images/debug-navigator.png[title="GUIスナップショット"]
-2. スナップショット内の「Guess」ボタンを右クリックし、ポップアップ・メニューから「コンポーネント宣言へ移動」を選択します。
+
+[start=2]
+. スナップショット内の「Guess」ボタンを右クリックし、ポップアップ・メニューから「コンポーネント宣言へ移動」を選択します。
「コンポーネント宣言へ移動」を選択すると、IDEによってソース・ファイルがエディタに表示され、 ``guessButton`` が宣言されているコード内の行にカーソルが移動されます。
image::images/debug-gotodeclaration.png[title="コンポーネントが宣言されているコードの行"]
-3. スナップショット内の「Guess」ボタンをもう一度右クリックし、「コンポーネント・ソースへ移動」を選択します。
+
+[start=3]
+. スナップショット内の「Guess」ボタンをもう一度右クリックし、「コンポーネント・ソースへ移動」を選択します。
「コンポーネント・ソースへ移動」を選択すると、IDEによってソース・ファイルがエディタに表示され、JButtonコンポーネントのソース・コード内の行にカーソルが移動されます。
@@ -118,13 +126,21 @@ GUIスナップショットの「階層の追加へ移動」コマンドを使
*注意:*NetBeans IDE 7.1では、「オプション」ウィンドウの「Javaデバッガ」タブは「その他」カテゴリ内にあります。
-3. カテゴリ・リストの「ビジュアル・デバッグ」を選択し、「*コンポーネント階層の変更箇所をトラック*」を選択します。「OK」をクリックします。
-4. デバッグ・セッション(実行中の場合)を停止します。
+
+[start=3]
+. カテゴリ・リストの「ビジュアル・デバッグ」を選択し、「*コンポーネント階層の変更箇所をトラック*」を選択します。「OK」をクリックします。
+
+[start=4]
+. デバッグ・セッション(実行中の場合)を停止します。
*注意:*「オプション」ウィンドウでコマンドを有効にした後、「階層の追加へ移動」コマンドを使用できるようにするには、デバッグ・セッションを再起動して、新規のGUIスナップショットを取る必要があります。
-5. 新規デバッグ・セッションを開始し、GUIスナップショットを作成します。
-6. GUIスナップショット内のコンポーネントを右クリックし、「階層の追加へ移動」を選択します。
+
+[start=5]
+. 新規デバッグ・セッションを開始し、GUIスナップショットを作成します。
+
+[start=6]
+. GUIスナップショット内のコンポーネントを右クリックし、「階層の追加へ移動」を選択します。
IDEによって、コンポーネントが追加されている行の部分のソース・コードがエディタに表示されます。
@@ -140,26 +156,36 @@ image::images/debug-hierarchy.png[title="コンポーネントがコンテナに
「リスナーを表示」を選択すると、IDEによって「イベント」ウィンドウが表示されます。「カスタム・リスナー」ノードが展開されることが確認できます。
image::images/debug-customlisteners.png[title="コンポーネントがコンテナに追加されているソース・コードの行"]
-2. 「カスタム・リスナー」ノードの下にある「*com.toy.anagrams.ui.Anagrams$3*」を右クリックし、ポップアップ・メニューで「コンポーネント・ソースへ移動」を選択します。
+
+[start=2]
+. 「カスタム・リスナー」ノードの下にある「*com.toy.anagrams.ui.Anagrams$3*」を右クリックし、ポップアップ・メニューで「コンポーネント・ソースへ移動」を選択します。
リスナーが定義されている行の部分のソース・コードがエディタに表示されます。
-3. スナップショット内の空のテキスト・フィールドを選択します。
+
+[start=3]
+. スナップショット内の空のテキスト・フィールドを選択します。
または、「ナビゲータ」ウィンドウで「 ``guessedWord`` 」テキスト・フィールドを選択できます。
このテキスト・フィールドを選択すると、「イベント」ウィンドウ内の項目が自動的に変更され、選択されたコンポーネントのリスナーが表示されます。
-4. 「イベント」ウィンドウで、「イベント・ログ」ノードをダブルクリックして「リスナーを選択」ウィンドウを開きます。
+
+[start=4]
+. 「イベント」ウィンドウで、「イベント・ログ」ノードをダブルクリックして「リスナーを選択」ウィンドウを開きます。
または、「イベント・ログ」ノードを右クリックし、ポップアップ・メニューから「ロギング・イベントを設定」を選択できます。
-5. ダイアログから「 ``java.awt.event.KeyListener`` 」リスナーを選択します。「OK」をクリックします。
+
+[start=5]
+. ダイアログから「 ``java.awt.event.KeyListener`` 」リスナーを選択します。「OK」をクリックします。
image::images/debug-select-listener.png[title="コンポーネントがコンテナに追加されているソース・コードの行"]
このリスナーは現在、テキスト・フィールド内のキーボード・イベントを待機しています。
-6. Anagram Gameアプリケーションで、テキスト・フィールドに何文字か入力します。
+
+[start=6]
+. Anagram Gameアプリケーションで、テキスト・フィールドに何文字か入力します。
テキスト・フィールドに文字を入力すると、そのイベントがイベント・ログに記録されます。「イベント・ログ」ノードを展開すると、各キー・ストロークがログに記録されていることが確認できます。Anagram Gameアプリケーションのテキスト・フィールドに入力するたびに、新しいイベントが表示されます。個々のイベント(たとえば、 ``keyPressed`` )を展開すると、ログ内のそのイベントのプロパティが表示されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_pt_BR.asciidoc
index 3a04d97..ebe8b2f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_pt_BR.asciidoc
@@ -60,7 +60,9 @@ Neste tutorial você irá usar a aplicação de amostra Jogo de Anagramas, uma a
Quando você clica em Finalizar, o IDE cria o projeto e o abre na janela Projetos.
-4. Clique no botão Depurar na barra de ferramentas (Ctrl-F5; -F5 no Mac) para iniciar a sessão de depuração.
+
+[start=4]
+. Clique no botão Depurar na barra de ferramentas (Ctrl-F5; -F5 no Mac) para iniciar a sessão de depuração.
Alternativamente, clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Depurar.
@@ -68,7 +70,9 @@ Quando você inicia a sessão, o IDE irá iniciar a aplicação Jogo de Anagrama
Para obter mais informações sobre a execução do depurador, consulte link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG798[+Sobre Execução e Depuração de Projetos de Aplicação Java+] em _Desenvolvendo Aplicações com o NetBeans IDE_.
-5. Escolha Depurar > Obter Snapshot da GUI no menu principal.
+
+[start=5]
+. Escolha Depurar > Obter Snapshot da GUI no menu principal.
Quando você escolhe Obter um Snapshot da GUI, o IDE irá obter um snapshot da GUI e irá abrir o snapshot na janela principal.
@@ -100,12 +104,16 @@ image::images/debug-snapshot.png[title="Snapshot GUI"]
O IDE também exibe o local do componente na forma hierárquica na janela Navegador.
image::images/debug-navigator.png[title="Snapshot GUI"]
-2. Clique com o botão direito do mouse no botão Adivinhar no snapshot e escolha Ir para a Declaração do Componente no menu pop-up.
+
+[start=2]
+. Clique com o botão direito do mouse no botão Adivinhar no snapshot e escolha Ir para a Declaração do Componente no menu pop-up.
Quando você escolhe Ir para a Declaração do Componente, o IDE abre o arquivo de códigos-fonte no editor e move o cursor para a linha no código onde ``guessButton`` está declarado.
image::images/debug-gotodeclaration.png[title="Linha de código onde o componente é declarado"]
-3. Clique novamente com o botão direito do mouse no botão Adivinhar no snapshot e escolha Ir para o Código-fonte do Componente.
+
+[start=3]
+. Clique novamente com o botão direito do mouse no botão Adivinhar no snapshot e escolha Ir para o Código-fonte do Componente.
Quando você escolhe Ir para o Código-fonte do Componente, o IDE abre o arquivo de códigos-fonte no editor e move o cursor para a linha no código para o componente JButton.
@@ -118,13 +126,21 @@ Você pode usar o comando Ir Para a Adição de Hierarquia no snapshot GUI para
*Observação.* No NetBeans IDE 7.1, a guia Depurador Java está localizada na categoria Diversos na janela Opções.
-3. Selecione Depuração Visual na lista de categorias e selecione *Rastrear as localizações das alterações de hierarquia do componente*. Clique em OK.
-4. Interrompa sua sessão de depuração (se uma estiver em execução).
+
+[start=3]
+. Selecione Depuração Visual na lista de categorias e selecione *Rastrear as localizações das alterações de hierarquia do componente*. Clique em OK.
+
+[start=4]
+. Interrompa sua sessão de depuração (se uma estiver em execução).
*Observação.* Após ativar o comando na janela Opções, você precisará reiniciar sua sessão de depuração e obter um novo snapshot GUI antes de usar o comando Ir Para a Adição de Hierarquia.
-5. Inicie uma sessão de depuração e obtenha um snapshot da GUI.
-6. Clique com o botão direito do mouse em um componente no snapshot da GUI e escolha Ir Para a Adição de Hierarquia.
+
+[start=5]
+. Inicie uma sessão de depuração e obtenha um snapshot da GUI.
+
+[start=6]
+. Clique com o botão direito do mouse em um componente no snapshot da GUI e escolha Ir Para a Adição de Hierarquia.
O IDE irá abrir o código-fonte no editor na linha onde o componente está adicionado.
@@ -140,26 +156,36 @@ Este exercício irá demonstrar como você pode usar o snapshot da GUI e a janel
Quando você escolhe Mostrar Listeners, o IDE abre a janela Eventos. Você pode ver que o nó Listeners Personalizados está expandido.
image::images/debug-customlisteners.png[title="Linha do código-fonte onde o componente é adicionado ao contêiner"]
-2. Clique com o botão direito do mouse em *com.toy.anagrams.ui.Anagrams$3* abaixo do nó Listeners Personalizados e escolha Ir para o Código-fonte do Componente no menu pop-up.
+
+[start=2]
+. Clique com o botão direito do mouse em *com.toy.anagrams.ui.Anagrams$3* abaixo do nó Listeners Personalizados e escolha Ir para o Código-fonte do Componente no menu pop-up.
O código-fonte é aberto no editor na linha onde o listener está definido.
-3. Selecione o campo de texto vazio no snapshot.
+
+[start=3]
+. Selecione o campo de texto vazio no snapshot.
Outra opção é selecionar o campo de texto ``guessedWord`` na janela Navegador.
Quando você selecionar o campo de texto, os itens na janela Eventos irá mudar automaticamente para exibir os listeners para o componente selecionado.
-4. Na janela Eventos, clique duas vezes no nó Log de Eventos para abrir a janela Selecionar Listener.
+
+[start=4]
+. Na janela Eventos, clique duas vezes no nó Log de Eventos para abrir a janela Selecionar Listener.
Se preferir, clique com o botão direito do mouse no nó Log de Eventos e escolha Definir o Log de Eventos do menu pop-up.
-5. Selecione o listener ``java.awt.event.KeyListener`` na caixa de diálogo. Clique em OK.
+
+[start=5]
+. Selecione o listener ``java.awt.event.KeyListener`` na caixa de diálogo. Clique em OK.
image::images/debug-select-listener.png[title="Linha do código-fonte onde o componente é adicionado ao contêiner"]
Este listener está agora fazendo listening para eventos de teclado no campo de texto.
-6. Na aplicação Jogo de Anagramas, digite alguns caracteres no campo de texto.
+
+[start=6]
+. Na aplicação Jogo de Anagramas, digite alguns caracteres no campo de texto.
Quando você digita um caractere no campo de texto, o evento é registrado no log de eventos. Caso você expanda o nó Log de Eventos, poderá ver que cada tecla pressionada está agora registrada. Novos eventos aparecem todas as vezes que você digita no campo de texto da aplicação Jogo de Anagramas. Se você expandir um evento individual, por exemplo ``keyPressed`` , poderá ver as propriedades daquele evento no log.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ru.asciidoc
index b4304aa..b9656c5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_ru.asciidoc
@@ -60,7 +60,9 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
При нажатии на кнопку 'Готово' IDE создает проект, который открывается в окне 'Проекты'.
-4. Нажмите кнопку 'Отладка' на панели инструментов (Ctrl-F5; ⌘-F5 в Mac) для запуска сеанса отладки.
+
+[start=4]
+. Нажмите кнопку 'Отладка' на панели инструментов (Ctrl-F5; ⌘-F5 в Mac) для запуска сеанса отладки.
Также вы можете щелкнуть правой кнопкой мыши узел проекта в окне 'Проекты' и выбрав 'Отладка'.
@@ -68,7 +70,9 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
Дополнительные сведения о работе с отладчиком см. в разделе link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG798[+Запуск и отладка проектов приложений Java+] в документе _Разработка приложений в IDE NetBeans_.
-5. В главном меню выберите "Отладка" > "Сделать снимок графического интерфейса пользователя".
+
+[start=5]
+. В главном меню выберите "Отладка" > "Сделать снимок графического интерфейса пользователя".
При выборе пункта "Сделать снимок графического интерфейса пользователя" среда IDE сделает моментальный снимок графического интерфейса пользователя и откроет снимок в главном окне.
@@ -100,12 +104,16 @@ image::images/debug-snapshot.png[title="Снимок графического и
Среда IDE также отображает местоположение компонента в иерархии формы в окне навигатора.
image::images/debug-navigator.png[title="Снимок графического интерфейса пользователя"]
-2. Щелкните кнопку "Определить" правой кнопкой мыши и во всплывающем меню выберите пункт "Перейти к объявлению компонента".
+
+[start=2]
+. Щелкните кнопку "Определить" правой кнопкой мыши и во всплывающем меню выберите пункт "Перейти к объявлению компонента".
При выборе команды "Перейти к объявлению компонента" среда IDE открывает файл исходного кода в редакторе и перемещает курсор на ту строку в коде, в которой объявляется ``guessButton`` .
image::images/debug-gotodeclaration.png[title="Строка кода, в которой объявлен компонент"]
-3. Щелкните кнопку "Определить" правой кнопкой мыши на моментальном снимке и выберите "Перейти к исходному коду компонента".
+
+[start=3]
+. Щелкните кнопку "Определить" правой кнопкой мыши на моментальном снимке и выберите "Перейти к исходному коду компонента".
При выборе команды "Перейти к исходному коду компонента" среда IDE открывает файл исходного кода в редакторе и перемещает курсор на строку исходного кода компонента JButton.
@@ -118,13 +126,21 @@ image::images/debug-gotosource.png[title="Строка исходного код
*Примечание.* В NetBeans IDE 7.1 вкладка 'Отладчик' находится в категории 'Разное' в том же окне 'Параметры'.
-3. В списке категорий выберите "Визуальная отладка", а затем выберите *Отслеживать местоположения изменений в иерархии компонентов*. Нажмите кнопку "ОК".
-4. Остановите сеанс отладки (если он запущен).
+
+[start=3]
+. В списке категорий выберите "Визуальная отладка", а затем выберите *Отслеживать местоположения изменений в иерархии компонентов*. Нажмите кнопку "ОК".
+
+[start=4]
+. Остановите сеанс отладки (если он запущен).
*Примечание.* После включения команды 'Перейти к добавлению иерархии' в окне 'Параметры' потребуется начать сеанс отладки заново и сделать новый снимок графического интерфейса. После этого можно будет использовать команду.
-5. Начните новый сеанс отладки и сделайте снимок графического интерфейса.
-6. Щелкните компонент правой кнопкой мыши на моментальном снимке графического интерфейса пользователя и выберите "Перейти к добавлению иерархии".
+
+[start=5]
+. Начните новый сеанс отладки и сделайте снимок графического интерфейса.
+
+[start=6]
+. Щелкните компонент правой кнопкой мыши на моментальном снимке графического интерфейса пользователя и выберите "Перейти к добавлению иерархии".
Среда IDE откроет исходный код в редакторе на строке, в которой добавляется компонент.
@@ -140,26 +156,36 @@ image::images/debug-hierarchy.png[title="Строка исходного код
При выборе команды "Показать прослушиватели" среда IDE открывает окно "События". Как видно, узел "Особые прослушиватели" развернут.
image::images/debug-customlisteners.png[title="Строка исходного кода, в которой компонент добавлен в контейнер"]
-2. Правой кнопкой мыши щелкните *com.toy.anagrams.ui.Anagrams$3* в узле "Особые прослушиватели" и во всплывающем выберите команду "Перейти к исходному тексту компонента".
+
+[start=2]
+. Правой кнопкой мыши щелкните *com.toy.anagrams.ui.Anagrams$3* в узле "Особые прослушиватели" и во всплывающем выберите команду "Перейти к исходному тексту компонента".
Исходный код открывается в редакторе на той строке, в которой определяется прослушиватель.
-3. Выберите пустое текстовое поле на снимке.
+
+[start=3]
+. Выберите пустое текстовое поле на снимке.
Также можно выбрать текстовое поле ``guessedWord`` в окне "Навигатор".
При выборе текстового поля элементы в окне "События" автоматически изменятся, и в окне будут отображены прослушиватели выбранного компонента.
-4. В окне "События" дважды щелкните узел "Журнал событий". При этом откроется окно "Выбор прослушивателя".
+
+[start=4]
+. В окне "События" дважды щелкните узел "Журнал событий". При этом откроется окно "Выбор прослушивателя".
Также можно щелкнуть правой кнопкой мыши узел Event Log и выбрать 'Задать события журналирования' во всплывающем меню.
-5. В диалоге выберите прослушивающий процесс ``java.awt.event.KeyListener`` . Нажмите кнопку "ОК".
+
+[start=5]
+. В диалоге выберите прослушивающий процесс ``java.awt.event.KeyListener`` . Нажмите кнопку "ОК".
image::images/debug-select-listener.png[title="Строка исходного кода, в которой компонент добавлен в контейнер"]
Теперь прослушиватель прослушивает события клавиатуры в текстовом поле.
-6. В приложении "Анаграммы" в текстовом поле введите несколько символов.
+
+[start=6]
+. В приложении "Анаграммы" в текстовом поле введите несколько символов.
При вводе вами символа это событие записывается в журнал. Развернув узел "Журнал событий", вы увидите, что каждое нажатие клавиши записано. Новые события появляются при каждом вводе символов в текстовое поле игры "Анаграммы". Развернув отдельное событие, например ``keyPressed`` , вы увидите свойства этого события в журнале.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_zh_CN.asciidoc
index 0bb7ad2..88f3f8e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/debug-visual_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/debug-visual_zh_CN.asciidoc
@@ -60,7 +60,9 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
单击 "Finish"（完成），此时 IDE 将创建项目并在 "Projects"（项目）窗口中打开该项目。
-4. 单击工具栏中的“调试”按钮（Ctrl-F5 组合键；在 Mac 上为 ⌘-F5 组合键）以启动调试会话。
+
+[start=4]
+. 单击工具栏中的“调试”按钮（Ctrl-F5 组合键；在 Mac 上为 ⌘-F5 组合键）以启动调试会话。
或者，在“项目”窗口中右键单击项目节点，然后选择“调试”。
@@ -68,7 +70,9 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
有关运行调试器的更多信息，请参见_使用 NetBeans IDE 开发应用程序_中的link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG798[+关于运行和调试 Java 应用程序项目+]。
-5. 从主菜单中选择“调试”>“生成 GUI 快照”。
+
+[start=5]
+. 从主菜单中选择“调试”>“生成 GUI 快照”。
选择“生成 GUI 快照”时，IDE 将生成 GUI 的快照，并在主窗口中打开该快照。
@@ -100,12 +104,16 @@ image::images/debug-snapshot.png[title="GUI 快照"]
IDE 还会在 "Navigator"（导航器）窗口的窗体分层结构中显示组件的位置。
image::images/debug-navigator.png[title="GUI 快照"]
-2. 在快照中右键单击 "Guess" 按钮，然后从弹出式菜单中选择“转至组件声明”。
+
+[start=2]
+. 在快照中右键单击 "Guess" 按钮，然后从弹出式菜单中选择“转至组件声明”。
选择 "Go to Component Declaration"（转至组件声明）时，IDE 将在编辑器中打开源文件，然后将光标移至代码中声明 ``guessButton`` 的行。
image::images/debug-gotodeclaration.png[title="声明组件的代码行"]
-3. 在快照中再次右键单击 "Guess" 按钮，然后选择 "Go to Component Source"（转至组件源文件）。
+
+[start=3]
+. 在快照中再次右键单击 "Guess" 按钮，然后选择 "Go to Component Source"（转至组件源文件）。
选择 "Go to Component Source"（转至组件源文件）时，IDE 将在编辑器中打开源文件，然后将光标移至 JButton 组件源代码中的相应行。
@@ -118,13 +126,21 @@ image::images/debug-gotosource.png[title="组件的源代码行"]
*注：*在 NetBeans IDE 7.1 中，"Java Debugger"（Java 调试器）标签位于 "Options"（选项）窗口中的 "Miscellaneous"（其他）类别下。
-3. 在类别列表中选择“可视调试”，然后选择*跟踪组件分层结构更改的位置*。单击 "OK"（确定）。
-4. 停止调试会话（如果正在运行）。
+
+[start=3]
+. 在类别列表中选择“可视调试”，然后选择*跟踪组件分层结构更改的位置*。单击 "OK"（确定）。
+
+[start=4]
+. 停止调试会话（如果正在运行）。
*注：*在 "Options"（选项）窗口中启用此命令后，需要重新启动调试会话并生成新的 GUI 快照，然后才能使用 "Go to Hierarchy Addition"（转至分层结构其他源文件）命令。
-5. 启动新的调试会话并生成 GUI 快照。
-6. 在 GUI 快照中右键单击组件，然后选择“转至分层结构其他源文件”。
+
+[start=5]
+. 启动新的调试会话并生成 GUI 快照。
+
+[start=6]
+. 在 GUI 快照中右键单击组件，然后选择“转至分层结构其他源文件”。
IDE 将在编辑器中添加组件的行上打开源代码。
@@ -140,26 +156,36 @@ image::images/debug-hierarchy.png[title="将组件添加到容器中的源代码
选择 "Show Listeners"（显示监听程序）时，IDE 将会打开 "Events"（事件）窗口。您可以看到 "Custom Listeners"（定制监听程序）节点已展开。
image::images/debug-customlisteners.png[title="将组件添加到容器中的源代码行"]
-2. 右键单击 "Custom Listeners"（定制监听程序）节点下方的 *com.toy.anagrams.ui.Anagrams$3*，然后在弹出式菜单中选择“转至组件源文件”。
+
+[start=2]
+. 右键单击 "Custom Listeners"（定制监听程序）节点下方的 *com.toy.anagrams.ui.Anagrams$3*，然后在弹出式菜单中选择“转至组件源文件”。
源代码在编辑器中定义监听程序的行上打开。
-3. 在快照中选择空文本字段。
+
+[start=3]
+. 在快照中选择空文本字段。
此外，也可以在“导航器”窗口中选择 ``guessedWord`` 文本字段。
选择文本字段时，“事件”窗口中的项将会自动更改，以显示选定组件的监听程序。
-4. 在“事件”窗口中，双击 "Event Log"（事件日志）节点打开 "Select Listener"（选择监听程序）窗口。
+
+[start=4]
+. 在“事件”窗口中，双击 "Event Log"（事件日志）节点打开 "Select Listener"（选择监听程序）窗口。
此外，也可以右键单击 "Event Log"（事件日志）节点，然后从弹出式菜单中选择 "Set Logging Events"（设置日志记录事件）。
-5. 从对话框中选择 ``java.awt.event.KeyListener`` 监听程序。单击 "OK"（确定）。
+
+[start=5]
+. 从对话框中选择 ``java.awt.event.KeyListener`` 监听程序。单击 "OK"（确定）。
image::images/debug-select-listener.png[title="将组件添加到容器中的源代码行"]
此监听程序现在正在监听文本字段中的键盘事件。
-6. 在 Anagram Game 应用程序的文本字段中，键入一些字符。
+
+[start=6]
+. 在 Anagram Game 应用程序的文本字段中，键入一些字符。
在文本字段中键入字符时，将在事件日志中记录事件。如果展开 "Event Log"（事件日志）节点，您可以看到现在记录了每个击键。每次在 Anagram Game 应用程序文本字段中键入时，都会显示新事件。如果展开单个事件，例如 ``keyPressed`` ，日志中会显示该事件的属性。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
index 4df1ec9..119d0c3 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform.asciidoc
@@ -59,7 +59,7 @@ image::images/search-small.png[role="left", link="images/search.png"]
Every inspection is provided with a description available either in the Description field or in the *Manage Inspection dialog* box.
-==== To run an inspection and apply an existing Inspection:
+=== To run an inspection and apply an existing Inspection:
. In the *Projects* window, select the `InspectTransform.java` file.
. Choose *Refactor > Inspect and Transform* from the IDE's menu.
@@ -216,9 +216,13 @@ Your custom inspection is done and ready to be applied.
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
+
-4. Click *Inspect*.
+
+[start=4]
+. Click *Inspect*.
The suggested refactoring changes display in the preview panel.
-5. Click *Do Refactoring* to apply the changes if required.
+
+[start=5]
+. Click *Do Refactoring* to apply the changes if required.
== Summary
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ja.asciidoc
index 8bfefd4..7447e25 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ja.asciidoc
@@ -34,7 +34,7 @@ NetBeans IDE Javaエディタは、選択された範囲のファイルに対し
このチュートリアルでは、リファクタリングを含む検査や事前定義された一連の検査を使用してコードのレビューを実行したり、構成を管理したり、カスタム検査を作成したりする方法について学習します。
-=== 内容
+== 内容
image::images/netbeans-stamp.png[title="このページの内容は、NetBeans IDE 8.0に適用されます"]
@@ -103,7 +103,9 @@ image::images/search-small.png[role="left", link="images/search.png"]
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=7]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
<<top,先頭>>
@@ -154,7 +156,9 @@ image::images/jdk7-conf-small.png[role="left", link="images/jdk7-conf.png"]
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=5]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
=== JDK 8に移行
@@ -185,7 +189,9 @@ image::images/jdk8-conf-small.png[role="left", link="images/jdk8-conf.png"]
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. 「OK」をクリックして編集を保存します。
+
+[start=5]
+. 「OK」をクリックして編集を保存します。
*デフォルトの「 ``インポートの編成`` 」構成を実行して適用するには:*
@@ -200,7 +206,9 @@ image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=5]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
<<top,先頭>>
@@ -223,23 +231,33 @@ image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
image::images/custom-hint-small.png[role="left", link="images/custom-hint.png"]
--
-4. (オプション)「 ``検査`` 」を右クリックしてポップアップ・メニューから「名前変更」を選択し、カスタム検査に必要な名前(たとえば、 ``MyCustomInspection`` )を指定して、[Enter]を押します。
-5. 「スクリプトの編集」をクリックします。「スクリプト」テキスト領域が表示されます。
+
+[start=4]
+. (オプション)「 ``検査`` 」を右クリックしてポップアップ・メニューから「名前変更」を選択し、カスタム検査に必要な名前(たとえば、 ``MyCustomInspection`` )を指定して、[Enter]を押します。
+
+[start=5]
+. 「スクリプトの編集」をクリックします。「スクリプト」テキスト領域が表示されます。
[.feature]
--
image::images/script-small.png[role="left", link="images/script.png"]
--
-6. 「スクリプト」テキスト領域に検査の説明とコードを入力するか、または「エディタで開く」をクリックし、 ``MyCustomInspection.hint`` ファイルで同じ内容を指定します。
+
+[start=6]
+. 「スクリプト」テキスト領域に検査の説明とコードを入力するか、または「エディタで開く」をクリックし、 ``MyCustomInspection.hint`` ファイルで同じ内容を指定します。
[.feature]
--
image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
--
-7. 「スクリプト」テキスト領域の下にある「保存」をクリックするか、またはエディタで[Ctrl]-[S]を押して編集を保存します。
-8. 「OK」をクリックして「検査の管理」ダイアログ・ボックスを閉じるか、またはエディタで ``MyCustomInspection.hint`` ファイルを閉じます。
+
+[start=7]
+. 「スクリプト」テキスト領域の下にある「保存」をクリックするか、またはエディタで[Ctrl]-[S]を押して編集を保存します。
+
+[start=8]
+. 「OK」をクリックして「検査の管理」ダイアログ・ボックスを閉じるか、またはエディタで ``MyCustomInspection.hint`` ファイルを閉じます。
カスタム検査が完成し、適用する準備ができました。
*作成したカスタム検査を実行するには:*
@@ -253,9 +271,13 @@ image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
-4. 「検査」をクリックします。
+
+[start=4]
+. 「検査」をクリックします。
提案されたリファクタリングの変更がプレビュー・パネルに表示されます。
-5. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=5]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
<<top,先頭>>
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_pt_BR.asciidoc
index 8e8416f..92db8a4 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_pt_BR.asciidoc
@@ -92,7 +92,9 @@ As alterações de refatoração sugeridas são exibidas no painel de visualiza
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
+
+[start=7]
+. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
<<top,início>>
@@ -143,7 +145,9 @@ As alterações que convertem o código para a sintaxe do JDK 7 são exibidas no
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
+
+[start=5]
+. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
=== Migrar para JDK 8
@@ -174,7 +178,9 @@ A configuração ``Organizar Importações`` permite inspecionar a forma como
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. Clique em OK para salvar suas edições.
+
+[start=5]
+. Clique em OK para salvar suas edições.
*Para executar e aplicar a configuração default ``Organizar Importações`` :*
@@ -189,7 +195,9 @@ O painel de visualização exibe uma ocorrência proposta para a seção Importa
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
+
+[start=5]
+. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
<<top,início>>
@@ -212,23 +220,33 @@ Um nó ``Personalizar > Inspeção`` é criado na lista Inspeções.
image::images/custom-hint-small.png[role="left", link="images/custom-hint.png"]
--
-4. (Opcional) Clique com o botão direito do mouse em ``Inspecionar`` , escolha Renomear no menu pop-up, especifique o nome necessário para sua inspeção personalizada (por exemplo, ``MyCustomInspection`` ) e pressione Enter.
-5. Clique em Editar Script. A área de texto Script é exibida.
+
+[start=4]
+. (Opcional) Clique com o botão direito do mouse em ``Inspecionar`` , escolha Renomear no menu pop-up, especifique o nome necessário para sua inspeção personalizada (por exemplo, ``MyCustomInspection`` ) e pressione Enter.
+
+[start=5]
+. Clique em Editar Script. A área de texto Script é exibida.
[.feature]
--
image::images/script-small.png[role="left", link="images/script.png"]
--
-6. Digite a descrição e o código da inspeção na área de texto Script ou clique em Abrir no Editor e especifique o mesmo no arquivo ``MyCustomInspection.hint`` .
+
+[start=6]
+. Digite a descrição e o código da inspeção na área de texto Script ou clique em Abrir no Editor e especifique o mesmo no arquivo ``MyCustomInspection.hint`` .
[.feature]
--
image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
--
-7. Clique em Salvar abaixo da área de texto Script ou pressione Ctrl-S no Editor para salvar suas edições.
-8. Clique em OK para fechar a caixa de diálogo Gerenciar Inspeções ou feche o arquivo ``MyCustomInspection.hint`` no Editor.
+
+[start=7]
+. Clique em Salvar abaixo da área de texto Script ou pressione Ctrl-S no Editor para salvar suas edições.
+
+[start=8]
+. Clique em OK para fechar a caixa de diálogo Gerenciar Inspeções ou feche o arquivo ``MyCustomInspection.hint`` no Editor.
Sua inspeção personalizada está feita e pronta para ser aplicada.
*Para executar a inspeção personalizada que você criou:*
@@ -242,9 +260,13 @@ Sua inspeção personalizada está feita e pronta para ser aplicada.
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
-4. Clique em Inspecionar.
+
+[start=4]
+. Clique em Inspecionar.
As alterações de refatoração sugeridas são exibidas no painel de exibição.
-5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
+
+[start=5]
+. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.
<<top,início>>
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ru.asciidoc
index 85bff98..aab3677 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_ru.asciidoc
@@ -92,7 +92,9 @@ image::images/search-small.png[role="left", link="images/search.png"]
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=7]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
<<top,В начало>>
@@ -143,7 +145,9 @@ image::images/jdk7-conf-small.png[role="left", link="images/jdk7-conf.png"]
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=5]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
=== Перенос в JDK 8
@@ -174,7 +178,9 @@ image::images/jdk8-conf-small.png[role="left", link="images/jdk8-conf.png"]
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. Нажмите кнопку "ОК", чтобы сохранить изменения.
+
+[start=5]
+. Нажмите кнопку "ОК", чтобы сохранить изменения.
*Чтобы запустить и применить настройку по умолчанию ``Упорядочение операторов импорта`` , выполните следующие действия.*
@@ -189,7 +195,9 @@ image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=5]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
<<top,В начало>>
@@ -212,23 +220,33 @@ image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
image::images/custom-hint-small.png[role="left", link="images/custom-hint.png"]
--
-4. (Дополнительно) Правой кнопкой мыши щелкните ``Проверка`` , выберите "Переименовать" в раскрывающемся меню, укажите имя пользовательской проверки (например, ``MyCustomInspection`` ), затем нажмите ENTER.
-5. Нажмите кнопку "Правка сценария". Отобразится текстовое поле со сценарием.
+
+[start=4]
+. (Дополнительно) Правой кнопкой мыши щелкните ``Проверка`` , выберите "Переименовать" в раскрывающемся меню, укажите имя пользовательской проверки (например, ``MyCustomInspection`` ), затем нажмите ENTER.
+
+[start=5]
+. Нажмите кнопку "Правка сценария". Отобразится текстовое поле со сценарием.
[.feature]
--
image::images/script-small.png[role="left", link="images/script.png"]
--
-6. Введите описание проверки и код в текстовую область сценария или нажмите кнопку "Открыть" в редакторе и укажите те же данные в файле ``MyCustomInspection.hint`` .
+
+[start=6]
+. Введите описание проверки и код в текстовую область сценария или нажмите кнопку "Открыть" в редакторе и укажите те же данные в файле ``MyCustomInspection.hint`` .
[.feature]
--
image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
--
-7. Чтобы сохранить изменения, нажмите кнопку "Сохранить" под текстовым полем со сценарием или нажмите сочетание клавиш CTRL+S в редакторе.
-8. Нажмите кнопку "ОК", чтобы закрыть диалоговое окно "Управление проверками" или закройте файл ``MyCustomInspection.hint`` в редакторе.
+
+[start=7]
+. Чтобы сохранить изменения, нажмите кнопку "Сохранить" под текстовым полем со сценарием или нажмите сочетание клавиш CTRL+S в редакторе.
+
+[start=8]
+. Нажмите кнопку "ОК", чтобы закрыть диалоговое окно "Управление проверками" или закройте файл ``MyCustomInspection.hint`` в редакторе.
Пользовательская проверка создана и может быть применена.
*Чтобы запустить созданную пользовательскую проверку, выполните следующие действия.*
@@ -242,9 +260,13 @@ image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
-4. Нажмите кнопку "Проверить".
+
+[start=4]
+. Нажмите кнопку "Проверить".
Предлагаемые изменения реорганизации отобразятся на панели предварительного просмотра.
-5. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=5]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
<<top,В начало>>
diff --git a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_zh_CN.asciidoc
index 84bea08..146c322 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/editor-inspect-transform_zh_CN.asciidoc
@@ -92,7 +92,9 @@ image::images/search-small.png[role="left", link="images/search.png"]
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
+
+[start=7]
+. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
<<top,返回页首>>
@@ -143,7 +145,9 @@ image::images/jdk7-conf-small.png[role="left", link="images/jdk7-conf.png"]
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
+
+[start=5]
+. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
=== 迁移至 JDK 8
@@ -174,7 +178,9 @@ image::images/jdk8-conf-small.png[role="left", link="images/jdk8-conf.png"]
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. 单击 "OK"（确定）保存所做的编辑。
+
+[start=5]
+. 单击 "OK"（确定）保存所做的编辑。
*运行并应用默认的 ``Organize Imports`` （组织导入）配置：*
@@ -189,7 +195,9 @@ image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
+
+[start=5]
+. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
<<top,返回页首>>
@@ -212,23 +220,33 @@ image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
image::images/custom-hint-small.png[role="left", link="images/custom-hint.png"]
--
-4. （可选）右键单击 ``Inspection`` （检查），从弹出式菜单中选择 "Rename"（重命名），指定定制检查所需的名称（例如 ``MyCustomInspection`` ），然后按 Enter 键。
-5. 单击 "Edit Script"（编缉脚本）。显示 "Script"（脚本）文本区域。
+
+[start=4]
+. （可选）右键单击 ``Inspection`` （检查），从弹出式菜单中选择 "Rename"（重命名），指定定制检查所需的名称（例如 ``MyCustomInspection`` ），然后按 Enter 键。
+
+[start=5]
+. 单击 "Edit Script"（编缉脚本）。显示 "Script"（脚本）文本区域。
[.feature]
--
image::images/script-small.png[role="left", link="images/script.png"]
--
-6. 在 "Script"（脚本）文本区域中键入检查描述和代码，或者在编辑器中单击 "Open"（打开），并在 ``MyCustomInspection.hint`` 文件中指定相同的内容。
+
+[start=6]
+. 在 "Script"（脚本）文本区域中键入检查描述和代码，或者在编辑器中单击 "Open"（打开），并在 ``MyCustomInspection.hint`` 文件中指定相同的内容。
[.feature]
--
image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
--
-7. 单击 "Script"（脚本）文本区域下方的 "Save"（保存），或在编辑器中按 Ctrl-S 组合键保存所做的编辑。
-8. 单击 "OK"（确定）以关闭 "Manage Inspections"（管理检查）对话框，或在编辑器中关闭 ``MyCustomInspection.hint`` 文件。
+
+[start=7]
+. 单击 "Script"（脚本）文本区域下方的 "Save"（保存），或在编辑器中按 Ctrl-S 组合键保存所做的编辑。
+
+[start=8]
+. 单击 "OK"（确定）以关闭 "Manage Inspections"（管理检查）对话框，或在编辑器中关闭 ``MyCustomInspection.hint`` 文件。
您的定制检查已完成并准备进行应用。
*运行已创建的定制检查：*
@@ -242,9 +260,13 @@ image::images/hint-file-small.png[role="left", link="images/hint-file.png"]
image::images/mycustomhint-small.png[role="left", link="images/mycustomhint.png"]
--
-4. 单击 "Inspect"（检查）。
+
+[start=4]
+. 单击 "Inspect"（检查）。
建议的重构更改显示在预览面板中。
-5. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
+
+[start=5]
+. 单击 "Do Refactoring"（执行重构）以应用所做的更改（如有必要）。
<<top,返回页首>>
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced.asciidoc
index 75adba4..16151cc 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced.asciidoc
@@ -63,7 +63,9 @@ Before starting to lay out the components with the help of the GridBag Customize
NOTE: The ``GridBagCustomizerAdvancedTutorial`` project uses the ``JUnit`` and ``JUnit 4`` class libraries, which are located in the Update Center. You need to click Resolve Problems in the Open project dialog box, then click Resolve in the Resolve Reference Problems dialog box and install the JUnit plugin following the instructions in the NetBeans IDE Installer. When the installation is completed, click Finish to close the NetBeans IDE Installer dialog box, then click Close to clo [...]
-3. Expand ``Source Packages > tutorial`` and double-click ``ContactsAdvancedInitial.java`` .
+
+[start=3]
+. Expand ``Source Packages > tutorial`` and double-click ``ContactsAdvancedInitial.java`` .
The sample form opens in the GUI Builder Design view.
[.feature]
@@ -126,8 +128,12 @@ image::images/addcomponent-small.png[role="left", link="images/addcomponent.png"
Highlighted ``JLabel1`` displays in the first cell.
-3. Right-click the second cell of the newly added row.
-4. From the context menu, choose ``Add Components > Swing Controls > Text Field`` .
+
+[start=3]
+. Right-click the second cell of the newly added row.
+
+[start=4]
+. From the context menu, choose ``Add Components > Swing Controls > Text Field`` .
Highlighted ``JTextField1`` displays in the second cell.
image::images/highlightedtextfield.png[]
@@ -180,9 +186,15 @@ image::images/textfieldsonecolumn.png[]
The GridBag Customizer can resize several components together thus making room for the second column of text fields.
-4. Click outside the form to deselect the resized text fields.
-5. Control-click to select all the ``Skype:`` and ``Home Phone:`` ``JLabel`` and ``JTextField`` components in the ``Phone`` section.
-6. Position the cursor over the selection and drag them to the right of the top two text fields.
+
+[start=4]
+. Click outside the form to deselect the resized text fields.
+
+[start=5]
+. Control-click to select all the ``Skype:`` and ``Home Phone:`` ``JLabel`` and ``JTextField`` components in the ``Phone`` section.
+
+[start=6]
+. Position the cursor over the selection and drag them to the right of the top two text fields.
image::images/movesecondcolumn.png[]
@@ -203,7 +215,9 @@ To fix spacing of the second column here, do as follows:
1. Control-click the ``Skype:`` and ``Home Phone:`` labels to select them in the Grid Area.
2. Click the browse button (image::images/browsebutton.png[]) to the right of the ``Insets`` text field.
The ``Insets`` dialog box displays.
-3. Enter ``5`` in the ``Left:`` text field, and click OK.
+
+[start=3]
+. Enter ``5`` in the ``Left:`` text field, and click OK.
=== Introducing Subcontainers
@@ -276,7 +290,9 @@ Complete the steps listed below to add a button to an existing subcontainer:
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. Right-click the second column header and choose ``Insert Column After`` from the context menu.
+
+[start=3]
+. Right-click the second column header and choose ``Insert Column After`` from the context menu.
An empty cell for the new button displays.
[.feature]
@@ -284,7 +300,9 @@ An empty cell for the new button displays.
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. Right-click inside the newly created cell and choose ``Add Component`` > ``Swing Controls`` > ``Button`` from the context menu.
+
+[start=4]
+. Right-click inside the newly created cell and choose ``Add Component`` > ``Swing Controls`` > ``Button`` from the context menu.
A new ``jButton1`` button is added.
[.feature]
@@ -292,9 +310,15 @@ A new ``jButton1`` button is added.
image::images/newbutton-small.png[role="left", link="images/newbutton.png"]
--
-5. Click the Baseline-Related Anchor button (image::images/baselineanchor.png[]) in the Property Customizer to align the new button with the two existing ones in the row.
-6. Click the browse button (image::images/browsebutton.png[]) to the right of the Insets text field. The Insets dialog box displays. Enter 5 in the Top: text field, and click OK.
-7. To check how the main container layout looks now, right-click the designed subcontainer and choose ``Design Parent Container`` from the context menu.
+
+[start=5]
+. Click the Baseline-Related Anchor button (image::images/baselineanchor.png[]) in the Property Customizer to align the new button with the two existing ones in the row.
+
+[start=6]
+. Click the browse button (image::images/browsebutton.png[]) to the right of the Insets text field. The Insets dialog box displays. Enter 5 in the Top: text field, and click OK.
+
+[start=7]
+. To check how the main container layout looks now, right-click the designed subcontainer and choose ``Design Parent Container`` from the context menu.
image::images/designparentcontainer.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ja.asciidoc
index 4fc2647..2b5aa17 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ja.asciidoc
@@ -72,7 +72,9 @@ GridBagカスタマイザを使用してコンポーネントのレイアウト
*注意:* ``GridBagCustomizerAdvancedTutorial`` プロジェクトでは、更新センターから入手できる ``JUnit`` と ``JUnit 4`` クラス・ライブラリを使用します。「プロジェクトを開く」ダイアログ・ボックスで「問題を解決」をクリックし、次に「参照の問題を解決」ダイアログ・ボックスで「解決」をクリックし、NetBeans IDEのインストーラの指示に従ってJUnitプラグインをインストールする必要がありますインストールが完了したら、「終了」をクリックして「NetBeans IDEのインストーラ」ダイアログ・ボックスを閉じ、「閉じる」をクリックして「参照の問題を解決」ダイアログ・ボックスを閉じます。
-3. ``「ソース・パッケージ」>「tutorial」`` を展開し、 ``ContactsAdvancedInitial.java`` をダブルクリックします。
+
+[start=3]
+. ``「ソース・パッケージ」>「tutorial」`` を展開し、 ``ContactsAdvancedInitial.java`` をダブルクリックします。
サンプル・フォームがGUIビルダーの「デザイン」ビューで開きます。
[.feature]
@@ -135,8 +137,12 @@ image::images/addcomponent-small.png[role="left", link="images/addcomponent.png"
強調表示された ``JLabel1`` が最初のセルに表示されます。
-3. 新しく追加された行の2つ目のセルを右クリックします。
-4. コンテキスト・メニューから ``「コンポーネントを追加」>「Swingコントロール」>「テキスト・フィールド」`` を選択します。
+
+[start=3]
+. 新しく追加された行の2つ目のセルを右クリックします。
+
+[start=4]
+. コンテキスト・メニューから ``「コンポーネントを追加」>「Swingコントロール」>「テキスト・フィールド」`` を選択します。
強調表示された ``JTextField1`` が2つ目のセルに表示されます。
image::images/highlightedtextfield.png[]
@@ -171,6 +177,7 @@ image::images/constraintsset.png[]
``JTextField1`` コンポーネントのテキストを除去するには、次の手順を行います:
+[start=1]
1. 「デザイン」ビューで、 ``JTextField1`` コンポーネントを選択し、[F2]を押します(または、コンテキスト・メニューから「テキストを編集」を選択します)。
2. 選択されているテキストを削除し、[Enter]を押します。
@@ -189,9 +196,15 @@ image::images/textfieldsonecolumn.png[]
GridBagカスタマイザは複数のコンポーネントのサイズをまとめて変更でき、それによって、テキスト・フィールドの2番目の列の領域が確保されます。
-4. フォームの外側をクリックして、サイズが変更されたテキスト・フィールドの選択を解除します。
-5. 「 ``Phone`` 」セクション内の「 ``Skype:`` 」と「 ``Home Phone:`` 」の ``JLabel`` と ``JTextField`` コンポーネントを[Ctrl]を押しながらクリックしてすべて選択します。
-6. 選択範囲の上にカーソルを置き、上の2つのテキスト・フィールドの右にドラッグします。
+
+[start=4]
+. フォームの外側をクリックして、サイズが変更されたテキスト・フィールドの選択を解除します。
+
+[start=5]
+. 「 ``Phone`` 」セクション内の「 ``Skype:`` 」と「 ``Home Phone:`` 」の ``JLabel`` と ``JTextField`` コンポーネントを[Ctrl]を押しながらクリックしてすべて選択します。
+
+[start=6]
+. 選択範囲の上にカーソルを置き、上の2つのテキスト・フィールドの右にドラッグします。
image::images/movesecondcolumn.png[]
@@ -212,7 +225,9 @@ image::images/textfieldsmoved.png[]
1. グリッド領域で、[Ctrl]を押しながら「 ``Skype:`` 」と「 ``Home Phone:`` 」のラベルをクリックして選択します。
2. 「 ``インセット`` 」テキスト・フィールドの右にある「参照」ボタン(image::images/browsebutton.png[])をクリックします。
「 ``インセット`` 」ダイアログ・ボックスが表示されます。
-3. 「 ``左:`` 」テキスト・フィールドに「 ``5`` 」と入力し、「OK」をクリックします。
+
+[start=3]
+. 「 ``左:`` 」テキスト・フィールドに「 ``5`` 」と入力し、「OK」をクリックします。
=== サブコンテナの導入
@@ -285,7 +300,9 @@ image::images/subcontainerresized.png[]
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. 2番目の列ヘッダーを右クリックし、コンテキスト・メニューから「 ``列を後ろに挿入`` 」を選択します。
+
+[start=3]
+. 2番目の列ヘッダーを右クリックし、コンテキスト・メニューから「 ``列を後ろに挿入`` 」を選択します。
新しいボタンのための空のセルが表示されます。
[.feature]
@@ -293,7 +310,9 @@ image::images/designsubcontainer-small.png[role="left", link="images/designsubco
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. 新しく作成されたセルの内部を右クリックし、コンテキスト・メニューから「 ``コンポーネントを追加`` 」>「 ``Swingコントロール`` 」>「 ``ボタン`` 」を選択します。
+
+[start=4]
+. 新しく作成されたセルの内部を右クリックし、コンテキスト・メニューから「 ``コンポーネントを追加`` 」>「 ``Swingコントロール`` 」>「 ``ボタン`` 」を選択します。
新しい「 ``jButton1`` 」ボタンが追加されます。
[.feature]
@@ -301,9 +320,15 @@ image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
image::images/newbutton-small.png[role="left", link="images/newbutton.png"]
--
-5. プロパティ・カスタマイザで「ベースライン関連のアンカー」ボタン(image::images/baselineanchor.png[])をクリックし、新しいボタンをこの行にある2つの既存のボタンにそろえます。
-6. 「インセット」テキスト・フィールドの右にある「参照」ボタン(image::images/browsebutton.png[])をクリックします。「インセット」ダイアログ・ボックスが表示されます。「上:」テキスト・フィールドに「5」と入力し、「OK」をクリックします。
-7. メイン・コンテナの現在のレイアウトの外観を確認するには、デザインされたサブコンテナを右クリックし、コンテキスト・メニューから「 ``親コンテナをデザイン`` 」を選択します。
+
+[start=5]
+. プロパティ・カスタマイザで「ベースライン関連のアンカー」ボタン(image::images/baselineanchor.png[])をクリックし、新しいボタンをこの行にある2つの既存のボタンにそろえます。
+
+[start=6]
+. 「インセット」テキスト・フィールドの右にある「参照」ボタン(image::images/browsebutton.png[])をクリックします。「インセット」ダイアログ・ボックスが表示されます。「上:」テキスト・フィールドに「5」と入力し、「OK」をクリックします。
+
+[start=7]
+. メイン・コンテナの現在のレイアウトの外観を確認するには、デザインされたサブコンテナを右クリックし、コンテキスト・メニューから「 ``親コンテナをデザイン`` 」を選択します。
image::images/designparentcontainer.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_pt_BR.asciidoc
index 88006ad..7cfd561 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_pt_BR.asciidoc
@@ -72,7 +72,9 @@ Antes de começar a efetuar o layout dos componentes com a ajuda do GridBag Cust
*Observação:* o projeto ``GridBagCustomizerAdvancedTutorial`` usa as bibliotecas de classe ``Junit`` e ``JUnit 4`` , que estão localizadas na Central de Atualização. Você precisa clicar em Resolver Problemas na caixa de diálogo Abrir projeto, em seguida, clique em Resolver na caixa de diálogo Resolver Problemas de referência e instale o plug-in JUnit seguindo as instruções no Instalador NetBeans IDE. Quando a instalação for concluída, clique em Finalizar para fechar a caixa de diálo [...]
-3. Expanda ``Pacotes de Código-fonte > tutorial`` e clique duas vezes em ``ContactsAdvancedInitial.java`` .
+
+[start=3]
+. Expanda ``Pacotes de Código-fonte > tutorial`` e clique duas vezes em ``ContactsAdvancedInitial.java`` .
O form de exemplo é aberto na view Design do GUI Builder.
[.feature]
@@ -135,8 +137,12 @@ image::images/addcomponent-small.png[role="left", link="images/addcomponent.png"
O ``JLabel1`` realçado é exibido na primeira célula.
-3. Clique com o botão direito do mouse na segunda célula da linha recém-adicionada.
-4. No menu de contexto, escolha ``Adicionar Componentes > Controle do Swing >Campo de Texto`` .
+
+[start=3]
+. Clique com o botão direito do mouse na segunda célula da linha recém-adicionada.
+
+[start=4]
+. No menu de contexto, escolha ``Adicionar Componentes > Controle do Swing >Campo de Texto`` .
O ``JTextField1`` realçado é exibido na segunda célula.
image::images/highlightedtextfield.png[]
@@ -189,9 +195,15 @@ image::images/textfieldsonecolumn.png[]
O GridBag Customizer pode redimensionar diversos componentes juntos, portanto, criando espaço para a segunda coluna de campos de texto.
-4. Clique fora do form para cancelar a seleção dos campos de texto redimensionados.
-5. Pressione Ctrl e clique para selecionar todos os ``Skype:`` e ``Telefone Residencial:`` dos componentes ``JLabel`` e ``JTextField`` na seção ``Telefone`` .
-6. Posicione o cursor sobre a seleção e arraste-o para a direita dos dois campos superiores de texto.
+
+[start=4]
+. Clique fora do form para cancelar a seleção dos campos de texto redimensionados.
+
+[start=5]
+. Pressione Ctrl e clique para selecionar todos os ``Skype:`` e ``Telefone Residencial:`` dos componentes ``JLabel`` e ``JTextField`` na seção ``Telefone`` .
+
+[start=6]
+. Posicione o cursor sobre a seleção e arraste-o para a direita dos dois campos superiores de texto.
image::images/movesecondcolumn.png[]
@@ -212,7 +224,9 @@ Para corrigir o espaço da segunda coluna aqui, faça como segue:
1. Pressione Ctrl+Clique nos labels ``Skype:`` e ``Telefone Residencial:`` para selecioná-los na Área da grade.
2. Clique no botão Procurar (image::images/browsebutton.png[]) à direita do campo de texto ``Insets`` .
A caixa de diálogo ``Insets`` é exibida.
-3. Insira ``5`` no campo de texto ``Esquerda:`` e clique em OK.
+
+[start=3]
+. Insira ``5`` no campo de texto ``Esquerda:`` e clique em OK.
=== Introduzindo Subcontêineres
@@ -286,7 +300,9 @@ Conclua as etapas abaixo listadas para adicionar um botão em um subcontêiner e
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. Clique com o botão direito do mouse no cabeçalho da segunda coluna e escolha ``Inserir Coluna Após`` a partir do menu de contexto.
+
+[start=3]
+. Clique com o botão direito do mouse no cabeçalho da segunda coluna e escolha ``Inserir Coluna Após`` a partir do menu de contexto.
Uma célula vazia para o novo botão é exibida.
[.feature]
@@ -294,7 +310,9 @@ Uma célula vazia para o novo botão é exibida.
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. Clique com o botão direito do mouse na célula recém-criada e escolha ``Adicionar Componente`` > ``Controles do Swing`` > ``Botão`` a partir do menu de contexto.
+
+[start=4]
+. Clique com o botão direito do mouse na célula recém-criada e escolha ``Adicionar Componente`` > ``Controles do Swing`` > ``Botão`` a partir do menu de contexto.
Um novo botão ``jButton1`` é adicionado.
[.feature]
@@ -302,9 +320,15 @@ Um novo botão ``jButton1`` é adicionado.
image::images/newbutton-small.png[role="left", link="images/newbutton.png"]
--
-5. Clique no botão de Âncora Relacionado à Linha de Base (image::images/baselineanchor.png[]) no Personalizador de Propriedades para alinhar o botão Novo com os dois existentes na linha.
-6. Clique no botão Procurar (image::images/browsebutton.png[]) à direita do campo de texto Insets. A caixa de diálogo Insets é exibida. Insira 5 no campo de texto Superior: e clique em OK.
-7. Para verificar a aparência do contêiner principal, clique com o botão direito do mouse no subcontêiner desenhado e escolha ``Criar Contêiner Pai`` no menu de contexto.
+
+[start=5]
+. Clique no botão de Âncora Relacionado à Linha de Base (image::images/baselineanchor.png[]) no Personalizador de Propriedades para alinhar o botão Novo com os dois existentes na linha.
+
+[start=6]
+. Clique no botão Procurar (image::images/browsebutton.png[]) à direita do campo de texto Insets. A caixa de diálogo Insets é exibida. Insira 5 no campo de texto Superior: e clique em OK.
+
+[start=7]
+. Para verificar a aparência do contêiner principal, clique com o botão direito do mouse no subcontêiner desenhado e escolha ``Criar Contêiner Pai`` no menu de contexto.
image::images/designparentcontainer.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ru.asciidoc
index 82d91dc..9c1a9c2 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_ru.asciidoc
@@ -72,7 +72,9 @@ image::images/netbeans-stamp-80-74.png[title="Содержимое этой ст
*Примечание.* В проекте ``GridBagCustomizerAdvancedTutorial`` используются библиотеки классов ``JUnit`` и ``JUnit 4`` , которые можно найти в центре обновлений. Необходимо щелкнуть 'Решить проблемы' в диалоговом окне 'Открыть проект', затем щелкните 'Решить' в диалоговом окне 'решить проблемы ссылок' и установить подключаемый модуль в соответствии с инструкциями в установщике IDE NetBeans. После завершения установки нажмите 'Готово', чтобы закрыть диалоговое окно установщика IDE Net [...]
-3. Разверните ``Пакеты исходного кода`` > учебное руководство и дважды щелкните ``ContactsAdvancedInitial.java`` .
+
+[start=3]
+. Разверните ``Пакеты исходного кода`` > учебное руководство и дважды щелкните ``ContactsAdvancedInitial.java`` .
В конструкторе графического интерфейса откроется образец формы в режиме конструктора.
[.feature]
@@ -135,8 +137,12 @@ image::images/addcomponent-small.png[role="left", link="images/addcomponent.png"
Выделенное ``JLabel1`` отображается в первой ячейке.
-3. Щелкните правой кнопкой мыши первую ячейку добавленной строки.
-4. В контекстном меню выберите ``Add Components ("Добавление компонентов") > Swing Controls ("Элементы управления Swing") > Text Field ("Текстовое поле")`` .
+
+[start=3]
+. Щелкните правой кнопкой мыши первую ячейку добавленной строки.
+
+[start=4]
+. В контекстном меню выберите ``Add Components ("Добавление компонентов") > Swing Controls ("Элементы управления Swing") > Text Field ("Текстовое поле")`` .
Выделенное поле ``JTextField1`` отображается во второй ячейке.
image::images/highlightedtextfield.png[]
@@ -189,9 +195,15 @@ image::images/textfieldsonecolumn.png[]
Настройщик GridBag может изменить размер нескольких компонентов одновременно, тем самым давая место для второго столбца текстовых полей.
-4. Щелкните вне формы, чтобы отменить выбор текстовых полей, размер которых был изменен.
-5. Удерживая клавишу CTRL, щелкните компоненты ``Skype:`` , ``Home Phone:`` , ``JLabel`` и ``JTextField`` в разделе ``Phone`` , чтобы выбрать их.
-6. Наведите курсор на выбранные компоненты и перетащите их направо от двух верхних текстовых полей.
+
+[start=4]
+. Щелкните вне формы, чтобы отменить выбор текстовых полей, размер которых был изменен.
+
+[start=5]
+. Удерживая клавишу CTRL, щелкните компоненты ``Skype:`` , ``Home Phone:`` , ``JLabel`` и ``JTextField`` в разделе ``Phone`` , чтобы выбрать их.
+
+[start=6]
+. Наведите курсор на выбранные компоненты и перетащите их направо от двух верхних текстовых полей.
image::images/movesecondcolumn.png[]
@@ -212,7 +224,9 @@ image::images/textfieldsmoved.png[]
1. Удерживая клавишу CTRL, щелкните метки ``Skype:`` и ``Home Phone:`` , чтобы выбрать их в области сетки.
2. Нажмите кнопку обзора (image::images/browsebutton.png[]) справа от текстового поля ``Вставки`` .
Отобразится диалоговое окно ``Insets`` ("Вставки").
-3. Введите ``5`` в текстовое поле ``Left:`` ("Лево:") и нажмите кнопку "OК".
+
+[start=3]
+. Введите ``5`` в текстовое поле ``Left:`` ("Лево:") и нажмите кнопку "OК".
=== Введение подконтейнеров
@@ -285,7 +299,9 @@ image::images/subcontainerresized.png[]
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. Щелкните правой кнопкой мыши второй заголовок столбца и выберите ``Insert Column After`` ("Вставить столбец после") из контекстного меню.
+
+[start=3]
+. Щелкните правой кнопкой мыши второй заголовок столбца и выберите ``Insert Column After`` ("Вставить столбец после") из контекстного меню.
Отобразится пустая ячейка для новой кнопки.
[.feature]
@@ -293,7 +309,9 @@ image::images/designsubcontainer-small.png[role="left", link="images/designsubco
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. Щелкните созданную ячейку правой кнопкой мыши и выберите ``Add Component`` ("Добавить компонент") > ``Swing Controls`` ("Элементы управления Swing") > ``Button`` ("Кнопка") из контекстного меню.
+
+[start=4]
+. Щелкните созданную ячейку правой кнопкой мыши и выберите ``Add Component`` ("Добавить компонент") > ``Swing Controls`` ("Элементы управления Swing") > ``Button`` ("Кнопка") из контекстного меню.
Будет добавлена новая кнопка ``jButton1`` .
[.feature]
@@ -301,9 +319,15 @@ image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
image::images/newbutton-small.png[role="left", link="images/newbutton.png"]
--
-5. Нажмите кнопку привязки, связанной с базовой линией, (image::images/baselineanchor.png[]) в 'Средстве настройки свойств' для выравнивания новой кнопки с двумя существующими в строке.
-6. Нажмите кнопку обзора (image::images/browsebutton.png[]) справа от текстового поля 'Вставки'. Отобразится диалоговое окно "Вставки". Введите 5 в текстовое поле 'Вверх' и нажмите OK.
-7. Чтобы проверить, как основной макет контейнера выглядит сейчас, щелкните правой кнопкой мыши разработанный вложенный контейнер и выберите в контекстном меню ``Конструировать родительский контейнер`` .
+
+[start=5]
+. Нажмите кнопку привязки, связанной с базовой линией, (image::images/baselineanchor.png[]) в 'Средстве настройки свойств' для выравнивания новой кнопки с двумя существующими в строке.
+
+[start=6]
+. Нажмите кнопку обзора (image::images/browsebutton.png[]) справа от текстового поля 'Вставки'. Отобразится диалоговое окно "Вставки". Введите 5 в текстовое поле 'Вверх' и нажмите OK.
+
+[start=7]
+. Чтобы проверить, как основной макет контейнера выглядит сейчас, щелкните правой кнопкой мыши разработанный вложенный контейнер и выберите в контекстном меню ``Конструировать родительский контейнер`` .
image::images/designparentcontainer.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_zh_CN.asciidoc
index dc6f34d..8131095 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-advanced_zh_CN.asciidoc
@@ -72,7 +72,9 @@ image::images/netbeans-stamp-80-74.png[title="此页上的内容适用于 NetBea
*注：* ``GridBagCustomizerAdvancedTutorial`` 项目使用 ``JUnit`` 和 ``JUnit 4`` 类库，这些库位于更新中心内。需要在 "Open project"（打开项目）对话框中单击 "Resolve Problems"（解决问题），然后在 "Resolve Reference Problems"（解决引用问题）对话框中单击 "Resolve"（解决），并按照 NetBeans IDE 安装程序中的说明安装 JUnit 插件。安装完成后，单击 "Finish"（完成）以关闭 "NetBeans IDE Installer"（NetBeans IDE 安装程序）对话框，然后单击 "Close"（关闭）以关闭 "Resolve Reference Problems"（解决引用问题）对话框。
-3. 展开 ``源包 > tutorial`` ，然后双击 ``ContactsAdvancedInitial.java`` 。
+
+[start=3]
+. 展开 ``源包 > tutorial`` ，然后双击 ``ContactsAdvancedInitial.java`` 。
此时将在 GUI 构建器的 "Design"（设计）视图中打开样例窗体。
[.feature]
@@ -135,8 +137,12 @@ image::images/addcomponent-small.png[role="left", link="images/addcomponent.png"
此时将在第一个单元格中突出显示 ``JLabel1`` 。
-3. 右键单击新添加的行的第二个单元格。
-4. 从上下文菜单中，选择 ``"Add Components"（添加组件）> "Swing Controls"（Swing 控件）> "Text Field"（文本字段）`` 。
+
+[start=3]
+. 右键单击新添加的行的第二个单元格。
+
+[start=4]
+. 从上下文菜单中，选择 ``"Add Components"（添加组件）> "Swing Controls"（Swing 控件）> "Text Field"（文本字段）`` 。
此时将在第二个单元格中突出显示 ``JTextField1`` 。
image::images/highlightedtextfield.png[]
@@ -189,9 +195,15 @@ image::images/textfieldsonecolumn.png[]
GridBag 定制器可以同时调整几个组件的大小，从而为文本字段的第二列腾出空间。
-4. 在窗体外部单击以取消选择调整了大小的文本字段。
-5. 按住 Ctrl 键单击以选择 ``Phone`` 部分的所有 ``Skype:`` 、 ``Home Phone:`` ``JLabel`` 和 ``JTextField`` 组件。
-6. 将光标放在所选组件上，然后将其拖至上面两个文本字段的右侧。
+
+[start=4]
+. 在窗体外部单击以取消选择调整了大小的文本字段。
+
+[start=5]
+. 按住 Ctrl 键单击以选择 ``Phone`` 部分的所有 ``Skype:`` 、 ``Home Phone:`` ``JLabel`` 和 ``JTextField`` 组件。
+
+[start=6]
+. 将光标放在所选组件上，然后将其拖至上面两个文本字段的右侧。
image::images/movesecondcolumn.png[]
@@ -212,7 +224,9 @@ image::images/textfieldsmoved.png[]
1. 在网格区域中，按住 Ctrl 键单击 ``Skype:`` 和 ``Home Phone:`` 标签将其选中。
2. 单击 ``Insets`` （插入量）文本字段右侧的浏览按钮 (image::images/browsebutton.png[])。
此时将显示 ``Insets`` （插入量）对话框。
-3. 在 ``Left:`` （左侧：）文本字段中输入 ``5`` ，然后单击 "OK"（确定）。
+
+[start=3]
+. 在 ``Left:`` （左侧：）文本字段中输入 ``5`` ，然后单击 "OK"（确定）。
=== 引入子容器
@@ -285,7 +299,9 @@ image::images/subcontainerresized.png[]
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. 右键单击第二列的标题，然后从上下文菜单中选择 ``Insert Column After`` （在后面插入列）。
+
+[start=3]
+. 右键单击第二列的标题，然后从上下文菜单中选择 ``Insert Column After`` （在后面插入列）。
此时将显示新按钮的空单元格。
[.feature]
@@ -293,7 +309,9 @@ image::images/designsubcontainer-small.png[role="left", link="images/designsubco
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. 在新创建的单元格内右键单击，然后从上下文菜单中选择 ``Add Component`` （添加组件）> ``Swing Controls`` （Swing 控件）> ``Button`` （按钮）。
+
+[start=4]
+. 在新创建的单元格内右键单击，然后从上下文菜单中选择 ``Add Component`` （添加组件）> ``Swing Controls`` （Swing 控件）> ``Button`` （按钮）。
此时将添加一个新的 ``jButton1`` 按钮。
[.feature]
@@ -301,9 +319,15 @@ image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
image::images/newbutton-small.png[role="left", link="images/newbutton.png"]
--
-5. 单击属性定制器中的 "Baseline-Related Anchor"（与基线相关的锚点）按钮 (image::images/baselineanchor.png[])，将新按钮与行中的两个现有按钮对齐。
-6. 单击 "Insets"（插入量）文本字段右侧的浏览按钮 (image::images/browsebutton.png[])。此时将显示 "Insets"（插入量）对话框。在 "Top:"（上：）文本字段中输入 5，然后单击 "OK"（确定）。
-7. 要立即查看主容器布局的外观，请右键单击设计的子容器，然后从上下文菜单中选择 ``Design Parent Container`` （设计父容器）。
+
+[start=5]
+. 单击属性定制器中的 "Baseline-Related Anchor"（与基线相关的锚点）按钮 (image::images/baselineanchor.png[])，将新按钮与行中的两个现有按钮对齐。
+
+[start=6]
+. 单击 "Insets"（插入量）文本字段右侧的浏览按钮 (image::images/browsebutton.png[])。此时将显示 "Insets"（插入量）对话框。在 "Top:"（上：）文本字段中输入 5，然后单击 "OK"（确定）。
+
+[start=7]
+. 要立即查看主容器布局的外观，请右键单击设计的子容器，然后从上下文菜单中选择 ``Design Parent Container`` （设计父容器）。
image::images/designparentcontainer.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic.asciidoc
index c81e705..15f7f01 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic.asciidoc
@@ -228,7 +228,9 @@ NOTE: You can select multiple components by pressing the left mouse button on th
image::images/multiselect.png[]
-2. Change the ``Anchor`` layout constraint of the labels to ``Line Start`` .
+
+[start=2]
+. Change the ``Anchor`` layout constraint of the labels to ``Line Start`` .
The labels are anchored to the left.
image::images/linestartanchor.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ja.asciidoc
index f95e413..fa86f5b3 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ja.asciidoc
@@ -238,7 +238,9 @@ image::images/comboanchored-small.png[role="left", link="images/comboanchored.pn
image::images/multiselect.png[]
-2. これらのラベルの「 ``アンカー`` 」レイアウト制約を「 ``行の始め`` 」に変更します。
+
+[start=2]
+. これらのラベルの「 ``アンカー`` 」レイアウト制約を「 ``行の始め`` 」に変更します。
これらのラベルが左側に固定されました。
image::images/linestartanchor.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_pt_BR.asciidoc
index 924df73..20e85e1 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_pt_BR.asciidoc
@@ -238,7 +238,9 @@ Para fazer com os labels se alinhem na esquerda ao invés de no centro, como est
image::images/multiselect.png[]
-2. Altere a restrição do layout ``Âncora`` dos labels para ``Início da Linha`` .
+
+[start=2]
+. Altere a restrição do layout ``Âncora`` dos labels para ``Início da Linha`` .
Os labels são ancorados na esquerda.
image::images/linestartanchor.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ru.asciidoc
index 22f2a3b..d914e85 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_ru.asciidoc
@@ -238,7 +238,9 @@ image::images/comboanchored-small.png[role="left", link="images/comboanchored.pn
image::images/multiselect.png[]
-2. Измените ограничение компоновки ``Anchor`` ("Привязка") меток на ``Line Start`` ("Начало строки").
+
+[start=2]
+. Измените ограничение компоновки ``Anchor`` ("Привязка") меток на ``Line Start`` ("Начало строки").
Метки выровняются по левой стороне.
image::images/linestartanchor.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_zh_CN.asciidoc
index a2f4ade..a3d643d 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gbcustomizer-basic_zh_CN.asciidoc
@@ -238,7 +238,9 @@ image::images/comboanchored-small.png[role="left", link="images/comboanchored.pn
image::images/multiselect.png[]
-2. 将标签的 ``锚点`` 布局约束更改为 ``行首`` 。
+
+[start=2]
+. 将标签的 ``锚点`` 布局约束更改为 ``行首`` 。
标签将锚定到左侧。
image::images/linestartanchor.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart.asciidoc
index 3c39ef7..efccab2 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart.asciidoc
@@ -52,23 +52,35 @@ In this section you will create a JFrame and a Groovy class.
image::images/groovy-newjframe.png[]
+
+
[start=3]
-3. Type *DisplayJFrame* as the Class Name.
-4. Type *org.demo* as the Package. Click Finish.
+. Type *DisplayJFrame* as the Class Name.
+
+[start=4]
+. Type *org.demo* as the Package. Click Finish.
image::images/groovy-newjframe2.png[]
When you click Finish the IDE creates the JFrame form and opens the file in the editor.
+
+
[start=5]
-5. Right-click the project node in the Projects window and choose New > Other to open the New File dialog box.
-6. Select Groovy Class in the Groovy category. Click Next.
+. Right-click the project node in the Projects window and choose New > Other to open the New File dialog box.
+
+[start=6]
+. Select Groovy Class in the Groovy category. Click Next.
image::images/groovy-newgroovyclass.png[]
+
+
[start=7]
-7. Type *GreetingProvider* as the Class Name.
-8. Select the ``org.demo`` package from the Package dropdown list. Click Finish.
+. Type *GreetingProvider* as the Class Name.
+
+[start=8]
+. Select the ``org.demo`` package from the Package dropdown list. Click Finish.
When you click Finish the IDE creates the Groovy file and opens the file in the editor.
@@ -90,14 +102,20 @@ class GreetingProvider {
}
----
+
+
[start=3]
-3. Open ``DisplayJFrame.java`` in the editor (if not already open) and click the Design tab.
-4. Open the Palette (Window > Palette from the main menu) and drag and drop a Text Field element ( ``jTextField`` ) from the Palette and into the JFrame.
+. Open ``DisplayJFrame.java`` in the editor (if not already open) and click the Design tab.
+
+[start=4]
+. Open the Palette (Window > Palette from the main menu) and drag and drop a Text Field element ( ``jTextField`` ) from the Palette and into the JFrame.
image::images/groovy-jtextfield.png[]
+
+
[start=5]
-5. Click the Source tab in the editor and add the following code at the top of the class body to instantiate the Groovy class and in the constructor to call the ``getGreeting()`` method in the Groovy class.
+. Click the Source tab in the editor and add the following code at the top of the class body to instantiate the Groovy class and in the constructor to call the ``getGreeting()`` method in the Groovy class.
[source,java]
----
@@ -119,8 +137,10 @@ image::images/groovy-codecompletion.png[]
WARNING: JIRA link:https://issues.apache.org/jira/browse/NETBEANS-1996[] has to be solved for the Java editor to recognize the Groovy reference and for code completion shown above to work. Despite that, and even though the Java editor shows the Groovy reference with a red underline, you can still follow the step below and successfully run the application.
+
+
[start=6]
-6. Right-click the project node in the Projects window and choose Run.
+. Right-click the project node in the Projects window and choose Run.
When you choose Run, the IDE compiles and launches the application.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ja.asciidoc
index 07f798d..7984dd4 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ja.asciidoc
@@ -58,10 +58,16 @@ IDEのJavaバージョンをインストールする際、Groovyのサポート
または、「検索」フィールドに`groovy`と入力して、プラグインのリストをフィルタできます。
-4. 「GroovyおよびGrails」プラグインのチェックボックスをオンにして、「アクティブ化」をクリックします。
+
+[start=4]
+. 「GroovyおよびGrails」プラグインのチェックボックスをオンにして、「アクティブ化」をクリックします。
image::images/groovy-plugin.png[title="プラグイン・マネージャで選択されたGroovyプラグイン"]
-5. NetBeans IDEのインストーラのウィンドウで「アクティブ化」をクリックして、Groovyプラグインをアクティブ化します。
-6. インストールが完了したらNetBeans IDEのインストーラのウィンドウで「終了」をクリックし、プラグイン・マネージャで「閉じる」をクリックします。
+
+[start=5]
+. NetBeans IDEのインストーラのウィンドウで「アクティブ化」をクリックして、Groovyプラグインをアクティブ化します。
+
+[start=6]
+. インストールが完了したらNetBeans IDEのインストーラのウィンドウで「終了」をクリックし、プラグイン・マネージャで「閉じる」をクリックします。
== アプリケーションの作成
@@ -83,17 +89,29 @@ image::images/groovy-plugin.png[title="プラグイン・マネージャで選
1. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「新規」→「その他」を選択して「新規ファイル」ダイアログ・ボックスを開きます。
2. 「JFrameフォーム」を「Swing GUIフォーム」カテゴリから選択します。「次」をクリックします。
image::images/groovy-newjframe.png[title="新規ファイル・ウィザードの「JFrameフォーム」テンプレート"]
-3. 「クラス名」に「*DisplayJFrame*」と入力します。
-4. 「パッケージ」に「*org.demo*」と入力します。「終了」をクリックします。
+
+[start=3]
+. 「クラス名」に「*DisplayJFrame*」と入力します。
+
+[start=4]
+. 「パッケージ」に「*org.demo*」と入力します。「終了」をクリックします。
image::images/groovy-newjframe2.png[title="新規JFrameフォーム・ウィザードの「名前と場所」パネル"]
「終了」をクリックすると、IDEはJFrameフォームを作成し、そのファイルがエディタで開かれます。
-5. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「新規」→「その他」を選択して「新規ファイル」ダイアログ・ボックスを開きます。
-6. 「Groovy」カテゴリから「Groovyクラス」を選択します。「次」をクリックします。
+
+[start=5]
+. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「新規」→「その他」を選択して「新規ファイル」ダイアログ・ボックスを開きます。
+
+[start=6]
+. 「Groovy」カテゴリから「Groovyクラス」を選択します。「次」をクリックします。
image::images/groovy-newgroovyclass.png[title="新規ファイル・ウィザードの「Groovyクラス」テンプレート"]
-7. 「クラス名」に「*GreetingProvider*」と入力します。
-8. 「パッケージ」ドロップダウン・リストから「 ``org.demo`` パッケージ」を選択します。「終了」をクリックします。
+
+[start=7]
+. 「クラス名」に「*GreetingProvider*」と入力します。
+
+[start=8]
+. 「パッケージ」ドロップダウン・リストから「 ``org.demo`` パッケージ」を選択します。「終了」をクリックします。
「終了」をクリックすると、IDEではGroovyファイルが作成され、エディタでこのファイルが開かれます。
@@ -116,10 +134,16 @@ class GreetingProvider {
}
----
-3. エディタで ``DisplayJFrame.java`` を開いて(まだ開いていない場合)、「デザイン」タブをクリックします。
-4. 「パレット」(メイン・メニューから「ウィンドウ」>「パレット」を選択)を開いて、「テキスト・フィールド」要素( ``jTextField`` )を「パレット」からJFrameにドラッグ・アンド・ドロップします。
+
+[start=3]
+. エディタで ``DisplayJFrame.java`` を開いて(まだ開いていない場合)、「デザイン」タブをクリックします。
+
+[start=4]
+. 「パレット」(メイン・メニューから「ウィンドウ」>「パレット」を選択)を開いて、「テキスト・フィールド」要素( ``jTextField`` )を「パレット」からJFrameにドラッグ・アンド・ドロップします。
image::images/groovy-jtextfield.png[title="エディタの「デザイン」ビューで開かれるDesignJFrameのJTextfield"]
-5. エディタで「ソース」タブをクリックし、Groovyクラスをインスタンス化し、コンストラクタでGroovyクラスの ``getGreeting()`` メソッドをコールするために、クラス本文の上部に次のコードを追加します。
+
+[start=5]
+. エディタで「ソース」タブをクリックし、Groovyクラスをインスタンス化し、コンストラクタでGroovyクラスの ``getGreeting()`` メソッドをコールするために、クラス本文の上部に次のコードを追加します。
[source,java]
----
@@ -138,7 +162,9 @@ public class DisplayJFrameForm extends javax.swing.JFrame {*
Groovyクラスで必要なメソッドの検索には、Javaクラスのコード補完を使用できます。
image::images/groovy-codecompletion.png[title="エディタでのコード補完"]
-6. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」を選択します。
+
+[start=6]
+. 「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「実行」を選択します。
「実行」を選択すると、IDEはアプリケーションをコンパイルして起動します。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_pt_BR.asciidoc
index 434e1f5..40524f7 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_pt_BR.asciidoc
@@ -58,10 +58,16 @@ O suporte para Groovy é desativado por padrão quando você instala a versão J
Se preferir, digite `groovy` no campo Pesquisar para filtrar a lista de plug-ins.
-4. Marque a caixa de seleção do plug-in Groovy e Grails e clique em Ativar.
+
+[start=4]
+. Marque a caixa de seleção do plug-in Groovy e Grails e clique em Ativar.
image::images/groovy-plugin.png[title="Plug-in do Groovy selecionado no gerenciador de Plug-ins"]
-5. Clique em Ativar na janela do Instalador do NetBeans IDE para ativar o plug-in do Groovy.
-6. Clique em Finalizar na janela do Instalador do NetBeans IDE após a instalação ser concluída e, em seguida, clique em Fechar no gerenciador de Plug-ins.
+
+[start=5]
+. Clique em Ativar na janela do Instalador do NetBeans IDE para ativar o plug-in do Groovy.
+
+[start=6]
+. Clique em Finalizar na janela do Instalador do NetBeans IDE após a instalação ser concluída e, em seguida, clique em Fechar no gerenciador de Plug-ins.
== Criando a Aplicação
@@ -83,17 +89,29 @@ Nesta seção, você criará um JFrame e uma classe Groovy.
1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Novo > Outro para abrir a caixa de diálogo Novo Arquivo.
2. Selecione o Form JFrame na categoria Forms de GUI Swing. Clique em Próximo.
image::images/groovy-newjframe.png[title="Modelo de Form JFrame no assistente Novo Arquivo"]
-3. Digite *DisplayJFrame* como o Nome da Classe.
-4. Digite *org.demo* como o Pacote. Clique em Finalizar.
+
+[start=3]
+. Digite *DisplayJFrame* como o Nome da Classe.
+
+[start=4]
+. Digite *org.demo* como o Pacote. Clique em Finalizar.
image::images/groovy-newjframe2.png[title="Painel Nome e Localização no assistente Novo Form JFrame"]
Quando você clica em Finalizar, o IDE cria o form JFrame e abre o arquivo no editor.
-5. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Novo > Outro para abrir a caixa de diálogo Novo Arquivo.
-6. Selecione a Classe Groovy na categoria Groovy. Clique em Próximo.
+
+[start=5]
+. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Novo > Outro para abrir a caixa de diálogo Novo Arquivo.
+
+[start=6]
+. Selecione a Classe Groovy na categoria Groovy. Clique em Próximo.
image::images/groovy-newgroovyclass.png[title="Modelo de Classe Groovy no assistente Novo Arquivo"]
-7. Digite *GreetingProvider* como o Nome da Classe.
-8. Selecione o pacote ``org.demo`` na lista drop-down Pacote. Clique em Finalizar.
+
+[start=7]
+. Digite *GreetingProvider* como o Nome da Classe.
+
+[start=8]
+. Selecione o pacote ``org.demo`` na lista drop-down Pacote. Clique em Finalizar.
Quando você clica em Finalizar, o IDE cria o arquivo Groovy e abre-o no editor.
@@ -116,10 +134,16 @@ class GreetingProvider {
}
----
-3. Abra ``DisplayJFrame.java`` no editor (se ainda não estiver aberto) e clique na guia Design.
-4. Abra a Paleta (Janela > Paleta do menu principal) e arraste e solte um elemento Campo de Texto ( ``jTextField`` ) da Paleta e para o JFrame.
+
+[start=3]
+. Abra ``DisplayJFrame.java`` no editor (se ainda não estiver aberto) e clique na guia Design.
+
+[start=4]
+. Abra a Paleta (Janela > Paleta do menu principal) e arraste e solte um elemento Campo de Texto ( ``jTextField`` ) da Paleta e para o JFrame.
image::images/groovy-jtextfield.png[title="JTextfield no DesignJFrame será aberto na view de Design do editor"]
-5. Clique na guia Código-fonte do editor e adicione o seguinte código à parte superior do corpo da classe para instanciar a classe Groovy e no construtor para chamar o método ``getGreeting()`` na classe Groovy.
+
+[start=5]
+. Clique na guia Código-fonte do editor e adicione o seguinte código à parte superior do corpo da classe para instanciar a classe Groovy e no construtor para chamar o método ``getGreeting()`` na classe Groovy.
[source,java]
----
@@ -138,7 +162,9 @@ public class DisplayJFrameForm extends javax.swing.JFrame {*
É possível utilizar a funcionalidade autocompletar código na classe Java para encontrar os métodos necessários na classe Groovy.
image::images/groovy-codecompletion.png[title="Autocompletar código no editor"]
-6. Clique com o botão direito do mouse no nó na janela Projetos e selecione Executar.
+
+[start=6]
+. Clique com o botão direito do mouse no nó na janela Projetos e selecione Executar.
Quando escolher Executar o IDE compila e aciona a aplicação.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ru.asciidoc
index 3aeb58d..0c727f6 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_ru.asciidoc
@@ -58,10 +58,16 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
В качестве альтернативы вы можете ввести `groovy` в поле поиска, чтобы отфильтровать список подключаемых модулей.
-4. Установите подключаемый модуль 'Groovy and Grails' и нажмите 'Активировать'.
+
+[start=4]
+. Установите подключаемый модуль 'Groovy and Grails' и нажмите 'Активировать'.
image::images/groovy-plugin.png[title="Подключаемый модуль 'Groovy' выбран в диспетчере подключаемых модулей"]
-5. Нажмите кнопку 'Активировать' в окне 'Мастер установки NetBeans IDE', чтобы активировать подключаемый модуль Groovy.
-6. Нажмите кнопку 'Завершить' в окне 'Мастер установки NetBeans IDE' после завершения установки и затем нажмите 'Закрыть' в диспетчере подключаемых модулей.
+
+[start=5]
+. Нажмите кнопку 'Активировать' в окне 'Мастер установки NetBeans IDE', чтобы активировать подключаемый модуль Groovy.
+
+[start=6]
+. Нажмите кнопку 'Завершить' в окне 'Мастер установки NetBeans IDE' после завершения установки и затем нажмите 'Закрыть' в диспетчере подключаемых модулей.
== Создание приложения
@@ -83,17 +89,29 @@ image::images/groovy-plugin.png[title="Подключаемый модуль 'Gr
1. Щелкните правой кнопкой мыши узел проекта в окне 'Проекты' и выберите 'Создать > Другое'. Откроется диалоговое окно мастера создания файлов.
2. В категории 'Формы Swing GUI' выберите 'Форма JFrame'. Нажмите 'Далее'.
image::images/groovy-newjframe.png[title="Шаблон формы JFrame в мастере создания файлов"]
-3. В поле 'Имя класса' введите *DisplayJFrame*.
-4. В поле 'Пакет' введите *org.demo*. Нажмите 'Готово'.
+
+[start=3]
+. В поле 'Имя класса' введите *DisplayJFrame*.
+
+[start=4]
+. В поле 'Пакет' введите *org.demo*. Нажмите 'Готово'.
image::images/groovy-newjframe2.png[title="Панель 'Имя и местоположение' в мастере создания форм JFrame"]
При нажатии на кнопку 'Готово' в среде IDE создается форма JFrame, и в редакторе открывается соответствующий файл.
-5. Щелкните правой кнопкой мыши узел проекта в окне 'Проекты' и выберите 'Создать > Другое'. Откроется диалоговое окно мастера создания файлов.
-6. В категории Groovy выберите 'Класс Groovy'. Нажмите 'Далее'.
+
+[start=5]
+. Щелкните правой кнопкой мыши узел проекта в окне 'Проекты' и выберите 'Создать > Другое'. Откроется диалоговое окно мастера создания файлов.
+
+[start=6]
+. В категории Groovy выберите 'Класс Groovy'. Нажмите 'Далее'.
image::images/groovy-newgroovyclass.png[title="Шаблон класса Groovy в мастере создания файлов"]
-7. В поле 'Имя класса' введите *GreetingProvider*.
-8. В списке 'Пакеты' выберите пакет ``org.demo`` . Нажмите кнопку "Завершить".
+
+[start=7]
+. В поле 'Имя класса' введите *GreetingProvider*.
+
+[start=8]
+. В списке 'Пакеты' выберите пакет ``org.demo`` . Нажмите кнопку "Завершить".
При нажатии на кнопку 'Готово' IDE создает файл Groovy и открывает его в редакторе.
@@ -116,10 +134,16 @@ class GreetingProvider {
}
----
-3. Откройте файл ``DisplayJFrame.java`` в редакторе (если он еще не открыт) и перейдите на вкладку 'Конструирование'.
-4. Откройте палитру (выберите 'Окно > Палитра' в главном меню) и перетащите элемент 'Текстовое поле' ( ``jTextField`` ) и палитры на форму JFrame.
+
+[start=3]
+. Откройте файл ``DisplayJFrame.java`` в редакторе (если он еще не открыт) и перейдите на вкладку 'Конструирование'.
+
+[start=4]
+. Откройте палитру (выберите 'Окно > Палитра' в главном меню) и перетащите элемент 'Текстовое поле' ( ``jTextField`` ) и палитры на форму JFrame.
image::images/groovy-jtextfield.png[title="Элемент JTextfield в файле DesignJFrame на вкладке 'Конструирование' в редакторе"]
-5. Перейдите на вкладку 'Исходный код' и добавьте следующий исходный код в верхнюю часть тела класса, чтобы создать экземпляр класса Groovy и вызвать метод ``getGreeting()`` в классе Groovy в конструкторе.
+
+[start=5]
+. Перейдите на вкладку 'Исходный код' и добавьте следующий исходный код в верхнюю часть тела класса, чтобы создать экземпляр класса Groovy и вызвать метод ``getGreeting()`` в классе Groovy в конструкторе.
[source,java]
----
@@ -138,7 +162,9 @@ public class DisplayJFrameForm extends javax.swing.JFrame {*
Для поиска в классе Java методов, необходимых для класса Groovy, можно использовать автозавершение кода.
image::images/groovy-codecompletion.png[title="Автозавершение кода в редакторе"]
-6. Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите "Выполнить".
+
+[start=6]
+. Щелкните правой кнопкой мыши узел проекта в окне "Проекты" и выберите "Выполнить".
Если выбрать команду 'Выполнить', IDE выполнит сборку и запуск приложения.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_zh_CN.asciidoc
index d648eff..5dace37 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/groovy-quickstart_zh_CN.asciidoc
@@ -58,10 +58,16 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
或者，您也可以在搜索字段中键入 `groovy` 以过滤插件列表。
-4. 选中 "Groovy and Grails"（Groovy 和 Grails）插件对应的复选框，然后单击 "Activate"（激活）。
+
+[start=4]
+. 选中 "Groovy and Grails"（Groovy 和 Grails）插件对应的复选框，然后单击 "Activate"（激活）。
image::images/groovy-plugin.png[title="在插件管理器中选定的 Groovy 插件"]
-5. 在 "NetBeans IDE Installer"（NetBeans IDE 安装程序）窗口中单击 "Activate"（激活）以激活 Groovy 插件。
-6. 在安装完成之后，在 "NetBeans IDE Installer"（NetBeans IDE 安装程序）窗口中单击 "Finish"（完成），然后在插件管理器中单击 "Close"（关闭）。
+
+[start=5]
+. 在 "NetBeans IDE Installer"（NetBeans IDE 安装程序）窗口中单击 "Activate"（激活）以激活 Groovy 插件。
+
+[start=6]
+. 在安装完成之后，在 "NetBeans IDE Installer"（NetBeans IDE 安装程序）窗口中单击 "Finish"（完成），然后在插件管理器中单击 "Close"（关闭）。
== 创建应用程序
@@ -83,17 +89,29 @@ image::images/groovy-plugin.png[title="在插件管理器中选定的 Groovy 插
1. 在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "New"（新建）> "Other"（其他）以打开 "New File"（新建文件）对话框。
2. 在 "Swing GUI Forms"（Swing GUI 窗体）类别中选择 "JFrame Form"（JFrame 窗体）。单击 "Next"（下一步）。
image::images/groovy-newjframe.png[title=""New File"（新建文件）向导中的 JFrame 窗体模板"]
-3. 键入 *DisplayJFrame* 作为类名。
-4. 键入 *org.demo* 作为包。单击 "Finish"（完成）。
+
+[start=3]
+. 键入 *DisplayJFrame* 作为类名。
+
+[start=4]
+. 键入 *org.demo* 作为包。单击 "Finish"（完成）。
image::images/groovy-newjframe2.png[title=""New JFrame Form"（新建 JFrame 窗体）向导中的 "Name and Location"（名称和位置）面板"]
单击 "Finish"（完成）后，IDE 将创建 JFrame 窗体并在编辑器中打开文件。
-5. 在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "New"（新建）> "Other"（其他）以打开 "New File"（新建文件）对话框。
-6. 在 "Groovy" 类别中选择 "Groovy Class"（Groovy 类）。单击 "Next"（下一步）。
+
+[start=5]
+. 在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "New"（新建）> "Other"（其他）以打开 "New File"（新建文件）对话框。
+
+[start=6]
+. 在 "Groovy" 类别中选择 "Groovy Class"（Groovy 类）。单击 "Next"（下一步）。
image::images/groovy-newgroovyclass.png[title=""New File"（新建文件）向导中的 Groovy 类模板"]
-7. 键入 *GreetingProvider* 作为类名。
-8. 从 "Package"（包）下拉列表中选择 ``org.demo`` 包。单击“完成”。
+
+[start=7]
+. 键入 *GreetingProvider* 作为类名。
+
+[start=8]
+. 从 "Package"（包）下拉列表中选择 ``org.demo`` 包。单击“完成”。
单击 "Finish"（完成）后，IDE 将创建 Groovy 文件并在编辑器中打开该文件。
@@ -116,10 +134,16 @@ class GreetingProvider {
}
----
-3. 在编辑器中打开 ``DisplayJFrame.java`` （如果尚未打开），然后单击 "Design"（设计）标签。
-4. 打开 "Palette"（组件面板）（从主菜单中选择 "Window"（窗口）> "Palette"（组件面板）），然后将 "Text Field"（文本字段）元素 ( ``jTextField`` ) 从 "Palette"（组件面板）拖放到 JFrame。
+
+[start=3]
+. 在编辑器中打开 ``DisplayJFrame.java`` （如果尚未打开），然后单击 "Design"（设计）标签。
+
+[start=4]
+. 打开 "Palette"（组件面板）（从主菜单中选择 "Window"（窗口）> "Palette"（组件面板）），然后将 "Text Field"（文本字段）元素 ( ``jTextField`` ) 从 "Palette"（组件面板）拖放到 JFrame。
image::images/groovy-jtextfield.png[title="在编辑器 "Design"（设计）视图中打开的 DesignJFrame 中的 JTextfield"]
-5. 在编辑器中单击 "Source"（源）标签，然后在类主体顶部添加以下代码以实例化 Groovy 类并在构造函数中调用 Groovy 类中的 ``getGreeting()`` 方法。
+
+[start=5]
+. 在编辑器中单击 "Source"（源）标签，然后在类主体顶部添加以下代码以实例化 Groovy 类并在构造函数中调用 Groovy 类中的 ``getGreeting()`` 方法。
[source,java]
----
@@ -138,7 +162,9 @@ public class DisplayJFrameForm extends javax.swing.JFrame {*
您可以在 Java 类中使用代码完成来查找 Groovy 类中需要的方法。
image::images/groovy-codecompletion.png[title="编辑器中的代码完成功能"]
-6. 在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "Run"（运行）。
+
+[start=6]
+. 在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "Run"（运行）。
选择 "Run"（运行）后，IDE 将编译并启动应用程序。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n.asciidoc
index 4254dca..56b4f6c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n.asciidoc
@@ -63,11 +63,15 @@ image::images/finddialog_ai18n.png[]
image::images/navigator.png[]
-2. In the Properties window, select the checkbox in the Automatic Internationalization property.
+
+[start=2]
+. In the Properties window, select the checkbox in the Automatic Internationalization property.
image::images/properties.png[]
-3. Click Upgrade in the GUI Form Format Upgrade dialog box.
+
+[start=3]
+. Click Upgrade in the GUI Form Format Upgrade dialog box.
If the checkbox is selected, the IDE creates the ``Bundle.properties`` file in the ``demo`` package as it is set in the ``Properties Bundle File`` property.
@@ -75,11 +79,15 @@ image::images/bundle_new.png[]
If you need to have the ``Bundle.properties`` file in a different location, you can click the ellipsis (...) button to the right of the Properties Bundle File and choose a location or directly type the path in the property's text field.
-4. In the Projects window, double-click the ``Bundle.properties`` node in the Projects Window or right-click the node and choose Edit.
+
+[start=4]
+. In the Projects window, double-click the ``Bundle.properties`` node in the Projects Window or right-click the node and choose Edit.
The properties file is opened in the Source Editor. As you can see, all appropriate Keys and Values for Form ``FindDialog.java`` are generated. (The name of each key is derived from the form file name and the component Variable name. For example, the key ``FindDialog.jLabel1.text`` is generated for a component with the variable name ``jLabel1`` placed in form file ``FindDialog`` . The value ``jLabel1`` represents component's Text property in this example.
-5. Close the ``Bundle.properties`` file.
+
+[start=5]
+. Close the ``Bundle.properties`` file.
=== Internationalizing Individual GUI Components
@@ -91,9 +99,15 @@ We will now use the GUI builder to enter internationalized strings for the JLabe
NOTE: You can also internationalize other properties that have String values, such as Mnemonic, Accessible Name, Accessible Descriptor, and ToolTip.
-3. The property editor is switched to resource bundle mode. Check that the Bundle Name field is set to ``demo.Bundle`` and the Key field contains the string ``FindDialog.jLabel1.text``
-4. Type ``Find What:`` in the Value field.
-5. Click OK.
+
+[start=3]
+. The property editor is switched to resource bundle mode. Check that the Bundle Name field is set to ``demo.Bundle`` and the Key field contains the string ``FindDialog.jLabel1.text``
+
+[start=4]
+. Type ``Find What:`` in the Value field.
+
+[start=5]
+. Click OK.
Repeat the previous steps for all the components so that the form looks like the following picture:
@@ -122,18 +136,30 @@ The new locale appears below the ``Bundle.properties`` node, as shown below:
image::images/addlocale_new.png[]
-5. In the Projects window, right-click ``Bundle.properties`` and choose Open.
-6. Translate individual messages in the correspondent column of the table to a new language (for example, Spanish), as shown below:
+
+[start=5]
+. In the Projects window, right-click ``Bundle.properties`` and choose Open.
+
+[start=6]
+. Translate individual messages in the correspondent column of the table to a new language (for example, Spanish), as shown below:
[.feature]
--
image::images/bundles_new_small.png[role="left", link="images/bundles_new.png"]
--
-7. Press Ctrl-S to save your edits.
-8. Select the ``FindDialog.java`` tab to display the form you are internationalizing.
-9. Right-click the root node in the Navigator window and choose Reload Form (alternatively, press Ctrl-R).
-10. Click Save in the Question dialog box that displays.
+
+[start=7]
+. Press Ctrl-S to save your edits.
+
+[start=8]
+. Select the ``FindDialog.java`` tab to display the form you are internationalizing.
+
+[start=9]
+. Right-click the root node in the Navigator window and choose Reload Form (alternatively, press Ctrl-R).
+
+[start=10]
+. Click Save in the Question dialog box that displays.
The form is reopened and the Spanish locale is loaded in in the design, as shown below:
[.feature]
@@ -153,8 +179,12 @@ image::images/finddialog_es_new_small.png[role="left", link="images/finddialog_e
image::images/prjproperties_small.png[role="left", link="images/prjproperties.png"]
--
-4. Click OK.
-5. Right-click the InternationalizeDemo project and choose Run.
+
+[start=4]
+. Click OK.
+
+[start=5]
+. Right-click the InternationalizeDemo project and choose Run.
The IDE runs the ``FindDialog`` dialog box in the Spanish locale like shown below.
@@ -209,25 +239,39 @@ The sources files appear in the first page of the Wizard as shown below:
image::images/i18nwizardone_small.png[role="left", link="images/i18nwizardone.png"]
--
-5. For demonstration purposes, select ``examples.Find`` and click the Remove Source(s) button.
-6. Click Next.
-7. Check if the Internationalization Wizard offers the correct properties files ``examples.Antenna`` and ``examples.ContactEditor`` . If it does not, use the Select Resource button to choose the correct properties file.
+
+[start=5]
+. For demonstration purposes, select ``examples.Find`` and click the Remove Source(s) button.
+
+[start=6]
+. Click Next.
+
+[start=7]
+. Check if the Internationalization Wizard offers the correct properties files ``examples.Antenna`` and ``examples.ContactEditor`` . If it does not, use the Select Resource button to choose the correct properties file.
[.feature]
--
image::images/i18nwizardtwo_small.png[role="left", link="images/i18nwizardtwo.png"]
--
-8. Click Next.
-9. Skip page 3 of the Wizard since you are not going to create any fields and modify additional values and click Next.
-10. All hard-coded strings are displayed in the last step of Internationalization wizard and it is possible to decide which of them will come from the properties file (use checkbox). You can further customize individual keys, values, comments, and format of replaced strings by clicking on the ellipsis (...) button for a string.
+
+[start=8]
+. Click Next.
+
+[start=9]
+. Skip page 3 of the Wizard since you are not going to create any fields and modify additional values and click Next.
+
+[start=10]
+. All hard-coded strings are displayed in the last step of Internationalization wizard and it is possible to decide which of them will come from the properties file (use checkbox). You can further customize individual keys, values, comments, and format of replaced strings by clicking on the ellipsis (...) button for a string.
[.feature]
--
image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthree.png"]
--
-11. Click Finish.
+
+[start=11]
+. Click Finish.
Now, the internationalization of source code is finished, other locale can be <<newlocale,added>> and <<testlocale,tested>> as it was shown previously.
@@ -245,10 +289,18 @@ In this last exercise we will reuse the GUI Form Examples project and internatio
The IDE shows Internationalization dialog box and pre-fills the first hard-coded string from the ``Find.java`` source code .
-2. Click Select to select a particular properties file or create a new one.
-3. In the Select Resource Bundle dialog box, enter ``Find.properties`` in the File Name text field, click Create New and then OK.
-4. You can modify format of replaced string, key, value or comment if it is necessary. We'll just leave the default values.
-5. Click Replace to confirm the change and move a focus on the next hard-coded string.
+
+[start=2]
+. Click Select to select a particular properties file or create a new one.
+
+[start=3]
+. In the Select Resource Bundle dialog box, enter ``Find.properties`` in the File Name text field, click Create New and then OK.
+
+[start=4]
+. You can modify format of replaced string, key, value or comment if it is necessary. We'll just leave the default values.
+
+[start=5]
+. Click Replace to confirm the change and move a focus on the next hard-coded string.
If a hard-coded string does not need to be replaced, click the Skip button.
@@ -264,8 +316,12 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
The IDE opens the ``Find.java`` file in the Source Editor.
-2. Scroll through the source code and find the main method.
-3. Insert the following line in bold in the main method:
+
+[start=2]
+. Scroll through the source code and find the main method.
+
+[start=3]
+. Insert the following line in bold in the main method:
[source,xml]
----
@@ -302,15 +358,25 @@ The IDE opens the ``Find.java`` file in the Source Editor.
});
}
----
-4. Place the mouse cursor within the parentheses of the ``System.out.println();`` so that an internationalized string is inserted as a parameter.
-5. Press Ctrl-Shift-J to invoke Insert Internationalized String dialog box (alternatively, you can choose Tools > Internationalization > Insert Internationalized String from the main menu).
-6. For Bundle Name, click the Select button, select the ``Source Packages > examples`` folder, and enter ``Find`` as the Bundle name in the File Name text field. Then click OK.
+
+[start=4]
+. Place the mouse cursor within the parentheses of the ``System.out.println();`` so that an internationalized string is inserted as a parameter.
+
+[start=5]
+. Press Ctrl-Shift-J to invoke Insert Internationalized String dialog box (alternatively, you can choose Tools > Internationalization > Insert Internationalized String from the main menu).
+
+[start=6]
+. For Bundle Name, click the Select button, select the ``Source Packages > examples`` folder, and enter ``Find`` as the Bundle name in the File Name text field. Then click OK.
The Bundle Name field of the Insert Internationalized String dialog box shows ``examples.Find`` .
-7. Type ``Start`` in the Key drop-down box and ``Start Find Dialog`` in the Value field. Then click OK.
+
+[start=7]
+. Type ``Start`` in the Key drop-down box and ``Start Find Dialog`` in the Value field. Then click OK.
image::images/insi18nstring.png[]
-8. The IDE inserts an internationalized string:
+
+[start=8]
+. The IDE inserts an internationalized string:
[source,xml]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ja.asciidoc
index 36e86d1..d749509 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ja.asciidoc
@@ -80,11 +80,15 @@ image::images/finddialog_ai18n.png[]
image::images/navigator.png[]
-2. 「プロパティ」ウィンドウで、「自動国際化」プロパティのチェックボックスを選択します。
+
+[start=2]
+. 「プロパティ」ウィンドウで、「自動国際化」プロパティのチェックボックスを選択します。
image::images/properties.png[]
-3. 「GUIフォーム形式のアップグレード」ダイアログ・ボックスで「アップグレード」をクリックします。
+
+[start=3]
+. 「GUIフォーム形式のアップグレード」ダイアログ・ボックスで「アップグレード」をクリックします。
チェックボックスが選択されると、「 ``プロパティ・バンドル・ファイル`` 」プロパティで設定されているとおりに、IDEが ``demo`` パッケージ内に ``Bundle.properties`` ファイルを作成します。
@@ -92,11 +96,15 @@ image::images/bundle_new.png[]
``Bundle.properties`` ファイルを別の場所に置く必要がある場合は、「プロパティ・バンドル・ファイル」の右側の省略符号ボタン(...)をクリックして場所を選択するか、プロパティのテキスト・フィールドにパスを直接入力できます。
-4. 「プロジェクト」ウィンドウで、「プロジェクト」ウィンドウの「 ``Bundle.properties`` 」ノードをダブルクリックするか、またはノードを右クリックして「編集」を選択します。
+
+[start=4]
+. 「プロジェクト」ウィンドウで、「プロジェクト」ウィンドウの「 ``Bundle.properties`` 」ノードをダブルクリックするか、またはノードを右クリックして「編集」を選択します。
プロパティ・ファイルがソース・エディタに表示されます。フォーム ``FindDialog.java`` に適切なキーと値がすべて生成されていることがわかります。各キーの名前は、フォームのファイル名とコンポーネントの変数名から派生されます。たとえば、キー ``FindDialog.jLabel1.text`` は、フォーム・ファイル ``FindDialog`` に配置された ``jLabel1`` という変数名を持つコンポーネント用に生成されます。値 ``jLabel1`` は、この例ではコンポーネントの「text」プロパティを表しています。
-5. ``Bundle.properties`` ファイルを閉じます。
+
+[start=5]
+. ``Bundle.properties`` ファイルを閉じます。
=== 個別のGUIコンポーネントの国際化
@@ -108,9 +116,15 @@ GUIビルダーを使用して、フォームのJLabelsおよびJButtonsの国
*注意:* Mnemonic、Accessible Name、Accessible Descriptor、ToolTipなどの、文字列値を持つその他のプロパティも国際化できます。
-3. プロパティ・エディタがリソース・バンドル・モードに切り替わります。「バンドル名」フィールドが ``demo.Bundle`` に設定され、「キー」フィールドに文字列 ``FindDialog.jLabel1.text`` が含まれていることを確認します。
-4. 「値」フィールドに「 ``Find What:`` 」と入力します。
-5. 「OK」をクリックします。
+
+[start=3]
+. プロパティ・エディタがリソース・バンドル・モードに切り替わります。「バンドル名」フィールドが ``demo.Bundle`` に設定され、「キー」フィールドに文字列 ``FindDialog.jLabel1.text`` が含まれていることを確認します。
+
+[start=4]
+. 「値」フィールドに「 ``Find What:`` 」と入力します。
+
+[start=5]
+. 「OK」をクリックします。
すべてのコンポーネントで前述の手順を繰り返すと、フォームは次の図のようになります。
@@ -139,18 +153,30 @@ image::images/finddialog_new_small.png[role="left", link="images/finddialog_new.
image::images/addlocale_new.png[]
-5. 「プロジェクト」ウィンドウで、 ``Bundle.properties`` を右クリックして「開く」を選択します。
-6. 次に示すように、表の対応する列の個々のメッセージを、新しい言語(スペイン語など)に変換します。
+
+[start=5]
+. 「プロジェクト」ウィンドウで、 ``Bundle.properties`` を右クリックして「開く」を選択します。
+
+[start=6]
+. 次に示すように、表の対応する列の個々のメッセージを、新しい言語(スペイン語など)に変換します。
[.feature]
--
image::images/bundles_new_small.png[role="left", link="images/bundles_new.png"]
--
-7. [Ctrl]-[S]を押して編集を保存します。
-8. 「 ``FindDialog.java`` 」タブを選択して、国際化しているフォームを表示します。
-9. 「ナビゲータ」ウィンドウのルート・ノードを右クリックし、「フォームの再ロード」を選択します(または[Ctrl]+[R]を押します)。
-10. 表示される「質問」ダイアログ・ボックスで「保存」をクリックします。
+
+[start=7]
+. [Ctrl]-[S]を押して編集を保存します。
+
+[start=8]
+. 「 ``FindDialog.java`` 」タブを選択して、国際化しているフォームを表示します。
+
+[start=9]
+. 「ナビゲータ」ウィンドウのルート・ノードを右クリックし、「フォームの再ロード」を選択します(または[Ctrl]+[R]を押します)。
+
+[start=10]
+. 表示される「質問」ダイアログ・ボックスで「保存」をクリックします。
フォームが再度開き、次に示すように、スペイン語ロケールがデザインにロードされます。
[.feature]
@@ -170,8 +196,12 @@ image::images/finddialog_es_new_small.png[role="left", link="images/finddialog_e
image::images/prjproperties_small.png[role="left", link="images/prjproperties.png"]
--
-4. 「OK」をクリックします。
-5. 「InternationalizeDemo」プロジェクトを右クリックし、「実行」を選択します。
+
+[start=4]
+. 「OK」をクリックします。
+
+[start=5]
+. 「InternationalizeDemo」プロジェクトを右クリックし、「実行」を選択します。
次に示すように、IDEによって「 ``FindDialog`` 」ダイアログ・ボックスがスペイン語ロケールで実行されます。
@@ -226,25 +256,39 @@ image::images/ceprjprops.png[]
image::images/i18nwizardone_small.png[role="left", link="images/i18nwizardone.png"]
--
-5. デモの目的で、「 ``examples.Find`` 」を選択し、「ソースを除去」ボタンをクリックします。
-6. 「次」をクリックします。
-7. 国際化ウィザードが正しいプロパティ・ファイル ``examples.Antenna`` と ``examples.ContactEditor`` を提示するかどうかを確認します。提示しない場合、「リソースを選択」ボタンを使用して正しいプロパティ・ファイルを選択します。
+
+[start=5]
+. デモの目的で、「 ``examples.Find`` 」を選択し、「ソースを除去」ボタンをクリックします。
+
+[start=6]
+. 「次」をクリックします。
+
+[start=7]
+. 国際化ウィザードが正しいプロパティ・ファイル ``examples.Antenna`` と ``examples.ContactEditor`` を提示するかどうかを確認します。提示しない場合、「リソースを選択」ボタンを使用して正しいプロパティ・ファイルを選択します。
[.feature]
--
image::images/i18nwizardtwo_small.png[role="left", link="images/i18nwizardtwo.png"]
--
-8. 「次」をクリックします。
-9. フィールドを作成する予定はないため、ウィザードの3ページ目をスキップし、追加の値を変更して「次」をクリックします。
-10. ハードコードされた文字列は、国際化ウィザードの最後のステップですべて表示されます。それらのうちどれがプロパティ・ファイルからのものかを判断できます(チェックボックスを使用)。文字列の省略符号ボタン(...)をクリックして、個々のキー、値、コメント、および置換した文字列の書式をさらにカスタマイズできます。
+
+[start=8]
+. 「次」をクリックします。
+
+[start=9]
+. フィールドを作成する予定はないため、ウィザードの3ページ目をスキップし、追加の値を変更して「次」をクリックします。
+
+[start=10]
+. ハードコードされた文字列は、国際化ウィザードの最後のステップですべて表示されます。それらのうちどれがプロパティ・ファイルからのものかを判断できます(チェックボックスを使用)。文字列の省略符号ボタン(...)をクリックして、個々のキー、値、コメント、および置換した文字列の書式をさらにカスタマイズできます。
[.feature]
--
image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthree.png"]
--
-11. 「終了」をクリックします。
+
+[start=11]
+. 「終了」をクリックします。
これでソース・コードの国際化は終了し、前述したように、他のロケールも<<newlocale,追加>>したり<<testlocale,テスト>>したりできます。
@@ -262,10 +306,18 @@ GUIフォームを国際化するには、自動国際化機能を使用する
IDEは、「国際化」ダイアログ・ボックスと、事前入力済の ``Find.java`` ソース・コードから最初にハードコードされた文字列を表示します。
-2. 「選択」をクリックして特定のプロパティ・ファイルを選択するか、または新しいプロパティ・ファイルを作成します。
-3. 「リソース・バンドルを選択」ダイアログ・ボックスで、「ファイル名」テキスト・フィールドに「 ``Find.properties`` 」と入力し、「新規作成」をクリックしてから「OK」をクリックします。
-4. 必要に応じて、置換された文字列、キー、値、またはコメントの書式を変更できます。デフォルトの値はそのままにします。
-5. 「置換」をクリックして変更を確認し、フォーカスを次のハードコードされた文字列に移動します。
+
+[start=2]
+. 「選択」をクリックして特定のプロパティ・ファイルを選択するか、または新しいプロパティ・ファイルを作成します。
+
+[start=3]
+. 「リソース・バンドルを選択」ダイアログ・ボックスで、「ファイル名」テキスト・フィールドに「 ``Find.properties`` 」と入力し、「新規作成」をクリックしてから「OK」をクリックします。
+
+[start=4]
+. 必要に応じて、置換された文字列、キー、値、またはコメントの書式を変更できます。デフォルトの値はそのままにします。
+
+[start=5]
+. 「置換」をクリックして変更を確認し、フォーカスを次のハードコードされた文字列に移動します。
ハードコードされた文字列を置換する必要がない場合は、「スキップ」ボタンをクリックします。
@@ -281,8 +333,12 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
IDEは、ソース・エディタで ``Find.java`` ファイルを開きます。
-2. ソース・コードをスクロールし、mainメソッドを探します。
-3. mainメソッドに、次の太字の行を挿入します。
+
+[start=2]
+. ソース・コードをスクロールし、mainメソッドを探します。
+
+[start=3]
+. mainメソッドに、次の太字の行を挿入します。
[source,xml]
----
@@ -319,15 +375,25 @@ IDEは、ソース・エディタで ``Find.java`` ファイルを開きます
});
}
----
-4. ``System.out.println();`` の括弧内にカーソルを移動して、国際化文字列をパラメータとして挿入できるようにします。
-5. [Ctrl]-[Shift]-[J]を押して「国際化文字列を挿入」ダイアログ・ボックスを起動します(または、メイン・メニューから「ツール」>「国際化」>「国際化文字列を挿入」を選択できます)。
-6. 「バンドル名」で、「選択」ボタンをクリックし、 ``「ソース・パッケージ」>「examples」`` フォルダを選択して、「ファイル名」テキスト・フィールドにバンドル名として「 ``Find`` 」と入力します。「OK」をクリックします。
+
+[start=4]
+. ``System.out.println();`` の括弧内にカーソルを移動して、国際化文字列をパラメータとして挿入できるようにします。
+
+[start=5]
+. [Ctrl]-[Shift]-[J]を押して「国際化文字列を挿入」ダイアログ・ボックスを起動します(または、メイン・メニューから「ツール」>「国際化」>「国際化文字列を挿入」を選択できます)。
+
+[start=6]
+. 「バンドル名」で、「選択」ボタンをクリックし、 ``「ソース・パッケージ」>「examples」`` フォルダを選択して、「ファイル名」テキスト・フィールドにバンドル名として「 ``Find`` 」と入力します。「OK」をクリックします。
「国際化文字列を挿入」ダイアログ・ボックスの「バンドル名」フィールドに、「 ``examples.Find`` 」と表示されます。
-7. 「キー」ドロップダウン・ボックスに「 ``Start`` 」と入力し、「値」フィールドに「 ``Start Find Dialog`` 」と入力します。「OK」をクリックします。
+
+[start=7]
+. 「キー」ドロップダウン・ボックスに「 ``Start`` 」と入力し、「値」フィールドに「 ``Start Find Dialog`` 」と入力します。「OK」をクリックします。
image::images/insi18nstring.png[]
-8. 次のように、IDEが国際化文字列を挿入します。
+
+[start=8]
+. 次のように、IDEが国際化文字列を挿入します。
[source,xml]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_pt_BR.asciidoc
index 5989a12..a7ed003 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_pt_BR.asciidoc
@@ -80,11 +80,15 @@ image::images/finddialog_ai18n.png[]
image::images/navigator.png[]
-2. Na janela Propriedades, marque a caixa de seleção na propriedade Automatic Internationalization.
+
+[start=2]
+. Na janela Propriedades, marque a caixa de seleção na propriedade Automatic Internationalization.
image::images/properties.png[]
-3. Clique em Upgrade na caixa de diálogo Upgrade do Formato do Form GUI.
+
+[start=3]
+. Clique em Upgrade na caixa de diálogo Upgrade do Formato do Form GUI.
Se a caixa de seleção estiver marcada, o IDE cria o arquivo ``Bundle.properties`` no pacote ``demo`` conforme está definido na propriedade ``Properties Bundle File`` .
@@ -92,11 +96,15 @@ image::images/bundle_new.png[]
Se você precisar que o arquivo ``Bundle.properties`` fique em outro local, poderá clicar no botão de reticências (...) à direita do Arquivo Conjunto de Propriedades e escolher um local ou digitar diretamente o caminho no campo de texto da propriedade.
-4. Na janela Projetos, clique duas vezes no nó ``Bundle.properties`` na janela Projetos ou clique com o botão direito do mouse no nó e escolha Editar.
+
+[start=4]
+. Na janela Projetos, clique duas vezes no nó ``Bundle.properties`` na janela Projetos ou clique com o botão direito do mouse no nó e escolha Editar.
O arquivo de propriedades é aberto no Editor de Código-fonte. Como você pode ver, todas as chaves e os valores apropriados para o form ``FindDialog.java`` são gerados. (O nome de cada chave é obtido do nome do arquivo de form e do nome de variável do componente). Por exemplo, a chave ``FindDialog.jLabel1.text`` é gerada para um componente com o nome de variável ``jLabel1`` colocado no arquivo de form ``FindDialog`` . O valor ``jLabel1`` representa a propriedade Text do component [...]
-5. Escolha o arquivo ``Bundle.properties`` .
+
+[start=5]
+. Escolha o arquivo ``Bundle.properties`` .
=== Internacionalizando Componentes GUI Individuais
@@ -108,9 +116,15 @@ Nós agora utilizaremos o GUI Builder para inserir strings internacionalizadas p
*Observação:* você também pode internacionalizar outras propriedades que tenham valor de Strings, como Mnemonic, Accessible Name, Accessible Descriptor e ToolTip.
-3. O editor de propriedade é alternado para o modo de pacote de recursos. Verifique se o campo Nome do Pacote está definido como ``demo.Bundle`` e se o campo Chave contém a string ``FindDialog.jLabel1.text``
-4. Digite ``Localizar:`` no campo Valor.
-5. Clique em OK.
+
+[start=3]
+. O editor de propriedade é alternado para o modo de pacote de recursos. Verifique se o campo Nome do Pacote está definido como ``demo.Bundle`` e se o campo Chave contém a string ``FindDialog.jLabel1.text``
+
+[start=4]
+. Digite ``Localizar:`` no campo Valor.
+
+[start=5]
+. Clique em OK.
Repita as etapas anteriores para todos os componentes para que o form tenha a aparência semelhante à figura a seguir:
@@ -139,18 +153,30 @@ A nova configuração regional aparece abaixo do nó ``Bundle.properties`` , co
image::images/addlocale_new.png[]
-5. Na janela Projetos, clique com o botão direito do mouse em ``Bundle.properties`` e escolha Abrir.
-6. Traduza mensagens individuais na coluna correspondente da tabela para o novo idioma (por exemplo, espanhol), como mostrado abaixo:
+
+[start=5]
+. Na janela Projetos, clique com o botão direito do mouse em ``Bundle.properties`` e escolha Abrir.
+
+[start=6]
+. Traduza mensagens individuais na coluna correspondente da tabela para o novo idioma (por exemplo, espanhol), como mostrado abaixo:
[.feature]
--
image::images/bundles_new_small.png[role="left", link="images/bundles_new.png"]
--
-7. Pressione Ctrl-S para salvar suas edições.
-8. Selecione a guia ``FindDialog.java`` para exibir o form que você está internacionalizando.
-9. Clique com o botão direito do mouse no nó-raiz da janela Navegador e escolha Recarregar Form (se preferir, pressione Ctrl-R).
-10. Clique em Salvar na caixa de diálogo Pergunta que é exibida.
+
+[start=7]
+. Pressione Ctrl-S para salvar suas edições.
+
+[start=8]
+. Selecione a guia ``FindDialog.java`` para exibir o form que você está internacionalizando.
+
+[start=9]
+. Clique com o botão direito do mouse no nó-raiz da janela Navegador e escolha Recarregar Form (se preferir, pressione Ctrl-R).
+
+[start=10]
+. Clique em Salvar na caixa de diálogo Pergunta que é exibida.
O form é reaberto e a configuração regional Espanhol é carregada no design, como mostrado abaixo:
[.feature]
@@ -170,8 +196,12 @@ image::images/finddialog_es_new_small.png[role="left", link="images/finddialog_e
image::images/prjproperties_small.png[role="left", link="images/prjproperties.png"]
--
-4. Clique em OK.
-5. Clique com o botão direito do mouse no nó do projeto InternationalizeDemo e escolha Executar.
+
+[start=4]
+. Clique em OK.
+
+[start=5]
+. Clique com o botão direito do mouse no nó do projeto InternationalizeDemo e escolha Executar.
O IDE executa a caixa de diálogo ``FindDialog`` na configuração regional Espanhol, como mostrado abaixo.
@@ -226,25 +256,39 @@ Os arquivos de código-fonte aparecem na primeira página do assistente, como mo
image::images/i18nwizardone_small.png[role="left", link="images/i18nwizardone.png"]
--
-5. Para fins de demonstração, selecione ``examples.Find.`` e clique no botão Remover Código-fonte.
-6. Clique em Próximo.
-7. Verifique se o Assistente de Internacionalização oferece os arquivos de propriedades corretos ``examples.Antenna`` e ``examples.ContactEditor`` . Caso não ofereça, use o botão Selecionar Recurso para escolher o arquivo de propriedades correto.
+
+[start=5]
+. Para fins de demonstração, selecione ``examples.Find.`` e clique no botão Remover Código-fonte.
+
+[start=6]
+. Clique em Próximo.
+
+[start=7]
+. Verifique se o Assistente de Internacionalização oferece os arquivos de propriedades corretos ``examples.Antenna`` e ``examples.ContactEditor`` . Caso não ofereça, use o botão Selecionar Recurso para escolher o arquivo de propriedades correto.
[.feature]
--
image::images/i18nwizardtwo_small.png[role="left", link="images/i18nwizardtwo.png"]
--
-8. Clique em Próximo.
-9. Pule a página 3 do Assistente, pois você não criará quaisquer campos nem modificará valores adicionais, e clique em Próximo.
-10. Todas as strings codificadas são exibidas na última etapa do Assistente de internacionalização e é possível decidir quais delas virão do arquivo de propriedades (use a caixa de seleção). Você pode personalizar ainda mais comentários, valores, chaves individuais e o formato de strings substituídas clicando no botão de reticências (...) de uma string.
+
+[start=8]
+. Clique em Próximo.
+
+[start=9]
+. Pule a página 3 do Assistente, pois você não criará quaisquer campos nem modificará valores adicionais, e clique em Próximo.
+
+[start=10]
+. Todas as strings codificadas são exibidas na última etapa do Assistente de internacionalização e é possível decidir quais delas virão do arquivo de propriedades (use a caixa de seleção). Você pode personalizar ainda mais comentários, valores, chaves individuais e o formato de strings substituídas clicando no botão de reticências (...) de uma string.
[.feature]
--
image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthree.png"]
--
-11. Clique em Finalizar.
+
+[start=11]
+. Clique em Finalizar.
Agora, que a internacionalização do código-fonte está finalizada, outra configuração regional pode ser <<newlocale,adicionada>> e <<testlocale,testada>>, como mostrado anteriormente.
@@ -262,10 +306,18 @@ Neste último exercício, nós reutilizaremos o projeto de exemplos de forms de
O IDE mostra a caixa de diálogo Internacionalização e faz um preenchimento prévio da primeira string codificada do código-fonte ``Find.java`` .
-2. Clique em Selecionar para selecionar um arquivo de propriedades particular ou crie um novo.
-3. Na caixa de diálogo Selecionar Pacote de Recursos , digite ``Find.properties`` no campo de texto Nome do Arquivo, clique em Criar Novo e, em seguida, em OK.
-4. Você pode modificar o formato da string substituída, a chave, o valor ou o comentário, se necessário. Nós manteremos os valores default.
-5. Clique em Substituir para confirmar a alteração e mover um foco na próxima string codificada.
+
+[start=2]
+. Clique em Selecionar para selecionar um arquivo de propriedades particular ou crie um novo.
+
+[start=3]
+. Na caixa de diálogo Selecionar Pacote de Recursos , digite ``Find.properties`` no campo de texto Nome do Arquivo, clique em Criar Novo e, em seguida, em OK.
+
+[start=4]
+. Você pode modificar o formato da string substituída, a chave, o valor ou o comentário, se necessário. Nós manteremos os valores default.
+
+[start=5]
+. Clique em Substituir para confirmar a alteração e mover um foco na próxima string codificada.
Se uma string codificada não precisar ser substituída, clique no botão Ignorar.
@@ -281,8 +333,12 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
O IDE abre o arquivo ``Find.java`` no Editor de Código-fonte.
-2. Role pelo código-fonte e localize o método principal.
-3. Insira a seguinte linha em negrito no método principal:
+
+[start=2]
+. Role pelo código-fonte e localize o método principal.
+
+[start=3]
+. Insira a seguinte linha em negrito no método principal:
[source,xml]
----
@@ -319,15 +375,25 @@ O IDE abre o arquivo ``Find.java`` no Editor de Código-fonte.
});
}
----
-4. Coloque o cursor do mouse em parênteses em ``System.out.println();`` de forma que uma string internacionalizada seja inserida como um parâmetro.
-5. Pressione Ctrl-Shift-J para chamar a caixa de diálogo Inserir String Internacionalizada (se preferir, é possível escolher Ferramentas > Internacionalização > Inserir String Internacionalizada no menu principal).
-6. Para o Nome do Pacote, clique no botão Selecionar, selecione a pasta ``Pacotes de Código-fonte > exemplos`` e insira ``Localizar`` como o Nome do pacote no campo de texto Nome do Arquivo. Em seguida, clique em OK.
+
+[start=4]
+. Coloque o cursor do mouse em parênteses em ``System.out.println();`` de forma que uma string internacionalizada seja inserida como um parâmetro.
+
+[start=5]
+. Pressione Ctrl-Shift-J para chamar a caixa de diálogo Inserir String Internacionalizada (se preferir, é possível escolher Ferramentas > Internacionalização > Inserir String Internacionalizada no menu principal).
+
+[start=6]
+. Para o Nome do Pacote, clique no botão Selecionar, selecione a pasta ``Pacotes de Código-fonte > exemplos`` e insira ``Localizar`` como o Nome do pacote no campo de texto Nome do Arquivo. Em seguida, clique em OK.
O campo Nome do Pacote da caixa de diálogo Inserir String Internacionalizada mostra ``examples.Find`` .
-7. Digite ``Iniciar`` na caixa drop-down Chave e ``Iniciar caixa de diálogo Localizar`` no campo Valor. Em seguida, clique em OK.
+
+[start=7]
+. Digite ``Iniciar`` na caixa drop-down Chave e ``Iniciar caixa de diálogo Localizar`` no campo Valor. Em seguida, clique em OK.
image::images/insi18nstring.png[]
-8. O IDE insere uma string internacionalizada:
+
+[start=8]
+. O IDE insere uma string internacionalizada:
[source,xml]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ru.asciidoc
index 7127adc..841806c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_ru.asciidoc
@@ -80,11 +80,15 @@ image::images/finddialog_ai18n.png[]
image::images/navigator.png[]
-2. В окне Properties ("Свойства") установите флажок для свойства Automatic Internationalization ("Автоматическая интернационализация").
+
+[start=2]
+. В окне Properties ("Свойства") установите флажок для свойства Automatic Internationalization ("Автоматическая интернационализация").
image::images/properties.png[]
-3. Нажмите кнопку Upgrade ("Обновить") в диалоговом окне GUI Form Format Upgrade ("Обновление формата формы графического интерфейса").
+
+[start=3]
+. Нажмите кнопку Upgrade ("Обновить") в диалоговом окне GUI Form Format Upgrade ("Обновление формата формы графического интерфейса").
Если флажок установлен, среда IDE создаст файл ``Bundle.properties`` в пакете ``demo`` , поскольку он установлен в свойстве ``Properties Bundle File`` ("Файл набора свойств").
@@ -92,11 +96,15 @@ image::images/bundle_new.png[]
Если нужно, чтобы файл ``Bundle.properties`` находился в другом месте, можно нажать расположенную справа кнопку обзора (...) и выбрать местоположение, либо ввести путь непосредственно в текстовом поле свойства.
-4. В окне 'Проекты' дважды щелкните узел ``Bundle.properties`` в окне 'Проекты' или щелкните правой кнопкой мыши узел и выберите 'Правка'.
+
+[start=4]
+. В окне 'Проекты' дважды щелкните узел ``Bundle.properties`` в окне 'Проекты' или щелкните правой кнопкой мыши узел и выберите 'Правка'.
Файл свойств откроется в редакторе исходного кода. Как можно увидеть, созданы все необходимые ключи и значения для формы ``FindDialog.java`` . (Имя каждого из ключей является производным от имени файла формы и имени переменной компонента. Например, ключ ``FindDialog.jLabel1.text`` создан из компонента с именем переменной ``jLabel1`` , который помещен в файл формы ``FindDialog`` . Значение ``jLabel1`` представляет в данном примере свойство Text ("Текст") компонента.
-5. Закройте файл ``Bundle.properties`` .
+
+[start=5]
+. Закройте файл ``Bundle.properties`` .
=== Интернационализация отдельных компонентов графического интерфейса
@@ -108,9 +116,15 @@ image::images/bundle_new.png[]
*Примечание.* Также можно интернационализовать другие свойства, содержащие строковые значения, такие как Mnemonic, Accessible Name, Accessible Descriptor и ToolTip.
-3. Редактор свойств переключен в режим набора ресурсов. Убедитесь, что в поле Bundle Name ("Имя набора") введено ``demo.Bundle`` , а поле Key ("Ключ") содержит строку ``FindDialog.jLabel1.text``
-4. Введите ``Find What:`` в поле Value ("Значение").
-5. Нажмите кнопку "ОК".
+
+[start=3]
+. Редактор свойств переключен в режим набора ресурсов. Убедитесь, что в поле Bundle Name ("Имя набора") введено ``demo.Bundle`` , а поле Key ("Ключ") содержит строку ``FindDialog.jLabel1.text``
+
+[start=4]
+. Введите ``Find What:`` в поле Value ("Значение").
+
+[start=5]
+. Нажмите кнопку "ОК".
Повторите вышеприведенные действия для всех компонентов, чтобы форма выглядела подобно следующей иллюстрации:
@@ -139,18 +153,30 @@ image::images/finddialog_new_small.png[role="left", link="images/finddialog_new.
image::images/addlocale_new.png[]
-5. В окне 'Проекты' щелкните правой кнопкой мыши ``Bundle.properties`` и выберите 'Открыть'.
-6. Переведите отдельные сообщения в соответствующем столбце таблицы на новый (например, испанский) язык, как показано ниже:
+
+[start=5]
+. В окне 'Проекты' щелкните правой кнопкой мыши ``Bundle.properties`` и выберите 'Открыть'.
+
+[start=6]
+. Переведите отдельные сообщения в соответствующем столбце таблицы на новый (например, испанский) язык, как показано ниже:
[.feature]
--
image::images/bundles_new_small.png[role="left", link="images/bundles_new.png"]
--
-7. Нажмите Ctrl+S для сохранения изменений.
-8. Выберите вкладку ``FindDialog.java`` для отображения интернационализируемой формы.
-9. Щелкните правой кнопкой мыши корневой узел в окне 'Навигатор' и выберите 'Перезагрузить форму' (или нажмите Ctrl+R).
-10. Выберите Save ("Сохранить") в отобразившемся диалоговом окне Question ("Вопрос").
+
+[start=7]
+. Нажмите Ctrl+S для сохранения изменений.
+
+[start=8]
+. Выберите вкладку ``FindDialog.java`` для отображения интернационализируемой формы.
+
+[start=9]
+. Щелкните правой кнопкой мыши корневой узел в окне 'Навигатор' и выберите 'Перезагрузить форму' (или нажмите Ctrl+R).
+
+[start=10]
+. Выберите Save ("Сохранить") в отобразившемся диалоговом окне Question ("Вопрос").
Форма будет открыта заново и в проект будет загружена испанская локаль, как показано ниже:
[.feature]
@@ -170,8 +196,12 @@ image::images/finddialog_es_new_small.png[role="left", link="images/finddialog_e
image::images/prjproperties_small.png[role="left", link="images/prjproperties.png"]
--
-4. Нажмите кнопку "ОК".
-5. Щелкните правой кнопкой мыши проект InternationalizeDemo и выберите Run ("Запустить").
+
+[start=4]
+. Нажмите кнопку "ОК".
+
+[start=5]
+. Щелкните правой кнопкой мыши проект InternationalizeDemo и выберите Run ("Запустить").
Среда IDE запустит диалоговое окно ``FindDialog`` на испанском, как показано ниже.
@@ -226,25 +256,39 @@ image::images/ceprjprops.png[]
image::images/i18nwizardone_small.png[role="left", link="images/i18nwizardone.png"]
--
-5. Для демонстрации выберите ``examples.Find`` и нажмите кнопку Remove Source(s) ("Удалить источник(и)").
-6. Нажмите кнопку "Далее".
-7. Убедитесь, что мастер интернационализации предлагает верные файлы свойств: ``examples.Antenna`` и ``examples.ContactEditor`` . Если это не так, используйте кнопку Select Resource ("Выбор ресурса") для выбора верного файла свойств.
+
+[start=5]
+. Для демонстрации выберите ``examples.Find`` и нажмите кнопку Remove Source(s) ("Удалить источник(и)").
+
+[start=6]
+. Нажмите кнопку "Далее".
+
+[start=7]
+. Убедитесь, что мастер интернационализации предлагает верные файлы свойств: ``examples.Antenna`` и ``examples.ContactEditor`` . Если это не так, используйте кнопку Select Resource ("Выбор ресурса") для выбора верного файла свойств.
[.feature]
--
image::images/i18nwizardtwo_small.png[role="left", link="images/i18nwizardtwo.png"]
--
-8. Нажмите кнопку "Далее".
-9. Пропустите страницу 3 мастера, поскольку мы не будем заниматься здесь созданием полей и изменением дополнительных значений и нажмите кнопку Next ("Далее").
-10. Все жестко определенные строки отображаются на последнем этапе работы с мастером интернационализации. Здесь можно определить, какие из них будут исходить из файла свойств (используйте флажок). Можно также осуществлять дополнительную настройку отдельных ключей, значений и формата замененных строк, нажимая на кнопку многоточия (...) для нужной строки.
+
+[start=8]
+. Нажмите кнопку "Далее".
+
+[start=9]
+. Пропустите страницу 3 мастера, поскольку мы не будем заниматься здесь созданием полей и изменением дополнительных значений и нажмите кнопку Next ("Далее").
+
+[start=10]
+. Все жестко определенные строки отображаются на последнем этапе работы с мастером интернационализации. Здесь можно определить, какие из них будут исходить из файла свойств (используйте флажок). Можно также осуществлять дополнительную настройку отдельных ключей, значений и формата замененных строк, нажимая на кнопку многоточия (...) для нужной строки.
[.feature]
--
image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthree.png"]
--
-11. Нажмите кнопку "Завершить".
+
+[start=11]
+. Нажмите кнопку "Завершить".
Теперь интернационализация исходного кода завершена, и можно <<newlocale,добавлять>> и <<testlocale,тестировать>> локали, как было показано ранее.
@@ -262,10 +306,18 @@ image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthre
В среде IDE отображается диалоговое окно Internationalization ("Интернационализация"), в которое автоматически вставляется первая жестко определенная строка из исходного кода ``Find.java`` .
-2. Нажмите кнопку Select ("Выбор"), чтобы выбрать определенный файл свойств или создать новый.
-3. В диалоговом окне 'Выбор пакета ресурсов' в поле 'Имя файла' введите ``Find.properties`` , нажмите 'Создать' и ОК.
-4. Формат замененной строки, ключа, значения или комментария при необходимости можно заменить. Мы просто оставим значения по умолчанию.
-5. Нажмите кнопку Replace ("Замена"), чтобы подтвердить изменение, и переместите фокус на следующую жестко определенную строку.
+
+[start=2]
+. Нажмите кнопку Select ("Выбор"), чтобы выбрать определенный файл свойств или создать новый.
+
+[start=3]
+. В диалоговом окне 'Выбор пакета ресурсов' в поле 'Имя файла' введите ``Find.properties`` , нажмите 'Создать' и ОК.
+
+[start=4]
+. Формат замененной строки, ключа, значения или комментария при необходимости можно заменить. Мы просто оставим значения по умолчанию.
+
+[start=5]
+. Нажмите кнопку Replace ("Замена"), чтобы подтвердить изменение, и переместите фокус на следующую жестко определенную строку.
Если жестко определенная строка не требует замены, нажмите кнопку Skip ("Пропуск").
@@ -281,8 +333,12 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
Среда IDE откроет файл ``Find.java`` в редакторе исходного кода.
-2. Найдите в исходном коде главный метод.
-3. Вставьте следующую строку, выделенную жирным шрифтом, в главный метод:
+
+[start=2]
+. Найдите в исходном коде главный метод.
+
+[start=3]
+. Вставьте следующую строку, выделенную жирным шрифтом, в главный метод:
[source,xml]
----
@@ -319,15 +375,25 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
});
}
----
-4. Поместите курсор в скобках выражения ``System.out.println();`` и вставьте интернационализированную строку как параметр.
-5. Нажмите Ctrl-Shift-J для вызова диалогового окна Insert Internationalized String ("Вставить интернационализированную строку") (как вариант, можно выбрать Tools ("Сервис") > Internationalization ("Интернационализация") > Insert Internationalized String ("Вставить интернационализированную строку") из главного меню).
-6. Для ввода имени набора нажмите кнопку Select ("Выбор"), выберите ``Source Packages ("Исходные пакеты") > папку`` примеров и введите ``Find`` в качестве имя набора в текстовое поле File Name ("Имя файла"). После этого нажмите кнопку OK.
+
+[start=4]
+. Поместите курсор в скобках выражения ``System.out.println();`` и вставьте интернационализированную строку как параметр.
+
+[start=5]
+. Нажмите Ctrl-Shift-J для вызова диалогового окна Insert Internationalized String ("Вставить интернационализированную строку") (как вариант, можно выбрать Tools ("Сервис") > Internationalization ("Интернационализация") > Insert Internationalized String ("Вставить интернационализированную строку") из главного меню).
+
+[start=6]
+. Для ввода имени набора нажмите кнопку Select ("Выбор"), выберите ``Source Packages ("Исходные пакеты") > папку`` примеров и введите ``Find`` в качестве имя набора в текстовое поле File Name ("Имя файла"). После этого нажмите кнопку OK.
В поле 'Имя пакета' в диалоговом окне 'Вставка интернационализированной строки' отображается ``examples.Find`` .
-7. Введите ``Start`` в раскрывающееся окно Key ("Ключ") и ``Start Find Dialog`` в поле Value ("Значение"). После этого нажмите кнопку OK.
+
+[start=7]
+. Введите ``Start`` в раскрывающееся окно Key ("Ключ") и ``Start Find Dialog`` в поле Value ("Значение"). После этого нажмите кнопку OK.
image::images/insi18nstring.png[]
-8. Среда IDE вставит интернационализированную строку:
+
+[start=8]
+. Среда IDE вставит интернационализированную строку:
[source,xml]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_zh_CN.asciidoc
index 599c829..82c946c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-automatic-i18n_zh_CN.asciidoc
@@ -80,11 +80,15 @@ image::images/finddialog_ai18n.png[]
image::images/navigator.png[]
-2. 在 "Properties"（属性）窗口中，选中 "Automatic Internationalization"（自动国际化）属性中的复选框。
+
+[start=2]
+. 在 "Properties"（属性）窗口中，选中 "Automatic Internationalization"（自动国际化）属性中的复选框。
image::images/properties.png[]
-3. 在 "GUI Form Format Upgrade"（GUI 窗体格式升级）对话框中，单击 "Upgrade"（升级）。
+
+[start=3]
+. 在 "GUI Form Format Upgrade"（GUI 窗体格式升级）对话框中，单击 "Upgrade"（升级）。
如果选中该复选框，则 IDE 将按照 ``Properties Bundle File`` （属性包文件）属性中的设置在 ``demo`` 包中创建 ``Bundle.properties`` 文件。
@@ -92,11 +96,15 @@ image::images/bundle_new.png[]
如果您需要在其他位置创建 ``Bundle.properties`` 文件，则可以单击 "Properties Bundle File"（属性包文件）右侧的省略号 (...) 按钮，然后选择一个位置，或者直接在该属性的文本字段中键入路径。
-4. 在 "Projects"（项目）窗口中，双击 ``Bundle.properties`` 节点，或者右键单击该节点，然后选择 "Edit"（编辑）。
+
+[start=4]
+. 在 "Projects"（项目）窗口中，双击 ``Bundle.properties`` 节点，或者右键单击该节点，然后选择 "Edit"（编辑）。
将在源代码编辑器中打开该属性文件。正如您所看到的，将为窗体 ``FindDialog.java`` 生成所有相应的键和值。（每个键的名称是从窗体文件名和组件变量名派生的。例如，键 ``FindDialog.jLabel1.text`` 是为窗体文件 ``FindDialog`` 中包含的变量名为 ``jLabel1`` 的组件生成的。在此示例中，值 ``jLabel1`` 表示组件的 "text" 属性。
-5. 关闭 ``Bundle.properties`` 文件。
+
+[start=5]
+. 关闭 ``Bundle.properties`` 文件。
=== 国际化各个 GUI 组件
@@ -108,9 +116,15 @@ image::images/bundle_new.png[]
*注：*您还可以对具有字符串值的其他属性进行国际化，例如助记符、可访问的名称、可访问的描述符和工具提示。
-3. 属性编辑器将切换至资源包模式。检查 "Bundle Name"（包名）字段是否设置为 ``demo.Bundle`` ，以及 "Key"（键）字段是否包含字符串 ``FindDialog.jLabel1.text`` 。
-4. 在 "Value"（值）字段中键入 ``Find What:`` 。
-5. 单击 "OK"（确定）。
+
+[start=3]
+. 属性编辑器将切换至资源包模式。检查 "Bundle Name"（包名）字段是否设置为 ``demo.Bundle`` ，以及 "Key"（键）字段是否包含字符串 ``FindDialog.jLabel1.text`` 。
+
+[start=4]
+. 在 "Value"（值）字段中键入 ``Find What:`` 。
+
+[start=5]
+. 单击 "OK"（确定）。
对所有组件重复执行以上步骤，使该窗体如下图所示：
@@ -139,18 +153,30 @@ image::images/finddialog_new_small.png[role="left", link="images/finddialog_new.
image::images/addlocale_new.png[]
-5. 在 "Projects"（项目）窗口中，右键单击 ``Bundle.properties`` ，然后选择 "Open"（打开）。
-6. 将相应表列中的各条消息转换为新语言（例如西班牙语），如下所示：
+
+[start=5]
+. 在 "Projects"（项目）窗口中，右键单击 ``Bundle.properties`` ，然后选择 "Open"（打开）。
+
+[start=6]
+. 将相应表列中的各条消息转换为新语言（例如西班牙语），如下所示：
[.feature]
--
image::images/bundles_new_small.png[role="left", link="images/bundles_new.png"]
--
-7. 按 Ctrl-S 组合键保存所做的编辑。
-8. 选择 ``FindDialog.java`` 标签，以显示要国际化的窗体。
-9. 在 "Navigator"（导航器）窗口中右键单击根节点，然后选择 "Reload Form"（重新加载窗体）（或者，按 Ctrl-R 组合键）。
-10. 在显示的 "Question"（问题）对话框中单击 "Save"（保存）。
+
+[start=7]
+. 按 Ctrl-S 组合键保存所做的编辑。
+
+[start=8]
+. 选择 ``FindDialog.java`` 标签，以显示要国际化的窗体。
+
+[start=9]
+. 在 "Navigator"（导航器）窗口中右键单击根节点，然后选择 "Reload Form"（重新加载窗体）（或者，按 Ctrl-R 组合键）。
+
+[start=10]
+. 在显示的 "Question"（问题）对话框中单击 "Save"（保存）。
将重新打开该窗体，并在设计区域中加载西班牙语语言环境，如下所示：
[.feature]
@@ -170,8 +196,12 @@ image::images/finddialog_es_new_small.png[role="left", link="images/finddialog_e
image::images/prjproperties_small.png[role="left", link="images/prjproperties.png"]
--
-4. 单击 "OK"（确定）。
-5. 右键单击 "InternationalizeDemo" 项目，然后选择 "Run"（运行）。
+
+[start=4]
+. 单击 "OK"（确定）。
+
+[start=5]
+. 右键单击 "InternationalizeDemo" 项目，然后选择 "Run"（运行）。
IDE 将在西班牙语语言环境中运行 ``FindDialog`` 对话框，如下所示。
@@ -226,25 +256,39 @@ image::images/ceprjprops.png[]
image::images/i18nwizardone_small.png[role="left", link="images/i18nwizardone.png"]
--
-5. 为了便于演示，选择 ``examples.Find`` ，然后单击 "Remove Source(s)"（删除源）按钮。
-6. 单击 "Next"（下一步）。
-7. 检查国际化向导是否提供了正确的属性文件 ``examples.Antenna`` 和 ``examples.ContactEditor`` 。如果未提供，请使用 "Select Resource"（选择资源）按钮来选择正确的属性文件。
+
+[start=5]
+. 为了便于演示，选择 ``examples.Find`` ，然后单击 "Remove Source(s)"（删除源）按钮。
+
+[start=6]
+. 单击 "Next"（下一步）。
+
+[start=7]
+. 检查国际化向导是否提供了正确的属性文件 ``examples.Antenna`` 和 ``examples.ContactEditor`` 。如果未提供，请使用 "Select Resource"（选择资源）按钮来选择正确的属性文件。
[.feature]
--
image::images/i18nwizardtwo_small.png[role="left", link="images/i18nwizardtwo.png"]
--
-8. 单击 "Next"（下一步）。
-9. 跳过该向导的第 3 页（因为您不打算创建任何字段并修改其他值），然后单击 "Next"（下一步）。
-10. 所有固定编码字符串都将显示在国际化向导的最后一步中，您可以在该步中确定将哪些字符串包含在属性文件中（使用复选框）。您也可以进一步定制各个键、值、注释和替换字符串的格式，方法是单击字符串的省略号 (...) 按钮。
+
+[start=8]
+. 单击 "Next"（下一步）。
+
+[start=9]
+. 跳过该向导的第 3 页（因为您不打算创建任何字段并修改其他值），然后单击 "Next"（下一步）。
+
+[start=10]
+. 所有固定编码字符串都将显示在国际化向导的最后一步中，您可以在该步中确定将哪些字符串包含在属性文件中（使用复选框）。您也可以进一步定制各个键、值、注释和替换字符串的格式，方法是单击字符串的省略号 (...) 按钮。
[.feature]
--
image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthree.png"]
--
-11. 单击 "Finish"（完成）。
+
+[start=11]
+. 单击 "Finish"（完成）。
现在，已完成源代码的国际化，接下来可以按照先前所述<<newlocale,添加>>和<<testlocale,测试>>其他语言环境。
@@ -262,10 +306,18 @@ image::images/i18nwizardthree_small.png[role="left", link="images/i18nwizardthre
IDE 将显示 "Internationalization"（国际化）对话框，并预先填写 ``Find.java`` 源代码中的第一个固定编码字符串。
-2. 单击 "Select"（选择）以选择特定的属性文件，或者创建新文件。
-3. 在 "Select Resource Bundle"（选择资源包）对话框中，在 "File Name"（文件名）文本字段中输入 ``Find.properties`` ，单击 "Create New"（新建），然后单击 "OK"（确定）。
-4. 您可以修改替换字符串的格式、键、值或注释（如有必要）。我们将仅保留默认值。
-5. 单击 "Replace"（替换）以确认更改，并将焦点移到下一个固定编码字符串上。
+
+[start=2]
+. 单击 "Select"（选择）以选择特定的属性文件，或者创建新文件。
+
+[start=3]
+. 在 "Select Resource Bundle"（选择资源包）对话框中，在 "File Name"（文件名）文本字段中输入 ``Find.properties`` ，单击 "Create New"（新建），然后单击 "OK"（确定）。
+
+[start=4]
+. 您可以修改替换字符串的格式、键、值或注释（如有必要）。我们将仅保留默认值。
+
+[start=5]
+. 单击 "Replace"（替换）以确认更改，并将焦点移到下一个固定编码字符串上。
如果不需要替换固定编码字符串，请单击 "Skip"（跳过）按钮。
@@ -281,8 +333,12 @@ image::images/i18ndialog_small.png[role="left", link="images/i18ndialog.png"]
IDE 将在源代码编辑器中打开 ``Find.java`` 文件。
-2. 滚动查看源代码并查找 main 方法。
-3. 在 main 方法中插入以下用粗体显示的行：
+
+[start=2]
+. 滚动查看源代码并查找 main 方法。
+
+[start=3]
+. 在 main 方法中插入以下用粗体显示的行：
[source,xml]
----
@@ -319,15 +375,25 @@ IDE 将在源代码编辑器中打开 ``Find.java`` 文件。
});
}
----
-4. 将鼠标光标放在 ``System.out.println();`` 的圆括号内，以便作为参数插入国际化字符串。
-5. 按 Ctrl-Shift-J 组合键调用 "Insert Internationalized String"（插入国际化字符串）对话框（也可以从主菜单中选择 "Tools"（工具）> "Internationalization"（国际化）> "Insert Internationalized String"（插入国际化字符串））。
-6. 对于 "Bundle Name"（包名），单击 "Select"（选择）按钮，选择 ``"Source Packages"（源包）> "Examples"（样例）`` 文件夹，然后在 "File Name"（文件名）文本字段中输入 ``Find`` 作为包名。然后，单击 "OK"（确定）。
+
+[start=4]
+. 将鼠标光标放在 ``System.out.println();`` 的圆括号内，以便作为参数插入国际化字符串。
+
+[start=5]
+. 按 Ctrl-Shift-J 组合键调用 "Insert Internationalized String"（插入国际化字符串）对话框（也可以从主菜单中选择 "Tools"（工具）> "Internationalization"（国际化）> "Insert Internationalized String"（插入国际化字符串））。
+
+[start=6]
+. 对于 "Bundle Name"（包名），单击 "Select"（选择）按钮，选择 ``"Source Packages"（源包）> "Examples"（样例）`` 文件夹，然后在 "File Name"（文件名）文本字段中输入 ``Find`` 作为包名。然后，单击 "OK"（确定）。
"Insert Internationalized String"（插入国际化字符串）对话框的 "Bundle Name"（包名称）字段显示 ``examples.Find`` 。
-7. 在 "Key"（键）下拉框中键入 ``Start`` ，并在 "Value"（值）字段中键入 ``Start Find Dialog`` 。然后，单击 "OK"（确定）。
+
+[start=7]
+. 在 "Key"（键）下拉框中键入 ``Start`` ，并在 "Value"（值）字段中键入 ``Start Find Dialog`` 。然后，单击 "OK"（确定）。
image::images/insi18nstring.png[]
-8. IDE 将插入国际化字符串：
+
+[start=8]
+. IDE 将插入国际化字符串：
[source,xml]
----
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-binding.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-binding.asciidoc
index 1e3b94a..dd2f230 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-binding.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-binding.asciidoc
@@ -75,12 +75,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
--
* Clear the Create Main Class checkbox.
-4. Click Finish to exit the wizard and set up the project.
-5. In the Projects window, right-click the NumberSlider project node and choose New > JFrame Form.
+
+[start=4]
+. Click Finish to exit the wizard and set up the project.
+
+[start=5]
+. In the Projects window, right-click the NumberSlider project node and choose New > JFrame Form.
(If JFrame Form is not available in the New menu, choose Other. Then in the New File wizard, select the Swing GUI Forms category and select the JFrame Form template.)
-6. In the Name and Location page of the wizard, perform the following operations:
+
+[start=6]
+. In the Name and Location page of the wizard, perform the following operations:
* Type ``NumberSliderFrame`` for the class name.
* Type ``numberslider`` for the package name.
@@ -89,12 +95,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
image::images/numberslider2-small.png[role="left", link="images/numberslider2.png"]
--
-7. Click Finish to exit the wizard and create the form.
+
+[start=7]
+. Click Finish to exit the wizard and create the form.
``NumberSliderFrame.java`` should open in design mode in the editing area.
-8. From the Swing Controls section of the Palette, drag a slider component into the design area. (If the Palette window is not open, choose Window > Palette.)
-9. From the Palette, drag a text field component to the design area.
+
+[start=8]
+. From the Swing Controls section of the Palette, drag a slider component into the design area. (If the Palette window is not open, choose Window > Palette.)
+
+[start=9]
+. From the Palette, drag a text field component to the design area.
The resulting form might look something like the screenshot below. However, positioning is not important for purposes of this example.
@@ -125,7 +137,9 @@ NOTE: Bindings can be two-way (read/write), so that changes in the target are au
image::images/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. Click OK.
+
+[start=4]
+. Click OK.
You have just bound the ``value`` bean property of the slider to the ``text`` value of the text field.
@@ -226,15 +240,21 @@ Before binding a component to data from a database, you need to have done the fo
image::images/entity-wizard1-small.png[role="left", link="images/entity-wizard1.png"]
--
-4. In the Entity Classes page of the wizard, make sure the Generate Named Query Annotations for Persistent Fields and Create Persistence Unit checkboxes are selected.
+
+[start=4]
+. In the Entity Classes page of the wizard, make sure the Generate Named Query Annotations for Persistent Fields and Create Persistence Unit checkboxes are selected.
[.feature]
--
image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.png"]
--
-5. Make any customizations that you want to make to the names of the generated classes and their location.
-6. Click Finish.
+
+[start=5]
+. Make any customizations that you want to make to the names of the generated classes and their location.
+
+[start=6]
+. Click Finish.
You should see nodes for the entity classes in the Projects window.
@@ -251,8 +271,12 @@ This section shows you how you can bind data to JTable, JList, and JComboBox com
NOTE: The tutorial uses the ``sample [app on App]`` database that can be connected to by selecting the Services window, expanding the Databases node, right-clicking the database connection node ( ``jdbc:derby://localhost:1527/sample[app on APP]`` ), and choosing Connect from the context menu.
Specify ``app`` as a userid and ``app`` as a password, if you are prompted for a userid and password.
-3. Expand the node for the connection, and expand its Tables node.
-4. Drag the node for the table on to the form and press Ctrl as you drop the table.
+
+[start=3]
+. Expand the node for the connection, and expand its Tables node.
+
+[start=4]
+. Drag the node for the table on to the form and press Ctrl as you drop the table.
A JTable is created and its columns are bound to the columns in the database table.
@@ -265,18 +289,30 @@ A JTable is created and its columns are bound to the columns in the database tab
image::images/bind-dialog-table-small.png[role="left", link="images/bind-dialog-table.png"]
--
-2. Click Import Data to Form. From the Import Data to Form dialog box, select the database table to which you want to bind your components. Click OK.
-3. From the Binding Source combo box, select the item that represents the result list of the entity class. For example, if the entity class is called, ``Customer.java`` , the list object would be generated as ``customerList`` .
+
+[start=2]
+. Click Import Data to Form. From the Import Data to Form dialog box, select the database table to which you want to bind your components. Click OK.
+
+[start=3]
+. From the Binding Source combo box, select the item that represents the result list of the entity class. For example, if the entity class is called, ``Customer.java`` , the list object would be generated as ``customerList`` .
[.feature]
--
image::images/source-selected-small.png[role="left", link="images/source-selected.png"]
--
-4. Leave the Binding Expression value as ``null`` .
-5. If there are any database columns that you do not want to appear in the JTable, select those columns in the Selected list and move them to the Available list.
-6. Select the Advanced tab to further configure the binding. For example, you can specify a validator or converter, or you can specify behavior if the binding source is null or unreadable.
-7. Click OK.
+
+[start=4]
+. Leave the Binding Expression value as ``null`` .
+
+[start=5]
+. If there are any database columns that you do not want to appear in the JTable, select those columns in the Selected list and move them to the Available list.
+
+[start=6]
+. Select the Advanced tab to further configure the binding. For example, you can specify a validator or converter, or you can specify behavior if the binding source is null or unreadable.
+
+[start=7]
+. Click OK.
*To bind the data to a JList component:*
@@ -289,10 +325,18 @@ image::images/source-selected-small.png[role="left", link="images/source-selecte
image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.png"]
--
-4. Leave the Binding Expression value as ``null`` .
-5. In the Display Expression drop-down list, select the property that represents the database column that contains the values that you want to display in the list.
-6. Select the Advanced tab to further configure the binding.
-7. Click OK.
+
+[start=4]
+. Leave the Binding Expression value as ``null`` .
+
+[start=5]
+. In the Display Expression drop-down list, select the property that represents the database column that contains the values that you want to display in the list.
+
+[start=6]
+. Select the Advanced tab to further configure the binding.
+
+[start=7]
+. Click OK.
*To bind the data to a JComboBox component:*
@@ -305,13 +349,21 @@ image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.pn
image::images/combo-binding-small.png[role="left", link="images/combo-binding.png"]
--
-4. Leave the Binding Expression value as ``null`` and click OK.
-5. Right-click the combo box again and choose Bind > selectedItem.
-6. Bind to the property that you want to be affected by the user selection.
+
+[start=4]
+. Leave the Binding Expression value as ``null`` and click OK.
+
+[start=5]
+. Right-click the combo box again and choose Bind > selectedItem.
+
+[start=6]
+. Bind to the property that you want to be affected by the user selection.
image::images/combo-item.png[]
-7. Click OK to save your edits.
+
+[start=7]
+. Click OK to save your edits.
The Beans Binding library (as of version 1.2.1) does not have a DetailBinding class that enables you to specify how to derive the _display_ values for the JComboBox. So you will need to write some custom code. One approach is to write a custom cell renderer, as shown below.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ja.asciidoc
index 46fe80b..4884d07 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ja.asciidoc
@@ -75,12 +75,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
--
* 「メイン・クラスの作成」チェックボックスを選択解除します。
-4. 「終了」をクリックしてウィザードを終了し、プロジェクトを設定します。
-5. 「プロジェクト」ウィンドウで「NumberSlider」プロジェクト・ノードを右クリックし、「新規」>「JFrameフォーム」を選択します。
+
+[start=4]
+. 「終了」をクリックしてウィザードを終了し、プロジェクトを設定します。
+
+[start=5]
+. 「プロジェクト」ウィンドウで「NumberSlider」プロジェクト・ノードを右クリックし、「新規」>「JFrameフォーム」を選択します。
(「JFrameフォーム」が「新規」メニューにない場合は、「その他」を選択します。次に、新規ファイル・ウィザードで「Swing GUIフォーム」カテゴリを選択してから「JFrameフォーム」テンプレートを選択します。)
-6. ウィザードの名前と場所ページで、次の操作を行います。
+
+[start=6]
+. ウィザードの名前と場所ページで、次の操作を行います。
* クラス名に「 ``NumberSliderFrame`` 」と入力します。
* パッケージ名に「 ``numberslider`` 」と入力します。
@@ -89,12 +95,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
image::images/numberslider2-small.png[role="left", link="images/numberslider2.png"]
--
-7. 「終了」をクリックしてウィザードを終了し、フォームを作成します。
+
+[start=7]
+. 「終了」をクリックしてウィザードを終了し、フォームを作成します。
``NumberSliderFrame.java`` が編集領域にデザイン・モードで開きます。
-8. パレットの「Swingコントロール」セクションからスライダ・コンポーネントをデザイン領域までドラッグします。「パレット」ウィンドウが開いていない場合は、「ウィンドウ」>「パレット」を選択します。
-9. パレットから、テキスト・フィールド・コンポーネントをデザイン領域までドラッグします。
+
+[start=8]
+. パレットの「Swingコントロール」セクションからスライダ・コンポーネントをデザイン領域までドラッグします。「パレット」ウィンドウが開いていない場合は、「ウィンドウ」>「パレット」を選択します。
+
+[start=9]
+. パレットから、テキスト・フィールド・コンポーネントをデザイン領域までドラッグします。
フォームは次のスクリーンショットのようになります。この例では、配置は重要ではありません。
@@ -125,7 +137,9 @@ GUIエディタでバインディングを行う場合は、ターゲットで
image::images/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. 「OK」をクリックします。
+
+[start=4]
+. 「OK」をクリックします。
これで、スライダの「 ``value`` 」Beanプロパティがテキスト・フィールドの「 ``text`` 」の値にバインドされました。
@@ -226,15 +240,21 @@ image::images/run-numberslider.png[]
image::images/entity-wizard1-small.png[role="left", link="images/entity-wizard1.png"]
--
-4. ウィザードのエンティティ・クラス・ページで、「持続フィールド用のNamedQuery注釈を生成」および「持続性ユニットを作成」チェックボックスが選択されていることを確認します。
+
+[start=4]
+. ウィザードのエンティティ・クラス・ページで、「持続フィールド用のNamedQuery注釈を生成」および「持続性ユニットを作成」チェックボックスが選択されていることを確認します。
[.feature]
--
image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.png"]
--
-5. 生成されたクラスの名前と場所をカスタマイズします。
-6. 「終了」をクリックします。
+
+[start=5]
+. 生成されたクラスの名前と場所をカスタマイズします。
+
+[start=6]
+. 「終了」をクリックします。
「プロジェクト」ウィンドウにエンティティ・クラスのノードが表示されます。
@@ -251,8 +271,12 @@ image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.
*注意:* チュートリアルでは ``sample [app on App]`` データベースを使用します。このデータベースに接続するには、「サービス」ウィンドウを選択して、データベース・ノードを展開し、データベース接続ノード( ``jdbc:derby://localhost:1527/sample[app on APP]`` )を右クリックして、コンテキスト・メニューから「接続」を選択します。
ユーザーIDおよびパスワードを求められたら、 ``app`` をユーザーID、 ``app`` をパスワードとして指定します。
-3. 接続のノードを展開し、「表」ノードを展開します。
-4. 表のノードをフォームにドラッグし、[Ctrl]を押しながら表にドロップします。
+
+[start=3]
+. 接続のノードを展開し、「表」ノードを展開します。
+
+[start=4]
+. 表のノードをフォームにドラッグし、[Ctrl]を押しながら表にドロップします。
JTableが作成され、その列はデータベース表の列にバインドされます。
@@ -265,18 +289,30 @@ JTableが作成され、その列はデータベース表の列にバインド
image::images/bind-dialog-table-small.png[role="left", link="images/bind-dialog-table.png"]
--
-2. 「データをフォームにインポート」をクリックします。「データをフォームにインポート」ダイアログ・ボックスで、コンポーネントをバインドするデータベース表を選択します。「OK」をクリックします。
-3. 「ソースをバインディング」コンボ・ボックスで、エンティティ・クラスの結果リストを表す項目を選択します。たとえば、エンティティ・クラスの名前が ``Customer.java`` の場合、listオブジェクトは ``customerList`` として生成されます。
+
+[start=2]
+. 「データをフォームにインポート」をクリックします。「データをフォームにインポート」ダイアログ・ボックスで、コンポーネントをバインドするデータベース表を選択します。「OK」をクリックします。
+
+[start=3]
+. 「ソースをバインディング」コンボ・ボックスで、エンティティ・クラスの結果リストを表す項目を選択します。たとえば、エンティティ・クラスの名前が ``Customer.java`` の場合、listオブジェクトは ``customerList`` として生成されます。
[.feature]
--
image::images/source-selected-small.png[role="left", link="images/source-selected.png"]
--
-4. 「式をバインディング」の値は「 ``null`` 」のままにしてください。
-5. JTableに表示しないデータベース列がある場合は、「選択」リストでそれらの列を選択して「使用可能」リストに移動します。
-6. さらにバインディングを構成するには、「詳細」タブを選択します。たとえば、バリデータやコンバータを指定したり、バインディング・ソースがnullまたは読取り不能な場合の動作を指定することができます。
-7. 「OK」をクリックします。
+
+[start=4]
+. 「式をバインディング」の値は「 ``null`` 」のままにしてください。
+
+[start=5]
+. JTableに表示しないデータベース列がある場合は、「選択」リストでそれらの列を選択して「使用可能」リストに移動します。
+
+[start=6]
+. さらにバインディングを構成するには、「詳細」タブを選択します。たとえば、バリデータやコンバータを指定したり、バインディング・ソースがnullまたは読取り不能な場合の動作を指定することができます。
+
+[start=7]
+. 「OK」をクリックします。
*データをJListコンポーネントにバインドする*
@@ -289,10 +325,18 @@ image::images/source-selected-small.png[role="left", link="images/source-selecte
image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.png"]
--
-4. 「式をバインディング」の値は「 ``null`` 」のままにしてください。
-5. 「式を表示」ドロップダウン・リストで、リストに表示する値を含むデータベース列を表すプロパティを選択します。
-6. さらにバインディングを構成するには、「詳細」タブを選択します。
-7. 「OK」をクリックします。
+
+[start=4]
+. 「式をバインディング」の値は「 ``null`` 」のままにしてください。
+
+[start=5]
+. 「式を表示」ドロップダウン・リストで、リストに表示する値を含むデータベース列を表すプロパティを選択します。
+
+[start=6]
+. さらにバインディングを構成するには、「詳細」タブを選択します。
+
+[start=7]
+. 「OK」をクリックします。
*データをJComboBoxコンポーネントにバインドする*
@@ -305,13 +349,21 @@ image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.pn
image::images/combo-binding-small.png[role="left", link="images/combo-binding.png"]
--
-4. 「式をバインディング」の値を「 ``null`` 」のままにして、「OK」をクリックします。
-5. コンボ・ボックスをもう一度右クリックし、「バインド」>「selectedItem」を選択します。
-6. ユーザーの選択によって影響の出るプロパティにバインドします。
+
+[start=4]
+. 「式をバインディング」の値を「 ``null`` 」のままにして、「OK」をクリックします。
+
+[start=5]
+. コンボ・ボックスをもう一度右クリックし、「バインド」>「selectedItem」を選択します。
+
+[start=6]
+. ユーザーの選択によって影響の出るプロパティにバインドします。
image::images/combo-item.png[]
-7. 「OK」をクリックして編集を保存します。
+
+[start=7]
+. 「OK」をクリックして編集を保存します。
JComboBoxの_display_値を取得する方法を指定できるDetailBindingクラスは、バージョン1.2.1時点ではBeans Bindingライブラリにありません。このため、カスタム・コードを記述する必要があります。1つの方法として、次に示すようにカスタムのセル・レンダラを記述できます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_pt_BR.asciidoc
index 5cf08c6..7505a3f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_pt_BR.asciidoc
@@ -75,12 +75,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
--
* Desmarque a caixa de seleção Criar Classe Principal.
-4. Clique em Finalizar para sair do assistente e configurar o projeto.
-5. Na janela Projetos, clique com o botão direito do mouse no nó do projeto NumberSlider e selecione Novo > Form JFrame.
+
+[start=4]
+. Clique em Finalizar para sair do assistente e configurar o projeto.
+
+[start=5]
+. Na janela Projetos, clique com o botão direito do mouse no nó do projeto NumberSlider e selecione Novo > Form JFrame.
(Se o form JFrame não estiver disponível no menu Novo, escolha Outro. Em seguida, no assistente para Novo Arquivo, selecione a categoria Forms de GUI Swing e selecione o modelo Form JFrame.)
-6. Na página Nome e Localização do assistente, realize as seguintes operações:
+
+[start=6]
+. Na página Nome e Localização do assistente, realize as seguintes operações:
* Digite ``NumberSliderFrame`` para o nome da classe.
* Digite ``numberslider`` como o nome do pacote.
@@ -89,12 +95,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
image::images/numberslider2-small.png[role="left", link="images/numberslider2.png"]
--
-7. Clique em Finalizar para sair do assistente e criar o form.
+
+[start=7]
+. Clique em Finalizar para sair do assistente e criar o form.
``NumberSliderFrame.java`` deve ser aberto no modo de design na área de edição.
-8. Na seção Controles Swing da Paleta, arraste um componente de controle deslizante para a área de design. (Se a janela Paleta não estiver aberta, escolha Janela > Paleta).
-9. Da Paleta, arraste um componente de campo de texto para a área de design.
+
+[start=8]
+. Na seção Controles Swing da Paleta, arraste um componente de controle deslizante para a área de design. (Se a janela Paleta não estiver aberta, escolha Janela > Paleta).
+
+[start=9]
+. Da Paleta, arraste um componente de campo de texto para a área de design.
O form resultante é parecido com a tela abaixo. Entretanto, o posicionamento não é importante para fins deste exemplo.
@@ -125,7 +137,9 @@ Nesse caso, já que o JSlider vem com uma faixa default de valores, vamos usá-l
image::images/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. Clique em OK.
+
+[start=4]
+. Clique em OK.
Você acabou de vincular a propriedade de bean ``value`` do controle deslizante ao valor ``text`` do campo de texto.
@@ -226,15 +240,21 @@ Antes de vincular um componente a dados de um banco de dados, você precisa ter
image::images/entity-wizard1-small.png[role="left", link="images/entity-wizard1.png"]
--
-4. Na página Classes de Entidade do assistente, verifique se as caixas de seleção Gerar Anotações de Consulta Nomeada e Criar Unidades Persistentes estão selecionadas.
+
+[start=4]
+. Na página Classes de Entidade do assistente, verifique se as caixas de seleção Gerar Anotações de Consulta Nomeada e Criar Unidades Persistentes estão selecionadas.
[.feature]
--
image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.png"]
--
-5. Faça quaisquer personalizações que desejar nos nomes das classes geradas e em sua localização.
-6. Clique em Finalizar.
+
+[start=5]
+. Faça quaisquer personalizações que desejar nos nomes das classes geradas e em sua localização.
+
+[start=6]
+. Clique em Finalizar.
Você deve ver nós das classes de entidade na janela Projetos.
@@ -251,8 +271,12 @@ Esta seção mostra como você pode vincular dados a componentes JTable, JList e
*Observação:* o tutorial usa o banco de dados ``sample [app on App]`` que pode ser conectado, selecionando a janela Serviços, expandindo o nó dos Bancos de dados, clicando com o botão direito do mouse no nó de conexão do banco de dados ( ``jdbc:derby://localhost:1527/sample[app on APP]`` ) e selecionando Conectar do menu de contexto.
Especifique ``app`` como id do usuário e ``app`` como senha, se for solicitado um id do usuário e uma senha.
-3. Expanda o nó da conexão e expanda seu nó Tabelas.
-4. Arraste o nó para a tabela no form e pressione Ctrl enquanto arrasta a tabela.
+
+[start=3]
+. Expanda o nó da conexão e expanda seu nó Tabelas.
+
+[start=4]
+. Arraste o nó para a tabela no form e pressione Ctrl enquanto arrasta a tabela.
Um JTable é criado e suas colunas são vinculadas às colunas na tabela do banco de dados.
@@ -265,18 +289,30 @@ Um JTable é criado e suas colunas são vinculadas às colunas na tabela do banc
image::images/bind-dialog-table-small.png[role="left", link="images/bind-dialog-table.png"]
--
-2. Clique em Importar Dados para Form. Na caixa de diálogo Importar Dados para Form, selecione a tabela de banco de dados a qual você deseja vincular seus componentes. Clique em OK.
-3. Na caixa de combinação Vincular Origem, selecione o item que representa a lista de resultados da classe da entidade. Por exemplo, se a classe da entidade for chamada, ``Customer.java`` , o objeto da lista seria gerado como ``customerList`` .
+
+[start=2]
+. Clique em Importar Dados para Form. Na caixa de diálogo Importar Dados para Form, selecione a tabela de banco de dados a qual você deseja vincular seus componentes. Clique em OK.
+
+[start=3]
+. Na caixa de combinação Vincular Origem, selecione o item que representa a lista de resultados da classe da entidade. Por exemplo, se a classe da entidade for chamada, ``Customer.java`` , o objeto da lista seria gerado como ``customerList`` .
[.feature]
--
image::images/source-selected-small.png[role="left", link="images/source-selected.png"]
--
-4. Deixe o valor Expressão de Vinculação como ``nulo`` .
-5. Se houver quaisquer colunas de banco de dados que você deseja que apareça na JTable, selecione essas colunas na lista Selecionado e mova-as para a lista Disponível.
-6. Selecione a guia Avançado para configurar a vinculação. Por exemplo, você pode especificar um validador ou conversor, ou pode especificar o comportamento se a origem da vinculação for nula ou ilegível.
-7. Clique em OK.
+
+[start=4]
+. Deixe o valor Expressão de Vinculação como ``nulo`` .
+
+[start=5]
+. Se houver quaisquer colunas de banco de dados que você deseja que apareça na JTable, selecione essas colunas na lista Selecionado e mova-as para a lista Disponível.
+
+[start=6]
+. Selecione a guia Avançado para configurar a vinculação. Por exemplo, você pode especificar um validador ou conversor, ou pode especificar o comportamento se a origem da vinculação for nula ou ilegível.
+
+[start=7]
+. Clique em OK.
*Para vincular os dados a um componente JList:*
@@ -289,10 +325,18 @@ image::images/source-selected-small.png[role="left", link="images/source-selecte
image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.png"]
--
-4. Deixe o valor Expressão de Vinculação como ``nulo`` .
-5. Na lista drop-down Exibir expressão, selecione a propriedade que representa a coluna do banco de dados que contém os valores que você deseja exibir na lista.
-6. Selecione a guia Avançado para configurar a vinculação.
-7. Clique em OK.
+
+[start=4]
+. Deixe o valor Expressão de Vinculação como ``nulo`` .
+
+[start=5]
+. Na lista drop-down Exibir expressão, selecione a propriedade que representa a coluna do banco de dados que contém os valores que você deseja exibir na lista.
+
+[start=6]
+. Selecione a guia Avançado para configurar a vinculação.
+
+[start=7]
+. Clique em OK.
*Para vincular os dados a um componente JComboBox:*
@@ -305,13 +349,21 @@ image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.pn
image::images/combo-binding-small.png[role="left", link="images/combo-binding.png"]
--
-4. Deixe o valor da Expressão de Vinculação como ``nulo`` e clique em OK.
-5. Clique com o botão direito do mouse na caixa de combinação novamente e escolha Vincular > Item selecionado.
-6. Vincule à propriedade que você deseja que seja afetada pela seleção do usuário.
+
+[start=4]
+. Deixe o valor da Expressão de Vinculação como ``nulo`` e clique em OK.
+
+[start=5]
+. Clique com o botão direito do mouse na caixa de combinação novamente e escolha Vincular > Item selecionado.
+
+[start=6]
+. Vincule à propriedade que você deseja que seja afetada pela seleção do usuário.
image::images/combo-item.png[]
-7. Clique em OK para salvar suas edições.
+
+[start=7]
+. Clique em OK para salvar suas edições.
A biblioteca Vinculação de Beans (a partir da versão 1.2.1) não possui uma classe DetailBinding que permite que você especifique como derivar os valores de _exibição_ de JComboBox. Portanto, você precisará escrever algum código personalizado. Uma abordagem é escrever um renderizador de célula personalizado, como mostrado abaixo.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ru.asciidoc
index 0afb175..0a971ec 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_ru.asciidoc
@@ -75,12 +75,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
--
* Снимите флажок "Создать главный класс".
-4. Нажмите кнопку Finish ("Готово"), чтобы выйти из мастера и приступить к настройке проекта.
-5. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта NumberSlider и выберите 'Создать' > 'Форма JFrame'.
+
+[start=4]
+. Нажмите кнопку Finish ("Готово"), чтобы выйти из мастера и приступить к настройке проекта.
+
+[start=5]
+. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта NumberSlider и выберите 'Создать' > 'Форма JFrame'.
(Если пункт JFrame Form отсутствует в меню New, выберите пункт Other ("Другое"). Затем в мастере создания файлов выберите категорию Swing GUI Forms ("Формы графического интерфейса Swing") и затем выберите шаблон JFrame Form.)
-6. На странице Name and Location ("Имя и местоположение") мастера выполните следующие операции:
+
+[start=6]
+. На странице Name and Location ("Имя и местоположение") мастера выполните следующие операции:
* Введите ``NumberSliderFrame`` в поле имени класса.
* Введите ``numberslider`` в поле имени пакета.
@@ -89,12 +95,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
image::images/numberslider2-small.png[role="left", link="images/numberslider2.png"]
--
-7. Нажмите кнопку Finish ("Готово") для выхода из мастера и создания формы.
+
+[start=7]
+. Нажмите кнопку Finish ("Готово") для выхода из мастера и создания формы.
В области редактирования должен открыться файл ``NumberSliderForm.java`` в режиме проектирования.
-8. Перетащите компонент ползунка в область проектирования из раздела Swing ("Элементы управления Swing") в Palette ("Палитра"). (Если окно палитры не открыто, выберите Window ("Окно") > Palette ("Палитра")).
-9. Перетащите компонент текстового поля в область проектирования из окна палитры.
+
+[start=8]
+. Перетащите компонент ползунка в область проектирования из раздела Swing ("Элементы управления Swing") в Palette ("Палитра"). (Если окно палитры не открыто, выберите Window ("Окно") > Palette ("Палитра")).
+
+[start=9]
+. Перетащите компонент текстового поля в область проектирования из окна палитры.
Полученная форма может выглядеть подобно приведенному ниже снимку экрана. Но для данного примера позиция не важна.
@@ -125,7 +137,9 @@ image::images/slider-textfield-small.png[role="left", link="images/slider-textfi
image::images/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. Нажмите кнопку "ОК".
+
+[start=4]
+. Нажмите кнопку "ОК".
Мы только что привязали свойство компонента ползунка ``value`` ("значение") к значению текстового поля ``text`` ("текст").
@@ -226,15 +240,21 @@ image::images/run-numberslider.png[]
image::images/entity-wizard1-small.png[role="left", link="images/entity-wizard1.png"]
--
-4. На странице мастера Entity Classes ("Сущностные классы") убедитесь, что установлены флажки Generate Named Query Annotations for Persistent Fields ("Создать аннотации именованных запросов для полей ") и Create Persistence Unit ("Создать блок сохранения состояния").
+
+[start=4]
+. На странице мастера Entity Classes ("Сущностные классы") убедитесь, что установлены флажки Generate Named Query Annotations for Persistent Fields ("Создать аннотации именованных запросов для полей ") и Create Persistence Unit ("Создать блок сохранения состояния").
[.feature]
--
image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.png"]
--
-5. Внесите любые необходимые изменения в имена и местоположение созданных классов.
-6. Нажмите кнопку "Завершить".
+
+[start=5]
+. Внесите любые необходимые изменения в имена и местоположение созданных классов.
+
+[start=6]
+. Нажмите кнопку "Завершить".
Узлы для сущностных классов можно будет увидеть в окне Projects ("Проекты").
@@ -251,8 +271,12 @@ image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.
*Примечание.* В этом учебном курсе используется тестовая база данных ``sample [app on App]`` . Для подключения к этой базе данных откройте окно 'Службы', разверните узел 'Базы данных', щелкните правой кнопкой мыши узел подключения к базе данных ( ``jdbc:derby://localhost:1527/sample[app on APP]`` ) и выберите пункт 'Подключение' в контекстном меню.
При появлении соответствующего запроса укажите значение ``app`` в качестве идентификатора пользователя и то же значение ``app`` в качестве пароля.
-3. Разверните узел для подключения и разверните его узел Tables ("Таблицы").
-4. Перетащите узел для таблицы на форму и нажмите клавишу Ctrl при завершении перетаскивания таблицы.
+
+[start=3]
+. Разверните узел для подключения и разверните его узел Tables ("Таблицы").
+
+[start=4]
+. Перетащите узел для таблицы на форму и нажмите клавишу Ctrl при завершении перетаскивания таблицы.
Будет создана таблица JTable, и ее столбцы будут привязаны к столбцам в таблице базы данных.
@@ -265,18 +289,30 @@ image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.
image::images/bind-dialog-table-small.png[role="left", link="images/bind-dialog-table.png"]
--
-2. Нажмите кнопку Import Data to Form ("Импортировать данные в форму"). В диалоговом окне Import Data to Form ("Импортировать данные в форму") выберите таблицу данных, к которой следует привязать свои компоненты. Нажмите кнопку "ОК".
-3. Из поля со списком Binding Source ("Источник привязки") выберите элемент, представляющий результирующий список сущностного класса. Например, если сущностный класс называется ``Customer.java`` , объект списка будет создан как ``customerList`` .
+
+[start=2]
+. Нажмите кнопку Import Data to Form ("Импортировать данные в форму"). В диалоговом окне Import Data to Form ("Импортировать данные в форму") выберите таблицу данных, к которой следует привязать свои компоненты. Нажмите кнопку "ОК".
+
+[start=3]
+. Из поля со списком Binding Source ("Источник привязки") выберите элемент, представляющий результирующий список сущностного класса. Например, если сущностный класс называется ``Customer.java`` , объект списка будет создан как ``customerList`` .
[.feature]
--
image::images/source-selected-small.png[role="left", link="images/source-selected.png"]
--
-4. Значением выражения привязки оставьте ``null`` .
-5. При наличии столбцов баз данных, которые не следует включать в JTable, выберите эти столбцы в списке Selected ("Выбранные") и переместите их в список Available ("Доступные").
-6. Выберите вкладку Advanced ("Дополнительные") для расширенной настройки привязки. Там, например, можно указать средство проверки или преобразователь, либо поведение в случае, если источник привязки не читается или имеет значение null.
-7. Нажмите кнопку "ОК".
+
+[start=4]
+. Значением выражения привязки оставьте ``null`` .
+
+[start=5]
+. При наличии столбцов баз данных, которые не следует включать в JTable, выберите эти столбцы в списке Selected ("Выбранные") и переместите их в список Available ("Доступные").
+
+[start=6]
+. Выберите вкладку Advanced ("Дополнительные") для расширенной настройки привязки. Там, например, можно указать средство проверки или преобразователь, либо поведение в случае, если источник привязки не читается или имеет значение null.
+
+[start=7]
+. Нажмите кнопку "ОК".
*Для привязки данных к компоненту JList выполните следующие действия.*
@@ -289,10 +325,18 @@ image::images/source-selected-small.png[role="left", link="images/source-selecte
image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.png"]
--
-4. Значением выражения привязки оставьте ``null`` .
-5. В раскрывающемся списке Display Expression ("Отображаемое выражение") выберите свойство, представляющее столбец базы данных, содержащий значения, которые необходимо отобразить в списке.
-6. Выберите вкладку Advanced ("Дополнительные") для расширенной настройки привязки.
-7. Нажмите кнопку "ОК".
+
+[start=4]
+. Значением выражения привязки оставьте ``null`` .
+
+[start=5]
+. В раскрывающемся списке Display Expression ("Отображаемое выражение") выберите свойство, представляющее столбец базы данных, содержащий значения, которые необходимо отобразить в списке.
+
+[start=6]
+. Выберите вкладку Advanced ("Дополнительные") для расширенной настройки привязки.
+
+[start=7]
+. Нажмите кнопку "ОК".
*Для привязки данных к компоненту JComboBox выполните следующие действия.*
@@ -305,13 +349,21 @@ image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.pn
image::images/combo-binding-small.png[role="left", link="images/combo-binding.png"]
--
-4. Оставьте значением Binding Expression ("Выражение привязки") ``null`` и нажмите кнопку "OК".
-5. Вновь щелкните правой кнопкой мыши поле со списком и выберите "Bind > selectedItem".
-6. Выполните привязку к свойству, на котором должен сказываться выбор пользователя
+
+[start=4]
+. Оставьте значением Binding Expression ("Выражение привязки") ``null`` и нажмите кнопку "OК".
+
+[start=5]
+. Вновь щелкните правой кнопкой мыши поле со списком и выберите "Bind > selectedItem".
+
+[start=6]
+. Выполните привязку к свойству, на котором должен сказываться выбор пользователя
image::images/combo-item.png[]
-7. Нажмите кнопку "ОК", чтобы сохранить изменения.
+
+[start=7]
+. Нажмите кнопку "ОК", чтобы сохранить изменения.
У библиотеки привязки компонентов (версии 1.2.1 и более ранних) нет класса DetailBinding, позволяющего указать, как следует извлекать _отображаемые_ значения для JComboBox. Так что необходимо будет написать немного собственного кода. Одним из подходов является написание собственного визуализатора ячеек, как показано ниже.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_zh_CN.asciidoc
index 29f549a..cc8570b 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-binding_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-binding_zh_CN.asciidoc
@@ -75,12 +75,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
--
* 清除 "Create Main Class"（创建主类）复选框。
-4. 单击 "Finish"（完成）退出向导并设置项目。
-5. 在 "Projects"（项目）窗口中，右键单击 NumberSlider 项目节点并选择 "New"（新建）> "JFrame Form"（JFrame 窗体）。
+
+[start=4]
+. 单击 "Finish"（完成）退出向导并设置项目。
+
+[start=5]
+. 在 "Projects"（项目）窗口中，右键单击 NumberSlider 项目节点并选择 "New"（新建）> "JFrame Form"（JFrame 窗体）。
（如果 "JFrame Form"（JFrame 窗体）在 "New"（新建）菜单中不可用，则选择 "Other"（其他）。然后在新建文件向导中，选择 "Swing GUI Forms"（Swing GUI 窗体）类别，然后选择 "JFrame Form"（JFrame 窗体）模板。）
-6. 在向导的 "Name and Location"（名称和位置）页中，执行以下操作：
+
+[start=6]
+. 在向导的 "Name and Location"（名称和位置）页中，执行以下操作：
* 为类名键入 ``NumberSliderFrame`` 。
* 为包名键入 ``numberslider`` 。
@@ -89,12 +95,18 @@ image:images/numberslider-small.png[role="left", link="images/numberslider.png"]
image::images/numberslider2-small.png[role="left", link="images/numberslider2.png"]
--
-7. 单击 "Finish"（完成）退出向导并创建窗体。
+
+[start=7]
+. 单击 "Finish"（完成）退出向导并创建窗体。
``NumberSliderFrame.java`` 应以设计模式在编辑区域中打开。
-8. 从组件面板的 "Swing Controls"（Swing 控件）部分，将一个滑块组件拖至设计区域。（如果 "Palette"（组件面板）窗口未打开，请选择 "Window"（窗口）> "Palette"（组件面板）。）
-9. 从组件面板中，将一个文本字段组件拖至设计区域。
+
+[start=8]
+. 从组件面板的 "Swing Controls"（Swing 控件）部分，将一个滑块组件拖至设计区域。（如果 "Palette"（组件面板）窗口未打开，请选择 "Window"（窗口）> "Palette"（组件面板）。）
+
+[start=9]
+. 从组件面板中，将一个文本字段组件拖至设计区域。
生成的窗体可能类似于下面的屏幕快照。不过，对于本示例而言，定位并不重要。
@@ -125,7 +137,9 @@ image::images/slider-textfield-small.png[role="left", link="images/slider-textfi
image::images/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. 单击 "OK"（确定）。
+
+[start=4]
+. 单击 "OK"（确定）。
刚才将滑块的 ``value`` Bean 属性绑定到了文本字段的 ``text`` 值。
@@ -226,15 +240,21 @@ image::images/run-numberslider.png[]
image::images/entity-wizard1-small.png[role="left", link="images/entity-wizard1.png"]
--
-4. 在该向导的 "Entity Classes"（实体类）页中，确保选中了 "Generate Named Query Annotations for Persistent Fields"（为持久性字段生成已命名的查询标注）和 "Create Persistence Unit"（创建持久性单元）复选框。
+
+[start=4]
+. 在该向导的 "Entity Classes"（实体类）页中，确保选中了 "Generate Named Query Annotations for Persistent Fields"（为持久性字段生成已命名的查询标注）和 "Create Persistence Unit"（创建持久性单元）复选框。
[.feature]
--
image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.png"]
--
-5. 对生成类的名称及其位置进行任何所需的定制。
-6. 单击 "Finish"（完成）。
+
+[start=5]
+. 对生成类的名称及其位置进行任何所需的定制。
+
+[start=6]
+. 单击 "Finish"（完成）。
在 "Projects"（项目）窗口中，您会看到实体类的节点。
@@ -251,8 +271,12 @@ image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.
*注：*本教程使用 ``sample [app on App]`` 数据库，通过选择 "Services"（服务）窗口，展开 "Databases"（数据库）节点，右键单击数据库连接节点 ( ``jdbc:derby://localhost:1527/sample[app on APP]`` )，然后从上下文菜单中选择 "Connect"（连接），可连接到该数据库。
如果系统提示您提供用户 ID 和口令，请指定 ``app`` 作为用户 ID，并指定 ``app`` 作为口令。
-3. 展开用于连接的节点，并展开其表节点。
-4. 将表节点拖到窗体并在拖至表时按住 Ctrl 键。
+
+[start=3]
+. 展开用于连接的节点，并展开其表节点。
+
+[start=4]
+. 将表节点拖到窗体并在拖至表时按住 Ctrl 键。
这将创建 JTable，并将其列绑定到数据库表中的列。
@@ -265,18 +289,30 @@ image::images/entity-wizard2-small.png[role="left", link="images/entity-wizard2.
image::images/bind-dialog-table-small.png[role="left", link="images/bind-dialog-table.png"]
--
-2. 单击 "Import Data to Form"（将数据导入窗体）。在 "Import Data to Form"（将数据导入窗体）对话框中，选择要将组件绑定到的数据库表。单击 "OK"（确定）。
-3. 在 "Binding Source"（绑定源）组合框中，选择表示实体类结果列表的项。例如，如果调用实体类 ``Customer.java`` ，则列表对象将生成为 ``customerList`` 。
+
+[start=2]
+. 单击 "Import Data to Form"（将数据导入窗体）。在 "Import Data to Form"（将数据导入窗体）对话框中，选择要将组件绑定到的数据库表。单击 "OK"（确定）。
+
+[start=3]
+. 在 "Binding Source"（绑定源）组合框中，选择表示实体类结果列表的项。例如，如果调用实体类 ``Customer.java`` ，则列表对象将生成为 ``customerList`` 。
[.feature]
--
image::images/source-selected-small.png[role="left", link="images/source-selected.png"]
--
-4. 将绑定表达式的值保留为 ``空值`` 。
-5. 如果不想在 JTable 中显示某些数据库列，请在 "Selected"（选定）列表中选择这些列，然后将它们移到 "Available"（可用）列表中。
-6. 选择 "Advanced"（高级）标签进一步配置绑定内容。例如，您可以指定验证器或转换器，或者指定绑定源为空值或不可读时的行为。
-7. 单击 "OK"（确定）。
+
+[start=4]
+. 将绑定表达式的值保留为 ``空值`` 。
+
+[start=5]
+. 如果不想在 JTable 中显示某些数据库列，请在 "Selected"（选定）列表中选择这些列，然后将它们移到 "Available"（可用）列表中。
+
+[start=6]
+. 选择 "Advanced"（高级）标签进一步配置绑定内容。例如，您可以指定验证器或转换器，或者指定绑定源为空值或不可读时的行为。
+
+[start=7]
+. 单击 "OK"（确定）。
*将数据绑定到 JList 组件：*
@@ -289,10 +325,18 @@ image::images/source-selected-small.png[role="left", link="images/source-selecte
image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.png"]
--
-4. 将绑定表达式的值保留为 ``空值`` 。
-5. 在 "Display Expression"（显示表达式）下拉列表中，选择表示数据库列的属性，该列包含了要在列表中显示的值。
-6. 选择 "Advanced"（高级）标签进一步配置绑定内容。
-7. 单击 "OK"（确定）。
+
+[start=4]
+. 将绑定表达式的值保留为 ``空值`` 。
+
+[start=5]
+. 在 "Display Expression"（显示表达式）下拉列表中，选择表示数据库列的属性，该列包含了要在列表中显示的值。
+
+[start=6]
+. 选择 "Advanced"（高级）标签进一步配置绑定内容。
+
+[start=7]
+. 单击 "OK"（确定）。
*将数据绑定到 JComboBox 组件：*
@@ -305,13 +349,21 @@ image::images/jlist-binding-small.png[role="left", link="images/jlist-binding.pn
image::images/combo-binding-small.png[role="left", link="images/combo-binding.png"]
--
-4. 将绑定表达式值保留为 ``空值`` ，然后单击 "OK"（确定）。
-5. 再次右键单击组合框，然后选择 "Bind"（绑定）> "selectedItem"。
-6. 绑定到您希望受用户选择影响的属性。
+
+[start=4]
+. 将绑定表达式值保留为 ``空值`` ，然后单击 "OK"（确定）。
+
+[start=5]
+. 再次右键单击组合框，然后选择 "Bind"（绑定）> "selectedItem"。
+
+[start=6]
+. 绑定到您希望受用户选择影响的属性。
image::images/combo-item.png[]
-7. 单击 "OK"（确定）保存所做的编辑。
+
+[start=7]
+. 单击 "OK"（确定）保存所做的编辑。
Bean 绑定库（从版本 1.2.1 起）没有 DetailBinding 类，该类用于指定如何为 JComboBox 派生 _display_ 值。因此，您需要编写一些定制代码。一种方法是编写定制单元格呈现器，如下所示。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser.asciidoc
index e26c7c2..203dbbe 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser.asciidoc
@@ -63,7 +63,9 @@ First you create a new Java Application:
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. Click Finish.
+
+[start=4]
+. Click Finish.
== Creating the Application Form
@@ -81,8 +83,12 @@ In this section, you create a ``JFrame`` container and add a few components to
image::images/newjframeform-small.png[role="left", link="images/newjframeform.png"]
--
-4. Click Finish.
-5. In the Properties window, enter `Demo application` for the Title property and press Enter to confirm.
+
+[start=4]
+. Click Finish.
+
+[start=5]
+. In the Properties window, enter `Demo application` for the Title property and press Enter to confirm.
*To add components to the JFrame form:*
@@ -95,8 +101,12 @@ image::images/newjframeform-small.png[role="left", link="images/newjframeform.pn
image::images/menubaradded-small.png[role="left", link="images/menubaradded.png"]
--
-2. Right-click the Edit item of the Menu Bar component and select Delete in the context menu.
-3. To add a menu item that allows to open FileChooser from the running application, in the Swing Menus category in the Palette, select a new Menu Item (JMenuItem1), drag it to the Menu Bar, and drop it to the File item of the Menu Bar.
+
+[start=2]
+. Right-click the Edit item of the Menu Bar component and select Delete in the context menu.
+
+[start=3]
+. To add a menu item that allows to open FileChooser from the running application, in the Swing Menus category in the Palette, select a new Menu Item (JMenuItem1), drag it to the Menu Bar, and drop it to the File item of the Menu Bar.
[.feature]
--
@@ -105,37 +115,57 @@ image::images/menuitemadded-small.png[role="left", link="images/menuitemadded.pn
*Note: * Make sure the Menu Bar is selected before dragging another Menu Item there in order to have the latter added to the Menu Bar.
-4. Right-click the jMenuItem1 in the Design view and choose Change Variable Name from the context menu. Rename the item to `Open` and click OK.
-5. Make sure that the jMenuItem1 is still selected in the Design view. Press the Space bar to edit the text of the component. Change the text to `Open` and press Enter to confirm.
-6. Specify the action handler for the Open menu item. Right-click the menu item and choose Events > Action > action Performed from the context menu. The GUI Builder automatically switches to the Source view and a new event handler method named ``OpenActionPerformed()`` is generated. The Navigator window should look as follows:
+
+[start=4]
+. Right-click the jMenuItem1 in the Design view and choose Change Variable Name from the context menu. Rename the item to `Open` and click OK.
+
+[start=5]
+. Make sure that the jMenuItem1 is still selected in the Design view. Press the Space bar to edit the text of the component. Change the text to `Open` and press Enter to confirm.
+
+[start=6]
+. Specify the action handler for the Open menu item. Right-click the menu item and choose Events > Action > action Performed from the context menu. The GUI Builder automatically switches to the Source view and a new event handler method named ``OpenActionPerformed()`` is generated. The Navigator window should look as follows:
image::images/openactionperformednavigator.png[]
-7. To add a menu item to exit FileChooser from the application being created, switch back into the Design mode, in the Swing Menus category in the Palette, select a Menu Item (JMenuItem1) and drag it to the Menu Bar below the Open menu item. Notice orange highlighting that indicates where the ``JMenuItem1`` is going to be placed.
+
+[start=7]
+. To add a menu item to exit FileChooser from the application being created, switch back into the Design mode, in the Swing Menus category in the Palette, select a Menu Item (JMenuItem1) and drag it to the Menu Bar below the Open menu item. Notice orange highlighting that indicates where the ``JMenuItem1`` is going to be placed.
[.feature]
--
image::images/highlighting-small.png[role="left", link="images/highlighting.png"]
--
-8. Right-click ``jMenuItem1`` in the Design view and choose Change Variable Name from the context menu. Rename the item to `Exit` and click OK.
-9. Make sure that the ``jMenuItem1`` is still selected in the Design view. Press the Space bar to edit the text of the component. Change the text to ``Exit`` and press Enter to confirm.
-10. Specify the action handler for the Exit menu item. Right-click the menu item and choose Events > Action > action Performed from the context menu. The GUI Builder automatically switches to the Source view and a new event handler method is generated which is named `ExitActionPerformed()`.The `ExitActionPerformed` node appears in the Navigator window below the `OpenActionPerformed()` node.
-11. To make the Exit menu item work, you include the following source into the `ExitActionPerformed()` method body:
+
+[start=8]
+. Right-click ``jMenuItem1`` in the Design view and choose Change Variable Name from the context menu. Rename the item to `Exit` and click OK.
+
+[start=9]
+. Make sure that the ``jMenuItem1`` is still selected in the Design view. Press the Space bar to edit the text of the component. Change the text to ``Exit`` and press Enter to confirm.
+
+[start=10]
+. Specify the action handler for the Exit menu item. Right-click the menu item and choose Events > Action > action Performed from the context menu. The GUI Builder automatically switches to the Source view and a new event handler method is generated which is named `ExitActionPerformed()`.The `ExitActionPerformed` node appears in the Navigator window below the `OpenActionPerformed()` node.
+
+[start=11]
+. To make the Exit menu item work, you include the following source into the `ExitActionPerformed()` method body:
[source,java]
----
System.exit(0);
----
-12. Switch back into Design mode. From the Swing Controls category of the Palette, drag a Text Area ( ``JTextArea`` ) into the form like shown in the picture below.
+
+[start=12]
+. Switch back into Design mode. From the Swing Controls category of the Palette, drag a Text Area ( ``JTextArea`` ) into the form like shown in the picture below.
[.feature]
--
image::images/textareadded-small.png[role="left", link="images/textareadded.png"]
--
-13. Resize the added component to make room for the text displayed by the File Chooser later. Rename the variable to `textarea`. The form should look like the following screenshot:
+
+[start=13]
+. Resize the added component to make room for the text displayed by the File Chooser later. Rename the variable to `textarea`. The form should look like the following screenshot:
[.feature]
--
@@ -152,8 +182,12 @@ You have set up a simple Java application as a base for this tutorial. Next you
As an alternative to the ``Add From Palette`` context menu, you can also drag and drop a ``JFileChooser`` component from the Swing Window category of the Palette to the white area of the GUI builder. It will have the same result, but it is a bit harder, because the preview of the ``JFileChooser`` is rather big and you might accidentally insert the window into one of the panels, which is not what you want.
-3. A look in the Navigator confirms that a ``JFileChooser`` was added to the form.
-4. Right-click the ``JFileChooser`` node and rename the variable to `fileChooser`.
+
+[start=3]
+. A look in the Navigator confirms that a ``JFileChooser`` was added to the form.
+
+[start=4]
+. Right-click the ``JFileChooser`` node and rename the variable to `fileChooser`.
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
*Note: * Remove the first and last lines of the code snippet that duplicate the existing ones in the source file.
-3. If the editor reports errors in your code, right-click anywhere in the code and select Fix Imports or press Ctrl+Shift+I. In the Fix All Imports dialog box accept the defaults to update the import statements and click OK.
+
+[start=3]
+. If the editor reports errors in your code, right-click anywhere in the code and select Fix Imports or press Ctrl+Shift+I. In the Fix All Imports dialog box accept the defaults to update the import statements and click OK.
As you can see, you call the FileChooser's ``getSelectedFile()`` method to determine which file the user clicked, so you can work with it. This example reads the file contents and displays them in the TextArea.
@@ -207,15 +243,21 @@ Now you add a custom file filter that makes the File Chooser display only ``*.t
image::images/combobox-small.png[role="left", link="images/combobox.png"]
--
-4. Type the following in the text field:
+
+[start=4]
+. Type the following in the text field:
[source,java]
----
new MyCustomFilter()
----
-5. Click OK.
-6. To make the custom code work, you write an inner (or outer) class ``MyCustomFilter`` that extends the ``FileFilter`` class. Copy and paste the following code snippet into the source of your class below the import statements to create an inner class implementing the filter.
+
+[start=5]
+. Click OK.
+
+[start=6]
+. To make the custom code work, you write an inner (or outer) class ``MyCustomFilter`` that extends the ``FileFilter`` class. Copy and paste the following code snippet into the source of your class below the import statements to create an inner class implementing the filter.
[source,java]
----
@@ -245,14 +287,18 @@ NOTE: To learn how to implement smarter, switchable file filters, have a look at
image::images/run.png[]
-3. In the running Demo application, choose Open in the File menu to trigger the action. The result should look like this:
+
+[start=3]
+. In the running Demo application, choose Open in the File menu to trigger the action. The result should look like this:
[.feature]
--
image::images/result_jfilechooserdemo-small.png[role="left", link="images/result_jfilechooserdemo.png"]
--
-4. To close the application, select Exit in the File menu.
+
+[start=4]
+. To close the application, select Exit in the File menu.
Have a look at other useful Swing windows and dialogs like the ColorChooser or the OptionPane in the GUI Palette.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ja.asciidoc
index 4e22abe..92eac3f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ja.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. 「終了」をクリックします。
+
+[start=4]
+. 「終了」をクリックします。
== アプリケーション・フォームの作成
@@ -81,8 +83,12 @@ image::images/newproj-small.png[role="left", link="images/newproj.png"]
image::images/newjframeform-small.png[role="left", link="images/newjframeform.png"]
--
-4. 「終了」をクリックします。
-5. 「プロパティ」ウィンドウで、「タイトル」プロパティに「`デモ・アプリケーション`」と入力し、[Enter]を押して確認します。
+
+[start=4]
+. 「終了」をクリックします。
+
+[start=5]
+. 「プロパティ」ウィンドウで、「タイトル」プロパティに「`デモ・アプリケーション`」と入力し、[Enter]を押して確認します。
*JFrameフォームにコンポーネントを追加するには:*
@@ -95,8 +101,12 @@ image::images/newjframeform-small.png[role="left", link="images/newjframeform.pn
image::images/menubaradded-small.png[role="left", link="images/menubaradded.png"]
--
-2. 「メニュー・バー」コンポーネントの「編集」項目を右クリックし、コンテキスト・メニューの「削除」を選択します。
-3. 実行中のアプリケーションからFileChooserを開くことができるメニュー項目を追加するには、パレットの「Swingメニュー」カテゴリで新しい「メニュー項目」(JMenuItem1)を選択し、それを「メニュー・バー」にドラッグして「メニュー・バー」の「ファイル」項目にドロップします。
+
+[start=2]
+. 「メニュー・バー」コンポーネントの「編集」項目を右クリックし、コンテキスト・メニューの「削除」を選択します。
+
+[start=3]
+. 実行中のアプリケーションからFileChooserを開くことができるメニュー項目を追加するには、パレットの「Swingメニュー」カテゴリで新しい「メニュー項目」(JMenuItem1)を選択し、それを「メニュー・バー」にドラッグして「メニュー・バー」の「ファイル」項目にドロップします。
[.feature]
--
@@ -105,37 +115,57 @@ image::images/menuitemadded-small.png[role="left", link="images/menuitemadded.pn
*注意:* 別の「メニュー項目」をドラッグする場合は、それが「メニュー・バー」に追加されるように、その前に「メニュー・バー」が選択されていることを確認してください。
-4. 「デザイン」ビューで「jMenuItem1」を右クリックし、コンテキスト・メニューから「変数名を変更」を選択します。項目の名前を「`Open`」に変更し、「OK」をクリックします。
-5. 「デザイン」ビューで「jMenuItem1」が引続き選択されていることを確認します。[Space]バーを押して、コンポーネントのテキストを編集します。テキストを「`開く`」に変更し、[Enter]を押して確認します。
-6. 「開く」メニュー項目のアクション・ハンドラを指定します。メニュー項目を右クリックし、コンテキスト・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。GUIビルダーによって自動的に「ソース」ビューに切り替えられ、 ``OpenActionPerformed()`` という名前の新しいイベント・ハンドラ・メソッドが生成されます。「ナビゲータ」ウィンドウは次のようになります。
+
+[start=4]
+. 「デザイン」ビューで「jMenuItem1」を右クリックし、コンテキスト・メニューから「変数名を変更」を選択します。項目の名前を「`Open`」に変更し、「OK」をクリックします。
+
+[start=5]
+. 「デザイン」ビューで「jMenuItem1」が引続き選択されていることを確認します。[Space]バーを押して、コンポーネントのテキストを編集します。テキストを「`開く`」に変更し、[Enter]を押して確認します。
+
+[start=6]
+. 「開く」メニュー項目のアクション・ハンドラを指定します。メニュー項目を右クリックし、コンテキスト・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。GUIビルダーによって自動的に「ソース」ビューに切り替えられ、 ``OpenActionPerformed()`` という名前の新しいイベント・ハンドラ・メソッドが生成されます。「ナビゲータ」ウィンドウは次のようになります。
image::images/openactionperformednavigator.png[]
-7. 作成されているアプリケーションからFileChooserを終了するためのメニュー項目を追加するには、「デザイン」モードに戻ってパレットの「Swingメニュー」カテゴリで「メニュー項目」(JMenuItem1)を選択し、それを「開く」メニュー項目の下にある「メニュー・バー」にドラッグします。オレンジ色の強調表示は ``JMenuItem1`` が配置される場所を示しています。
+
+[start=7]
+. 作成されているアプリケーションからFileChooserを終了するためのメニュー項目を追加するには、「デザイン」モードに戻ってパレットの「Swingメニュー」カテゴリで「メニュー項目」(JMenuItem1)を選択し、それを「開く」メニュー項目の下にある「メニュー・バー」にドラッグします。オレンジ色の強調表示は ``JMenuItem1`` が配置される場所を示しています。
[.feature]
--
image::images/highlighting-small.png[role="left", link="images/highlighting.png"]
--
-8. 「デザイン」ビューで「 ``jMenuItem1`` 」を右クリックし、コンテキスト・メニューから「変数名を変更」を選択します。項目の名前を「`Exit`」に変更し、「OK」をクリックします。
-9. 「デザイン」ビューで「 ``jMenuItem1`` 」が引続き選択されていることを確認します。[Space]バーを押して、コンポーネントのテキストを編集します。テキストを「 ``終了`` 」に変更し、[Enter]を押して確認します。
-10. 「終了」メニュー項目のアクション・ハンドラを指定します。メニュー項目を右クリックし、コンテキスト・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。GUIビルダーによって自動的に「ソース」ビューに切り替えられ、`ExitActionPerformed()`という名前の新しいイベント・ハンドラ・メソッドが生成されます。「ナビゲータ」ウィンドウの「`OpenActionPerformed()`」ノードの下に「`ExitActionPerformed`」ノードが表示されます。
-11. 「終了」メニュー項目を機能させるには、`ExitActionPerformed()`メソッドの本文に次のソースを追加します。
+
+[start=8]
+. 「デザイン」ビューで「 ``jMenuItem1`` 」を右クリックし、コンテキスト・メニューから「変数名を変更」を選択します。項目の名前を「`Exit`」に変更し、「OK」をクリックします。
+
+[start=9]
+. 「デザイン」ビューで「 ``jMenuItem1`` 」が引続き選択されていることを確認します。[Space]バーを押して、コンポーネントのテキストを編集します。テキストを「 ``終了`` 」に変更し、[Enter]を押して確認します。
+
+[start=10]
+. 「終了」メニュー項目のアクション・ハンドラを指定します。メニュー項目を右クリックし、コンテキスト・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。GUIビルダーによって自動的に「ソース」ビューに切り替えられ、`ExitActionPerformed()`という名前の新しいイベント・ハンドラ・メソッドが生成されます。「ナビゲータ」ウィンドウの「`OpenActionPerformed()`」ノードの下に「`ExitActionPerformed`」ノードが表示されます。
+
+[start=11]
+. 「終了」メニュー項目を機能させるには、`ExitActionPerformed()`メソッドの本文に次のソースを追加します。
[source,java]
----
System.exit(0);
----
-12. 「デザイン」モードに戻ります。次の図に示すように、パレットの「Swingコントロール」カテゴリから「テキスト領域」( ``JTextArea`` )をフォームにドラッグします。
+
+[start=12]
+. 「デザイン」モードに戻ります。次の図に示すように、パレットの「Swingコントロール」カテゴリから「テキスト領域」( ``JTextArea`` )をフォームにドラッグします。
[.feature]
--
image::images/textareadded-small.png[role="left", link="images/textareadded.png"]
--
-13. 追加されたコンポーネントのサイズを変更して、後でファイル・チューザによって表示されるテキストの領域を確保します。変数の名前を「`textarea`」に変更します。フォームは次のスクリーンショットのようにします。
+
+[start=13]
+. 追加されたコンポーネントのサイズを変更して、後でファイル・チューザによって表示されるテキストの領域を確保します。変数の名前を「`textarea`」に変更します。フォームは次のスクリーンショットのようにします。
[.feature]
--
@@ -152,8 +182,12 @@ image::images/jfilechooserdemoview_final-small.png[role="left", link="images/jfi
「 ``パレットから追加`` 」コンテキスト・メニューのかわりに、パレットの「Swingウィンドウ」カテゴリから、 ``JFileChooser`` コンポーネントをGUIビルダーの白い領域にドラッグ・アンド・ドロップすることもできます。それでも同じ結果になりますが操作が難しくなり、 ``JFileChooser`` のプレビューが非常に大きいため、ウィンドウを誤ってパネルに挿入して望まない結果になる可能性があります。
-3. ナビゲータを見ると、 ``JFileChooser`` がフォームに追加されたことを確認できます。
-4. 「 ``JFileChooser`` 」ノードを右クリックし、変数の名前を「`fileChooser`」に変更します。
+
+[start=3]
+. ナビゲータを見ると、 ``JFileChooser`` がフォームに追加されたことを確認できます。
+
+[start=4]
+. 「 ``JFileChooser`` 」ノードを右クリックし、変数の名前を「`fileChooser`」に変更します。
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
*注意:* このコード・スニペットの最初と最後の行は、ソース・ファイル内の既存の行と重複するため、除去してください。
-3. エディタによってコード内のエラーが報告された場合は、コード内の任意の場所を右クリックして「インポートを修正」を選択するか、または[Ctrl]+[Shift]+[I]を押します。「すべてのインポートを修正」ダイアログ・ボックスで、デフォルトを受け入れてインポート文を更新し、「OK」をクリックします。
+
+[start=3]
+. エディタによってコード内のエラーが報告された場合は、コード内の任意の場所を右クリックして「インポートを修正」を選択するか、または[Ctrl]+[Shift]+[I]を押します。「すべてのインポートを修正」ダイアログ・ボックスで、デフォルトを受け入れてインポート文を更新し、「OK」をクリックします。
このように、FileChooserの ``getSelectedFile()`` メソッドをコールしてユーザーがクリックしたファイルを判定し、それを処理できます。この例では、ファイルの内容を読み取ってテキスト領域に表示します。
@@ -207,8 +243,12 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
image::images/combobox-small.png[role="left", link="images/combobox.png"]
--
-4. テキスト・フィールドに「 ``new MyCustomFilter()`` 」と入力します。「OK」をクリックします。
-5. このカスタム・コードを機能させるには、 ``FileFilter`` クラスを拡張する内部(または外部)クラス ``MyCustomFilter`` を記述します。次のコード・スニペットをクラスのソースのインポート文の下にコピーして貼り付け、このフィルタを実装する内部クラスを作成します。
+
+[start=4]
+. テキスト・フィールドに「 ``new MyCustomFilter()`` 」と入力します。「OK」をクリックします。
+
+[start=5]
+. このカスタム・コードを機能させるには、 ``FileFilter`` クラスを拡張する内部(または外部)クラス ``MyCustomFilter`` を記述します。次のコード・スニペットをクラスのソースのインポート文の下にコピーして貼り付け、このフィルタを実装する内部クラスを作成します。
[source,java]
----
@@ -238,14 +278,18 @@ image::images/combobox-small.png[role="left", link="images/combobox.png"]
image::images/run.png[]
-3. 実行中のデモ・アプリケーションで、「ファイル」メニューの「開く」を選択してアクションをトリガーします。結果は次のようになります。
+
+[start=3]
+. 実行中のデモ・アプリケーションで、「ファイル」メニューの「開く」を選択してアクションをトリガーします。結果は次のようになります。
[.feature]
--
image::images/result_jfilechooserdemo-small.png[role="left", link="images/result_jfilechooserdemo.png"]
--
-4. アプリケーションを終了するには、「ファイル」メニューの「終了」を選択します。
+
+[start=4]
+. アプリケーションを終了するには、「ファイル」メニューの「終了」を選択します。
他にも、GUIパレットのColorChooserやOptionPaneなどの便利なSwingウィンドウやダイアログを試してみてください。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_pt_BR.asciidoc
index 4cef008..776a068 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_pt_BR.asciidoc
@@ -63,7 +63,9 @@ Primeiro, você cria uma nova Aplicação Java:
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. Clique em Finalizar.
+
+[start=4]
+. Clique em Finalizar.
== Criando o Form da Aplicação
@@ -81,8 +83,12 @@ Nesta seção, você cria um contêiner ``JFrame`` e adiciona uns poucos compo
image::images/newjframeform-small.png[role="left", link="images/newjframeform.png"]
--
-4. Clique em Finalizar.
-5. Na janela Propriedades, insira `Aplicação de demonstração` para a propriedade Título e pressione Enter para confirmar.
+
+[start=4]
+. Clique em Finalizar.
+
+[start=5]
+. Na janela Propriedades, insira `Aplicação de demonstração` para a propriedade Título e pressione Enter para confirmar.
*Para adicionar componentes ao form JFrame:*
@@ -95,8 +101,12 @@ image::images/newjframeform-small.png[role="left", link="images/newjframeform.pn
image::images/menubaradded-small.png[role="left", link="images/menubaradded.png"]
--
-2. Clique com o botão direito do mouse no item Editar do componente Barra de Menus e selecione Deletar no menu de contexto.
-3. Para adicionar um item de menu que permita abrir o FileChooser a partir da aplicação em execução, na categoria Menus Swing na Paleta, selecione um novo item de menu (JMenuItem1) e arraste-o para a Barra de Menus e solte-o no item Arquivo na Barra de Menus.
+
+[start=2]
+. Clique com o botão direito do mouse no item Editar do componente Barra de Menus e selecione Deletar no menu de contexto.
+
+[start=3]
+. Para adicionar um item de menu que permita abrir o FileChooser a partir da aplicação em execução, na categoria Menus Swing na Paleta, selecione um novo item de menu (JMenuItem1) e arraste-o para a Barra de Menus e solte-o no item Arquivo na Barra de Menus.
[.feature]
--
@@ -105,37 +115,57 @@ image::images/menuitemadded-small.png[role="left", link="images/menuitemadded.pn
*Observação:* assegure-se de que a Barra de Menus esteja selecionada antes de arrastar outro item de menu para ela para que o último seja adicionado na barra de menus.
-4. Clique com o botão direito do mouse em jMenuItem1 na view Design e escolha Alterar Nome da Variável no menu de contexto. Renomeie o item como `Abrir` e clique em OK.
-5. Assegure-se de que o jMenuItem1 ainda esteja selecionado na view Design. Pressione a barra de Espaço para editar o texto do componente. Altere o texto para `Abrir` e pressione Enter para confirmar.
-6. Especifique o handler de ação para o item de menu Abrir. Clique com o botão direito do mouse no item do menu e escolha Eventos > Ação > Ação executada do menu de contexto. O GUI Builder alterna automaticamente para a view do Código-fonte e um novo método do handler de evento ``OpenActionPerformed()`` é gerado. A janela do Navegador deveria se semelhante a esta:
+
+[start=4]
+. Clique com o botão direito do mouse em jMenuItem1 na view Design e escolha Alterar Nome da Variável no menu de contexto. Renomeie o item como `Abrir` e clique em OK.
+
+[start=5]
+. Assegure-se de que o jMenuItem1 ainda esteja selecionado na view Design. Pressione a barra de Espaço para editar o texto do componente. Altere o texto para `Abrir` e pressione Enter para confirmar.
+
+[start=6]
+. Especifique o handler de ação para o item de menu Abrir. Clique com o botão direito do mouse no item do menu e escolha Eventos > Ação > Ação executada do menu de contexto. O GUI Builder alterna automaticamente para a view do Código-fonte e um novo método do handler de evento ``OpenActionPerformed()`` é gerado. A janela do Navegador deveria se semelhante a esta:
image::images/openactionperformednavigator.png[]
-7. Para adicionar um item de menu para sair do FileChoser antes da aplicação ter sido criada, alterne de volta para o modo Design, na categoria Menu Swing na Paleta, selecione um item de menu (JMenuItem1) e arraste-o para a Barra de Menus abaixo do item de menu Abrir. Observe que o realce laranja indica onde o ``JMenuItem1`` será colocado.
+
+[start=7]
+. Para adicionar um item de menu para sair do FileChoser antes da aplicação ter sido criada, alterne de volta para o modo Design, na categoria Menu Swing na Paleta, selecione um item de menu (JMenuItem1) e arraste-o para a Barra de Menus abaixo do item de menu Abrir. Observe que o realce laranja indica onde o ``JMenuItem1`` será colocado.
[.feature]
--
image::images/highlighting-small.png[role="left", link="images/highlighting.png"]
--
-8. Clique com o botão direito do mouse em ``jMenuItem1`` na view Design e escolha Alterar Nome da Variável no menu de contexto. Renomeie o item como `Sair` e clique em OK.
-9. Assegure-se de que o ``jMenuItem1`` ainda esteja selecionado na view Design. Pressione a barra de Espaço para editar o texto do componente. Altere o texto para ``Sair`` e pressione Enter para confirmar.
-10. Especifique o handler de ação para o item de menu Sair. Clique com o botão direito do mouse no item do menu e escolha Eventos > Ação > Ação executada do menu de contexto. O GUI Builder alterna automaticamente para a view do Código-fonte e um novo método de handler de evento é gerado, denominado `ExitActionPerformed()`. O nó `ExitActionPerformed` aparece na janela do Navegador abaixo do nó `OpenActionPerformed()`.
-11. Para fazer com que o item de menu Sair funcione, você inclui o seguinte código-fonte no corpo do método `ExitActionPerformed`:
+
+[start=8]
+. Clique com o botão direito do mouse em ``jMenuItem1`` na view Design e escolha Alterar Nome da Variável no menu de contexto. Renomeie o item como `Sair` e clique em OK.
+
+[start=9]
+. Assegure-se de que o ``jMenuItem1`` ainda esteja selecionado na view Design. Pressione a barra de Espaço para editar o texto do componente. Altere o texto para ``Sair`` e pressione Enter para confirmar.
+
+[start=10]
+. Especifique o handler de ação para o item de menu Sair. Clique com o botão direito do mouse no item do menu e escolha Eventos > Ação > Ação executada do menu de contexto. O GUI Builder alterna automaticamente para a view do Código-fonte e um novo método de handler de evento é gerado, denominado `ExitActionPerformed()`. O nó `ExitActionPerformed` aparece na janela do Navegador abaixo do nó `OpenActionPerformed()`.
+
+[start=11]
+. Para fazer com que o item de menu Sair funcione, você inclui o seguinte código-fonte no corpo do método `ExitActionPerformed`:
[source,java]
----
System.exit(0);
----
-12. Volte para o modo Design. Na categoria Controles de Swing da Paleta, arraste uma Área de Texto ( ``JTextArea`` ) para o form, como mostrado na figura abaixo.
+
+[start=12]
+. Volte para o modo Design. Na categoria Controles de Swing da Paleta, arraste uma Área de Texto ( ``JTextArea`` ) para o form, como mostrado na figura abaixo.
[.feature]
--
image::images/textareadded-small.png[role="left", link="images/textareadded.png"]
--
-13. Redimensione o componente adicionado para criar espaço para o texto exibido mais tarde pelo Seletor de Arquivos. Renomeie a variável para `textarea`. O form deve parecer com a tela a seguir:
+
+[start=13]
+. Redimensione o componente adicionado para criar espaço para o texto exibido mais tarde pelo Seletor de Arquivos. Renomeie a variável para `textarea`. O form deve parecer com a tela a seguir:
[.feature]
--
@@ -152,8 +182,12 @@ Você precisa criar uma aplicação Java simples como base para este tutorial. E
Como uma alternativa para o menu de contexto ``Adicionar da Paleta`` , você também pode arrastar e soltar um componente ``JFileChooser`` da categoria Janelas Swing da Paleta para a área branca do GUI Builder. Isso terá o mesmo resultado, mas é um pouco mais difícil porque a exibição do ``JFileChooser`` é um pouco grande e você poderá acidentalmente inserir a janela em um dos painéis, o que não é o desejado.
-3. Um exame no Navegador confirma que um ``JFileChooser`` foi adicionado ao form.
-4. Clique com o botão direito do mouse no nó ``JFileChooser`` e renomeie a variável para `fileChooser`.
+
+[start=3]
+. Um exame no Navegador confirma que um ``JFileChooser`` foi adicionado ao form.
+
+[start=4]
+. Clique com o botão direito do mouse no nó ``JFileChooser`` e renomeie a variável para `fileChooser`.
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
*Observação: * Remova primeira e a última linha do snippet de código que duplicam os existentes no arquivo de código-fonte.
-3. Se o editor relata erros em seu código, clique com o botão direito do mouse em qualquer lugar no código e selecione Corrigir Importações ou pressione Ctrl+Shift+I. Na caixa de diálogo Corrigir Todas as Importações aceite os defaults para atualizar as instruções de importação e clique em OK.
+
+[start=3]
+. Se o editor relata erros em seu código, clique com o botão direito do mouse em qualquer lugar no código e selecione Corrigir Importações ou pressione Ctrl+Shift+I. Na caixa de diálogo Corrigir Todas as Importações aceite os defaults para atualizar as instruções de importação e clique em OK.
Como é possível ver, o método ``getSelectedFile()`` do Seletor de Arquivos é chamado para determinar em que arquivo o usuário clicou, para que você possa trabalhar com ele. Esse exemplo lê o conteúdo do arquivo e o exibe na Área de Texto.
@@ -207,8 +243,12 @@ Agora você precisa adicionar um filtro personalizado que faz com que o Seletor
image::images/combobox-small.png[role="left", link="images/combobox.png"]
--
-4. Digite ``new MyCustomFilter()`` no campo de texto. Clique em OK.
-5. Para fazer com que o código personalizado funcione, você escreve uma classe interna (ou externa) ``MyCustomFilter`` que estende a classe ``FileFilter`` . Copie e cole o seguinte snippet de código no código-fonte de sua classe abaixo das instruções de importação, para criar um classe interna que implementa o filtro.
+
+[start=4]
+. Digite ``new MyCustomFilter()`` no campo de texto. Clique em OK.
+
+[start=5]
+. Para fazer com que o código personalizado funcione, você escreve uma classe interna (ou externa) ``MyCustomFilter`` que estende a classe ``FileFilter`` . Copie e cole o seguinte snippet de código no código-fonte de sua classe abaixo das instruções de importação, para criar um classe interna que implementa o filtro.
[source,java]
----
@@ -238,14 +278,18 @@ image::images/combobox-small.png[role="left", link="images/combobox.png"]
image::images/run.png[]
-3. Na aplicação de Demonstração em execução, escolha Abrir no menu Arquivo para acionar a ação. O resultado deve ficar da seguinte forma:
+
+[start=3]
+. Na aplicação de Demonstração em execução, escolha Abrir no menu Arquivo para acionar a ação. O resultado deve ficar da seguinte forma:
[.feature]
--
image::images/result_jfilechooserdemo-small.png[role="left", link="images/result_jfilechooserdemo.png"]
--
-4. Para fechar a aplicação, selecione Sair no menu Arquivo.
+
+[start=4]
+. Para fechar a aplicação, selecione Sair no menu Arquivo.
Examine outras janelas e caixas de diálogo úteis do Swing como o Seletor de Cores ou o Painel de Opções na Paleta GUI.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ru.asciidoc
index 9c3eff1..3f7697d 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_ru.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. Нажмите кнопку "Завершить".
+
+[start=4]
+. Нажмите кнопку "Завершить".
== Создание формы приложения
@@ -81,8 +83,12 @@ image::images/newproj-small.png[role="left", link="images/newproj.png"]
image::images/newjframeform-small.png[role="left", link="images/newjframeform.png"]
--
-4. Нажмите кнопку "Завершить".
-5. В окне "Свойства" введите `Demo application` в качестве свойства "Заголовок" и нажмите ENTER для подтверждения.
+
+[start=4]
+. Нажмите кнопку "Завершить".
+
+[start=5]
+. В окне "Свойства" введите `Demo application` в качестве свойства "Заголовок" и нажмите ENTER для подтверждения.
*Чтобы добавить компоненты к форме JFrame, выполните следующие действия.*
@@ -95,8 +101,12 @@ image::images/newjframeform-small.png[role="left", link="images/newjframeform.pn
image::images/menubaradded-small.png[role="left", link="images/menubaradded.png"]
--
-2. Правой кнопкой мыши щелкните элемент "Правка" компонента "Строка меню" и выберите в контекстном меню пункт "Удалить".
-3. Чтобы добавить пункт меню, позволяющий открывать компонент FileChooser из выполняемого приложения, в категории "Меню Swing" в окне "Палитра" выберите новый пункт меню (JMenuItem1), перетащите его в элемент "Строка меню" и поместите его в поле "Файл" элемента "Строка меню".
+
+[start=2]
+. Правой кнопкой мыши щелкните элемент "Правка" компонента "Строка меню" и выберите в контекстном меню пункт "Удалить".
+
+[start=3]
+. Чтобы добавить пункт меню, позволяющий открывать компонент FileChooser из выполняемого приложения, в категории "Меню Swing" в окне "Палитра" выберите новый пункт меню (JMenuItem1), перетащите его в элемент "Строка меню" и поместите его в поле "Файл" элемента "Строка меню".
[.feature]
--
@@ -105,37 +115,57 @@ image::images/menuitemadded-small.png[role="left", link="images/menuitemadded.pn
*Примечание. * Убедитесь, что панель меню выбрана до перетаскивания другого элемента меню в него, чтобы добавить этот другой элемент на панель меню.
-4. Правой кнопкой мыши щелкните элемент jMenuItem1 в режиме конструирования и выберите 'Изменить имя переменной' в контекстном меню. Измените имя элемента на `Open` и нажмите кнопку "ОК".
-5. Убедитесь, что элемент jMenuItem1 все еще выбран в режиме проектирования. Нажмите клавишу ПРОБЕЛ, чтобы изменить текст компонента. Измените текст на `Open` и нажмите ENTER для подтверждения.
-6. Укажите обработчик действий для пункта меню "Open". Правой кнопкой мыши щелкните пункт меню и выберите в контекстном меню "События >Действие > Выполненное действие". GUI Builder автоматически переключается в режим просмотра исходного кода, и создается новый метод обработчика событий с именем ``OpenActionPerformed()`` . Окно навигатора должно выглядеть следующим образом:
+
+[start=4]
+. Правой кнопкой мыши щелкните элемент jMenuItem1 в режиме конструирования и выберите 'Изменить имя переменной' в контекстном меню. Измените имя элемента на `Open` и нажмите кнопку "ОК".
+
+[start=5]
+. Убедитесь, что элемент jMenuItem1 все еще выбран в режиме проектирования. Нажмите клавишу ПРОБЕЛ, чтобы изменить текст компонента. Измените текст на `Open` и нажмите ENTER для подтверждения.
+
+[start=6]
+. Укажите обработчик действий для пункта меню "Open". Правой кнопкой мыши щелкните пункт меню и выберите в контекстном меню "События >Действие > Выполненное действие". GUI Builder автоматически переключается в режим просмотра исходного кода, и создается новый метод обработчика событий с именем ``OpenActionPerformed()`` . Окно навигатора должно выглядеть следующим образом:
image::images/openactionperformednavigator.png[]
-7. Чтобы добавить пункт меню для выхода элемента FileChooser из создаваемого приложения, вернитесь в режим проектирования, в категории "Меню Swing" в окне "Палитра" выберите пункт меню JMenuItem1 и перетащите его в элемент "Строка меню" под пункт меню "Open". Место вставки элемента ``JMenuItem1`` выделено оранжевым цветом.
+
+[start=7]
+. Чтобы добавить пункт меню для выхода элемента FileChooser из создаваемого приложения, вернитесь в режим проектирования, в категории "Меню Swing" в окне "Палитра" выберите пункт меню JMenuItem1 и перетащите его в элемент "Строка меню" под пункт меню "Open". Место вставки элемента ``JMenuItem1`` выделено оранжевым цветом.
[.feature]
--
image::images/highlighting-small.png[role="left", link="images/highlighting.png"]
--
-8. Щелкните правой кнопкой мыши элемент ``jMenuItem1`` в режиме конструирования и выберите 'Изменить имя переменной' в контекстном меню. Измените имя элемента на `Exit` и нажмите кнопку "ОК".
-9. Убедитесь, что элемент ``jMenuItem1`` все еще выбран в режиме конструирования. Нажмите клавишу ПРОБЕЛ, чтобы изменить текст компонента. Измените текст на ``Exit`` и нажмите ENTER для подтверждения.
-10. Укажите обработчик действий для пункта меню "Exit". Правой кнопкой мыши щелкните пункт меню и выберите в контекстном меню "События >Действие > Выполненное действие". GUI Builder автоматически переключается в режим просмотра исходного кода, и создается новый метод обработчика событий с именем `ExitActionPerformed()`. В окне навигатора, под узлом `OpenActionPerformed()` отображается узел `ExitActionPerformed`.
-11. Чтобы сделать пункт меню "Exit" рабочим, в тело метода `ExitActionPerformed()` необходимо включить следующий исходный код:
+
+[start=8]
+. Щелкните правой кнопкой мыши элемент ``jMenuItem1`` в режиме конструирования и выберите 'Изменить имя переменной' в контекстном меню. Измените имя элемента на `Exit` и нажмите кнопку "ОК".
+
+[start=9]
+. Убедитесь, что элемент ``jMenuItem1`` все еще выбран в режиме конструирования. Нажмите клавишу ПРОБЕЛ, чтобы изменить текст компонента. Измените текст на ``Exit`` и нажмите ENTER для подтверждения.
+
+[start=10]
+. Укажите обработчик действий для пункта меню "Exit". Правой кнопкой мыши щелкните пункт меню и выберите в контекстном меню "События >Действие > Выполненное действие". GUI Builder автоматически переключается в режим просмотра исходного кода, и создается новый метод обработчика событий с именем `ExitActionPerformed()`. В окне навигатора, под узлом `OpenActionPerformed()` отображается узел `ExitActionPerformed`.
+
+[start=11]
+. Чтобы сделать пункт меню "Exit" рабочим, в тело метода `ExitActionPerformed()` необходимо включить следующий исходный код:
[source,java]
----
System.exit(0);
----
-12. Переключитесь обратно в режим проектирования. Перетащите текстовую область ( ``JTextArea`` ) из категории 'Элементы управления Swing' палитры на форму, как показано на иллюстрации.
+
+[start=12]
+. Переключитесь обратно в режим проектирования. Перетащите текстовую область ( ``JTextArea`` ) из категории 'Элементы управления Swing' палитры на форму, как показано на иллюстрации.
[.feature]
--
image::images/textareadded-small.png[role="left", link="images/textareadded.png"]
--
-13. Измените размер компонента, чтобы оставить место для текста, который отобразится в выборе файлов позже. Измените имя переменной на `textarea`. Форма должна иметь следующий вид:
+
+[start=13]
+. Измените размер компонента, чтобы оставить место для текста, который отобразится в выборе файлов позже. Измените имя переменной на `textarea`. Форма должна иметь следующий вид:
[.feature]
--
@@ -152,8 +182,12 @@ image::images/jfilechooserdemoview_final-small.png[role="left", link="images/jfi
Помимо использования контекстного меню ``Добавить из палитры`` можно также перетащить компонент ``JFileChooser`` из категории 'Окно Swing' палитры на белое поле конструктора графического интерфейса. Вы получите тот же результат, но данный метод требует немного больше усилий, так как эскиз ``JFileChooser`` занимает достаточно большую область экрана и можно случайно вставить окно в одну из панелей, что не соответствует поставленной задаче.
-3. Навигатор показывает, что элемент ``JFileChooser`` добавлен в форму.
-4. Щелкните узел ``JFileChooser`` правой кнопкой мыши и измените имя переменной на `fileChooser`.
+
+[start=3]
+. Навигатор показывает, что элемент ``JFileChooser`` добавлен в форму.
+
+[start=4]
+. Щелкните узел ``JFileChooser`` правой кнопкой мыши и измените имя переменной на `fileChooser`.
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
*Примечание. * Удалите первую и последнюю строку фрагмента кода, которые дублируют существующие строки в исходном файле.
-3. Если редактор создает отчет об ошибках в коде, щелкните правой кнопкой мыши в любом месте кода и выберите 'Исправить выражения импорта' или нажмите Ctrl+Shift+I. В диалоговом окне 'Исправить все выражения импорта' примите значения по умолчанию для обновления операторов импорта и нажмите OK.
+
+[start=3]
+. Если редактор создает отчет об ошибках в коде, щелкните правой кнопкой мыши в любом месте кода и выберите 'Исправить выражения импорта' или нажмите Ctrl+Shift+I. В диалоговом окне 'Исправить все выражения импорта' примите значения по умолчанию для обновления операторов импорта и нажмите OK.
Итак, метод FileChooser ``getSelectedFile()`` вызывается для определения файла, выбранного пользователем, в целях дальнейшей работы с ним. В этом примере считывается содержимое файлов, которое затем отображается в TextArea.
@@ -207,8 +243,12 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
image::images/combobox-small.png[role="left", link="images/combobox.png"]
--
-4. Введите ``new MyCustomFilter()`` в текстовое поле. Нажмите кнопку "ОК".
-5. Для использования пользовательского кода необходимо создать внутренний (или внешний) класс ``MyCustomFilter`` , расширяющий класс ``FileFilter`` . Чтобы создать внутренний класс, реализующий фильтр, скопируйте и вставьте следующий фрагмент кода в исходный код класса под операторами импорта.
+
+[start=4]
+. Введите ``new MyCustomFilter()`` в текстовое поле. Нажмите кнопку "ОК".
+
+[start=5]
+. Для использования пользовательского кода необходимо создать внутренний (или внешний) класс ``MyCustomFilter`` , расширяющий класс ``FileFilter`` . Чтобы создать внутренний класс, реализующий фильтр, скопируйте и вставьте следующий фрагмент кода в исходный код класса под операторами импорта.
[source,java]
----
@@ -238,14 +278,18 @@ image::images/combobox-small.png[role="left", link="images/combobox.png"]
image::images/run.png[]
-3. В меню 'Файл' запущенного демо-приложения выберите 'Открыть', чтобы инициировать действие. Результат должен иметь следующий вид:
+
+[start=3]
+. В меню 'Файл' запущенного демо-приложения выберите 'Открыть', чтобы инициировать действие. Результат должен иметь следующий вид:
[.feature]
--
image::images/result_jfilechooserdemo-small.png[role="left", link="images/result_jfilechooserdemo.png"]
--
-4. Чтобы закрыть приложение, выберите "Выход" в меню "Файл".
+
+[start=4]
+. Чтобы закрыть приложение, выберите "Выход" в меню "Файл".
Следует обратить внимание на другие полезные окна и диалоговые окна Swing, например ColorChooser или OptionPane в палитре графического интерфейса.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_zh_CN.asciidoc
index 15d391c..7bfde95 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-filechooser_zh_CN.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. 单击 "Finish"（完成）。
+
+[start=4]
+. 单击 "Finish"（完成）。
== 创建应用程序窗体
@@ -81,8 +83,12 @@ image::images/newproj-small.png[role="left", link="images/newproj.png"]
image::images/newjframeform-small.png[role="left", link="images/newjframeform.png"]
--
-4. 单击 "Finish"（完成）。
-5. 在 "Properties"（属性）窗口中，输入 `Demo application` 作为 "Title"（标题）属性，然后按 Enter 键进行确认。
+
+[start=4]
+. 单击 "Finish"（完成）。
+
+[start=5]
+. 在 "Properties"（属性）窗口中，输入 `Demo application` 作为 "Title"（标题）属性，然后按 Enter 键进行确认。
*将组件添加到 JFrame 窗体中：*
@@ -95,8 +101,12 @@ image::images/newjframeform-small.png[role="left", link="images/newjframeform.pn
image::images/menubaradded-small.png[role="left", link="images/menubaradded.png"]
--
-2. 右键单击 "Menu Bar"（菜单栏）组件的 "Edit"（编辑）项，然后在上下文菜单中选择 "Delete"（删除）。
-3. 要添加菜单项，以便从正在运行的应用程序打开文件选择器，请在 "Palette"（组件面板）的 "Swing Menus"（Swing 菜单）类别中，选择新的菜单项 (JMenuItem1)，然后将其拖放至 "Menu Bar"（菜单栏）的 "File"（文件）项。
+
+[start=2]
+. 右键单击 "Menu Bar"（菜单栏）组件的 "Edit"（编辑）项，然后在上下文菜单中选择 "Delete"（删除）。
+
+[start=3]
+. 要添加菜单项，以便从正在运行的应用程序打开文件选择器，请在 "Palette"（组件面板）的 "Swing Menus"（Swing 菜单）类别中，选择新的菜单项 (JMenuItem1)，然后将其拖放至 "Menu Bar"（菜单栏）的 "File"（文件）项。
[.feature]
--
@@ -105,37 +115,57 @@ image::images/menuitemadded-small.png[role="left", link="images/menuitemadded.pn
*注：*请确保先选择 "Menu Bar"（菜单栏），然后再将其他菜单项拖至此处，以便将后者添加到 "Menu Bar"（菜单栏）中。
-4. 在 "Design"（设计）视图中右键单击 jMenuItem1，然后从上下文菜单中选择 "Change Variable Name"（更改变量名称）。将项重命名为 `Open`，然后单击 "OK"（确定）。
-5. 确保 jMenuItem1 在 "Design"（设计）视图中仍处于选中状态。按空格键编缉组件的文本。将文本更改为 `Open`，然后按 Enter 键进行确认。
-6. 为 "Open" 菜单项指定操作处理程序。右键单击菜单项，然后从上下文菜单中选择 "Events"（事件）> "Action"（操作）> "action Performed"（执行的操作）。GUI 构建器自动切换至 "Source"（源）视图，并构建名为 ``OpenActionPerformed()`` 的新事件处理程序方法。"Navigator"（导航器）窗口应如下所示：
+
+[start=4]
+. 在 "Design"（设计）视图中右键单击 jMenuItem1，然后从上下文菜单中选择 "Change Variable Name"（更改变量名称）。将项重命名为 `Open`，然后单击 "OK"（确定）。
+
+[start=5]
+. 确保 jMenuItem1 在 "Design"（设计）视图中仍处于选中状态。按空格键编缉组件的文本。将文本更改为 `Open`，然后按 Enter 键进行确认。
+
+[start=6]
+. 为 "Open" 菜单项指定操作处理程序。右键单击菜单项，然后从上下文菜单中选择 "Events"（事件）> "Action"（操作）> "action Performed"（执行的操作）。GUI 构建器自动切换至 "Source"（源）视图，并构建名为 ``OpenActionPerformed()`` 的新事件处理程序方法。"Navigator"（导航器）窗口应如下所示：
image::images/openactionperformednavigator.png[]
-7. 要添加菜单项，以便从正在创建的应用程序中退出文件选择器，并切换回 "Design"（设计）模式，请在 "Palette"（组件面板）的 "Swing Menus"（Swing 菜单）类别中，选择菜单项 (JMenuItem1)，然后将其拖至 "Menu Bar"（菜单栏）中 "Open" 菜单项的下方。请注意橙色的突出显示，表示要放置 ``JMenuItem1`` 的位置。
+
+[start=7]
+. 要添加菜单项，以便从正在创建的应用程序中退出文件选择器，并切换回 "Design"（设计）模式，请在 "Palette"（组件面板）的 "Swing Menus"（Swing 菜单）类别中，选择菜单项 (JMenuItem1)，然后将其拖至 "Menu Bar"（菜单栏）中 "Open" 菜单项的下方。请注意橙色的突出显示，表示要放置 ``JMenuItem1`` 的位置。
[.feature]
--
image::images/highlighting-small.png[role="left", link="images/highlighting.png"]
--
-8. 在 "Design"（设计）视图中右键单击 ``jMenuItem1`` ，然后从上下文菜单中选择 "Change Variable Name"（更改变量名称）。将项重命名为 `Exit`，然后单击 "OK"（确定）。
-9. 确保 ``jMenuItem1`` 在 "Design"（设计）视图中仍处于选中状态。按空格键编缉组件的文本。将文本更改为 ``Exit`` ，然后按 Enter 键进行确认。
-10. 为 "Exit" 菜单项指定操作处理程序。右键单击菜单项，然后从上下文菜单中选择 "Events"（事件）> "Action"（操作）> "action Performed"（执行的操作）。GUI 构建器自动切换至 "Source"（源）视图，并将构建名为 `ExitActionPerformed()` 的新事件处理程序方法。`ExitActionPerformed` 节点显示在 "Navigator"（导航器）窗口中 `OpenActionPerformed()` 节点的下方。
-11. 要使 "Exit" 菜单项正常工作，需要将以下源添加到 `ExitActionPerformed()` 方法的主体中：
+
+[start=8]
+. 在 "Design"（设计）视图中右键单击 ``jMenuItem1`` ，然后从上下文菜单中选择 "Change Variable Name"（更改变量名称）。将项重命名为 `Exit`，然后单击 "OK"（确定）。
+
+[start=9]
+. 确保 ``jMenuItem1`` 在 "Design"（设计）视图中仍处于选中状态。按空格键编缉组件的文本。将文本更改为 ``Exit`` ，然后按 Enter 键进行确认。
+
+[start=10]
+. 为 "Exit" 菜单项指定操作处理程序。右键单击菜单项，然后从上下文菜单中选择 "Events"（事件）> "Action"（操作）> "action Performed"（执行的操作）。GUI 构建器自动切换至 "Source"（源）视图，并将构建名为 `ExitActionPerformed()` 的新事件处理程序方法。`ExitActionPerformed` 节点显示在 "Navigator"（导航器）窗口中 `OpenActionPerformed()` 节点的下方。
+
+[start=11]
+. 要使 "Exit" 菜单项正常工作，需要将以下源添加到 `ExitActionPerformed()` 方法的主体中：
[source,java]
----
System.exit(0);
----
-12. 切换回 "Design"（设计）模式。从 "Palette"（组件面板）的 "Swing Controls"（Swing 控件）类别中，将文本区域 ( ``JTextArea`` ) 拖入窗体中，如下图所示。
+
+[start=12]
+. 切换回 "Design"（设计）模式。从 "Palette"（组件面板）的 "Swing Controls"（Swing 控件）类别中，将文本区域 ( ``JTextArea`` ) 拖入窗体中，如下图所示。
[.feature]
--
image::images/textareadded-small.png[role="left", link="images/textareadded.png"]
--
-13. 调整已添加组件的大小，以便为文件选择器稍后显示的文本留出空间。将变量重命名为 `textarea`。此窗体应该类似于下面的屏幕快照：
+
+[start=13]
+. 调整已添加组件的大小，以便为文件选择器稍后显示的文本留出空间。将变量重命名为 `textarea`。此窗体应该类似于下面的屏幕快照：
[.feature]
--
@@ -152,8 +182,12 @@ image::images/jfilechooserdemoview_final-small.png[role="left", link="images/jfi
除了 ``Add From Palette`` （从组件面板上添加）上下文菜单之外，还可以从 "Palette"（组件面板）的 "Swing Window"（Swing 窗口）将 ``JFileChooser`` 组件拖放至 GUI 构建器的空白区域。结果是一样的，但操作上有一些困难，因为 ``JFileChooser`` 的预览非常大，并且可能会不小心将窗口插入到错误的面板。
-3. 查看导航器，确认 ``JFileChooser`` 已添加到窗体中。
-4. 右键单击 ``JFileChooser`` 节点，并将变量重命名为 `fileChooser`。
+
+[start=3]
+. 查看导航器，确认 ``JFileChooser`` 已添加到窗体中。
+
+[start=4]
+. 右键单击 ``JFileChooser`` 节点，并将变量重命名为 `fileChooser`。
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
*注：*删除代码片段中与源文件中现有的第一行和最后一行重复的行。
-3. 如果编辑器报告了代码中有错误，则右键单击代码中的任意位置，然后选择 "Fix Imports"（修复导入）或按 Ctrl+Shift+I 键。在 "Fix All Imports"（修复所有导入）对话框中，接受默认值以更新导入的语句，然后单击 "OK"（确定）。
+
+[start=3]
+. 如果编辑器报告了代码中有错误，则右键单击代码中的任意位置，然后选择 "Fix Imports"（修复导入）或按 Ctrl+Shift+I 键。在 "Fix All Imports"（修复所有导入）对话框中，接受默认值以更新导入的语句，然后单击 "OK"（确定）。
正如您所看到的，调用 FileChooser 的 ``getSelectedFile()`` 方法来确认用户所单击的文件，以便您可以对其进行操作。本示例读取文件内容，并将其显示在文本区域中。
@@ -207,8 +243,12 @@ private void OpenActionPerformed(java.awt.event.ActionEvent evt) {
image::images/combobox-small.png[role="left", link="images/combobox.png"]
--
-4. 在文本字段中键入 ``new MyCustomFilter()`` 。单击 "OK"（确定）。
-5. 要使定制代码正常工作，需要编写内部（或外部） ``MyCustomFilter`` 类，以扩展 ``FileFilter`` 类。复制以下代码片段，并将其粘贴到类的源代码中 import 语句的下方，以创建实现过滤器的内部类。
+
+[start=4]
+. 在文本字段中键入 ``new MyCustomFilter()`` 。单击 "OK"（确定）。
+
+[start=5]
+. 要使定制代码正常工作，需要编写内部（或外部） ``MyCustomFilter`` 类，以扩展 ``FileFilter`` 类。复制以下代码片段，并将其粘贴到类的源代码中 import 语句的下方，以创建实现过滤器的内部类。
[source,java]
----
@@ -238,14 +278,18 @@ image::images/combobox-small.png[role="left", link="images/combobox.png"]
image::images/run.png[]
-3. 在正运行的 Demo 应用程序中，从 "File"（文件）菜单中选择 "Open"（打开），以触发相应操作。该结果应该与此类似：
+
+[start=3]
+. 在正运行的 Demo 应用程序中，从 "File"（文件）菜单中选择 "Open"（打开），以触发相应操作。该结果应该与此类似：
[.feature]
--
image::images/result_jfilechooserdemo-small.png[role="left", link="images/result_jfilechooserdemo.png"]
--
-4. 要关闭该应用程序，请在 "File"（文件）菜单中选择 "Exit"（退出）。
+
+[start=4]
+. 要关闭该应用程序，请在 "File"（文件）菜单中选择 "Exit"（退出）。
查看 GUI 组件面板中的其他有用 Swing 窗口和对话框，如 "ColorChooser"（颜色选择器）或 "OptionPane"（选项窗格）。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality.asciidoc
index 9969d8d..781ea70 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality.asciidoc
@@ -117,7 +117,9 @@ private void jButton3ActionPerformed(java.awt.event.ActionEvent evt) {
//TODO add your handling code here:
}
----
-3. We are now going to add code for what we want the Exit Button to do. Replace the TODO line with `System.exit(0);`. Your finished Exit button code should look like this:
+
+[start=3]
+. We are now going to add code for what we want the Exit Button to do. Replace the TODO line with `System.exit(0);`. Your finished Exit button code should look like this:
[source,java]
----
@@ -156,6 +158,7 @@ The Add button will perform three actions.
3. And finally, it will convert the sum to a type String and place it in `jTextField3`.
Lets get started!
+[start=1]
1. Click the Design tab at the top of your work area to go back to the Form Design.
2. Right-click the Add button (`jButton2`). From the pop-up menu, select Events > Action > actionPerformed.
3. We are going to add some code to have our Add button work. The finished source code shall look like this:
@@ -196,7 +199,9 @@ NOTE: If you get a window informing you that Project NumberAddition does not hav
NOTE: The location of the ``NumberAddition`` project directory depends on the path you specified while creating the project in step 3 of the <<Exercise_1,Exercise 1: Creating a Project>> section.
-3. Double-click the `NumberAddition.jar` file.
+
+[start=3]
+. Double-click the `NumberAddition.jar` file.
After a few seconds, the application should start.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ja.asciidoc
index 663a869..1b3da8f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ja.asciidoc
@@ -39,8 +39,7 @@ GUIビルダーのデザイン機能に関する一般的な説明(様々なデ
*予想される所要時間: 20分*
-
-=== 内容
+== 内容
image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 6.9以降に適用されます"]
@@ -142,7 +141,9 @@ private void jButton3ActionPerformed(java.awt.event.ActionEvent evt) {
//TODO add your handling code here:
}
----
-3. 「Exit」ボタンで行う処理のコードを追加します。TODOの行を`System.exit(0);`に置き換えます。完成した「Exit」ボタンのコードは次のようになります。
+
+[start=3]
+. 「Exit」ボタンで行う処理のコードを追加します。TODOの行を`System.exit(0);`に置き換えます。完成した「Exit」ボタンのコードは次のようになります。
[source,java]
----
@@ -181,6 +182,8 @@ private void jButton1ActionPerformed(java.awt.event.ActionEvent evt){
3. そして最後に、その和を文字列型に変換し、それを`jTextField3`に配置します。
それでは始めましょう。
+
+[start=1]
1. 作業領域の上部にある「デザイン」タブをクリックし、フォームのデザインに戻ります。
2. 「Add」ボタン(`jButton2`)を右クリックします。ポップアップ・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。
3. 「Add」ボタンが機能するようにコードを追加します。完成したソース・コードは次のようになります。
@@ -221,7 +224,9 @@ private void jButton2ActionPerformed(java.awt.event.ActionEvent evt){
*注意:* ``NumberAddition`` プロジェクト・ディレクトリの場所は、<<Exercise_1,課題1: プロジェクトの作成>>の項でプロジェクトを作成するときにステップ3で指定したパスによって決まります。
-3. `NumberAddition.jar`ファイルをダブルクリックします。
+
+[start=3]
+. `NumberAddition.jar`ファイルをダブルクリックします。
数秒後、アプリケーションが起動するはずです。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_pt_BR.asciidoc
index e2982ed..e3f5e82 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_pt_BR.asciidoc
@@ -135,7 +135,9 @@ private void jButton3ActionPerformed(java.awt.event.ActionEvent evt) {
//TODO add your handling code here:
}
----
-3. Agora vamos adicionar o código da ação que desejamos que o botão Sair execute. Substitua a linha TODO por `System.exit(0);`. Seu código do botão Sair finalizado deve ter a seguinte aparência:
+
+[start=3]
+. Agora vamos adicionar o código da ação que desejamos que o botão Sair execute. Substitua a linha TODO por `System.exit(0);`. Seu código do botão Sair finalizado deve ter a seguinte aparência:
[source,java]
----
@@ -174,6 +176,7 @@ O botão Adicionar realizará três ações.
3. E, finalmente, ele converterá a soma para um tipo string e irá colocá-lo no `TextField3`.
Vamos começar!
+[start=1]
1. Clique na guia Design na parte superior da sua área de trabalho para voltar para o Design do Form.
2. Clique com o botão direito do mouse no botão Adicionar (`jButton2`). No menu pop-up, escolha Eventos > Ação> actionPerformed.
3. Agora vamos adicionar algum código para fazer nosso botão Adicionar funcionar. O código-fonte finalizado terá a seguinte aparência:
@@ -214,7 +217,9 @@ Agora nosso programa está completo e podemos construí-lo e executá-lo para v
*Observação:* a localização do diretório do projeto ``NumberAddition`` depende o caminho que você especificou ao criar o projeto na etapa 3 da seção <<Exercise_1,Exercício 1: Criando um Projeto>>.
-3. Clique duas vezes no arquivo `NumberAddition.jar`.
+
+[start=3]
+. Clique duas vezes no arquivo `NumberAddition.jar`.
Depois de alguns segundos, a aplicação deve ser iniciada.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ru.asciidoc
index 07c44a5..147033a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_ru.asciidoc
@@ -135,7 +135,9 @@ private void jButton3ActionPerformed(java.awt.event.ActionEvent evt) {
//TODO add your handling code here:
}
----
-3. Теперь добавим код действия, которое должна выполнять кнопка "Exit". Замените строку TODO на `System.exit(0);`. Готовый код кнопки "Exit" должен выглядеть следующим образом:
+
+[start=3]
+. Теперь добавим код действия, которое должна выполнять кнопка "Exit". Замените строку TODO на `System.exit(0);`. Готовый код кнопки "Exit" должен выглядеть следующим образом:
[source,java]
----
@@ -174,6 +176,7 @@ private void jButton1ActionPerformed(java.awt.event.ActionEvent evt){
3. И, наконец, она преобразует сумму в тип String и поместит ее в `jTextField3`.
Начнем!
+[start=1]
1. Щелкните вкладку "Design" в верхней части рабочей области для возврата к экрану "Form Design".
2. Щелкните правой кнопкой мыши кнопку "Add" (`jButton2`). Во всплывающем меню выберите Events ("События") > Action ("Действие") > actionPerformed.
3. Добавьте код действий, которые должна выполнять кнопка "Add". Готовый исходный код должен выглядеть следующим образом:
@@ -214,7 +217,9 @@ private void jButton2ActionPerformed(java.awt.event.ActionEvent evt){
*Примечание.* Местоположение каталога проекта ``NumberAddition`` зависит от пути, указанного при создании проекта в шаге 3 в разделе <<Exercise_1,Упражнение 1. Создание проекта>>.
-3. Дважды щелкните файл `NumberAddition.jar`.
+
+[start=3]
+. Дважды щелкните файл `NumberAddition.jar`.
Через несколько секунд приложение запустится.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_zh_CN.asciidoc
index 7041137..1845c8c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-functionality_zh_CN.asciidoc
@@ -135,7 +135,9 @@ private void jButton3ActionPerformed(java.awt.event.ActionEvent evt) {
//TODO add your handling code here:
}
----
-3. 现在，我们将为希望 "Exit" 按钮执行的操作添加代码。将 TODO 行替换为 `System.exit(0);`。完成的 "Exit" 按钮代码应如下所示：
+
+[start=3]
+. 现在，我们将为希望 "Exit" 按钮执行的操作添加代码。将 TODO 行替换为 `System.exit(0);`。完成的 "Exit" 按钮代码应如下所示：
[source,java]
----
@@ -174,6 +176,7 @@ private void jButton1ActionPerformed(java.awt.event.ActionEvent evt){
3. 最后，将相加之和的类型转换为字符串，并将其放在 `jTextField3` 中。
我们现在就开始吧！
+[start=1]
1. 单击工作区域顶部的“设计”标签以返回到窗体设计区域。
2. 右键单击 "Add" 按钮 (`jButton2`)。从弹出式菜单中选择“事件”>“操作”> "actionPerformed"。
3. 我们将添加一些代码以使 "Add" 按钮正常工作。完成的源代码应如下所示：
@@ -214,7 +217,9 @@ private void jButton2ActionPerformed(java.awt.event.ActionEvent evt){
*注：* ``NumberAddition`` 项目目录的位置取决于在<<Exercise_1,练习 1：创建项目>>部分中的第 3 步创建项目时指定的路径。
-3. 双击 `NumberAddition.jar` 文件。
+
+[start=3]
+. 双击 `NumberAddition.jar` 文件。
几秒钟后，将会启动应用程序。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps.asciidoc
index 312e1f4..eb1acaf 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps.asciidoc
@@ -57,7 +57,9 @@ The Projects window should look like the following:
image::images/prj.png[]
-4. Double-click the ``Initial.java`` file.
+
+[start=4]
+. Double-click the ``Initial.java`` file.
The sample form opens in the GUI Builder Design view.
image::images/initialform.png[]
@@ -80,33 +82,47 @@ The gap is highlighted with green.
image::images/gap-highlighted.png[]
-2. Hover the mouse pointer over the bottom part of the highlighted gap.
+
+[start=2]
+. Hover the mouse pointer over the bottom part of the highlighted gap.
The pointer is changed to a vertical resizable one.
image::images/gap-resizable.png[]
-3. Enlarge the selected gap to 50 by pressing the left mouse button, dragging the pointer downward, and releasing the left mouse button.
+
+[start=3]
+. Enlarge the selected gap to 50 by pressing the left mouse button, dragging the pointer downward, and releasing the left mouse button.
The new size of the gap is displayed in a tooltip.
image::images/resizing.png[]
-4. Add a new label into the created gap by dragging it from the Swing Controls section of the Palette and dropping it so that its left edge is aligned with the left edge of the ``First Name`` label and its top edge has the suggested preferred gap from the ``First Name`` row.
+
+[start=4]
+. Add a new label into the created gap by dragging it from the Swing Controls section of the Palette and dropping it so that its left edge is aligned with the left edge of the ``First Name`` label and its top edge has the suggested preferred gap from the ``First Name`` row.
image::images/jlabel.png[]
-5. Double-click the label and change the text of the label to ``Middle Name:`` .
+
+[start=5]
+. Double-click the label and change the text of the label to ``Middle Name:`` .
image::images/middle-name.png[]
-6. Add a new text field to the right of the ``Middle Name:`` label by dragging it from the Swing Controls section of the Palette and dropping it so that it is baseline-aligned with the ``Middle Name`` label and its left edge is aligned with the other text fields.
+
+[start=6]
+. Add a new text field to the right of the ``Middle Name:`` label by dragging it from the Swing Controls section of the Palette and dropping it so that it is baseline-aligned with the ``Middle Name`` label and its left edge is aligned with the other text fields.
image::images/textfield.png[]
-7. Drag the right edge of the text field to align it with the right edge of the other text fields.
+
+[start=7]
+. Drag the right edge of the text field to align it with the right edge of the other text fields.
image::images/textfield-resized.png[]
-8. Right-click the text inside the text field and choose Edit Text from the popup menu. Remove the text.
+
+[start=8]
+. Right-click the text inside the text field and choose Edit Text from the popup menu. Remove the text.
The ``Middle Name`` row is inserted between the form components.
@@ -156,7 +172,9 @@ The Edit Layout Space dialog box is displayed.
image::images/edit-layout-space.png[]
-2. Set the size of the Left and Right gaps to 0 and click OK.
+
+[start=2]
+. Set the size of the Left and Right gaps to 0 and click OK.
The gaps to the left and right of the buttons are removed using the Edit Layout Space dialog box.
image::images/gaps-removed.png[]
@@ -165,14 +183,18 @@ image::images/gaps-removed.png[]
1. Double-click the gap at the bottom of the last button.
The Edit Layout Space dialog box is displayed.
-2. In the Edit Layout Space dialog box, select the ``Resizable`` option and click OK.
+
+[start=2]
+. In the Edit Layout Space dialog box, select the ``Resizable`` option and click OK.
[.feature]
--
image::images/bottom-small.png[role="left", link="images/bottom.png"]
--
-3. Repeat steps 1 and 2 for the gap above the topmost button.
+
+[start=3]
+. Repeat steps 1 and 2 for the gap above the topmost button.
The gaps above and below the container with the buttons are made resizable.
*To center the buttons of the sample form*:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ja.asciidoc
index 182e2a2..c0620ec 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ja.asciidoc
@@ -67,7 +67,9 @@ image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、N
image::images/prj.png[]
-4. ``Initial.java`` ファイルをダブルクリックします。
+
+[start=4]
+. ``Initial.java`` ファイルをダブルクリックします。
サンプル・フォームがGUIビルダーの「デザイン」ビューで開きます。
image::images/initialform.png[]
@@ -90,33 +92,47 @@ IDEのデザイン・ビューで、端をドラッグ・アンド・ドロッ
image::images/gap-highlighted.png[]
-2. 強調表示されたギャップの下部にマウス・ポインタを置きます。
+
+[start=2]
+. 強調表示されたギャップの下部にマウス・ポインタを置きます。
ポインタは、垂直方向にサイズ変更可能なポインタに変わります。
image::images/gap-resizable.png[]
-3. マウスの左ボタンを押しながらポインタを下へドラッグして選択したギャップを50まで拡大し、マウスの左ボタンを離します。
+
+[start=3]
+. マウスの左ボタンを押しながらポインタを下へドラッグして選択したギャップを50まで拡大し、マウスの左ボタンを離します。
ギャップの新しいサイズがツールチップに表示されます。
image::images/resizing.png[]
-4. パレットの「Swingコントロール」セクションから新しいラベルをドラッグし、作成したギャップにドロップします。これにより、左端が「 ``First Name`` 」ラベルの左端にそろい、上端には「 ``First Name`` 」行からの提案された優先ギャップが確保されます。
+
+[start=4]
+. パレットの「Swingコントロール」セクションから新しいラベルをドラッグし、作成したギャップにドロップします。これにより、左端が「 ``First Name`` 」ラベルの左端にそろい、上端には「 ``First Name`` 」行からの提案された優先ギャップが確保されます。
image::images/jlabel.png[]
-5. ラベルをダブルクリックし、ラベルのテキストを「 ``Middle Name:`` 」に変更します。
+
+[start=5]
+. ラベルをダブルクリックし、ラベルのテキストを「 ``Middle Name:`` 」に変更します。
image::images/middle-name.png[]
-6. パレットの「Swingコントロール」セクションから新しいテキスト・フィールドをドラッグして「 ``Middle Name:`` 」ラベルの右に追加します。これにより、新しいテキスト・フィールドはベースラインが「 ``Middle Name`` 」ラベルとそろい、左端が他のテキスト・フィールドとそろいます。
+
+[start=6]
+. パレットの「Swingコントロール」セクションから新しいテキスト・フィールドをドラッグして「 ``Middle Name:`` 」ラベルの右に追加します。これにより、新しいテキスト・フィールドはベースラインが「 ``Middle Name`` 」ラベルとそろい、左端が他のテキスト・フィールドとそろいます。
image::images/textfield.png[]
-7. テキスト・フィールドの右端をドラッグして、他のテキスト・フィールドの右端とそろえます。
+
+[start=7]
+. テキスト・フィールドの右端をドラッグして、他のテキスト・フィールドの右端とそろえます。
image::images/textfield-resized.png[]
-8. テキスト・フィールド内のテキストを右クリックし、ポップアップ・メニューから「テキストを編集」を選択します。テキストを除去します。
+
+[start=8]
+. テキスト・フィールド内のテキストを右クリックし、ポップアップ・メニューから「テキストを編集」を選択します。テキストを除去します。
「 ``Middle Name`` 」行がフォーム・コンポーネント間に挿入されます。
@@ -166,7 +182,9 @@ image::images/buttons-enclosed.png[]
image::images/edit-layout-space.png[]
-2. 左右のギャップのサイズを0に設定し、「OK」をクリックします。
+
+[start=2]
+. 左右のギャップのサイズを0に設定し、「OK」をクリックします。
「レイアウト・スペースを編集」ダイアログ・ボックスを使用して、ボタンの左右のギャップが除去されます。
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@ image::images/gaps-removed.png[]
1. 最後のボタンの下部にあるギャップをダブルクリックします。
「レイアウト・スペースを編集」ダイアログ・ボックスが表示されます。
-2. 「レイアウト・スペースを編集」ダイアログ・ボックスで、「 ``サイズ変更可能`` 」オプションを選択し、「OK」をクリックします。
+
+[start=2]
+. 「レイアウト・スペースを編集」ダイアログ・ボックスで、「 ``サイズ変更可能`` 」オプションを選択し、「OK」をクリックします。
[.feature]
--
image::images/bottom-small.png[role="left", link="images/bottom.png"]
--
-3. 一番上のボタンの上にあるギャップについて、ステップ1と2を繰り返します。
+
+[start=3]
+. 一番上のボタンの上にあるギャップについて、ステップ1と2を繰り返します。
ボタンが含まれるコンテナの上下のギャップがサイズ変更可能になります。
*サンプル・フォームのボタンを中央揃えするには:*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_pt_BR.asciidoc
index a52a866..3db8ae6 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_pt_BR.asciidoc
@@ -67,7 +67,9 @@ A janela Projetos deve ter uma aparência semelhante a esta:
image::images/prj.png[]
-4. Clique duas vezes no arquivo ``Initial.java`` .
+
+[start=4]
+. Clique duas vezes no arquivo ``Initial.java`` .
O form de exemplo é aberto na view Design do GUI Builder.
image::images/initialform.png[]
@@ -90,33 +92,47 @@ A lacuna é realçada em verde.
image::images/gap-highlighted.png[]
-2. Passe o ponteiro do mouse sobre a parte inferior da lacuna realçada.
+
+[start=2]
+. Passe o ponteiro do mouse sobre a parte inferior da lacuna realçada.
O ponteiro é alterado para um redimensionável vertical.
image::images/gap-resizable.png[]
-3. Aumente a lacuna selecionada para 50, pressionando o botão esquerdo do mouse, arrastando o ponteiro para baixo, e liberando o botão esquerdo do mouse.
+
+[start=3]
+. Aumente a lacuna selecionada para 50, pressionando o botão esquerdo do mouse, arrastando o ponteiro para baixo, e liberando o botão esquerdo do mouse.
O novo tamanho da lacuna é exibido em uma dica de ferramenta.
image::images/resizing.png[]
-4. Adicionar um novo label à lacuna criada, arrastando-a da seção Controles Swing da Paleta e soltando-a para que sua borda esquerda seja alinhada com a borda esquerda do label ``Nome`` e sua borda superior tenha a lacuna preferencial sugerida da linha ``Nome`` .
+
+[start=4]
+. Adicionar um novo label à lacuna criada, arrastando-a da seção Controles Swing da Paleta e soltando-a para que sua borda esquerda seja alinhada com a borda esquerda do label ``Nome`` e sua borda superior tenha a lacuna preferencial sugerida da linha ``Nome`` .
image::images/jlabel.png[]
-5. Clique duas vezes no label e altere o texto do label para ``Nome do Meio:`` .
+
+[start=5]
+. Clique duas vezes no label e altere o texto do label para ``Nome do Meio:`` .
image::images/middle-name.png[]
-6. Adicione um novo campo de texto à direita do nome do label ``Nome do Meio:`` , arrastando-o da seção Controles Swing da Paleta e soltando-o, de forma que ele seja alinhado com o label do ``Nome do Meio`` e sua borda esquerda seja alinhada com os outros campos de texto.
+
+[start=6]
+. Adicione um novo campo de texto à direita do nome do label ``Nome do Meio:`` , arrastando-o da seção Controles Swing da Paleta e soltando-o, de forma que ele seja alinhado com o label do ``Nome do Meio`` e sua borda esquerda seja alinhada com os outros campos de texto.
image::images/textfield.png[]
-7. Arraste a borda direita do campo de texto para alinhá-la com a borda direita dos outros campos de texto.
+
+[start=7]
+. Arraste a borda direita do campo de texto para alinhá-la com a borda direita dos outros campos de texto.
image::images/textfield-resized.png[]
-8. Clique com o botão direito do mouse no texto no campo de texto e escolha Editar Texto no menu pop-up. Remover o texto.
+
+[start=8]
+. Clique com o botão direito do mouse no texto no campo de texto e escolha Editar Texto no menu pop-up. Remover o texto.
A linha ``Nome do Meio`` é inserida entre os componentes do form.
@@ -166,7 +182,9 @@ A caixa de diálogo Editar Espaço de Layout é exibida.
image::images/edit-layout-space.png[]
-2. Defina o tamanho das lacunas Esquerda e Direita para 0 e clique em OK.
+
+[start=2]
+. Defina o tamanho das lacunas Esquerda e Direita para 0 e clique em OK.
As lacunas à esquerda e à direita dos botões são removidas usando a caixa de diálogo Editar Espaço de Layout.
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@ image::images/gaps-removed.png[]
1. Clique duas vezes na lacuna na parte inferior do último botão.
A caixa de diálogo Editar Espaço de Layout é exibida.
-2. Na caixa de diálogo Editar Espaço de Layout, selecione a opção ``Redimensionável`` e clique em OK.
+
+[start=2]
+. Na caixa de diálogo Editar Espaço de Layout, selecione a opção ``Redimensionável`` e clique em OK.
[.feature]
--
image::images/bottom-small.png[role="left", link="images/bottom.png"]
--
-3. Repita as etapas 1 e 2 da lacuna acima do botão superior.
+
+[start=3]
+. Repita as etapas 1 e 2 da lacuna acima do botão superior.
As lacunas acima e abaixo do contêiner com os botões são redimensionáveis.
*Para centralizar os botões do form de exemplo*:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ru.asciidoc
index 685c48b..8ca5605 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_ru.asciidoc
@@ -67,7 +67,9 @@ image::images/netbeans-stamp-80-74-73.png[title="Содержимое на эт
image::images/prj.png[]
-4. Дважды щелкните файл ``Initial.java`` .
+
+[start=4]
+. Дважды щелкните файл ``Initial.java`` .
В конструкторе графического интерфейса откроется образец формы в режиме конструктора.
image::images/initialform.png[]
@@ -90,33 +92,47 @@ image::images/navigator.png[]
image::images/gap-highlighted.png[]
-2. Наведите курсор мыши на нижнюю часть выделенного промежутка.
+
+[start=2]
+. Наведите курсор мыши на нижнюю часть выделенного промежутка.
Указатель будет преобразован в вертикальный указатель с поддержкой изменения размера.
image::images/gap-resizable.png[]
-3. Увеличить выбранный промежуток до 50 нажатием левой кнопки мыши, перетаскиванием указателя вниз, после чего следует отжать левую кнопку мыши.
+
+[start=3]
+. Увеличить выбранный промежуток до 50 нажатием левой кнопки мыши, перетаскиванием указателя вниз, после чего следует отжать левую кнопку мыши.
Новый размер промежутка отображается в подсказке.
image::images/resizing.png[]
-4. Добавить новую метку в созданный промежуток, перетащив его из раздела 'Элементы управления Swing' палитры и отпустив его таким образом, чтобы левая граница была выровнена с левой границей метки ``Имя`` а ее верхняя граница содержала указанный предпочитаемый промежуток из строки ``Имя`` .
+
+[start=4]
+. Добавить новую метку в созданный промежуток, перетащив его из раздела 'Элементы управления Swing' палитры и отпустив его таким образом, чтобы левая граница была выровнена с левой границей метки ``Имя`` а ее верхняя граница содержала указанный предпочитаемый промежуток из строки ``Имя`` .
image::images/jlabel.png[]
-5. Дважды щелкните метку и измените текст метки на ``Отчество:`` .
+
+[start=5]
+. Дважды щелкните метку и измените текст метки на ``Отчество:`` .
image::images/middle-name.png[]
-6. Добавьте новое текстовое поле к правой стороне метки ``Отчество:`` перетащив его из раздела 'Элементы управления Swing' палитры и отпустив его, таким образом, чтобы его базовая линия была выровнена с меткой ``Отчество`` , а левая граница была выровнена с другими текстовыми полями.
+
+[start=6]
+. Добавьте новое текстовое поле к правой стороне метки ``Отчество:`` перетащив его из раздела 'Элементы управления Swing' палитры и отпустив его, таким образом, чтобы его базовая линия была выровнена с меткой ``Отчество`` , а левая граница была выровнена с другими текстовыми полями.
image::images/textfield.png[]
-7. Перетащите правую границу текстового поля для выравнивания его с правой границей других текстовых полей.
+
+[start=7]
+. Перетащите правую границу текстового поля для выравнивания его с правой границей других текстовых полей.
image::images/textfield-resized.png[]
-8. Щелкните правой кнопкой мыши текст внутри текстового поля и выбрав 'Редактировать текст' во всплывающем меню. Удалите текст.
+
+[start=8]
+. Щелкните правой кнопкой мыши текст внутри текстового поля и выбрав 'Редактировать текст' во всплывающем меню. Удалите текст.
Строка ``Отчество`` вставлена между компонентами формы.
@@ -166,7 +182,9 @@ image::images/buttons-enclosed.png[]
image::images/edit-layout-space.png[]
-2. Задайте размер левого и правого промежутка равным 0 и нажмите OK.
+
+[start=2]
+. Задайте размер левого и правого промежутка равным 0 и нажмите OK.
Промежутки справа и слева от кнопок удаляются с помощью диалогового окна 'Изменить пространство компоновки'.
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@ image::images/gaps-removed.png[]
1. Дважды щелкните промежуток в нижней части последней кнопки.
Отображается диалоговое окно 'Изменить пространство компоновки'.
-2. В диалоговом окне выберите 'Изменить пространство компоновки' выберите параметр ``С поддержкой изменения размера`` и нажмите ОК.
+
+[start=2]
+. В диалоговом окне выберите 'Изменить пространство компоновки' выберите параметр ``С поддержкой изменения размера`` и нажмите ОК.
[.feature]
--
image::images/bottom-small.png[role="left", link="images/bottom.png"]
--
-3. Повторите шаги 1 и 2 для промежутка над самой верхней кнопкой.
+
+[start=3]
+. Повторите шаги 1 и 2 для промежутка над самой верхней кнопкой.
Для промежутков выше и ниже контейнера с кнопками включена поддержка изменения размера.
*Центрирование кнопок в образце формы*:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_zh_CN.asciidoc
index 31a7180..04e3680 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-gaps_zh_CN.asciidoc
@@ -67,7 +67,9 @@ image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 Net
image::images/prj.png[]
-4. 双击 ``Initial.java`` 文件。
+
+[start=4]
+. 双击 ``Initial.java`` 文件。
此时将在 GUI 构建器的 "Design"（设计）视图中打开样例窗体。
image::images/initialform.png[]
@@ -90,33 +92,47 @@ image::images/navigator.png[]
image::images/gap-highlighted.png[]
-2. 将鼠标指针悬停在突出显示间距的底部。
+
+[start=2]
+. 将鼠标指针悬停在突出显示间距的底部。
指针将更改为垂直可调整大小的形状。
image::images/gap-resizable.png[]
-3. 通过按鼠标左键向下拖动指针，然后释放鼠标按键，将所选间距扩大到 50。
+
+[start=3]
+. 通过按鼠标左键向下拖动指针，然后释放鼠标按键，将所选间距扩大到 50。
间距的新大小将显示在工具提示中。
image::images/resizing.png[]
-4. 在创建的间距中添加新标签，方法是从组件面板的 "Swing Controls"（Swing 控件）部分拖放标签，使其左侧边缘与 ``First Name`` （名字）标签的左侧边缘对齐，其顶部边缘与 ``First Name`` （名字）行具有建议的首选间距。
+
+[start=4]
+. 在创建的间距中添加新标签，方法是从组件面板的 "Swing Controls"（Swing 控件）部分拖放标签，使其左侧边缘与 ``First Name`` （名字）标签的左侧边缘对齐，其顶部边缘与 ``First Name`` （名字）行具有建议的首选间距。
image::images/jlabel.png[]
-5. 双击标签并将标签的文本更改为 ``Middle Name:`` （中间名：）。
+
+[start=5]
+. 双击标签并将标签的文本更改为 ``Middle Name:`` （中间名：）。
image::images/middle-name.png[]
-6. 通过在组件面板的 "Swing Controls"（Swing 控件）部分拖放新文本字段，将该字段添加到 ``Middle Name:`` （中间名：）标签的右侧，使其底部与 ``Middle Name`` （中间名）标签对齐，左侧边缘与其他文本字段对齐。
+
+[start=6]
+. 通过在组件面板的 "Swing Controls"（Swing 控件）部分拖放新文本字段，将该字段添加到 ``Middle Name:`` （中间名：）标签的右侧，使其底部与 ``Middle Name`` （中间名）标签对齐，左侧边缘与其他文本字段对齐。
image::images/textfield.png[]
-7. 拖动文本字段的右侧边缘，使其与其他文本字段的右侧边缘对齐。
+
+[start=7]
+. 拖动文本字段的右侧边缘，使其与其他文本字段的右侧边缘对齐。
image::images/textfield-resized.png[]
-8. 右键单击文本字段中的文本并从弹出菜单中选择 "Edit Text"（编辑文本）。删除文本。
+
+[start=8]
+. 右键单击文本字段中的文本并从弹出菜单中选择 "Edit Text"（编辑文本）。删除文本。
``Middle Name`` （中间名）行将插入到窗体组件之间。
@@ -166,7 +182,9 @@ image::images/buttons-enclosed.png[]
image::images/edit-layout-space.png[]
-2. 将左右两侧间距的大小设置为 0，然后单击 "OK"（确定）。
+
+[start=2]
+. 将左右两侧间距的大小设置为 0，然后单击 "OK"（确定）。
此时将使用 "Edit Layout Space"（编辑布局空间）对话框删除按钮左右两侧的间距。
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@ image::images/gaps-removed.png[]
1. 双击最后一个按钮底部的间距。
此时将显示 "Edit Layout Space"（编辑布局空间）对话框。
-2. 在 "Edit Layout Space"（编辑布局空间）对话框中，选择 ``Resizable`` （可调整大小）选项，然后单击 "OK"（确定）。
+
+[start=2]
+. 在 "Edit Layout Space"（编辑布局空间）对话框中，选择 ``Resizable`` （可调整大小）选项，然后单击 "OK"（确定）。
[.feature]
--
image::images/bottom-small.png[role="left", link="images/bottom.png"]
--
-3. 对顶部按钮上方的间距重复步骤 1 和 2。
+
+[start=3]
+. 对顶部按钮上方的间距重复步骤 1 和 2。
带有按钮的容器上下的间距将成为可调整大小的间距。
*要将样例窗体的按钮居中，请执行以下操作*：
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display.asciidoc
index 8eec966..60ec8ba 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display.asciidoc
@@ -46,7 +46,9 @@ The application that results from this tutorial will be a simple JFrame that con
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. Click Finish.
+
+[start=5]
+. Click Finish.
== Creating the Application Form
@@ -86,7 +88,9 @@ When you use images or other resources in an application, typically you create a
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. Click Finish.
+
+[start=2]
+. Click Finish.
In the Projects window, you should see a new package appear within the `Source Packages` folder.
@@ -109,16 +113,24 @@ The icon property editor is displayed.
image::images/importimage-small.png[role="left", link="images/importimage.png"]
--
-4. In the icon property dialog box, click Import to Project.
-5. In the file chooser navigate to any image that is on your system that you want to use. Then click Next.
-6. In the Select target folder page of the wizard, select the `newpackage` folder and click Finish.
+
+[start=4]
+. In the icon property dialog box, click Import to Project.
+
+[start=5]
+. In the file chooser navigate to any image that is on your system that you want to use. Then click Next.
+
+[start=6]
+. In the Select target folder page of the wizard, select the `newpackage` folder and click Finish.
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-7. Click OK to close the icon property dialog box.
+
+[start=7]
+. Click OK to close the icon property dialog box.
After you click OK, the IDE does the following things:
@@ -188,8 +200,12 @@ First you need to set the project's main class. When you set the main class, the
image::images/mainclass-small.png[role="left", link="images/mainclass.png"]
--
-4. Click the Select Main Class button.
-5. Click OK to close the Project Properties dialog box.
+
+[start=4]
+. Click the Select Main Class button.
+
+[start=5]
+. Click OK to close the Project Properties dialog box.
*To build the project:*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ja.asciidoc
index 3c93984..ef96e96 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ja.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74.png[title="このページの内容は、NetB
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
== アプリケーション・フォームの作成
@@ -103,7 +105,9 @@ image::images/form-small.png[role="left", link="images/form.png"]
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. 「終了」をクリックします。
+
+[start=2]
+. 「終了」をクリックします。
「プロジェクト」ウィンドウでは、`Source Packages`フォルダ内に新規パッケージが表示されているはずです。
@@ -126,16 +130,24 @@ image::images/project-with-imagepack.png[]
image::images/importimage-small.png[role="left", link="images/importimage.png"]
--
-4. アイコン・プロパティのダイアログ・ボックスで、「プロジェクトにインポート」をクリックします。
-5. ファイル・チューザで、システム上にある、使用するイメージに移動します。「次」をクリックします。
-6. ウィザードの「ターゲット・フォルダの選択」ページで、`newpackage`フォルダを選択し、「終了」をクリックします。
+
+[start=4]
+. アイコン・プロパティのダイアログ・ボックスで、「プロジェクトにインポート」をクリックします。
+
+[start=5]
+. ファイル・チューザで、システム上にある、使用するイメージに移動します。「次」をクリックします。
+
+[start=6]
+. ウィザードの「ターゲット・フォルダの選択」ページで、`newpackage`フォルダを選択し、「終了」をクリックします。
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-7. 「OK」をクリックしてアイコン・プロパティのダイアログ・ボックスを閉じます。
+
+[start=7]
+. 「OK」をクリックしてアイコン・プロパティのダイアログ・ボックスを閉じます。
「OK」をクリックすると、IDEでは次の処理が行われます。
@@ -205,48 +217,96 @@ SwingにはJFrameの背景イメージに対する直接のサポートがない
image::images/prj-small.png[role="left", link="images/prj.png"]
--
-5. 「終了」をクリックします。
-6. 「プロジェクト」ウィンドウで、「`BackgroundImageApp`」ノードを展開します。
-7. 「ソース・パッケージ」ノードを右クリックし、「新規」>「JFrameフォーム」を選択します。
-8. 「クラス名」に「`ImageDisplay`」と入力します。
-9. 「パッケージ名」に「`org.me.mybackgroundapp`」と入力します。
+
+[start=5]
+. 「終了」をクリックします。
+
+[start=6]
+. 「プロジェクト」ウィンドウで、「`BackgroundImageApp`」ノードを展開します。
+
+[start=7]
+. 「ソース・パッケージ」ノードを右クリックし、「新規」>「JFrameフォーム」を選択します。
+
+[start=8]
+. 「クラス名」に「`ImageDisplay`」と入力します。
+
+[start=9]
+. 「パッケージ名」に「`org.me.mybackgroundapp`」と入力します。
[.feature]
--
image::images/newjframe-small.png[role="left", link="images/newjframe.png"]
--
-10. 「終了」をクリックします。
-11. 「デザイン」ビューで「JFrame」を右クリックし、ポップアップ・メニューから「レイアウトを設定」>「グリッド・バッグ・レイアウト」を選択します。
-12. 「JFrame」を右クリックし、ポップアップ・メニューから「パレットから追加」>「Swingコンテナ」>「パネル」を選択します。
-13. 「プロパティ」ウィンドウで、jPanelの「`opaque`」プロパティを選択解除します。
-14. 「JFrame」を右クリックし、ポップアップ・メニューから「パレットから追加」>「Swingコントロール」>「ラベル」を選択します。
-15. 「プロジェクト」ウィンドウで、「`org.me.mybackgroundapp`」ノードを右クリックし、「新規」>「Javaパッケージ」を選択します。
-16. 「終了」をクリックします。新規パッケージが追加されます。
-17. GUIデザイナで、フォームに追加したラベルを選択します。
-18. 「プロパティ」ウィンドウで、「プロパティ」カテゴリをクリックし、アイコン・プロパティまでスクロールします。
-19. 省略符号(...)ボタンをクリックします。
-20. アイコン・プロパティのダイアログ・ボックスで、「プロジェクトにインポート」をクリックします。
-21. ファイル・チューザで、システム上にある、使用するイメージに移動します。「次」をクリックします。
-22. ウィザードの「ターゲット・フォルダの選択」ページで、`newpackage`リソース・フォルダを選択し、「終了」をクリックします。
+
+[start=10]
+. 「終了」をクリックします。
+
+[start=11]
+. 「デザイン」ビューで「JFrame」を右クリックし、ポップアップ・メニューから「レイアウトを設定」>「グリッド・バッグ・レイアウト」を選択します。
+
+[start=12]
+. 「JFrame」を右クリックし、ポップアップ・メニューから「パレットから追加」>「Swingコンテナ」>「パネル」を選択します。
+
+[start=13]
+. 「プロパティ」ウィンドウで、jPanelの「`opaque`」プロパティを選択解除します。
+
+[start=14]
+. 「JFrame」を右クリックし、ポップアップ・メニューから「パレットから追加」>「Swingコントロール」>「ラベル」を選択します。
+
+[start=15]
+. 「プロジェクト」ウィンドウで、「`org.me.mybackgroundapp`」ノードを右クリックし、「新規」>「Javaパッケージ」を選択します。
+
+[start=16]
+. 「終了」をクリックします。新規パッケージが追加されます。
+
+[start=17]
+. GUIデザイナで、フォームに追加したラベルを選択します。
+
+[start=18]
+. 「プロパティ」ウィンドウで、「プロパティ」カテゴリをクリックし、アイコン・プロパティまでスクロールします。
+
+[start=19]
+. 省略符号(...)ボタンをクリックします。
+
+[start=20]
+. アイコン・プロパティのダイアログ・ボックスで、「プロジェクトにインポート」をクリックします。
+
+[start=21]
+. ファイル・チューザで、システム上にある、使用するイメージに移動します。「次」をクリックします。
+
+[start=22]
+. ウィザードの「ターゲット・フォルダの選択」ページで、`newpackage`リソース・フォルダを選択し、「終了」をクリックします。
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-23. 「OK」をクリックしてアイコン・プロパティのダイアログ・ボックスを閉じます。
-24. ナビゲータで、「jPanel」を右クリックし、ポップアップ・メニューから「プロパティ」を選択します。
-25. 「プロパティ」ダイアログ・ボックスで、「`グリッドX`」、「`グリッドY`」、「`ウエイトX`」、および「`ウエイトY`」プロパティを「`1`」に設定し、「`フィル`」プロパティを「`両方`」に設定します。
+
+[start=23]
+. 「OK」をクリックしてアイコン・プロパティのダイアログ・ボックスを閉じます。
+
+[start=24]
+. ナビゲータで、「jPanel」を右クリックし、ポップアップ・メニューから「プロパティ」を選択します。
+
+[start=25]
+. 「プロパティ」ダイアログ・ボックスで、「`グリッドX`」、「`グリッドY`」、「`ウエイトX`」、および「`ウエイトY`」プロパティを「`1`」に設定し、「`フィル`」プロパティを「`両方`」に設定します。
[.feature]
--
image::images/panelprops-small.png[role="left", link="images/panelprops.png"]
--
-26. 「閉じる」をクリックします。
-27. jLabelについて手順24と25を繰り返します。
-28. 「プロパティ」ダイアログ・ボックスで、`text`プロパティを選択して`jLabel1`を削除します。
+
+[start=26]
+. 「閉じる」をクリックします。
+
+[start=27]
+. jLabelについて手順24と25を繰り返します。
+
+[start=28]
+. 「プロパティ」ダイアログ・ボックスで、`text`プロパティを選択して`jLabel1`を削除します。
[.feature]
--
@@ -277,8 +337,12 @@ image::images/background.png[]
image::images/mainclass-small.png[role="left", link="images/mainclass.png"]
--
-4. 「メイン・クラスを選択」ボタンをクリックします。
-5. 「OK」をクリックして、「プロジェクト・プロパティ」ダイアログ・ボックスを閉じます。
+
+[start=4]
+. 「メイン・クラスを選択」ボタンをクリックします。
+
+[start=5]
+. 「OK」をクリックして、「プロジェクト・プロパティ」ダイアログ・ボックスを閉じます。
*プロジェクトをビルドするには:*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_pt_BR.asciidoc
index 1e9c2c7..8d31cb2 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_pt_BR.asciidoc
@@ -63,7 +63,9 @@ A aplicação resultante deste tutorial será um JFrame simples que contém um J
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. Clique em Finalizar.
+
+[start=5]
+. Clique em Finalizar.
== Criando o Form da Aplicação
@@ -103,7 +105,9 @@ Ao usar imagens ou outros recursos em uma aplicação, normalmente você cria um
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. Clique em Finalizar.
+
+[start=2]
+. Clique em Finalizar.
Na janela Projetos, você deve ver um novo pacote que aparece na pasta `Pacotes do Código-fonte`.
@@ -126,16 +130,24 @@ O editor de propriedades do ícone é exibido.
image::images/importimage-small.png[role="left", link="images/importimage.png"]
--
-4. Na caixa de diálogo da propriedade do ícone, clique em Importar para o Projeto.
-5. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em Próximo.
-6. Na página Selecionar pasta de destino do assistente, selecione a pasta `newpackage` e clique em Finalizar.
+
+[start=4]
+. Na caixa de diálogo da propriedade do ícone, clique em Importar para o Projeto.
+
+[start=5]
+. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em Próximo.
+
+[start=6]
+. Na página Selecionar pasta de destino do assistente, selecione a pasta `newpackage` e clique em Finalizar.
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-7. Clique em OK para fechar a caixa de diálogo de propriedade do ícone.
+
+[start=7]
+. Clique em OK para fechar a caixa de diálogo de propriedade do ícone.
Após clicar em OK, o IDE faz o seguinte:
@@ -205,48 +217,96 @@ De qualquer forma, há diversas formas indiretas de atingir tal objetivo. Nesta
image::images/prj-small.png[role="left", link="images/prj.png"]
--
-5. Clique em Finalizar.
-6. Na janela Projetos, expanda o nó `BackgroundImageApp`.
-7. Clique com o botão direito do mouse no nó Pacotes de Código-fonte e escolha Novo > Form JFrame.
-8. Em Nome da Classe, digite `ImageDisplay`.
-9. Em Nome do Pacote, digite `org.me.mybackgroundapp`.
+
+[start=5]
+. Clique em Finalizar.
+
+[start=6]
+. Na janela Projetos, expanda o nó `BackgroundImageApp`.
+
+[start=7]
+. Clique com o botão direito do mouse no nó Pacotes de Código-fonte e escolha Novo > Form JFrame.
+
+[start=8]
+. Em Nome da Classe, digite `ImageDisplay`.
+
+[start=9]
+. Em Nome do Pacote, digite `org.me.mybackgroundapp`.
[.feature]
--
image::images/newjframe-small.png[role="left", link="images/newjframe.png"]
--
-10. Clique em Finalizar.
-11. Na view Design, clique com o botão direito do mouse em JFrame e selecione Definir Layout > Layout do Conjunto de Grades no menu pop-up.
-12. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Contêineres Swing > Painel no menu pop-up.
-13. Na janela Propriedades, desmarque a propriedade `opaque` do jPanel.
-14. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Controles do Swing > Label no menu pop-up.
-15. Na janela Projetos, clique com o botão direito do mouse no nó `org.me.mybackgroundapp` e escolha Novo > Pacote Java.
-16. Clique em Finalizar. Um novo pacote é adicionado.
-17. No Designer de GUI, selecione o label que adicionou ao seu form.
-18. Na janela Propriedades, clique na categoria Propriedades e role até a propriedade do ícone.
-19. Clique no botão de reticências (...).
-20. Na caixa de diálogo da propriedade do ícone, clique em Importar para o Projeto.
-21. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em Próximo.
-22. Na página Selecionar Pasta de Destino do assistente, selecione a pasta de recursos `newpackage` e clique em Finalizar.
+
+[start=10]
+. Clique em Finalizar.
+
+[start=11]
+. Na view Design, clique com o botão direito do mouse em JFrame e selecione Definir Layout > Layout do Conjunto de Grades no menu pop-up.
+
+[start=12]
+. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Contêineres Swing > Painel no menu pop-up.
+
+[start=13]
+. Na janela Propriedades, desmarque a propriedade `opaque` do jPanel.
+
+[start=14]
+. Clique com o botão direito do mouse em JFrame e selecione Adicionar da Paleta > Controles do Swing > Label no menu pop-up.
+
+[start=15]
+. Na janela Projetos, clique com o botão direito do mouse no nó `org.me.mybackgroundapp` e escolha Novo > Pacote Java.
+
+[start=16]
+. Clique em Finalizar. Um novo pacote é adicionado.
+
+[start=17]
+. No Designer de GUI, selecione o label que adicionou ao seu form.
+
+[start=18]
+. Na janela Propriedades, clique na categoria Propriedades e role até a propriedade do ícone.
+
+[start=19]
+. Clique no botão de reticências (...).
+
+[start=20]
+. Na caixa de diálogo da propriedade do ícone, clique em Importar para o Projeto.
+
+[start=21]
+. Na seletor de arquivos, vá até qualquer imagem que esteja em seu sistema que você queira usar. Em seguida, clique em Próximo.
+
+[start=22]
+. Na página Selecionar Pasta de Destino do assistente, selecione a pasta de recursos `newpackage` e clique em Finalizar.
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-23. Clique em OK para fechar a caixa de diálogo de propriedade do ícone.
-24. No navegador, clique com o botão direito do mouse em jPanel e escolha Propriedades no menu pop-up.
-25. Na caixa de dialogo Propriedades, defina as propriedades `Grid X`, `Grid Y`, `Weight X` e `Weight Y` como `1` e a propriedade `Fill` como `Both`.
+
+[start=23]
+. Clique em OK para fechar a caixa de diálogo de propriedade do ícone.
+
+[start=24]
+. No navegador, clique com o botão direito do mouse em jPanel e escolha Propriedades no menu pop-up.
+
+[start=25]
+. Na caixa de dialogo Propriedades, defina as propriedades `Grid X`, `Grid Y`, `Weight X` e `Weight Y` como `1` e a propriedade `Fill` como `Both`.
[.feature]
--
image::images/panelprops-small.png[role="left", link="images/panelprops.png"]
--
-26. Clique em Fechar.
-27. Repita as etapas 24 e 25 para o jLabel.
-28. Na caixa de diálogo Propriedades, selecione a propriedade `text` e delete `jLabel1`.
+
+[start=26]
+. Clique em Fechar.
+
+[start=27]
+. Repita as etapas 24 e 25 para o jLabel.
+
+[start=28]
+. Na caixa de diálogo Propriedades, selecione a propriedade `text` e delete `jLabel1`.
[.feature]
--
@@ -277,8 +337,12 @@ Você precisa, primeiro, definir a classe principal do projeto. Quando você def
image::images/mainclass-small.png[role="left", link="images/mainclass.png"]
--
-4. Clique no botão Selecionar Classe Principal.
-5. Clique em OK para fechar a caixa de diálogo Propriedades do Projeto.
+
+[start=4]
+. Clique no botão Selecionar Classe Principal.
+
+[start=5]
+. Clique em OK para fechar a caixa de diálogo Propriedades do Projeto.
*Para construir o projeto:*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ru.asciidoc
index 61dc24c..b7ac48f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_ru.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74.png[title="Содержимое этой ст
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. Нажмите кнопку 'Готово'.
+
+[start=5]
+. Нажмите кнопку 'Готово'.
== Создание формы приложения
@@ -103,7 +105,9 @@ image::images/form-small.png[role="left", link="images/form.png"]
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. Нажмите кнопку 'Готово'.
+
+[start=2]
+. Нажмите кнопку 'Готово'.
В окне 'Проекты' в папке `Исходные пакеты` отображается новый пакет.
@@ -126,16 +130,24 @@ image::images/project-with-imagepack.png[]
image::images/importimage-small.png[role="left", link="images/importimage.png"]
--
-4. В диалоговом окне свойств значка щелкните Import to Project ("Импорт в проект").
-5. В окне выбора файлов выберите любое сохраненное в компьютере изображение. Затем нажмите кнопку "Дальше".
-6. На странице 'Выбор целевой папки' выберите папку `newpackage` и нажмите 'Готово'.
+
+[start=4]
+. В диалоговом окне свойств значка щелкните Import to Project ("Импорт в проект").
+
+[start=5]
+. В окне выбора файлов выберите любое сохраненное в компьютере изображение. Затем нажмите кнопку "Дальше".
+
+[start=6]
+. На странице 'Выбор целевой папки' выберите папку `newpackage` и нажмите 'Готово'.
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-7. Нажмите ОК, чтобы закрыть диалоговое окно свойств значка.
+
+[start=7]
+. Нажмите ОК, чтобы закрыть диалоговое окно свойств значка.
При нажатии на кнопку OK IDE выполняет следующие действия:
@@ -205,48 +217,96 @@ jLabel1.setIcon(new javax.swing.ImageIcon(getClass().getResource("/org/me/myimag
image::images/prj-small.png[role="left", link="images/prj.png"]
--
-5. Нажмите кнопку 'Готово'.
-6. В окне 'Проекты' разверните узел `BackgroundImageApp`.
-7. Щелкните правой кнопкой узел "Исходные файлы" и выберите форму "Создать" > "JFrame".
-8. В качестве имени класса введите `ImageDisplay`.
-9. В качестве имени пакета введите `org.me.mybackgroundapp`.
+
+[start=5]
+. Нажмите кнопку 'Готово'.
+
+[start=6]
+. В окне 'Проекты' разверните узел `BackgroundImageApp`.
+
+[start=7]
+. Щелкните правой кнопкой узел "Исходные файлы" и выберите форму "Создать" > "JFrame".
+
+[start=8]
+. В качестве имени класса введите `ImageDisplay`.
+
+[start=9]
+. В качестве имени пакета введите `org.me.mybackgroundapp`.
[.feature]
--
image::images/newjframe-small.png[role="left", link="images/newjframe.png"]
--
-10. Нажмите кнопку 'Готово'.
-11. В режиме конструирования щелкните правой кнопкой мыши объект JFrame и выберите 'Выбрать макет > Макет контейнера сетки' в контекстном меню.
-12. Щелкните правой кнопкой мыши объект JFrame и выберите Добавить из палитры > Контейнеры Swing > Панель в контекстном меню.
-13. В окне свойств отмените выбор свойства jPanel `opaque`.
-14. Щелкните правой кнопкой мыши объект JFrame и выберите Добавить из палитры > Элементы управления Swing > Метка в контекстном меню.
-15. В окне 'Проекты' щелкните правой кнопкой мыши узел `org.me.mybackgroundapp` и выберите 'Создать' > 'Пакет Java'.
-16. Нажмите кнопку "Готово". В результате будет добавлен новый пакет.
-17. В редакторе GUI Designer выберите метку, добавленную ранее в форму.
-18. В окне "Свойства" щелкните категорию "Свойства" и выполните прокрутку до свойства "Значок".
-19. Нажмите кнопку со многоточием (...).
-20. В диалоговом окне свойств значка щелкните Import to Project ("Импорт в проект").
-21. В окне выбора файлов выберите любое сохраненное в компьютере изображение. Затем нажмите кнопку "Дальше".
-22. На странице 'Выбор целевой папки' в мастере выберите каталог ресурсов `newpackage` и нажмите 'Готово'.
+
+[start=10]
+. Нажмите кнопку 'Готово'.
+
+[start=11]
+. В режиме конструирования щелкните правой кнопкой мыши объект JFrame и выберите 'Выбрать макет > Макет контейнера сетки' в контекстном меню.
+
+[start=12]
+. Щелкните правой кнопкой мыши объект JFrame и выберите Добавить из палитры > Контейнеры Swing > Панель в контекстном меню.
+
+[start=13]
+. В окне свойств отмените выбор свойства jPanel `opaque`.
+
+[start=14]
+. Щелкните правой кнопкой мыши объект JFrame и выберите Добавить из палитры > Элементы управления Swing > Метка в контекстном меню.
+
+[start=15]
+. В окне 'Проекты' щелкните правой кнопкой мыши узел `org.me.mybackgroundapp` и выберите 'Создать' > 'Пакет Java'.
+
+[start=16]
+. Нажмите кнопку "Готово". В результате будет добавлен новый пакет.
+
+[start=17]
+. В редакторе GUI Designer выберите метку, добавленную ранее в форму.
+
+[start=18]
+. В окне "Свойства" щелкните категорию "Свойства" и выполните прокрутку до свойства "Значок".
+
+[start=19]
+. Нажмите кнопку со многоточием (...).
+
+[start=20]
+. В диалоговом окне свойств значка щелкните Import to Project ("Импорт в проект").
+
+[start=21]
+. В окне выбора файлов выберите любое сохраненное в компьютере изображение. Затем нажмите кнопку "Дальше".
+
+[start=22]
+. На странице 'Выбор целевой папки' в мастере выберите каталог ресурсов `newpackage` и нажмите 'Готово'.
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-23. Нажмите ОК, чтобы закрыть диалоговое окно свойств значка.
-24. В навигаторе щелкните правой кнопкой мыши jPanel и выберите 'Свойства' во всплывающем меню.
-25. В диалоговом окне Properties ("Свойства") установите свойства `Grid X`, `Grid Y`, `Weight X` и `Weight Y` на `1`, а свойство `Fill` на `Both`.
+
+[start=23]
+. Нажмите ОК, чтобы закрыть диалоговое окно свойств значка.
+
+[start=24]
+. В навигаторе щелкните правой кнопкой мыши jPanel и выберите 'Свойства' во всплывающем меню.
+
+[start=25]
+. В диалоговом окне Properties ("Свойства") установите свойства `Grid X`, `Grid Y`, `Weight X` и `Weight Y` на `1`, а свойство `Fill` на `Both`.
[.feature]
--
image::images/panelprops-small.png[role="left", link="images/panelprops.png"]
--
-26. Выберите "Close" (Закрыть).
-27. Повторите шаги 24 и 25 для jLabel.
-28. В диалоговом окне 'Свойства' выберите свойство `text` и удалите `jLabel1`.
+
+[start=26]
+. Выберите "Close" (Закрыть).
+
+[start=27]
+. Повторите шаги 24 и 25 для jLabel.
+
+[start=28]
+. В диалоговом окне 'Свойства' выберите свойство `text` и удалите `jLabel1`.
[.feature]
--
@@ -277,8 +337,12 @@ image::images/background.png[]
image::images/mainclass-small.png[role="left", link="images/mainclass.png"]
--
-4. Нажмите кнопку 'Выбрать основной класс'.
-5. Нажмите кнопку "ОК" для закрытия диалогового окна "Свойства проекта".
+
+[start=4]
+. Нажмите кнопку 'Выбрать основной класс'.
+
+[start=5]
+. Нажмите кнопку "ОК" для закрытия диалогового окна "Свойства проекта".
*Для сборки проекта:*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_zh_CN.asciidoc
index d094b31..6d171aa 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/gui-image-display_zh_CN.asciidoc
@@ -63,7 +63,9 @@ image::images/netbeans-stamp-80-74.png[title="此页上的内容适用于 NetBea
image::images/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
== 创建应用程序窗体
@@ -103,7 +105,9 @@ image::images/form-small.png[role="left", link="images/form.png"]
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. 单击 "Finish"（完成）。
+
+[start=2]
+. 单击 "Finish"（完成）。
在 "Projects"（项目）窗口中，您应该会看到新包出现在 `Source Packages`（源包）文件夹内。
@@ -126,16 +130,24 @@ image::images/project-with-imagepack.png[]
image::images/importimage-small.png[role="left", link="images/importimage.png"]
--
-4. 在 icon 属性对话框中，单击 "Import to Project"（导入到项目）。
-5. 在文件选择器中，导航到系统上要使用的任何图像。然后，单击 "Next"（下一步）。
-6. 在向导的 "Select target folder"（选择目标文件夹）页中，选择 `newpackage` 文件夹，然后单击 "Finish"（完成）。
+
+[start=4]
+. 在 icon 属性对话框中，单击 "Import to Project"（导入到项目）。
+
+[start=5]
+. 在文件选择器中，导航到系统上要使用的任何图像。然后，单击 "Next"（下一步）。
+
+[start=6]
+. 在向导的 "Select target folder"（选择目标文件夹）页中，选择 `newpackage` 文件夹，然后单击 "Finish"（完成）。
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-7. 单击 "OK"（确定）以关闭 "icon property"（图标属性）对话框。
+
+[start=7]
+. 单击 "OK"（确定）以关闭 "icon property"（图标属性）对话框。
单击 "OK"（确定）后，IDE 将执行以下任务：
@@ -205,48 +217,96 @@ GUI 构建器不直接支持 JFrame 的背景图像，因为 Swing 不直接支
image::images/prj-small.png[role="left", link="images/prj.png"]
--
-5. 单击 "Finish"（完成）。
-6. 在 "Projects"（项目）窗口中，展开 `BackgroundImageApp` 节点。
-7. 右键单击 "Source Packages"（源包）节点，然后选择 "New"（新建）> "JFrame Form"（JFrame 窗体）。
-8. 键入 `ImageDisplay` 作为类名。
-9. 键入 `org.me.mybackgroundapp` 作为包名。
+
+[start=5]
+. 单击 "Finish"（完成）。
+
+[start=6]
+. 在 "Projects"（项目）窗口中，展开 `BackgroundImageApp` 节点。
+
+[start=7]
+. 右键单击 "Source Packages"（源包）节点，然后选择 "New"（新建）> "JFrame Form"（JFrame 窗体）。
+
+[start=8]
+. 键入 `ImageDisplay` 作为类名。
+
+[start=9]
+. 键入 `org.me.mybackgroundapp` 作为包名。
[.feature]
--
image::images/newjframe-small.png[role="left", link="images/newjframe.png"]
--
-10. 单击 "Finish"（完成）。
-11. 在 "Design"（设计）视图中，右键单击 "JFrame"，然后从弹出式菜单中选择 "Set Layout"（设置布局）> "Grid Bag Layout"（网格包布局）。
-12. 右键单击 "JFrame"，然后从弹出式菜单中选择 "Add From Palette"（从组件面板上添加）> "Swing Containers"（Swing 容器）> "Panel"（面板）。
-13. 在 "Properties"（属性）窗口中，取消选择 jPanel 的 `opaque` 属性。
-14. 右键单击 "JFrame"，然后从弹出式菜单中选择 "Add From Palette"（从组件面板上添加）> "Swing Controls"（Swing 控件）> "Label"（标签）。
-15. 在 "Projects"（项目）窗口中，右键单击 `org.me.mybackgroundapp` 节点，然后选择 "New"（新建）> "Java Package"（Java 包）。
-16. 单击 "Finish"（完成）。添加新包。
-17. 在 GUI 设计器中，选择已添加到窗体上的标签。
-18. 在 "Properties"（属性）窗口中，单击 "Properties"（属性）类别，然后滚动到 icon 属性。
-19. 单击省略号 (...) 按钮。
-20. 在 icon 属性对话框中，单击 "Import to Project"（导入到项目）。
-21. 在文件选择器中，导航到系统上要使用的任何图像。然后，单击 "Next"（下一步）。
-22. 在向导的 "Select Target Folder"（选择目标文件夹）页中，选择 `newpackage` 资源文件夹，然后单击 "Finish"（完成）。
+
+[start=10]
+. 单击 "Finish"（完成）。
+
+[start=11]
+. 在 "Design"（设计）视图中，右键单击 "JFrame"，然后从弹出式菜单中选择 "Set Layout"（设置布局）> "Grid Bag Layout"（网格包布局）。
+
+[start=12]
+. 右键单击 "JFrame"，然后从弹出式菜单中选择 "Add From Palette"（从组件面板上添加）> "Swing Containers"（Swing 容器）> "Panel"（面板）。
+
+[start=13]
+. 在 "Properties"（属性）窗口中，取消选择 jPanel 的 `opaque` 属性。
+
+[start=14]
+. 右键单击 "JFrame"，然后从弹出式菜单中选择 "Add From Palette"（从组件面板上添加）> "Swing Controls"（Swing 控件）> "Label"（标签）。
+
+[start=15]
+. 在 "Projects"（项目）窗口中，右键单击 `org.me.mybackgroundapp` 节点，然后选择 "New"（新建）> "Java Package"（Java 包）。
+
+[start=16]
+. 单击 "Finish"（完成）。添加新包。
+
+[start=17]
+. 在 GUI 设计器中，选择已添加到窗体上的标签。
+
+[start=18]
+. 在 "Properties"（属性）窗口中，单击 "Properties"（属性）类别，然后滚动到 icon 属性。
+
+[start=19]
+. 单击省略号 (...) 按钮。
+
+[start=20]
+. 在 icon 属性对话框中，单击 "Import to Project"（导入到项目）。
+
+[start=21]
+. 在文件选择器中，导航到系统上要使用的任何图像。然后，单击 "Next"（下一步）。
+
+[start=22]
+. 在向导的 "Select Target Folder"（选择目标文件夹）页中，选择 `newpackage` 资源文件夹，然后单击 "Finish"（完成）。
[.feature]
--
image::images/targetfolder-small.png[role="left", link="images/targetfolder.png"]
--
-23. 单击 "OK"（确定）以关闭 "icon property"（图标属性）对话框。
-24. 在 "Navigator"（导航器）窗口中，右键单击 "jPanel"，然后从弹出式菜单中选择 "Properties"（属性）。
-25. 在 "Properties"（属性）对话框中，将 `Grid X`、`Grid Y`、`Weight X` 和 `Weight Y` 属性设置为 `1`，并将 `Fill` 属性设置为 `Both`。
+
+[start=23]
+. 单击 "OK"（确定）以关闭 "icon property"（图标属性）对话框。
+
+[start=24]
+. 在 "Navigator"（导航器）窗口中，右键单击 "jPanel"，然后从弹出式菜单中选择 "Properties"（属性）。
+
+[start=25]
+. 在 "Properties"（属性）对话框中，将 `Grid X`、`Grid Y`、`Weight X` 和 `Weight Y` 属性设置为 `1`，并将 `Fill` 属性设置为 `Both`。
[.feature]
--
image::images/panelprops-small.png[role="left", link="images/panelprops.png"]
--
-26. 单击 "Close"（关闭）。
-27. 针对 jLabel 重复步骤 24 和 25。
-28. 在 "Properties"（属性）对话框中，选择 `text` 属性，然后删除 `jLabel1`。
+
+[start=26]
+. 单击 "Close"（关闭）。
+
+[start=27]
+. 针对 jLabel 重复步骤 24 和 25。
+
+[start=28]
+. 在 "Properties"（属性）对话框中，选择 `text` 属性，然后删除 `jLabel1`。
[.feature]
--
@@ -277,8 +337,12 @@ image::images/background.png[]
image::images/mainclass-small.png[role="left", link="images/mainclass.png"]
--
-4. 单击 "Select Main Class"（选择主类）按钮。
-5. 单击“确定”。关闭“项目属性”对话框。
+
+[start=4]
+. 单击 "Select Main Class"（选择主类）按钮。
+
+[start=5]
+. 单击“确定”。关闭“项目属性”对话框。
*要构建项目，请执行以下操作：*
diff --git a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se.asciidoc
index 23dd51e..888f5be 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se.asciidoc
@@ -80,7 +80,9 @@ image::images/create-sakila-mysql.png[title="Screenshot of Create MySQL Database
When you click OK a Sakila node appears under the MySQL Server node.
-5. Right-click the Sakila node and choose Connect.
+
+[start=5]
+. Right-click the Sakila node and choose Connect.
When you click Connect a database connection node for the Sakila database ( ``jdbc:mysql://localhost:3306/sakila [_username_ on Default]`` ) is listed under the Databases node. When a connection is open you can view the data in the database by expanding the connection node.
@@ -93,7 +95,9 @@ In this exercise you create a simple Java Swing application project called DVDSt
2. Type *DVDStoreAdmin* for the project name and set the project location.
3. Deselect the Use Dedicated Folder option, if selected.
For this tutorial there is little reason to copy project libraries to a dedicated folder because you will not need to share libraries with other users.
-4. Deselect Create Main Class. Click Finish.
+
+[start=4]
+. Deselect Create Main Class. Click Finish.
When you click Finish, the IDE creates the Java application project. The project does not have a main class. You will create a form and then set the form as the main class.
@@ -133,8 +137,12 @@ In this exercise you will edit the default properties specified in ``hibernate.
3. Click Add to open the Add Hibernate Property dialog box.
4. In the dialog box, select the ``hibernate.show_sql`` property and set the value to ``true`` . Click OK. This enables the debug logging of the SQL statements.
image::images/add-property-showsql.png[title="Add Hibernate Property dialog box showing setting value for the hibernate.show_sql property"]
-5. Click Add under the Miscellaneous Properties node and select ``hibernate.query.factory_class`` in the Property Name dropdown list.
-6. Type *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* as the Property Value.
+
+[start=5]
+. Click Add under the Miscellaneous Properties node and select ``hibernate.query.factory_class`` in the Property Name dropdown list.
+
+[start=6]
+. Type *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* as the Property Value.
This is the translator factory class that is used in Hibernate 4 that is bundled with the IDE.
@@ -164,7 +172,9 @@ If you click the XML tab in the editor you can see the file in XML view. Your fi
</session-factory>
</hibernate-configuration>
----
-7. Save your changes to the file.
+
+[start=7]
+. Save your changes to the file.
After you create the form and set it as the main class you will be able to see the SQL query printed in the IDE's Output window when you run the project.
@@ -178,7 +188,9 @@ In this section you use the New File wizard to create the helper class ``Hibern
1. Right-click the Source Packages node and select New > Other to open the New File wizard.
2. Select Hibernate from the Categories list and HibernateUtil.java from the File Types list. Click Next.
image::images/hib-util.png[title="New File wizard showing how to create HibernateUtil"]
-3. Type *HibernateUtil* for the class name and *sakila.util* as the package name. Click Finish.
+
+[start=3]
+. Type *HibernateUtil* for the class name and *sakila.util* as the package name. Click Finish.
When you click Finish, ``HibernateUtil.java`` opens in the editor. You can close the file because you do not need to edit the file.
@@ -268,7 +280,9 @@ You do not need to assign Variable Name values to the Label elements.
|Table | ``resultTable``
|===
-9. Save your changes.
+
+[start=9]
+. Save your changes.
In Design view your form should look similar to the following image.
@@ -291,7 +305,9 @@ In this exercise you use the HQL Editor to construct simple HQL queries that ret
When you click Run HQL Query you should see the query results in the bottom pane of the HQL Query Editor.
image::images/hib-query-hqlresults.png[title="HQL Query Editor showing HQL query results"]
-5. Type the following query in the HQL Query Editor and click Run HQL Query to check the query results when the search string is 'PE'.
+
+[start=5]
+. Type the following query in the HQL Query Editor and click Run HQL Query to check the query results when the search string is 'PE'.
[source,java]
----
@@ -309,7 +325,9 @@ If you click the SQL button above the results you should see the following equiv
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. Open a new HQL Query Editor tab and type the following query in the editor pane. Click Run HQL Query.
+
+[start=6]
+. Open a new HQL Query Editor tab and type the following query in the editor pane. Click Run HQL Query.
[source,java]
----
@@ -342,7 +360,9 @@ private static String QUERY_BASED_ON_LAST_NAME="from Actor a where a.lastName li
It is possible to copy the queries from the HQL Query Editor tabs into the file and then modify the code.
-3. Add the following methods to create the query based on the user input string.
+
+[start=3]
+. Add the following methods to create the query based on the user input string.
[source,java]
----
@@ -358,7 +378,9 @@ private void runQueryBasedOnLastName() {
The methods call a method called ``executeHQLQuery()`` and create the query by combining the query string with the user entered search string.
-4. Add the ``executeHQLQuery()`` method.
+
+[start=4]
+. Add the ``executeHQLQuery()`` method.
[source,java]
----
@@ -379,12 +401,18 @@ private void executeHQLQuery(String hql) {
The ``executeHQLQuery()`` method calls Hibernate to execute the selected query. This method makes use of the ``HibernateUtil.java`` utility class to obtain the Hibernate Session.
-5. Right-click in the editor and choose Fix Imports (Ctrl-Shift-I; ⌘-Shift-I on Mac) to generate import statements for the Hibernate libraries ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) and ``java.util.List`` . Save your changes.
-6. Create a Query button event handler by switching to the Design view and double-clicking the Query button.
+
+[start=5]
+. Right-click in the editor and choose Fix Imports (Ctrl-Shift-I; ⌘-Shift-I on Mac) to generate import statements for the Hibernate libraries ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) and ``java.util.List`` . Save your changes.
+
+[start=6]
+. Create a Query button event handler by switching to the Design view and double-clicking the Query button.
The IDE creates the ``queryButtonActionPerformed`` method and displays the method in the Source view.
-7. Modify the ``queryButtonActionPerformed`` method in the Source view by adding the following code so that a query is run when the user clicks the button.
+
+[start=7]
+. Modify the ``queryButtonActionPerformed`` method in the Source view by adding the following code so that a query is run when the user clicks the button.
[source,java]
----
@@ -397,7 +425,9 @@ private void queryButtonActionPerformed(java.awt.event.ActionEvent evt) {
}*
}
----
-8. Add the following method to display the results in the JTable.
+
+[start=8]
+. Add the following method to display the results in the JTable.
[source,java]
----
@@ -422,7 +452,9 @@ private void displayResult(List resultList) {
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Right-click in the editor and choose Fix Imports (Ctrl-Shift-I; ⌘-Shift-I on Mac) to generate an import statement for ``java.util.Vector`` and ``java.util.List`` . Save your changes.
+
+[start=9]
+. Right-click in the editor and choose Fix Imports (Ctrl-Shift-I; ⌘-Shift-I on Mac) to generate an import statement for ``java.util.Vector`` and ``java.util.List`` . Save your changes.
After you save the form you can run the project.
@@ -438,7 +470,9 @@ Now that the coding is finished, you can launch the application. Before you run
Alternatively, you can click the Browse button and choose the main class in the dialog box.
image::images/browse-main-class.png[title="Setting the main class in the Browse Main Classes dialog"]
-4. Click Run Project in the main toolbar to launch the application.
+
+[start=4]
+. Click Run Project in the main toolbar to launch the application.
Type in a search string in the First Name or Last Name text field and click Query to search for an actor and see the details.
@@ -457,14 +491,24 @@ You can download the solution to this tutorial as a project in the following way
2. In the Checkout dialog box, enter the following Repository URL:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Click Next.
-3. Click Browse to open the Browse Repostiory Folders dialog box.
-4. Expand the root node and select *samples/java/DVDStoreAdmin-Ant*. Click OK.
-5. Specify the Local Folder for the sources (the local folder must be empty).
-6. Click Finish.
+
+[start=3]
+. Click Browse to open the Browse Repostiory Folders dialog box.
+
+[start=4]
+. Expand the root node and select *samples/java/DVDStoreAdmin-Ant*. Click OK.
+
+[start=5]
+. Specify the Local Folder for the sources (the local folder must be empty).
+
+[start=6]
+. Click Finish.
When you click Finish, the IDE initializes the local folder as a Subversion repository and checks out the project sources.
-7. Click Open Project in the dialog that appears when checkout is complete.
+
+[start=7]
+. Click Open Project in the dialog that appears when checkout is complete.
*Note.* You need a Subversion client to checkout the sources. For more about installing Subversion, see the section on link:../ide/subversion.html#settingUp[+Setting up Subversion+] in the link:../ide/subversion.html[+Guide to Subversion in NetBeans IDE+].
@@ -489,13 +533,19 @@ public class Actor *implements Serializable* {
private Date lastUpdate;*
}
----
-4. Right-click in the editor and choose Insert Code (Alt-Insert; Ctrl-I on Mac) and select Getter and Setter in the popup menu to generate getters and setters for the fields.
-5. In the Generate Getters and Setters dialog box, select all the fields and click Generate.
+
+[start=4]
+. Right-click in the editor and choose Insert Code (Alt-Insert; Ctrl-I on Mac) and select Getter and Setter in the popup menu to generate getters and setters for the fields.
+
+[start=5]
+. In the Generate Getters and Setters dialog box, select all the fields and click Generate.
image::images/getters-setters.png[title="Generate Getters and Setters dialog box"]
In the Generate Getters and Setters dialog box, you can use the Up arrow on the keyboard to move the selected item to the Actor node and then press the Space bar to select all fields in Actor.
-6. Fix your imports and save your changes.
+
+[start=6]
+. Fix your imports and save your changes.
After you create the POJO for the table you will want to create an Hibernate Mapping File for ``Actor.java`` .
@@ -515,7 +565,9 @@ When you click Finish the ``Actor.hbm.xml`` Hibernate mapping file opens in th
</session-factory>
</hibernate-configuration>
----
-5. Map the fields in ``Actor.java`` to the columns in the ACTOR table by making the following changes (in bold) to ``Actor.hbm.xml`` .
+
+[start=5]
+. Map the fields in ``Actor.java`` to the columns in the ACTOR table by making the following changes (in bold) to ``Actor.hbm.xml`` .
[source,xml]
----
@@ -552,7 +604,9 @@ NOTE: By default, the generated ``class`` element has a closing tag. Because y
</class>*
</hibernate-mapping>
----
-6. Click the Validate XML button in the toolbar and save your changes.
+
+[start=6]
+. Click the Validate XML button in the toolbar and save your changes.
Creating individual POJOs and Hibernate mapping files might be a convenient way to further customizing your application.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ja.asciidoc
index a5c8eb4..3ef1a5e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ja.asciidoc
@@ -80,7 +80,9 @@ image::images/create-sakila-mysql.png[title="「MySQLデータベースの作成
「OK」をクリックすると、「MySQLサーバー」ノードの下に「Sakila」ノードが表示されます。
-5. 「Sakila」ノードを右クリックし、「接続」を選択します。
+
+[start=5]
+. 「Sakila」ノードを右クリックし、「接続」を選択します。
「接続」をクリックすると、「Sakila」データベースのデータベース接続のノード( ``jdbc:mysql://localhost:3306/sakila [デフォルトの_ユーザー名_]`` )が「データベース」ノードに一覧表示されます。接続が開いたら、接続ノードを展開してデータベースのデータを表示できます。
@@ -93,7 +95,9 @@ image::images/create-sakila-mysql.png[title="「MySQLデータベースの作成
2. プロジェクト名に「*DVDStoreAdmin*」と入力し、プロジェクトの場所を設定します。
3. 専用フォルダを使用するオプションが選択されている場合は選択を解除します。
このチュートリアルでは、ライブラリを他のユーザーと共有する必要がないので、プロジェクト・ライブラリを専用のフォルダにコピーする理由はほとんどありません。
-4. 「メイン・クラスの作成」の選択を解除します。「終了」をクリックします。
+
+[start=4]
+. 「メイン・クラスの作成」の選択を解除します。「終了」をクリックします。
「終了」をクリックすると、IDEでJavaアプリケーション・プロジェクトが作成されます。このプロジェクトにはメイン・クラスが設定されていません。フォームを作成し、このフォームをメイン・クラスとして設定します。
@@ -133,8 +137,12 @@ image::images/hib-libraries-config.png[title="Hibernateライブラリが表示
3. 「追加」をクリックして「Hibernateのプロパティの追加」ダイアログ・ボックスを開きます。
4. このダイアログ・ボックスで、「 ``hibernate.show_sql`` 」プロパティを選択し、値を「 ``true`` 」に設定します。「OK」をクリックします。これにより、SQL文のデバッグ・ロギングが有効になります。
image::images/add-property-showsql.png[title="hibernate.show_sqlプロパティの設定値が表示された「Hibernateのプロパティの追加」ダイアログ・ボックス"]
-5. 「その他のプロパティ」ノードの下にある「追加」をクリックし、「プロパティ名」ドロップダウン・リストで「 ``hibernate.query.factory_class`` 」を選択します。
-6. プロパティ値として*org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory*を入力します。
+
+[start=5]
+. 「その他のプロパティ」ノードの下にある「追加」をクリックし、「プロパティ名」ドロップダウン・リストで「 ``hibernate.query.factory_class`` 」を選択します。
+
+[start=6]
+. プロパティ値として*org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory*を入力します。
これは、IDEにバンドルされているHibernate 4で使用されるトランスレータ・ファクトリ・クラスです。
@@ -164,7 +172,9 @@ image::images/add-property-factoryclass.png[title="hibernate.query.factory_class
</session-factory>
</hibernate-configuration>
----
-7. 変更内容をファイルに保存します。
+
+[start=7]
+. 変更内容をファイルに保存します。
フォームを作成してメイン・クラスとして設定した後に、プロジェクトを実行すると、IDEの出力ウィンドウにSQL問合せが表示されます。
@@ -178,7 +188,9 @@ Hibernateを使用するには、起動を処理し、Hibernateの ``SessionFact
1. 「ソース・パッケージ」ノードを右クリックし、「新規」>「その他」を選択して新規ファイル・ウィザードを開きます。
2. 「カテゴリ」の一覧から「Hibernate」を選択し、「ファイル・タイプ」の一覧から「HibernateUtil.java」を選択します。「次」をクリックします。
image::images/hib-util.png[title="HibernateUtilの作成方法を示す新規ファイル・ウィザード"]
-3. クラス名として「*HibernateUtil*」を入力し、パッケージ名として「*sakila.util*」を入力します。「終了」をクリックします。
+
+[start=3]
+. クラス名として「*HibernateUtil*」を入力し、パッケージ名として「*sakila.util*」を入力します。「終了」をクリックします。
「終了」をクリックすると、 ``HibernateUtil.java`` がエディタに表示されます。このファイルは、編集する必要がないため閉じてかまいません。
@@ -268,7 +280,9 @@ GUIビルダーを使用したフォームの作成に慣れていない場合
|表 | ``resultTable``
|===
-9. 変更を保存します。
+
+[start=9]
+. 変更を保存します。
デザイン・ビューのフォームは、次のイメージのような外観になります。
@@ -291,7 +305,9 @@ IDEで、HQL問合せエディタを使用してHibernate問合せ言語(HQL)に
「HQL問合せの実行」をクリックすると、問合せ結果がHQL問合せエディタの下のペインに表示されるはずです。
image::images/hib-query-hqlresults.png[title="HQL問合せ結果が表示されたHQL問合せエディタ"]
-5. 検索文字列が「PE」の場合、次の問合せをHQL問合せエディタに入力して「HQL問合せの実行」をクリックし、問合せ結果を確認します。
+
+[start=5]
+. 検索文字列が「PE」の場合、次の問合せをHQL問合せエディタに入力して「HQL問合せの実行」をクリックし、問合せ結果を確認します。
[source,java]
----
@@ -309,7 +325,9 @@ from Actor a where a.firstName like 'PE%'
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. 新しいHQL問合せエディタのタブを開き、次の問合せをエディタ・ペインに入力します。「HQL問合せの実行」をクリックします。
+
+[start=6]
+. 新しいHQL問合せエディタのタブを開き、次の問合せをエディタ・ペインに入力します。「HQL問合せの実行」をクリックします。
[source,java]
----
@@ -342,7 +360,9 @@ private static String QUERY_BASED_ON_LAST_NAME="from Actor a where a.lastName li
問合せをHQL問合せエディタのタブからファイルにコピーし、コードを変更できます。
-3. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
+
+[start=3]
+. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
... 15254 lines suppressed ...
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists