[NETBEANS-1867] java section cleanup
Markup cleanup of some kb/docs/java tutorials.
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 @@
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 @@
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 @@
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 @@
}
----
+
+
[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 @@
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 @@
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 @@
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 @@
}
----
+
+
[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 @@
「終了」をクリックすると、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 @@
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 @@
ここで、 ``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 @@
}
*}
----
-10. 「 ``AnnProcessor`` 」プロジェクトを右クリックし、「ビルド」を選択することによってプロジェクトをビルドします。
+
+[start=10]
+. 「 ``AnnProcessor`` 」プロジェクトを右クリックし、「ビルド」を選択することによってプロジェクトをビルドします。
== IDEでの注釈プロセッサの使用
@@ -325,8 +345,12 @@
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 @@
``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 @@
}
}
----
-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 @@
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 @@
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 @@
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 @@
}
*}
----
-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 @@
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 @@
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 @@
}
}
----
-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 @@
При нажатии кнопки "Готово" среда 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 @@
После создания двух пакетов 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 @@
Теперь необходимо добавить к обработчику аннотаций код для обработки аннотации ``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 @@
}
*}
----
-10. Создайте проект, щелкнув правой кнопкой мыши проект ``AnnProcessor`` и выбрав 'Сборка'.
+
+[start=10]
+. Создайте проект, щелкнув правой кнопкой мыши проект ``AnnProcessor`` и выбрав 'Сборка'.
== Работа с обработчиком аннотаций в среде IDE
@@ -325,8 +345,12 @@
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 @@
После сохранения кода ``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 @@
}
}
----
-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 @@
单击 "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 @@
创建了这两个 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 @@
现在，您需要为标注处理程序添加处理 ``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 @@
}
*}
----
-10. 右键单击 ``AnnProcessor`` 项目，然后选择 "Build"（构建）以构建项目。
+
+[start=10]
+. 右键单击 ``AnnProcessor`` 项目，然后选择 "Build"（构建）以构建项目。
== 在 IDE 中使用标注处理程序
@@ -325,8 +345,12 @@
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 @@
保存 ``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 @@
}
}
----
-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 @@
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 @@
}
----
+
+
[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 @@
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 @@
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 @@
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 @@
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 @@
}
----
+
+
[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 @@
}
----
+
+
[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 @@
「終了」をクリックすると、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 @@
}
----
-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 @@
「コンパイル」タブで追加されたリソースは、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 @@
プロジェクト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 @@
コード補完ウィンドウを呼び出すと([Ctrl]-[Space])、生成されたアーティファクトも選択可能になっているのが確認できます。ここで、プロジェクトがコンパイルされ、生成されたアーティファクトをプログラムの他の部分からコールできることを確認します。
-3. _main_メソッドで ``TestBooks.java`` ファイルを開き、次のコード(太字)を追加して、 ``MyBooks`` クラスの新規オブジェクトを作成します。
+
+[start=3]
+. _main_メソッドで ``TestBooks.java`` ファイルを開き、次のコード(太字)を追加して、 ``MyBooks`` クラスの新規オブジェクトを作成します。
[source,java]
----
@@ -168,7 +190,9 @@
}
}
----
-4. ``books`` 変数の値を出力するための次のコードを追加します。
+
+[start=4]
+. ``books`` 変数の値を出力するための次のコードを追加します。
値を返すため、 ``lombok.jar`` によって自動生成された取得メソッドをコールします。入力中に、自動生成されたアーティファクトをコード補完ウィンドウから使用できます。
@@ -186,8 +210,12 @@
}
}
----
-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 @@
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 @@
}
----
-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 @@
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 @@
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 @@
É 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 @@
}
}
----
-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 @@
}
}
----
-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 @@
После нажатия кнопки "Готово" среда 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 @@
}
----
-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 @@
Ресурсы, добавленные на вкладке "Компиляция", соответствуют параметру ``-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 @@
Дополнительные сведения об аннотациях, поддерживаемых в проекте 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 @@
Можно также вызвать окно автозавершения кода (CTRL+ПРОБЕЛ) и проверить доступность созданных артефактов для выбора. Теперь необходимо убедиться, что проект выполняет компиляцию, а созданные артефакты можно вызвать из других компонентов программы.
-3. Откройте файл ``TestBooks.java`` с методом _main_ и добавьте следующий код (выделен полужирным шрифтом), чтобы создать новый объект класса ``MyBooks`` .
+
+[start=3]
+. Откройте файл ``TestBooks.java`` с методом _main_ и добавьте следующий код (выделен полужирным шрифтом), чтобы создать новый объект класса ``MyBooks`` .
[source,java]
----
@@ -168,7 +190,9 @@
}
}
----
-4. Добавьте следующий код, который выводит на экран значения переменной ``books`` .
+
+[start=4]
+. Добавьте следующий код, который выводит на экран значения переменной ``books`` .
Для возврата значений следует вызвать методы получения, автоматически созданные в файле ``lombok.jar`` . Обратите внимание, что при вводе автоматически созданные артефакты доступны в окне автозавершения кода.
@@ -186,8 +210,12 @@
}
}
----
-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 @@
单击 "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 @@
}
----
-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 @@
在 "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 @@
要了解有关 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 @@
还可以调用代码完成窗口（Ctrl-空格键），然后查看生成的工件是否可供选择。现在，我们看到项目已编译，生成的工件可以通过程序的其他部分调用。
-3. 打开包含 _main_ 方法的 ``TestBooks.java`` 文件，并添加下面的代码（粗体）以创建 ``MyBooks`` 类的新对象。
+
+[start=3]
+. 打开包含 _main_ 方法的 ``TestBooks.java`` 文件，并添加下面的代码（粗体）以创建 ``MyBooks`` 类的新对象。
[source,java]
----
@@ -168,7 +190,9 @@
}
}
----
-4. 添加以下代码，以输出 ``books`` 变量的值。
+
+[start=4]
+. 添加以下代码，以输出 ``books`` 变量的值。
要返回值，我们调用 ``lombok.jar`` 自动生成的 getter 方法。键入时，请注意代码完成窗口是否提供了自动生成的工件。
@@ -186,8 +210,12 @@
}
}
----
-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 @@
--
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 @@
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 @@
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 @@
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 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 @@
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 @@
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 @@
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 @@
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/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 @@
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/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/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 @@
このチュートリアルでは、アプリケーションを実際には実行せずに、FindBugsおよびNetBeans Javaヒントを使用してJavaコードの静的分析を実行する方法を学習します。
-
-=== 内容
-
-image::images/netbeans-stamp.png[title="このページの内容は、NetBeans IDE 8.0に適用されます"]
+== 内容
* <<setup,チュートリアルの環境の設定>>
* <<config,構成の使用>>
@@ -92,15 +89,21 @@
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 @@
*注意:* この構成を最初に実行する前に、<<plugin,FindBugs>>プラグインをインストールする必要があります。
-4. 「検査」をクリックします。
+
+[start=4]
+. 「検査」をクリックします。
分析の結果が「インスペクタ・ウィンドウ」の左にツリー・ビューとして表示されます。
[.feature]
@@ -164,19 +169,25 @@
*注意:* 「 ``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 @@
*注意:* 「 ``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/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/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 @@
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-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/delete.png[]
-5. 「構成の削除」ダイアログ・ボックスで、「はい」をクリックして構成の削除を確認します。
+
+[start=5]
+. 「構成の削除」ダイアログ・ボックスで、「はい」をクリックして構成の削除を確認します。
image::images/delete-confirm.png[]
@@ -359,7 +396,9 @@
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 @@
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 @@
*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 @@
*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 @@
*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 @@
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/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 @@
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 @@
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/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/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/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 @@
*Примечание.* Необходимо установить подключаемый модуль <<plugin,FindBugs>> для запуска этой конфигурации в первый раз.
-4. Нажмите кнопку "Проверить".
+
+[start=4]
+. Нажмите кнопку "Проверить".
Результаты анализа отображаются в окне 'Инспектор' в представлении дерева слева.
[.feature]
@@ -153,19 +161,25 @@
*Примечание.* Можно определить область (файлы. пакеты или проекты) для конфигурации ``Подсказки 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 @@
*Примечание.* Можно проверить файлы, пакеты или проекты с помощью конфигурации ``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/inspector-small.png[role="left", link="images/inspector.png"]
--
-5. В качестве альтернативы нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
+
+[start=5]
+. В качестве альтернативы нажмите кнопку <<categorize,Категоризировать>> на панели инструментов слева для просмотра проблем, сгруппированных в категории.
image::images/fbcat.png[]
@@ -241,8 +261,12 @@
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 @@
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-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/delete.png[]
-5. В диалоговом окне 'Удалить конфигурацию' щелкните 'Да', чтобы подствердить удаление конфигурации.
+
+[start=5]
+. В диалоговом окне 'Удалить конфигурацию' щелкните 'Да', чтобы подствердить удаление конфигурации.
image::images/delete-confirm.png[]
@@ -348,7 +388,9 @@
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/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 @@
*注：*首次运行此配置时，需要安装 <<plugin,FindBugs>> 插件。
-4. 单击 "Inspect"（检查）。
+
+[start=4]
+. 单击 "Inspect"（检查）。
分析的结果以树视图显示在 "Inspector"（检查器）窗口的左侧。
[.feature]
@@ -153,19 +161,25 @@
*注：*可以为 ``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 @@
*注：*可以使用 ``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/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/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 @@
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-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/delete.png[]
-5. 在 "Delete Configuration"（删除配置）对话框中，单击 "Yes"（是）以确认删除配置。
+
+[start=5]
+. 在 "Delete Configuration"（删除配置）对话框中，单击 "Yes"（是）以确认删除配置。
image::images/delete-confirm.png[]
@@ -348,7 +388,9 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
*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 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 @@
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 @@
「開く」をクリックすると、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 @@
「開く」をクリックすると、IDEによりプロジェクトが「プロジェクト」ウィンドウで開かれ、表示されます。「プロジェクト」ウィンドウでプロジェクト・ノードを展開すると、このプロジェクトが単純なJavaアプリケーションであることがわかります。
-3. プロジェクト・ノードを右クリックし、「実行」を選択してDeadlockアプリケーションを起動します。
+
+[start=3]
+. プロジェクト・ノードを右クリックし、「実行」を選択してDeadlockアプリケーションを起動します。
「実行」をクリックすると、「出力」ウィンドウが開き、次の出力が表示されます。
@@ -121,7 +139,9 @@
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. アプリケーションが通常どおり終了するのを待ちます(5分)。
+
+[start=4]
+. アプリケーションが通常どおり終了するのを待ちます(5分)。
Deadlockアプリケーションが終了したら、次の内容が「出力」ウィンドウに表示されます。
@@ -148,12 +168,16 @@
「デバッグ」をクリックすると、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 @@
エディタのマージンにある「プログラム・カウンタ」に、メソッドのステップ実行での位置が示されます。
-6. Galleryアプリケーションで「詳細表示」をクリックして、メソッド・ブレークポイントをヒットする新しいスレッドを開始します。
+
+[start=6]
+. Galleryアプリケーションで「詳細表示」をクリックして、メソッド・ブレークポイントをヒットする新しいスレッドを開始します。
新しいスレッドがメソッド・ブレークポイントをヒットすると、メソッドのステップ実行中に別のスレッドがブレークポイントをヒットしたことを通知する「新しいブレークポイントのヒット」通知が「デバッグ」ウィンドウに表示されます。
@@ -189,15 +215,21 @@
*注意:*「デバッグ」ウィンドウでは、現在のスレッド(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 @@
ブレークポイントを設定するには、ブレークポイントを設定する行の横で、ソース・エディタ内のマージンをクリックします。ブレークポイント注釈が、行の横の左マージンに表示されます。「ブレークポイント」ウィンドウ([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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
*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 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 @@
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 @@
При выборе "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 @@
При выборе "Open" в среде IDE проект будет открыт и выведен на экран в окне "Projects". После развертывания узла проекта в окне "Projects" видно, что он представляет собой простое приложение Java.
-3. Для запуска приложения "Deadlock" щелкните правой кнопкой мыши узел проекта и выберите "Run".
+
+[start=3]
+. Для запуска приложения "Deadlock" щелкните правой кнопкой мыши узел проекта и выберите "Run".
При нажатии кнопки "Run" откроется окно "Output", в котором отображается следующая выходная информация.
@@ -121,7 +139,9 @@
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. Пусть приложение нормально завершит работу (пять минут).
+
+[start=4]
+. Пусть приложение нормально завершит работу (пять минут).
По завершении работы приложения "Deadlock" в окне "Output" должна отображаться следующая информация.
@@ -148,12 +168,16 @@
После нажатия кнопки "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 @@
В счетчике строк кода в поле редактора отображается текущее положение в коде при пошаговом выполнении метода.
-6. Нажмите кнопку "More" в приложении "Gallery" для запуска нового потока выполнения, который должен достичь точки останова.
+
+[start=6]
+. Нажмите кнопку "More" в приложении "Gallery" для запуска нового потока выполнения, который должен достичь точки останова.
Когда новый поток выполнения достигнет точки останова, установленной в методе, в окне "Debugging" появится уведомление "New Breakpoint Hit", информирующее о том, что еще один поток выполнения достиг точки останова в процессе последовательного выполнения метода.
@@ -189,15 +215,21 @@
*Примечание.* В окне "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 @@
Для установки точки останова в поле редактора исходного кода щелкните поле напротив строки, в которой требуется установить точку останова. В левом поле напротив этой строки появится аннотация точки останова. Если открыть окно 'Точки останова' (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 @@
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 @@
单击 "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 @@
单击 "Open"（打开）之后，IDE 将在 "Projects"（项目）窗口中打开并显示该项目。如果在 "Projects"（项目）窗口中展开该节点，您可以看到该项目是一个简单的 Java 应用程序。
-3. 右键单击该项目节点并选择 "Run"（运行）以启动 Deadlock 应用程序。
+
+[start=3]
+. 右键单击该项目节点并选择 "Run"（运行）以启动 Deadlock 应用程序。
单击 "Run"（运行）之后，"Output"（输出）窗口将打开并显示以下输出。
@@ -121,7 +139,9 @@
MyThread2 successfully finished.
MyThread1 successfully finished
----
-4. 等待应用程序正常结束（五分钟）。
+
+[start=4]
+. 等待应用程序正常结束（五分钟）。
当 Deadlock 应用程序结束时，您将在 "Output"（输出）窗口中看到以下内容。
@@ -148,12 +168,16 @@
单击 "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 @@
单步调试该方法时，您可以看到编辑器旁注中的程序计数器指示了您的位置。
-6. 在 Gallery 应用程序中单击 "More"（更多）以启动一个将遇到该方法断点的新线程。
+
+[start=6]
+. 在 Gallery 应用程序中单击 "More"（更多）以启动一个将遇到该方法断点的新线程。
当新线程遇到方法断点时，"Debugging"（调试）窗口中会显示一个 "New Breakpoint Hit"（遇到新断点）通知，告诉您在单步调试该方法时另一个线程遇到了断点。
@@ -189,15 +215,21 @@
*注：*在 "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 @@
要设置断点，请在源代码编辑器中单击您要设置断点的行旁边的旁注。断点标注将出现在旁注中该行的左侧。打开 "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 @@
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 @@
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 @@
「終了」をクリックすると、IDEがプロジェクトを作成し、そのプロジェクトが「プロジェクト」ウィンドウで開きます。
-4. ツールバーの「デバッグ」ボタン([Ctrl]-[F5]、Macの場合は[⌘]-[F5])をクリックしてデバッグ・セッションを開始します。
+
+[start=4]
+. ツールバーの「デバッグ」ボタン([Ctrl]-[F5]、Macの場合は[⌘]-[F5])をクリックしてデバッグ・セッションを開始します。
または、「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「デバッグ」を選択します。
@@ -68,7 +70,9 @@
デバッガの実行の詳細は、_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 @@
また、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 @@
*注意:*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 @@
「リスナーを表示」を選択すると、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 @@
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 @@
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 @@
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 @@
*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 @@
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 @@
При нажатии на кнопку 'Готово' IDE создает проект, который открывается в окне 'Проекты'.
-4. Нажмите кнопку 'Отладка' на панели инструментов (Ctrl-F5; ⌘-F5 в Mac) для запуска сеанса отладки.
+
+[start=4]
+. Нажмите кнопку 'Отладка' на панели инструментов (Ctrl-F5; ⌘-F5 в Mac) для запуска сеанса отладки.
Также вы можете щелкнуть правой кнопкой мыши узел проекта в окне 'Проекты' и выбрав 'Отладка'.
@@ -68,7 +70,9 @@
Дополнительные сведения о работе с отладчиком см. в разделе link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG798[+Запуск и отладка проектов приложений Java+] в документе _Разработка приложений в IDE NetBeans_.
-5. В главном меню выберите "Отладка" > "Сделать снимок графического интерфейса пользователя".
+
+[start=5]
+. В главном меню выберите "Отладка" > "Сделать снимок графического интерфейса пользователя".
При выборе пункта "Сделать снимок графического интерфейса пользователя" среда IDE сделает моментальный снимок графического интерфейса пользователя и откроет снимок в главном окне.
@@ -100,12 +104,16 @@
Среда 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 @@
*Примечание.* В NetBeans IDE 7.1 вкладка 'Отладчик' находится в категории 'Разное' в том же окне 'Параметры'.
-3. В списке категорий выберите "Визуальная отладка", а затем выберите *Отслеживать местоположения изменений в иерархии компонентов*. Нажмите кнопку "ОК".
-4. Остановите сеанс отладки (если он запущен).
+
+[start=3]
+. В списке категорий выберите "Визуальная отладка", а затем выберите *Отслеживать местоположения изменений в иерархии компонентов*. Нажмите кнопку "ОК".
+
+[start=4]
+. Остановите сеанс отладки (если он запущен).
*Примечание.* После включения команды 'Перейти к добавлению иерархии' в окне 'Параметры' потребуется начать сеанс отладки заново и сделать новый снимок графического интерфейса. После этого можно будет использовать команду.
-5. Начните новый сеанс отладки и сделайте снимок графического интерфейса.
-6. Щелкните компонент правой кнопкой мыши на моментальном снимке графического интерфейса пользователя и выберите "Перейти к добавлению иерархии".
+
+[start=5]
+. Начните новый сеанс отладки и сделайте снимок графического интерфейса.
+
+[start=6]
+. Щелкните компонент правой кнопкой мыши на моментальном снимке графического интерфейса пользователя и выберите "Перейти к добавлению иерархии".
Среда IDE откроет исходный код в редакторе на строке, в которой добавляется компонент.
@@ -140,26 +156,36 @@
При выборе команды "Показать прослушиватели" среда 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 @@
单击 "Finish"（完成），此时 IDE 将创建项目并在 "Projects"（项目）窗口中打开该项目。
-4. 单击工具栏中的“调试”按钮（Ctrl-F5 组合键；在 Mac 上为 ⌘-F5 组合键）以启动调试会话。
+
+[start=4]
+. 单击工具栏中的“调试”按钮（Ctrl-F5 组合键；在 Mac 上为 ⌘-F5 组合键）以启动调试会话。
或者，在“项目”窗口中右键单击项目节点，然后选择“调试”。
@@ -68,7 +70,9 @@
有关运行调试器的更多信息，请参见_使用 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 @@
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 @@
*注：*在 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 @@
选择 "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 @@
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 @@
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 @@
このチュートリアルでは、リファクタリングを含む検査や事前定義された一連の検査を使用してコードのレビューを実行したり、構成を管理したり、カスタム検査を作成したりする方法について学習します。
-=== 内容
+== 内容
image::images/netbeans-stamp.png[title="このページの内容は、NetBeans IDE 8.0に適用されます"]
@@ -103,7 +103,9 @@
image::images/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=7]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
<<top,先頭>>
@@ -154,7 +156,9 @@
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=5]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
=== JDK 8に移行
@@ -185,7 +189,9 @@
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. 「OK」をクリックして編集を保存します。
+
+[start=5]
+. 「OK」をクリックして編集を保存します。
*デフォルトの「 ``インポートの編成`` 」構成を実行して適用するには:*
@@ -200,7 +206,9 @@
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
+
+[start=5]
+. 必要に応じて、「リファクタリングを実行」をクリックして変更を適用します。
<<top,先頭>>
@@ -223,23 +231,33 @@
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/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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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/single-inspection-small.png[role="left", link="images/single-inspection.png"]
--
-7. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=7]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
<<top,В начало>>
@@ -143,7 +145,9 @@
image::images/jdk7-ref-small.png[role="left", link="images/jdk7-ref.png"]
--
-5. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=5]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
=== Перенос в JDK 8
@@ -174,7 +178,9 @@
image::images/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. Нажмите кнопку "ОК", чтобы сохранить изменения.
+
+[start=5]
+. Нажмите кнопку "ОК", чтобы сохранить изменения.
*Чтобы запустить и применить настройку по умолчанию ``Упорядочение операторов импорта`` , выполните следующие действия.*
@@ -189,7 +195,9 @@
image::images/imports-ref-small.png[role="left", link="images/imports-ref.png"]
--
-5. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
+
+[start=5]
+. Нажмите кнопку "Реорганизовать код", чтобы применить изменения, если это необходимо.
<<top,В начало>>
@@ -212,23 +220,33 @@
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/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/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-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/org-imports-small.png[role="left", link="images/org-imports.png"]
--
-5. 单击 "OK"（确定）保存所做的编辑。
+
+[start=5]
+. 单击 "OK"（确定）保存所做的编辑。
*运行并应用默认的 ``Organize Imports`` （组织导入）配置：*
@@ -189,7 +195,9 @@
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/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/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 @@
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 close the Resolve Reference Problems dialog box.
-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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
*注意:* ``GridBagCustomizerAdvancedTutorial`` プロジェクトでは、更新センターから入手できる ``JUnit`` と ``JUnit 4`` クラス・ライブラリを使用します。「プロジェクトを開く」ダイアログ・ボックスで「問題を解決」をクリックし、次に「参照の問題を解決」ダイアログ・ボックスで「解決」をクリックし、NetBeans IDEのインストーラの指示に従ってJUnitプラグインをインストールする必要がありますインストールが完了したら、「終了」をクリックして「NetBeans IDEのインストーラ」ダイアログ・ボックスを閉じ、「閉じる」をクリックして「参照の問題を解決」ダイアログ・ボックスを閉じます。
-3. ``「ソース・パッケージ」>「tutorial」`` を展開し、 ``ContactsAdvancedInitial.java`` をダブルクリックします。
+
+[start=3]
+. ``「ソース・パッケージ」>「tutorial」`` を展開し、 ``ContactsAdvancedInitial.java`` をダブルクリックします。
サンプル・フォームがGUIビルダーの「デザイン」ビューで開きます。
[.feature]
@@ -135,8 +137,12 @@
強調表示された ``JLabel1`` が最初のセルに表示されます。
-3. 新しく追加された行の2つ目のセルを右クリックします。
-4. コンテキスト・メニューから ``「コンポーネントを追加」>「Swingコントロール」>「テキスト・フィールド」`` を選択します。
+
+[start=3]
+. 新しく追加された行の2つ目のセルを右クリックします。
+
+[start=4]
+. コンテキスト・メニューから ``「コンポーネントを追加」>「Swingコントロール」>「テキスト・フィールド」`` を選択します。
強調表示された ``JTextField1`` が2つ目のセルに表示されます。
image::images/highlightedtextfield.png[]
@@ -171,6 +177,7 @@
``JTextField1`` コンポーネントのテキストを除去するには、次の手順を行います:
+[start=1]
1. 「デザイン」ビューで、 ``JTextField1`` コンポーネントを選択し、[F2]を押します(または、コンテキスト・メニューから「テキストを編集」を選択します)。
2. 選択されているテキストを削除し、[Enter]を押します。
@@ -189,9 +196,15 @@
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 @@
1. グリッド領域で、[Ctrl]を押しながら「 ``Skype:`` 」と「 ``Home Phone:`` 」のラベルをクリックして選択します。
2. 「 ``インセット`` 」テキスト・フィールドの右にある「参照」ボタン(image::images/browsebutton.png[])をクリックします。
「 ``インセット`` 」ダイアログ・ボックスが表示されます。
-3. 「 ``左:`` 」テキスト・フィールドに「 ``5`` 」と入力し、「OK」をクリックします。
+
+[start=3]
+. 「 ``左:`` 」テキスト・フィールドに「 ``5`` 」と入力し、「OK」をクリックします。
=== サブコンテナの導入
@@ -285,7 +300,9 @@
image::images/designsubcontainer-small.png[role="left", link="images/designsubcontainer.png"]
--
-3. 2番目の列ヘッダーを右クリックし、コンテキスト・メニューから「 ``列を後ろに挿入`` 」を選択します。
+
+[start=3]
+. 2番目の列ヘッダーを右クリックし、コンテキスト・メニューから「 ``列を後ろに挿入`` 」を選択します。
新しいボタンのための空のセルが表示されます。
[.feature]
@@ -293,7 +310,9 @@
image::images/emptycell-small.png[role="left", link="images/emptycell.png"]
--
-4. 新しく作成されたセルの内部を右クリックし、コンテキスト・メニューから「 ``コンポーネントを追加`` 」>「 ``Swingコントロール`` 」>「 ``ボタン`` 」を選択します。
+
+[start=4]
+. 新しく作成されたセルの内部を右クリックし、コンテキスト・メニューから「 ``コンポーネントを追加`` 」>「 ``Swingコントロール`` 」>「 ``ボタン`` 」を選択します。
新しい「 ``jButton1`` 」ボタンが追加されます。
[.feature]
@@ -301,9 +320,15 @@
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 @@
*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álogo do Instalador do NetBeans IDE e, em seguida, clique em Fechar para fechar a caixa de diálogo Resolver Problemas de Referência.
-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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
*Примечание.* В проекте ``GridBagCustomizerAdvancedTutorial`` используются библиотеки классов ``JUnit`` и ``JUnit 4`` , которые можно найти в центре обновлений. Необходимо щелкнуть 'Решить проблемы' в диалоговом окне 'Открыть проект', затем щелкните 'Решить' в диалоговом окне 'решить проблемы ссылок' и установить подключаемый модуль в соответствии с инструкциями в установщике IDE NetBeans. После завершения установки нажмите 'Готово', чтобы закрыть диалоговое окно установщика IDE NetBeans, затем нажмите 'Закрыть', чтобы закрыть диалоговое окно 'Разрешение проблем ссылок'.
-3. Разверните ``Пакеты исходного кода`` > учебное руководство и дважды щелкните ``ContactsAdvancedInitial.java`` .
+
+[start=3]
+. Разверните ``Пакеты исходного кода`` > учебное руководство и дважды щелкните ``ContactsAdvancedInitial.java`` .
В конструкторе графического интерфейса откроется образец формы в режиме конструктора.
[.feature]
@@ -135,8 +137,12 @@
Выделенное ``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 @@
Настройщик 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 @@
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/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/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/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 @@
*注：* ``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 @@
此时将在第一个单元格中突出显示 ``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 @@
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 @@
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/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/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/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 @@
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/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 @@
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/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/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 @@
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 @@
}
----
+
+
[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 @@
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 @@
または、「検索」フィールドに`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 @@
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 @@
}
----
-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 @@
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 @@
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 @@
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 @@
}
----
-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 @@
É 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 @@
В качестве альтернативы вы можете ввести `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 @@
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 @@
}
----
-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 @@
Для поиска в классе 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 @@
或者，您也可以在搜索字段中键入 `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 @@
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 @@
}
----
-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 @@
您可以在 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/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 @@
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 @@
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 @@
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/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 @@
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 @@
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 @@
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 @@
});
}
----
-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/navigator.png[]
-2. 「プロパティ」ウィンドウで、「自動国際化」プロパティのチェックボックスを選択します。
+
+[start=2]
+. 「プロパティ」ウィンドウで、「自動国際化」プロパティのチェックボックスを選択します。
image::images/properties.png[]
-3. 「GUIフォーム形式のアップグレード」ダイアログ・ボックスで「アップグレード」をクリックします。
+
+[start=3]
+. 「GUIフォーム形式のアップグレード」ダイアログ・ボックスで「アップグレード」をクリックします。
チェックボックスが選択されると、「 ``プロパティ・バンドル・ファイル`` 」プロパティで設定されているとおりに、IDEが ``demo`` パッケージ内に ``Bundle.properties`` ファイルを作成します。
@@ -92,11 +96,15 @@
``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 @@
*注意:* 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/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/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/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 @@
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 @@
IDEは、ソース・エディタで ``Find.java`` ファイルを開きます。
-2. ソース・コードをスクロールし、mainメソッドを探します。
-3. mainメソッドに、次の太字の行を挿入します。
+
+[start=2]
+. ソース・コードをスクロールし、mainメソッドを探します。
+
+[start=3]
+. mainメソッドに、次の太字の行を挿入します。
[source,xml]
----
@@ -319,15 +375,25 @@
});
}
----
-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/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 @@
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 componente neste exemplo.
-5. Escolha o arquivo ``Bundle.properties`` .
+
+[start=5]
+. Escolha o arquivo ``Bundle.properties`` .
=== Internacionalizando Componentes GUI Individuais
@@ -108,9 +116,15 @@
*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 @@
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/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 @@
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 @@
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 @@
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 @@
});
}
----
-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/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 @@
Если нужно, чтобы файл ``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 @@
*Примечание.* Также можно интернационализовать другие свойства, содержащие строковые значения, такие как 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/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/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/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 @@
В среде 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 @@
Среда IDE откроет файл ``Find.java`` в редакторе исходного кода.
-2. Найдите в исходном коде главный метод.
-3. Вставьте следующую строку, выделенную жирным шрифтом, в главный метод:
+
+[start=2]
+. Найдите в исходном коде главный метод.
+
+[start=3]
+. Вставьте следующую строку, выделенную жирным шрифтом, в главный метод:
[source,xml]
----
@@ -319,15 +375,25 @@
});
}
----
-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/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 @@
如果您需要在其他位置创建 ``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 @@
*注：*您还可以对具有字符串值的其他属性进行国际化，例如助记符、可访问的名称、可访问的描述符和工具提示。
-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/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/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/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 @@
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 @@
IDE 将在源代码编辑器中打开 ``Find.java`` 文件。
-2. 滚动查看源代码并查找 main 方法。
-3. 在 main 方法中插入以下用粗体显示的行：
+
+[start=2]
+. 滚动查看源代码并查找 main 方法。
+
+[start=3]
+. 在 main 方法中插入以下用粗体显示的行：
[source,xml]
----
@@ -319,15 +375,25 @@
});
}
----
-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 @@
--
* 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/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 @@
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 @@
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 @@
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 @@
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/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/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 @@
--
* 「メイン・クラスの作成」チェックボックスを選択解除します。
-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/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 @@
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/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 @@
*注意:* チュートリアルでは ``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 @@
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/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/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 @@
--
* 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/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 @@
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 @@
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 @@
*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 @@
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/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/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 @@
--
* Снимите флажок "Создать главный класс".
-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/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/bind-dialog-small.png[role="left", link="images/bind-dialog.png"]
--
-4. Нажмите кнопку "ОК".
+
+[start=4]
+. Нажмите кнопку "ОК".
Мы только что привязали свойство компонента ползунка ``value`` ("значение") к значению текстового поля ``text`` ("текст").
@@ -226,15 +240,21 @@
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 @@
*Примечание.* В этом учебном курсе используется тестовая база данных ``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/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/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/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 @@
--
* 清除 "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/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/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/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 @@
*注：*本教程使用 ``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/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/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/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 @@
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 @@
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/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 @@
*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 @@
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 @@
*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 @@
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 @@
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/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. 「終了」をクリックします。
+
+[start=4]
+. 「終了」をクリックします。
== アプリケーション・フォームの作成
@@ -81,8 +83,12 @@
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/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 @@
*注意:* 別の「メニュー項目」をドラッグする場合は、それが「メニュー・バー」に追加されるように、その前に「メニュー・バー」が選択されていることを確認してください。
-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 @@
「 ``パレットから追加`` 」コンテキスト・メニューのかわりに、パレットの「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 @@
*注意:* このコード・スニペットの最初と最後の行は、ソース・ファイル内の既存の行と重複するため、除去してください。
-3. エディタによってコード内のエラーが報告された場合は、コード内の任意の場所を右クリックして「インポートを修正」を選択するか、または[Ctrl]+[Shift]+[I]を押します。「すべてのインポートを修正」ダイアログ・ボックスで、デフォルトを受け入れてインポート文を更新し、「OK」をクリックします。
+
+[start=3]
+. エディタによってコード内のエラーが報告された場合は、コード内の任意の場所を右クリックして「インポートを修正」を選択するか、または[Ctrl]+[Shift]+[I]を押します。「すべてのインポートを修正」ダイアログ・ボックスで、デフォルトを受け入れてインポート文を更新し、「OK」をクリックします。
このように、FileChooserの ``getSelectedFile()`` メソッドをコールしてユーザーがクリックしたファイルを判定し、それを処理できます。この例では、ファイルの内容を読み取ってテキスト領域に表示します。
@@ -207,8 +243,12 @@
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/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 @@
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 @@
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/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 @@
*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 @@
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 @@
*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 @@
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/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/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. Нажмите кнопку "Завершить".
+
+[start=4]
+. Нажмите кнопку "Завершить".
== Создание формы приложения
@@ -81,8 +83,12 @@
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/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 @@
*Примечание. * Убедитесь, что панель меню выбрана до перетаскивания другого элемента меню в него, чтобы добавить этот другой элемент на панель меню.
-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 @@
Помимо использования контекстного меню ``Добавить из палитры`` можно также перетащить компонент ``JFileChooser`` из категории 'Окно Swing' палитры на белое поле конструктора графического интерфейса. Вы получите тот же результат, но данный метод требует немного больше усилий, так как эскиз ``JFileChooser`` занимает достаточно большую область экрана и можно случайно вставить окно в одну из панелей, что не соответствует поставленной задаче.
-3. Навигатор показывает, что элемент ``JFileChooser`` добавлен в форму.
-4. Щелкните узел ``JFileChooser`` правой кнопкой мыши и измените имя переменной на `fileChooser`.
+
+[start=3]
+. Навигатор показывает, что элемент ``JFileChooser`` добавлен в форму.
+
+[start=4]
+. Щелкните узел ``JFileChooser`` правой кнопкой мыши и измените имя переменной на `fileChooser`.
image::images/navigator_jframe.png[]
@@ -189,7 +223,9 @@
*Примечание. * Удалите первую и последнюю строку фрагмента кода, которые дублируют существующие строки в исходном файле.
-3. Если редактор создает отчет об ошибках в коде, щелкните правой кнопкой мыши в любом месте кода и выберите 'Исправить выражения импорта' или нажмите Ctrl+Shift+I. В диалоговом окне 'Исправить все выражения импорта' примите значения по умолчанию для обновления операторов импорта и нажмите OK.
+
+[start=3]
+. Если редактор создает отчет об ошибках в коде, щелкните правой кнопкой мыши в любом месте кода и выберите 'Исправить выражения импорта' или нажмите Ctrl+Shift+I. В диалоговом окне 'Исправить все выражения импорта' примите значения по умолчанию для обновления операторов импорта и нажмите OK.
Итак, метод FileChooser ``getSelectedFile()`` вызывается для определения файла, выбранного пользователем, в целях дальнейшей работы с ним. В этом примере считывается содержимое файлов, которое затем отображается в TextArea.
@@ -207,8 +243,12 @@
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/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/newproj-small.png[role="left", link="images/newproj.png"]
--
-4. 单击 "Finish"（完成）。
+
+[start=4]
+. 单击 "Finish"（完成）。
== 创建应用程序窗体
@@ -81,8 +83,12 @@
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/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 @@
*注：*请确保先选择 "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 @@
除了 ``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 @@
*注：*删除代码片段中与源文件中现有的第一行和最后一行重复的行。
-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 @@
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/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 @@
//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 @@
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: 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 @@
*予想される所要時間: 20分*
-
-=== 内容
+== 内容
image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 6.9以降に適用されます"]
@@ -142,7 +141,9 @@
//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 @@
3. そして最後に、その和を文字列型に変換し、それを`jTextField3`に配置します。
それでは始めましょう。
+
+[start=1]
1. 作業領域の上部にある「デザイン」タブをクリックし、フォームのデザインに戻ります。
2. 「Add」ボタン(`jButton2`)を右クリックします。ポップアップ・メニューから「イベント」>「アクション」>「actionPerformed」を選択します。
3. 「Add」ボタンが機能するようにコードを追加します。完成したソース・コードは次のようになります。
@@ -221,7 +224,9 @@
*注意:* ``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 @@
//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 @@
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 @@
*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 @@
//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 @@
3. И, наконец, она преобразует сумму в тип String и поместит ее в `jTextField3`.
Начнем!
+[start=1]
1. Щелкните вкладку "Design" в верхней части рабочей области для возврата к экрану "Form Design".
2. Щелкните правой кнопкой мыши кнопку "Add" (`jButton2`). Во всплывающем меню выберите Events ("События") > Action ("Действие") > actionPerformed.
3. Добавьте код действий, которые должна выполнять кнопка "Add". Готовый исходный код должен выглядеть следующим образом:
@@ -214,7 +217,9 @@
*Примечание.* Местоположение каталога проекта ``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 @@
//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 @@
3. 最后，将相加之和的类型转换为字符串，并将其放在 `jTextField3` 中。
我们现在就开始吧！
+[start=1]
1. 单击工作区域顶部的“设计”标签以返回到窗体设计区域。
2. 右键单击 "Add" 按钮 (`jButton2`)。从弹出式菜单中选择“事件”>“操作”> "actionPerformed"。
3. 我们将添加一些代码以使 "Add" 按钮正常工作。完成的源代码应如下所示：
@@ -214,7 +217,9 @@
*注：* ``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 @@
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 @@
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 @@
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 @@
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/prj.png[]
-4. ``Initial.java`` ファイルをダブルクリックします。
+
+[start=4]
+. ``Initial.java`` ファイルをダブルクリックします。
サンプル・フォームがGUIビルダーの「デザイン」ビューで開きます。
image::images/initialform.png[]
@@ -90,33 +92,47 @@
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/edit-layout-space.png[]
-2. 左右のギャップのサイズを0に設定し、「OK」をクリックします。
+
+[start=2]
+. 左右のギャップのサイズを0に設定し、「OK」をクリックします。
「レイアウト・スペースを編集」ダイアログ・ボックスを使用して、ボタンの左右のギャップが除去されます。
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@
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 @@
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 @@
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 @@
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 @@
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/prj.png[]
-4. Дважды щелкните файл ``Initial.java`` .
+
+[start=4]
+. Дважды щелкните файл ``Initial.java`` .
В конструкторе графического интерфейса откроется образец формы в режиме конструктора.
image::images/initialform.png[]
@@ -90,33 +92,47 @@
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/edit-layout-space.png[]
-2. Задайте размер левого и правого промежутка равным 0 и нажмите OK.
+
+[start=2]
+. Задайте размер левого и правого промежутка равным 0 и нажмите OK.
Промежутки справа и слева от кнопок удаляются с помощью диалогового окна 'Изменить пространство компоновки'.
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@
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/prj.png[]
-4. 双击 ``Initial.java`` 文件。
+
+[start=4]
+. 双击 ``Initial.java`` 文件。
此时将在 GUI 构建器的 "Design"（设计）视图中打开样例窗体。
image::images/initialform.png[]
@@ -90,33 +92,47 @@
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/edit-layout-space.png[]
-2. 将左右两侧间距的大小设置为 0，然后单击 "OK"（确定）。
+
+[start=2]
+. 将左右两侧间距的大小设置为 0，然后单击 "OK"（确定）。
此时将使用 "Edit Layout Space"（编辑布局空间）对话框删除按钮左右两侧的间距。
image::images/gaps-removed.png[]
@@ -175,14 +193,18 @@
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 @@
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 @@
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 @@
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 @@
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/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
== アプリケーション・フォームの作成
@@ -103,7 +105,9 @@
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. 「終了」をクリックします。
+
+[start=2]
+. 「終了」をクリックします。
「プロジェクト」ウィンドウでは、`Source Packages`フォルダ内に新規パッケージが表示されているはずです。
@@ -126,16 +130,24 @@
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 @@
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/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 @@
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 @@
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 @@
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 @@
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 @@
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/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. Нажмите кнопку 'Готово'.
+
+[start=5]
+. Нажмите кнопку 'Готово'.
== Создание формы приложения
@@ -103,7 +105,9 @@
image::images/package-small.png[role="left", link="images/package.png"]
--
-2. Нажмите кнопку 'Готово'.
+
+[start=2]
+. Нажмите кнопку 'Готово'.
В окне 'Проекты' в папке `Исходные пакеты` отображается новый пакет.
@@ -126,16 +130,24 @@
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 @@
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/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/newproj-small.png[role="left", link="images/newproj.png"]
--
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
== 创建应用程序窗体
@@ -103,7 +105,9 @@
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/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 @@
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/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 @@
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 @@
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 @@
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 @@
</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 @@
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 @@
|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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
}*
}
----
-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 @@
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 @@
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 @@
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 @@
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 @@
</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 @@
</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 @@
「OK」をクリックすると、「MySQLサーバー」ノードの下に「Sakila」ノードが表示されます。
-5. 「Sakila」ノードを右クリックし、「接続」を選択します。
+
+[start=5]
+. 「Sakila」ノードを右クリックし、「接続」を選択します。
「接続」をクリックすると、「Sakila」データベースのデータベース接続のノード( ``jdbc:mysql://localhost:3306/sakila [デフォルトの_ユーザー名_]`` )が「データベース」ノードに一覧表示されます。接続が開いたら、接続ノードを展開してデータベースのデータを表示できます。
@@ -93,7 +95,9 @@
2. プロジェクト名に「*DVDStoreAdmin*」と入力し、プロジェクトの場所を設定します。
3. 専用フォルダを使用するオプションが選択されている場合は選択を解除します。
このチュートリアルでは、ライブラリを他のユーザーと共有する必要がないので、プロジェクト・ライブラリを専用のフォルダにコピーする理由はほとんどありません。
-4. 「メイン・クラスの作成」の選択を解除します。「終了」をクリックします。
+
+[start=4]
+. 「メイン・クラスの作成」の選択を解除します。「終了」をクリックします。
「終了」をクリックすると、IDEでJavaアプリケーション・プロジェクトが作成されます。このプロジェクトにはメイン・クラスが設定されていません。フォームを作成し、このフォームをメイン・クラスとして設定します。
@@ -133,8 +137,12 @@
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 @@
</session-factory>
</hibernate-configuration>
----
-7. 変更内容をファイルに保存します。
+
+[start=7]
+. 変更内容をファイルに保存します。
フォームを作成してメイン・クラスとして設定した後に、プロジェクトを実行すると、IDEの出力ウィンドウにSQL問合せが表示されます。
@@ -178,7 +188,9 @@
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 @@
|表 | ``resultTable``
|===
-9. 変更を保存します。
+
+[start=9]
+. 変更を保存します。
デザイン・ビューのフォームは、次のイメージのような外観になります。
@@ -291,7 +305,9 @@
「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 @@
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 @@
問合せをHQL問合せエディタのタブからファイルにコピーし、コードを変更できます。
-3. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
+
+[start=3]
+. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
[source,java]
----
@@ -358,7 +378,9 @@
このメソッドは、 ``executeHQLQuery()`` というメソッドをコールし、問合せ文字列をユーザーが入力した検索文字列と組み合せて問合せを作成します。
-4. ``executeHQLQuery()`` メソッドを追加します。
+
+[start=4]
+. ``executeHQLQuery()`` メソッドを追加します。
[source,java]
----
@@ -379,12 +401,18 @@
``executeHQLQuery()`` メソッドは、Hibernateをコールして、選択した問合せを実行します。このメソッドは、 ``HibernateUtil.java`` ユーティリティ・クラスを使用してHibernateセッションを取得します。
-5. エディタを右クリックして「インポートを修正」([Ctrl]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、Hibernateライブラリ( ``org.hibernate.Query`` 、 ``org.hibernate.Session`` )および ``java.util.List`` に対するインポート文を生成します。変更を保存します。
-6. デザイン・ビューに切り替えて「問合せ」ボタンをダブルクリックすることで、「問合せ」ボタン・イベント・ハンドラを作成します。
+
+[start=5]
+. エディタを右クリックして「インポートを修正」([Ctrl]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、Hibernateライブラリ( ``org.hibernate.Query`` 、 ``org.hibernate.Session`` )および ``java.util.List`` に対するインポート文を生成します。変更を保存します。
+
+[start=6]
+. デザイン・ビューに切り替えて「問合せ」ボタンをダブルクリックすることで、「問合せ」ボタン・イベント・ハンドラを作成します。
IDEで ``queryButtonActionPerformed`` メソッドが作成され、このメソッドがソース・ビューに表示されます。
-7. ユーザーがボタンをクリックすると問合せが実行されるように、ソース・ビューの ``queryButtonActionPerformed`` メソッドに次のコードを追加して変更します。
+
+[start=7]
+. ユーザーがボタンをクリックすると問合せが実行されるように、ソース・ビューの ``queryButtonActionPerformed`` メソッドに次のコードを追加して変更します。
[source,java]
----
@@ -397,7 +425,9 @@
}*
}
----
-8. 次のメソッドを追加し、結果がJTableに表示されるようにします。
+
+[start=8]
+. 次のメソッドを追加し、結果がJTableに表示されるようにします。
[source,java]
----
@@ -422,7 +452,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. エディタを右クリックして「インポートを修正」([Ctrl]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、 ``java.util.Vector`` と ``java.util.List`` に対するインポート文を生成します。変更を保存します。
+
+[start=9]
+. エディタを右クリックして「インポートを修正」([Ctrl]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、 ``java.util.Vector`` と ``java.util.List`` に対するインポート文を生成します。変更を保存します。
フォームの保存後、プロジェクトを実行できます。
@@ -438,7 +470,9 @@
または、「参照」ボタンをクリックし、ダイアログ・ボックスでメイン・クラスを選択できます。
image::images/browse-main-class.png[title="「メイン・クラスの参照」ダイアログでのメイン・クラスの設定"]
-4. メイン・ツールバーの「プロジェクトの実行」をクリックし、アプリケーションを起動します。
+
+[start=4]
+. メイン・ツールバーの「プロジェクトの実行」をクリックし、アプリケーションを起動します。
検索文字列を「名」または「姓」テキスト・フィールドに入力し、「問合せ」をクリックして俳優を検索し、詳細を確認します。
@@ -457,14 +491,24 @@
2. 「チェックアウト」ダイアログ・ボックスで次のリポジトリURLを入力します。
``https://svn.netbeans.org/svn/samples~samples-source-code``
「次」をクリックします。
-3. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
-4. ルート・ノードを展開し、*samples/java/DVDStoreAdmin-Ant*を選択します。「OK」をクリックします。
-5. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
-6. 「終了」をクリックします。
+
+[start=3]
+. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
+
+[start=4]
+. ルート・ノードを展開し、*samples/java/DVDStoreAdmin-Ant*を選択します。「OK」をクリックします。
+
+[start=5]
+. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
+
+[start=6]
+. 「終了」をクリックします。
「終了」をクリックすると、IDEではローカル・フォルダがSubversionリポジトリとして初期化され、プロジェクト・ソースがチェックアウトされます。
-7. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
+
+[start=7]
+. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
*注意:*ソースをチェックアウトするには、Subversionクライアントが必要です。Subversionのインストールの詳細は、link:../ide/subversion.html[+NetBeans IDEでのSubversionガイド+]のlink:../ide/subversion.html#settingUp[+Subversionの設定+]の項を参照してください。
@@ -489,13 +533,19 @@
private Date lastUpdate;*
}
----
-4. エディタを右クリックして「コードを挿入」([Alt]-[Insert]、Macの場合は[Ctrl]-[I])を選択し、ポップアップ・メニューから「取得メソッドおよび設定メソッド」を選択して、フィールドに対する取得メソッドと設定メソッドを生成します。
-5. 「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスですべてのフィールドを選択し、「生成」をクリックします。
+
+[start=4]
+. エディタを右クリックして「コードを挿入」([Alt]-[Insert]、Macの場合は[Ctrl]-[I])を選択し、ポップアップ・メニューから「取得メソッドおよび設定メソッド」を選択して、フィールドに対する取得メソッドと設定メソッドを生成します。
+
+[start=5]
+. 「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスですべてのフィールドを選択し、「生成」をクリックします。
image::images/getters-setters.png[title="「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックス"]
「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスでは、キーボードの[↑]を使用して、選択した項目を「Actor」ノードまで移動してから、[Space]バーを押してActor内のすべてのフィールドを選択できます。
-6. インポートを修正して変更内容を保存します。
+
+[start=6]
+. インポートを修正して変更内容を保存します。
表のためのPOJOの作成後、 ``Actor.java`` のHibernateマッピング・ファイルを作成します。
@@ -515,7 +565,9 @@
</session-factory>
</hibernate-configuration>
----
-5. 次の太字部分の変更を ``Actor.hbm.xml`` に加えて、 ``Actor.java`` のフィールドをACTOR表の列にマップします。
+
+[start=5]
+. 次の太字部分の変更を ``Actor.hbm.xml`` に加えて、 ``Actor.java`` のフィールドをACTOR表の列にマップします。
[source,xml]
----
@@ -552,7 +604,9 @@
</class>*
</hibernate-mapping>
----
-6. ツールバーの「XMLの検証」ボタンをクリックし、変更内容を保存します。
+
+[start=6]
+. ツールバーの「XMLの検証」ボタンをクリックし、変更内容を保存します。
POJOとHibernateのマッピング・ファイルを個別に作成すると、アプリケーションをさらにカスタマイズするときに役立つ場合があります。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_pt_BR.asciidoc
index 5ce420c..f8dcb22 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_pt_BR.asciidoc
@@ -80,7 +80,9 @@
Quando você clicar em OK, um nó do Salkila será exibido sob o nó Servidor MySQL.
-5. Clique com o botão direito do mouse no nó do Sakila e escolha Conectar.
+
+[start=5]
+. Clique com o botão direito do mouse no nó do Sakila e escolha Conectar.
Quando você clicar em Conectar, um nó de conexão do banco de dados do banco de dados Sakila ( ``jdbc:mysql://localhost:3306/sakila [_nome de usuário_ em Default]`` ) será apresentado no nó Bancos de Dados. Quando uma conexão for aberta, você poderá exibir os dados no banco de dados ampliando o nó de conexão.
@@ -93,7 +95,9 @@
2. Insira *DVDStoreAdmin* para o nome do projeto e defina a sua localização.
3. Desmarque a opção Usar Pasta Dedicada, se ela estiver selecionada.
Para este tutorial, não é necessário copiar as bibliotecas do projeto em uma pasta dedicada, pois você não precisará compartilhar bibliotecas com outros usuários.
-4. Desmarque Criar Classe Principal. Clique em Finalizar.
+
+[start=4]
+. Desmarque Criar Classe Principal. Clique em Finalizar.
Quando você clicar em Finalizar, o IDE criará o projeto da aplicação Java. O projeto não tem uma classe principal. Você criará um form e o definirá como classe principal.
@@ -133,8 +137,12 @@
3. Clique em Adicionar para abrir a caixa de diálogo Adicionar Propriedade do Hibernate.
4. Na caixa de diálogo, selecione a propriedade ``hibernate.show_sql`` e defina o valor para ``true`` . Clique em OK. Isso ativa o log de depuração das instruções SQL.
image::images/add-property-showsql.png[title="Caixa de diálogo Adicionar Propriedade Hibernate que mostra o valor de definição de hibernate.show_sql"]
-5. Clique em Adicionar no nó Propriedades Diversas e selecione ``hibernate.query.factory_class`` na lista drop-down Nome da Propriedade.
-6. Digite *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* como Valor da Propriedade.
+
+[start=5]
+. Clique em Adicionar no nó Propriedades Diversas e selecione ``hibernate.query.factory_class`` na lista drop-down Nome da Propriedade.
+
+[start=6]
+. Digite *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* como Valor da Propriedade.
Esta é a classe translator factory usada no Hibernate 4 que acompanha o IDE.
@@ -164,7 +172,9 @@
</session-factory>
</hibernate-configuration>
----
-7. Salve as alterações feitas no arquivo.
+
+[start=7]
+. Salve as alterações feitas no arquivo.
Após você criar o form e defini-lo como a classe principal você poderá ver a consulta SQL impressa na janela de Saída do IDE quando você executar o projeto.
@@ -178,7 +188,9 @@
1. Clique com o botão direito do mouse no nó dos Pacote de Códigos-fonte e selecione Novo > Outro para abrir o assistente para Novo Arquivo.
2. Selecione Hibernate na lista Categorias e HibernateUtil.java na lista Tipos de Arquivo. Clique em Próximo.
image::images/hib-util.png[title="O assistente Novo Arquivo que mostram como criar HibernateUtil"]
-3. Insira *HibernateUtil* como nome da classe e *sakila.util* como nome do pacote. Clique em Finalizar.
+
+[start=3]
+. Insira *HibernateUtil* como nome da classe e *sakila.util* como nome do pacote. Clique em Finalizar.
Quando você clicar em Finalizar, o ``HibernateUtil.java`` será aberto no editor. Você pode fechar o arquivo porque não precisa editá-lo.
@@ -268,7 +280,9 @@
|Tabela | ``resultTable``
|===
-9. Salve as alterações.
+
+[start=9]
+. Salve as alterações.
Na view Design, seu form deve parecer com a imagem a seguir.
@@ -291,7 +305,9 @@
Quando você clicar em Executar Consulta HQL, deverá visualizar os resultados da consulta no painel inferior do Editor de Consultas HQL.
image::images/hib-query-hqlresults.png[title="Hql Editor de Consulta mostrando resultados da consulta HQL"]
-5. Digite a consulta a seguir no Editor de Consultas HQL e clique em Executar consulta HQL para verificar os resultados da consulta quando a string de pesquisa for "PE".
+
+[start=5]
+. Digite a consulta a seguir no Editor de Consultas HQL e clique em Executar consulta HQL para verificar os resultados da consulta quando a string de pesquisa for "PE".
[source,java]
----
@@ -309,7 +325,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. Abra uma nova guia do Editor de Consulta HQL e insira a consulta a seguir no painel do editor. Clique em Executar Consulta HQL.
+
+[start=6]
+. Abra uma nova guia do Editor de Consulta HQL e insira a consulta a seguir no painel do editor. Clique em Executar Consulta HQL.
[source,java]
----
@@ -342,7 +360,9 @@
É possível copiar as consultas das guias do Editor de Consulta HQL para o campo e, em seguida, modificar o código.
-3. Adicione os métodos a seguir para criar a consulta com base na string de entrada do usuário.
+
+[start=3]
+. Adicione os métodos a seguir para criar a consulta com base na string de entrada do usuário.
[source,java]
----
@@ -358,7 +378,9 @@
Esses métodos chamam o método ``executeHQLQuery()`` e cria a consulta combinando a string de consulta com o usuário que inseriu a string de pesquisa.
-4. Adicione o método ``executeHQLQuery()`` .
+
+[start=4]
+. Adicione o método ``executeHQLQuery()`` .
[source,java]
----
@@ -379,12 +401,18 @@
O método ``executeHQLQuery()`` chama o Hibernate para executar a consulta selecionada. Esse método usa a classe de utilitário ``HibernateUtil.java`` para obter a Sessão Hibernate.
-5. Clique com o botão direito do mouse no Editor e escolha Corrigir Importações (ctrl-shift-i; ⌘-shift-i em mac) para gerar instruções de importação para as bibliotecas de Hibernação ( ``org.hibernate.query`` , ``org.hibernate.session`` ) e ``java.util.list`` . Salve as alterações.
-6. Crie um handler de eventos do botão Consulta alternando para a view Design e clicando duas vezes no botão Consulta.
+
+[start=5]
+. Clique com o botão direito do mouse no Editor e escolha Corrigir Importações (ctrl-shift-i; ⌘-shift-i em mac) para gerar instruções de importação para as bibliotecas de Hibernação ( ``org.hibernate.query`` , ``org.hibernate.session`` ) e ``java.util.list`` . Salve as alterações.
+
+[start=6]
+. Crie um handler de eventos do botão Consulta alternando para a view Design e clicando duas vezes no botão Consulta.
O IDE cria o método ``queryButtonActionPerformed`` e exibe o método na view Código-fonte.
-7. Modifique o método ``queryButtonActionPerformed`` na view Código-fonte adicionando o código a seguir de modo que uma consulta seja executada quando o usuário clicar no botão.
+
+[start=7]
+. Modifique o método ``queryButtonActionPerformed`` na view Código-fonte adicionando o código a seguir de modo que uma consulta seja executada quando o usuário clicar no botão.
[source,java]
----
@@ -397,7 +425,9 @@
}*
}
----
-8. Adicione o método a seguir para exibir os resultados na JTable.
+
+[start=8]
+. Adicione o método a seguir para exibir os resultados na JTable.
[source,java]
----
@@ -422,7 +452,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Clique com o botão direito do mouse no editor e escolha Corrigir Importações (Ctrl-Shift-I; ⌘-Shift-I no Mac) para gerar uma instrução de importação para ``java.util.Vector`` e ``java.util.List`` . Salve as alterações.
+
+[start=9]
+. Clique com o botão direito do mouse no editor e escolha Corrigir Importações (Ctrl-Shift-I; ⌘-Shift-I no Mac) para gerar uma instrução de importação para ``java.util.Vector`` e ``java.util.List`` . Salve as alterações.
Depois de salvar o form, você pode executar o projeto.
@@ -438,7 +470,9 @@
De modo alternativo, você pode clicar no botão Procurar e escolher a classe principal na caixa de diálogo.
image::images/browse-main-class.png[title="Definindo a Classe Principal na caixa de diálogo Procurar Classes Principais"]
-4. Clique em Executar Projeto principal na barra de ferramentas principal para iniciar a aplicação.
+
+[start=4]
+. Clique em Executar Projeto principal na barra de ferramentas principal para iniciar a aplicação.
Insira uma string de pesquisa no campo de texto Nome ou Sobrenome e clique em Consulta para pesquisar um ator e exibir os detalhes.
@@ -457,14 +491,24 @@
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 nas Pastas do Repositório:
-4. Expanda o nó-raiz e selecione *samples/java/DVDStoreAdmin-Ant*. 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 nas Pastas do Repositório:
+
+[start=4]
+. Expanda o nó-raiz e selecione *samples/java/DVDStoreAdmin-Ant*. 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.* É necessário um cliente Subversion para verificar os códigos-fonte. Para saber mais sobre a instalação 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+].
@@ -489,13 +533,19 @@
private Date lastUpdate;*
}
----
-4. Clique com o botão direito do mouse no Editor e escolha Inserir Código (Alt-Insert; Ctrl-I em Mac) e selecione getter e setter no menu pop-up para gerar getters e setters para os campos.
-5. Na caixa de diálogo Gerar Getters e Setters, selecione todos os campos e clique em Gerar.
+
+[start=4]
+. Clique com o botão direito do mouse no Editor e escolha Inserir Código (Alt-Insert; Ctrl-I em Mac) e selecione getter e setter no menu pop-up para gerar getters e setters para os campos.
+
+[start=5]
+. Na caixa de diálogo Gerar Getters e Setters, selecione todos os campos e clique em Gerar.
image::images/getters-setters.png[title="Caixa de diálogo Gerar Getters e Setters"]
Na caixa de diálogo Gerar Getters e Setters, você pode usar a seta para cima no teclado para mover o item selecionado para o nó Ator e pressionar a barra de espaços para selecionar todos os campos em Ator.
-6. Corrija as importações e salve as alterações.
+
+[start=6]
+. Corrija as importações e salve as alterações.
Depois de criar o POJO para a tabela, você desejará criar um arquivo de mapeamento do Hibernate para ``Actor.java`` .
@@ -515,7 +565,9 @@
</session-factory>
</hibernate-configuration>
----
-5. Associe os campos ``Actor.java`` às colunas na tabela ACTOR fazendo as seguintes alterações (em negrito) no ``Actor.hbm.xml`` .
+
+[start=5]
+. Associe os campos ``Actor.java`` às colunas na tabela ACTOR fazendo as seguintes alterações (em negrito) no ``Actor.hbm.xml`` .
[source,xml]
----
@@ -552,7 +604,9 @@
</class>*
</hibernate-mapping>
----
-6. Clique no botão Validar XML na barra de ferramentas e salve as alterações.
+
+[start=6]
+. Clique no botão Validar XML na barra de ferramentas e salve as alterações.
A criação de POJOs individuais e arquivos de mapeamento do Hibernate pode ser um modo conveniente de personalizar ainda mais sua aplicação.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ru.asciidoc
index 6d779f8..e2a5839 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_ru.asciidoc
@@ -80,7 +80,9 @@
При нажатии кнопки "OK" узел "Sakila" появится под узлом "MySQL Server".
-5. Щелкните правой кнопкой мыши узел "Sakila" и выберите "Connect".
+
+[start=5]
+. Щелкните правой кнопкой мыши узел "Sakila" и выберите "Connect".
После нажатия кнопки "Connect a database" под узлом "Databases" отобразится узел подключения к базе данных "Sakila" ( ``jdbc:mysql://localhost:3306/sakila [_username_ on Default]`` ). При открытом подключении для просмотра данных в базе данных разверните этот узел подключения.
@@ -93,7 +95,9 @@
2. Введите *DVDStoreAdmin* в качестве имени проекта и укажите местоположение проекта.
3. Снимите флажок "Использовать отдельную папку", если он установлен.
В рамках этого руководства копирование библиотек проекта в выделенную папку лишено смысла, поскольку совместное использование библиотек с другими пользователями не потребуется.
-4. Снимите флажок "Create Main Class". Нажмите кнопку "Завершить".
+
+[start=4]
+. Снимите флажок "Create Main Class". Нажмите кнопку "Завершить".
При нажатии кнопки "Finish" в среде IDE будет создан проект приложения Java. В проекте нет главного класса. Следует создать форму и установить ее в качестве главного класса.
@@ -133,8 +137,12 @@
3. Нажмите кнопку "Add" для открытия диалогового окна "Add Hibernate Property".
4. В диалоговом окне выберите свойство ``hibernate.show_sql`` и установите значение ``true`` . Нажмите кнопку "ОК". Это приведет ко включению протоколирования отладки операторов SQL.
image::images/add-property-showsql.png[title="Диалоговое окно 'Добавить свойство Hibernate', в котором отображаются значения настроек для свойства hibernate.show_sql"]
-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* в качестве значения свойства.
Класс 'translator factory' используется в библиотеке Hibernate 4, связанной с IDE.
@@ -164,7 +172,9 @@
</session-factory>
</hibernate-configuration>
----
-7. Сохраните измененный файл.
+
+[start=7]
+. Сохраните измененный файл.
После создания формы и настройки ее в качестве основного класса, вы сможете увидеть SQL запросов, выведенные на печать в окне вывода IDE при выполнении проекта.
@@ -178,7 +188,9 @@
1. Щелкните правой кнопкой мыши узел "Source Packages" и выберите "New > Other" для открытия мастера "New File".
2. Выберите "Hibernate" из списка "Categories" и "HibernateUtil.java" из списка "File Types". Нажмите кнопку "Далее".
image::images/hib-util.png[title="Описание создания HibernateUtil с помощью мастера создания файлов"]
-3. Введите *HibernateUtil* в качестве имени класса и *sakila.util* в качестве имени пакета. Нажмите кнопку "Завершить".
+
+[start=3]
+. Введите *HibernateUtil* в качестве имени класса и *sakila.util* в качестве имени пакета. Нажмите кнопку "Завершить".
После нажатия кнопки "Finish" в редакторе откроется класс ``HibernateUtil.java`` . Файл можно закрыть, т.к. необходимость в его изменении отсутствует.
@@ -268,7 +280,9 @@
|Таблица | ``resultTable``
|===
-9. Сохраните изменения.
+
+[start=9]
+. Сохраните изменения.
В режиме проектирования внешний вид формы выглядит так, как показано на следующем рисунке.
@@ -291,7 +305,9 @@
При нажатии кнопки "Run HQL Query" результаты запроса должны отображаться в нижней области редактора запросов HQL Query Editor.
image::images/hib-query-hqlresults.png[title="Редактор запросов HQL с отображением результатов запроса HQL"]
-5. Введите следующий запрос в редактор запросов HQL Query Editor и нажмите кнопку "Выполнить запрос HQL" для проверки результатов запроса при вводе значения "PE" в строку поиска.
+
+[start=5]
+. Введите следующий запрос в редактор запросов HQL Query Editor и нажмите кнопку "Выполнить запрос HQL" для проверки результатов запроса при вводе значения "PE" в строку поиска.
[source,java]
----
@@ -309,7 +325,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. Откройте новую вкладку редактора HQL Query Editor и введите следующий запрос на панели редактирования. Нажмите кнопку "Run HQL Query".
+
+[start=6]
+. Откройте новую вкладку редактора HQL Query Editor и введите следующий запрос на панели редактирования. Нажмите кнопку "Run HQL Query".
[source,java]
----
@@ -342,7 +360,9 @@
Запросы можно скопировать из вкладок редактора запросов HQL Query Editor в файл, а затем изменить код.
-3. Добавьте следующие методы для создания запроса на основе строки со вводимой пользователем информацией.
+
+[start=3]
+. Добавьте следующие методы для создания запроса на основе строки со вводимой пользователем информацией.
[source,java]
----
@@ -358,7 +378,9 @@
Эти методы обеспечивают вызов метода с именем ``executeHQLQuery()`` и создание запроса путем объединения строки запроса с информацией пользователя, вводимой в строку поиска.
-4. Добавьте метод ``executeHQLQuery()`` .
+
+[start=4]
+. Добавьте метод ``executeHQLQuery()`` .
[source,java]
----
@@ -379,12 +401,18 @@
Метод ``executeHQLQuery()`` обеспечивает вызов библиотеки Hibernate для выполнения выбранного запроса. В этом методе служебный класс ``HibernateUtil.java`` применяется для получения объекта Hibernate "Session".
-5. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Ctrl-Shift-I; ⌘-Shift-I в Mac) для создания операторов импорта для библиотек Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) и ``java.util.List`` . Сохраните изменения.
-6. Создайте обработчик событий для кнопки "Query", переключившись в режим проектирования и дважды нажав кнопку "Query".
+
+[start=5]
+. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Ctrl-Shift-I; ⌘-Shift-I в Mac) для создания операторов импорта для библиотек Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) и ``java.util.List`` . Сохраните изменения.
+
+[start=6]
+. Создайте обработчик событий для кнопки "Query", переключившись в режим проектирования и дважды нажав кнопку "Query".
В среде IDE будет создан метод ``queryButtonActionPerformed`` , который затем отобразится в режиме просмотра исходного кода.
-7. Измените метод ``queryButtonActionPerformed`` в режиме просмотра исходного кода путем добавления следующего кода, обеспечивающего выполнение запроса при нажатии кнопки пользователем.
+
+[start=7]
+. Измените метод ``queryButtonActionPerformed`` в режиме просмотра исходного кода путем добавления следующего кода, обеспечивающего выполнение запроса при нажатии кнопки пользователем.
[source,java]
----
@@ -397,7 +425,9 @@
}*
}
----
-8. Добавьте следующий метод для просмотра результатов в "JTable".
+
+[start=8]
+. Добавьте следующий метод для просмотра результатов в "JTable".
[source,java]
----
@@ -422,7 +452,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Ctrl-Shift-I; ⌘-Shift-I в Mac) для создания оператора импорта для ``java.util.Vector`` и ``java.util.List`` . Сохраните изменения.
+
+[start=9]
+. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Ctrl-Shift-I; ⌘-Shift-I в Mac) для создания оператора импорта для ``java.util.Vector`` и ``java.util.List`` . Сохраните изменения.
После сохранения формы можно запустить проект.
@@ -438,7 +470,9 @@
В качестве альтернативы можно нажать кнопку "Browse" и выбрать главный класс в диалоговом окне.
image::images/browse-main-class.png[title="Установка главного класса в диалоговом окне 'Обзор главных классов'"]
-4. Нажмите кнопку "Run Project" на главной панели инструментов для запуска приложения.
+
+[start=4]
+. Нажмите кнопку "Run Project" на главной панели инструментов для запуска приложения.
Введите информацию в строке поиска для текстовых полей "First Name" или "Last Name" и нажмите кнопку "Query" для поиска актера и просмотра подробных данных.
@@ -457,14 +491,24 @@
2. В диалоговом окне "Проверка" введите следующий URL-адрес репозитория:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Нажмите кнопку "Далее".
-3. Нажмите кнопку "Обзор" для открытия диалогового окна "Обзор папок репозитория".
-4. Разверните корневой узел и выберите *samples/java/DVDStoreAdmin-Ant*. Нажмите кнопку "ОК".
-5. Укажите локальную папку для исходных файлов (папка должна быть пустой).
-6. Нажмите кнопку "Завершить".
+
+[start=3]
+. Нажмите кнопку "Обзор" для открытия диалогового окна "Обзор папок репозитория".
+
+[start=4]
+. Разверните корневой узел и выберите *samples/java/DVDStoreAdmin-Ant*. Нажмите кнопку "ОК".
+
+[start=5]
+. Укажите локальную папку для исходных файлов (папка должна быть пустой).
+
+[start=6]
+. Нажмите кнопку "Завершить".
После нажатия кнопки "Готово" среда IDE инициализирует локальную папку в качестве репозитория Subversion и выполняет проверку исходных файлов проекта на выходе.
-7. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
+
+[start=7]
+. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
*Примечание.* Для получения исходных файлов на редактирование требуется клиент Subversion. Дополнительные сведения об установке Subversion см. в разделе link:../ide/subversion.html#settingUp[+Настройка Subversion+] в link:../ide/subversion.html[+Руководстве по Subversion в IDE NetBeans+].
@@ -489,13 +533,19 @@
private Date lastUpdate;*
}
----
-4. Щелкните правой кнопкой мыши в редакторе и выберите 'Вставить код' (Alt-Insert, Ctrl-I на Mac) и выберите методы получения и установки в контекстном меню для создания методов получения и установки для полей.
-5. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
+
+[start=4]
+. Щелкните правой кнопкой мыши в редакторе и выберите 'Вставить код' (Alt-Insert, Ctrl-I на Mac) и выберите методы получения и установки в контекстном меню для создания методов получения и установки для полей.
+
+[start=5]
+. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
image::images/getters-setters.png[title="Диалоговое окно 'Создание методов получения и установки'"]
В диалоговом окне "Generate Getters and Setters" можно использовать стрелку вверх на клавиатуре для перемещения выбранного элемента к узлу "Actor", а затем нажать клавишу "пробел" и выбрать все поля "Actor".
-6. Исправьте операторы импорта и сохраните измененные данные.
+
+[start=6]
+. Исправьте операторы импорта и сохраните измененные данные.
После создания объекта POJO для таблицы необходимо создать файл сопоставления библиотеки Hibernate для класса ``Actor.java`` .
@@ -515,7 +565,9 @@
</session-factory>
</hibernate-configuration>
----
-5. Сопоставьте поля в ``Actor.java`` со столбцами в таблице "ACTOR" путем внесения следующих изменений (выделены полужирным шрифтом) в ``Actor.hbm.xml`` .
+
+[start=5]
+. Сопоставьте поля в ``Actor.java`` со столбцами в таблице "ACTOR" путем внесения следующих изменений (выделены полужирным шрифтом) в ``Actor.hbm.xml`` .
[source,xml]
----
@@ -552,7 +604,9 @@
</class>*
</hibernate-mapping>
----
-6. Нажмите кнопку "Validate XML" на панели инструментов и сохраните изменения.
+
+[start=6]
+. Нажмите кнопку "Validate XML" на панели инструментов и сохраните изменения.
Создание объектов POJO и файлов сопоставления библиотеки Hibernate может эффективно использоваться для дальнейшей настройки приложения.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_zh_CN.asciidoc
index e3654a8..92ca26e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/hibernate-java-se_zh_CN.asciidoc
@@ -80,7 +80,9 @@
单击 "OK"（确定），MySQL 服务器节点下随即出现一个 Sakila 节点。
-5. 右键单击 "Sakila" 节点，然后选择 "Connect"（连接）。
+
+[start=5]
+. 右键单击 "Sakila" 节点，然后选择 "Connect"（连接）。
单击 "Connect"（连接）后，"Databases"（数据库）节点下面将列出 Sakila 数据库连接节点 ( ``jdbc:mysql://localhost:3306/sakila [_username_ on Default]`` )。打开连接时，可通过展开该连接节点查看数据库中数据。
@@ -93,7 +95,9 @@
2. 键入 *DVDStoreAdmin* 作为项目名称并设置项目位置。
3. 取消选中 "Use Dedicated Folder"（使用专用文件夹）选项（如果该选项处于选中状态）。
对于本教程，没有理由将项目库复制到指定文件夹，因为您将需要与其他用户共享库。
-4. 取消选中 "Create Main Class"（创建主类）。单击 "Finish"（完成）。
+
+[start=4]
+. 取消选中 "Create Main Class"（创建主类）。单击 "Finish"（完成）。
单击 "Finish"（完成），此时 IDE 将创建 Java 应用程序项目。项目没有设置主类。您将创建一个窗体，然后将该窗体设置为主类。
@@ -133,8 +137,12 @@
3. 单击 "Add"（添加）以打开 "Add Hibernate Property"（添加 Hibernate 属性）对话框。
4. 在此对话框中，选择 ``hibernate.show_sql`` 属性并将值设置为 ``true`` 。单击 "OK"（确定）。这将启用 SQL 语句的调试日志记录。
image::images/add-property-showsql.png[title="显示 hibernate.show_sql 属性的设置值的 "Add Hibernate Property"（添加 Hibernate 属性）对话框"]
-5. 单击 "Miscellaneous Properties"（其他属性）节点下的 "Add"（添加），然后选择 "Property Name"（属性名称）下拉列表中的 ``hibernate.query.factory_class`` 。
-6. 键入 *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* 作为属性值。
+
+[start=5]
+. 单击 "Miscellaneous Properties"（其他属性）节点下的 "Add"（添加），然后选择 "Property Name"（属性名称）下拉列表中的 ``hibernate.query.factory_class`` 。
+
+[start=6]
+. 键入 *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* 作为属性值。
这是在随 IDE 捆绑提供的 Hibernate 4 中使用的转换器工厂类。
@@ -164,7 +172,9 @@
</session-factory>
</hibernate-configuration>
----
-7. 保存对该文件所做的更改。
+
+[start=7]
+. 保存对该文件所做的更改。
创建窗体并将其设置为主类之后，在运行项目时还将看到输出到 IDE 的 "Output"（输出）窗口中的 SQL 查询。
@@ -178,7 +188,9 @@
1. 右键单击 "Source Packages"（源包）节点并选择 "New"（新建）> "Other"（其他），打开新建文件向导。
2. 从 "Categories"（类别）列表中选择 "Hibernate"，从 "File Types"（文件类型）列表中选择 HibernateUtil.java。单击 "Next"（下一步）。
image::images/hib-util.png[title="显示如何创建 HibernateUtil 的新建文件向导"]
-3. 键入 *HibernateUtil* 作为类名，并键入 *sakila.util* 作为包名。单击 "Finish"（完成）。
+
+[start=3]
+. 键入 *HibernateUtil* 作为类名，并键入 *sakila.util* 作为包名。单击 "Finish"（完成）。
单击 "Finish"（完成），此时 ``HibernateUtil.java`` 将在编辑器中打开。由于不需要编辑该文件，因此可以关闭该文件。
@@ -268,7 +280,9 @@
|表 | ``resultTable``
|===
-9. 保存所做的更改。
+
+[start=9]
+. 保存所做的更改。
在 "Design"（设计）视图中，您的窗体应与下图类似。
@@ -291,7 +305,9 @@
单击 "Run HQL Query"（运行 HQL 查询）按钮之后，您应该能在 HQL 查询编辑器的底部窗格中看到查询结果。
image::images/hib-query-hqlresults.png[title="显示 HQL 查询结果的 HQL 查询编辑器"]
-5. 在 HQL 查询编辑器中键入以下查询，然后单击 "Run HQL Query"（运行 HQL 查询）查询搜索字符串为 "PE" 时的查询结果。
+
+[start=5]
+. 在 HQL 查询编辑器中键入以下查询，然后单击 "Run HQL Query"（运行 HQL 查询）查询搜索字符串为 "PE" 时的查询结果。
[source,java]
----
@@ -309,7 +325,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. 打开一个新的 HQL 查询编辑器标签，在编辑器窗格中键入以下查询。单击 "Run HQL Query"（运行 HQL 查询）按钮。
+
+[start=6]
+. 打开一个新的 HQL 查询编辑器标签，在编辑器窗格中键入以下查询。单击 "Run HQL Query"（运行 HQL 查询）按钮。
[source,java]
----
@@ -342,7 +360,9 @@
可以将 HQL 查询编辑器标签中的查询复制到文件中，然后再修改代码。
-3. 添加以下方法，以根据用户输入字符串创建查询。
+
+[start=3]
+. 添加以下方法，以根据用户输入字符串创建查询。
[source,java]
----
@@ -358,7 +378,9 @@
这些方法调用一个名称为 ``executeHQLQuery()`` 的方法，并通过结合查询字符串与用户输入的搜索字符串来创建查询。
-4. 添加 ``executeHQLQuery()`` 方法。
+
+[start=4]
+. 添加 ``executeHQLQuery()`` 方法。
[source,java]
----
@@ -379,12 +401,18 @@
``executeHQLQuery()`` 方法调用 Hibernate 来执行选定的查询。该方法利用 ``HibernateUtil.java`` 实用程序类来获取 Hibernate 会话。
-5. 在编辑器中右键单击并选择 "Fix Imports"（修复导入）（Ctrl-Shift-I；在 Mac 上为 ⌘-Shift-I）可为 Hibernate 库（ ``org.hibernate.Query`` 、 ``org.hibernate.Session`` ）和 ``java.util.List`` 生成导入语句。保存所做的更改。
-6. 切换到 "Design"（设计）视图并双击 "Query" 按钮，创建一个 "Query" 按钮事件处理程序。
+
+[start=5]
+. 在编辑器中右键单击并选择 "Fix Imports"（修复导入）（Ctrl-Shift-I；在 Mac 上为 ⌘-Shift-I）可为 Hibernate 库（ ``org.hibernate.Query`` 、 ``org.hibernate.Session`` ）和 ``java.util.List`` 生成导入语句。保存所做的更改。
+
+[start=6]
+. 切换到 "Design"（设计）视图并双击 "Query" 按钮，创建一个 "Query" 按钮事件处理程序。
IDE 将创建 ``queryButtonActionPerformed`` 方法并在 "Source"（源）视图中显示该方法。
-7. 在 "Source"（源）视图中修改 ``queryButtonActionPerformed`` 方法，添加以下代码，以便查询能在用户单击按钮时正确运行。
+
+[start=7]
+. 在 "Source"（源）视图中修改 ``queryButtonActionPerformed`` 方法，添加以下代码，以便查询能在用户单击按钮时正确运行。
[source,java]
----
@@ -397,7 +425,9 @@
}*
}
----
-8. 添加以下方法，在 JTable 中显示结果。
+
+[start=8]
+. 添加以下方法，在 JTable 中显示结果。
[source,java]
----
@@ -422,7 +452,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. 在编辑器中右键单击并选择 "Fix Imports"（修复导入）（Ctrl-Shift-I；在 Mac 上为 ⌘-Shift-I）可为 ``java.util.Vector`` 和 ``java.util.List`` 生成导入语句。保存所做的更改。
+
+[start=9]
+. 在编辑器中右键单击并选择 "Fix Imports"（修复导入）（Ctrl-Shift-I；在 Mac 上为 ⌘-Shift-I）可为 ``java.util.Vector`` 和 ``java.util.List`` 生成导入语句。保存所做的更改。
保存窗体之后，您可以运行项目。
@@ -438,7 +470,9 @@
或者，您可以单击 "Browse"（浏览）按钮并在对话框中选择主类。
image::images/browse-main-class.png[title="在 "Browse Main Classes"（浏览主类）对话框中设置主类"]
-4. 单击主工具栏中的 "Run Project"（运行项目）以启动应用程序。
+
+[start=4]
+. 单击主工具栏中的 "Run Project"（运行项目）以启动应用程序。
在 "First Name" 或 "Last Name" 字段中键入搜索字符串，并单击 "Query" 来搜索演员并查看详细信息。
@@ -457,14 +491,24 @@
2. 在 "Checkout"（检出）对话框中，输入以下资源库 URL：
``https://svn.netbeans.org/svn/samples~samples-source-code``
单击 "Next"（下一步）。
-3. 单击 "Browse"（浏览）以打开 "Browse Repostiory Folders"（浏览资源库文件夹）对话框。
-4. 展开根节点，然后选择 *samples/java/DVDStoreAdmin-Ant*。单击 "OK"（确定）。
-5. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
-6. 单击 "Finish"（完成）。
+
+[start=3]
+. 单击 "Browse"（浏览）以打开 "Browse Repostiory Folders"（浏览资源库文件夹）对话框。
+
+[start=4]
+. 展开根节点，然后选择 *samples/java/DVDStoreAdmin-Ant*。单击 "OK"（确定）。
+
+[start=5]
+. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
+
+[start=6]
+. 单击 "Finish"（完成）。
单击 "Finish"（完成），此时 IDE 会将本地文件夹初始化为 Subversion 资源库，并检出项目源代码。
-7. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
+
+[start=7]
+. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
*注：*需要 Subversion 客户端检出源代码。有关安装 Subversion 的更多信息，请参见 link:../ide/subversion.html[+NetBeans IDE 中的 Subversion 指南+]中有关link:../ide/subversion.html#settingUp[+设置 Subversion+] 的部分。
@@ -489,13 +533,19 @@
private Date lastUpdate;*
}
----
-4. 在编辑器中右键单击，选择 "Insert Code"（插入代码）（Alt-Insert；在 Mac 上为 Ctrl-I）并在弹出菜单中选择 "Getter and Setter"（Getter 和 Setter），可以为字段生成 getter 和 setter。
-5. 在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，选择所有字段并单击 "Generate"（生成）。
+
+[start=4]
+. 在编辑器中右键单击，选择 "Insert Code"（插入代码）（Alt-Insert；在 Mac 上为 Ctrl-I）并在弹出菜单中选择 "Getter and Setter"（Getter 和 Setter），可以为字段生成 getter 和 setter。
+
+[start=5]
+. 在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，选择所有字段并单击 "Generate"（生成）。
image::images/getters-setters.png[title=""Generate Getters and Setters"（生成 getter 和 setter）对话框"]
在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，您可以使用键盘中的向上箭头将所选项目移动到 Actor 节点中，然后按空格键选择 Actor 中的所有字段。
-6. 修复导入并保存更改。
+
+[start=6]
+. 修复导入并保存更改。
为表创建 POJO 之后，您需要为 ``Actor.java`` 创建一个 Hibernate 映射文件。
@@ -515,7 +565,9 @@
</session-factory>
</hibernate-configuration>
----
-5. 对 ``Actor.hbm.xml`` 执行以下更改（黑体），将 ``Actor.java`` 中的字段映射到 ACTOR 表中的列。
+
+[start=5]
+. 对 ``Actor.hbm.xml`` 执行以下更改（黑体），将 ``Actor.java`` 中的字段映射到 ACTOR 表中的列。
[source,xml]
----
@@ -552,7 +604,9 @@
</class>*
</hibernate-mapping>
----
-6. 单击工具栏中的 "Validate XML"（验证 XML）按钮并保存更改。
+
+[start=6]
+. 单击工具栏中的 "Validate XML"（验证 XML）按钮并保存更改。
如果要进一步定制应用程序，单独创建 POJO 和 Hibernate 映射文件可能是一种非常方便的方法。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy.asciidoc
index ae6ca17..700a124 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy.asciidoc
@@ -54,17 +54,27 @@
1. Download the link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FDeploymentTutorial.zip[+DeploymentTutorial.zip+] file and extract its contents on your system.
This zip archive contains source files for the application plus a few other files that will be used in the tutorial.
-2. In NetBeans IDE, choose File > New Project.
-3. In the Choose Category page, select Java Project With Existing Sources in the Java category and click Next.
-4. On the Name and Location page of the wizard, type ``AnotherGrep`` as the project name and specify the project's location.
+[start=2]
+. In NetBeans IDE, choose File > New Project.
+
+
+[start=3]
+. In the Choose Category page, select Java Project With Existing Sources in the Java category and click Next.
+
+[start=4]
+. On the Name and Location page of the wizard, type ``AnotherGrep`` as the project name and specify the project's location.
Click Next.
The project folder does _not_ have to be in the same location as the source files that you are importing into the project.
-5. On the Existing Sources page of the wizard, specify the sources that will be in the project.
+
+[start=5]
+. On the Existing Sources page of the wizard, specify the sources that will be in the project.
Click the Add Folder button that is to the right of the Source Package Folders field. Navigate to the ``DeploymentTutorial`` folder that you have just unzipped on your system, expand the folder, select the ``src`` folder, and click Open. The ``src`` folder is added to your Source Package Folders field.
-6. Click Finish.
+
+[start=6]
+. Click Finish.
NOTE: If, for example, you want to exclude some source files from importing into the project, click Next to open the last Includes & Excludes window. In our case, we want to use all the source files in the ``src`` folder, so we click Finish to finish working in the New Project wizard.
@@ -298,11 +308,21 @@
2. (Applicable to Windows Vista only.) Click Control Panel Home > Programs.
3. For Windows XP, double-click Folder Options and select the File Types tab.
For Windows Vista or 7, click Default Programs and select Associate a file type or protocol with a program.
-4. In the Registered File Types list, select JAR File.
-5. (On Windows XP, in the Details section of the dialog box), click Change Program.
-6. In the Open With dialog box, select Java Platform SE Binary.
-7. Click OK to exit the Open With dialog box.
-8. Click Close to exit the Folder Options dialog box (on Windows XP) or the Associate a file type or protocol with a specific program dialog box (on Windows 7).
+
+[start=4]
+. In the Registered File Types list, select JAR File.
+
+[start=5]
+. (On Windows XP, in the Details section of the dialog box), click Change Program.
+
+[start=6]
+. In the Open With dialog box, select Java Platform SE Binary.
+
+[start=7]
+. Click OK to exit the Open With dialog box.
+
+[start=8]
+. Click Close to exit the Folder Options dialog box (on Windows XP) or the Associate a file type or protocol with a specific program dialog box (on Windows 7).
NOTE: If JAR files are associated with the Java Platform SE Binary on your system but double-clicking still does not execute the file JAR file, you might need to specify the ``-jar`` option in the file association.
@@ -327,9 +347,15 @@
"C:\Program Files\Java\jre1.7.0_51\bin\javaw.exe" -jar "%1" %*
----
-7. Click OK to exit the Editing Action for Type dialog box.
-8. Click OK to exit the Edit File Type dialog box.
-9. Click Close to exit the Folder Options dialog box.
+
+[start=7]
+. Click OK to exit the Editing Action for Type dialog box.
+
+[start=8]
+. Click OK to exit the Edit File Type dialog box.
+
+[start=9]
+. Click Close to exit the Folder Options dialog box.
NOTE: Starting with Windows Vista advanced file associations can be set via RegEdit. See the link:http://technet.microsoft.com/en-us/magazine/ee914604.aspx[+What Happened to the File Types Dialog?+] article for details.
@@ -355,6 +381,8 @@
C:\Program Files\Java\jdk1.7.0_51\bin
----
-6. Click OK to exit the Environment Variables dialog box, and click OK to exit the System Properties dialog box.
+
+[start=6]
+. Click OK to exit the Environment Variables dialog box, and click OK to exit the System Properties dialog box.
If you are running on a UNIX or Linux system, the instructions for modifying your PATH variable depends on the shell program you are using. Consult the documentation of the shell that you are using for more information.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ja.asciidoc
index 4cdf5d4..bc2232b 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ja.asciidoc
@@ -82,17 +82,27 @@
1. link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FDeploymentTutorial.zip[+DeploymentTutorial.zip+]ファイルをダウンロードし、その内容をシステム上に抽出します。
このzipアーカイブには、アプリケーションのソース・ファイルに加えて、このチュートリアルで使用されるその他のファイルもいくつか含まれています。
-2. NetBeans IDEで、「ファイル」>「新規プロジェクト」を選択します。
-3. カテゴリを選択ページで、「Java」カテゴリにある「既存のソースを使用するJavaプロジェクト」を選択し、「次」をクリックします。
-4. ウィザードの名前と場所ページで、プロジェクト名として「 ``AnotherGrep`` 」と入力し、プロジェクトの場所を指定します。
+[start=2]
+. NetBeans IDEで、「ファイル」>「新規プロジェクト」を選択します。
+
+
+[start=3]
+. カテゴリを選択ページで、「Java」カテゴリにある「既存のソースを使用するJavaプロジェクト」を選択し、「次」をクリックします。
+
+[start=4]
+. ウィザードの名前と場所ページで、プロジェクト名として「 ``AnotherGrep`` 」と入力し、プロジェクトの場所を指定します。
「次」をクリックします。
プロジェクト・フォルダが、プロジェクトにインポートするソース・ファイルと同じ場所に存在する必要は_ありません_。
-5. ウィザードの既存のソース・ページで、プロジェクトに含めるソースを指定します。
+
+[start=5]
+. ウィザードの既存のソース・ページで、プロジェクトに含めるソースを指定します。
「ソース・パッケージ・フォルダ」フィールドの右にある「フォルダの追加」ボタンをクリックします。システム上にある解凍済の ``DeploymentTutorial`` フォルダに移動してそのフォルダを展開し、 ``src`` フォルダを選択して「開く」をクリックします。 ``src`` フォルダが「ソース・パッケージ・フォルダ」フィールドに追加されます。
-6. 「終了」をクリックします。
+
+[start=6]
+. 「終了」をクリックします。
*注意:* たとえば、プロジェクトへのインポートから一部のソース・ファイルを除外する場合は、「次」をクリックして最後の「含める/除外する」ウィンドウを開きます。ここでは、 ``src`` フォルダ内のすべてのソース・ファイルを使用するため、「終了」をクリックして新規プロジェクト・ウィザードでの操作を終了します。
@@ -320,12 +330,20 @@
*注意:* 2013年4月のJava SE 7 Update 21以降、すべてのJavaアプレットおよびWeb Startアプリケーションは、信頼できる証明書で署名することを求められます。詳細は、link:http://www.oracle.com/technetwork/java/javase/tech/java-code-signing-1915323.html[+JavaアプレットとWeb Start - コード署名+]を参照してください。
-5. その他の設定はすべてデフォルト値のままにして、「OK」をクリックします。
-6. プロジェクトのノードを右クリックし、「消去してビルド」を選択します。
+
+[start=5]
+. その他の設定はすべてデフォルト値のままにして、「OK」をクリックします。
+
+[start=6]
+. プロジェクトのノードを右クリックし、「消去してビルド」を選択します。
このIDEコマンドによって、以前にコンパイルされたファイルやビルド出力がすべて削除され、アプリケーションが再コンパイルされて、プロジェクトが新しい設定でビルドされます。
-7. IDEの外部で、 ``_PROJECT_HOME_/dist`` フォルダを開き、 ``launch.html`` ファイルをブラウザで開きます。
+
+[start=7]
+. IDEの外部で、 ``_PROJECT_HOME_/dist`` フォルダを開き、 ``launch.html`` ファイルをブラウザで開きます。
「Launch」ボタンを含むテスト用HTMLページが開きます。
-8. 「Launch」ボタンをクリックしてアプリケーションを開きます。
+
+[start=8]
+. 「Launch」ボタンをクリックしてアプリケーションを開きます。
Javaがロードされ、アプリケーションが起動されることが確認できます。
*注意:* 一部のブラウザでは、最初にJavaのダウンロード・ページにリダイレクトされます。
@@ -361,11 +379,21 @@
2. (Windows Vistaのみ該当)「コントロール パネル ホーム」>「プログラム」をクリックします。
3. Windows XPの場合は、「フォルダ オプション」をダブルクリックし、「ファイルの種類」タブを選択します。
Windows VistaまたはWindows 7の場合は、「既定のプログラム」をクリックし、「ファイルの種類またはプロトコルのプログラムへの関連付け」を選択します。
-4. 「登録されているファイルの種類」リストで、「JARファイル」を選択します。
-5. (Windows XPの場合は、ダイアログ・ボックスの「詳細」セクションで)「プログラムの変更」をクリックします。
-6. 「ファイルを開くプログラムの選択」ダイアログ・ボックスで、「Java Platform SEバイナリ」を選択します。
-7. 「OK」をクリックして「ファイルを開くプログラムの選択」ダイアログ・ボックスを終了します。
-8. 「閉じる」をクリックして、「フォルダ オプション」ダイアログ・ボックス(Windows XPの場合)、または「ファイルの種類またはプロトコルのプログラムへの関連付け」ダイアログ・ボックス(Windows 7の場合)を終了します。
+
+[start=4]
+. 「登録されているファイルの種類」リストで、「JARファイル」を選択します。
+
+[start=5]
+. (Windows XPの場合は、ダイアログ・ボックスの「詳細」セクションで)「プログラムの変更」をクリックします。
+
+[start=6]
+. 「ファイルを開くプログラムの選択」ダイアログ・ボックスで、「Java Platform SEバイナリ」を選択します。
+
+[start=7]
+. 「OK」をクリックして「ファイルを開くプログラムの選択」ダイアログ・ボックスを終了します。
+
+[start=8]
+. 「閉じる」をクリックして、「フォルダ オプション」ダイアログ・ボックス(Windows XPの場合)、または「ファイルの種類またはプロトコルのプログラムへの関連付け」ダイアログ・ボックス(Windows 7の場合)を終了します。
*注意:* システム上でJARファイルがJava Platform SEバイナリに関連付けられているが、依然としてJARファイルをダブルクリックしても実行されない場合は、ファイルの関連付けで ``-jar`` オプションの指定が必要である可能性があります。
@@ -390,9 +418,15 @@
"C:\Program Files\Java\jre1.7.0_51\bin\javaw.exe" -jar "%1" %*
----
-7. 「OK」をクリックして「アクションの編集」ダイアログ・ボックスを終了します。
-8. 「OK」をクリックして「ファイルの種類の編集」ダイアログ・ボックスを終了します。
-9. 「閉じる」をクリックして「フォルダ オプション」ダイアログ・ボックスを終了します。
+
+[start=7]
+. 「OK」をクリックして「アクションの編集」ダイアログ・ボックスを終了します。
+
+[start=8]
+. 「OK」をクリックして「ファイルの種類の編集」ダイアログ・ボックスを終了します。
+
+[start=9]
+. 「閉じる」をクリックして「フォルダ オプション」ダイアログ・ボックスを終了します。
*注意:* Windows Vista以降の詳細なファイルの関連付けは、RegEditを使用して設定できます。詳細は、link:http://technet.microsoft.com/en-us/magazine/ee914604.aspx[+「ファイルの種類」ダイアログで何が発生したか+]の記事を参照してください。
@@ -419,7 +453,9 @@
C:\Program Files\Java\jdk1.7.0_51\bin
----
-6. 「OK」をクリックして「環境変数」ダイアログ・ボックスを終了し、「OK」をクリックして「システムのプロパティ」ダイアログ・ボックスを終了します。
+
+[start=6]
+. 「OK」をクリックして「環境変数」ダイアログ・ボックスを終了し、「OK」をクリックして「システムのプロパティ」ダイアログ・ボックスを終了します。
UNIXまたはLinuxシステム上で実行している場合、PATH変数を変更するための手順は、使用しているシェル・プログラムによって異なります。詳細は、使用しているシェルのドキュメントを参照してください。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_pt_BR.asciidoc
index 0befeed..388eca7 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_pt_BR.asciidoc
@@ -83,17 +83,27 @@
1. Faça download do arquivo link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FDeploymentTutorial.zip[+DeploymentTutorial.zip+] e extraia seu conteúdo no sistema.
Esse arquivo compactado zip contém arquivos de código-fonte para a aplicação, além de alguns outros arquivos que serão usados no tutorial.
-2. No NetBeans IDE, escolha Arquivo > Novo Projeto.
-3. Na página Selecionar Categoria, selecione Projeto Java com Códigos-fonte Existentes na categoria Java e clique em Próximo.
-4. Na página Nome e Localização do assistente, digite ``AnotherGrep`` como o nome do projeto e especifique o local do projeto.
+[start=2]
+. No NetBeans IDE, escolha Arquivo > Novo Projeto.
+
+
+[start=3]
+. Na página Selecionar Categoria, selecione Projeto Java com Códigos-fonte Existentes na categoria Java e clique em Próximo.
+
+[start=4]
+. Na página Nome e Localização do assistente, digite ``AnotherGrep`` como o nome do projeto e especifique o local do projeto.
Clique em Próximo.
A pasta do projeto _não_ precisa estar no mesmo local que os arquivos de código-fonte que você está importando para o projeto.
-5. Na página Códigos-fonte existentes do assistente, especifique os códigos-fonte que estarão no projeto.
+
+[start=5]
+. Na página Códigos-fonte existentes do assistente, especifique os códigos-fonte que estarão no projeto.
Clique no botão Adicionar Pasta, à direita do campo Pastas de Pacote de Código-fonte. Navegue até a pasta ``DeploymentTutorial`` que você acabou de descompactar em seu sistema, expanda a pasta, selecione a pasta ``src`` e clique em Abrir. A pasta ``src`` é adicionada ao campo Pastas de Pacote de Código-fonte.
-6. Clique em Finalizar.
+
+[start=6]
+. Clique em Finalizar.
*Observação:* Se, por exemplo, você desejar excluir alguns arquivos de código-fonte da importação para o projeto, clique em Próximo para abrir a última janela Inclusões e Exclusões. Em nosso caso, queremos usar todos os arquivos de código-fonte na pasta ``src`` , portanto clicamos em Finalizar para concluir o assistente Novo Projeto.
@@ -321,12 +331,20 @@
*Observação:* a partir do Java SE 7 Atualização 21 de abril de 2013, é recomendável que todos os Applets Java e Aplicações Web Start sejam assinados com um certificado confiável. Consulte link:http://www.oracle.com/technetwork/java/javase/tech/java-code-signing-1915323.html[+Applet Java e Web Start - Assinatura de Código+] para obter mais informações.
-5. Deixe todas as outras definições com seus valores default e clique em OK.
-6. Clique com o botão direito do mouse no nó do projeto e escolha Limpar e Construir Projeto.
+
+[start=5]
+. Deixe todas as outras definições com seus valores default e clique em OK.
+
+[start=6]
+. Clique com o botão direito do mouse no nó do projeto e escolha Limpar e Construir Projeto.
Este comando do IDE deleta todos os arquivos anteriormente compilados e as saídas geradas, recompila sua aplicação e constrói o projeto com as novas definições.
-7. Fora do IDE, abra a pasta ``_PROJECT_HOME_/dist`` e abra o arquivo ``launch.html`` no browser.
+
+[start=7]
+. Fora do IDE, abra a pasta ``_PROJECT_HOME_/dist`` e abra o arquivo ``launch.html`` no browser.
A página HTML de teste com o botão Iniciar é aberta.
-8. Clique no botão Iniciar para abrir a aplicação.
+
+[start=8]
+. Clique no botão Iniciar para abrir a aplicação.
Você pode ver que o Java foi carregado e a aplicação é iniciada.
*Observação:* alguns browsers redirecionam primeiro para a página de download do Java.
@@ -362,11 +380,21 @@
2. (Aplicável somente para Windows Vista.) Clique em Painel de Controle > Programas.
3. Para Windows xp, clique duas vezes em Opções de Pasta e selecione a guia Tipos de Arquivo.
para Windows Vista ou 7, clique em Programas Default e selecione Associar um tipo de arquivo ou protocolo com um programa.
-4. Na lista Tipos de Arquivos Registrados, selecione Arquivo JAR.
-5. (no Windows XP, na seção Detalhes da caixa de diálogo), clique em Alterar Programa.
-6. Na caixa de diálogo Abrir com, selecione Java Platform SE Binary.
-7. Clique em OK para sair da caixa de diálogo Abrir com.
-8. Clique em Fechar para sair da caixa de diálogo Opções de Pasta (no Windows xp) ou o tipo de arquivo ou associar um protocolo com uma caixa de diálogo de programa específico (no Windows 7).
+
+[start=4]
+. Na lista Tipos de Arquivos Registrados, selecione Arquivo JAR.
+
+[start=5]
+. (no Windows XP, na seção Detalhes da caixa de diálogo), clique em Alterar Programa.
+
+[start=6]
+. Na caixa de diálogo Abrir com, selecione Java Platform SE Binary.
+
+[start=7]
+. Clique em OK para sair da caixa de diálogo Abrir com.
+
+[start=8]
+. Clique em Fechar para sair da caixa de diálogo Opções de Pasta (no Windows xp) ou o tipo de arquivo ou associar um protocolo com uma caixa de diálogo de programa específico (no Windows 7).
*Observação:* se os arquivos JAR estiverem associados com o Java Platform SE Binary em seu sistema, mas ao clicar duas vezes ainda não foi executado o arquivo JAR, poderá ser necessário especificar a opção ``-jar`` na associação do arquivo.
@@ -391,9 +419,15 @@
"C:\Program Files\Java\jre1.7.0_51\bin\javaw.exe" -jar "%1" %*
----
-7. Clique em OK para sair da caixa de diálogo Ação de Edição para o Tipo.
-8. Clique em OK para sair da caixa de diálogo Editar Tipo de Arquivo.
-9. Clique em Fechar para sair da caixa de diálogo Opções de Pasta.
+
+[start=7]
+. Clique em OK para sair da caixa de diálogo Ação de Edição para o Tipo.
+
+[start=8]
+. Clique em OK para sair da caixa de diálogo Editar Tipo de Arquivo.
+
+[start=9]
+. Clique em Fechar para sair da caixa de diálogo Opções de Pasta.
*Observação:* iniciando com Windows Vista as associações do arquivo avançadas podem ser definidas por regedit. Consulte o artigo link:http://technet.microsoft.com/en-us/magazine/ee914604.aspx[+O que Aconteceu com a Caixa de Diálogo Tipos de Artigo?+] para obter detalhes.
@@ -420,7 +454,9 @@
C:\Program Files\Java\jdk1.7.0_51\bin
----
-6. Clique em OK para sair da caixa de diálogo Variáveis de Ambiente, e clique em OK para sair da caixa de diálogo Propriedades do Sistema.
+
+[start=6]
+. Clique em OK para sair da caixa de diálogo Variáveis de Ambiente, e clique em OK para sair da caixa de diálogo Propriedades do Sistema.
Se você estiver executando um sistema UNIX ou Linux, as instruções para modificar a variável PATH depende do programa shell que está em uso. Consulte a documentação do shell que está em uso para obter mais informações.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ru.asciidoc
index e6fece8..c472845 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_ru.asciidoc
@@ -82,17 +82,27 @@
1. Загрузите файл link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FDeploymentTutorial.zip[+DeploymentTutorial.zip+] и извлеките его содержимое.
Данный архив ZIP содержит файлы исходного кода для приложения, а также несколько других файлов, которые будут использованы в этом руководстве.
-2. В IDE NetBeans выберите 'Файл' > 'Создать проект'.
-3. На странице Choose Category ("Выбор категории") выберите Java Project With Existing Sources ("Проект Java с существующим исходным кодом") в категории Java и нажмите кнопку Next ("Далее").
-4. На странице Name and Location ("Имя и местоположение") мастера введите ``AnotherGrep`` в поле имени проекта и укажите местоположение проекта.
+[start=2]
+. В IDE NetBeans выберите 'Файл' > 'Создать проект'.
+
+
+[start=3]
+. На странице Choose Category ("Выбор категории") выберите Java Project With Existing Sources ("Проект Java с существующим исходным кодом") в категории Java и нажмите кнопку Next ("Далее").
+
+[start=4]
+. На странице Name and Location ("Имя и местоположение") мастера введите ``AnotherGrep`` в поле имени проекта и укажите местоположение проекта.
Нажмите кнопку "Далее".
Местоположение папки проекта _не_ обязательно должно совпадать с местоположением исходных файлов, импортируемых в проект.
-5. На странице мастера Existing Sources ("Существующие исходные файлы") укажите файлы исходного кода, которые будут включены в проект.
+
+[start=5]
+. На странице мастера Existing Sources ("Существующие исходные файлы") укажите файлы исходного кода, которые будут включены в проект.
Нажмите кнопку Add Folder ("Добавить папку") справа от поля Source Package Folders ("Папки пакетов исходного кода"). Перейдите к папке ``DeploymentTutorial`` , которую только что разархивировали, разверните папку, выберите папку ``src`` и нажмите кнопку Open ("Открыть"). Папка ``src`` будет добавлена к полю Source Package Folders ("Папки пакетов исходного кода").
-6. Нажмите кнопку "Завершить".
+
+[start=6]
+. Нажмите кнопку "Завершить".
*Примечание.* Если, например, необходимо исключить определенные исходные файлы из операции импорта в проект, щелкните 'Далее', чтобы открыть последнее окно 'Включает & Исключает'. В этом случае необходимо использовать все исходные файлы в папке ``src`` поэтому нажимается кнопка 'Готово', чтобы завершить работу в мастере создания проектов.
@@ -320,12 +330,20 @@
*Примечание.* Начиная с обновления Java SE 7 Update 21, выпущенного в апреле 2013 г., рекомендуется использование подписанных доверенных сертификатов для всех Java-аплетов и приложений Web Start Для получения дополнительной информации см. link:http://www.oracle.com/technetwork/java/javase/tech/java-code-signing-1915323.html[+Апплеты Java и Web Start - подпись кода+].
-5. Сохраните все прочие параметры по умолчанию и нажмите кнопку "OК".
-6. Щелкните правой кнопкой мыши узел проекта и выберите Clean and Build Project ("Очистка и сборка проекта").
+
+[start=5]
+. Сохраните все прочие параметры по умолчанию и нажмите кнопку "OК".
+
+[start=6]
+. Щелкните правой кнопкой мыши узел проекта и выберите Clean and Build Project ("Очистка и сборка проекта").
Данная команда среды IDE удалит все ранее скомпилированные файлы и результаты сборок, скомпилирует приложение заново и соберет проект с новыми параметрами.
-7. Вне среды IDE откройте папку ``_PROJECT_HOME_/dist`` , после чего откройте файл ``launch.html`` в своем браузере.
+
+[start=7]
+. Вне среды IDE откройте папку ``_PROJECT_HOME_/dist`` , после чего откройте файл ``launch.html`` в своем браузере.
Появится тестовая страница HTML с кнопкой Launch ("Запуск").
-8. Нажмите кнопку Launch, чтобы открыть приложение.
+
+[start=8]
+. Нажмите кнопку Launch, чтобы открыть приложение.
Можно будет увидеть, что Java загружена и приложение запускается.
*Примечание.* Некоторые браузеры сначала перенаправляют пользователей на страницу загрузок Java.
@@ -361,11 +379,21 @@
2. (Применимо только к Windows Vista). Щелкните 'Панель управления' > 'Программы'.
3. В Windows XP дважды щелкните 'Свойства папки' и выберите вкладку 'Типы файлов'.
Для Windows Vista или 7 щелкните 'Программы по умолчанию' и выберите 'Связать тип файла или протокол с программой'.
-4. В списке "Зарегистрированные типы файлов" выберите файл JAR.
-5. (В Windows XP в разделе "Сведения" диалогового окна щелкните "Изменить программу").
-6. В диалоговом окне "Выбор программы" выберите Java Platform SE Binary.
-7. Нажмите кнопку "OК" для выхода из диалогового окна "Выбор программы".
-8. Нажмите кнопку 'Закрыть', чтобы закрыть диалоговое окно 'Свойства папки' (в Windows XP) или диалогового окна связывания типа файла или протокола с конкретными программами (в Windows 7).
+
+[start=4]
+. В списке "Зарегистрированные типы файлов" выберите файл JAR.
+
+[start=5]
+. (В Windows XP в разделе "Сведения" диалогового окна щелкните "Изменить программу").
+
+[start=6]
+. В диалоговом окне "Выбор программы" выберите Java Platform SE Binary.
+
+[start=7]
+. Нажмите кнопку "OК" для выхода из диалогового окна "Выбор программы".
+
+[start=8]
+. Нажмите кнопку 'Закрыть', чтобы закрыть диалоговое окно 'Свойства папки' (в Windows XP) или диалогового окна связывания типа файла или протокола с конкретными программами (в Windows 7).
*Примечание.* Если файлы JAR files связаны с Java Platform SE Binary в системе, но двойной щелчок все равно не запускает файл JAR, может потребовать указание параметра ``-jar`` в связи файлов.
@@ -390,9 +418,15 @@
"C:\Program Files\Java\jre1.7.0_51\bin\javaw.exe" -jar "%1" %*
----
-7. Нажмите кнопку "OК" для выхода из диалогового окна "Изменение действия для типа".
-8. Нажмите кнопку "OК" для выхода из диалогового окна "Изменение свойств типа файлов".
-9. Нажмите кнопку "Закрыть" для выхода из диалогового окна "Свойства папки".
+
+[start=7]
+. Нажмите кнопку "OК" для выхода из диалогового окна "Изменение действия для типа".
+
+[start=8]
+. Нажмите кнопку "OК" для выхода из диалогового окна "Изменение свойств типа файлов".
+
+[start=9]
+. Нажмите кнопку "Закрыть" для выхода из диалогового окна "Свойства папки".
*Примечание.* Начиная с Windows Vista расширенные связи файлов можно настроить с помощью RegEdit. Дополнительные сведения см. в статье link:http://technet.microsoft.com/en-us/magazine/ee914604.aspx[+Что произошло с диалоговым окном типов файлов?+].
@@ -419,7 +453,9 @@
C:\Program Files\Java\jdk1.7.0_51\bin
----
-6. Нажмите кнопку "OК" для выхода из диалогового окна "Переменные среды", затем нажмите кнопку "ОК" для выхода из диалогового окна "Свойства системы".
+
+[start=6]
+. Нажмите кнопку "OК" для выхода из диалогового окна "Переменные среды", затем нажмите кнопку "ОК" для выхода из диалогового окна "Свойства системы".
При работе в операционной системе UNIX или Linux способ изменения переменной среды PATH зависит от используемой программы интерпретатора команд. Ознакомьтесь с документацией по интерпретатору команд для получения дополнительных сведений.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_zh_CN.asciidoc
index c1a1b5d..7423479 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-deploy_zh_CN.asciidoc
@@ -82,17 +82,27 @@
1. 下载 link:https://netbeans.org/projects/samples/downloads/download/Samples%252FJava%252FDeploymentTutorial.zip[+DeploymentTutorial.zip+] 文件，并将其内容解压缩到您的系统上。
该 zip 档案包含应用程序的源文件以及本教程中要使用的其他几个文件。
-2. 在 NetBeans IDE 中，选择“文件”>“新建项目”。
-3. 在“选择类别”页的 "Java" 类别中，选择“基于现有源代码的 Java 项目”，然后单击“下一步”。
-4. 在向导的“名称和位置”页中，键入 ``AnotherGrep`` 作为项目名称，然后指定项目的位置。
+[start=2]
+. 在 NetBeans IDE 中，选择“文件”>“新建项目”。
+
+
+[start=3]
+. 在“选择类别”页的 "Java" 类别中，选择“基于现有源代码的 Java 项目”，然后单击“下一步”。
+
+[start=4]
+. 在向导的“名称和位置”页中，键入 ``AnotherGrep`` 作为项目名称，然后指定项目的位置。
单击 "Next"（下一步）。
项目文件夹_不必_与将要导入项目的源文件位于相同的位置。
-5. 在向导的“现有源代码”页中，指定项目中要包含的源文件。
+
+[start=5]
+. 在向导的“现有源代码”页中，指定项目中要包含的源文件。
单击“源包文件夹”字段右侧的“添加文件夹”按钮。导航至刚在系统上解压缩的 ``DeploymentTutorial`` 文件夹，展开该文件夹，选择 ``src`` 文件夹，然后单击“打开”。此时将向“源包文件夹”字段中添加 ``src`` 文件夹。
-6. 单击“完成”。
+
+[start=6]
+. 单击“完成”。
*注：*举例来说，如果要在导入到项目时排除某些源文件，请单击“下一步”打开最后一个“包括和排除”窗口。在本示例中，我们希望使用 ``src`` 文件夹中的所有源文件，因此，只需单击“完成”完成“新建项目”向导中的工作即可。
@@ -320,12 +330,20 @@
*注：*从 2013 年 4 月的 Java SE 7 Update 21 开始，鼓励使用可信证书对所有 Java 小应用程序和 Web Start 应用程序进行签名。有关详细信息，请参见 link:http://www.oracle.com/technetwork/java/javase/tech/java-code-signing-1915323.html[+Java 小应用程序和 Web Start - 代码签名+]。
-5. 将所有其他设置保留默认值，然后单击“确定”。
-6. 右键单击项目节点，然后选择“清理并构建”。
+
+[start=5]
+. 将所有其他设置保留默认值，然后单击“确定”。
+
+[start=6]
+. 右键单击项目节点，然后选择“清理并构建”。
此 IDE 命令将删除以前编译的所有文件和构建输出，重新编译应用程序，然后使用新设置构建项目。
-7. 在 IDE 外部，打开 ``_PROJECT_HOME_/dist`` 文件夹，然后在浏览器中打开 ``launch.html`` 文件。
+
+[start=7]
+. 在 IDE 外部，打开 ``_PROJECT_HOME_/dist`` 文件夹，然后在浏览器中打开 ``launch.html`` 文件。
此时将打开包含“启动”按钮的测试 HTML 页。
-8. 单击“启动”按钮以打开应用程序。
+
+[start=8]
+. 单击“启动”按钮以打开应用程序。
您可以看到已加载 Java 并启动了应用程序。
*注：*某些浏览器先将您重定向到 Java 下载页。
@@ -361,11 +379,21 @@
2. （仅适用于 Windows Vista。）单击“控制面板”>“程序”。
3. 对于 Windows XP，双击“文件夹选项”，然后选择“文件类型”标签。
对于 Windows Vista 或 Windows 7，单击“默认程序”并选择“将文件类型或协议与程序关联”。
-4. 在“已注册的文件类型”列表中，选择“JAR 文件”。
-5. （在 Windows XP 上，在对话框的详细信息部分中）单击“更改程序”。
-6. 在“打开方式”对话框中，选择 "Java Platform SE Binary"。
-7. 单击“确定”以退出“打开方式”对话框。
-8. 单击“关闭”以退出“文件夹选项”对话框（在 Windows XP 上）或“将文件类型或协议与特定程序关联”对话框（在 Windows 7 上）。
+
+[start=4]
+. 在“已注册的文件类型”列表中，选择“JAR 文件”。
+
+[start=5]
+. （在 Windows XP 上，在对话框的详细信息部分中）单击“更改程序”。
+
+[start=6]
+. 在“打开方式”对话框中，选择 "Java Platform SE Binary"。
+
+[start=7]
+. 单击“确定”以退出“打开方式”对话框。
+
+[start=8]
+. 单击“关闭”以退出“文件夹选项”对话框（在 Windows XP 上）或“将文件类型或协议与特定程序关联”对话框（在 Windows 7 上）。
*注：*如果 JAR 文件与系统上的 Java Platform SE Binary 关联，但双击时仍不执行 JAR 文件，则可能需要在文件关联中指定 ``-jar`` 选项。
@@ -390,9 +418,15 @@
"C:\Program Files\Java\jre1.7.0_51\bin\javaw.exe" -jar "%1" %*
----
-7. 单击“确定”以退出“编辑这种类型的操作”对话框。
-8. 单击“确定”以退出“编辑文件类型”对话框。
-9. 单击“关闭”以退出“文件夹选项”对话框。
+
+[start=7]
+. 单击“确定”以退出“编辑这种类型的操作”对话框。
+
+[start=8]
+. 单击“确定”以退出“编辑文件类型”对话框。
+
+[start=9]
+. 单击“关闭”以退出“文件夹选项”对话框。
*注：*从 Windows Vista 开始，可以通过 RegEdit 编辑高级文件关联。有关详细信息，请参见link:http://technet.microsoft.com/en-us/magazine/ee914604.aspx[+“文件类型”对话框有什么变化？+]一文。
@@ -419,7 +453,9 @@
C:\Program Files\Java\jdk1.7.0_51\bin
----
-6. 单击“确定”以退出“环境变量”对话框，然后单击“确定”以退出“系统属性”对话框。
+
+[start=6]
+. 单击“确定”以退出“环境变量”对话框，然后单击“确定”以退出“系统属性”对话框。
如果要在 UNIX 或 Linux 系统上运行，则如何修改 PATH 变量取决于所使用的 shell 程序。有关详细信息，请查阅所使用的 shell 的文档。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded.asciidoc
index 56de559..99c40a2 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded.asciidoc
@@ -52,10 +52,18 @@
image::images/plugins-small.png[role="left", link="images/plugins.png"]
--
-3. Click Activate.
-4. At the Welcome panel of the Installer dialog box, click Activate.
-5. When the activation is successfully completed, click Finish.
-6. Click Close to close the Plugins dialog box.
+
+[start=3]
+. Click Activate.
+
+[start=4]
+. At the Welcome panel of the Installer dialog box, click Activate.
+
+[start=5]
+. When the activation is successfully completed, click Finish.
+
+[start=6]
+. Click Close to close the Plugins dialog box.
*To install a remote Java SE platform in NetBeans IDE:*
@@ -67,8 +75,12 @@
image::images/jpmanager-small.png[role="left", link="images/jpmanager.png"]
--
-2. Click Add Platform.
-3. In the Select Platform Type of the Add Java Platform wizard, select Remote Java Standard Edition and click Next.
+
+[start=2]
+. Click Add Platform.
+
+[start=3]
+. In the Select Platform Type of the Add Java Platform wizard, select Remote Java Standard Edition and click Next.
The IDE displays the Add Java Platform dialog box.
[.feature]
@@ -76,11 +88,15 @@
image::images/addjp-small.png[role="left", link="images/addjp.png"]
--
-4. Specify the remote platform details such as the name, the IP address or DNS name of the device, login, password, and the path to the JRE on the remote device.
+
+[start=4]
+. Specify the remote platform details such as the name, the IP address or DNS name of the device, login, password, and the path to the JRE on the remote device.
NOTE: The target operating system must be UNIX (Windows is not supported).
-5. Click Finish. The IDE validates the remote JRE by executing a probe and downloads the remote JRE system properties.
+
+[start=5]
+. Click Finish. The IDE validates the remote JRE by executing a probe and downloads the remote JRE system properties.
A new remote Java SE platform displays in the Java Platform Manager dialog box.
[.feature]
@@ -108,9 +124,13 @@
image::images/wizard-small.png[role="left", link="images/wizard.png"]
--
-4. Click Finish.
+
+[start=4]
+. Click Finish.
The IDE creates and opens the Java SE project in the Projects window.
-5. Replace the ``// TODO code application logic here`` line with the following code:
+
+[start=5]
+. Replace the ``// TODO code application logic here`` line with the following code:
[source,java]
----
@@ -120,7 +140,9 @@
int c = a + b;
System.out.println (c);
----
-6. Save your changes by choosing File > Save.
+
+[start=6]
+. Save your changes by choosing File > Save.
To test your application, right-click the project name and choose Run from the context menu. The calculated output can be viewed in the Output window (Window > Output).
@@ -142,7 +164,9 @@
image::images/jdk8-small.png[role="left", link="images/jdk8.png"]
--
-5. Verify that the default locations of the platform sources zip file and API documentation are valid. Click Finish to close the Add Java Platform dialog box.
+
+[start=5]
+. Verify that the default locations of the platform sources zip file and API documentation are valid. Click Finish to close the Add Java Platform dialog box.
JDK 8 is registered as a platform in the IDE.
[.feature]
@@ -150,7 +174,9 @@
image::images/jdk8registered-small.png[role="left", link="images/jdk8registered.png"]
--
-6. Click Close.
+
+[start=6]
+. Click Close.
*To configure your project to use JDK 8:*
@@ -162,21 +188,27 @@
image::images/prj-jdk8-small.png[role="left", link="images/prj-jdk8.png"]
--
-3. Select the Sources category and set Source/Binary Format to JDK 8.
+
+[start=3]
+. Select the Sources category and set Source/Binary Format to JDK 8.
[.feature]
--
image::images/prj-source-jdk8-small.png[role="left", link="images/prj-source-jdk8.png"]
--
-4. Specify the profile that is used as runtime on a remote platform (for example, Compact 2).
+
+[start=4]
+. Specify the profile that is used as runtime on a remote platform (for example, Compact 2).
[.feature]
--
image::images/prj-jdk8-profile-small.png[role="left", link="images/prj-jdk8-profile.png"]
--
-5. Click OK to save the changes.
+
+[start=5]
+. Click OK to save the changes.
Your project is set to recognize a particular runtime on a remote platform.
== Running a Project on a Remote Platfrom
@@ -196,7 +228,9 @@
image::images/config-runtime-small.png[role="left", link="images/config-runtime.png"]
--
-6. Click OK to save your edits.
+
+[start=6]
+. Click OK to save your edits.
If you run the project on a remote platform (Run > Run Project (project name)), the output will look similar to what is shown in the figure below.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ja.asciidoc
index 72ea2f3..095cf69 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ja.asciidoc
@@ -67,10 +67,18 @@
image::images/plugins-small.png[role="left", link="images/plugins.png"]
--
-3. 「アクティブ化」をクリックします。
-4. 「インストーラ」ダイアログ・ボックスの「ようこそ」パネルで「アクティブ化」をクリックします。
-5. アクティブ化が正常に完了したら、「終了」をクリックします。
-6. 「閉じる」をクリックして「プラグイン」ダイアログ・ボックスを閉じます。
+
+[start=3]
+. 「アクティブ化」をクリックします。
+
+[start=4]
+. 「インストーラ」ダイアログ・ボックスの「ようこそ」パネルで「アクティブ化」をクリックします。
+
+[start=5]
+. アクティブ化が正常に完了したら、「終了」をクリックします。
+
+[start=6]
+. 「閉じる」をクリックして「プラグイン」ダイアログ・ボックスを閉じます。
*NetBeans IDEへリモートJava SEプラットフォームをインストールするには:*
@@ -82,8 +90,12 @@
image::images/jpmanager-small.png[role="left", link="images/jpmanager.png"]
--
-2. 「プラットフォームの追加」をクリックします。
-3. 「Javaプラットフォームの追加」ウィザードの「プラットフォーム・タイプを選択」で「リモートJava Standard Edition」を選択して、「次」をクリックします。
+
+[start=2]
+. 「プラットフォームの追加」をクリックします。
+
+[start=3]
+. 「Javaプラットフォームの追加」ウィザードの「プラットフォーム・タイプを選択」で「リモートJava Standard Edition」を選択して、「次」をクリックします。
IDEで「Javaプラットフォームの追加」ダイアログ・ボックスが表示されます。
[.feature]
@@ -91,11 +103,15 @@
image::images/addjp-small.png[role="left", link="images/addjp.png"]
--
-4. デバイスの名前、IPアドレスまたはDNS名、ログイン、パスワード、リモート・デバイス上のJREへのパスなど、リモート・プラットフォームの詳細を指定します。
+
+[start=4]
+. デバイスの名前、IPアドレスまたはDNS名、ログイン、パスワード、リモート・デバイス上のJREへのパスなど、リモート・プラットフォームの詳細を指定します。
*注意:* ターゲット・オペレーティング・システムはUNIXである必要があります(Windowsはサポートされていません)。
-5. 「終了」をクリックします。プローブを実行してリモートJREシステム・プロパティをダウンロードすることで、IDEでリモートJREが検証されます。
+
+[start=5]
+. 「終了」をクリックします。プローブを実行してリモートJREシステム・プロパティをダウンロードすることで、IDEでリモートJREが検証されます。
「Javaプラットフォーム・マネージャ」ダイアログ・ボックスに、新しいリモートJava SEプラットフォームが表示されます。
[.feature]
@@ -124,9 +140,13 @@
image::images/wizard-small.png[role="left", link="images/wizard.png"]
--
-4. 「終了」をクリックします。
+
+[start=4]
+. 「終了」をクリックします。
Java SEプロジェクトがIDEで作成され、「プロジェクト」ウィンドウで開かれます。
-5. ``//TODO code application logic here`` 行を次のコードで置き換えます。
+
+[start=5]
+. ``//TODO code application logic here`` 行を次のコードで置き換えます。
[source,java]
----
@@ -136,7 +156,9 @@
int c = a + b;
System.out.println (c);
----
-6. 「ファイル」>「保存」を選択して、変更内容を保存します。
+
+[start=6]
+. 「ファイル」>「保存」を選択して、変更内容を保存します。
アプリケーションをテストするには、プロジェクト名を右クリックし、コンテキスト・メニューの「実行」を選択します。計算した出力は、「出力」ウィンドウで確認できます(「ウィンドウ」>「出力」)。
@@ -159,7 +181,9 @@
image::images/jdk8-small.png[role="left", link="images/jdk8.png"]
--
-5. 「プラットフォームのソース」のzipファイルとAPIドキュメントのデフォルトの場所が有効であることを確認します。「終了」をクリックして「Javaプラットフォームの追加」ダイアログ・ボックスを閉じます。
+
+[start=5]
+. 「プラットフォームのソース」のzipファイルとAPIドキュメントのデフォルトの場所が有効であることを確認します。「終了」をクリックして「Javaプラットフォームの追加」ダイアログ・ボックスを閉じます。
JDK 8がIDEでプラットフォームとして登録されます。
[.feature]
@@ -167,7 +191,9 @@
image::images/jdk8registered-small.png[role="left", link="images/jdk8registered.png"]
--
-6. 「閉じる」をクリックします。
+
+[start=6]
+. 「閉じる」をクリックします。
*JDK 8を使用するようにプロジェクトを構成するには:*
@@ -179,21 +205,27 @@
image::images/prj-jdk8-small.png[role="left", link="images/prj-jdk8.png"]
--
-3. 「ソース」カテゴリを選択して、「ソース/バイナリ形式」をJDK 8に設定します。
+
+[start=3]
+. 「ソース」カテゴリを選択して、「ソース/バイナリ形式」をJDK 8に設定します。
[.feature]
--
image::images/prj-source-jdk8-small.png[role="left", link="images/prj-source-jdk8.png"]
--
-4. リモート・プラットフォームでランタイムとして使用するプロファイルを指定します(Compact 2など)。
+
+[start=4]
+. リモート・プラットフォームでランタイムとして使用するプロファイルを指定します(Compact 2など)。
[.feature]
--
image::images/prj-jdk8-profile-small.png[role="left", link="images/prj-jdk8-profile.png"]
--
-5. 「OK」をクリックして変更を保存します。
+
+[start=5]
+. 「OK」をクリックして変更を保存します。
プロジェクトは、リモート・プラットフォームで特定のランタイムを認識するように設定されます。
@@ -214,7 +246,9 @@
image::images/config-runtime-small.png[role="left", link="images/config-runtime.png"]
--
-6. 「OK」をクリックして編集を保存します。
+
+[start=6]
+. 「OK」をクリックして編集を保存します。
リモート・プラットフォーム(「実行」>「プロジェクトの実行」(プロジェクト名))でプロジェクトを実行する場合、出力は次の図のようになります。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_pt_BR.asciidoc
index 3a8af23..96ebb86 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_pt_BR.asciidoc
@@ -67,10 +67,18 @@
image::images/plugins-small.png[role="left", link="images/plugins.png"]
--
-3. Clique em Ativar.
-4. No painel de Boas-vindas da caixa de diálogo do Instalador, clique em Ativar.
-5. Quando a ativação foi concluída com êxito, clique em Finalizar.
-6. Clique em Fechar para fechar a caixa de diálogo Plug-ins.
+
+[start=3]
+. Clique em Ativar.
+
+[start=4]
+. No painel de Boas-vindas da caixa de diálogo do Instalador, clique em Ativar.
+
+[start=5]
+. Quando a ativação foi concluída com êxito, clique em Finalizar.
+
+[start=6]
+. Clique em Fechar para fechar a caixa de diálogo Plug-ins.
*Para instalar uma plataforma Java SE remota no NetBeans IDE:*
@@ -82,8 +90,12 @@
image::images/jpmanager-small.png[role="left", link="images/jpmanager.png"]
--
-2. Clique em Adicionar Plataforma.
-3. Na opção Selecionar Tipo de Plataforma do assistente de Adição de Plataforma Java, selecione Remote Java Standard Edition e clique em Próximo.
+
+[start=2]
+. Clique em Adicionar Plataforma.
+
+[start=3]
+. Na opção Selecionar Tipo de Plataforma do assistente de Adição de Plataforma Java, selecione Remote Java Standard Edition e clique em Próximo.
O IDE exibe a caixa de diálogo Adicionar Plataforma Java.
[.feature]
@@ -91,11 +103,15 @@
image::images/addjp-small.png[role="left", link="images/addjp.png"]
--
-4. Especifique os detalhes da plataforma remota, como nome, endereço IP ou nome do DNS do dispositivo, log-in, senha e o caminho para o JRE no dispositivo remoto.
+
+[start=4]
+. Especifique os detalhes da plataforma remota, como nome, endereço IP ou nome do DNS do dispositivo, log-in, senha e o caminho para o JRE no dispositivo remoto.
*Observação:* o sistema operacional de destino deve ser o UNIX (o Windows não é suportado).
-5. Clique em Finalizar. O IDE valida o JRE remoto executando uma sondagem e faz download das propriedades do sistema JRE remoto.
+
+[start=5]
+. Clique em Finalizar. O IDE valida o JRE remoto executando uma sondagem e faz download das propriedades do sistema JRE remoto.
Uma nova plataforma Java SE remota é exibida na caixa de diálogo Gerenciador de Plataformas Java.
[.feature]
@@ -124,9 +140,13 @@
image::images/wizard-small.png[role="left", link="images/wizard.png"]
--
-4. Clique em Finalizar.
+
+[start=4]
+. Clique em Finalizar.
O IDE cria e abre o projeto Java SE na janela Projetos.
-5. Substitua a linha ``// TODO code application logic here`` pelo seguinte código:
+
+[start=5]
+. Substitua a linha ``// TODO code application logic here`` pelo seguinte código:
[source,java]
----
@@ -136,7 +156,9 @@
int c = a + b;
System.out.println (c);
----
-6. Salve as alterações escolhendo Arquivo > Salvar.
+
+[start=6]
+. Salve as alterações escolhendo Arquivo > Salvar.
Para testar sua aplicação, clique com o botão direito do mouse no nome do projeto e escolha Executar no menu de contexto. A saída calculada pode ser exibida na janela Saída (Janela > Saída).
@@ -159,7 +181,9 @@
image::images/jdk8-small.png[role="left", link="images/jdk8.png"]
--
-5. Verifique se os locais padrão do arquivo zip de códigos-fonte da plataforma e da documentação da API são válidos. Clique em Finalizar para fechar a caixa de diálogo Adicionar Plataforma Java.
+
+[start=5]
+. Verifique se os locais padrão do arquivo zip de códigos-fonte da plataforma e da documentação da API são válidos. Clique em Finalizar para fechar a caixa de diálogo Adicionar Plataforma Java.
O JDK 8 é registrado como uma plataforma no IDE.
[.feature]
@@ -167,7 +191,9 @@
image::images/jdk8registered-small.png[role="left", link="images/jdk8registered.png"]
--
-6. Clique em Fechar.
+
+[start=6]
+. Clique em Fechar.
*Para configurar seu projeto, use o JDK 8:*
@@ -179,21 +205,27 @@
image::images/prj-jdk8-small.png[role="left", link="images/prj-jdk8.png"]
--
-3. Selecione a Categoria Código-fonte e defina o Formato de Código-origem/Binário para JDK 8.
+
+[start=3]
+. Selecione a Categoria Código-fonte e defina o Formato de Código-origem/Binário para JDK 8.
[.feature]
--
image::images/prj-source-jdk8-small.png[role="left", link="images/prj-source-jdk8.png"]
--
-4. Especifique o perfil usado como runtime em uma plataforma remota (por exemplo, Compact 2).
+
+[start=4]
+. Especifique o perfil usado como runtime em uma plataforma remota (por exemplo, Compact 2).
[.feature]
--
image::images/prj-jdk8-profile-small.png[role="left", link="images/prj-jdk8-profile.png"]
--
-5. Clique em OK para salvar as alterações.
+
+[start=5]
+. Clique em OK para salvar as alterações.
Seu projeto está definido para reconhecer um determinado runtime em uma plataforma remota.
@@ -214,7 +246,9 @@
image::images/config-runtime-small.png[role="left", link="images/config-runtime.png"]
--
-6. Clique em OK para salvar suas edições.
+
+[start=6]
+. Clique em OK para salvar suas edições.
Se você executar o projeto em uma plataforma remota (Executar > Executar Projeto (nome do projeto)), a saída será semelhante à mostrada na figura a seguir.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ru.asciidoc
index 6e7fbe0..ae44e03 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_ru.asciidoc
@@ -67,10 +67,18 @@
image::images/plugins-small.png[role="left", link="images/plugins.png"]
--
-3. Нажмите кнопку 'Активировать'.
-4. На панели приветствия в диалоговом окне программы установки нажмите кнопку 'Активировать'.
-5. После успешного завершения активации нажмите кнопку 'Готово'.
-6. Нажмите кнопку 'Закрыть', чтобы закрыть диалоговое окно 'Подключаемые модули'.
+
+[start=3]
+. Нажмите кнопку 'Активировать'.
+
+[start=4]
+. На панели приветствия в диалоговом окне программы установки нажмите кнопку 'Активировать'.
+
+[start=5]
+. После успешного завершения активации нажмите кнопку 'Готово'.
+
+[start=6]
+. Нажмите кнопку 'Закрыть', чтобы закрыть диалоговое окно 'Подключаемые модули'.
*Для установки удаленной платформы Java SE в среде NetBeans IDE:*
@@ -82,8 +90,12 @@
image::images/jpmanager-small.png[role="left", link="images/jpmanager.png"]
--
-2. Нажмите 'Добавить платформу'.
-3. В окне 'Выбор типа платформы' мастера платформ Java выберите Remote Java Standard Edition и нажмите кнопку 'Далее'.
+
+[start=2]
+. Нажмите 'Добавить платформу'.
+
+[start=3]
+. В окне 'Выбор типа платформы' мастера платформ Java выберите Remote Java Standard Edition и нажмите кнопку 'Далее'.
IDE отображает диалоговое окно 'Добавить платформу Java'.
[.feature]
@@ -91,11 +103,15 @@
image::images/addjp-small.png[role="left", link="images/addjp.png"]
--
-4. Укажите следующие сведения об удаленной платформе: имя, IP-адрес или DNS-имя устройства, имя пользователя, пароль и путь в JRE на удаленном устройстве.
+
+[start=4]
+. Укажите следующие сведения об удаленной платформе: имя, IP-адрес или DNS-имя устройства, имя пользователя, пароль и путь в JRE на удаленном устройстве.
*Примечание.* Целевая операционная система - UNIX (Windows не поддерживается).
-5. Нажмите кнопку "Завершить". Среда IDE проверяет удаленную среду JRE, выполняя исследование, и загружает свойства удаленной системы JRE.
+
+[start=5]
+. Нажмите кнопку "Завершить". Среда IDE проверяет удаленную среду JRE, выполняя исследование, и загружает свойства удаленной системы JRE.
Новая удаленная платформа Java SE отображается в диалоговом окне 'Диспетчер платформ Java'.
[.feature]
@@ -124,9 +140,13 @@
image::images/wizard-small.png[role="left", link="images/wizard.png"]
--
-4. Нажмите 'Готово'.
+
+[start=4]
+. Нажмите 'Готово'.
IDE создает проект Java SE и открывает его в окне 'Проекты'.
-5. Замените строку ``// TODO code application logic here`` следующим кодом:
+
+[start=5]
+. Замените строку ``// TODO code application logic here`` следующим кодом:
[source,java]
----
@@ -136,7 +156,9 @@
int c = a + b;
System.out.println (c);
----
-6. Сохраните изменения, выбрав "Файл" > "Сохранить".
+
+[start=6]
+. Сохраните изменения, выбрав "Файл" > "Сохранить".
Для тестирования приложения щелкните на проекте правой кнопкой мыши и выберите "Выполнить" в контекстном меню. Рассчитанные выходные данные можно просматривать в диалоговом окне 'Выходные данные' (Окно > Выходные данные).
@@ -159,7 +181,9 @@
image::images/jdk8-small.png[role="left", link="images/jdk8.png"]
--
-5. Проверьте правильность местоположений по умолчанию для zip-архива Platform Sources и документации API. Для закрытия диалога добавления платформы Java нажмите кнопку "Готово".
+
+[start=5]
+. Проверьте правильность местоположений по умолчанию для zip-архива Platform Sources и документации API. Для закрытия диалога добавления платформы Java нажмите кнопку "Готово".
Платформа JDK 8 зарегистрирована в IDE.
[.feature]
@@ -167,7 +191,9 @@
image::images/jdk8registered-small.png[role="left", link="images/jdk8registered.png"]
--
-6. Выберите "Close" (Закрыть).
+
+[start=6]
+. Выберите "Close" (Закрыть).
*Настройка проекта для работы с JDK 8:*
@@ -179,21 +205,27 @@
image::images/prj-jdk8-small.png[role="left", link="images/prj-jdk8.png"]
--
-3. Выберите категорию 'Источники', затем выберите JDK 8 в списке 'Исходный/двоичный формат'.
+
+[start=3]
+. Выберите категорию 'Источники', затем выберите JDK 8 в списке 'Исходный/двоичный формат'.
[.feature]
--
image::images/prj-source-jdk8-small.png[role="left", link="images/prj-source-jdk8.png"]
--
-4. Укажите профиль, который используется в качестве стадии выполнения на удаленной платформе (например, Compact 2).
+
+[start=4]
+. Укажите профиль, который используется в качестве стадии выполнения на удаленной платформе (например, Compact 2).
[.feature]
--
image::images/prj-jdk8-profile-small.png[role="left", link="images/prj-jdk8-profile.png"]
--
-5. Нажмите OK для сохранения изменений.
+
+[start=5]
+. Нажмите OK для сохранения изменений.
Ваш проект настроен на распознавание определенной стадии выполнения на удаленной платформе.
@@ -214,7 +246,9 @@
image::images/config-runtime-small.png[role="left", link="images/config-runtime.png"]
--
-6. Нажмите кнопку "ОК", чтобы сохранить изменения.
+
+[start=6]
+. Нажмите кнопку "ОК", чтобы сохранить изменения.
При запуске проекта на удаленной платформе (Запуск > Запуск проекта (имя проекта)) выходные данные выглядят практически так, как показано на рисунке ниже.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_zh_CN.asciidoc
index b366d41..5426e91 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-embedded_zh_CN.asciidoc
@@ -67,10 +67,18 @@
image::images/plugins-small.png[role="left", link="images/plugins.png"]
--
-3. 单击 "Activate"（激活）。
-4. 在 "Installer"（安装程序）对话框的 "Welcome"（欢迎使用）面板上，单击 "Activate"（激活）。
-5. 在成功完成激活过程后，单击 "Finish"（完成）。
-6. 单击 "Close"（关闭）以关闭 "Plugins"（插件）对话框。
+
+[start=3]
+. 单击 "Activate"（激活）。
+
+[start=4]
+. 在 "Installer"（安装程序）对话框的 "Welcome"（欢迎使用）面板上，单击 "Activate"（激活）。
+
+[start=5]
+. 在成功完成激活过程后，单击 "Finish"（完成）。
+
+[start=6]
+. 单击 "Close"（关闭）以关闭 "Plugins"（插件）对话框。
*要在 NetBeans IDE 中安装远程 Java SE 平台，请执行以下操作：*
@@ -82,8 +90,12 @@
image::images/jpmanager-small.png[role="left", link="images/jpmanager.png"]
--
-2. 单击 "Add Platform"（添加平台）。
-3. 在 "Add Java Platform"（添加 Java 平台）向导的 "Select Platform Type"（选择平台类型）中，选择 "Remote Java Standard Edition"（远程 Java Standard Edition）并单击 "Next"（下一步）。
+
+[start=2]
+. 单击 "Add Platform"（添加平台）。
+
+[start=3]
+. 在 "Add Java Platform"（添加 Java 平台）向导的 "Select Platform Type"（选择平台类型）中，选择 "Remote Java Standard Edition"（远程 Java Standard Edition）并单击 "Next"（下一步）。
IDE 将显示 "Add Java Platform"（添加 Java 平台）对话框。
[.feature]
@@ -91,11 +103,15 @@
image::images/addjp-small.png[role="left", link="images/addjp.png"]
--
-4. 指定远程平台的详细信息，例如，名称、设备的 IP 地址或 DNS 名称、登录名、口令以及远程设备上 JRE 的路径。
+
+[start=4]
+. 指定远程平台的详细信息，例如，名称、设备的 IP 地址或 DNS 名称、登录名、口令以及远程设备上 JRE 的路径。
*注：*目标操作系统必须是 UNIX（不支持 Windows）。
-5. 单击 "Finish"（完成）。IDE 将通过执行探测来验证远程 JRE，并下载远程 JRE 系统属性。
+
+[start=5]
+. 单击 "Finish"（完成）。IDE 将通过执行探测来验证远程 JRE，并下载远程 JRE 系统属性。
"Java Platform Manager"（Java 平台管理器）对话框中将显示新的远程 Java SE 平台。
[.feature]
@@ -124,9 +140,13 @@
image::images/wizard-small.png[role="left", link="images/wizard.png"]
--
-4. 单击 "Finish"（完成）。
+
+[start=4]
+. 单击 "Finish"（完成）。
IDE 将在 "Projects"（项目）窗口中创建并打开 Java SE 项目。
-5. 将 ``// TODO code application logic here`` 一行替换为以下代码：
+
+[start=5]
+. 将 ``// TODO code application logic here`` 一行替换为以下代码：
[source,java]
----
@@ -136,7 +156,9 @@
int c = a + b;
System.out.println (c);
----
-6. 通过选择 "File"（文件）> "Save"（保存）保存您所做的更改。
+
+[start=6]
+. 通过选择 "File"（文件）> "Save"（保存）保存您所做的更改。
要测试应用程序，请右键单击项目名称，然后从上下文菜单中选择 "Run"（运行）。可以在 "Output"（输出）窗口（"Window"（窗口）> "Output"（输出））中查看计算的输出。
@@ -159,7 +181,9 @@
image::images/jdk8-small.png[role="left", link="images/jdk8.png"]
--
-5. 验证平台源 zip 文件和 API 文档的默认位置是否有效。单击 "Finish"（完成）以关闭 "Add Java Platform"（添加 Java 平台）对话框。
+
+[start=5]
+. 验证平台源 zip 文件和 API 文档的默认位置是否有效。单击 "Finish"（完成）以关闭 "Add Java Platform"（添加 Java 平台）对话框。
JDK 8 作为平台注册在 IDE 中。
[.feature]
@@ -167,7 +191,9 @@
image::images/jdk8registered-small.png[role="left", link="images/jdk8registered.png"]
--
-6. 单击 "Close"（关闭）。
+
+[start=6]
+. 单击 "Close"（关闭）。
*要配置项目以使用 JDK 8，请执行以下操作：*
@@ -179,21 +205,27 @@
image::images/prj-jdk8-small.png[role="left", link="images/prj-jdk8.png"]
--
-3. 选择 "Sources"（源）类别，然后将源代码/二进制格式设置为 "JDK 8"。
+
+[start=3]
+. 选择 "Sources"（源）类别，然后将源代码/二进制格式设置为 "JDK 8"。
[.feature]
--
image::images/prj-source-jdk8-small.png[role="left", link="images/prj-source-jdk8.png"]
--
-4. 指定在远程平台上用作运行时的配置文件（例如，简洁 2）。
+
+[start=4]
+. 指定在远程平台上用作运行时的配置文件（例如，简洁 2）。
[.feature]
--
image::images/prj-jdk8-profile-small.png[role="left", link="images/prj-jdk8-profile.png"]
--
-5. 单击“确定”保存更改。
+
+[start=5]
+. 单击“确定”保存更改。
您的项目将设置为在远程平台上识别特定的运行时。
@@ -214,7 +246,9 @@
image::images/config-runtime-small.png[role="left", link="images/config-runtime.png"]
--
-6. 单击 "OK"（确定）保存所做的编辑。
+
+[start=6]
+. 单击 "OK"（确定）保存所做的编辑。
如果在远程平台上运行项目（"Run"（运行）> "Run Project (project name)"（运行项目（项目名称））），则输出将看起来类似于下图中显示的内容。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ja.asciidoc
index 9a7b1ad..0c3551f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ja.asciidoc
@@ -69,8 +69,12 @@
*注意:* ここで指定したパスは、ウィザードの「プロジェクト・フォルダ」フィールドに`` /`_NetBeansProjects_`/MyLib/ ``のように表示されます。
-3. (オプション)「ライブラリの格納用に専用フォルダを使用」チェックボックスを選択し、ライブラリ・フォルダの場所を指定します。このオプションの詳細は、_NetBeans IDEによるアプリケーションの開発_のlink:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+他のユーザーとのライブラリの共有+]を参照してください。
-4. 「終了」をクリックします。「プロジェクト」および「ファイル」ウィンドウの両方にMyLibプロジェクトが表示されます。
+
+[start=3]
+. (オプション)「ライブラリの格納用に専用フォルダを使用」チェックボックスを選択し、ライブラリ・フォルダの場所を指定します。このオプションの詳細は、_NetBeans IDEによるアプリケーションの開発_のlink:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+他のユーザーとのライブラリの共有+]を参照してください。
+
+[start=4]
+. 「終了」をクリックします。「プロジェクト」および「ファイル」ウィンドウの両方にMyLibプロジェクトが表示されます。
=== [[Javaアプリケーション・プロジェクトの作成]]
@@ -93,9 +97,15 @@
image::images/addproj.png[]
-2. `_NetBeansProjects_/`に移動して、`MyLib`プロジェクト・フォルダを選択します。「プロジェクトJARファイル」ペインに、プロジェクトに追加できるJARファイルが表示されます。実際にはまだMyLibのJARファイルをビルドしていませんが、JARファイルが一覧表示されることに注意してください。このJARファイルは、MyAppプロジェクトをビルド、実行したときに作成されます。
-3. 「プロジェクトJARファイルの追加」をクリックします。
-4. 「ライブラリ」ノードを展開します。MyLibプロジェクトのJARファイルがMyAppプロジェクトのクラスパスに追加されます。
+
+[start=2]
+. `_NetBeansProjects_/`に移動して、`MyLib`プロジェクト・フォルダを選択します。「プロジェクトJARファイル」ペインに、プロジェクトに追加できるJARファイルが表示されます。実際にはまだMyLibのJARファイルをビルドしていませんが、JARファイルが一覧表示されることに注意してください。このJARファイルは、MyAppプロジェクトをビルド、実行したときに作成されます。
+
+[start=3]
+. 「プロジェクトJARファイルの追加」をクリックします。
+
+[start=4]
+. 「ライブラリ」ノードを展開します。MyLibプロジェクトのJARファイルがMyAppプロジェクトのクラスパスに追加されます。
== Javaソース・コードの作成と編集
@@ -124,8 +134,12 @@
return b.toString();
}
----
-4. 貼り付けたコードが正しくフォーマットされていない場合は、[Alt]-[Shift]-[F]を押して、ファイル全体を再フォーマットします。
-5. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=4]
+. 貼り付けたコードが正しくフォーマットされていない場合は、[Alt]-[Shift]-[F]を押して、ファイル全体を再フォーマットします。
+
+[start=5]
+. [Ctrl]-[S]を押して、ファイルを保存します。
=== Javaファイルの編集
@@ -144,22 +158,36 @@
カーソルは`Li`の直後に置いたままにします。次の手順で、コード補完を使用して`Li`を`LibClass`に変えます。
-4. [Ctrl]-[Space]を押して、コード補完ボックスを開きます。
+
+[start=4]
+. [Ctrl]-[Space]を押して、コード補完ボックスを開きます。
語の補完方法の候補一覧が表示されます。ただし、必要なクラス`LibClass`が一覧に含まれない可能性があります。
-5. 再び[Ctrl]-[Space]を押すとさらに候補が表示されます。
+
+[start=5]
+. 再び[Ctrl]-[Space]を押すとさらに候補が表示されます。
`LibClass`はこの一覧に含まれるはずです。
-6. 「`LibClass`」を選択し、[Enter]を押します。IDEは残りのクラス名を整理し、自動的にクラスのimport文を作成します。
+
+[start=6]
+. 「`LibClass`」を選択し、[Enter]を押します。IDEは残りのクラス名を整理し、自動的にクラスのimport文を作成します。
*注意:* IDEでは、コード補完ボックスの上に、選択されたクラスまたはパッケージに関するJavadoc情報を表示する別のボックスも表示されます。このパッケージにはJavadoc情報がないため、ボックスにJavadocが見つからないというメッセージが表示されます。
-7. mainメソッドで、`LibClass`の後にピリオド(.)を入力します。再びコード補完ボックスが開きます。
-8. `acrostic(String[]args) `メソッドを選択し、[Enter]を押します。IDEによって`acrostic`メソッドの内容が入力され、`args`パラメータが強調表示されます。
-9. [Enter]を押して、パラメータとして`args`を設定します。
-10. セミコロン(;)を入力します。
+
+[start=7]
+. mainメソッドで、`LibClass`の後にピリオド(.)を入力します。再びコード補完ボックスが開きます。
+
+[start=8]
+. `acrostic(String[]args) `メソッドを選択し、[Enter]を押します。IDEによって`acrostic`メソッドの内容が入力され、`args`パラメータが強調表示されます。
+
+[start=9]
+. [Enter]を押して、パラメータとして`args`を設定します。
+
+[start=10]
+. セミコロン(;)を入力します。
最後の行は次の行のようになるはずです。
@@ -169,7 +197,9 @@
String result = LibClass.acrostic(args);
----
-11. [Enter]を押して、新しい行を開始します。次に`sout`と入力して、[Tab]を押します。省略名`sout`が`System.out.println("");`に展開され、引用符の間にカーソルが表示されます。引用符内に`Result=`、引用符の後に`+result`と入力します。
+
+[start=11]
+. [Enter]を押して、新しい行を開始します。次に`sout`と入力して、[Tab]を押します。省略名`sout`が`System.out.println("");`に展開され、引用符の間にカーソルが表示されます。引用符内に`Result=`、引用符の後に`+result`と入力します。
最後の行は次の行のようになるはずです。
@@ -179,7 +209,9 @@
System.out.println("Result = " + result);
----
-12. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=12]
+. [Ctrl]-[S]を押して、ファイルを保存します。
*注意:* `sout`は、ソース・エディタで使用できる多くのコード・テンプレートの1つです。コード・テンプレートのリストを検索して編集するには、「ツール」>「オプション」>「エディタ」>「コード・テンプレート」を選択します。
@@ -201,7 +233,9 @@
メイン・クラスは、すでに`acrostic.Main`に設定されているはずです。
-2. 「引数」フィールドに`However we all feel zealous`と入力し、「OK」をクリックします。
+
+[start=2]
+. 「引数」フィールドに`However we all feel zealous`と入力し、「OK」をクリックします。
=== アプリケーションの実行
@@ -227,9 +261,15 @@
JUnitテストをIDEで初めて作成する場合は、「JUnitのバージョンを選択」ダイアログ・ボックスが表示されます。[Enter]を押してJUnit 4.xを選択し、「テストを作成」ダイアログ・ボックスに進みます。
-2. 「テストを作成」ダイアログ・ボックスで「OK」をクリックして、デフォルトのオプションでコマンドを実行します。IDEでは、`org.me.mylib`パッケージと`LibClassTest.java`ファイルが、別個の`test`フォルダに作成されます。このファイルを見つけるには、「テスト・パッケージ」ノード、「`org.me.mylib`」サブノードを順に展開します。
-3. `LibClassTest.java`で、`public void testAcrostic()`メソッドの本文を削除します。
-4. 行を削除した部分に次のコードを入力または貼り付けます。
+
+[start=2]
+. 「テストを作成」ダイアログ・ボックスで「OK」をクリックして、デフォルトのオプションでコマンドを実行します。IDEでは、`org.me.mylib`パッケージと`LibClassTest.java`ファイルが、別個の`test`フォルダに作成されます。このファイルを見つけるには、「テスト・パッケージ」ノード、「`org.me.mylib`」サブノードを順に展開します。
+
+[start=3]
+. `LibClassTest.java`で、`public void testAcrostic()`メソッドの本文を削除します。
+
+[start=4]
+. 行を削除した部分に次のコードを入力または貼り付けます。
[source,java]
----
@@ -239,7 +279,9 @@
{"fnord", "polly", "tropism"});
assertEquals("Correct value", "foo", result);
----
-5. [Ctrl]-[S]を押してファイルを保存します。
+
+[start=5]
+. [Ctrl]-[S]を押してファイルを保存します。
=== JUnitテストの実行
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_pt_BR.asciidoc
index 71e2473..2e541bf 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_pt_BR.asciidoc
@@ -69,8 +69,12 @@
*Observação:* o caminho especificado acima deve estar como a seguir no campo Pasta do Projeto do assistente: `` /`_NetBeansProjects_`/MyLib/ ``
-3. (Opcional) Marque a caixa de seleção Utilizar Pasta Dedicada para Armazenamento de Bibliotecas e especifique o local da pasta de bibliotecas. Consulte link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+Compartilhando uma Biblioteca com Outros Usuários+] em _Desenvolvendo Aplicações com o NetBeans IDE_ para obter mais informações sobre essa opção.
-4. Clique em Finalizar. O projeto MyLib será exibido nas janelas Projetos e Arquivos.
+
+[start=3]
+. (Opcional) Marque a caixa de seleção Utilizar Pasta Dedicada para Armazenamento de Bibliotecas e especifique o local da pasta de bibliotecas. Consulte link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+Compartilhando uma Biblioteca com Outros Usuários+] em _Desenvolvendo Aplicações com o NetBeans IDE_ para obter mais informações sobre essa opção.
+
+[start=4]
+. Clique em Finalizar. O projeto MyLib será exibido nas janelas Projetos e Arquivos.
=== [[Criando um Projeto de Aplicação Java]]
@@ -93,9 +97,15 @@
image::images/addproj.png[]
-2. Navegue para `_NetBeansProjects_/` e selecione a pasta de projeto `MyLib`. O painel Arquivos JAR do projeto mostrará os arquivos JAR que podem ser adicionados ao projeto. Observe que um arquivo JAR do MyLib está listado, embora ainda não tenha sido construído. Esse arquivo JAR será contruído quando você construir e executar o projeto MyApp.
-3. Clique em Adicionar Arquivos JAR do Projeto.
-4. Expanda o nó Bibliotecas. O arquivo JAR do projeto MyLib será adicionado ao classpath do projeto MyApp.
+
+[start=2]
+. Navegue para `_NetBeansProjects_/` e selecione a pasta de projeto `MyLib`. O painel Arquivos JAR do projeto mostrará os arquivos JAR que podem ser adicionados ao projeto. Observe que um arquivo JAR do MyLib está listado, embora ainda não tenha sido construído. Esse arquivo JAR será contruído quando você construir e executar o projeto MyApp.
+
+[start=3]
+. Clique em Adicionar Arquivos JAR do Projeto.
+
+[start=4]
+. Expanda o nó Bibliotecas. O arquivo JAR do projeto MyLib será adicionado ao classpath do projeto MyApp.
== Criando e Editando o Código-fonte Java
@@ -124,8 +134,12 @@
return b.toString();
}
----
-4. Se o código colado não estiver formatado corretamente, pressione Alt-Shift-F para reformatar todo o arquivo.
-5. Pressione Ctrl-S para salvar o arquivo.
+
+[start=4]
+. Se o código colado não estiver formatado corretamente, pressione Alt-Shift-F para reformatar todo o arquivo.
+
+[start=5]
+. Pressione Ctrl-S para salvar o arquivo.
=== Editando um Arquivo Java
@@ -144,22 +158,36 @@
Deixe o cursor imediatamente depois de `Li`. Na próxima etapa, você utilizará a funcionalidade autocompletar código para transformar `Li` em `LibClass`.
-4. Pressione Ctrl-Espaço para abrir a caixa para autocompletar código.
+
+[start=4]
+. Pressione Ctrl-Espaço para abrir a caixa para autocompletar código.
Aparece uma lista resumida de formas possíveis para completar a palavra. Contudo, a classe que você deseja, `LibClass`, pode não existir.
-5. Pressione Ctrl-Espaço novamente para exibir uma lista mais longa de possíveis correspondências.
+
+[start=5]
+. Pressione Ctrl-Espaço novamente para exibir uma lista mais longa de possíveis correspondências.
`LibClass` deve estar na lista.
-6. Selecione `LibClass` e pressione Enter. O IDE preencherá o resto do nome da classe, além de criar automaticamente uma instrução de importação para a classe.
+
+[start=6]
+. Selecione `LibClass` e pressione Enter. O IDE preencherá o resto do nome da classe, além de criar automaticamente uma instrução de importação para a classe.
*Observação:* o IDE também abrirá uma caixa acima da caixa para autocompletar código que exibe informações de Javadoc da classe ou do pacote selecionado. Como não há informações Javadoc para esse pacote, a caixa exibe a mensagem "Não é possível localizar o Javadoc".
-7. No método principal, digite um ponto (.) depois de `LibClass`. A caixa para autocompletar código se abrirá novamente.
-8. Selecione o método `acrostic(String[]args)` e pressione Enter. O IDE preenche o método `acróstico` e mostra os realces do parâmetro `args`.
-9. Pressione Enter para aceitar `args` como o parâmetro.
-10. Insira um ponto-e-vírgula (;).
+
+[start=7]
+. No método principal, digite um ponto (.) depois de `LibClass`. A caixa para autocompletar código se abrirá novamente.
+
+[start=8]
+. Selecione o método `acrostic(String[]args)` e pressione Enter. O IDE preenche o método `acróstico` e mostra os realces do parâmetro `args`.
+
+[start=9]
+. Pressione Enter para aceitar `args` como o parâmetro.
+
+[start=10]
+. Insira um ponto-e-vírgula (;).
A linha final deve se parecer com a linha a seguir.
@@ -169,7 +197,9 @@
String result = LibClass.acrostic(args);
----
-11. Pressione Enter para iniciar uma nova linha. Depois, digite `sout` e pressione Tab. A abreviação `sout` se expandirá para `System.out.println("");` com o cursor posicionado entre as aspas. Digite `Result =` dentro das aspas e `+ result` após as aspas finais.
+
+[start=11]
+. Pressione Enter para iniciar uma nova linha. Depois, digite `sout` e pressione Tab. A abreviação `sout` se expandirá para `System.out.println("");` com o cursor posicionado entre as aspas. Digite `Result =` dentro das aspas e `+ result` após as aspas finais.
A linha final deve se parecer com a linha a seguir.
@@ -179,7 +209,9 @@
System.out.println("Result = " + result);
----
-12. Pressione Ctrl-S para salvar o arquivo.
+
+[start=12]
+. Pressione Ctrl-S para salvar o arquivo.
*Observação:* `sout` é um dos vários modelos de código disponíveis no Editor de Código-fonte. Para encontrar e editar a lista de modelos de código, escolha Ferramentas > Opções > Editor > Modelo de Código.
@@ -201,7 +233,9 @@
A classe principal já deve estar definida para `acrostic.Main`.
-2. Digite `However we all feel zealous `no campo Argumentos e clique em OK.
+
+[start=2]
+. Digite `However we all feel zealous `no campo Argumentos e clique em OK.
=== Executando a Aplicação
@@ -227,9 +261,15 @@
Se esta é a primeira vez que criou testes JUnit no IDE, você verá a caixa de diálogo Selecionar Versão de JUnit. Pressione Enter para selecionar JUnit 4.x e prosseguir para a caixa de diálogo Criar Testes.
-2. Na caixa de diálogo Criar Testes, clique em OK para executar o comando com as opções default. O IDE criará o pacote `org.me.mylib` e o arquivo `LibClassTest.java` em uma pasta de `teste` separada. É possível localizar esse arquivo expandindo o nó Testar Pacotes e o subnó `org.me.mylib`.
-3. Em `LibClassTest.java`, delete o corpo do método `public void testAcrostic()`.
-4. No lugar das linhas deletadas, digite ou cole o seguinte:
+
+[start=2]
+. Na caixa de diálogo Criar Testes, clique em OK para executar o comando com as opções default. O IDE criará o pacote `org.me.mylib` e o arquivo `LibClassTest.java` em uma pasta de `teste` separada. É possível localizar esse arquivo expandindo o nó Testar Pacotes e o subnó `org.me.mylib`.
+
+[start=3]
+. Em `LibClassTest.java`, delete o corpo do método `public void testAcrostic()`.
+
+[start=4]
+. No lugar das linhas deletadas, digite ou cole o seguinte:
[source,java]
----
@@ -239,7 +279,9 @@
{"fnord", "polly", "tropism"});
assertEquals("Correct value", "foo", result);
----
-5. Salve o arquivo pressionando Ctrl-S.
+
+[start=5]
+. Salve o arquivo pressionando Ctrl-S.
=== Executando Testes JUnit
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ru.asciidoc
index ed3a953..8189f4c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_ru.asciidoc
@@ -69,8 +69,12 @@
*Примечание.* Путь, указанный выше, должен отображаться как следующий в поле папки проекта мастера: `` /`_NetBeansProjects_`/MyLib/ ``
-3. Установите флажок "Использовать отдельную папку для хранения библиотек" и укажите местоположение папки библиотек (необязательно). Дополнительная информация об этой команде приведена в статье link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+Предоставление доступа к библиотеке другим пользователям+] в документе _Разработка приложений с помощью NetBeans IDE_.
-4. Нажмите кнопку 'Готово'. Проект "MyLib" будет открыт как в окне "Проекты", так и в окне "Файлы".
+
+[start=3]
+. Установите флажок "Использовать отдельную папку для хранения библиотек" и укажите местоположение папки библиотек (необязательно). Дополнительная информация об этой команде приведена в статье link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+Предоставление доступа к библиотеке другим пользователям+] в документе _Разработка приложений с помощью NetBeans IDE_.
+
+[start=4]
+. Нажмите кнопку 'Готово'. Проект "MyLib" будет открыт как в окне "Проекты", так и в окне "Файлы".
=== [[Создание проекта приложения Java]]
@@ -93,9 +97,15 @@
image::images/addproj.png[]
-2. Перейдите к `_NetBeansProjects_/` и выберите папку проекта `MyLib`. На экране "Файлы JAR проекта" отображаются архивы JAR, которые можно добавить к проекту. Учтите, что архив JAR для проекта "MyLib" отображается даже в том случае, если он фактически еще не создан. Этот архив JAR будет создан в процессе сборки и выполнения проекта "MyApp".
-3. Нажмите кнопку "Добавить файлы JAR проекта".
-4. Разверните узел "Библиотеки". Архив JAR проекта "MyLib" добавлен в путь к классам проекта "MyApp".
+
+[start=2]
+. Перейдите к `_NetBeansProjects_/` и выберите папку проекта `MyLib`. На экране "Файлы JAR проекта" отображаются архивы JAR, которые можно добавить к проекту. Учтите, что архив JAR для проекта "MyLib" отображается даже в том случае, если он фактически еще не создан. Этот архив JAR будет создан в процессе сборки и выполнения проекта "MyApp".
+
+[start=3]
+. Нажмите кнопку "Добавить файлы JAR проекта".
+
+[start=4]
+. Разверните узел "Библиотеки". Архив JAR проекта "MyLib" добавлен в путь к классам проекта "MyApp".
== Создание и изменение исходного кода Java
@@ -124,8 +134,12 @@
return b.toString();
}
----
-4. Если вставленный код отформатирован неправильно, нажмите сочетание клавиш ALT+SHIFT+F для переформатирования всего файла.
-5. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=4]
+. Если вставленный код отформатирован неправильно, нажмите сочетание клавиш ALT+SHIFT+F для переформатирования всего файла.
+
+[start=5]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
=== Изменение файла Java
@@ -144,22 +158,36 @@
Установите курсор сразу же после `Li`. Теперь можно воспользоваться функцией автозавершения кода для подстановки `LibClass` вместо `Li`.
-4. Нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова окна автозавершения кода.
+
+[start=4]
+. Нажмите сочетание клавиш CTRL+ПРОБЕЛ для вызова окна автозавершения кода.
Появится небольшой список допустимых подстановок. Однако требуемого класса `LibClass` там может не оказаться.
-5. Для просмотра расширенного списка возможных соответствий еще раз нажмите сочетание клавиш CTRL+ПРОБЕЛ.
+
+[start=5]
+. Для просмотра расширенного списка возможных соответствий еще раз нажмите сочетание клавиш CTRL+ПРОБЕЛ.
Класс `LibClass` должен находиться в этом списке.
-6. Выберите `LibClass` и нажмите ENTER. Оставшаяся часть имени класса будет автоматически подставлена в код средой IDE. Кроме того, для этого класса также автоматически создается оператор импорта.
+
+[start=6]
+. Выберите `LibClass` и нажмите ENTER. Оставшаяся часть имени класса будет автоматически подставлена в код средой IDE. Кроме того, для этого класса также автоматически создается оператор импорта.
*Примечание.* В IDE также открывается поле над полем завершения кода, в котором отображаются данные Javadoc для выбранного класса или пакета. Поскольку для этого пакета документация Javadoc отсутствует, в поле отображается сообщение "Не удалось найти сообщение Javadoc".
-7. В главном методе введите точку (.) после записи `LibClass`. Снова появится поле автозавершения кода.
-8. Выберите метод `acrostic(String[]args)` и нажмите ENTER. После автоматического заполнения метода `acrostic` появится выделенный параметр `args`.
-9. Нажмите ENTER для подтверждения параметра `args`.
-10. Введите точку с запятой (;).
+
+[start=7]
+. В главном методе введите точку (.) после записи `LibClass`. Снова появится поле автозавершения кода.
+
+[start=8]
+. Выберите метод `acrostic(String[]args)` и нажмите ENTER. После автоматического заполнения метода `acrostic` появится выделенный параметр `args`.
+
+[start=9]
+. Нажмите ENTER для подтверждения параметра `args`.
+
+[start=10]
+. Введите точку с запятой (;).
Последняя строка должна выглядеть следующим образом.
@@ -169,7 +197,9 @@
String result = LibClass.acrostic(args);
----
-11. Нажмите ENTER для вставки новой строки. Затем введите `sout` и нажмите клавишу TAB. Сокращение `sout` расширяется до `System.out.println("");`, а курсор устанавливается между кавычками. Введите `Result =` в кавычках и `+ result` после закрывающей кавычки.
+
+[start=11]
+. Нажмите ENTER для вставки новой строки. Затем введите `sout` и нажмите клавишу TAB. Сокращение `sout` расширяется до `System.out.println("");`, а курсор устанавливается между кавычками. Введите `Result =` в кавычках и `+ result` после закрывающей кавычки.
Последняя строка должна выглядеть следующим образом.
@@ -179,7 +209,9 @@
System.out.println("Result = " + result);
----
-12. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=12]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
*Примечание.* `sout` является одним из многих шаблонов кода, доступных в редакторе исходного кода. Чтобы найти и изменить список шаблонов кода, выберите "Средства > Параметры > Редактор > Шаблон кода".
@@ -201,7 +233,9 @@
В качестве главного класса должен быть указан `acrostic.Main`.
-2. Введите `However we all feel zealous ` в поле "Аргументы" и нажмите кнопку "ОК".
+
+[start=2]
+. Введите `However we all feel zealous ` в поле "Аргументы" и нажмите кнопку "ОК".
=== Запуск приложения
@@ -227,9 +261,15 @@
Если тесты JUnit в среде IDE создаются впервые, появится диалоговое окно выбора версии "Выберите версию JUnit". Нажмите ENTER для выбора JUnit 4.x и перейдите (кнопка "Продолжить") к диалоговому окну "Создать тесты".
-2. В диалоговом окне "Создать тесты" нажмите кнопку "ОК" для выполнения команды с параметрами по умолчанию. Средой IDE будет автоматически создан пакет `org.me.mylib` и файл `LibClassTest.java` в отдельной папке `test`. Этот файл можно просмотреть путем развертывания узла "Тесты" и в нем подузла `org.me.mylib`.
-3. В `LibClassTest.java` удалите тело метода `public void testAcrostic()`.
-4. Вместо удаленных строк введите или вставьте следующее:
+
+[start=2]
+. В диалоговом окне "Создать тесты" нажмите кнопку "ОК" для выполнения команды с параметрами по умолчанию. Средой IDE будет автоматически создан пакет `org.me.mylib` и файл `LibClassTest.java` в отдельной папке `test`. Этот файл можно просмотреть путем развертывания узла "Тесты" и в нем подузла `org.me.mylib`.
+
+[start=3]
+. В `LibClassTest.java` удалите тело метода `public void testAcrostic()`.
+
+[start=4]
+. Вместо удаленных строк введите или вставьте следующее:
[source,java]
----
@@ -239,7 +279,9 @@
{"fnord", "polly", "tropism"});
assertEquals("Correct value", "foo", result);
----
-5. Сохраните файл путем нажатия CTRL+S.
+
+[start=5]
+. Сохраните файл путем нажатия CTRL+S.
=== Выполнение тестов JUnit
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_zh_CN.asciidoc
index 662e893..c2e7c0b 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-intro_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-intro_zh_CN.asciidoc
@@ -69,8 +69,12 @@
*注：*上面指定的路径在向导的“项目文件夹”字段中应显示如下：`` /`_NetBeansProjects_`/MyLib/ ``
-3. （可选）选中“使用专用文件夹存储库”复选框，并指定库文件夹的位置。有关此选项的详细信息，请参见_使用 NetBeans IDE 开发应用程序_中的link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+与其他用户共享库+]。
-4. 单击 "Finish"（完成）。将同时在“项目”窗口和“文件”窗口中打开 MyLib 项目。
+
+[start=3]
+. （可选）选中“使用专用文件夹存储库”复选框，并指定库文件夹的位置。有关此选项的详细信息，请参见_使用 NetBeans IDE 开发应用程序_中的link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG455[+与其他用户共享库+]。
+
+[start=4]
+. 单击 "Finish"（完成）。将同时在“项目”窗口和“文件”窗口中打开 MyLib 项目。
=== [[创建 Java 应用程序项目]]
@@ -93,9 +97,15 @@
image::images/addproj.png[]
-2. 浏览到 `_NetBeansProjects_/`，然后选择 `MyLib` 项目文件夹。“项目 JAR 文件”窗格显示了可以添加到项目中的 JAR 文件。请注意，系统将列出 MyLib 的 JAR 文件，即使您尚未实际构建 JAR 文件也是如此。在构建并运行 MyApp 项目时，将构建此 JAR 文件。
-3. 单击“添加项目 JAR 文件”。
-4. 展开“库”节点。MyLib 项目的 JAR 文件将添加到 MyApp 项目的类路径中。
+
+[start=2]
+. 浏览到 `_NetBeansProjects_/`，然后选择 `MyLib` 项目文件夹。“项目 JAR 文件”窗格显示了可以添加到项目中的 JAR 文件。请注意，系统将列出 MyLib 的 JAR 文件，即使您尚未实际构建 JAR 文件也是如此。在构建并运行 MyApp 项目时，将构建此 JAR 文件。
+
+[start=3]
+. 单击“添加项目 JAR 文件”。
+
+[start=4]
+. 展开“库”节点。MyLib 项目的 JAR 文件将添加到 MyApp 项目的类路径中。
== 创建和编辑 Java 源代码
@@ -124,8 +134,12 @@
return b.toString();
}
----
-4. 如果粘贴的代码格式不正确，请按 Alt-Shift-F 组合键重新设置整个文件的格式。
-5. 按 Ctrl-S 组合键保存该文件。
+
+[start=4]
+. 如果粘贴的代码格式不正确，请按 Alt-Shift-F 组合键重新设置整个文件的格式。
+
+[start=5]
+. 按 Ctrl-S 组合键保存该文件。
=== 编辑 Java 文件
@@ -144,22 +158,36 @@
将光标保留在紧随 `Li` 之后的位置。在下一步中，您将使用代码完成功能来将 `Li` 转换为 `LibClass`。
-4. 按 Ctrl-空格键打开代码完成框。
+
+[start=4]
+. 按 Ctrl-空格键打开代码完成框。
将显示一个简短的列表，其中列出了用于完成该词的可能方式。但是，该列表中可能不会列出您所需的类 `LibClass`。
-5. 再次按 Ctrl-空格键以显示较长的可能匹配项列表。
+
+[start=5]
+. 再次按 Ctrl-空格键以显示较长的可能匹配项列表。
此列表中应该包含 `LibClass`。
-6. 选择 `LibClass`，然后按 Enter 键。IDE 将填写该类名的其余部分，并且还将自动为该类创建一个 import 语句。
+
+[start=6]
+. 选择 `LibClass`，然后按 Enter 键。IDE 将填写该类名的其余部分，并且还将自动为该类创建一个 import 语句。
*注：*IDE 还将在代码完成框的上面打开一个框，该框显示选定类或包的 Javadoc 信息。由于此包没有对应的 Javadoc 信息，因此该框将显示“无法找到 Javadoc”消息。
-7. 在主方法中 `LibClass` 后面键入句点 (.)。将再次打开代码完成框。
-8. 选择 `acrostic(String[]args)` 方法，然后按 Enter 键。IDE 将填写 `acrostic` 方法并突出显示 `args` 参数。
-9. 按 Enter 键以接受 `args` 参数。
-10. 键入分号 (;)。
+
+[start=7]
+. 在主方法中 `LibClass` 后面键入句点 (.)。将再次打开代码完成框。
+
+[start=8]
+. 选择 `acrostic(String[]args)` 方法，然后按 Enter 键。IDE 将填写 `acrostic` 方法并突出显示 `args` 参数。
+
+[start=9]
+. 按 Enter 键以接受 `args` 参数。
+
+[start=10]
+. 键入分号 (;)。
最后一行应与以下行类似。
@@ -169,7 +197,9 @@
String result = LibClass.acrostic(args);
----
-11. 按 Enter 键以开始一个新行。然后，键入 `sout` 并按 Tab 键。`sout` 缩写将扩展为 `System.out.println("");`，且光标置于引号之间。在引号内键入 `Result =`，并在右引号后面键入 `+ result`。
+
+[start=11]
+. 按 Enter 键以开始一个新行。然后，键入 `sout` 并按 Tab 键。`sout` 缩写将扩展为 `System.out.println("");`，且光标置于引号之间。在引号内键入 `Result =`，并在右引号后面键入 `+ result`。
最后一行应与以下行类似。
@@ -179,7 +209,9 @@
System.out.println("Result = " + result);
----
-12. 按 Ctrl-S 组合键保存该文件。
+
+[start=12]
+. 按 Ctrl-S 组合键保存该文件。
*注：*`sout` 是源代码编辑器中许多可用的代码模板之一。要查找和编辑代码模板的列表，请选择“工具”>“选项”>“编辑器”>“代码模板”。
@@ -201,7 +233,9 @@
主类应该已设置为 `acrostic.Main`。
-2. 在“参数”字段中键入 `However we all feel zealous`，然后单击“确定”。
+
+[start=2]
+. 在“参数”字段中键入 `However we all feel zealous`，然后单击“确定”。
=== 运行应用程序
@@ -227,9 +261,15 @@
如果这是您首次在 IDE 中创建 JUnit 测试，则系统会显示“选择 JUnit 版本”对话框提示。按 Enter 键以选择 "JUnit 4.x"，然后继续执行“创建测试”对话框中的操作。
-2. 在“创建测试”对话框中，单击“确定”以使用默认选项运行命令。IDE 在单独的 `test` 文件夹中创建 `org.me.mylib` 包和 `LibClassTest.java` 文件。通过展开“测试包”节点和 `org.me.mylib` 子节点，可以找到此文件。
-3. 在 `LibClassTest.java` 中，删除 `public void testAcrostic()` 方法的主体。
-4. 键入或粘贴以下代码，以代替删除的行：
+
+[start=2]
+. 在“创建测试”对话框中，单击“确定”以使用默认选项运行命令。IDE 在单独的 `test` 文件夹中创建 `org.me.mylib` 包和 `LibClassTest.java` 文件。通过展开“测试包”节点和 `org.me.mylib` 子节点，可以找到此文件。
+
+[start=3]
+. 在 `LibClassTest.java` 中，删除 `public void testAcrostic()` 方法的主体。
+
+[start=4]
+. 键入或粘贴以下代码，以代替删除的行：
[source,java]
----
@@ -239,7 +279,9 @@
{"fnord", "polly", "tropism"});
assertEquals("Correct value", "foo", result);
----
-5. 通过按 Ctrl-S 组合键保存该文件。
+
+[start=5]
+. 通过按 Ctrl-S 组合键保存该文件。
=== 运行 JUnit 测试
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7.asciidoc
index 7e2eaaf..309e56c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7.asciidoc
@@ -60,7 +60,9 @@
image::images/platform-small.png[role="left", link="images/platform.png"]
--
-3. Click Close.
+
+[start=3]
+. Click Close.
== Checking the Project Configuration
@@ -78,14 +80,18 @@
image::images/props-libs-small.png[role="left", link="images/props-libs.png"]
--
-6. Switch to the Sources tab of the Project Properties window and ensure JDK 7 is chosen as the Source/Binary Format.
+
+[start=6]
+. Switch to the Sources tab of the Project Properties window and ensure JDK 7 is chosen as the Source/Binary Format.
[.feature]
--
image::images/props-sources-small.png[role="left", link="images/props-sources.png"]
--
-7. Click OK to close the Project Properties dialog box. Your project is configured to recognize Java 7 language features.
+
+[start=7]
+. Click OK to close the Project Properties dialog box. Your project is configured to recognize Java 7 language features.
== Using New JDK 7 Language Constructs: Switch Statement
@@ -123,12 +129,16 @@
If the pasted code is formatted incorrectly in the editor, press Alt-Shift-F to reformat.
-2. In the Projects window, right-click the project's node and choose Run File. You will see the output of the application, which is the RGB code for the red color.
+
+[start=2]
+. In the Projects window, right-click the project's node and choose Run File. You will see the output of the application, which is the RGB code for the red color.
You can see that the build is successful and the application works when the target platform and source format is JDK 7.
image::images/output.png[]
-3. Let's rollback to using JDK 6 and test how the application is complied with the JDK 6 compiler.
+
+[start=3]
+. Let's rollback to using JDK 6 and test how the application is complied with the JDK 6 compiler.
In the Projects window, right-click the project's node and choose Properties. In the Sources category, set the Source/Binary Format to ``JDK 6`` and click OK.
You can immediately see that the JDK6 parser does not recognize the syntax. The compilation fails because of the incompatible variable type.
@@ -137,7 +147,9 @@
image::images/error-small.png[role="left", link="images/error.png"]
--
-4. Now, let's rewrite the code using the ``if-then-else`` statement instead of ``switch`` as follows:
+
+[start=4]
+. Now, let's rewrite the code using the ``if-then-else`` statement instead of ``switch`` as follows:
[source,java]
----
@@ -238,8 +250,12 @@
}
----
-2. Note that the IDE displays several hints, as shown above in this tutorial, of how you can optimize your code for the JDK 7 spec. Simply click on each hint and select the suggested action.
-3. Finally, after you accept all the suggestions, you should have the JDK 7 compatible code shown below.
+
+[start=2]
+. Note that the IDE displays several hints, as shown above in this tutorial, of how you can optimize your code for the JDK 7 spec. Simply click on each hint and select the suggested action.
+
+[start=3]
+. Finally, after you accept all the suggestions, you should have the JDK 7 compatible code shown below.
[.feature]
--
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ja.asciidoc
index 4013d3f..0a28956 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ja.asciidoc
@@ -60,7 +60,9 @@
image::images/platform-small.png[role="left", link="images/platform.png"]
--
-3. 「閉じる」をクリックします。
+
+[start=3]
+. 「閉じる」をクリックします。
== プロジェクト構成の確認
@@ -78,14 +80,18 @@
image::images/props-libs-small.png[role="left", link="images/props-libs.png"]
--
-6. 「プロジェクト・プロパティ」ウィンドウの「ソース」タブに切り替え、「ソース/バイナリ形式」として「JDK 7」が選択されていることを確認します。
+
+[start=6]
+. 「プロジェクト・プロパティ」ウィンドウの「ソース」タブに切り替え、「ソース/バイナリ形式」として「JDK 7」が選択されていることを確認します。
[.feature]
--
image::images/props-sources-small.png[role="left", link="images/props-sources.png"]
--
-7. 「OK」をクリックして、「プロジェクト・プロパティ」ダイアログ・ボックスを閉じます。プロジェクトが、Java 7言語機能を認識するように構成されています。
+
+[start=7]
+. 「OK」をクリックして、「プロジェクト・プロパティ」ダイアログ・ボックスを閉じます。プロジェクトが、Java 7言語機能を認識するように構成されています。
== 新しいJDK 7言語構造の使用: switch文
@@ -123,12 +129,16 @@
貼り付けたコードがエディタで誤ってフォーマットされている場合は、[Alt]-[Shift]-[F]を押して再フォーマットします。
-2. 「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「ファイルの実行」を選択します。アプリケーションの出力(赤色のRGBコード)が表示されます。
+
+[start=2]
+. 「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「ファイルの実行」を選択します。アプリケーションの出力(赤色のRGBコード)が表示されます。
ターゲット・プラットフォームとソース形式がJDK 7である場合は、ビルドが成功し、アプリケーションが正常に動作することがわかります。
image::images/output.png[]
-3. 前に戻ってJDK 6を使用し、このアプリケーションがJDK 6コンパイラでどのようにコンパイルされるかをテストしてみます。
+
+[start=3]
+. 前に戻ってJDK 6を使用し、このアプリケーションがJDK 6コンパイラでどのようにコンパイルされるかをテストしてみます。
「プロジェクト」ウィンドウでプロジェクトのノードを右クリックし、「プロパティ」を選択します。「ソース」カテゴリで、「ソース/バイナリ形式」を ``JDK 6`` に設定して「OK」をクリックします。
JDK6パーサーでこの構文が認識されないことがただちにわかります。互換性のない変数型のためにコンパイルが失敗します。
@@ -137,7 +147,9 @@
image::images/error-small.png[role="left", link="images/error.png"]
--
-4. ここで、次のように、 ``switch`` のかわりに ``if-then-else`` 文を使用してコードを書き換えてみます。
+
+[start=4]
+. ここで、次のように、 ``switch`` のかわりに ``if-then-else`` 文を使用してコードを書き換えてみます。
[source,java]
----
@@ -238,8 +250,12 @@
}
----
-2. このチュートリアルの上に示すように、コードをJDK 7仕様向けに最適化する方法を示す複数のヒントがIDEに表示されます。単純に各ヒントをクリックし、提案されたアクションを選択します。
-3. 最終的に、すべての提案を受け入れると、次に示すJDK 7と互換性のあるコードが得られるはずです。
+
+[start=2]
+. このチュートリアルの上に示すように、コードをJDK 7仕様向けに最適化する方法を示す複数のヒントがIDEに表示されます。単純に各ヒントをクリックし、提案されたアクションを選択します。
+
+[start=3]
+. 最終的に、すべての提案を受け入れると、次に示すJDK 7と互換性のあるコードが得られるはずです。
[.feature]
--
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_pt_BR.asciidoc
index 0e87ed7..1567f39 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_pt_BR.asciidoc
@@ -60,7 +60,9 @@
image::images/platform-small.png[role="left", link="images/platform.png"]
--
-3. Clique em Fechar.
+
+[start=3]
+. Clique em Fechar.
== Verificando a Configuração do Projeto
@@ -78,14 +80,18 @@
image::images/props-libs-small.png[role="left", link="images/props-libs.png"]
--
-6. Alterne para a guia Códigos-fonte da janela Propriedades do Projeto e certifique-se de que JDK 7 tenha sido escolhido como o formato do Código-fonte/Binário.
+
+[start=6]
+. Alterne para a guia Códigos-fonte da janela Propriedades do Projeto e certifique-se de que JDK 7 tenha sido escolhido como o formato do Código-fonte/Binário.
[.feature]
--
image::images/props-sources-small.png[role="left", link="images/props-sources.png"]
--
-7. Clique em OK para fechar a caixa de diálogo Propriedades do Projeto. Seu projeto está configurado para reconhecer os recursos do idioma do Java 7.
+
+[start=7]
+. Clique em OK para fechar a caixa de diálogo Propriedades do Projeto. Seu projeto está configurado para reconhecer os recursos do idioma do Java 7.
== Usando Novos Construtores de Linguagem do JDK 7: Instrução de Alternância
@@ -123,12 +129,16 @@
Se o código colado for incorretamente colado no editor, pressione Alt-Shift-F para reformatar.
-2. Na janela Projetos, clique com o botão direito do mouse no nó do projeto e selecione Executar Arquivo. Você verá a saída da aplicação, que é o código RGB para a cor vermelha.
+
+[start=2]
+. Na janela Projetos, clique com o botão direito do mouse no nó do projeto e selecione Executar Arquivo. Você verá a saída da aplicação, que é o código RGB para a cor vermelha.
Você pode ver que a construção foi bem-sucedida e que a aplicação funciona quando a plataforma de destino e o formato do código-fonte são JDK 7.
image::images/output.png[]
-3. Vamos reverter para o uso do JDK 6 e testar como a aplicação é compilada com o compilador do JDK 6.
+
+[start=3]
+. Vamos reverter para o uso do JDK 6 e testar como a aplicação é compilada com o compilador do JDK 6.
Na janela Projetos, clique com o botão direito do mouse no nó do projeto e selecione Propriedades. Na categoria Códigos-fontes, defina o Formato Código-fonte/Binário para ``JDK 6`` e clique em OK.
Você pode ver imediatamente que o parser do JDK6 não reconhece a sintaxe. A compilação falha por causa do tipo de variável incompatível.
@@ -137,7 +147,9 @@
image::images/error-small.png[role="left", link="images/error.png"]
--
-4. Agora, vamos reescrever o código usando a instrução ``if-then-else`` , em vez de ``switch`` , como segue:
+
+[start=4]
+. Agora, vamos reescrever o código usando a instrução ``if-then-else`` , em vez de ``switch`` , como segue:
[source,java]
----
@@ -238,8 +250,12 @@
}
----
-2. Observe que o IDE exibe diversas dicas, como mostrado acima neste tutorial, de como é possível otimizar seu código para a especificação JDK 7. Basta clicar em cada dica e selecionar a ação sugerida.
-3. Finalmente, depois de aceitar todas as sugestões, você deverá ter o código compatível com JDK 7 mostrado abaixo.
+
+[start=2]
+. Observe que o IDE exibe diversas dicas, como mostrado acima neste tutorial, de como é possível otimizar seu código para a especificação JDK 7. Basta clicar em cada dica e selecionar a ação sugerida.
+
+[start=3]
+. Finalmente, depois de aceitar todas as sugestões, você deverá ter o código compatível com JDK 7 mostrado abaixo.
[.feature]
--
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ru.asciidoc
index 5cd6ce4..08be185 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_ru.asciidoc
@@ -60,7 +60,9 @@
image::images/platform-small.png[role="left", link="images/platform.png"]
--
-3. Выберите "Close" (Закрыть).
+
+[start=3]
+. Выберите "Close" (Закрыть).
== Проверка конфигурации проекта
@@ -78,14 +80,18 @@
image::images/props-libs-small.png[role="left", link="images/props-libs.png"]
--
-6. В окне 'Свойства проекта' перейдите на вкладку 'Исходный код'. В списке 'Исходный/двоичный формат' должна быть выбрана версия JDK 7.
+
+[start=6]
+. В окне 'Свойства проекта' перейдите на вкладку 'Исходный код'. В списке 'Исходный/двоичный формат' должна быть выбрана версия JDK 7.
[.feature]
--
image::images/props-sources-small.png[role="left", link="images/props-sources.png"]
--
-7. Нажмите кнопку "ОК" для закрытия диалогового окна "Свойства проекта". Ваш проект настроен для работы с компонентами языка Java 7.
+
+[start=7]
+. Нажмите кнопку "ОК" для закрытия диалогового окна "Свойства проекта". Ваш проект настроен для работы с компонентами языка Java 7.
== Использование новых языковых конструкций JDK 7: оператор переключения
@@ -123,12 +129,16 @@
Если вставленный код некорректно форматируется в редакторе, нажмите сочетание клавиш ALT+SHIFT+F для выполнения повторного форматирования.
-2. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта и выберите 'Запустить файл'. На экране отобразится вывод приложения, который представляет собой код RGB для красного цвета.
+
+[start=2]
+. В окне 'Проекты' щелкните правой кнопкой мыши узел проекта и выберите 'Запустить файл'. На экране отобразится вывод приложения, который представляет собой код RGB для красного цвета.
Таким образом, сборка выполнена успешно, а приложение успешно работает при указании целевой платформы и исходного формата JDK 7.
image::images/output.png[]
-3. Вернемся к JDK 6 и проверим компилирование приложения с помощью компилятора JDK 6.
+
+[start=3]
+. Вернемся к JDK 6 и проверим компилирование приложения с помощью компилятора JDK 6.
В окне 'Проекты' щелкните правой кнопкой мыши узел проекта и выберите 'Свойства'. В категории 'Источники' в списке 'Исходный/двоичный формат' выберите ``JDK 6`` и нажмите ОК.
Сразу видно, что синтаксический анализатор JDK6 не распознает синтаксис. Компиляция завершается с ошибкой из-за несовместимого типа переменной.
@@ -137,7 +147,9 @@
image::images/error-small.png[role="left", link="images/error.png"]
--
-4. Теперь перепишите код, используя оператор ``if-then-else`` вместо оператора ``switch`` :
+
+[start=4]
+. Теперь перепишите код, используя оператор ``if-then-else`` вместо оператора ``switch`` :
[source,java]
----
@@ -238,8 +250,12 @@
}
----
-2. Обратите внимание, что в среде IDE отображаются подсказки по оптимизации кода в соответствии со спецификациями JDK 7. Щелкните подсказки и выберите предложенные действия.
-3. По принятии всех предложений будет создан код, совместимый с JDK 7. Этот код будет выглядеть так же, как код, показанный ниже.
+
+[start=2]
+. Обратите внимание, что в среде IDE отображаются подсказки по оптимизации кода в соответствии со спецификациями JDK 7. Щелкните подсказки и выберите предложенные действия.
+
+[start=3]
+. По принятии всех предложений будет создан код, совместимый с JDK 7. Этот код будет выглядеть так же, как код, показанный ниже.
[.feature]
--
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_zh_CN.asciidoc
index e63ac56..290a239 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk7_zh_CN.asciidoc
@@ -60,7 +60,9 @@
image::images/platform-small.png[role="left", link="images/platform.png"]
--
-3. 单击 "Close"（关闭）。
+
+[start=3]
+. 单击 "Close"（关闭）。
== 检查项目配置
@@ -78,14 +80,18 @@
image::images/props-libs-small.png[role="left", link="images/props-libs.png"]
--
-6. 切换到 "Project Properties"（项目属性）窗口的 "Sources"（源）标签，并确保选择 "JDK 7" 作为源代码/二进制格式。
+
+[start=6]
+. 切换到 "Project Properties"（项目属性）窗口的 "Sources"（源）标签，并确保选择 "JDK 7" 作为源代码/二进制格式。
[.feature]
--
image::images/props-sources-small.png[role="left", link="images/props-sources.png"]
--
-7. 单击“确定”。关闭“项目属性”对话框。您的项目配置为识别 Java 7 语言功能。
+
+[start=7]
+. 单击“确定”。关闭“项目属性”对话框。您的项目配置为识别 Java 7 语言功能。
== 使用新的 JDK 7 语言结构：Switch 语句
@@ -123,12 +129,16 @@
如果在编辑器中错误地设置了粘贴的代码格式，请按 Alt-Shift-F 组合键以重新设置格式。
-2. 在 "Projects"（项目）窗口中，右键单击该项目节点并选择 "Run File"（运行文件）。此时将会看到应用程序输出，这是红色的 RGB 代码。
+
+[start=2]
+. 在 "Projects"（项目）窗口中，右键单击该项目节点并选择 "Run File"（运行文件）。此时将会看到应用程序输出，这是红色的 RGB 代码。
如果目标平台和源格式为 JDK 7，您可以看到构建成功，并且应用程序正常工作。
image::images/output.png[]
-3. 让我们改用以前的 JDK 6，并测试如何使用 JDK 6 编译器编译应用程序。
+
+[start=3]
+. 让我们改用以前的 JDK 6，并测试如何使用 JDK 6 编译器编译应用程序。
在 "Projects"（项目）窗口中，右键单击该项目节点并选择 "Properties"（属性）。在 "Sources"（源）类别中，将源代码/二进制格式设置为 ``JDK 6`` ，然后单击 "OK"（确定）。
您可以立即看到 JDK6 解析器无法识别语法。编译将失败，因为变量类型不兼容。
@@ -137,7 +147,9 @@
image::images/error-small.png[role="left", link="images/error.png"]
--
-4. 现在，让我们使用 ``if-then-else`` 语句而非 ``switch`` 重新编写代码，如下所示：
+
+[start=4]
+. 现在，让我们使用 ``if-then-else`` 语句而非 ``switch`` 重新编写代码，如下所示：
[source,java]
----
@@ -238,8 +250,12 @@
}
----
-2. 请注意，IDE 将显示一些说明如何优化代码以符合 JDK 7 规范的提示，如本教程中上面所述。只需单击每个提示并选择建议的操作即可。
-3. 最后，接受了所有建议后，您就应该具有与 JDK 7 兼容的代码，如下所示。
+
+[start=2]
+. 请注意，IDE 将显示一些说明如何优化代码以符合 JDK 7 规范的提示，如本教程中上面所述。只需单击每个提示并选择建议的操作即可。
+
+[start=3]
+. 最后，接受了所有建议后，您就应该具有与 JDK 7 兼容的代码，如下所示。
[.feature]
--
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8.asciidoc
index 38a5df0..9f00fa5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8.asciidoc
@@ -64,7 +64,9 @@
image::images/jdk8_small.png[role="left", link="images/jdk8.png"]
--
-5. Verify that the default locations of the Platform Sources zip file and API documentation are valid. Click Finish to close the Add Java Platform dialog box.
+
+[start=5]
+. Verify that the default locations of the Platform Sources zip file and API documentation are valid. Click Finish to close the Add Java Platform dialog box.
JDK 8 is registered as a platform in the IDE.
[.feature]
@@ -72,7 +74,9 @@
image::images/jdk8registered_small.png[role="left", link="images/jdk8registered.png"]
--
-6. Ensure JDK 1.8 is chosen in the Platforms list and click Close.
+
+[start=6]
+. Ensure JDK 1.8 is chosen in the Platforms list and click Close.
== Configuring a Project to use JDK 8
@@ -98,14 +102,18 @@
image::images/prj_jdk8_small.png[role="left", link="images/prj_jdk8.png"]
--
-3. Select the Sources category and set Source/Binary Format to JDK 8.
+
+[start=3]
+. Select the Sources category and set Source/Binary Format to JDK 8.
[.feature]
--
image::images/prj_source_jdk8_small.png[role="left", link="images/prj_source_jdk8.png"]
--
-4. Click OK to save the changes.
+
+[start=4]
+. Click OK to save the changes.
Your project is set to recognize new JDK 8 language features.
@@ -182,7 +190,9 @@
image::images/prj_src_profile_small.png[role="left", link="images/prj_src_profile.png"]
--
-4. Click OK.
+
+[start=4]
+. Click OK.
To see how the IDE checks whether classes used in your project belong to the specified profile, select Compact1 as a profile for the AnagramGame project and click OK.
The IDE displays errors to notify that the AnagramGame project is not compliant with the _compact1_ profile.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ja.asciidoc
index 0dc1a71..c4586a7 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ja.asciidoc
@@ -64,7 +64,9 @@
image::images/jdk8_small.png[role="left", link="images/jdk8.png"]
--
-5. 「プラットフォームのソース」のzipファイルとAPIドキュメントのデフォルトの場所が有効であることを確認します。「終了」をクリックして「Javaプラットフォームの追加」ダイアログ・ボックスを閉じます。
+
+[start=5]
+. 「プラットフォームのソース」のzipファイルとAPIドキュメントのデフォルトの場所が有効であることを確認します。「終了」をクリックして「Javaプラットフォームの追加」ダイアログ・ボックスを閉じます。
JDK 8がIDEでプラットフォームとして登録されます。
[.feature]
@@ -72,7 +74,9 @@
image::images/jdk8registered_small.png[role="left", link="images/jdk8registered.png"]
--
-6. 「プラットフォーム」リストで「JDK 1.8」が選択されていることを確認し、「閉じる」をクリックします。
+
+[start=6]
+. 「プラットフォーム」リストで「JDK 1.8」が選択されていることを確認し、「閉じる」をクリックします。
== JDK 8を使用するためのプロジェクトの構成
@@ -98,14 +102,18 @@
image::images/prj_jdk8_small.png[role="left", link="images/prj_jdk8.png"]
--
-3. 「ソース」カテゴリを選択して、「ソース/バイナリ形式」をJDK 8に設定します。
+
+[start=3]
+. 「ソース」カテゴリを選択して、「ソース/バイナリ形式」をJDK 8に設定します。
[.feature]
--
image::images/prj_source_jdk8_small.png[role="left", link="images/prj_source_jdk8.png"]
--
-4. 「OK」をクリックして変更を保存します。
+
+[start=4]
+. 「OK」をクリックして変更を保存します。
プロジェクトが、新しいJDK 8言語機能を認識するように設定されています。
@@ -182,7 +190,9 @@
image::images/prj_src_profile_small.png[role="left", link="images/prj_src_profile.png"]
--
-4. 「OK」をクリックします。
+
+[start=4]
+. 「OK」をクリックします。
プロジェクトで使用されるクラスが指定されたプロファイルに属すかどうかを、IDEでどのように確認するか参照するには、「Compact1」をAnagramGameプロジェクトのプロファイルとして選択して、「OK」をクリックします。
IDEには、AnagramGameプロジェクトが_compact1_プロファイルと互換性がないことを通知するエラーが表示されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_pt_BR.asciidoc
index 5b0d340..049f691 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_pt_BR.asciidoc
@@ -64,7 +64,9 @@
image::images/jdk8_small.png[role="left", link="images/jdk8.png"]
--
-5. Verifique se os locais default do arquivo zip Códigos-fonte da Plataforma e da documentação da API são válidos. Clique em Finalizar para fechar a caixa de diálogo Adicionar Plataforma Java.
+
+[start=5]
+. Verifique se os locais default do arquivo zip Códigos-fonte da Plataforma e da documentação da API são válidos. Clique em Finalizar para fechar a caixa de diálogo Adicionar Plataforma Java.
O JDK 8 é registrado como uma plataforma no IDE.
[.feature]
@@ -72,7 +74,9 @@
image::images/jdk8registered_small.png[role="left", link="images/jdk8registered.png"]
--
-6. Assegure-se de que o JDK 1.8 esteja selecionado na lista Plataformas e clique em Fechar.
+
+[start=6]
+. Assegure-se de que o JDK 1.8 esteja selecionado na lista Plataformas e clique em Fechar.
== Configurando um Projeto para usar JDK 8
@@ -98,14 +102,18 @@
image::images/prj_jdk8_small.png[role="left", link="images/prj_jdk8.png"]
--
-3. Selecione a Categoria Código-fonte e defina o Formato de Código-origem/Binário para JDK 8.
+
+[start=3]
+. Selecione a Categoria Código-fonte e defina o Formato de Código-origem/Binário para JDK 8.
[.feature]
--
image::images/prj_source_jdk8_small.png[role="left", link="images/prj_source_jdk8.png"]
--
-4. Clique em OK para salvar as alterações.
+
+[start=4]
+. Clique em OK para salvar as alterações.
Seu projeto está definido para reconhecer as novas funcionalidades de linguagem do JDK 8.
@@ -182,7 +190,9 @@
image::images/prj_src_profile_small.png[role="left", link="images/prj_src_profile.png"]
--
-4. Clique em OK.
+
+[start=4]
+. Clique em OK.
Para verificar como o IDE verifica se as classes usadas em seu projeto pertencem ao perfil especificado, selecione Compact1 como perfil para o projeto Jogo de Anagramas e clique em OK.
O IDE exibe os erros para notificar que o projeto Jogo de Anagramas não é compatível com o projeto _compact1_.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ru.asciidoc
index 05732d9..635667c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_ru.asciidoc
@@ -64,7 +64,9 @@
image::images/jdk8_small.png[role="left", link="images/jdk8.png"]
--
-5. Проверьте правильность местоположений по умолчанию для zip-архива Platform Sources и документации API. Для закрытия диалога добавления платформы Java нажмите кнопку "Готово".
+
+[start=5]
+. Проверьте правильность местоположений по умолчанию для zip-архива Platform Sources и документации API. Для закрытия диалога добавления платформы Java нажмите кнопку "Готово".
Платформа JDK 8 зарегистрирована в IDE.
[.feature]
@@ -72,7 +74,9 @@
image::images/jdk8registered_small.png[role="left", link="images/jdk8registered.png"]
--
-6. Убедитесь в том, что в списке "Платформы" выбран пункт "JDK 1.8", и нажмите кнопку "Закрыть".
+
+[start=6]
+. Убедитесь в том, что в списке "Платформы" выбран пункт "JDK 1.8", и нажмите кнопку "Закрыть".
== Настройка проекта для работы с JDK 8
@@ -98,14 +102,18 @@
image::images/prj_jdk8_small.png[role="left", link="images/prj_jdk8.png"]
--
-3. Выберите категорию 'Источники', затем выберите JDK 8 в списке 'Исходный/двоичный формат'.
+
+[start=3]
+. Выберите категорию 'Источники', затем выберите JDK 8 в списке 'Исходный/двоичный формат'.
[.feature]
--
image::images/prj_source_jdk8_small.png[role="left", link="images/prj_source_jdk8.png"]
--
-4. Нажмите OK для сохранения изменений.
+
+[start=4]
+. Нажмите OK для сохранения изменений.
Теперь проект настроен на распознавание новых функций языка JDK 8.
@@ -182,7 +190,9 @@
image::images/prj_src_profile_small.png[role="left", link="images/prj_src_profile.png"]
--
-4. Нажмите ОК.
+
+[start=4]
+. Нажмите ОК.
IDE проверяет, принадлежат ли классы, используемые в проекте, определенному профилю. Чтобы рассмотреть это на примере, выберите Compact1 в качестве профиля проекта AnagramGame и нажмите ОК.
В IDE отображаются сообщения об ошибках, указывающие на то, что проект AnagramGame несовместим с профилем _compact1_.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_zh_CN.asciidoc
index c0884d3..ee7e87b 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/javase-jdk8_zh_CN.asciidoc
@@ -64,7 +64,9 @@
image::images/jdk8_small.png[role="left", link="images/jdk8.png"]
--
-5. 验证平台源 zip 文件和 API 文档的默认位置是否有效。单击 "Finish"（完成）以关闭 "Add Java Platform"（添加 Java 平台）对话框。
+
+[start=5]
+. 验证平台源 zip 文件和 API 文档的默认位置是否有效。单击 "Finish"（完成）以关闭 "Add Java Platform"（添加 Java 平台）对话框。
JDK 8 作为平台注册在 IDE 中。
[.feature]
@@ -72,7 +74,9 @@
image::images/jdk8registered_small.png[role="left", link="images/jdk8registered.png"]
--
-6. 确保在 "Platforms"（平台）列表中选择了 JDK 1.8，然后单击 "Close"（关闭）。
+
+[start=6]
+. 确保在 "Platforms"（平台）列表中选择了 JDK 1.8，然后单击 "Close"（关闭）。
== 配置项目以使用 JDK 8
@@ -98,14 +102,18 @@
image::images/prj_jdk8_small.png[role="left", link="images/prj_jdk8.png"]
--
-3. 选择 "Sources"（源）类别，然后将源代码/二进制格式设置为 "JDK 8"。
+
+[start=3]
+. 选择 "Sources"（源）类别，然后将源代码/二进制格式设置为 "JDK 8"。
[.feature]
--
image::images/prj_source_jdk8_small.png[role="left", link="images/prj_source_jdk8.png"]
--
-4. 单击“确定”保存更改。
+
+[start=4]
+. 单击“确定”保存更改。
此时将设置项目以识别新的 JDK 8 语言功能。
@@ -182,7 +190,9 @@
image::images/prj_src_profile_small.png[role="left", link="images/prj_src_profile.png"]
--
-4. 单击 "OK"（确定）。
+
+[start=4]
+. 单击 "OK"（确定）。
要了解 IDE 如何检查项目中使用的类是否属于指定的配置文件，请选择 "Compact1" 作为 AnagramGame 项目的配置文件，然后单击 "OK"（确定）。
IDE 将显示错误，以通知 AnagramGame 项目不符合 _compact1_ 配置文件。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart.asciidoc
index 167203c..1bb23ec 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart.asciidoc
@@ -51,7 +51,7 @@
* Tutorials accessible from the link:../../index.html[+netbeans.org+] site.
-=== Prerequisites
+== Prerequisites
This tutorial assumes you have some basic knowledge of, or programming experience with, the following technologies.
@@ -62,7 +62,7 @@
You will also benefit from having some knowledge on link:http://download.oracle.com/javase/6/docs/technotes/guides/management/index.html[+ Monitoring and Management for the Java Platform+]
-=== Software Needed for the Tutorial
+== Software Needed for the Tutorial
For this tutorial you need to have the following software installed on your computer:
@@ -150,11 +150,15 @@
2. In Samples, select the JMX category.
3. Select the Anagram Game Managed with JMX project.
image::images/jmx-newproject.png[title="Anagram Game Managed with JMX in New Project wizard"]
-4. Click Next. There is no need to change the supplied default project name or location values. Confirm that the Set as Main Project checkbox is selected. Click Finish.
+
+[start=4]
+. Click Next. There is no need to change the supplied default project name or location values. Confirm that the Set as Main Project checkbox is selected. Click Finish.
*Notes.* The IDE might prompt you to install the JUnit libraries if you did not install the JUnit plugin previously. You can click Resolve in the Resolve Resource Problems dialog box to launch the Installer to install the JUnit plugin. Alternatively, you can install the JUnit plugin in the Plugins manager.
-5. Once your project is created, and set as the Main Project, Run it with JConsole by clicking the "Run Main Project with Monitoring and Management" JConsole button.
+
+[start=5]
+. Once your project is created, and set as the Main Project, Run it with JConsole by clicking the "Run Main Project with Monitoring and Management" JConsole button.
*Notes.* You might see a Connection Failed warning in the Java Monitoring & Management Console when the console attempts to connect to the Anagram Game process. For this tutorial you can click Insecure when you are prompted to authorize the connection.
@@ -164,12 +168,22 @@
The JConsole window is also displayed.
-6. In the JConsole window, select the MBeans tab and in the tree layout on the left open down all nodes under ``anagrams.toy.com`` as shown below.
+
+[start=6]
+. In the JConsole window, select the MBeans tab and in the tree layout on the left open down all nodes under ``anagrams.toy.com`` as shown below.
image::images/jmx-jconsole1.png[title="JConsole window"]
-7. Select the Notifications node and click on the Subscribe button at the bottom so that JConsole will receive a new notification each time an anagram is solved.
-8. Now go to the Anagrams Game window, and solve the first three or four anagrams (The answers are in the WordLibrary class, but here they are: abstraction, ambiguous, arithmetic, backslash, ...)
-9. Go back to JConsole, and notice that it received the four notifications.
-10. Click on the Attributes node and notice the attributes values are updated:
+
+[start=7]
+. Select the Notifications node and click on the Subscribe button at the bottom so that JConsole will receive a new notification each time an anagram is solved.
+
+[start=8]
+. Now go to the Anagrams Game window, and solve the first three or four anagrams (The answers are in the WordLibrary class, but here they are: abstraction, ambiguous, arithmetic, backslash, ...)
+
+[start=9]
+. Go back to JConsole, and notice that it received the four notifications.
+
+[start=10]
+. Click on the Attributes node and notice the attributes values are updated:
image::images/jmx-jconsole2.png[title="JConsole window showing updated values"]
link:/about/contact_form.html?to=3&subject=Feedback:%20Getting%20Started%20with%20JMX%20Monitoring[+Send Feedback on This Tutorial+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ja.asciidoc
index 2bb0321..3c3b82e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ja.asciidoc
@@ -51,7 +51,7 @@
* link:../../index.html[+netbeans.org+]サイトからアクセス可能なチュートリアル。
-=== 前提条件
+== 前提条件
このチュートリアルは、次のテクノロジについて基本的な知識またはプログラミング経験を持つ読者を想定して書かれています。
@@ -62,7 +62,7 @@
link:http://download.oracle.com/javase/6/docs/technotes/guides/management/index.html[+Javaプラットフォームのモニタリングおよび管理+]の内容が参考になる場合もあります。
-=== チュートリアルに必要なソフトウェア
+== チュートリアルに必要なソフトウェア
このチュートリアルでは、コンピュータに次のソフトウェアをインストールしておく必要があります。
@@ -150,11 +150,15 @@
2. 「サンプル」でJMXカテゴリを選択します。
3. JMXで管理されたアナグラム・ゲーム・プロジェクトを選択します。
image::images/jmx-newproject.png[title="新規プロジェクト・ウィザードのJMXで管理されたアナグラム・ゲーム"]
-4. 「次」をクリックします。指定されているデフォルトのプロジェクト名や場所の値を変更する必要はありません。「メイン・プロジェクトとして設定」チェックボックスが選択されていることを確認します。「終了」をクリックします。
+
+[start=4]
+. 「次」をクリックします。指定されているデフォルトのプロジェクト名や場所の値を変更する必要はありません。「メイン・プロジェクトとして設定」チェックボックスが選択されていることを確認します。「終了」をクリックします。
*注意:*JUnitプラグインを以前にインストールしていない場合、JUnitライブラリのインストールを求めるメッセージが表示されることがあります。「リソースの問題を解決」ダイアログ・ボックスで「解決」をクリックしてインストーラを起動し、JUnitプラグインをインストールできます。プラグイン・マネージャでJUnitプラグインをインストールすることもできます。
-5. プロジェクトを作成し、メイン・プロジェクトとして設定したら、モニタリングおよび管理によるメイン・プロジェクトの実行のJConsoleボタンをクリックして、JConsoleで実行します。
+
+[start=5]
+. プロジェクトを作成し、メイン・プロジェクトとして設定したら、モニタリングおよび管理によるメイン・プロジェクトの実行のJConsoleボタンをクリックして、JConsoleで実行します。
*注意:*コンソールからアナグラム・ゲーム・プロセスに接続しようとすると、Java Monitoring & Management Consoleに「接続に失敗しました。」という警告が表示されることがあります。このチュートリアルでは、接続の認証を求めるメッセージが表示されたら、「非セキュア」をクリックできます。
@@ -164,12 +168,22 @@
JConsoleウィンドウも表示されます。
-6. JConsoleウィンドウで、「MBeans」タブを選択して、次に示すように、左側のツリー・レイアウトで ``anagrams.toy.com`` の下のすべてのノードを展開します。
+
+[start=6]
+. JConsoleウィンドウで、「MBeans」タブを選択して、次に示すように、左側のツリー・レイアウトで ``anagrams.toy.com`` の下のすべてのノードを展開します。
image::images/jmx-jconsole1.png[title="JConsoleウィンドウ"]
-7. 「通知」ノードを選択し、下にある「サブスクライブ」ボタンをクリックして、アナグラムが解決されるたびにJConsoleが新規通知を受け取れるようにします。
-8. 「アナグラム・ゲーム」ウィンドウに移動し、最初の3つか4つのアナグラムを解きます(解答はWordLibraryクラス内にありますが、次のとおりです: abstraction、ambiguous、arithmetic、backslash、...)
-9. JConsoleに戻り、4つの通知を受信したことを確認します。
-10. 「属性」ノードをクリックし、属性値が更新されていることを確認します。
+
+[start=7]
+. 「通知」ノードを選択し、下にある「サブスクライブ」ボタンをクリックして、アナグラムが解決されるたびにJConsoleが新規通知を受け取れるようにします。
+
+[start=8]
+. 「アナグラム・ゲーム」ウィンドウに移動し、最初の3つか4つのアナグラムを解きます(解答はWordLibraryクラス内にありますが、次のとおりです: abstraction、ambiguous、arithmetic、backslash、...)
+
+[start=9]
+. JConsoleに戻り、4つの通知を受信したことを確認します。
+
+[start=10]
+. 「属性」ノードをクリックし、属性値が更新されていることを確認します。
image::images/jmx-jconsole2.png[title="更新された値を示すJConsoleウィンドウ"]
link:/about/contact_form.html?to=3&subject=Feedback:%20Getting%20Started%20with%20JMX%20Monitoring[+このチュートリアルに関するご意見をお寄せください+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_pt_BR.asciidoc
index 498cbe8..a9087f4 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_pt_BR.asciidoc
@@ -51,7 +51,7 @@
* Tutoriais acessíveis do site link:../../index.html[+netbeans.org+].
-=== Pré-requisitos
+== Pré-requisitos
Este tutorial pressupõe que você tenha algum conhecimento básico das tecnologias a seguir ou alguma experiência de programação com elas:
@@ -62,7 +62,7 @@
Você também se beneficiará tendo conhecimento sobrelink:http://download.oracle.com/javase/6/docs/technotes/guides/management/index.html[+ Monitoramento e Gerenciamento da Plataforma Java+]
-=== Software Necessário para o Tutorial
+== Software Necessário para o Tutorial
Para este tutorial, você precisa ter instalado no computador os seguintes softwares:
@@ -150,11 +150,15 @@
2. Nestas Amostras, selecione a categoria JMX.
3. Selecione o Jogo de Anagramas Gerenciado com o projeto JMX.
image::images/jmx-newproject.png[title="Jogo de Anagramas Gerenciado com o JMX no assistente Novo Projeto"]
-4. Clique em Próximo. Não é necessário alterar o nome do projeto default fornecido ou os valores do local. Confirme se a caixa de seleção Definir como Projeto Principal está selecionada. Clique em Finalizar.
+
+[start=4]
+. Clique em Próximo. Não é necessário alterar o nome do projeto default fornecido ou os valores do local. Confirme se a caixa de seleção Definir como Projeto Principal está selecionada. Clique em Finalizar.
*Observações.* O IDE poderá solicitar a instalação das bibliotecas JUnit se você não tiver instalado o plug-in do JUnit anteriormente. Você pode clicar em Resolver, na caixa de diálogo Resolver Problemas de Recursos, para iniciar o Instalador a fim de instalar o plug-in do JUnit. Se preferir, instale o plug-in do JUnit no gerenciador de Plug-ins.
-5. Depois que seu projeto for criado e definido como o Projeto Principal, Execute-o com o JConsole, clicando no botão "Executar Projeto Principal com Monitoramento e Gerenciamento" da JConsole.
+
+[start=5]
+. Depois que seu projeto for criado e definido como o Projeto Principal, Execute-o com o JConsole, clicando no botão "Executar Projeto Principal com Monitoramento e Gerenciamento" da JConsole.
*Observações.* É possível que você veja uma advertência de Falha de Conexão na Console de Monitoramento e Gerenciamento Java quando a console tenta estabelecer conexão com o processo do Jogo de Anagramas. Neste tutorial, você pode clicar em Não Seguro quando solicitado a autorizar a conexão.
@@ -164,12 +168,22 @@
A janela JConsole também é exibida.
-6. Na janela JConsole, selecione a guia MBeans e no layout da árvore à esquerda, abra todos os nós em ``anagrams.toy.com`` conforme mostrado abaixo.
+
+[start=6]
+. Na janela JConsole, selecione a guia MBeans e no layout da árvore à esquerda, abra todos os nós em ``anagrams.toy.com`` conforme mostrado abaixo.
image::images/jmx-jconsole1.png[title="Janela JConsole"]
-7. Selecione o nó Notificações e clique no botão Assinar na parte inferior, de forma que o JConsole recebem uma nova notificação cada vez que um anagrama é resolvido.
-8. Agora vá para a janela Jogo de Anagramas e resolva os primeiros três ou quatro anagramas. (As respostas estão na classe WordLibrary, mas aqui estão elas: abstração, ambíguos, aritmética, barra invertida...)
-9. Volte para a JConsole e observe que ela recebeu as quatro notificações.
-10. Clique no nó Atributos e observe que os valores do atributo estão atualizados:
+
+[start=7]
+. Selecione o nó Notificações e clique no botão Assinar na parte inferior, de forma que o JConsole recebem uma nova notificação cada vez que um anagrama é resolvido.
+
+[start=8]
+. Agora vá para a janela Jogo de Anagramas e resolva os primeiros três ou quatro anagramas. (As respostas estão na classe WordLibrary, mas aqui estão elas: abstração, ambíguos, aritmética, barra invertida...)
+
+[start=9]
+. Volte para a JConsole e observe que ela recebeu as quatro notificações.
+
+[start=10]
+. Clique no nó Atributos e observe que os valores do atributo estão atualizados:
image::images/jmx-jconsole2.png[title="Janela de JConsole mostrando valores atualizados"]
link:/about/contact_form.html?to=3&subject=Feedback:%20Getting%20Started%20with%20JMX%20Monitoring[+Enviar Feedback neste Tutorial+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ru.asciidoc
index 71009f0..025eaef 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_ru.asciidoc
@@ -51,7 +51,7 @@
* Практические руководства доступны на сайте link:../../index.html[+netbeans.org+].
-=== Предпосылки
+== Предпосылки
Предполагается, что читатель обладает базовыми знаниями или опытом программирования по следующим технологиям.
@@ -62,7 +62,7 @@
Знания в области link:http://download.oracle.com/javase/6/docs/technotes/guides/management/index.html[+ мониторинга и управления платформой Java+] будут преимуществом.
-=== Программное обеспечение, требуемое для работы с данным учебным курсом.
+== Программное обеспечение, требуемое для работы с данным учебным курсом.
Для работы с этим учебным курсом на компьютере должно быть установлено следующее программное обеспечение.
@@ -150,11 +150,15 @@
2. В разделе 'Образцы' выберите категорию JMX.
3. Выберите проект 'Игра Anagram под управлениемJMX'.
image::images/jmx-newproject.png[title="Проект 'Игра Anagram под управлениемJMX' в мастере создания проектов"]
-4. Нажмите 'Далее'. Имя проекта и местоположение по умолчанию можно не менять. Убедитесь, что установлен флажок "Задать в качестве основного проекта". Нажмите кнопку 'Готово'.
+
+[start=4]
+. Нажмите 'Далее'. Имя проекта и местоположение по умолчанию можно не менять. Убедитесь, что установлен флажок "Задать в качестве основного проекта". Нажмите кнопку 'Готово'.
*Примечания.* Среда IDE может запросить разрешение на установку библиотеки JUnit, если вы не установили подключаемый модуль JUnit ранее. Вы можете нажать 'Разрешить' в диалоговом окне 'Разрешить проблему с ссылками' для запуска программы установки подключаемого модуля JUnit. В качестве альтернативы вы можете установить подключаемый модуль JUnit в диспетчере подключаемых модулей.
-5. Когда проект создан и выбран в качестве основного, запустите его в консоли JConsole, нажав на кнопку 'Запуск основного проекта с функциями мониторинга и управления'.
+
+[start=5]
+. Когда проект создан и выбран в качестве основного, запустите его в консоли JConsole, нажав на кнопку 'Запуск основного проекта с функциями мониторинга и управления'.
*Примечания.* Вы можете увидеть предупреждение о сбое подключения на консоли управления и мониторинга Java при попытке консоли подключиться к процессу Anagram Game. Для этой учебной программы вы можете нажать Ненадежно, когда вам будет предложено разрешить подключение.
@@ -164,12 +168,22 @@
Также отображается окно JConsole.
-6. В окне JConsole перейдите на вкладку MBeans и в дереве слева откройте все узлы под ``anagrams.toy.com`` , как показано на рисунке.
+
+[start=6]
+. В окне JConsole перейдите на вкладку MBeans и в дереве слева откройте все узлы под ``anagrams.toy.com`` , как показано на рисунке.
image::images/jmx-jconsole1.png[title="Окно JConsole"]
-7. Выберите узел 'Уведомления' и нажмите кнопку 'Подписаться' в нижней части окна консоли. После этого JConsole будет получать уведомления при расшифровке каждой анаграммы.
-8. Теперь перейдите в окно игры Anagram и расшифруйте первые три или четыре анаграммы (ответы находятся в классе WordLibrary: abstraction, ambiguous, arithmetic, backslash...)
-9. Вернитесь в консоль JConsole. Вы увидите, что получено четыре уведомления.
-10. При нажатии на узел 'Атрибуты' видно, что атрибуты обновлены:
+
+[start=7]
+. Выберите узел 'Уведомления' и нажмите кнопку 'Подписаться' в нижней части окна консоли. После этого JConsole будет получать уведомления при расшифровке каждой анаграммы.
+
+[start=8]
+. Теперь перейдите в окно игры Anagram и расшифруйте первые три или четыре анаграммы (ответы находятся в классе WordLibrary: abstraction, ambiguous, arithmetic, backslash...)
+
+[start=9]
+. Вернитесь в консоль JConsole. Вы увидите, что получено четыре уведомления.
+
+[start=10]
+. При нажатии на узел 'Атрибуты' видно, что атрибуты обновлены:
image::images/jmx-jconsole2.png[title="Окно JConsole с обновленными значениями"]
link:/about/contact_form.html?to=3&subject=Feedback:%20Getting%20Started%20with%20JMX%20Monitoring[+Отправить отзыв по этому учебному курсу+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_zh_CN.asciidoc
index e9c84ef..3149428 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-getstart_zh_CN.asciidoc
@@ -51,7 +51,7 @@
* 可从 link:../../index.html[+netbeans.org+] 站点访问的教程。
-=== 先决条件
+== 先决条件
本教程假定您具备以下技术的一些基本知识或编程经验。
@@ -62,7 +62,7 @@
您还将受益于在 link:http://download.oracle.com/javase/6/docs/technotes/guides/management/index.html[+Java 平台的监视和管理+]方面的一些知识
-=== 本教程所需要的软件
+== 本教程所需要的软件
在学习本教程之前，您需要在计算机上安装以下软件：
@@ -150,11 +150,15 @@
2. 在 "Samples"（样例）中，选择 "JMX" 类别。
3. 选择 "Anagram Game Managed with JMX"（使用 JMX 管理的 Anagram Game）项目。
image::images/jmx-newproject.png[title=""New Project"（新建项目）向导中的 "Anagram Game Managed with JMX"（使用 JMX 管理的 Anagram Game）"]
-4. 单击 "Next"（下一步）。无需更改提供的默认项目名称或位置值。确认 "Set as Main Project"（设置为主项目）复选框处于选中状态。单击 "Finish"（完成）。
+
+[start=4]
+. 单击 "Next"（下一步）。无需更改提供的默认项目名称或位置值。确认 "Set as Main Project"（设置为主项目）复选框处于选中状态。单击 "Finish"（完成）。
*注：*如果您以前未安装 JUnit 插件，则 IDE 可能会提示您安装 JUnit 库。您可以单击 "Resolve Resource Problems"（解决资源问题）对话框中的 "Resolve"（解决）启动安装程序来安装 JUnit 插件。或者，您也可以在插件管理器中安装 JUnit 插件。
-5. 创建项目并将其设置为主项目之后，通过单击 "Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）JConsole 按钮使用 JConsole 运行该项目。
+
+[start=5]
+. 创建项目并将其设置为主项目之后，通过单击 "Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）JConsole 按钮使用 JConsole 运行该项目。
*注：*当 Java 监视和管理控制台尝试连接到 Anagram Game 进程时，您可能会在此控制台中看到 "Connection Failed"（连接失败）警告。对于本教程，当系统提示您授权连接时，您可以单击 "Insecure"（不安全）。
@@ -164,12 +168,22 @@
也将显示 "JConsole" 窗口。
-6. 在 "JConsole" 窗口中，选择 "MBean" 标签，然后在左侧的树布局中向下打开 ``anagrams.toy.com`` 下的所有节点，如下所示。
+
+[start=6]
+. 在 "JConsole" 窗口中，选择 "MBean" 标签，然后在左侧的树布局中向下打开 ``anagrams.toy.com`` 下的所有节点，如下所示。
image::images/jmx-jconsole1.png[title=""JConsole" 窗口"]
-7. 选择 "Notifications"（通知）节点，然后单击底部的 "Subscribe"（订阅）按钮，这样在 Anagram 每次得到解决时 JConsole 都将会收到新通知。
-8. 现在转到 "Anagrams Game" 窗口，然后解决前三个或前四个 Anagram（答案位于 WordLibrary 类中，而此处它们是：abstraction、ambiguous、arithmetic、backslash...）
-9. 返回 JConsole，注意它收到了四个通知。
-10. 单击 "Attributes"（属性）节点，可以看到更新了属性值：
+
+[start=7]
+. 选择 "Notifications"（通知）节点，然后单击底部的 "Subscribe"（订阅）按钮，这样在 Anagram 每次得到解决时 JConsole 都将会收到新通知。
+
+[start=8]
+. 现在转到 "Anagrams Game" 窗口，然后解决前三个或前四个 Anagram（答案位于 WordLibrary 类中，而此处它们是：abstraction、ambiguous、arithmetic、backslash...）
+
+[start=9]
+. 返回 JConsole，注意它收到了四个通知。
+
+[start=10]
+. 单击 "Attributes"（属性）节点，可以看到更新了属性值：
image::images/jmx-jconsole2.png[title="显示已更新值的 "JConsole" 窗口"]
link:/about/contact_form.html?to=3&subject=Feedback:%20Getting%20Started%20with%20JMX%20Monitoring[+发送有关此教程的反馈意见+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial.asciidoc
index dc57846..bcc12d0 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial.asciidoc
@@ -41,7 +41,7 @@
4. Update the manager to add your own management logic.
-=== Tutorial Exercises
+== Tutorial Exercises
image::images/netbeans-stamp-80-74-73.png[title="Content on this page applies to the NetBeans IDE 7.2, 7.3, 7.4 and 8.0"]
@@ -96,7 +96,9 @@
2. In Samples, select the JMX category.
3. Select the Anagram Game Managed with JMX project.
image::images/jmx-newproject.png[title="Anagram Game Managed with JMX in New Project wizard"]
-4. Click Next. There is no need to change the already the default project name and location values. Confirm that Set as Main Project is selected and click Finish.
+
+[start=4]
+. Click Next. There is no need to change the already the default project name and location values. Confirm that Set as Main Project is selected and click Finish.
== Running the Agent
@@ -114,7 +116,9 @@
You can provide a port on which the agent waits for incoming JMX requests. In this tutorial, we just keep the default port (1099). If you provided another port number, you would have to make the appropriate changes in every part of this tutorial. Also, in this tutorial, we do not specify a properties file. (For your own applications, we provide a wizard to help you create a management properties file.)
-6. Choose Debug > Run Main Project with Monitoring and Management from the main menu to launch the Anagram Game application.
+
+[start=6]
+. Choose Debug > Run Main Project with Monitoring and Management from the main menu to launch the Anagram Game application.
Alternatively, click the Run Main Project with Monitoring and Management button in the toolbar ( image::images/run-project24.png[title="Run Main Project with Monitoring and Management button"]).
@@ -135,8 +139,12 @@
1. Choose File > New Project (Ctrl-Shift-N).
2. Choose Java Application in the Java category. Click Next.
image::images/jmx-newjavaproject.png[title="New Java Project wizard"]
-3. Type *JMXAnagramManager* as the Project Name.
-4. Select Set as Main Project (if not selected) and deselect Create Main Class. Click Finish.
+
+[start=3]
+. Type *JMXAnagramManager* as the Project Name.
+
+[start=4]
+. Select Set as Main Project (if not selected) and deselect Create Main Class. Click Finish.
*Note.* You will use the JMX Manager wizard to generate the main runnable class in the next exercise.
@@ -150,11 +158,21 @@
1. Confirm that the JMXAnagramManager project is set as the main project.
2. Choose File > New File (Ctrl-N; ⌘-N on Mac) and select JMX Manager in the JMX category. Click Next.
image::images/jmx-newjmxmanager.png[title="JMX Manager template in New File wizard"]
-3. Type *AnagramsManager* as the Class Name.
-4. Type *com.toys.anagrams.manager* as the package name.
-5. Confirm that Generate Main Method, Set as Project Main Class and Generate Sample MBean Discovery Code are selected. Click Next.
-6. Click Edit to enter the JMX agent URL to which you want to connect.
-7. Accept the default values in the RMI JMX Agent URL dialog box. Click OK.
+
+[start=3]
+. Type *AnagramsManager* as the Class Name.
+
+[start=4]
+. Type *com.toys.anagrams.manager* as the package name.
+
+[start=5]
+. Confirm that Generate Main Method, Set as Project Main Class and Generate Sample MBean Discovery Code are selected. Click Next.
+
+[start=6]
+. Click Edit to enter the JMX agent URL to which you want to connect.
+
+[start=7]
+. Accept the default values in the RMI JMX Agent URL dialog box. Click OK.
The RMI JMX Agent URL dialog box helps you enter a valid JMX URL, composed of a Protocol, a Host, a Port and an URL path.
@@ -166,7 +184,9 @@
When you click OK the JMX Agent URL field is updated with the full URL according to the details specified in the RMI JMX Agent URL dialog box.
-8. Confirm that Authenticated Connection and Generate Sample Code for Authenticated Connection are selected. Click Finish.
+
+[start=8]
+. Confirm that Authenticated Connection and Generate Sample Code for Authenticated Connection are selected. Click Finish.
[.feature]
--
image::images/jmx-jmxagenturl2-sm.png[role="left", link="images/jmx-jmxagenturl2.png"]
@@ -204,8 +224,12 @@
}
----
-2. Right-click in the editor and choose Fix Imports (Alt-Shift-I; ⌘-Shift-I on Mac) to generate any necessary import statements ( ``java.util.Set`` and ``java.util.Iterator`` ). Save your changes.
-3. Choose Run > Run Main Project from the main menu.
+
+[start=2]
+. Right-click in the editor and choose Fix Imports (Alt-Shift-I; ⌘-Shift-I on Mac) to generate any necessary import statements ( ``java.util.Set`` and ``java.util.Iterator`` ). Save your changes.
+
+[start=3]
+. Choose Run > Run Main Project from the main menu.
Alternatively, right-click the JMXAnagramManager project node in the Projects window and choose Run.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ja.asciidoc
index b4eccf5..e52cf48 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ja.asciidoc
@@ -41,7 +41,7 @@
4. マネージャを更新し、独自の管理ロジックを追加します。
-=== チュートリアルの課題
+== チュートリアルの課題
image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
@@ -95,7 +95,9 @@
2. 「サンプル」でJMXカテゴリを選択します。
3. JMXで管理されたアナグラム・ゲーム・プロジェクトを選択します。
image::images/jmx-newproject.png[title="新規プロジェクト・ウィザードのJMXで管理されたアナグラム・ゲーム"]
-4. 「次」をクリックします。既存のデフォルトのプロジェクト名と場所の値を変更する必要はありません。「メイン・プロジェクトとして設定」が選択されていることを確認し、「終了」をクリックします。
+
+[start=4]
+. 「次」をクリックします。既存のデフォルトのプロジェクト名と場所の値を変更する必要はありません。「メイン・プロジェクトとして設定」が選択されていることを確認し、「終了」をクリックします。
== エージェントの実行
@@ -113,7 +115,9 @@
エージェントが受信JMXリクエストを待機するポートを指定できます。このチュートリアルでは、デフォルト・ポート(1099)のままにします。別のポート番号を指定する場合は、このチュートリアルの各部分で適切な変更を行う必要があります。また、このチュートリアルでは、プロパティ・ファイルも指定しません。(独自のアプリケーションの場合、管理プロパティ・ファイルの作成に役立つウィザードが提供されます。)
-6. メイン・メニューから「デバッグ」>「モニタリングと管理付きでメイン・プロジェクトを実行」を選択し、Anagram Gameアプリケーションを起動します。
+
+[start=6]
+. メイン・メニューから「デバッグ」>「モニタリングと管理付きでメイン・プロジェクトを実行」を選択し、Anagram Gameアプリケーションを起動します。
あるいは、ツールバーの「モニタリングと管理付きでメイン・プロジェクトを実行」ボタン(image::images/run-project24.png[title="モニタリングおよび管理によるメイン・プロジェクトの実行のボタン"])をクリックします。
@@ -134,8 +138,12 @@
1. 「ファイル」>「新規プロジェクト」([Ctrl]-[Shift]-[N])を選択します。
2. 「Java」カテゴリで「Javaアプリケーション」を選択します。「次」をクリックします。
image::images/jmx-newjavaproject.png[title="新規Javaプロジェクト・ウィザード"]
-3. プロジェクト名として*「JMXAnagramManager」*と入力します。
-4. 「メイン・プロジェクトとして設定」を選択し(選択されていない場合)、「メイン・クラスの作成」を選択解除します。「終了」をクリックします。
+
+[start=3]
+. プロジェクト名として*「JMXAnagramManager」*と入力します。
+
+[start=4]
+. 「メイン・プロジェクトとして設定」を選択し(選択されていない場合)、「メイン・クラスの作成」を選択解除します。「終了」をクリックします。
*注意:*次の課題で、JMXマネージャ・ウィザードを使用してメインの実行可能クラスを生成します。
@@ -149,11 +157,21 @@
1. JMXAnagramManagerプロジェクトがメイン・プロジェクトとして設定されていることを確認します。
2. 「ファイル」>「新規ファイル」([Ctrl]-[N]、Macの場合は[⌘]-N)を選択し、「JMX」カテゴリで「JMXマネージャ」を選択します。「次」をクリックします。
image::images/jmx-newjmxmanager.png[title="新規ファイル・ウィザードのJMXマネージャ・テンプレート"]
-3. クラス名として*「AnagramsManager」*と入力します。
-4. パッケージ名として*「com.toys.anagrams.manager」*と入力します。
-5. 「mainメソッドを生成」、「プロジェクトのメイン・クラスとして設定」および「サンプルMBean検出コードの生成」が選択されていることを確認します。「次」をクリックします。
-6. 「編集」をクリックして、接続するJMXエージェントURLを入力します。
-7. RMI JMXエージェントURLダイアログ・ボックスでデフォルト値を受け入れます。「OK」をクリックします。
+
+[start=3]
+. クラス名として*「AnagramsManager」*と入力します。
+
+[start=4]
+. パッケージ名として*「com.toys.anagrams.manager」*と入力します。
+
+[start=5]
+. 「mainメソッドを生成」、「プロジェクトのメイン・クラスとして設定」および「サンプルMBean検出コードの生成」が選択されていることを確認します。「次」をクリックします。
+
+[start=6]
+. 「編集」をクリックして、接続するJMXエージェントURLを入力します。
+
+[start=7]
+. RMI JMXエージェントURLダイアログ・ボックスでデフォルト値を受け入れます。「OK」をクリックします。
RMI JMXエージェントURLダイアログ・ボックスは、プロトコル、ホスト、ポートおよびURLパスで構成される有効なJMX URLの入力に有用です。
@@ -165,7 +183,9 @@
「OK」をクリックすると、RMI JMXエージェントURLダイアログ・ボックスで指定された詳細に基づいた完全なURLでJMXエージェントURLフィールドが更新されます。
-8. 「認証された接続」および「認証された接続に対するサンプル・コードの生成」が選択されていることを確認します。「終了」をクリックします。
+
+[start=8]
+. 「認証された接続」および「認証された接続に対するサンプル・コードの生成」が選択されていることを確認します。「終了」をクリックします。
[.feature]
--
image::images/jmx-jmxagenturl2-sm.png[role="left", link="images/jmx-jmxagenturl2.png"]
@@ -203,8 +223,12 @@
}
----
-2. エディタで右クリックして「インポートを修正」([Alt]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、必要なインポート文( ``java.util.Set`` および ``java.util.Iterator`` )を生成します。変更を保存します。
-3. メイン・メニューから「実行」>「メイン・プロジェクトの実行」を選択します。
+
+[start=2]
+. エディタで右クリックして「インポートを修正」([Alt]-[Shift]-[I]、Macの場合は[⌘]-[Shift]-[I])を選択し、必要なインポート文( ``java.util.Set`` および ``java.util.Iterator`` )を生成します。変更を保存します。
+
+[start=3]
+. メイン・メニューから「実行」>「メイン・プロジェクトの実行」を選択します。
または、「プロジェクト」ウィンドウでJMXAnagramManagerプロジェクト・ノードを右クリックし、「実行」を選択します。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_pt_BR.asciidoc
index d7903d1..05459c5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_pt_BR.asciidoc
@@ -41,7 +41,7 @@
4. Atualize o gerenciador para adicionar sua própria lógica de gerenciamento.
-=== Exercícios do Tutorial
+== Exercícios do Tutorial
image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
@@ -95,7 +95,9 @@
2. Nestas Amostras, selecione a categoria JMX.
3. Selecione o Jogo de Anagramas Gerenciado com o projeto JMX.
image::images/jmx-newproject.png[title="Jogo de Anagramas Gerenciado com o JMX no assistente Novo Projeto"]
-4. Clique em Próximo. Não é necessário alterar o nome do projeto default ou os valores do local. Confirme se a opção Definir como Projeto Principal foi selecionada e clique em Finalizar.
+
+[start=4]
+. Clique em Próximo. Não é necessário alterar o nome do projeto default ou os valores do local. Confirme se a opção Definir como Projeto Principal foi selecionada e clique em Finalizar.
== Executando o Agente
@@ -113,7 +115,9 @@
Você pode fornecer uma porta na qual o agente aguarda pelas solicitações JMX de entrada. Neste tutorial, mantemos a porta default (1099). Se você forneceu outro número de porta, terá que fazer as alterações apropriadas em cada parte deste tutorial. Além disso, neste tutorial, não especificamos um arquivo de propriedades. (Para suas próprias aplicações, fornecemos um assistente para ajudá-lo a criar um arquivo de propriedades de gerenciamento).
-6. Escolha Depurar > Executar Projeto Principal com Monitoramento e Gerenciamento do menu principal para acionar a aplicação Jogo de Anagramas.
+
+[start=6]
+. Escolha Depurar > Executar Projeto Principal com Monitoramento e Gerenciamento do menu principal para acionar a aplicação Jogo de Anagramas.
Se preferir, clique no botão Executar Projeto Principal com Monitoramento e Gerenciamento na barra de ferramentas ( image::images/run-project24.png[title="Botão Executar Projeto Principal com Monitoramento e Gerenciamento"]).
@@ -134,8 +138,12 @@
1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N).
2. Escolha Aplicação Java na categoria Java. Clique em Próximo.
image::images/jmx-newjavaproject.png[title="Assistente Novo Projeto Java"]
-3. Digite *JMXAnagramManager* como Nome do Projeto.
-4. Selecione Definir como Projeto Principal (se não estiver selecionado) e desmarque a opção Criar Classe Principal. Clique em Finalizar.
+
+[start=3]
+. Digite *JMXAnagramManager* como Nome do Projeto.
+
+[start=4]
+. Selecione Definir como Projeto Principal (se não estiver selecionado) e desmarque a opção Criar Classe Principal. Clique em Finalizar.
*Observação.* Você usará o assistente Gerenciador JMX para gerar a classe executável principal no próximo exercício.
@@ -149,11 +157,21 @@
1. Confirme se o projeto JMXAnagramManager está definido como o projeto principal.
2. Escolha Arquivo > Novo Arquivo (Ctrl-N; ⌘-N no Mac) e selecione Gerenciador JMX na categoria JMX. Clique em Próximo.
image::images/jmx-newjmxmanager.png[title="O modelo do Gerenciador JMX no assistente Novo Arquivo"]
-3. Digite *AnagramsManager* como o Nome da Classe.
-4. Digite *com.toys.anagrams.manager* como o nome do pacote.
-5. Confirme se Gerar Método Principal, Definir como Classe Principal do Projeto e Gerar Código de Descoberta do MBean de Amostra estão selecionados. Clique em Próximo.
-6. Clique em Editar para digitar o URL do agente JMX para o qual você deseja estabelecer conexão.
-7. Aceite os valores default na caixa de diálogo URL do Agente JMX do RMI. Clique em OK.
+
+[start=3]
+. Digite *AnagramsManager* como o Nome da Classe.
+
+[start=4]
+. Digite *com.toys.anagrams.manager* como o nome do pacote.
+
+[start=5]
+. Confirme se Gerar Método Principal, Definir como Classe Principal do Projeto e Gerar Código de Descoberta do MBean de Amostra estão selecionados. Clique em Próximo.
+
+[start=6]
+. Clique em Editar para digitar o URL do agente JMX para o qual você deseja estabelecer conexão.
+
+[start=7]
+. Aceite os valores default na caixa de diálogo URL do Agente JMX do RMI. Clique em OK.
A caixa de diálogo URL do Agente JMX do RMI ajuda a informar um URL de JMX válido, composto de um Protocolo, um Host, uma Porta e um caminho de URL.
@@ -165,7 +183,9 @@
Quando você clicar em OK, o campo URL do Agente JMX é atualizado com o URL completo, de acordo com os detalhes especificados na caixa de diálogo URL do Agente JMX do RMI.
-8. Confirme se Conexão Autenticada e Gerar Código de Amostra para Conexão Autenticada estão selecionados. Clique em Finalizar.
+
+[start=8]
+. Confirme se Conexão Autenticada e Gerar Código de Amostra para Conexão Autenticada estão selecionados. Clique em Finalizar.
[.feature]
--
image::images/jmx-jmxagenturl2-sm.png[role="left", link="images/jmx-jmxagenturl2.png"]
@@ -203,8 +223,12 @@
}
----
-2. Clique com o botão direito do mouse no editor e escolha Corrigir Importações (Alt-Shift-I; ⌘-Shift-I no Mac) para gerar quaisquer instruções de importação necessárias ( ``java.util.Set`` e ``java.util.Iterator`` ). Salve as alterações.
-3. Escolha Executar > Executar Projeto Principal no menu principal.
+
+[start=2]
+. Clique com o botão direito do mouse no editor e escolha Corrigir Importações (Alt-Shift-I; ⌘-Shift-I no Mac) para gerar quaisquer instruções de importação necessárias ( ``java.util.Set`` e ``java.util.Iterator`` ). Salve as alterações.
+
+[start=3]
+. Escolha Executar > Executar Projeto Principal no menu principal.
Alternativamente, clique com o botão direito do mouse no nó do projeto JMXAnagramManager na janela Projetos e escolha Executar.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ru.asciidoc
index afcce01..4f6cece 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_ru.asciidoc
@@ -41,7 +41,7 @@
4. Обновлять диспетчер, добавляя в него собственную логику управления.
-=== Упражнения по темам руководства
+== Упражнения по темам руководства
image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
@@ -96,7 +96,9 @@
2. В разделе 'Образцы' выберите категорию JMX.
3. Выберите проект 'Игра Anagram под управлениемJMX'.
image::images/jmx-newproject.png[title="Проект 'Игра Anagram под управлениемJMX' в мастере создания проектов"]
-4. Нажмите 'Далее'. Имя проекта и местоположение по умолчанию можно не менять. Проверьте, что установлен флажок 'Выбрать как основной проект', и нажмите 'Готово'.
+
+[start=4]
+. Нажмите 'Далее'. Имя проекта и местоположение по умолчанию можно не менять. Проверьте, что установлен флажок 'Выбрать как основной проект', и нажмите 'Готово'.
== Запуск агента
@@ -114,7 +116,9 @@
Вы можете указать порт, с которого агент будет ожидать входящие запросы от JMX. В этом руководстве будет использоваться порт по умолчанию (1099). Если вы указали другой номер порта, вам потребуется внести соответствующие изменения на всех этапах. Кроме того, в этом руководстве не указывается файл свойств. (При разработке собственных приложений файлы свойств управления можно создавать с помощью мастера.)
-6. Выберите 'Отладка > Запуск основного проекта с функциями мониторинга и управления' в главном меню, чтобы запустить приложение Anagram Game.
+
+[start=6]
+. Выберите 'Отладка > Запуск основного проекта с функциями мониторинга и управления' в главном меню, чтобы запустить приложение Anagram Game.
Также можно нажать кнопку 'Запуск основного проекта с функциями мониторинга и управления' на панели инструментов ( image::images/run-project24.png[title="Кнопка 'Запуск основного проекта с функциями мониторинга и управления'"]).
@@ -135,8 +139,12 @@
1. Выберите команду "Файл" > "Создать проект" (CTRL+SHIFT+N).
2. В категории Java выберите 'Приложение Java'. Нажмите 'Далее'.
image::images/jmx-newjavaproject.png[title="Мастер создания проектов Java"]
-3. В поле 'Имя проекта' введите *JMXAnagramManager*.
-4. Выберите параметр 'Выбрать как основной проект' (если он еще не выбран) и снимите флажок 'Создать основной класс'. Нажмите 'Готово'.
+
+[start=3]
+. В поле 'Имя проекта' введите *JMXAnagramManager*.
+
+[start=4]
+. Выберите параметр 'Выбрать как основной проект' (если он еще не выбран) и снимите флажок 'Создать основной класс'. Нажмите 'Готово'.
*Примечание.* В следующем упражнении вы узнаете, как создать основной выполняемый класс с помощью мастера диспетчера JMX.
@@ -150,11 +158,21 @@
1. Убедитесь, что проект JMXAnagramManager выбран в качестве основного.
2. Выберите 'Файл > Создать файл' (Ctrl-N; ⌘-N для Mac), затем выберите 'Диспетчер JMX' в категории JMX. Нажмите кнопку "Далее".
image::images/jmx-newjmxmanager.png[title="Шаблон диспетчера JMX в мастере создания файлов"]
-3. В поле 'Имя класса' введите *AnagramsManager*.
-4. В поле 'Имя пакета' укажите *com.toys.anagrams.manager*.
-5. Убедитесь, что выбраны параметры 'Создать основной метод', 'Выбрать как основной класс проекта' и 'Создать пример кода обнаружения MBean'. Нажмите 'Далее'.
-6. Нажмите 'Изменить' и укажите URL-адрес агента JMX, к которому будет выполняться подключение.
-7. Оставьте все параметры по умолчанию в диалоговом окне 'URL-адрес агента RMI JMX' без изменения. Нажмите ОК.
+
+[start=3]
+. В поле 'Имя класса' введите *AnagramsManager*.
+
+[start=4]
+. В поле 'Имя пакета' укажите *com.toys.anagrams.manager*.
+
+[start=5]
+. Убедитесь, что выбраны параметры 'Создать основной метод', 'Выбрать как основной класс проекта' и 'Создать пример кода обнаружения MBean'. Нажмите 'Далее'.
+
+[start=6]
+. Нажмите 'Изменить' и укажите URL-адрес агента JMX, к которому будет выполняться подключение.
+
+[start=7]
+. Оставьте все параметры по умолчанию в диалоговом окне 'URL-адрес агента RMI JMX' без изменения. Нажмите ОК.
В диалоговом окне 'URL-адрес агента RMI JMX' указывается действующий URL-адрес JMX, который включает в себя протокол, узел, порт и путь URL.
@@ -166,7 +184,9 @@
При нажатии на кнопку ОК в поле 'URL-адрес агента JMX' появляется обновленный полный URL-адрес, составленный на основе данных, указанных в диалоговом окне 'URL-адрес агента RMI JMX'.
-8. Убедитесь, что выбраны параметры 'Аутентифицированное подключение' и 'Создать пример кода для аутентифицированного подключения'. Нажмите 'Готово'.
+
+[start=8]
+. Убедитесь, что выбраны параметры 'Аутентифицированное подключение' и 'Создать пример кода для аутентифицированного подключения'. Нажмите 'Готово'.
[.feature]
--
image::images/jmx-jmxagenturl2-sm.png[role="left", link="images/jmx-jmxagenturl2.png"]
@@ -204,8 +224,12 @@
}
----
-2. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Alt-Shift-I; ⌘-Shift-I в Mac), чтобы создать необходимые выражения импорта ( ``java.util.Set`` и ``java.util.Iterator`` ). Сохраните изменения.
-3. Выберите 'Выполнить > Запуск основного проекта' в главном меню.
+
+[start=2]
+. Щелкните правой кнопкой мыши в редакторе и выберите 'Исправить выражения импорта' (Alt-Shift-I; ⌘-Shift-I в Mac), чтобы создать необходимые выражения импорта ( ``java.util.Set`` и ``java.util.Iterator`` ). Сохраните изменения.
+
+[start=3]
+. Выберите 'Выполнить > Запуск основного проекта' в главном меню.
Также можно щелкнуть правой кнопкой мыши узел проекта JMXAnagramManager в окне 'Проекты' и выбрать 'Выполнить'.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_zh_CN.asciidoc
index 8f0580f..a0c3ccc 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-manager-tutorial_zh_CN.asciidoc
@@ -41,7 +41,7 @@
4. 更新该管理器以添加您自己的管理逻辑。
-=== 教程练习
+== 教程练习
image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
@@ -95,7 +95,9 @@
2. 在 "Samples"（样例）中，选择 "JMX" 类别。
3. 选择 "Anagram Game Managed with JMX"（使用 JMX 管理的 Anagram Game）项目。
image::images/jmx-newproject.png[title=""New Project"（新建项目）向导中的 "Anagram Game Managed with JMX"（使用 JMX 管理的 Anagram Game）"]
-4. 单击 "Next"（下一步）。无需更改已有的默认项目名称和位置值。确认选中 "Set as Main Project"（设置为主项目），然后单击 "Finish"（完成）。
+
+[start=4]
+. 单击 "Next"（下一步）。无需更改已有的默认项目名称和位置值。确认选中 "Set as Main Project"（设置为主项目），然后单击 "Finish"（完成）。
== 运行代理
@@ -113,7 +115,9 @@
可以提供代理用于等待传入的 JMX 请求的端口。在本教程中，我们只保留默认端口 (1099)。如果您提供了其他端口号，则必须在本教程的每一部分进行适当的更改。另外，在本教程中，我们不指定属性文件。（针对您自己的应用程序，我们将提供一个向导来帮助您创建管理属性文件。）
-6. 从主菜单中选择 "Debug"（调试）> "Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）以启动 Anagram Game 应用程序。
+
+[start=6]
+. 从主菜单中选择 "Debug"（调试）> "Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）以启动 Anagram Game 应用程序。
或者，单击工具栏中的 "Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）按钮 (image::images/run-project24.png[title=""Run Main Project with Monitoring and Management"（通过监视和管理运行主项目）按钮"])。
@@ -134,8 +138,12 @@
1. 选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键）。
2. 选择 "Java" 类别中的 "Java Application"（Java 应用程序）。单击 "Next"（下一步）。
image::images/jmx-newjavaproject.png[title=""New Java Project"（新建 Java 项目）向导"]
-3. 键入 *JMXAnagramManager* 作为项目名称。
-4. 选择 "Set as Main Project"（设置为主项目）（如果未选中）并取消选择 "Create Main Class"（创建主类）。单击 "Finish"（完成）。
+
+[start=3]
+. 键入 *JMXAnagramManager* 作为项目名称。
+
+[start=4]
+. 选择 "Set as Main Project"（设置为主项目）（如果未选中）并取消选择 "Create Main Class"（创建主类）。单击 "Finish"（完成）。
*注：*您将在下一个练习中使用 JMX 管理器向导生成可运行的主类。
@@ -149,11 +157,21 @@
1. 确认将 JMXAnagramManager 项目设置为主项目。
2. 选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键；在 Mac 上为 ⌘-N 组合键），然后在 "JMX" 类别中选择 "JMX Manager"（JMX 管理器）。单击 "Next"（下一步）。
image::images/jmx-newjmxmanager.png[title=""New File"（新建文件）向导中的 JMX 管理器模板"]
-3. 键入 *AnagramsManager* 作为类名。
-4. 键入 *com.toys.anagrams.manager* 作为包名称。
-5. 确认选中 "Generate Main Method"（生成 main 方法）、"Set as Project Main Class"（设置为项目主类）和 "Generate Sample MBean Discovery Code"（生成样例 MBean 发现代码）。单击 "Next"（下一步）。
-6. 单击 "Edit"（编辑）以输入要连接到的 JMX 代理 URL。
-7. 接受 "RMI JMX Agent URL"（RMI JMX 代理 URL）对话框中的默认值。单击 "OK"（确定）。
+
+[start=3]
+. 键入 *AnagramsManager* 作为类名。
+
+[start=4]
+. 键入 *com.toys.anagrams.manager* 作为包名称。
+
+[start=5]
+. 确认选中 "Generate Main Method"（生成 main 方法）、"Set as Project Main Class"（设置为项目主类）和 "Generate Sample MBean Discovery Code"（生成样例 MBean 发现代码）。单击 "Next"（下一步）。
+
+[start=6]
+. 单击 "Edit"（编辑）以输入要连接到的 JMX 代理 URL。
+
+[start=7]
+. 接受 "RMI JMX Agent URL"（RMI JMX 代理 URL）对话框中的默认值。单击 "OK"（确定）。
"RMI JMX Agent URL"（RMI JMX 代理 URL）对话框将帮助您输入有效的 JMX URL（由协议、主机、端口和 URL 路径组成）。
@@ -165,7 +183,9 @@
单击 "OK"（确定）后，将根据 "RMI JMX Agent URL"（RMI JMX 代理 URL）对话框中指定的详细信息使用完整 URL 更新 "JMX Agent URL"（JMX 代理 URL）字段。
-8. 确认选中 "Authenticated Connection"（已验证连接）和 "Generate Sample Code for Authenticated Connection"（为已验证连接生成样例代码）。单击 "Finish"（完成）。
+
+[start=8]
+. 确认选中 "Authenticated Connection"（已验证连接）和 "Generate Sample Code for Authenticated Connection"（为已验证连接生成样例代码）。单击 "Finish"（完成）。
[.feature]
--
image::images/jmx-jmxagenturl2-sm.png[role="left", link="images/jmx-jmxagenturl2.png"]
@@ -203,8 +223,12 @@
}
----
-2. 在编辑器中右键单击，然后选择“修复导入”（Alt-Shift-I 组合键；在 Mac 上为 ⌘-Shift-I 组合键），以生成所有必要的 import 语句（ ``java.util.Set`` 和 ``java.util.Iterator`` ）。保存所做的更改。
-3. 从主菜单中选择“运行”>“运行主项目”。
+
+[start=2]
+. 在编辑器中右键单击，然后选择“修复导入”（Alt-Shift-I 组合键；在 Mac 上为 ⌘-Shift-I 组合键），以生成所有必要的 import 语句（ ``java.util.Set`` 和 ``java.util.Iterator`` ）。保存所做的更改。
+
+[start=3]
+. 从主菜单中选择“运行”>“运行主项目”。
或者，在“项目”窗口中右键单击 JMXAnagramManager 项目节点，然后选择“运行”。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial.asciidoc
index 426eeb0..b1d1bd6 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial.asciidoc
@@ -36,7 +36,7 @@
This tutorial shows you how to add management to an existing application (the NetBeans sample Anagrams Game application). You will first create a non-manageable Anagram Java Project. You will then use JMX Wizards to generate 90% of the management. Then you will implement the management behavior specific to the application. You will finally use the Run/Debug project with JConsole to visualize the Anagram MBeans.
-=== Tutorial exercises
+== Tutorial exercises
image::images/netbeans-stamp-80-74-73.png[title="Content on this page applies to the NetBeans IDE 7.2, 7.3, 7.4 and 8.0"]
@@ -94,12 +94,18 @@
When you click Finish the IDE creates the Anagram Game project and displays the project in the Projects window.
-5. Right-click the AnagramGame project and select Properties.
-6. Select the Sources category and confirm that the Source/Binary format is set to JDK 7 or JDK 8. Click OK.
+
+[start=5]
+. Right-click the AnagramGame project and select Properties.
+
+[start=6]
+. Select the Sources category and confirm that the Source/Binary format is set to JDK 7 or JDK 8. Click OK.
*Note.* To select JDK 7 or JDK 8, the Java Platform for the AnagramGame project must also be at least JDK 7 or JDK 8, respectively. You can change the Java Platform for the AnagramGame in the Libraries category in the Properties window.
-7. Right-click the Anagram Game project node and choose Run.
+
+[start=7]
+. Right-click the Anagram Game project node and choose Run.
When you choose Run, the IDE builds and launches the Anagram Game application.
@@ -114,14 +120,18 @@
2. Choose File > New File (Ctrl-N).
3. From the JMX category, select Standard MBean. Click Next.
image::images/jmx-newfile.png[title="Standard MBean file type in New File Wizard"]
-4. Enter the following information Name and Location panel:
+
+[start=4]
+. Enter the following information Name and Location panel:
* Class Name: ``AnagramsStats``
* Location: Source Packages (default)
* Package: ``com.toy.anagrams.mbeans``
* Description: ``Monitoring and Management of the Anagrams Game``
image::images/jmx-newmbean.png[]
-5. Click Finish.
+
+[start=5]
+. Click Finish.
When you click Finish the ``AnagramsStats`` MBean class and ``AnagramsStatsMBean`` MBean interface are generated in the ``com.toy.anagrams.mbeans`` package of the AnagramGame project. These are now several empty skeletons that you will populate in the next exercise.
@@ -148,7 +158,9 @@
*Note.* Do not click OK yet!
-4. Click Add Attribute again and add the following ``NumSolvedAnagrams`` attribute. Click OK.
+
+[start=4]
+. Click Add Attribute again and add the following ``NumSolvedAnagrams`` attribute. Click OK.
* Attribute Name: ``NumSolvedAnagrams``
* Type: int
* Access: ReadOnly
@@ -162,8 +174,12 @@
Next you will add three more attributes to keep track of the minimum and maximum thinking time the user took, and of the current anagram being proposed to the user.
-5. Right-click in the source editor and select *JMX > Add MBean Attributes* in the popup menu.
-6. Click the Add Attribute button and add the following attributes.
+
+[start=5]
+. Right-click in the source editor and select *JMX > Add MBean Attributes* in the popup menu.
+
+[start=6]
+. Click the Add Attribute button and add the following attributes.
|===
|Attribute Name |Type |Access |Description
@@ -181,9 +197,15 @@
*Note.* Notice that the attributes that you already created are listed in the dialog box.
-7. Click OK and save your changes.
-8. Right-click in the source editor and select *JMX > Add MBeans Operations* in the popup menu.
-9. Click Add Operation and add the ``resetAll()`` operation and specify the following details. Click OK.
+
+[start=7]
+. Click OK and save your changes.
+
+[start=8]
+. Right-click in the source editor and select *JMX > Add MBeans Operations* in the popup menu.
+
+[start=9]
+. Click Add Operation and add the ``resetAll()`` operation and specify the following details. Click OK.
* Operation Name: ``resetAll``
* Return Type: ``void``
* Parameters: (leave empty)
@@ -194,8 +216,12 @@
After you click OK you can see that the necessary code to expose the ``resetAll`` operation was generated in both the ``AnagramsStats`` MBean class and its interface.
-10. Right-click in the source editor and select the *JMX > Implement NotificationEmitter interface* in the popup menu.
-11. Specify the following details in the Implement NotificationEmitter interface dialog box.
+
+[start=10]
+. Right-click in the source editor and select the *JMX > Implement NotificationEmitter interface* in the popup menu.
+
+[start=11]
+. Specify the following details in the Implement NotificationEmitter interface dialog box.
* *Select Generate Delegation to Broadcaster.* All methods declared by the ``NotificationEmitter`` interface will be implemented by delegating to a notification broadcaster. A notification broadcaster simplifies the way the MBean will send notifications.
* *Select Generate Private Seq Number and Accessor.* Some code will be generated to handle the unique sequence number value that must be added to each notification that is sent.
* *Click Add Notification.* Specify the following details in the Notifications table.
@@ -209,7 +235,9 @@
You can see that the necessary code to implement the ``NotificationEmitter`` interface was generated in the ``AnagramsStats`` MBean class. You can see how the generated implementation delegates the handling of notifications to the ``NotificationBroadcasterSupport`` class.
-12. Save your changes.
+
+[start=12]
+. Save your changes.
In this exercise you learned how to add attributes, operations and notifications emission to an MBean using the JMX Wizard module. The steps needed to populate your MBean with the necessary infrastructure to expose the management information you want are now finished. You now need to add internal logic to the ``AnagramsStats`` MBean class implementation, then build the bridge between the MBean and the Anagram Game application.
@@ -233,7 +261,9 @@
numSolvedAnagrams = 0;*
}
----
-3. You also need to add some implementation code that will do the following:
+
+[start=3]
+. You also need to add some implementation code that will do the following:
* calculate the thinking time the user took to solve the last anagram,
* calculate the minimum and maximum thinking times,
* increment the counter of solved anagrams,
@@ -318,8 +348,12 @@
The ``Anagrams`` class in the ``com.toy.anagrams.ui`` package is the ``main`` class of the Anagram Game application. The file opens in the Editor's Design view because the ``Anagrams`` class is also the User Interface class.
-2. Click the Source button at the top of the Editor window to edit the class in the Source view.
-3. Add the following empty ``initManagement()`` private method to the ``Anagrams`` class: after the ``Anagrams`` constructor.
+
+[start=2]
+. Click the Source button at the top of the Editor window to edit the class in the Source view.
+
+[start=3]
+. Add the following empty ``initManagement()`` private method to the ``Anagrams`` class: after the ``Anagrams`` constructor.
[source,java]
----
@@ -333,7 +367,9 @@
}
----
-4. Add the following call to the ``initManagement()`` method at the end of the ``Anagrams`` class constructor before the enclosing curly brace marking the end of the constructor.
+
+[start=4]
+. Add the following call to the ``initManagement()`` method at the end of the ``Anagrams`` class constructor before the enclosing curly brace marking the end of the constructor.
[source,java]
----
@@ -353,7 +389,9 @@
--
image:images/jmx-initmanagement-sm.png[role="left", link="images/jmx-initmanagement.png"]
--
-5. We now add the MBean registration code to the ``initManagement()`` method, using the JMX Module MBean registration wizard:
+
+[start=5]
+. We now add the MBean registration code to the ``initManagement()`` method, using the JMX Module MBean registration wizard:
In the ``Anagrams.java`` source editor window, right-click *inside* the ``initManagement()`` method body, select the JMX submenu and then the "Generate MBean Registration..." action. In the "Instantiate and Register MBean" panel that shows up, keep the "Register Existing MBean" radio-button selected, click the Browse button, choose the ``AnagramsStats`` MBean class and click OK in the Browse panel. You should now see:
@@ -377,7 +415,9 @@
Therefore, you need to make the following changes to the code of the ``Anagrams.java`` file.
-6. Add the following private field to the ``Anagrams`` class.
+
+[start=6]
+. Add the following private field to the ``Anagrams`` class.
[source,java]
----
@@ -386,7 +426,9 @@
private AnagramsStats mbean;
----
-7. Initialize the reference to the ``AnagramsStats`` MBean in the ``initManagement()`` method by modifying the generated MBean Registration code so that it reads:
+
+[start=7]
+. Initialize the reference to the ``AnagramsStats`` MBean in the ``initManagement()`` method by modifying the generated MBean Registration code so that it reads:
[source,java]
----
@@ -401,7 +443,9 @@
*ex.printStackTrace();*
}
----
-8. Initialize the ``AnagramsStats`` MBean state: when the Anagrams Game application starts up, an anagram is immediately displayed, so we need to pass to the MBean the anagram string value and to start computing thinking time. Copy and paste the lines below at the end of the ``initManagement()`` method:
+
+[start=8]
+. Initialize the ``AnagramsStats`` MBean state: when the Anagrams Game application starts up, an anagram is immediately displayed, so we need to pass to the MBean the anagram string value and to start computing thinking time. Copy and paste the lines below at the end of the ``initManagement()`` method:
[source,java]
----
@@ -422,7 +466,9 @@
You now need to add code to track the user's anagram solving experience.
-9. Locate the ``nextTrialActionPerformed()`` method and paste the following code at the end of the ``nextTrialActionPerformed()`` method.
+
+[start=9]
+. Locate the ``nextTrialActionPerformed()`` method and paste the following code at the end of the ``nextTrialActionPerformed()`` method.
[source,java]
----
@@ -436,7 +482,9 @@
Each time that a new anagram is proposed to the user, the code tells the MBean which anagram it is and to start counting the user thinking time.
-10. Locate the ``guessedWordActionPerformed()`` method and add the following lines to the code. Save your changes.
+
+[start=10]
+. Locate the ``guessedWordActionPerformed()`` method and add the following lines to the code. Save your changes.
[source,java]
----
@@ -483,20 +531,32 @@
*Notes.* You might see a Connection Failed warning in the Java Monitoring & Management Console when the console attempts to connect to the Anagram Game process. For this tutorial you can click Insecure when you are prompted to authorize the connection.
-2. Select the MBeans tab in the JConsole window.
-3. In the tree layout in the left pane, expand all the nodes under ``com.toy.anagrams.mbeans`` .
+
+[start=2]
+. Select the MBeans tab in the JConsole window.
+
+[start=3]
+. In the tree layout in the left pane, expand all the nodes under ``com.toy.anagrams.mbeans`` .
image::images/jmx-jconsole-mbeans1.png[title="MBeans tab showing AnagramsStats node"]
-4. Select the Notifications node and click on the Subscribe button at the bottom so that JConsole will receive a new notification each time an anagram is solved.
-5. In the Anagrams Game window, and solve the first three or four anagrams.
+
+[start=4]
+. Select the Notifications node and click on the Subscribe button at the bottom so that JConsole will receive a new notification each time an anagram is solved.
+
+[start=5]
+. In the Anagrams Game window, and solve the first three or four anagrams.
The solutions to the anagrams (abstraction, ambiguous, arithmetic, backslash,...) are contained in the ``WordLibrary`` class.
-6. In the JConsole window, and notice that it received notifications for each of the solutions.
+
+[start=6]
+. In the JConsole window, and notice that it received notifications for each of the solutions.
[.feature]
--
image::images/jmx-jconsole-mbeans2-sm.png[role="left", link="images/jmx-jconsole-mbeans2.png"]
--
-7. Click on the Attributes node and notice the attributes values are updated:
+
+[start=7]
+. Click on the Attributes node and notice the attributes values are updated:
image::images/jmx-jconsole-mbeans3.png[title="MBeans tab showing AnagramsStats node"]
You can experiment with the JConsole interface and the Anagrams Game. For example, if you invoke the management operation ``resetAll()`` you will see that the MBean attribute values are reset to 0.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ja.asciidoc
index 36bcab1..f48d2ae 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ja.asciidoc
@@ -36,7 +36,7 @@
このチュートリアルでは、既存のアプリケーション(NetBeansサンプルAnagrams Gameアプリケーション)に管理を追加する方法を示します。まず、非管理可能Anagram Javaプロジェクトを作成します。JMXウィザードを使用して管理の90%を生成します。次に、アプリケーションに固有の管理動作を実装します。最後に、JConsoleでプロジェクトの実行/デバッグを使用して、Anagram MBeanを視覚化します。
-=== チュートリアルの課題
+== チュートリアルの課題
image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 7.2、7.3、7.4および8.0に適用されます"]
@@ -93,12 +93,18 @@
「終了」をクリックすると、IDEによってAnagram Gameプロジェクトが作成され、そのプロジェクトが「プロジェクト」ウィンドウに表示されます。
-5. AnagramGameプロジェクトを右クリックし、「プロパティ」を選択します。
-6. 「ソース」カテゴリを選択し、「ソース/バイナリ形式」がJDK 7またはJDK 8に設定されていることを確認します。「OK」をクリックします。
+
+[start=5]
+. AnagramGameプロジェクトを右クリックし、「プロパティ」を選択します。
+
+[start=6]
+. 「ソース」カテゴリを選択し、「ソース/バイナリ形式」がJDK 7またはJDK 8に設定されていることを確認します。「OK」をクリックします。
*注意:*「JDK 7」または「JDK 8」を選択するには、AnagramGameプロジェクトのJavaプラットフォームもそれぞれJDK 7またはJDK 8以上である必要があります。AnagramGameのJavaプラットフォームは、「プロパティ」ウィンドウの「ライブラリ」カテゴリで変更できます。
-7. Anagram Gameプロジェクト・ノードを右クリックし、「実行」を選択します。
+
+[start=7]
+. Anagram Gameプロジェクト・ノードを右クリックし、「実行」を選択します。
「実行」をクリックすると、IDEによってAnagram Gameアプリケーションがビルドおよび起動されます。
@@ -113,14 +119,18 @@
2. 「ファイル」>「新規ファイル」([Ctrl]-[N])を選択します。
3. 「JMX」カテゴリから、「標準MBean」を選択します。「次」をクリックします。
image::images/jmx-newfile.png[title="新規ファイル・ウィザードの標準MBeanファイル・タイプ"]
-4. 「名前と場所」パネルで次の情報を入力します。
+
+[start=4]
+. 「名前と場所」パネルで次の情報を入力します。
* クラス名: ``AnagramsStats``
* 場所: ソース・パッケージ(デフォルト)
* パッケージ: ``com.toy.anagrams.mbeans``
* 説明: ``Monitoring and Management of the Anagrams Game``
image::images/jmx-newmbean.png[]
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
「終了」をクリックすると、 ``AnagramsStats`` MBeanクラスおよび ``AnagramsStatsMBean`` MBeanインタフェースがAnagramGameプロジェクトの ``com.toy.anagrams.mbeans`` パッケージに作成されます。これらは、次の課題で移入されるの空のスケルトンです。
@@ -147,7 +157,9 @@
*注意:*まだ「OK」をクリックしないでください。
-4. 「属性の追加」を再度クリックし、次の ``NumSolvedAnagrams`` 属性を追加します。「OK」をクリックします。
+
+[start=4]
+. 「属性の追加」を再度クリックし、次の ``NumSolvedAnagrams`` 属性を追加します。「OK」をクリックします。
* 属性名: ``NumSolvedAnagrams``
* 型: int
* アクセス: 読取り専用
@@ -161,8 +173,12 @@
次に、ユーザーが解答までにかかった最小と最大の思考時間および現在ユーザーに表示されているアナグラムを追跡するために、属性をさらに3個追加します。
-5. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「MBean属性の追加」*を選択します。
-6. 「属性の追加」ボタンをクリックし、次の属性を追加します。
+
+[start=5]
+. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「MBean属性の追加」*を選択します。
+
+[start=6]
+. 「属性の追加」ボタンをクリックし、次の属性を追加します。
|===
|属性名 |型 |アクセス |説明
@@ -180,9 +196,15 @@
*注意:*作成した属性がダイアログ・ボックスにリストされていることに注意してください。
-7. 「OK」をクリックして変更内容を保存します。
-8. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「MBean操作の追加」*を選択します。
-9. 「操作の追加」をクリックし、 ``resetAll()`` 操作を追加して次の詳細を指定します。「OK」をクリックします。
+
+[start=7]
+. 「OK」をクリックして変更内容を保存します。
+
+[start=8]
+. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「MBean操作の追加」*を選択します。
+
+[start=9]
+. 「操作の追加」をクリックし、 ``resetAll()`` 操作を追加して次の詳細を指定します。「OK」をクリックします。
* 操作名: ``resetAll``
* 戻り型: ``void``
* パラメータ: (空のままにします)
@@ -193,8 +215,12 @@
「OK」をクリックすると、 ``resetAll`` 操作を公開するために必要なコードが ``AnagramsStats`` MBeanクラスとそのインタフェースの両方に生成されていることが確認できます。
-10. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「NotificationEmitterインタフェースの実装」*を選択します。
-11. 「NotificationEmitterインタフェースの実装」ダイアログで次の詳細を指定します。
+
+[start=10]
+. ソース・エディタで右クリックし、ポップアップ・メニューで*「JMX」>「NotificationEmitterインタフェースの実装」*を選択します。
+
+[start=11]
+. 「NotificationEmitterインタフェースの実装」ダイアログで次の詳細を指定します。
* *「ブロードキャスタへの委任の生成」を選択します。* ``NotificationEmitter`` インタフェースによって宣言されているすべてのメソッドは、通知ブロードキャスタに委任することで実装されます。通知ブロードキャスタは、MBeanが通知を送信する方法を簡略化します。
* *「プライベート順序番号とアクセッサの生成」を選択します。*送信される各通知に追加される一意の順序番号値を処理するためのコードが生成されます。
* *「通知の追加」をクリックします。*通知表で次の詳細を指定します。
@@ -208,7 +234,9 @@
``NotificationEmitter`` インタフェースを実装するために必要なコードが ``AnagramsStats`` MBeanクラスに生成されていることが確認できます。生成された実装によって通知の処理が ``NotificationBroadcasterSupport`` クラスに委任されたことが確認できます。
-12. 変更を保存します。
+
+[start=12]
+. 変更を保存します。
この課題では、JMXウィザード・モジュールを使用して、属性、操作および通知の送信をMBeanに追加する方法を学習しました。これで、管理情報を公開するために必要なインフラストラクチャをMBeanに移入するために必要な手順が終了しました。 ``AnagramsStats`` MBeanクラスの実装に内部ロジックを追加し、MBeanとAnagram Gameアプリケーションの間にブリッジを作成する必要があります。
@@ -232,7 +260,9 @@
numSolvedAnagrams = 0;*
}
----
-3. 次の処理を行う実装コードも追加する必要があります。
+
+[start=3]
+. 次の処理を行う実装コードも追加する必要があります。
* ユーザーが最後のアナグラムを解くのにかかった思考時間の計算
* 最小および最大の思考時間の計算
* 解かれたアナグラムのカウンタの増分
@@ -317,8 +347,12 @@
``com.toy.anagrams.ui`` パッケージの ``Anagrams`` クラスは、Anagram Gameアプリケーションの ``main`` クラスです。 ``Anagrams`` クラスはユーザー・インタフェース・クラスでもあるため、ファイルはエディタの「デザイン」ビューで開きます。
-2. エディタ・ウィンドウの上部にある「ソース」ボタンをクリックして、「ソース」ビューでクラスを編集します。
-3. 次の空の ``initManagement()`` プライベート・メソッドを ``Anagrams`` クラス( ``Anagrams`` コンストラクタの後)に追加します。
+
+[start=2]
+. エディタ・ウィンドウの上部にある「ソース」ボタンをクリックして、「ソース」ビューでクラスを編集します。
+
+[start=3]
+. 次の空の ``initManagement()`` プライベート・メソッドを ``Anagrams`` クラス( ``Anagrams`` コンストラクタの後)に追加します。
[source,java]
----
@@ -332,7 +366,9 @@
}
----
-4. 次の ``initManagement()`` メソッドへのコールを ``Anagrams`` クラス・コンストラクタの最後、コンストラクタの終わりを表す終了の波括弧の前に追加します。
+
+[start=4]
+. 次の ``initManagement()`` メソッドへのコールを ``Anagrams`` クラス・コンストラクタの最後、コンストラクタの終わりを表す終了の波括弧の前に追加します。
[source,java]
----
@@ -352,7 +388,9 @@
--
image:images/jmx-initmanagement-sm.png[role="left", link="images/jmx-initmanagement.png"]
--
-5. ここで、JMXモジュールMBean登録ウィザードを使用して、MBean登録コードを ``initManagement()`` メソッドに追加します。
+
+[start=5]
+. ここで、JMXモジュールMBean登録ウィザードを使用して、MBean登録コードを ``initManagement()`` メソッドに追加します。
``Anagrams.java`` ソース・エディタ・ウィンドウで、 ``initManagement()`` メソッド本体*内*を右クリックし、「JMX」サブメニュー、「MBean登録の生成」アクションの順に選択します。表示された「MBeanのインスタンス化と登録」パネルで、「既存のMBeanの登録」ラジオ・ボタンを選択されたままにし、「参照」ボタンをクリックします。「参照」パネルで「 ``AnagramsStats`` 」MBeanクラスを選択し、「OK」をクリックします。表示は次のようになります。
@@ -376,7 +414,9 @@
したがって、 ``Anagrams.java`` ファイルのコードに次の変更を行う必要があります。
-6. 次のプライベート・フィールドを ``Anagrams`` クラスに追加します。
+
+[start=6]
+. 次のプライベート・フィールドを ``Anagrams`` クラスに追加します。
[source,java]
----
@@ -385,7 +425,9 @@
private AnagramsStats mbean;
----
-7. 生成されたMBean登録コードを次のように変更して、 ``initManagement()`` メソッド内の ``AnagramsStats`` MBeanへの参照を初期化します。
+
+[start=7]
+. 生成されたMBean登録コードを次のように変更して、 ``initManagement()`` メソッド内の ``AnagramsStats`` MBeanへの参照を初期化します。
[source,java]
----
@@ -400,7 +442,9 @@
*ex.printStackTrace();*
}
----
-8. ``AnagramsStats`` MBeanの状態を初期化します。Anagrams Gameアプリケーションが起動されると、アナグラムがすぐに表示されます。MBeanにアナグラム文字列値を渡し、思考時間の計算を開始する必要があります。次の行をコピーして ``initManagement()`` メソッドの最後に貼り付けます。
+
+[start=8]
+. ``AnagramsStats`` MBeanの状態を初期化します。Anagrams Gameアプリケーションが起動されると、アナグラムがすぐに表示されます。MBeanにアナグラム文字列値を渡し、思考時間の計算を開始する必要があります。次の行をコピーして ``initManagement()`` メソッドの最後に貼り付けます。
[source,java]
----
@@ -421,7 +465,9 @@
ユーザーのアナグラムの解答の実績を追跡するコードを追加する必要があります。
-9. ``nextTrialActionPerformed()`` メソッドを見つけて、次のコードを ``nextTrialActionPerformed()`` メソッドの最後に貼り付けます。
+
+[start=9]
+. ``nextTrialActionPerformed()`` メソッドを見つけて、次のコードを ``nextTrialActionPerformed()`` メソッドの最後に貼り付けます。
[source,java]
----
@@ -435,7 +481,9 @@
新しいアナグラムがユーザーに表示されるたびに、MBeanにそのアナグラムが示され、ユーザーの思考時間のカウントを開始するよう指示されます。
-10. ``guessedWordActionPerformed()`` メソッドを見つけ、次の行をコードに追加します。変更を保存します。
+
+[start=10]
+. ``guessedWordActionPerformed()`` メソッドを見つけ、次の行をコードに追加します。変更を保存します。
[source,java]
----
@@ -482,20 +530,32 @@
*注意:*コンソールからアナグラム・ゲーム・プロセスに接続しようとすると、Java Monitoring & Management Consoleに「接続に失敗しました。」という警告が表示されることがあります。このチュートリアルでは、接続の認証を求めるメッセージが表示されたら、「非セキュア」をクリックできます。
-2. JConsoleウィンドウで「MBeans」タブを選択します。
-3. 左ペインのツリー・レイアウトで、 ``com.toy.anagrams.mbeans`` の下のノードをすべて展開します。
+
+[start=2]
+. JConsoleウィンドウで「MBeans」タブを選択します。
+
+[start=3]
+. 左ペインのツリー・レイアウトで、 ``com.toy.anagrams.mbeans`` の下のノードをすべて展開します。
image::images/jmx-jconsole-mbeans1.png[title="AnagramsStatsノードを表示した「MBeans」タブ"]
-4. 「通知」ノードを選択し、下にある「サブスクライブ」ボタンをクリックして、アナグラムが解決されるたびにJConsoleが新規通知を受け取れるようにします。
-5. 「Anagrams Game」ウィンドウで最初の3、4個のアナグラムを解きます。
+
+[start=4]
+. 「通知」ノードを選択し、下にある「サブスクライブ」ボタンをクリックして、アナグラムが解決されるたびにJConsoleが新規通知を受け取れるようにします。
+
+[start=5]
+. 「Anagrams Game」ウィンドウで最初の3、4個のアナグラムを解きます。
アナグラムの解答(abstraction、ambiguous、arithmetic、backslash、...)は、 ``WordLibrary`` クラスに含まれます。
-6. JConsoleウィンドウで、解答のたびに通知を受信していることを確認します。
+
+[start=6]
+. JConsoleウィンドウで、解答のたびに通知を受信していることを確認します。
[.feature]
--
image::images/jmx-jconsole-mbeans2-sm.png[role="left", link="images/jmx-jconsole-mbeans2.png"]
--
-7. 「属性」ノードをクリックし、属性値が更新されていることを確認します。
+
+[start=7]
+. 「属性」ノードをクリックし、属性値が更新されていることを確認します。
image::images/jmx-jconsole-mbeans3.png[title="AnagramsStatsノードを表示した「MBeans」タブ"]
JConsoleインタフェースとAnagrams Gameを試すことができます。たとえば、管理操作 ``resetAll()`` を起動すると、MBeanの属性値が0にリセットされることがわかります。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_pt_BR.asciidoc
index e4b7d1d..2f3bc33 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_pt_BR.asciidoc
@@ -36,7 +36,7 @@
Este tutorial mostra como adicionar gerenciamento a uma aplicação existente (a aplicação Jogo de Anagramas de amostra do NetBeans). Primeiro você criará um Projeto Java de Anagrama não gerenciável. Depois você usará os Assistentes do JMX para gerar 90% do gerenciamento. Em seguida, você implementará o procedimento de gerenciamento específico da aplicação. Finalmente, você usará a opção Executar/Depurar projeto com JConsole para visualizar o MBeans do Anagrama.
-=== Exercícios do tutorial
+== Exercícios do tutorial
image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.2, 7.3, 7.4 e 8.0"]
@@ -93,12 +93,18 @@
Quando você clica em Finalizar, o IDE cria o projeto Jogo de Anagramas e exibe o projeto na janela Projetos.
-5. Clique com o botão direito do mouse no projeto AnagramGame e selecione Propriedades.
-6. Selecione a categoria Códigos-fonte e confirme se o formato de Código-fonte/Binário está definido como JDK 7 ou JDK 8. Clique em OK.
+
+[start=5]
+. Clique com o botão direito do mouse no projeto AnagramGame e selecione Propriedades.
+
+[start=6]
+. Selecione a categoria Códigos-fonte e confirme se o formato de Código-fonte/Binário está definido como JDK 7 ou JDK 8. Clique em OK.
*Observação.* Para selecionar JDK 7 ou JDK 8, a Plataforma Java do projeto Jogo de Anagramas também deve ser pelo menos JDK 7 ou JKD 8, respectivamente. Você pode alterar a Plataforma Java do Jogo de Anagramas na categoria Bibliotecas na janela Propriedades.
-7. Clique com o botão direito do mouse no nó de projeto Jogo de Anagramas e selecione Executar.
+
+[start=7]
+. Clique com o botão direito do mouse no nó de projeto Jogo de Anagramas e selecione Executar.
Quando escolher Executar, o IDE compilará e acionará a aplicação Jogo de Anagramas.
@@ -113,14 +119,18 @@
2. Escolha Arquivo > Novo Arquivo (Ctrl-N).
3. Na categoria JMX, selecione MBean Padrão. Clique em Próximo.
image::images/jmx-newfile.png[title="Tipo de arquivo MBean Padrão no Assistente Novo Arquivo"]
-4. Digite as seguintes informações no painel Nome e Localização:
+
+[start=4]
+. Digite as seguintes informações no painel Nome e Localização:
* Nome da Classe: ``AnagramsStats``
* Localização: Pacotes de Origem (default)
* Pacote: ``com.toy.anagrams.mbeans``
* Descrição: ``Monitoramento e Gerenciamento do Jogo de Anagramas``
image::images/jmx-newmbean.png[]
-5. Clique em Finalizar.
+
+[start=5]
+. Clique em Finalizar.
Quando você clicar em Finalizar, a classe ``AnagramsStats`` do MBean e a interface ``AnagramsStatsMBean`` do MBean são geradas no pacote ``com.toy.anagrams.mbeans`` do projeto AnagrmGame. Agora há vários esqueletos vazios que você preencherá no próximo exercício.
@@ -147,7 +157,9 @@
*Observação.* Não clique em OK ainda!
-4. Clique em Adicionar Atributo novamente e adicione o seguinte atributo ``NumSolvedAnagrams`` . Clique em OK.
+
+[start=4]
+. Clique em Adicionar Atributo novamente e adicione o seguinte atributo ``NumSolvedAnagrams`` . Clique em OK.
* Nome do Atributo: ``NumSolvedAnagrams``
* Tipo: int
* Acesso: Somente Leitura
@@ -161,8 +173,12 @@
Em seguida, você adicionará mais três atributos para manter controle do tempo mínimo e máximo de reflexão que o usuário leva e do anagrama atual que está sendo proposto ao usuário.
-5. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Adicionar Atributos de MBean* no menu pop-up.
-6. Clique no botão Adicionar Atributo e adicione os seguintes atributos.
+
+[start=5]
+. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Adicionar Atributos de MBean* no menu pop-up.
+
+[start=6]
+. Clique no botão Adicionar Atributo e adicione os seguintes atributos.
|===
|Nome do Atributo |Tipo |Acesso |Descrição
@@ -180,9 +196,15 @@
*Observação.* Observe que os atributos que você já criou estão listados na caixa de diálogo.
-7. Clique em OK e salve suas alterações.
-8. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Adicionar Operações de MBean* no menu pop-up.
-9. Clique em Adicionar Operação e adicione a operação ``resetAll()`` e especifique os seguintes detalhes. Clique em OK.
+
+[start=7]
+. Clique em OK e salve suas alterações.
+
+[start=8]
+. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Adicionar Operações de MBean* no menu pop-up.
+
+[start=9]
+. Clique em Adicionar Operação e adicione a operação ``resetAll()`` e especifique os seguintes detalhes. Clique em OK.
* Nome da Operação: ``resetAll``
* Tipo de Retorno: ``void``
* Parâmetros: (deixe vazia)
@@ -193,8 +215,12 @@
Depois de clicar em OK, você poderá ver se o código necessário para expor a operação ``resetAll`` foi gerado na classe ``AnagramsStats`` do MBean e em sua interface.
-10. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Interface Implementar NotificationEmitter* no menu pop-up.
-11. Especifique os seguintes detalhes na caixa de diálogo Implementar interface NotificationEmitter.
+
+[start=10]
+. Clique com o botão direito do mouse no editor de código-fonte e selecione *JMX > Interface Implementar NotificationEmitter* no menu pop-up.
+
+[start=11]
+. Especifique os seguintes detalhes na caixa de diálogo Implementar interface NotificationEmitter.
* *Selecione Gerar Delegação para Difusor.* Todos os métodos declarados pela interface ``NotificationEmitter`` serão implementados, delegando um difusor de notificação. Um difusor de notificação simplifica a forma em que o MBean enviará notificações.
* *Selecione Gerar Número de Sequência Privada e Acessador.* Um código será gerado para tratar o valor do número de sequência exclusivo que deve ser adicionado a cada notificação enviada.
* *Clique em Adicionar Notificação.* Especifique os detalhes a seguir na tabela Notificações.
@@ -208,7 +234,9 @@
Você pode ver que o código necessário para implementar a interface ``NotificationEmitter`` foi gerado na classe ``AnagramsStats`` do MBean. Você pode ver como a implementação gerada delega o tratamento de notificações para a classe ``NotificationBroadcasterSupport`` .
-12. Salve as alterações.
+
+[start=12]
+. Salve as alterações.
Neste exercício, você aprendeu a adicionar atributos, operações e emissão de notificações a um MBean usando o módulo Assistente JMX. As etapas necessárias para preencher seu MBean com a infraestrutura necessária para expor as informações de gerenciamento que você quer são finalizadas agora. Agora você precisa adicionar uma lógica interna à implementação da classe ``AnagramsStats`` do MBean, em seguida, criar a ponte entre a aplicação MBean e o Jogo de Anagramas.
@@ -232,7 +260,9 @@
numSolvedAnagrams = 0;*
}
----
-3. Você também precisa adicionar algum código de implementação que executará o seguinte:
+
+[start=3]
+. Você também precisa adicionar algum código de implementação que executará o seguinte:
* calcular o tempo de reflexão que o usuário levou para resolve o último anagrama,
* calcular os tempos mínimo e máximo de reflexão,
* incrementar o contador de anagramas resolvidos,
@@ -317,8 +347,12 @@
A classe ``Anagrams`` no pacote ``com.toy.anagrams.ui`` é a classe ``main`` da aplicação de Jogos de Anagramas. O arquivo é aberto na view Design do Editor porque a classe ``Anagrams`` também é a classe da Interface do Usuário.
-2. Clique no botão Código-fonte na parte superior da janela Editor para editar a classe na view Código-fonte.
-3. Adicione o seguinte método privado ``initManagement()`` vazio para a classe ``Anagrams`` : após o construtor ``Anagrams`` .
+
+[start=2]
+. Clique no botão Código-fonte na parte superior da janela Editor para editar a classe na view Código-fonte.
+
+[start=3]
+. Adicione o seguinte método privado ``initManagement()`` vazio para a classe ``Anagrams`` : após o construtor ``Anagrams`` .
[source,java]
----
@@ -332,7 +366,9 @@
}
----
-4. Adicione a seguinte chamada ao método ``initManagement()`` no fim do construtor da classe ``Anagrams`` antes de a chave de fechamento marcar o fim do construtor.
+
+[start=4]
+. Adicione a seguinte chamada ao método ``initManagement()`` no fim do construtor da classe ``Anagrams`` antes de a chave de fechamento marcar o fim do construtor.
[source,java]
----
@@ -352,7 +388,9 @@
--
image:images/jmx-initmanagement-sm.png[role="left", link="images/jmx-initmanagement.png"]
--
-5. Agora vamos adicionar o código de registro do MBean ao método ``initManagement()`` , usando o assistente de registro do MBean do Módulo JMX:
+
+[start=5]
+. Agora vamos adicionar o código de registro do MBean ao método ``initManagement()`` , usando o assistente de registro do MBean do Módulo JMX:
Na janela do editor do código-fonte ``Anagrams.java`` , clique com o botão direito do mouse *no* corpo do método ``initManagement()`` , selecione o submenu JMX e, em seguida, selecione a ação "Gerar Registro de MBean...". No painel "Instanciar e Registrar MBean", que é mostrado acima, mantenha o botão de opção "Registrar MBean Existente" selecionado, clique no botão Procurar ou escolha a classe ``AnagramsStats`` do MBean e clique em OK no painel Procurar. Agora você deverá ver o seguinte:
@@ -376,7 +414,9 @@
Portanto, você precisa fazer as seguintes alterações no código do arquivo ``Anagrams.java`` .
-6. Adicione o seguinte campo privado à classe ``Anagrams`` .
+
+[start=6]
+. Adicione o seguinte campo privado à classe ``Anagrams`` .
[source,java]
----
@@ -385,7 +425,9 @@
private AnagramsStats mbean;
----
-7. Inicialize a referência ao MBean ``AnagramsStats`` no método ``initManagement()`` modificando o código de Registro do MBean gerado, de forma que ele leia o seguinte:
+
+[start=7]
+. Inicialize a referência ao MBean ``AnagramsStats`` no método ``initManagement()`` modificando o código de Registro do MBean gerado, de forma que ele leia o seguinte:
[source,java]
----
@@ -400,7 +442,9 @@
*ex.printStackTrace();*
}
----
-8. Inicialize o estado ``AnagramsStats`` do MBean: quando a aplicação Jogo de Anagramas é iniciada, um anagrama é exibido imediatamente. Assim, é necessário informar ao MBean o valor da string do anagrama e começar a calcular o tempo de reflexão. Copie e cole as linhas abaixo no fim do método ``initManagement()`` :
+
+[start=8]
+. Inicialize o estado ``AnagramsStats`` do MBean: quando a aplicação Jogo de Anagramas é iniciada, um anagrama é exibido imediatamente. Assim, é necessário informar ao MBean o valor da string do anagrama e começar a calcular o tempo de reflexão. Copie e cole as linhas abaixo no fim do método ``initManagement()`` :
[source,java]
----
@@ -421,7 +465,9 @@
Agora você precisa adicionar o código para rastrear a experiência do usuário na resolução do anagrama.
-9. Localize o método ``nextTrialActionPerformed()`` e cole o seguinte código no fim do método ``nextTrialActionPerformed()`` .
+
+[start=9]
+. Localize o método ``nextTrialActionPerformed()`` e cole o seguinte código no fim do método ``nextTrialActionPerformed()`` .
[source,java]
----
@@ -435,7 +481,9 @@
Cada vez que um novo anagrama é proposto ao usuário, o código informa ao MBean qual é o anagrama e começa a contar o tempo de reflexão do usuário.
-10. Localize o método ``guessedWordActionPerformed()`` e adicione as seguintes linhas ao código. Salve as alterações.
+
+[start=10]
+. Localize o método ``guessedWordActionPerformed()`` e adicione as seguintes linhas ao código. Salve as alterações.
[source,java]
----
@@ -482,20 +530,32 @@
*Observações.* É possível que você veja uma advertência de Falha de Conexão na Console de Monitoramento e Gerenciamento Java quando a console tenta estabelecer conexão com o processo do Jogo de Anagramas. Neste tutorial, você pode clicar em Não Seguro quando solicitado a autorizar a conexão.
-2. Selecione a guia MBeans na janela JConsole.
-3. No layout da árvore no painel esquerdo, expanda todos os nós em ``com.toy.anagrams.mbeans`` .
+
+[start=2]
+. Selecione a guia MBeans na janela JConsole.
+
+[start=3]
+. No layout da árvore no painel esquerdo, expanda todos os nós em ``com.toy.anagrams.mbeans`` .
image::images/jmx-jconsole-mbeans1.png[title="Guia MBeans que mostra o nó AnagramsStats"]
-4. Selecione o nó Notificações e clique no botão Assinar na parte inferior, de forma que o JConsole recebem uma nova notificação cada vez que um anagrama é resolvido.
-5. Na janela Jogo de Anagramas, resolva os primeiros três ou quatro anagramas.
+
+[start=4]
+. Selecione o nó Notificações e clique no botão Assinar na parte inferior, de forma que o JConsole recebem uma nova notificação cada vez que um anagrama é resolvido.
+
+[start=5]
+. Na janela Jogo de Anagramas, resolva os primeiros três ou quatro anagramas.
As soluções para os anagramas (abstração, ambíguos, aritmética, barra invertida,...) estão contidas na classe ``WordLibrary`` .
-6. Na janela JConsole observe que ela recebeu notificações para cada uma das soluções.
+
+[start=6]
+. Na janela JConsole observe que ela recebeu notificações para cada uma das soluções.
[.feature]
--
image::images/jmx-jconsole-mbeans2-sm.png[role="left", link="images/jmx-jconsole-mbeans2.png"]
--
-7. Clique no nó Atributos e observe que os valores do atributo estão atualizados:
+
+[start=7]
+. Clique no nó Atributos e observe que os valores do atributo estão atualizados:
image::images/jmx-jconsole-mbeans3.png[title="Guia MBeans que mostra o nó AnagramsStats"]
Você pode experimentar a interface JConsole e o Jogo de Anagramas. Por exemplo, se você chamar a operação de gerenciamento ``resetAll()`` verá que os valores do atributo do MBean são redefinidos como 0.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ru.asciidoc
index bc8fa16..560c2ed 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_ru.asciidoc
@@ -36,7 +36,7 @@
Это руководство содержит инструкции по добавлению функций управления в существующее приложение (образец игрового приложения Anagrams в NetBeans). Сначала необходимо создать неуправляемый Java-проект Anagram. Затем с помощью мастеров JMX создается 90% функций управления. После этого реализуется управляющее поведение, специфичное для данного приложения. Наконец, осуществляется виртуализация Anagram MBeans с помощью функции 'Выполнение/отладка проекта' в консоли JConsole.
-=== Упражнения по темам руководства
+== Упражнения по темам руководства
image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 7.2, 7.3, 7.4 и 8.0"]
@@ -94,12 +94,18 @@
При нажатии на кнопку 'Готово' IDE создает проект Anagram Game, который отображается в окне 'Проекты'.
-5. Щелкните проект AnagramGame правой кнопкой мыши и выберите 'Свойства'.
-6. Выберите категорию 'Исходные файлы' и убедитесь, что в качестве формата исходных/двоичных файлов выбран JDK 7 или JDK 8. Нажмите OK.
+
+[start=5]
+. Щелкните проект AnagramGame правой кнопкой мыши и выберите 'Свойства'.
+
+[start=6]
+. Выберите категорию 'Исходные файлы' и убедитесь, что в качестве формата исходных/двоичных файлов выбран JDK 7 или JDK 8. Нажмите OK.
*Примечание.* Возможность выбора JDK 7 или JDK 8 доступна, если проект AnagramGame создан на платформе Java соответствующей версии (JDK 7 или JDK 8). Версию платформы Java для проекта AnagramGame можно изменить в категории 'Библиотеки' в окне 'Свойства'.
-7. Щелкните узел проекта Anagram Game правой кнопкой мыши и выберите 'Выполнить'.
+
+[start=7]
+. Щелкните узел проекта Anagram Game правой кнопкой мыши и выберите 'Выполнить'.
При выборе команды 'Выполнить' IDE осуществляет сборку и запуск приложения Anagram.
@@ -114,14 +120,18 @@
2. Выберите Файл> Создать файл (Ctrl-N).
3. В категории JMX выберите Standard MBean. Нажмите кнопку "Далее".
image::images/jmx-newfile.png[title="Тип файла Standard MBean в мастере создания файлов"]
-4. На панели 'Имя и местоположение' введите следующие данные:
+
+[start=4]
+. На панели 'Имя и местоположение' введите следующие данные:
* Имя класса: ``AnagramsStats``
* Местоположение: Исходные пакеты (по умолчанию)
* Пакет: ``com.toy.anagrams.mbeans``
* Описание: ``Мониторинг и управление для Anagrams Game``
image::images/jmx-newmbean.png[]
-5. Нажмите 'Готово'.
+
+[start=5]
+. Нажмите 'Готово'.
При нажатии на кнопку 'Готово' создаются класс MBean ``AnagramsStats`` и интерфейс MBean ``AnagramsStatsMBean`` в пакете ``com.toy.anagrams.mbeans`` проекта AnagramGame. Теперь у вас есть несколько пустых скелетов, которые вы заполните данными в следующем упражнении.
@@ -148,7 +158,9 @@
*Примечание.* Не нажимайте кнопку OK!
-4. Нажмите кнопку 'Добавить атрибут' еще раз и добавьте атрибут ``NumSolvedAnagrams`` . Нажмите OK.
+
+[start=4]
+. Нажмите кнопку 'Добавить атрибут' еще раз и добавьте атрибут ``NumSolvedAnagrams`` . Нажмите OK.
* Имя атрибута: ``NumSolvedAnagrams``
* Тип: int
* Доступ: ReadOnly
@@ -162,8 +174,12 @@
Теперь необходимо добавить еще несколько атрибутов для отслеживания минимального и максимального затраченного времени и текущей анаграммы, которая отображается для пользователя.
-5. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Добавить атрибуты MBean* в контекстном меню.
-6. Нажмите кнопку 'Добавить атрибут' и добавьте следующие атрибуты.
+
+[start=5]
+. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Добавить атрибуты MBean* в контекстном меню.
+
+[start=6]
+. Нажмите кнопку 'Добавить атрибут' и добавьте следующие атрибуты.
|===
|Имя атрибута |Тип |Доступ |Описание
@@ -181,9 +197,15 @@
*Примечание.* Обратите внимание, что в диалоговом окне отображается список уже созданных атрибутов.
-7. Нажмите ОК, чтобы сохранить изменения.
-8. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Добавить операции MBean* в контекстном меню.
-9. Нажмите кнопку 'Добавить операцию', добавьте операцию ``resetAll()`` и укажите следующие данные. Нажмите OK.
+
+[start=7]
+. Нажмите ОК, чтобы сохранить изменения.
+
+[start=8]
+. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Добавить операции MBean* в контекстном меню.
+
+[start=9]
+. Нажмите кнопку 'Добавить операцию', добавьте операцию ``resetAll()`` и укажите следующие данные. Нажмите OK.
* Имя операции: ``resetAll``
* Тип возвращаемого значения: ``void``
* Параметры: (оставьте это поле пустым)
@@ -194,8 +216,12 @@
После нажатия на кнопку ОК код, необходимый для предоставления операции ``resetAll`` , будет создан как в классе MBean ``AnagramsStats`` , так и в его интерфейсе.
-10. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Реализовать интерфейс NotificationEmitter* в контекстном меню.
-11. В диалоговом окне 'Реализация интерфейса NotificationEmitter' введите следующие данные.
+
+[start=10]
+. Щелкните в редакторе правой кнопкой мыши и выберите *JMX > Реализовать интерфейс NotificationEmitter* в контекстном меню.
+
+[start=11]
+. В диалоговом окне 'Реализация интерфейса NotificationEmitter' введите следующие данные.
* *Выберите параметр 'Создать делегирование для транслятора'.* Все методы, объявленные интерфейсом ``NotificationEmitter`` , будут реализованы путем делегирования транслятору уведомлений. Транслятор уведомлений упрощает отправку уведомлений компонентом MBean.
* *Выберите параметр 'Создать частный порядковый номер и модификатор'.* Будет создан код для обработки уникального значения порядкового номера, который будет присваиваться каждому отправленному уведомлению.
* *Нажмите 'Добавить уведомление'.* В таблице 'Уведомления' укажите следующие данные.
@@ -209,7 +235,9 @@
Код, необходимый для реализации интерфейса ``NotificationEmitter`` , будет создан в классе MBean ``AnagramsStats`` . Как видите, созданная реализация делегирует обработку уведомлений классу ``NotificationBroadcasterSupport`` .
-12. Сохраните изменения.
+
+[start=12]
+. Сохраните изменения.
Выполнив это упражнение, вы научились добавлять атрибуты, операции и функцию отправки уведомлений в компонент MBean с помощью модуля JMX Wizard. Этап заполнения скелета MBean функциональными элементами, необходимыми для предоставления управляющих данных, завершен. Теперь необходимо добавить внутреннюю логику в реализацию класса MBean ``AnagramsStats`` и установить связь между компонентом MBean и приложением Anagram.
@@ -233,7 +261,9 @@
numSolvedAnagrams = 0;*
}
----
-3. Также потребуется код реализации, который будет выполнять следующие действия:
+
+[start=3]
+. Также потребуется код реализации, который будет выполнять следующие действия:
* вычислять время, затраченное пользователем на расшифровку последней анаграммы;
* вычислять минимальное и максимальное затраченное время;
* увеличивать значение счетчика на 1 при расшифровке очередной анаграммы,
@@ -318,8 +348,12 @@
Класс ``Anagrams`` в пакете ``com.toy.anagrams.ui`` является ``основным`` классом приложения Anagram. Файл открывается в режиме конструирования, так как класс ``Anagrams`` также является классом пользовательского интерфейса.
-2. Нажмите кнопку 'Исходный код' в верхней части окна редактора, чтобы открыть класс в режиме редактирования исходного кода.
-3. Добавьте пустой частный метод ``initManagement()`` в класс ``Anagrams`` после конструктора ``Anagrams`` .
+
+[start=2]
+. Нажмите кнопку 'Исходный код' в верхней части окна редактора, чтобы открыть класс в режиме редактирования исходного кода.
+
+[start=3]
+. Добавьте пустой частный метод ``initManagement()`` в класс ``Anagrams`` после конструктора ``Anagrams`` .
[source,java]
----
@@ -333,7 +367,9 @@
}
----
-4. Добавьте следующий вызов метода ``initManagement()`` в конструктор класса ``Anagrams`` перед закрывающей фигурной скобкой, обозначающей конец конструктора.
+
+[start=4]
+. Добавьте следующий вызов метода ``initManagement()`` в конструктор класса ``Anagrams`` перед закрывающей фигурной скобкой, обозначающей конец конструктора.
[source,java]
----
@@ -353,7 +389,9 @@
--
image:images/jmx-initmanagement-sm.png[role="left", link="images/jmx-initmanagement.png"]
--
-5. Теперь необходимо добавить код регистрации MBean в метод ``initManagement()`` с помощью мастера регистрации MBean модуля JMX:
+
+[start=5]
+. Теперь необходимо добавить код регистрации MBean в метод ``initManagement()`` с помощью мастера регистрации MBean модуля JMX:
В файле ``Anagrams.java`` , открытом в редакторе исходного кода, щелкните правой кнопкой мыши *внутри* тела метода ``initManagement()`` , выберите меню JMX и команду 'Создать регистрацию MBean...'. На отобразившейся панели 'Создание экземпляра и регистрация MBean' оставьте выбранным параметр 'Зарегистрировать существующий MBean', нажмите кнопку 'Обзор', выберите класс MBean ``AnagramsStats`` и нажмите ОК на панели 'Обзор'. На экране отобразится следующее:
@@ -377,7 +415,9 @@
Следовательно, нужно внести изменения в файл ``Anagrams.java`` .
-6. Добавьте в класс ``Anagrams`` следующее частное поле.
+
+[start=6]
+. Добавьте в класс ``Anagrams`` следующее частное поле.
[source,java]
----
@@ -386,7 +426,9 @@
private AnagramsStats mbean;
----
-7. Инициализируйте ссылку на MBean ``AnagramsStats`` в методе ``initManagement()`` , изменив созданный код регистрации MBean следующим образом:
+
+[start=7]
+. Инициализируйте ссылку на MBean ``AnagramsStats`` в методе ``initManagement()`` , изменив созданный код регистрации MBean следующим образом:
[source,java]
----
@@ -401,7 +443,9 @@
*ex.printStackTrace();*
}
----
-8. Инициализируйте состояние MBean ``AnagramsStats`` . При запуске приложения Anagrams немедленно отображается анаграмма, поэтому необходимо передать компоненту MBean значение строкового ресурса анаграммы и начать отсчет времени. Скопируйте и вставьте указанные ниже строки в конец метода ``initManagement()`` :
+
+[start=8]
+. Инициализируйте состояние MBean ``AnagramsStats`` . При запуске приложения Anagrams немедленно отображается анаграмма, поэтому необходимо передать компоненту MBean значение строкового ресурса анаграммы и начать отсчет времени. Скопируйте и вставьте указанные ниже строки в конец метода ``initManagement()`` :
[source,java]
----
@@ -422,7 +466,9 @@
Теперь нужно добавить код для контроля результатов расшифровки анаграмм.
-9. Найдите метод ``nextTrialActionPerformed()`` и вставьте следующий код в конец метода ``nextTrialActionPerformed()`` .
+
+[start=9]
+. Найдите метод ``nextTrialActionPerformed()`` и вставьте следующий код в конец метода ``nextTrialActionPerformed()`` .
[source,java]
----
@@ -436,7 +482,9 @@
Каждый раз, когда пользователю предлагается новая анаграмма, код сообщает компоненту MBean, какая это анаграмма, и компонент начинает отсчет времени.
-10. Найдите метод ``guessedWordActionPerformed()`` и добавьте в него следующие строки. Сохраните изменения.
+
+[start=10]
+. Найдите метод ``guessedWordActionPerformed()`` и добавьте в него следующие строки. Сохраните изменения.
[source,java]
----
@@ -483,20 +531,32 @@
*Примечания.* Вы можете увидеть предупреждение о сбое подключения на консоли управления и мониторинга Java при попытке консоли подключиться к процессу Anagram Game. Для этой учебной программы вы можете нажать Ненадежно, когда вам будет предложено разрешить подключение.
-2. В окне JConsole перейдите на вкладку MBeans.
-3. В дереве в левой части окна разверните все узлы в структуре ``com.toy.anagrams.mbeans`` .
+
+[start=2]
+. В окне JConsole перейдите на вкладку MBeans.
+
+[start=3]
+. В дереве в левой части окна разверните все узлы в структуре ``com.toy.anagrams.mbeans`` .
image::images/jmx-jconsole-mbeans1.png[title="Вкладка MBeans с узлом AnagramsStats"]
-4. Выберите узел 'Уведомления' и нажмите кнопку 'Подписаться' в нижней части экрана. Теперь JConsole будет получать уведомления при каждой расшифровке анаграммы.
-5. В окне игры Anagram расшифруйте первые три или четыре анаграммы.
+
+[start=4]
+. Выберите узел 'Уведомления' и нажмите кнопку 'Подписаться' в нижней части экрана. Теперь JConsole будет получать уведомления при каждой расшифровке анаграммы.
+
+[start=5]
+. В окне игры Anagram расшифруйте первые три или четыре анаграммы.
Расшифровки анаграмм (abstraction, ambiguous, arithmetic, backslash...) содержатся в классе ``WordLibrary`` .
-6. В окне JConsole отображаются уведомления, полученные при расшифровке каждой из анаграмм.
+
+[start=6]
+. В окне JConsole отображаются уведомления, полученные при расшифровке каждой из анаграмм.
[.feature]
--
image::images/jmx-jconsole-mbeans2-sm.png[role="left", link="images/jmx-jconsole-mbeans2.png"]
--
-7. Нажмите на узел 'Атрибуты' и обратите внимание на обновленные значения атрибутов:
+
+[start=7]
+. Нажмите на узел 'Атрибуты' и обратите внимание на обновленные значения атрибутов:
image::images/jmx-jconsole-mbeans3.png[title="Вкладка MBeans с узлом AnagramsStats"]
С интерфейсом JConsole и игрой Anagram можно проводить и другие эксперименты. Например, если вызвать управляющую операцию ``resetAll()`` , значения атрибутов MBean будут возвращены к 0.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_zh_CN.asciidoc
index 5e3d15f..8c044de 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/jmx-tutorial_zh_CN.asciidoc
@@ -36,7 +36,7 @@
本教程将向您演示如何将管理添加到现有应用程序（NetBeans 样例 Anagrams Game 应用程序）。首先，您将创建一个不可管理的 Anagram Java 项目。然后，使用 JMX 向导生成 90% 的管理。接下来，实现特定于应用程序的管理行为。最后，结合使用“运行/调试”项目和 JConsole 以可视化 Anagram MBean。
-=== 教程练习
+== 教程练习
image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 7.2、7.3、7.4 和 8.0"]
@@ -93,12 +93,18 @@
单击“完成”后，IDE 将创建 Anagram Game 项目，并在“项目”窗口中显示该项目。
-5. 右键单击 "AnagramGame" 项目，然后选择“属性”。
-6. 选择“源”类别并确认源代码/二进制格式设置为 "JDK 7" 或 "JDK 8"。单击“确定”。
+
+[start=5]
+. 右键单击 "AnagramGame" 项目，然后选择“属性”。
+
+[start=6]
+. 选择“源”类别并确认源代码/二进制格式设置为 "JDK 7" 或 "JDK 8"。单击“确定”。
*注：*要选择 JDK 7 或 JDK 8，AnagramGame 项目的 Java 平台也必须分别至少为 JDK 7 或 JDK 8。可在“属性”窗口的“库”类别中更改 AnagramGame 的 Java 平台。
-7. 右键单击 "Anagram Game" 项目节点并选择“运行”。
+
+[start=7]
+. 右键单击 "Anagram Game" 项目节点并选择“运行”。
选择“运行”后，IDE 将构建并启动 Anagram Game 应用程序。
@@ -113,14 +119,18 @@
2. 选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。
3. 从 "JMX" 类别中选择 "Standard MBean"（标准 MBean）。单击 "Next"（下一步）。
image::images/jmx-newfile.png[title=""New File"（新建文件）向导中的 "Standard MBean"（标准 MBean）文件类型"]
-4. 在 "Name and Location"（名称和位置）面板中输入以下信息：
+
+[start=4]
+. 在 "Name and Location"（名称和位置）面板中输入以下信息：
* 类名： ``AnagramsStats``
* 位置：源包（默认值）
* 包： ``com.toy.anagrams.mbeans``
* 描述： ``Anagram Game 的监视和管理``
image::images/jmx-newmbean.png[]
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
单击 "Finish"（完成）后，将在 AnagramGame 项目的 ``com.toy.anagrams.mbeans`` 包中生成 ``AnagramsStats`` MBean 类和 ``AnagramsStatsMBean`` MBean 接口。这些现在是几个空框架，在下一练习中将进行填充。
@@ -147,7 +157,9 @@
*注：*还不要单击 "OK"（确定）！
-4. 再次单击 "Add Attribute"（添加属性）并添加以下 ``NumSolvedAnagrams`` 属性。单击 "OK"（确定）。
+
+[start=4]
+. 再次单击 "Add Attribute"（添加属性）并添加以下 ``NumSolvedAnagrams`` 属性。单击 "OK"（确定）。
* 属性名： ``NumSolvedAnagrams``
* 类型：int
* 访问权限：ReadOnly
@@ -161,8 +173,12 @@
接下来，将另外添加三个属性以跟踪用户所用的最短和最长思考时间以及当前向用户提供的 Anagram。
-5. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Add MBean Attributes*（JMX > 添加 MBean 属性）。
-6. 单击 "Add Attribute"（添加属性）按钮并添加以下属性。
+
+[start=5]
+. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Add MBean Attributes*（JMX > 添加 MBean 属性）。
+
+[start=6]
+. 单击 "Add Attribute"（添加属性）按钮并添加以下属性。
|===
|属性名 |类型 |访问权限 |描述
@@ -180,9 +196,15 @@
*注：*请注意，此对话框中列出了您已创建的属性。
-7. 单击 "OK"（确定）保存您所做的更改。
-8. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Add MBeans Operations*（JMX > 添加 MBean 操作）。
-9. 单击 "Add Operation"（添加操作），然后添加 ``resetAll()`` 操作并指定以下详细信息。单击 "OK"（确定）。
+
+[start=7]
+. 单击 "OK"（确定）保存您所做的更改。
+
+[start=8]
+. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Add MBeans Operations*（JMX > 添加 MBean 操作）。
+
+[start=9]
+. 单击 "Add Operation"（添加操作），然后添加 ``resetAll()`` 操作并指定以下详细信息。单击 "OK"（确定）。
* 操作名： ``resetAll``
* 返回类型： ``void``
* 参数：（留空）
@@ -193,8 +215,12 @@
单击 "OK"（确定）后，您可以看到在 ``AnagramsStats`` MBean 类及其接口中生成了公开 ``resetAll`` 操作所需的代码。
-10. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Implement NotificationEmitter interface*（JMX > 实现 NotificationEmitter 接口）。
-11. 在 "Implement NotificationEmitter interface"（实现 NotificationEmitter 接口）对话框中指定以下详细信息。
+
+[start=10]
+. 在源代码编辑器中右键单击，然后在弹出菜单中选择 *JMX > Implement NotificationEmitter interface*（JMX > 实现 NotificationEmitter 接口）。
+
+[start=11]
+. 在 "Implement NotificationEmitter interface"（实现 NotificationEmitter 接口）对话框中指定以下详细信息。
* *选择 "Generate Delegation to Broadcaster"（生成到广播器的委托）。*将通过委托到通知广播器来实现 ``NotificationEmitter`` 接口声明的所有方法。通知广播器将简化 MBean 发送通知的方式。
* *选择 "Generate Private Seq Number and Accessor"（生成私有序列号和存取方法）。*将生成一些代码以处理必须添加到发送的每个通知的唯一序列号值。
* *单击 "Add Notification"（添加通知）。*在 "Notifications"（通知）表中指定以下详细信息。
@@ -208,7 +234,9 @@
您可以看到在 ``AnagramsStats`` MBean 类中生成了实现 ``NotificationEmitter`` 接口所需的代码。您可以查看生成的实现如何将通知处理委托到 ``NotificationBroadcasterSupport`` 类。
-12. 保存所做的更改。
+
+[start=12]
+. 保存所做的更改。
在本练习中，您了解了如何使用 JMX 向导模块将属性、操作和发出的通知添加到 MBean 中。现已完成使用所需基础结构填充 MBean 以公开需要的管理信息所需执行的步骤。现在，您需要将内部逻辑添加到 ``AnagramsStats`` MBean 类实现中，然后在 MBean 与 Anagram Game 应用程序之间构建桥。
@@ -232,7 +260,9 @@
numSolvedAnagrams = 0;*
}
----
-3. 您还需要添加将执行以下操作的某种实现代码：
+
+[start=3]
+. 您还需要添加将执行以下操作的某种实现代码：
* 计算用户解决最后一个 Anagram 所用的思考时间，
* 计算最短和最长的思考时间，
* 增加已解决 Anagram 的计数器，
@@ -317,8 +347,12 @@
``com.toy.anagrams.ui`` 包中的 ``Anagrams`` 类是 Anagram Game 应用程序的 ``主`` 类。此文件将在编辑器的设计视图中打开，因为 ``Anagrams`` 类也是用户界面类。
-2. 单击 "Editor"（编辑器）窗口顶部的 "Source"（源）按钮以便在 "Source"（源）视图中编辑该类。
-3. 将以下空的 ``initManagement()`` 私有方法添加到 ``Anagrams`` 类中： ``Anagrams`` 构造函数后。
+
+[start=2]
+. 单击 "Editor"（编辑器）窗口顶部的 "Source"（源）按钮以便在 "Source"（源）视图中编辑该类。
+
+[start=3]
+. 将以下空的 ``initManagement()`` 私有方法添加到 ``Anagrams`` 类中： ``Anagrams`` 构造函数后。
[source,java]
----
@@ -332,7 +366,9 @@
}
----
-4. 将以下对 ``initManagement()`` 方法的调用添加到 ``Anagrams`` 类构造函数结尾，在标记该构造函数结尾的结束花括号之前。
+
+[start=4]
+. 将以下对 ``initManagement()`` 方法的调用添加到 ``Anagrams`` 类构造函数结尾，在标记该构造函数结尾的结束花括号之前。
[source,java]
----
@@ -352,7 +388,9 @@
--
image:images/jmx-initmanagement-sm.png[role="left", link="images/jmx-initmanagement.png"]
--
-5. 现在，我们使用 JMX 模块 MBean 注册向导将 MBean 注册代码添加到 ``initManagement()`` 方法中：
+
+[start=5]
+. 现在，我们使用 JMX 模块 MBean 注册向导将 MBean 注册代码添加到 ``initManagement()`` 方法中：
在 ``Anagrams.java`` 源代码编辑器窗口中，在 ``initManagement()`` 方法主体*内部*右键单击，选择 "JMX" 子菜单，然后选择 "Generate MBean Registration..."（生成 MBean 注册...）操作。在显示的 "Instantiate and Register MBean"（实例化并注册 MBean）面板中，保持 "Register Existing MBean"（注册现有 MBean）单选按钮为选中状态，单击 "Browse"（浏览）按钮，选择 ``AnagramsStats`` MBean 类，然后在 "Browse"（浏览）面板中单击 "OK"（确定）。此时您应该会看到：
@@ -376,7 +414,9 @@
因此，您需要对 ``Anagrams.java`` 文件的代码进行以下更改。
-6. 将以下私有字段添加到 ``Anagrams`` 类中。
+
+[start=6]
+. 将以下私有字段添加到 ``Anagrams`` 类中。
[source,java]
----
@@ -385,7 +425,9 @@
private AnagramsStats mbean;
----
-7. 通过修改生成的 MBean 注册代码，初始化对 ``initManagement()`` 方法中 ``AnagramsStats`` MBean 的引用，使其如下所示：
+
+[start=7]
+. 通过修改生成的 MBean 注册代码，初始化对 ``initManagement()`` 方法中 ``AnagramsStats`` MBean 的引用，使其如下所示：
[source,java]
----
@@ -400,7 +442,9 @@
*ex.printStackTrace();*
}
----
-8. 初始化 ``AnagramsStats`` MBean 状态：当 Anagrams Game 应用程序启动时，将立即显示一个 anagram，因此我们需要向 MBean 传递 anagram 字符串值并开始计算思考时间。在 ``initManagement()`` 方法结尾处复制并粘贴以下行：
+
+[start=8]
+. 初始化 ``AnagramsStats`` MBean 状态：当 Anagrams Game 应用程序启动时，将立即显示一个 anagram，因此我们需要向 MBean 传递 anagram 字符串值并开始计算思考时间。在 ``initManagement()`` 方法结尾处复制并粘贴以下行：
[source,java]
----
@@ -421,7 +465,9 @@
您现在需要添加代码以跟踪用户的 anagram 解决体验。
-9. 找到 ``nextTrialActionPerformed()`` 方法，然后将以下代码粘贴到 ``nextTrialActionPerformed()`` 方法的结尾处。
+
+[start=9]
+. 找到 ``nextTrialActionPerformed()`` 方法，然后将以下代码粘贴到 ``nextTrialActionPerformed()`` 方法的结尾处。
[source,java]
----
@@ -435,7 +481,9 @@
每次向用户提供新的 Anagram 时，该代码就会告知 MBean 是哪一个 Anagram 并开始对用户思考时间进行计数。
-10. 找到 ``guessedWordActionPerformed()`` 方法并将以下行添加到代码中。保存所做的更改。
+
+[start=10]
+. 找到 ``guessedWordActionPerformed()`` 方法并将以下行添加到代码中。保存所做的更改。
[source,java]
----
@@ -482,20 +530,32 @@
*注：*当 Java 监视和管理控制台尝试连接到 Anagram Game 进程时，您可能会在此控制台中看到 "Connection Failed"（连接失败）警告。对于本教程，当系统提示您授权连接时，您可以单击 "Insecure"（不安全）。
-2. 在 JConsole 窗口中选择 "MBean" 标签。
-3. 在左侧窗格的树布局中，展开 ``com.toy.anagrams.mbeans`` 下的所有节点。
+
+[start=2]
+. 在 JConsole 窗口中选择 "MBean" 标签。
+
+[start=3]
+. 在左侧窗格的树布局中，展开 ``com.toy.anagrams.mbeans`` 下的所有节点。
image::images/jmx-jconsole-mbeans1.png[title="显示 "AnagramsStats" 节点的 "MBean" 标签"]
-4. 选择 "Notifications"（通知）节点，然后单击底部的 "Subscribe"（订阅）按钮，这样在 Anagram 每次得到解决时 JConsole 都将会收到新通知。
-5. 在 "Anagrams Game" 窗口中，解决前三个或前四个 Anagram。
+
+[start=4]
+. 选择 "Notifications"（通知）节点，然后单击底部的 "Subscribe"（订阅）按钮，这样在 Anagram 每次得到解决时 JConsole 都将会收到新通知。
+
+[start=5]
+. 在 "Anagrams Game" 窗口中，解决前三个或前四个 Anagram。
Anagram 的解决方案（abstraction、ambiguous、arithmetic、backslash...）包含在 ``WordLibrary`` 类中。
-6. 在 "JConsole" 窗口中，注意它收到了关于每个解决方案的通知。
+
+[start=6]
+. 在 "JConsole" 窗口中，注意它收到了关于每个解决方案的通知。
[.feature]
--
image::images/jmx-jconsole-mbeans2-sm.png[role="left", link="images/jmx-jconsole-mbeans2.png"]
--
-7. 单击 "Attributes"（属性）节点，可以看到更新了属性值：
+
+[start=7]
+. 单击 "Attributes"（属性）节点，可以看到更新了属性值：
image::images/jmx-jconsole-mbeans3.png[title="显示 "AnagramsStats" 节点的 "MBean" 标签"]
您可以试用 JConsole 界面和 Anagrams Game。例如，如果调用管理操作 ``resetAll()`` ，您将会看到 MBean 属性值重置为 0。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/junit-intro.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/junit-intro.asciidoc
index 2773b96..ce0e264 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/junit-intro.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/junit-intro.asciidoc
@@ -65,8 +65,10 @@
--
image::images/projects-window.png[]
--
+
+
[start=4]
-4. Copy the classes ``Utils.java`` and ``Vectors.java`` in the JUnitSampleSol project and paste them into the ``sample`` source package in JUnit-Sample.
+. Copy the classes ``Utils.java`` and ``Vectors.java`` in the JUnitSampleSol project and paste them into the ``sample`` source package in JUnit-Sample.
If you look at the source code for the classes, you can see that ``Utils.java`` has three methods ( ``computeFactorial`` , ``concatWords`` , and ``normalizeWord`` ) and that ``Vectors.java`` has two methods ( ``equal`` and ``scalarMultiplication`` ). The next step is to create test classes for each class and write some test cases for the methods.
@@ -88,15 +90,21 @@
2. Modify the name of the test class to *VectorsJUnit3Test* in the Create Tests dialog.
When you change the name of the test class, you will see a warning about changing the name. The default name is based on the name of the class you are testing, with the word Test appended to the name. For example, for the class ``MyClass.java`` , the default name of the test class is ``MyClassTest.java`` . Usually it is best to keep the default name, but for this tutorial you will change the name because you will also create JUnit 4 tests in the same package and the names of the test classes must be unique.
+
+
[start=3]
-3. Select JUnit in the Framework dropdown list.
-4. Deselect Test Initializer and Test Finalizer. Click OK.
+. Select JUnit in the Framework dropdown list.
+
+[start=4]
+. Deselect Test Initializer and Test Finalizer. Click OK.
[.feature]
--
image::images/junit3-vectors-createtests.png[]
--
+
+
[start=5]
-5. Select JUnit 3.x in the Select JUnit Version dialog box.
+. Select JUnit 3.x in the Select JUnit Version dialog box.
[.feature]
--
image::images/junit3-select-version.png[]
@@ -171,8 +179,10 @@
assertEquals(expResult, result);
}
----
+
+
[start=3]
-3. Now add some assertions to test the method.
+. Now add some assertions to test the method.
[source,java]
----
@@ -188,8 +198,10 @@
----
This test method uses the JUnit ``assertEquals`` method. To use the assertion, you supply the input variables and the expected result. To pass the test, the test method must successfully return all the expected results based on the supplied variables when running the tested method. You should add a sufficient number of assertions to cover the various possible permutations.
+
+
[start=4]
-4. Modify the test skeleton for ``testEqual`` by deleting the generated method bodies and adding the following ``println`` .
+. Modify the test skeleton for ``testEqual`` by deleting the generated method bodies and adding the following ``println`` .
[source,java]
----
@@ -207,8 +219,10 @@
System.out.println("* VectorsJUnit3Test: testEqual()");
}
----
+
+
[start=5]
-5. Modify the ``testEqual`` method by adding the following assertions (displayed in bold).
+. Modify the ``testEqual`` method by adding the following assertions (displayed in bold).
[source,java]
----
@@ -236,8 +250,10 @@
----
This test uses the JUnit ``assertTrue`` and ``assertFalse`` methods to test a variety of possible results. For the test of this method to pass, the ``assertTrue`` must all be true and ``assertFalse`` must all be false.
+
+
[start=6]
-6. Save your changes.
+. Save your changes.
Compare: <<Exercise_32,Writing Test Methods for ``Vectors.java`` (JUnit 4)>>
@@ -292,7 +308,9 @@
2. Add the following method to test the ``concatWords`` method.*public void testHelloWorld() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Add a ``println`` statement to display text about the test in the JUnit Test Results window.
+
+[start=3]
+. Add a ``println`` statement to display text about the test in the JUnit Test Results window.
[source,java]
----
@@ -321,8 +339,12 @@
}
};
}*
-3. Fix your imports to import ``java.util.concurrent.TimeoutException`` .
-4. Add the following code (displayed in bold) to the method to interrupt the thread and display a message if the test takes too long to execute.
+
+[start=3]
+. Fix your imports to import ``java.util.concurrent.TimeoutException`` .
+
+[start=4]
+. Add the following code (displayed in bold) to the method to interrupt the thread and display a message if the test takes too long to execute.
[source,java]
----
@@ -344,8 +366,10 @@
----
You can modify the ``Thread.sleep`` line to change the number of milliseconds before the timeout is thrown.
+
+
[start=5]
-5. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
+. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
[source,java]
----
@@ -371,7 +395,9 @@
} catch (IllegalArgumentException ex) {
}
}*
-2. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
+
+[start=2]
+. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
[source,java]
----
@@ -394,8 +420,10 @@
}*
The test method ``testTemporarilyDisabled`` will run if you run the test class.
+
+
[start=3]
-3. Prepend ``DISABLED_`` (displayed in bold) to the name of the test method.
+. Prepend ``DISABLED_`` (displayed in bold) to the name of the test method.
[source,java]
----
@@ -454,15 +482,21 @@
2. Modify the name of the test class to *VectorsJUnit4Test* in the Create Tests dialog.
When you change the name of the test class, you will see a warning about changing the name. The default name is based on the name of the class you are testing, with the word Test appended to the name. For example, for the class ``MyClass.java`` , the default name of the test class is ``MyClassTest.java`` . Unlike JUnit 3, in JUnit 4, test are not required to end with the word Test. Usually it is best to keep the default name, but because you are creating all the JUnit tests in the same package in this tutorial the names of the test classes have to be unique.
+
+
[start=3]
-3. Select JUnit in the Framework dropdown list.
-4. Deselect Test Initializer and Test Finalizer. Click OK.
+. Select JUnit in the Framework dropdown list.
+
+[start=4]
+. Deselect Test Initializer and Test Finalizer. Click OK.
[.feature]
--
image::images/junit4-vectors-createtests.png[]
--
+
+
[start=5]
-5. Select JUnit 4.x in the Select JUnit Version dialog box. Click Select.
+. Select JUnit 4.x in the Select JUnit Version dialog box. Click Select.
[.feature]
--
image::images/junit4-select-version.png[]
@@ -520,8 +554,10 @@
----
NOTE: When writing tests it is not necessary to change the printed output. You do this in this exercise so that it is easier to identify the test results in the output window.
+
+
[start=3]
-3. Now add some assertions to test the method.
+. Now add some assertions to test the method.
[source,java]
----
@@ -538,10 +574,16 @@
----
In this test method you use the JUnit ``assertEquals`` method. To use the assertion, you supply the input variables and the expected result. To pass the test, the test method must successfully return all the expected results based on the supplied variables when running the tested method. You should add a sufficient number of assertions to cover the various possible permutations.
+
+
[start=4]
-4. Change the name of the ``testEqual`` test method to ``equalsCheck`` .
-5. Delete the the generated method body of the ``equalsCheck`` test method.
-6. Add the following ``println`` to the ``equalsCheck`` test method.*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
+. Change the name of the ``testEqual`` test method to ``equalsCheck`` .
+
+[start=5]
+. Delete the the generated method body of the ``equalsCheck`` test method.
+
+[start=6]
+. Add the following ``println`` to the ``equalsCheck`` test method.*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
The test method should now look like the following:
@@ -554,8 +596,10 @@
System.out.println("* VectorsJUnit4Test: equalsCheck()");
}
----
+
+
[start=7]
-7. Modify the ``equalsCheck`` method by adding the following assertions (displayed in bold).
+. Modify the ``equalsCheck`` method by adding the following assertions (displayed in bold).
[source,java]
----
@@ -657,7 +701,9 @@
public void helloWorldCheck() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Add a ``println`` statement to display text about the test in the JUnit Test Results window.
+
+[start=3]
+. Add a ``println`` statement to display text about the test in the JUnit Test Results window.
[source,java]
----
@@ -683,7 +729,9 @@
System.out.println("computing " + factorialOf + '!');
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-3. Add the following code (displayed in bold) to set the timeout and to interrupt the thread if the method takes too long to execute.
+
+[start=3]
+. Add the following code (displayed in bold) to set the timeout and to interrupt the thread if the method takes too long to execute.
[source,java]
----
@@ -694,8 +742,10 @@
----
You can see that the timeout is set to 1000 milliseconds.
+
+
[start=4]
-4. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
+. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
[source,java]
----
@@ -719,8 +769,10 @@
final int factorialOf = -5;
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
+
+
[start=2]
-2. Add the following property (displayed in bold) to the ``@Test`` annotation to specify that the test is expected to throw ``IllegalArgumentException`` .
+. Add the following property (displayed in bold) to the ``@Test`` annotation to specify that the test is expected to throw ``IllegalArgumentException`` .
[source,java]
----
@@ -731,8 +783,10 @@
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}
----
+
+
[start=3]
-3. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
+. Add the following ``println`` (displayed in bold) to print the text about the test in the JUnit Test Results window.
[source,java]
----
@@ -759,8 +813,10 @@
}*
The test method ``temporarilyDisabledTest`` will run if you run the test class.
+
+
[start=3]
-3. Add the ``@Ignore`` annotation (displayed in bold) above ``@Test`` to disable the test.*@Ignore*
+. Add the ``@Ignore`` annotation (displayed in bold) above ``@Test`` to disable the test.*@Ignore*
[source,java]
----
@@ -771,8 +827,10 @@
assertEquals("Malm\u00f6", Utils.normalizeWord("Malmo\u0308"));
}
----
+
+
[start=4]
-4. Fix your imports to import ``org.junit.Ignore`` .
+. Fix your imports to import ``org.junit.Ignore`` .
Compare: <<Exercise_245,Disabling a Test (JUnit 3)>>
@@ -839,8 +897,10 @@
}
}
----
+
+
[start=6]
-6. Modify the ``suite()`` method to add the test classes that will be run as part of the suite.
+. Modify the ``suite()`` method to add the test classes that will be run as part of the suite.
[source,java]
----
@@ -856,8 +916,10 @@
return suite;
}
----
+
+
[start=7]
-7. Save your changes.
+. Save your changes.
=== Creating JUnit 4 Test Suites
diff --git a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ja.asciidoc
index f37de32..5dddaef 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ja.asciidoc
@@ -83,13 +83,21 @@
2. 「チェックアウト」ダイアログ・ボックスで次のリポジトリURLを入力します。
``https://svn.netbeans.org/svn/samples~samples-source-code``
「次」をクリックします。
-3. 「チェックアウトするフォルダ」パネルで、「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
-4. ルート・ノードを展開し、*samples/java/JUnitSampleSol*を選択します。「OK」をクリックします。
-5. ソースのローカル・フォルダを指定します。「終了」をクリックします。
+
+[start=3]
+. 「チェックアウトするフォルダ」パネルで、「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
+
+[start=4]
+. ルート・ノードを展開し、*samples/java/JUnitSampleSol*を選択します。「OK」をクリックします。
+
+[start=5]
+. ソースのローカル・フォルダを指定します。「終了」をクリックします。
「終了」をクリックすると、IDEではローカル・フォルダがSubversionリポジトリとして初期化され、プロジェクト・ソースがチェックアウトされます。
-6. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
+
+[start=6]
+. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
Subversionのインストールの詳細は、link:../ide/subversion.html[+NetBeans IDEでのSubversionガイド+]のlink:../ide/subversion.html#settingUp[+Subversionの設定+]の項を参照してください。
@@ -104,7 +112,9 @@
2. パッケージ名として「*sample*」と入力します。「終了」をクリックします。
3. *JUnitSampleSol*プロジェクトを開き(まだ開いていない場合)、「プロジェクト」ウィンドウで「ソース・パッケージ」ノードを展開します。
image::images/projects-window.png[title="「プロジェクト」ウィンドウ内のJUnit-SampleおよびJUnitSampleSolプロジェクト"]
-4. JUnitSampleSolプロジェクト内のクラス ``Utils.java`` と ``Vectors.java`` をコピーし、それらをJUnit-Sample内の ``sample`` ソース・パッケージに貼り付けます。
+
+[start=4]
+. JUnitSampleSolプロジェクト内のクラス ``Utils.java`` と ``Vectors.java`` をコピーし、それらをJUnit-Sample内の ``sample`` ソース・パッケージに貼り付けます。
クラスのソース・コードを見ると、 ``Utils.java`` に3つのメソッド( ``computeFactorial`` 、 ``concatWords`` 、および ``normalizeWord`` )があり、 ``Vectors.java`` に2つのメソッド( ``equal`` および ``scalarMultiplication`` )があることがわかります。次の手順では、各クラス用のテスト・クラスを作成し、メソッド用にいくつかのテスト・クラスを記述します。
@@ -129,10 +139,16 @@
テスト・クラスの名前を変更するときは、名前が変更されることを警告するメッセージが表示されます。デフォルト名は、テスト対象のクラス名をベースに、末尾に「Test」を追加したものです。たとえば、 ``MyClass.java`` クラスの場合、テスト・クラスのデフォルト名は「 ``MyClassTest.java`` 」です。通常はデフォルト名をそのまま使用するのが最適ですが、このチュートリアルでは、JUnit 4テストも同じパッケージ内に作成し、テスト・クラスの名前は一意にする必要があるため、名前を変更します。
-3. 「フレームワーク」ドロップダウン・リストで「JUnit」を選択します。
-4. 「テスト初期化」および「テスト終了」を選択解除します。「OK」をクリックします。
+
+[start=3]
+. 「フレームワーク」ドロップダウン・リストで「JUnit」を選択します。
+
+[start=4]
+. 「テスト初期化」および「テスト終了」を選択解除します。「OK」をクリックします。
image::images/junit3-vectors-createtests.png[title="「JUnitのバージョンを選択」ダイアログ・ボックス"]
-5. 「JUnitのバージョンを選択」ダイアログ・ボックスで「JUnit 3.x」を選択します。
+
+[start=5]
+. 「JUnitのバージョンを選択」ダイアログ・ボックスで「JUnit 3.x」を選択します。
image::images/junit3-select-version.png[title="「JUnitのバージョンを選択」ダイアログ・ボックス"]
JUnit 3.xを選択すると、プロジェクトにJUnit 3ライブラリが追加されます。
@@ -204,7 +220,9 @@
assertEquals(expResult, result);
}
----
-3. ここで、メソッドをテストするためのアサーションを追加します。
+
+[start=3]
+. ここで、メソッドをテストするためのアサーションを追加します。
[source,java]
----
@@ -221,7 +239,9 @@
このテスト・メソッドでは、JUnitの ``assertEquals`` メソッドが使用されます。アサーションを使用するには、入力変数と、期待する結果を指定します。テストに合格するには、テスト済メソッドを実行したときに、テスト・メソッドが供給した変数に基づいて、期待されるすべての結果を正常に返す必要があります。様々な考えられる並べ替えを実行するため、十分な数のアサーションを追加するようにしてください。
-4. 生成されたメソッド本体を削除し、次の ``println`` を追加することによって、 ``testEqual`` のテスト・スケルトンを変更します。
+
+[start=4]
+. 生成されたメソッド本体を削除し、次の ``println`` を追加することによって、 ``testEqual`` のテスト・スケルトンを変更します。
[source,java]
----
@@ -239,7 +259,9 @@
System.out.println("* VectorsJUnit3Test: testEqual()");
}
----
-5. 次のアサーションを追加することによって ``testEqual`` メソッドを変更します(太字部分が変更箇所)。
+
+[start=5]
+. 次のアサーションを追加することによって ``testEqual`` メソッドを変更します(太字部分が変更箇所)。
[source,java]
----
@@ -268,7 +290,9 @@
このテストはJUnitの ``assertTrue`` メソッドと ``assertFalse`` メソッドを使用して、考えられる様々な結果をテストします。このメソッドのテストに合格するには、 ``assertTrue`` がすべてtrue、 ``assertFalse`` がすべてfalseである必要があります。
-6. 変更を保存します。
+
+[start=6]
+. 変更を保存します。
比較: <<Exercise_32, ``Vectors.java`` 用のテスト・メソッドの記述(JUnit 4)>>
@@ -331,7 +355,9 @@
2. ``concatWords`` メソッドをテストするため、次のメソッドを追加します。*public void testHelloWorld() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. テストに関するテキストを「JUnitテスト結果」ウィンドウに表示するため、 ``println`` 文を追加します。
+
+[start=3]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに表示するため、 ``println`` 文を追加します。
[source,java]
----
@@ -361,8 +387,12 @@
}
};
}*
-3. ``java.util.concurrent.TimeoutException`` をインポートするために、インポートを修正します。
-4. テストの実行に時間がかかりすぎる場合にスレッドが割込みされてメッセージが表示されるように、次のコード(太字で表示)をメソッドに追加します。
+
+[start=3]
+. ``java.util.concurrent.TimeoutException`` をインポートするために、インポートを修正します。
+
+[start=4]
+. テストの実行に時間がかかりすぎる場合にスレッドが割込みされてメッセージが表示されるように、次のコード(太字で表示)をメソッドに追加します。
[source,java]
----
@@ -385,7 +415,9 @@
タイム・アウトがスローされる前にミリ秒の数字を変更するには、 ``Thread.sleep`` 行を変更します。
-5. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
+
+[start=5]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
[source,java]
----
@@ -412,7 +444,9 @@
} catch (IllegalArgumentException ex) {
}
}*
-2. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
+
+[start=2]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
[source,java]
----
@@ -437,7 +471,9 @@
テスト・クラスを実行すると、テスト・メソッド ``testTemporarilyDisabled`` が実行されます。
-3. テスト・メソッドの名前の先頭に ``DISABLED_`` (太字で表示)を付加します。
+
+[start=3]
+. テスト・メソッドの名前の先頭に ``DISABLED_`` (太字で表示)を付加します。
[source,java]
----
@@ -502,10 +538,16 @@
テスト・クラスの名前を変更するときは、名前が変更されることを警告するメッセージが表示されます。デフォルト名は、テスト対象のクラス名をベースに、末尾に「Test」を追加したものです。たとえば、 ``MyClass.java`` クラスの場合、テスト・クラスのデフォルト名は「 ``MyClassTest.java`` 」です。JUnit 3とは異なり、JUnit 4ではテスト名の末尾に「Test」を付ける必要はありません。通常はデフォルト名をそのまま使用するのが最適ですが、このチュートリアルでは、すべてのJUnitテストを同じパッケージ内に作成するため、テスト・クラスの名前は一意にします。
-3. 「フレームワーク」ドロップダウン・リストで「JUnit」を選択します。
-4. 「テスト初期化」および「テスト終了」を選択解除します。「OK」をクリックします。
+
+[start=3]
+. 「フレームワーク」ドロップダウン・リストで「JUnit」を選択します。
+
+[start=4]
+. 「テスト初期化」および「テスト終了」を選択解除します。「OK」をクリックします。
image::images/junit4-vectors-createtests.png[title="JUnit 4の「テストを作成」ダイアログ・ボックス"]
-5. 「JUnitのバージョンを選択」ダイアログ・ボックスで「JUnit 4.x」を選択します。「選択」をクリックします。
+
+[start=5]
+. 「JUnitのバージョンを選択」ダイアログ・ボックスで「JUnit 4.x」を選択します。「選択」をクリックします。
image::images/junit4-select-version.png[title="「JUnitのバージョンを選択」ダイアログ・ボックス"]
「OK」をクリックすると、IDEによって、「プロジェクト」ウィンドウ内の「テスト・パッケージ」ノードの下にある ``sample`` パッケージ内に ``VectorsJUnit4Test.java`` テスト・クラスが作成されます。
@@ -561,7 +603,9 @@
*注意:*テストを記述する際に、プリントされた出力を変更する必要はありません。これはこの課題で行うため、テスト結果を出力ウィンドウで確認しやすくなります。
-3. ここで、メソッドをテストするためのアサーションを追加します。
+
+[start=3]
+. ここで、メソッドをテストするためのアサーションを追加します。
[source,java]
----
@@ -579,9 +623,15 @@
このテスト・メソッドでは、JUnit ``assertEquals`` メソッドを使用します。アサーションを使用するには、入力変数と、期待する結果を指定します。テストに合格するには、テスト済メソッドを実行したときに、テスト・メソッドが供給した変数に基づいて、期待されるすべての結果を正常に返す必要があります。様々な考えられる並べ替えを実行するため、十分な数のアサーションを追加するようにしてください。
-4. ``testEqual`` テスト・メソッドの名前を ``equalsCheck`` に変更します。
-5. ``equalsCheck`` テスト・メソッドの生成されたメソッドの本文を削除します。
-6. 次の ``println`` を ``equalsCheck`` テスト・メソッドに追加します。*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
+
+[start=4]
+. ``testEqual`` テスト・メソッドの名前を ``equalsCheck`` に変更します。
+
+[start=5]
+. ``equalsCheck`` テスト・メソッドの生成されたメソッドの本文を削除します。
+
+[start=6]
+. 次の ``println`` を ``equalsCheck`` テスト・メソッドに追加します。*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
テスト・メソッドは次のようになるはずです。
@@ -594,7 +644,9 @@
System.out.println("* VectorsJUnit4Test: equalsCheck()");
}
----
-7. 次のアサーション(太字で表示)を追加することによって、 ``equalsCheck`` メソッドを変更します。
+
+[start=7]
+. 次のアサーション(太字で表示)を追加することによって、 ``equalsCheck`` メソッドを変更します。
[source,java]
----
@@ -704,7 +756,9 @@
public void helloWorldCheck() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. テストに関するテキストを「JUnitテスト結果」ウィンドウに表示するため、 ``println`` 文を追加します。
+
+[start=3]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに表示するため、 ``println`` 文を追加します。
[source,java]
----
@@ -731,7 +785,9 @@
System.out.println("computing " + factorialOf + '!');
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-3. タイム・アウトを設定し、メソッドの実行に時間がかかりすぎる場合にスレッドが割込みされるようにするには、次のコード(太字で表示)を追加します。
+
+[start=3]
+. タイム・アウトを設定し、メソッドの実行に時間がかかりすぎる場合にスレッドが割込みされるようにするには、次のコード(太字で表示)を追加します。
[source,java]
----
@@ -743,7 +799,9 @@
タイム・アウトが1000ミリ秒に設定されていることがわかります。
-4. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
+
+[start=4]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
[source,java]
----
@@ -768,7 +826,9 @@
final int factorialOf = -5;
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-2. テストが ``IllegalArgumentException`` をスローするように指定するには、次のプロパティ(太字で表示)を ``@Test`` 注釈に追加します。
+
+[start=2]
+. テストが ``IllegalArgumentException`` をスローするように指定するには、次のプロパティ(太字で表示)を ``@Test`` 注釈に追加します。
[source,java]
----
@@ -779,7 +839,9 @@
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}
----
-3. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
+
+[start=3]
+. テストに関するテキストを「JUnitテスト結果」ウィンドウに出力するには、次の ``println`` (太字で表示)を追加します。
[source,java]
----
@@ -808,7 +870,9 @@
テスト・クラスを実行すると、テスト・メソッド ``temporarilyDisabledTest`` が実行されます。
-3. テストを無効にするには、 ``@Test`` の上に ``@Ignore`` 注釈(太字で表示)を追加します。*@Ignore*
+
+[start=3]
+. テストを無効にするには、 ``@Test`` の上に ``@Ignore`` 注釈(太字で表示)を追加します。*@Ignore*
[source,java]
----
@@ -819,7 +883,9 @@
assertEquals("Malm\u00f6", Utils.normalizeWord("Malmo\u0308"));
}
----
-4. ``org.junit.Ignore`` をインポートするために、インポートを修正します。
+
+[start=4]
+. ``org.junit.Ignore`` をインポートするために、インポートを修正します。
比較: <<Exercise_245,テストの無効化(JUnit 3)>>
@@ -891,7 +957,9 @@
}
}
----
-6. ``suite()`` メソッドを変更して、このスイートの一部として実行されるテスト・クラスを追加します。
+
+[start=6]
+. ``suite()`` メソッドを変更して、このスイートの一部として実行されるテスト・クラスを追加します。
[source,java]
----
@@ -907,7 +975,9 @@
return suite;
}
----
-7. 変更を保存します。
+
+[start=7]
+. 変更を保存します。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_pt_BR.asciidoc
index 8debb46..dcf9c72 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_pt_BR.asciidoc
@@ -83,13 +83,21 @@
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. No painel Pastas para Checkout, clique em Procurar para abrir a caixa de diálogo Procurar Pastas do Repositório.
-4. Expanda o nó raiz e selecione *samples/java/JUnitSampleSol*. Clique em OK.
-5. Especifique a Pasta Local dos códigos-fonte. Clique em Finalizar.
+
+[start=3]
+. No painel Pastas para Checkout, 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/JUnitSampleSol*. Clique em OK.
+
+[start=5]
+. Especifique a Pasta Local dos códigos-fonte. 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.
-6. Clique em Abrir Projeto na caixa de diálogo exibida quando o check-out for concluído.
+
+[start=6]
+. Clique em Abrir Projeto na caixa de diálogo exibida quando o check-out for concluído.
Para saber mais sobre a instalação 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+].
@@ -104,7 +112,9 @@
2. Insira *sample* como nome do pacote. Clique em Finalizar.
3. Abra o projeto *JUnitSampleSol* (se já não estiver aberto) e expanda o nó Pacotes de código-fonte na janela Projetos.
image::images/projects-window.png[title="Projetos -junit Amostra e junitsamplesol na janela Projetos"]
-4. Copie as classes ``Utils.java`` e ``Vectors.java`` no projeto JUnitSampleSol, e cole-as no pacote de código-fonte ``sample`` no JUnit-Sample.
+
+[start=4]
+. Copie as classes ``Utils.java`` e ``Vectors.java`` no projeto JUnitSampleSol, e cole-as no pacote de código-fonte ``sample`` no JUnit-Sample.
Se você observar o código-fonte das classes, perceberá que ``Utils.java`` tem três métodos ( ``computeFactorial`` , ``concatWords`` e ``normalizeWord`` ) e que ``Vectors.java`` tem dois métodos ( ``equals`` e ``scalarMultiplication`` ). O próximo passo é criar classes de teste para cada classe e escrever alguns casos de teste para os métodos.
@@ -129,10 +139,16 @@
Quando você alterar o nome da classe de teste, será exibido uma advertência sobre a alteração do nome. O nome default é baseado no nome da classe que você está testando, com a palavra Teste acrescentada ao nome. Por exemplo, para a classe ``MyClass.java`` , o nome default da classe de teste é ``MyClassTest.java`` . Normalmente, é melhor manter o nome default, mas para a finalidade deste tutorial você mudará o nome porque também irá criar testes JUnit 4 no mesmo pacote e os nomes das classes de teste devem ser únicos.
-3. Selecione JUnit na lista drop-down Framework.
-4. Desmarque Inicializador de Teste e Finalizador de Teste. Clique em OK.
+
+[start=3]
+. Selecione JUnit na lista drop-down Framework.
+
+[start=4]
+. Desmarque Inicializador de Teste e Finalizador de Teste. Clique em OK.
image::images/junit3-vectors-createtests.png[title="Selecione caixa de diálogo versão JUnit"]
-5. Selecione JUnit 3.x na caixa de diálogo Versão da JUnit.
+
+[start=5]
+. Selecione JUnit 3.x na caixa de diálogo Versão da JUnit.
image::images/junit3-select-version.png[title="Selecione caixa de diálogo versão JUnit"]
Quando você seleciona a JUnit 3.x, o IDE adiciona a biblioteca JUnit 3 ao projeto.
@@ -204,7 +220,9 @@
assertEquals(expResult, result);
}
----
-3. Agora adicione algumas asserções para testar o método.
+
+[start=3]
+. Agora adicione algumas asserções para testar o método.
[source,java]
----
@@ -221,7 +239,9 @@
Este método de teste usa o método ``assertEquals`` da JUnit. Para usar a asserção, forneça as variáveis de entrada e o resultado esperado. Para passar no teste, o método de teste deve retornar de modo bem-sucedido todos os resultados esperados com base nas variáveis fornecidas durante a execução do método. Você deve adicionar um número suficiente de asserções para abranger as várias permutações possíveis.
-4. Modifique o esqueleto de teste para ``testEqual`` deletando os corpos de método gerados e adicionando a seguinte ``println`` .
+
+[start=4]
+. Modifique o esqueleto de teste para ``testEqual`` deletando os corpos de método gerados e adicionando a seguinte ``println`` .
[source,java]
----
@@ -239,7 +259,9 @@
System.out.println("* VectorsJUnit3Test: testEqual()");
}
----
-5. Modifique o método ``testEqual`` adicionando as seguintes asserções (exibidas em negrito).
+
+[start=5]
+. Modifique o método ``testEqual`` adicionando as seguintes asserções (exibidas em negrito).
[source,java]
----
@@ -268,7 +290,9 @@
O teste usa os métodos ``assertTrue`` e ``assertFalse`` da JUnit para testar vários resultados possíveis. Para que o teste deste método seja aprovado, o ``assertTrue`` deve ser totalmente verdadeiro e ``assertFalse`` deve ser totalmente falso.
-6. Salve as alterações.
+
+[start=6]
+. Salve as alterações.
Compare: <<Exercise_32,Escrevendo Métodos de Teste para ``Vectors.java`` (JUnit 4)>>
@@ -331,7 +355,9 @@
2. Adicione o método a seguir para testar o método ``concatWords`` .*public void testHelloWorld() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Adicione uma instrução ``println`` para exibir o texto sobre o teste na janela Resultados de Testes JUnit.
+
+[start=3]
+. Adicione uma instrução ``println`` para exibir o texto sobre o teste na janela Resultados de Testes JUnit.
[source,java]
----
@@ -361,8 +387,12 @@
}
};
}*
-3. Corrija suas importações para importar ``java.util.concurrent.TimeoutException`` .
-4. Adicione o código a seguir (exibido em negrito) para que o método interrompa o thread e exiba uma mensagem se o teste levar muito tempo para ser executado.
+
+[start=3]
+. Corrija suas importações para importar ``java.util.concurrent.TimeoutException`` .
+
+[start=4]
+. Adicione o código a seguir (exibido em negrito) para que o método interrompa o thread e exiba uma mensagem se o teste levar muito tempo para ser executado.
[source,java]
----
@@ -385,7 +415,9 @@
Você pode modificar a linha ``Thread.sleep`` para alterar o número de milissegundos antes que o time-out seja lançado.
-5. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
+
+[start=5]
+. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
[source,java]
----
@@ -412,7 +444,9 @@
} catch (IllegalArgumentException ex) {
}
}*
-2. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
+
+[start=2]
+. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
[source,java]
----
@@ -437,7 +471,9 @@
O método de teste ``testTemporarilyDisabled`` será executado se você executar a classe de teste.
-3. Acrescente o prefixo ``DISABLED_`` (exibido em negrito) ao nome do método de teste.
+
+[start=3]
+. Acrescente o prefixo ``DISABLED_`` (exibido em negrito) ao nome do método de teste.
[source,java]
----
@@ -502,10 +538,16 @@
Quando você alterar o nome da classe de teste, será exibido uma advertência sobre a alteração do nome. O nome default é baseado no nome da classe que você está testando, com a palavra Teste acrescentada ao nome. Por exemplo, para a classe ``MyClass.java`` , o nome default da classe de teste é ``MyClassTest.java`` . Diferente da JUnit 3, na JUnit 4, o teste não precisa ser finalizado com a palavra Teste. Normalmente, é melhor manter o nome default, porém, como você está criando todos os testes da JUnit no mesmo pacote neste tutorial, os nomes das classes de teste devem ser exclusivos.
-3. Selecione JUnit na lista drop-down Framework.
-4. Desmarque Inicializador de Teste e Finalizador de Teste. Clique em OK.
+
+[start=3]
+. Selecione JUnit na lista drop-down Framework.
+
+[start=4]
+. Desmarque Inicializador de Teste e Finalizador de Teste. Clique em OK.
image::images/junit4-vectors-createtests.png[title="Caixa de diálogo Criar Testes JUnit 4"]
-5. Selecione a JUnit 4.x na caixa de diálogo Selecionar a Versão da JUnit. Clique em Selecionar.
+
+[start=5]
+. Selecione a JUnit 4.x na caixa de diálogo Selecionar a Versão da JUnit. Clique em Selecionar.
image::images/junit4-select-version.png[title="Selecione caixa de diálogo versão JUnit"]
Quando você clica em OK, o IDE cria a classe de teste ``VVectorsJUnit4Test.java`` no pacote ``sample`` no nó Pacotes de Teste, na janela Projetos.
@@ -561,7 +603,9 @@
*Observação.* Ao escrever testes, não é necessário alterar a saída impressa. Isso é realizado neste exercício, portanto é mais fácil identificar os resultados de teste na janela de saída.
-3. Agora adicione algumas asserções para testar o método.
+
+[start=3]
+. Agora adicione algumas asserções para testar o método.
[source,java]
----
@@ -579,9 +623,15 @@
Neste método de teste, você usa o método ``assertEquals`` da JUnit. Para usar a asserção, forneça as variáveis de entrada e o resultado esperado. Para passar no teste, o método de teste deve retornar de modo bem-sucedido todos os resultados esperados com base nas variáveis fornecidas durante a execução do método. Você deve adicionar um número suficiente de asserções para abranger as várias permutações possíveis.
-4. Altere o nome do método de teste ``testEqual`` para ``equalsCheck`` .
-5. Delete o corpo do método gerado do método de teste ``equalsCheck`` .
-6. Adicione o seguinte ``println`` ao método de teste ``equalsCheck`` .*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
+
+[start=4]
+. Altere o nome do método de teste ``testEqual`` para ``equalsCheck`` .
+
+[start=5]
+. Delete o corpo do método gerado do método de teste ``equalsCheck`` .
+
+[start=6]
+. Adicione o seguinte ``println`` ao método de teste ``equalsCheck`` .*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
O método de teste deve ser semelhante a:
@@ -594,7 +644,9 @@
System.out.println("* VectorsJUnit4Test: equalsCheck()");
}
----
-7. Modifique o método ``equalsCheck`` adicionando as asserções a seguir (exibidas em negrito).
+
+[start=7]
+. Modifique o método ``equalsCheck`` adicionando as asserções a seguir (exibidas em negrito).
[source,java]
----
@@ -704,7 +756,9 @@
public void helloWorldCheck() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Adicione uma instrução ``println`` para exibir o texto sobre o teste na janela Resultados de Testes JUnit.
+
+[start=3]
+. Adicione uma instrução ``println`` para exibir o texto sobre o teste na janela Resultados de Testes JUnit.
[source,java]
----
@@ -731,7 +785,9 @@
System.out.println("computing " + factorialOf + '!');
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-3. Adicione o código a seguir (exibido em negrito) para definir o time-out e para interromper o thread se o método demorar muito tempo para ser executado.
+
+[start=3]
+. Adicione o código a seguir (exibido em negrito) para definir o time-out e para interromper o thread se o método demorar muito tempo para ser executado.
[source,java]
----
@@ -743,7 +799,9 @@
Você pode observar que o time-out foi definido como 1000 milissegundos.
-4. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
+
+[start=4]
+. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
[source,java]
----
@@ -768,7 +826,9 @@
final int factorialOf = -5;
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-2. Adicione a propriedade a seguir (exibida em negrito) à anotação ``@Test`` para especificar que se espera que o teste lance a ``IllegalArgumentException`` .
+
+[start=2]
+. Adicione a propriedade a seguir (exibida em negrito) à anotação ``@Test`` para especificar que se espera que o teste lance a ``IllegalArgumentException`` .
[source,java]
----
@@ -779,7 +839,9 @@
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}
----
-3. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
+
+[start=3]
+. Adicione a seguinte ``println`` (exibida em negrito) para imprimir o texto sobre o teste na janela Resultados dos Testes JUnit.
[source,java]
----
@@ -808,7 +870,9 @@
O método de teste ``temporarilyDisabledTest`` será executado se você executar a classe de teste.
-3. Adicione a anotação ``@Ignore`` (exibida em negrito) acima de ``@Test`` para desativar o teste.*@Ignore*
+
+[start=3]
+. Adicione a anotação ``@Ignore`` (exibida em negrito) acima de ``@Test`` para desativar o teste.*@Ignore*
[source,java]
----
@@ -819,7 +883,9 @@
assertEquals("Malm\u00f6", Utils.normalizeWord("Malmo\u0308"));
}
----
-4. Corrija as importações para importar a ``org.junit.Ignore`` .
+
+[start=4]
+. Corrija as importações para importar a ``org.junit.Ignore`` .
Compare: <<Exercise_245,Desativando um Teste (JUnit 3)>>
@@ -891,7 +957,9 @@
}
}
----
-6. Modifique o método ``suite()`` para adicionar as classes de teste que serão executadas como parte do conjunto.
+
+[start=6]
+. Modifique o método ``suite()`` para adicionar as classes de teste que serão executadas como parte do conjunto.
[source,java]
----
@@ -907,7 +975,9 @@
return suite;
}
----
-7. Salve as alterações.
+
+[start=7]
+. Salve as alterações.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ru.asciidoc
index 2f928c3..1e7f82e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_ru.asciidoc
@@ -83,13 +83,21 @@
2. В диалоговом окне "Проверка" введите следующий URL-адрес репозитория:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Нажмите кнопку "Далее".
-3. В папках на панели "Взятие для изменения" нажмите кнопку "Обзор", чтобы открыть диалоговое окно "Обзор папок репозитория".
-4. Разверните корневой узел и выберите *samples/java/JUnitSampleSol*. Нажмите кнопку "ОК".
-5. Укажите локальную папку для исходных файлов. Нажмите кнопку "Завершить".
+
+[start=3]
+. В папках на панели "Взятие для изменения" нажмите кнопку "Обзор", чтобы открыть диалоговое окно "Обзор папок репозитория".
+
+[start=4]
+. Разверните корневой узел и выберите *samples/java/JUnitSampleSol*. Нажмите кнопку "ОК".
+
+[start=5]
+. Укажите локальную папку для исходных файлов. Нажмите кнопку "Завершить".
После нажатия кнопки "Готово" среда IDE инициализирует локальную папку в качестве репозитория Subversion и выполняет проверку исходных файлов проекта на выходе.
-6. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
+
+[start=6]
+. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
Дополнительные сведения об установке Subversion см. в разделе link:../ide/subversion.html#settingUp[+Настройка Subversion+] в link:../ide/subversion.html[+Руководстве по Subversion в IDE NetBeans+].
@@ -104,7 +112,9 @@
2. Введите *sample* в качестве имени пакета. Нажмите кнопку "Завершить".
3. Откройте проект *JUnitSampleSol* (если он еще не открыт) и разверните узел "Пакеты исходных файлов" в окне проектов.
image::images/projects-window.png[title="Проекты JUnit-Sample и JUnitSampleSol в окне 'Проекты'"]
-4. Скопируйте файлы классов ``Utils.java`` и ``Vectors.java`` из проекта JUnitSampleSol в пакет исходного кода ``sample`` в JUnit-Sample.
+
+[start=4]
+. Скопируйте файлы классов ``Utils.java`` и ``Vectors.java`` из проекта JUnitSampleSol в пакет исходного кода ``sample`` в JUnit-Sample.
Если открыть исходный код этих классов, можно заметить, что класс ``Utils.java`` содержит три метода ( ``computeFactorial`` , ``concatWords`` и ``normalizeWord`` ), а класс ``Vectors.java`` — два ( ``equal`` ``scalarMultiplication`` ). В следующем действии будут созданы тестовые классы для каждого класса и написаны тестовые примеры для методов.
@@ -129,10 +139,16 @@
В результате изменения имени тестового класса появится предупреждение об изменении имени. Имя по умолчанию – это имя тестируемого класса с добавленным словом "Test". Например, для класса ``MyClass.java`` именем по умолчанию тестового класса будет ``MyClassTest.java`` . Рекомендуется сохранить имя по умолчанию, но в рамках данного руководства имя будет изменено, так как в этом же пакете будут созданы тесты JUnit 4, а имена тестовых классов должны быть различными.
-3. В списке "Среда" выберите JUnit.
-4. Снимите флажки "Test Initializer" и "Test Finalizer". Нажмите кнопку "ОК".
+
+[start=3]
+. В списке "Среда" выберите JUnit.
+
+[start=4]
+. Снимите флажки "Test Initializer" и "Test Finalizer". Нажмите кнопку "ОК".
image::images/junit3-vectors-createtests.png[title="Диалоговое окно 'Выбрать версию JUnit'"]
-5. В диалоговом окне "Select JUnit Version" выберите JUnit 3.x.
+
+[start=5]
+. В диалоговом окне "Select JUnit Version" выберите JUnit 3.x.
image::images/junit3-select-version.png[title="Диалоговое окно 'Выбрать версию JUnit'"]
Если выбрана версия JUnit 3.x, среда IDE добавляет в проект библиотеку JUnit 3.
@@ -204,7 +220,9 @@
assertEquals(expResult, result);
}
----
-3. Затем добавьте несколько подтверждений для тестирования метода.
+
+[start=3]
+. Затем добавьте несколько подтверждений для тестирования метода.
[source,java]
----
@@ -221,7 +239,9 @@
В этом тестовом методе используется метод JUnit ``assertEquals`` . Для использования утверждения необходимо указать входные переменные и ожидаемый результат. Для успешного прохождения теста метод теста должен выдать все ожидаемые результаты на основе переменных, введенных при выполнении тестового метода. Для охвата возможных перестановок следует добавить достаточное количество утверждений.
-4. Измените скелет теста для ``testEqual`` путем удаления созданных тел методов и добавления следующего ``println`` .
+
+[start=4]
+. Измените скелет теста для ``testEqual`` путем удаления созданных тел методов и добавления следующего ``println`` .
[source,java]
----
@@ -239,7 +259,9 @@
System.out.println("* VectorsJUnit3Test: testEqual()");
}
----
-5. Измените метод ``testEqual`` путем добавления следующих утверждений (выделены полужирным шрифтом).
+
+[start=5]
+. Измените метод ``testEqual`` путем добавления следующих утверждений (выделены полужирным шрифтом).
[source,java]
----
@@ -268,7 +290,9 @@
В этом тесте используются методы JUnit ``assertTrue`` и ``assertFalse`` для тестирования всех возможных результатов. Для успешного прохождения теста утверждения ``assertTrue`` должны быть истинными, а ``assertFalse`` – ложными.
-6. Сохраните изменения.
+
+[start=6]
+. Сохраните изменения.
Сравните: <<Exercise_32,Написание тестовых методов для ``Vectors.java`` (JUnit 4)>>
@@ -331,7 +355,9 @@
2. Добавьте следующий метод для тестирования метода ``concatWords`` .*public void testHelloWorld() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Добавьте оператор ``println`` для вывода на экран текста о тесте в окне "JUnit Test Results".
+
+[start=3]
+. Добавьте оператор ``println`` для вывода на экран текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -361,8 +387,12 @@
}
};
}*
-3. Исправьте операторы импорта для импорта ``java.util.concurrent.TimeoutException`` .
-4. Добавьте к методу следующий код (выделен полужирным шрифтом) для прерывания потока выполнения и вывода на экран сообщения в случае слишком долгого выполнения теста.
+
+[start=3]
+. Исправьте операторы импорта для импорта ``java.util.concurrent.TimeoutException`` .
+
+[start=4]
+. Добавьте к методу следующий код (выделен полужирным шрифтом) для прерывания потока выполнения и вывода на экран сообщения в случае слишком долгого выполнения теста.
[source,java]
----
@@ -385,7 +415,9 @@
Можно изменить строку ``Thread.sleep`` для изменения количества миллисекунд до выдачи тайм-аута.
-5. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
+
+[start=5]
+. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -412,7 +444,9 @@
} catch (IllegalArgumentException ex) {
}
}*
-2. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
+
+[start=2]
+. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -437,7 +471,9 @@
При выполнении тестового класса будет выполнен тестовый метод ``testTemporarilyDisabled`` .
-3. Введите ``DISABLED_`` (выделено полужирным шрифтом) перед именем тестового метода.
+
+[start=3]
+. Введите ``DISABLED_`` (выделено полужирным шрифтом) перед именем тестового метода.
[source,java]
----
@@ -502,10 +538,16 @@
В результате изменения имени тестового класса появится предупреждение об изменении имени. Имя по умолчанию – это имя тестируемого класса с добавленным словом "Test". Например, для класса ``MyClass.java`` именем по умолчанию тестового класса будет ``MyClassTest.java`` . В отличие от JUnit 3, в JUnit 4 добавление слова "Test" к имени теста не обязательно. Рекомендуется сохранить имя по умолчанию, но так как в рамках данного руководства все тесты JUnit создаются в одном пакете, имена тестовых классов должны быть различны.
-3. В списке "Среда" выберите JUnit.
-4. Снимите флажки "Test Initializer" и "Test Finalizer". Нажмите кнопку "ОК".
+
+[start=3]
+. В списке "Среда" выберите JUnit.
+
+[start=4]
+. Снимите флажки "Test Initializer" и "Test Finalizer". Нажмите кнопку "ОК".
image::images/junit4-vectors-createtests.png[title="Диалоговое окно 'Создать тесты для JUnit 4'"]
-5. В диалоговом окне "Select JUnit Version" выберите JUnit 4.x. Нажмите кнопку "Выбрать".
+
+[start=5]
+. В диалоговом окне "Select JUnit Version" выберите JUnit 4.x. Нажмите кнопку "Выбрать".
image::images/junit4-select-version.png[title="Диалоговое окно 'Выбрать версию JUnit'"]
При нажатии кнопки "ОК" среда IDE создает тестовый класс ``VectorsJUnit4Test.java`` в пакете ``sample`` под узлом "Тестовые пакеты" окна проектов.
@@ -561,7 +603,9 @@
*Примечание.* При написании тестов изменять результат вывода не требуется. В этом упражнении это выполнено для упрощения идентификации результатов тестирования в окне вывода.
-3. Затем добавьте несколько подтверждений для тестирования метода.
+
+[start=3]
+. Затем добавьте несколько подтверждений для тестирования метода.
[source,java]
----
@@ -579,9 +623,15 @@
В этом тестовом методе используется метод JUnit ``assertEquals`` . Для использования утверждения необходимо указать входные переменные и ожидаемый результат. Для успешного прохождения теста метод теста должен выдать все ожидаемые результаты на основе переменных, введенных при выполнении тестового метода. Для охвата возможных перестановок следует добавить достаточное количество утверждений.
-4. Измените имя тестового метода с ``testEqual`` на ``equalsCheck`` .
-5. Удалите созданное тело тестового метода ``equalsCheck`` .
-6. Добавьте следующий метод ``println`` в тестовый метод ``equalsCheck`` .*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
+
+[start=4]
+. Измените имя тестового метода с ``testEqual`` на ``equalsCheck`` .
+
+[start=5]
+. Удалите созданное тело тестового метода ``equalsCheck`` .
+
+[start=6]
+. Добавьте следующий метод ``println`` в тестовый метод ``equalsCheck`` .*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
Тестовый метод в результате должен выглядеть следующим образом:
@@ -594,7 +644,9 @@
System.out.println("* VectorsJUnit4Test: equalsCheck()");
}
----
-7. Измените метод ``equalsCheck`` путем добавления следующих утверждений (выделены полужирным шрифтом).
+
+[start=7]
+. Измените метод ``equalsCheck`` путем добавления следующих утверждений (выделены полужирным шрифтом).
[source,java]
----
@@ -704,7 +756,9 @@
public void helloWorldCheck() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. Добавьте оператор ``println`` для вывода на экран текста о тесте в окне "JUnit Test Results".
+
+[start=3]
+. Добавьте оператор ``println`` для вывода на экран текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -731,7 +785,9 @@
System.out.println("computing " + factorialOf + '!');
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-3. Добавьте следующий код (выделен полужирным шрифтом) для определения тайм-аута и прерывания потока выполнения в случае слишком долгого выполнения метода.
+
+[start=3]
+. Добавьте следующий код (выделен полужирным шрифтом) для определения тайм-аута и прерывания потока выполнения в случае слишком долгого выполнения метода.
[source,java]
----
@@ -743,7 +799,9 @@
Как видно в примере, для тайм-аута установлено значение 1000 миллисекунд.
-4. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
+
+[start=4]
+. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -768,7 +826,9 @@
final int factorialOf = -5;
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-2. Добавьте следующее свойство (выделено полужирным шрифтом) в аннотацию ``@Test`` для определения необходимости выдачи ``IllegalArgumentException`` в результате выполнения теста.
+
+[start=2]
+. Добавьте следующее свойство (выделено полужирным шрифтом) в аннотацию ``@Test`` для определения необходимости выдачи ``IllegalArgumentException`` в результате выполнения теста.
[source,java]
----
@@ -779,7 +839,9 @@
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}
----
-3. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
+
+[start=3]
+. Добавьте следующий код ``println`` (выделен полужирным шрифтом) для отображения текста о тесте в окне "JUnit Test Results".
[source,java]
----
@@ -808,7 +870,9 @@
При выполнении тестового класса будет выполнен тестовый метод ``temporarilyDisabledTest`` .
-3. Для отключения теста добавьте аннотацию ``@Ignore`` (выделена полужирным шрифтом) над ``@Test`` .*@Ignore*
+
+[start=3]
+. Для отключения теста добавьте аннотацию ``@Ignore`` (выделена полужирным шрифтом) над ``@Test`` .*@Ignore*
[source,java]
----
@@ -819,7 +883,9 @@
assertEquals("Malm\u00f6", Utils.normalizeWord("Malmo\u0308"));
}
----
-4. Исправьте операторы импорта для импорта ``org.junit.Ignore`` .
+
+[start=4]
+. Исправьте операторы импорта для импорта ``org.junit.Ignore`` .
Сравните: <<Exercise_245,Отключение теста (JUnit 3)>>
@@ -891,7 +957,9 @@
}
}
----
-6. Измените метод ``suite()`` , чтобы добавить тестовые классы, которые будут запускать часть набора тестов.
+
+[start=6]
+. Измените метод ``suite()`` , чтобы добавить тестовые классы, которые будут запускать часть набора тестов.
[source,java]
----
@@ -907,7 +975,9 @@
return suite;
}
----
-7. Сохраните изменения.
+
+[start=7]
+. Сохраните изменения.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_zh_CN.asciidoc
index 834b1f3..e478ad3 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/junit-intro_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/junit-intro_zh_CN.asciidoc
@@ -83,13 +83,21 @@
2. 在 "Checkout"（检出）对话框中，输入以下资源库 URL：
``https://svn.netbeans.org/svn/samples~samples-source-code``
单击 "Next"（下一步）。
-3. 在 "Folders to Checkout"（要检出的文件夹）面板中，单击 "Browse"（浏览），以打开 "Browse Repository Folders"（浏览资源库文件夹）对话框。
-4. 展开根节点，然后选择 *samples/java/JUnitSampleSol*。单击 "OK"（确定）。
-5. 指定用于存储源代码的 "Local Folder"（本地文件夹）。单击 "Finish"（完成）。
+
+[start=3]
+. 在 "Folders to Checkout"（要检出的文件夹）面板中，单击 "Browse"（浏览），以打开 "Browse Repository Folders"（浏览资源库文件夹）对话框。
+
+[start=4]
+. 展开根节点，然后选择 *samples/java/JUnitSampleSol*。单击 "OK"（确定）。
+
+[start=5]
+. 指定用于存储源代码的 "Local Folder"（本地文件夹）。单击 "Finish"（完成）。
单击 "Finish"（完成），此时 IDE 会将本地文件夹初始化为 Subversion 资源库，并检出项目源代码。
-6. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
+
+[start=6]
+. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
有关安装 Subversion 的更多信息，请参见 link:../ide/subversion.html[+NetBeans IDE 中的 Subversion 指南+]中有关link:../ide/subversion.html#settingUp[+设置 Subversion+] 的部分。
@@ -104,7 +112,9 @@
2. 键入 *sample* 作为包名。单击 "Finish"（完成）。
3. 在 "Projects"（项目）窗口中，打开 *JUnitSampleSol* 项目（如果尚未打开），然后展开 "Source Packages"（源包）节点。
image::images/projects-window.png[title=""Projects"（项目）窗口中的 JUnit-Sample 和 JUnitSampleSol 项目"]
-4. 复制 JUnitSampleSol 项目中的 ``Utils.java`` 和 ``Vectors.java`` 类，然后将其粘贴到 JUnit-Sample 的 ``sample`` 源包中。
+
+[start=4]
+. 复制 JUnitSampleSol 项目中的 ``Utils.java`` 和 ``Vectors.java`` 类，然后将其粘贴到 JUnit-Sample 的 ``sample`` 源包中。
如果查看这些类的源代码，则可以看到 ``Utils.java`` 包含三个方法（ ``computeFactorial`` 、 ``concatWords`` 和 ``normalizeWord`` ），而 ``Vectors.java`` 包含两个方法（ ``equal`` 和 ``scalarMultiplication`` ）。接下来，为各类创建测试类并为这些方法编写一些测试用例。
@@ -129,10 +139,16 @@
更改测试类的名称之后，您将看到一个关于修改名称的警告。默认名称基于要测试的类名，并在该名称后面附加单词 Test。举例来说，对于 ``MyClass.java`` 类，测试类的默认名称为 ``MyClassTest.java`` 。通常，最好是保留默认名称，但是在教程中您将更改该名称，因为您还将在相同的包中创建 JUnit 4 测试，并且测试类的名称必须是惟一的。
-3. 在 "Framework"（框架）下拉列表中选择 "JUnit"。
-4. 取消选中 "Test Initializer"（测试初始化函数）和 "Test Finalizer"（测试终结方法）。单击 "OK"（确定）。
+
+[start=3]
+. 在 "Framework"（框架）下拉列表中选择 "JUnit"。
+
+[start=4]
+. 取消选中 "Test Initializer"（测试初始化函数）和 "Test Finalizer"（测试终结方法）。单击 "OK"（确定）。
image::images/junit3-vectors-createtests.png[title="选择 "JUnit version"（JUnit 版本）对话框"]
-5. 在 "Select JUnit Version"（选择 JUnit 版本）对话框中，选择 "JUnit 3.x"。
+
+[start=5]
+. 在 "Select JUnit Version"（选择 JUnit 版本）对话框中，选择 "JUnit 3.x"。
image::images/junit3-select-version.png[title="选择 "JUnit version"（JUnit 版本）对话框"]
选择 "JUnit 3.x" 时，IDE 会将 JUnit 3 库添加到项目中。
@@ -204,7 +220,9 @@
assertEquals(expResult, result);
}
----
-3. 现在，添加一些断言来测试方法。
+
+[start=3]
+. 现在，添加一些断言来测试方法。
[source,java]
----
@@ -221,7 +239,9 @@
该测试方法使用 JUnit ``assertEquals`` 方法。要使用断言，您需要提供输入变量和预期的结果。在运行被测试的方法时，要通过测试，测试方法必须根据提供的变量成功返回所有预期的结果。您应该添加足够数量的断言来涵盖各种可能的排列。
-4. 修改 ``testEqual`` 的测试框架：删除生成的方法主体并添加以下 ``println`` 。
+
+[start=4]
+. 修改 ``testEqual`` 的测试框架：删除生成的方法主体并添加以下 ``println`` 。
[source,java]
----
@@ -239,7 +259,9 @@
System.out.println("* VectorsJUnit3Test: testEqual()");
}
----
-5. 修改 ``testEqual`` 方法：添加以下断言（显示为粗体）。
+
+[start=5]
+. 修改 ``testEqual`` 方法：添加以下断言（显示为粗体）。
[source,java]
----
@@ -268,7 +290,9 @@
此方法使用 JUnit ``assertTrue`` 和 ``assertFalse`` 方法来测试各种可能的结果。要通过此方法的测试， ``assertTrue`` 必须全部为 true，并且 ``assertFalse`` 必须全部为 false。
-6. 保存所做的更改。
+
+[start=6]
+. 保存所做的更改。
比较：<<Exercise_32,为 ``Vectors.java`` 编写测试方法（JUnit 4）>>
@@ -331,7 +355,9 @@
2. 添加以下方法来测试 ``concatWords`` 方法。*public void testHelloWorld() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. 添加一个 ``println`` 语句，用于在 "JUnit Test Results"（JUnit 测试结果）窗口中显示关于测试的文本。
+
+[start=3]
+. 添加一个 ``println`` 语句，用于在 "JUnit Test Results"（JUnit 测试结果）窗口中显示关于测试的文本。
[source,java]
----
@@ -361,8 +387,12 @@
}
};
}*
-3. 修复导入，以导入 ``java.util.concurrent.TimeoutException`` 。
-4. 在方法中添加以下代码（显示为粗体），其作用是当测试任务的执行时间过长时中断线程并显示一条消息。
+
+[start=3]
+. 修复导入，以导入 ``java.util.concurrent.TimeoutException`` 。
+
+[start=4]
+. 在方法中添加以下代码（显示为粗体），其作用是当测试任务的执行时间过长时中断线程并显示一条消息。
[source,java]
----
@@ -385,7 +415,9 @@
在抛出超时之前，您可以通过修改 ``Thread.sleep`` 代码行来更改毫秒数。
-5. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
+
+[start=5]
+. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
[source,java]
----
@@ -412,7 +444,9 @@
} catch (IllegalArgumentException ex) {
}
}*
-2. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
+
+[start=2]
+. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
[source,java]
----
@@ -437,7 +471,9 @@
测试方法 ``testTemporarilyDisabled`` 将在您运行测试类时运行。
-3. 将 ``DISABLED_`` （显示为粗体）置于测试方法的名称之前。
+
+[start=3]
+. 将 ``DISABLED_`` （显示为粗体）置于测试方法的名称之前。
[source,java]
----
@@ -502,10 +538,16 @@
更改测试类的名称之后，您将看到一个关于修改名称的警告。默认名称基于要测试的类名，并在该名称后面附加单词 Test。举例来说，对于 ``MyClass.java`` 类，测试类的默认名称为 ``MyClassTest.java`` 。与 JUnit 3 不同，在 JUnit 4 中，测试不需要以单词 Test 结尾。通常，最好是保留默认名称，但由于在本教程中您将在相同的包中创建所有 JUnit 测试，因此测试类的名称必须是惟一的。
-3. 在 "Framework"（框架）下拉列表中选择 "JUnit"。
-4. 取消选中 "Test Initializer"（测试初始化函数）和 "Test Finalizer"（测试终结方法）。单击 "OK"（确定）。
+
+[start=3]
+. 在 "Framework"（框架）下拉列表中选择 "JUnit"。
+
+[start=4]
+. 取消选中 "Test Initializer"（测试初始化函数）和 "Test Finalizer"（测试终结方法）。单击 "OK"（确定）。
image::images/junit4-vectors-createtests.png[title="JUnit 4 "Create Tests"（创建测试）对话框"]
-5. 在 "Select JUnit Version"（选择 JUnit 版本）对话框中，选择 "JUnit 4.x"。单击 "Select"（选择）。
+
+[start=5]
+. 在 "Select JUnit Version"（选择 JUnit 版本）对话框中，选择 "JUnit 4.x"。单击 "Select"（选择）。
image::images/junit4-select-version.png[title="选择 "JUnit version"（JUnit 版本）对话框"]
单击 "OK"（确定）后，IDE 将在 "Projects"（项目）窗口 "Test Packages"（测试包）节点下方的 ``sample`` 包中创建 ``VectorsJUnit4Test.java`` 测试类。
@@ -561,7 +603,9 @@
*注：*在编写测试时，不需要更改打印的输出。在本练习中，其作用是能够更加轻松地识别输出窗口中的测试结果。
-3. 现在，添加一些断言来测试方法。
+
+[start=3]
+. 现在，添加一些断言来测试方法。
[source,java]
----
@@ -579,9 +623,15 @@
在此测试方法中，您使用了 JUnit ``assertEquals`` 方法。要使用断言，您需要提供输入变量和预期的结果。在运行被测试的方法时，要通过测试，测试方法必须根据提供的变量成功返回所有预期的结果。您应该添加足够数量的断言来涵盖各种可能的排列。
-4. 将 ``testEqual`` 测试方法的名称更改为 ``equalsCheck`` 。
-5. 删除 ``equalsCheck`` 测试方法的已生成方法主体。
-6. 将以下 ``println`` 添加到 ``equalsCheck`` 测试方法中。*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
+
+[start=4]
+. 将 ``testEqual`` 测试方法的名称更改为 ``equalsCheck`` 。
+
+[start=5]
+. 删除 ``equalsCheck`` 测试方法的已生成方法主体。
+
+[start=6]
+. 将以下 ``println`` 添加到 ``equalsCheck`` 测试方法中。*System.out.println("* VectorsJUnit4Test: equalsCheck()");*
现在，测试方法应如下所示：
@@ -594,7 +644,9 @@
System.out.println("* VectorsJUnit4Test: equalsCheck()");
}
----
-7. 修改 ``equalsCheck`` 方法：添加以下断言（显示为粗体）。
+
+[start=7]
+. 修改 ``equalsCheck`` 方法：添加以下断言（显示为粗体）。
[source,java]
----
@@ -704,7 +756,9 @@
public void helloWorldCheck() {
assertEquals("Hello, world!", Utils.concatWords("Hello", ", ", "world", "!"));
}*
-3. 添加一个 ``println`` 语句，用于在 "JUnit Test Results"（JUnit 测试结果）窗口中显示关于测试的文本。
+
+[start=3]
+. 添加一个 ``println`` 语句，用于在 "JUnit Test Results"（JUnit 测试结果）窗口中显示关于测试的文本。
[source,java]
----
@@ -731,7 +785,9 @@
System.out.println("computing " + factorialOf + '!');
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-3. 添加以下代码（显示为粗体），用于设置超时并在方法执行时间过长时中断线程。
+
+[start=3]
+. 添加以下代码（显示为粗体），用于设置超时并在方法执行时间过长时中断线程。
[source,java]
----
@@ -743,7 +799,9 @@
可以看到，超时被设置为 1000 毫秒。
-4. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
+
+[start=4]
+. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
[source,java]
----
@@ -768,7 +826,9 @@
final int factorialOf = -5;
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}*
-2. 在 ``@Test`` 标注中添加以下属性（显示为粗体），指定测试应该抛出 ``IllegalArgumentException`` 。
+
+[start=2]
+. 在 ``@Test`` 标注中添加以下属性（显示为粗体），指定测试应该抛出 ``IllegalArgumentException`` 。
[source,java]
----
@@ -779,7 +839,9 @@
System.out.println(factorialOf + "! = " + Utils.computeFactorial(factorialOf));
}
----
-3. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
+
+[start=3]
+. 添加以下 ``println`` （显示为粗体），用于在 "JUnit Test Results"（JUnit 测试结果）窗口中输出关于测试的文本。
[source,java]
----
@@ -808,7 +870,9 @@
测试方法 ``temporarilyDisabledTest`` 将在您运行测试类时运行。
-3. 在 ``@Test`` 上方添加 ``@Ignore`` 标注（显示为粗体）来禁用测试。*@Ignore*
+
+[start=3]
+. 在 ``@Test`` 上方添加 ``@Ignore`` 标注（显示为粗体）来禁用测试。*@Ignore*
[source,java]
----
@@ -819,7 +883,9 @@
assertEquals("Malm\u00f6", Utils.normalizeWord("Malmo\u0308"));
}
----
-4. 修复导入，以导入 ``org.junit.Ignore`` 。
+
+[start=4]
+. 修复导入，以导入 ``org.junit.Ignore`` 。
比较：<<Exercise_245,禁用测试（JUnit 3）>>
@@ -891,7 +957,9 @@
}
}
----
-6. 修改 ``suite()`` 方法，以添加要作为套件的一部分运行的测试类。
+
+[start=6]
+. 修改 ``suite()`` 方法，以添加要作为套件的一部分运行的测试类。
[source,java]
----
@@ -907,7 +975,9 @@
return suite;
}
----
-7. 保存所做的更改。
+
+[start=7]
+. 保存所做的更改。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se.asciidoc
index 73be845..3e2aead 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se.asciidoc
@@ -71,7 +71,9 @@
When you click OK the IDE will run a script to create the Sakila database and populate the database tables. You can see the results of running the script in the Output window. A node for the Sakila database is also added 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.
@@ -85,7 +87,9 @@
You can use the Maven version bundled with the IDE or specify the location of a local Maven installation (requires 2.0.9 or newer).
-4. Click OK to close the Options window.
+
+[start=4]
+. Click OK to close the Options window.
*Notes.*
@@ -130,12 +134,18 @@
1. Choose File > New Project (Ctrl-Shift-N; ⌘-Shift-N on Mac) from the main menu to open the New Project wizard.
2. Select Java Application from the Maven category. Click Next.
image::images/maven-project-wizard.png[title="Maven Archetypes in New Project wizard"]
-3. Type *DVDStoreAdmin* for the project name and set the project location.
-4. Modify the default Group Id and Version (optional).
+
+[start=3]
+. Type *DVDStoreAdmin* for the project name and set the project location.
+
+[start=4]
+. Modify the default Group Id and Version (optional).
The Group Id and Version will be used as the coordinates for the artifact in your local repository when you build the project.
-5. Click Finish.
+
+[start=5]
+. Click Finish.
When you click finish the IDE creates the Maven project and opens the project in the Projects window. The IDE automatically creates the class ``App.java`` in the ``com.mycompany.dvdstoreadmin`` package. You can delete ``App.java`` because the application does not need it.
@@ -191,8 +201,12 @@
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* in the text field. Click OK.
+
+[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* in the text field. Click OK.
*Note.* Do not select the value from the drop-down list.
@@ -216,7 +230,9 @@
</session-factory>
</hibernate-configuration>
----
-7. Save your changes to the file.
+
+[start=7]
+. Save your changes to the file.
When you run your project you will be able to see the SQL query printed in the IDE's Output window.
@@ -295,11 +311,21 @@
When you delete the default text, the text field will collapse. You can resize the text field later to adjust the alignment of the form elements.
-4. Drag a Label element from the Palette and change the text to *Last Name*.
-5. Drag a Text Field element next to the Last Name label and delete the default text.
-6. Drag a Button element from the Palette and change the text to *Query*.
-7. Drag a Table element from the Palette into the form.
-8. Modify the Variable Name values of the following UI elements according to the values in the following table.
+
+[start=4]
+. Drag a Label element from the Palette and change the text to *Last Name*.
+
+[start=5]
+. Drag a Text Field element next to the Last Name label and delete the default text.
+
+[start=6]
+. Drag a Button element from the Palette and change the text to *Query*.
+
+[start=7]
+. Drag a Table element from the Palette into the form.
+
+[start=8]
+. Modify the Variable Name values of the following UI elements according to the values in the following table.
You can modify the Variable Name value of an element by right-clicking the element in the Design view and then choosing Change Variable Name. Alternatively, you can change the Variable Name directly in the Inspector window.
@@ -316,11 +342,15 @@
|Table | ``resultTable``
|===
-9. Resize the text fields and align the form elements.
+
+[start=9]
+. Resize the text fields and align the form elements.
You can enable the Horizontal Resizable property for the text fields to ensure that the text fields resize with the window and that the spacing between elements remains constant.
-10. Save your changes.
+
+[start=10]
+. Save your changes.
In Design view your form should look similar to the following image.
@@ -338,14 +368,22 @@
When you click Build, the IDE will download the necessary artifacts to your local Maven repository.
-2. Expand the ``<default package>`` source package node under the Other Sources node in the Projects window.
-3. Right-click ``hibernate.cfg.xml`` and choose Run HQL Query to open the HQL Editor.
-4. Test the connection by typing ``from Actor`` in the HQL Query Editor. Click the Run HQL Query button ( image::images/run_hql_query_16.png[title="Run HQL Query button"] ) in the toolbar.
+
+[start=2]
+. Expand the ``<default package>`` source package node under the Other Sources node in the Projects window.
+
+[start=3]
+. Right-click ``hibernate.cfg.xml`` and choose Run HQL Query to open the HQL Editor.
+
+[start=4]
+. Test the connection by typing ``from Actor`` in the HQL Query Editor. Click the Run HQL Query button ( image::images/run_hql_query_16.png[title="Run HQL Query button"] ) in the toolbar.
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]
----
@@ -363,7 +401,9 @@
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]
----
@@ -395,7 +435,9 @@
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]
----
@@ -411,7 +453,9 @@
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]
----
@@ -432,12 +476,18 @@
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. Fix your imports to add import statements for the Hibernate libraries ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) and ``java.util.List`` .
-6. Create a Query button event handler by switching to the Design view and double-clicking the Query button.
+
+[start=5]
+. Fix your imports to add import statements for the Hibernate libraries ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) and ``java.util.List`` .
+
+[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]
----
@@ -450,7 +500,9 @@
}*
}
----
-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]
----
@@ -475,7 +527,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Fix your imports (Ctrl+Shift+I) to add ``java.util.Vector`` and save your changes.
+
+[start=9]
+. Fix your imports (Ctrl+Shift+I) to add ``java.util.Vector`` and save your changes.
After you save the form you can run the project.
@@ -497,7 +551,9 @@
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.
When you invoke the Run action on a Maven project in the IDE, the IDE runs the Maven goals associated with the Run action. The IDE has default goals bound to IDE actions according to the project packaging. You can view the goals bound to the Run action in the Actions pane of the project's Properties window
@@ -521,14 +577,24 @@
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-Maven*. 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-Maven*. 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.
*Notes.*
@@ -555,13 +621,19 @@
private Date lastUpdate;*
}
----
-4. Generate the getters and setters for the fields by placing the insertion cursor in the source editor, typing Alt-Insert and then selecting Getter and Setter.
-5. In the Generate Getters and Setters dialog box, select all the fields and click Generate.
+
+[start=4]
+. Generate the getters and setters for the fields by placing the insertion cursor in the source editor, typing Alt-Insert and then selecting Getter and Setter.
+
+[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`` .
@@ -582,7 +654,9 @@
</session-factory>
</hibernate-configuration>
----
-6. 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=6]
+. 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]
----
@@ -619,6 +693,8 @@
</class>*
</hibernate-mapping>
----
-7. Click the Validate XML button in the toolbar and save your changes.
+
+[start=7]
+. 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 customize your application.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ja.asciidoc
index 7c76010..155fb8c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ja.asciidoc
@@ -79,7 +79,9 @@
「OK」をクリックすると、Sakilaデータベースを作成し、データベース表を生成するためのスクリプトがIDEによって実行されます。スクリプトを実行した結果は、「出力」ウィンドウで確認できます。「MySQLサーバー」ノードの下にSakilaデータベースのノードも追加されます。
-5. 「Sakila」ノードを右クリックし、「接続」を選択します。
+
+[start=5]
+. 「Sakila」ノードを右クリックし、「接続」を選択します。
「接続」をクリックすると、Sakilaデータベースのデータベース接続ノード( ``jdbc:mysql://localhost:3306/sakila [デフォルトの_ユーザー名_]`` )が「データベース」ノードの下に一覧表示されます。接続が開いたら、接続ノードを展開してデータベースのデータを表示できます。
@@ -94,7 +96,9 @@
IDEにバンドルされているMavenバージョンを使用することも、ローカルのMavenインストール(2.0.9以降が必要)の場所を指定することもできます。
-4. 「OK」をクリックして「オプション」ウィンドウを閉じます。
+
+[start=4]
+. 「OK」をクリックして「オプション」ウィンドウを閉じます。
*注意:*
@@ -142,12 +146,18 @@
1. メイン・メニューから「ファイル」>「新規プロジェクト」([Ctrl]-[Shift]-[N]、Macの場合は[⌘]-[Shift]-[N])を選択して新規プロジェクト・ウィザードを開きます。
2. 「Maven」カテゴリから「Javaアプリケーション」を選択します。「次」をクリックします。
image::images/maven-project-wizard.png[title="新規プロジェクト・ウィザードでのMaven原型"]
-3. プロジェクト名に「*DVDStoreAdmin*」と入力し、プロジェクトの場所を設定します。
-4. デフォルトの「グループID」と「バージョン」を変更します(オプション)。
+
+[start=3]
+. プロジェクト名に「*DVDStoreAdmin*」と入力し、プロジェクトの場所を設定します。
+
+[start=4]
+. デフォルトの「グループID」と「バージョン」を変更します(オプション)。
プロジェクトのビルド時に、ローカル・リポジトリのアーティファクトのコーディネートとして「グループID」と「バージョン」が使用されます。
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
「終了」をクリックすると、IDEがMavenプロジェクトを作成し、そのプロジェクトが「プロジェクト」ウィンドウで開きます。IDEでは、 ``com.mycompany.dvdstoreadmin`` パッケージに ``App.java`` クラスが自動的に作成されます。アプリケーションでは必要ないため、 ``App.java`` は削除してかまいません。
@@ -207,8 +217,12 @@
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*を入力します。「OK」をクリックします。
+
+[start=5]
+. 「その他のプロパティ」ノードの下にある「追加」をクリックし、「プロパティ名」ドロップダウン・リストで「 ``hibernate.query.factory_class`` 」を選択します。
+
+[start=6]
+. テキスト・フィールドに*org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory*を入力します。「OK」をクリックします。
*注意:*ドロップダウン・リストから値を選択しないでください。
@@ -232,7 +246,9 @@
</session-factory>
</hibernate-configuration>
----
-7. 変更内容をファイルに保存します。
+
+[start=7]
+. 変更内容をファイルに保存します。
プロジェクトを実行すると、IDEの出力ウィンドウにSQL問合せが表示されます。
@@ -318,11 +334,21 @@
デフォルトのテキストを削除すると、テキスト・フィールドが縮小されます。テキスト・フィールドは、フォーム要素の位置を調整するために、後でサイズ変更できます。
-4. 「ラベル」要素をパレットからドラッグし、「*姓*」のテキストを変更します。
-5. 「テキスト・フィールド」要素を「姓」ラベルの隣にドラッグし、デフォルトのテキストを削除します。
-6. 「ボタン」要素をパレットからドラッグし、テキストを「*問合せ*」に変更します。
-7. 「表」要素をパレットからフォームにドラッグします。
-8. 次のUI要素の「変数名」の値を、次の表の値に従って変更します。
+
+[start=4]
+. 「ラベル」要素をパレットからドラッグし、「*姓*」のテキストを変更します。
+
+[start=5]
+. 「テキスト・フィールド」要素を「姓」ラベルの隣にドラッグし、デフォルトのテキストを削除します。
+
+[start=6]
+. 「ボタン」要素をパレットからドラッグし、テキストを「*問合せ*」に変更します。
+
+[start=7]
+. 「表」要素をパレットからフォームにドラッグします。
+
+[start=8]
+. 次のUI要素の「変数名」の値を、次の表の値に従って変更します。
要素の「変数名」の値は、その要素を「デザイン」ビューの中で右クリックし、「変数名を変更」を選択することで変更できます。または、「変数名」を「インスペクタ」ウィンドウで直接変更することもできます。
@@ -339,11 +365,15 @@
|表 | ``resultTable``
|===
-9. テキスト・フィールドのサイズを変更し、フォーム要素の位置揃えを行います。
+
+[start=9]
+. テキスト・フィールドのサイズを変更し、フォーム要素の位置揃えを行います。
テキスト・フィールドの「水平方向にサイズ変更可能」プロパティを有効にして、要素間のスペースを維持したまま、テキスト・フィールドをウィンドウにあわせてサイズ変更することができます。
-10. 変更を保存します。
+
+[start=10]
+. 変更を保存します。
デザイン・ビューのフォームは、次のイメージのような外観になります。
@@ -362,14 +392,22 @@
「ビルド」をクリックすると、IDEによって、必要なアーティファクトがローカルMavenリポジトリにダウンロードされます。
-2. 「プロジェクト」ウィンドウの「その他のソース」ノードの下にある、 ``<デフォルト・パッケージ>`` ソース・パッケージ・ノードを展開します。
-3. 「 ``hibernate.cfg.xml`` 」を右クリックし、「HQL問合せの実行」を選択してHQL問合せエディタを開きます。
-4. HQL問合せエディタに「 ``from Actor`` 」と入力して、接続をテストします。ツールバーの「HQL問合せの実行」ボタン(image::images/run_hql_query_16.png[title="「HQL問合せの実行」ボタン"])をクリックします。
+
+[start=2]
+. 「プロジェクト」ウィンドウの「その他のソース」ノードの下にある、 ``<デフォルト・パッケージ>`` ソース・パッケージ・ノードを展開します。
+
+[start=3]
+. 「 ``hibernate.cfg.xml`` 」を右クリックし、「HQL問合せの実行」を選択してHQL問合せエディタを開きます。
+
+[start=4]
+. HQL問合せエディタに「 ``from Actor`` 」と入力して、接続をテストします。ツールバーの「HQL問合せの実行」ボタン(image::images/run_hql_query_16.png[title="「HQL問合せの実行」ボタン"])をクリックします。
「HQL問合せの実行」をクリックすると、問合せ結果がHQL問合せエディタの下のペインに表示されるはずです。
image::images/hib-query-hqlresults.png[title="HQL問合せ結果が表示されたHQL問合せエディタ"]
-5. 検索文字列が「PE」の場合、次の問合せをHQL問合せエディタに入力して「HQL問合せの実行」をクリックし、問合せ結果を確認します。
+
+[start=5]
+. 検索文字列が「PE」の場合、次の問合せをHQL問合せエディタに入力して「HQL問合せの実行」をクリックし、問合せ結果を確認します。
[source,java]
----
@@ -387,7 +425,9 @@
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]
----
@@ -420,7 +460,9 @@
問合せをHQL問合せエディタのタブからファイルにコピーし、コードを変更できます。
-3. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
+
+[start=3]
+. 次のメソッドを追加し、ユーザー入力文字列に基づく問合せを作成します。
[source,java]
----
@@ -436,7 +478,9 @@
このメソッドは、 ``executeHQLQuery()`` というメソッドをコールし、問合せ文字列をユーザーが入力した検索文字列と組み合せて問合せを作成します。
-4. ``executeHQLQuery()`` メソッドを追加します。
+
+[start=4]
+. ``executeHQLQuery()`` メソッドを追加します。
[source,java]
----
@@ -457,12 +501,18 @@
``executeHQLQuery()`` メソッドは、Hibernateをコールして、選択した問合せを実行します。このメソッドは、 ``HibernateUtil.java`` ユーティリティ・クラスを使用してHibernateセッションを取得します。
-5. Hibernateライブラリ( ``org.hibernate.Query`` 、 ``org.hibernate.Session`` )と ``java.util.List`` に対するインポート文を追加するように、インポートを修正します。
-6. デザイン・ビューに切り替えて「問合せ」ボタンをダブルクリックすることで、「問合せ」ボタン・イベント・ハンドラを作成します。
+
+[start=5]
+. Hibernateライブラリ( ``org.hibernate.Query`` 、 ``org.hibernate.Session`` )と ``java.util.List`` に対するインポート文を追加するように、インポートを修正します。
+
+[start=6]
+. デザイン・ビューに切り替えて「問合せ」ボタンをダブルクリックすることで、「問合せ」ボタン・イベント・ハンドラを作成します。
IDEで ``queryButtonActionPerformed`` メソッドが作成され、このメソッドがソース・ビューに表示されます。
-7. ユーザーがボタンをクリックすると問合せが実行されるように、ソース・ビューの ``queryButtonActionPerformed`` メソッドに次のコードを追加して変更します。
+
+[start=7]
+. ユーザーがボタンをクリックすると問合せが実行されるように、ソース・ビューの ``queryButtonActionPerformed`` メソッドに次のコードを追加して変更します。
[source,java]
----
@@ -475,7 +525,9 @@
}*
}
----
-8. 次のメソッドを追加し、結果がJTableに表示されるようにします。
+
+[start=8]
+. 次のメソッドを追加し、結果がJTableに表示されるようにします。
[source,java]
----
@@ -500,7 +552,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. ``java.util.Vector`` を追加するようにインポートを修正し([Ctrl]-[Shift]-[I])、変更内容を保存します。
+
+[start=9]
+. ``java.util.Vector`` を追加するようにインポートを修正し([Ctrl]-[Shift]-[I])、変更内容を保存します。
フォームの保存後、プロジェクトを実行できます。
@@ -523,7 +577,9 @@
または、「参照」ボタンをクリックし、ダイアログ・ボックスでメイン・クラスを選択できます。
image::images/browse-main-class.png[title="「メイン・クラスの参照」ダイアログでのメイン・クラスの設定"]
-4. メイン・ツールバーの「プロジェクトの実行」をクリックし、アプリケーションを起動します。
+
+[start=4]
+. メイン・ツールバーの「プロジェクトの実行」をクリックし、アプリケーションを起動します。
IDEのMavenプロジェクトで「実行」アクションを呼び出すと、IDEは「実行」アクションに関連付けられたMavenゴールを実行します。IDEには、プロジェクトのパッケージに応じてIDEのアクションにバインドされたデフォルトのゴールがあります。プロジェクトの「プロパティ」ウィンドウの「アクション」ペインで、「実行」アクションにバインドされたゴールを表示できます。
@@ -548,14 +604,24 @@
2. 「チェックアウト」ダイアログ・ボックスで次のリポジトリURLを入力します。
``https://svn.netbeans.org/svn/samples~samples-source-code``
「次」をクリックします。
-3. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
-4. ルート・ノードを展開し、*samples/java/DVDStoreAdmin-Maven*を選択します。「OK」をクリックします。
-5. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
-6. 「終了」をクリックします。
+
+[start=3]
+. 「参照」をクリックして「リポジトリ・フォルダを参照」ダイアログ・ボックスを開きます。
+
+[start=4]
+. ルート・ノードを展開し、*samples/java/DVDStoreAdmin-Maven*を選択します。「OK」をクリックします。
+
+[start=5]
+. ソースのローカル・フォルダを指定します(ローカル・フォルダは空である必要があります)。
+
+[start=6]
+. 「終了」をクリックします。
「終了」をクリックすると、IDEではローカル・フォルダがSubversionリポジトリとして初期化され、プロジェクト・ソースがチェックアウトされます。
-7. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
+
+[start=7]
+. チェックアウトが完了するときに表示されるダイアログで、「プロジェクトを開く」をクリックします。
*注意:*
@@ -583,13 +649,19 @@
private Date lastUpdate;*
}
----
-4. フィールドに対する取得メソッドと設定メソッドは、挿入カーソルをソース・エディタに置き、[Alt]-[Insert]を押して「取得メソッドおよび設定メソッド」を選択することで生成します。
-5. 「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスですべてのフィールドを選択し、「生成」をクリックします。
+
+[start=4]
+. フィールドに対する取得メソッドと設定メソッドは、挿入カーソルをソース・エディタに置き、[Alt]-[Insert]を押して「取得メソッドおよび設定メソッド」を選択することで生成します。
+
+[start=5]
+. 「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスですべてのフィールドを選択し、「生成」をクリックします。
image::images/getters-setters.png[title="「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックス"]
「取得メソッドおよび設定メソッドの生成」ダイアログ・ボックスでは、キーボードの[↑]を使用して、選択した項目を「Actor」ノードまで移動してから、[Space]バーを押してActor内のすべてのフィールドを選択できます。
-6. インポートを修正して変更内容を保存します。
+
+[start=6]
+. インポートを修正して変更内容を保存します。
表のためのPOJOの作成後、 ``Actor.java`` のHibernateマッピング・ファイルを作成します。
@@ -610,7 +682,9 @@
</session-factory>
</hibernate-configuration>
----
-6. 次の太字部分の変更を ``Actor.hbm.xml`` に加えて、 ``Actor.java`` のフィールドをACTOR表の列にマップします。
+
+[start=6]
+. 次の太字部分の変更を ``Actor.hbm.xml`` に加えて、 ``Actor.java`` のフィールドをACTOR表の列にマップします。
[source,xml]
----
@@ -647,7 +721,9 @@
</class>*
</hibernate-mapping>
----
-7. ツールバーの「XMLの検証」ボタンをクリックし、変更内容を保存します。
+
+[start=7]
+. ツールバーの「XMLの検証」ボタンをクリックし、変更内容を保存します。
POJOとHibernateのマッピング・ファイルを個別に作成すると、アプリケーションをさらにカスタマイズするときに役立つ場合があります。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_pt_BR.asciidoc
index 5f8676e..a77507a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_pt_BR.asciidoc
@@ -81,7 +81,9 @@
Quando você clica em OK, o IDE executa um script para criar o banco de dados Sakila e preencher as tabelas do banco de dados. Você pode ver o resultado da execução do script na janela de Saída. É adicionado também um nó para o banco de dados Sakila sob o nó do Servidor MySQL.
-5. Clique com o botão direito do mouse no nó do Sakila e escolha Conectar.
+
+[start=5]
+. Clique com o botão direito do mouse no nó do Sakila e escolha Conectar.
Quando você clica em Conectar, um nó de conexão do banco de dados do banco de dados Sakila ( ``jdbc:mysql://localhost:3306/sakila [_nome de usuário_ em Default]`` ) será listado abaixo do nó Bancos de Dados. Quando uma conexão for aberta, você poderá exibir os dados no banco de dados ampliando o nó de conexão.
@@ -96,7 +98,9 @@
Você pode usar a versão do Maven incorporada no IDE ou especificar a localização de uma instalação local do Maven (requer versão 2.0.9 ou posterior).
-4. Clique em OK para fechar a janela Opções.
+
+[start=4]
+. Clique em OK para fechar a janela Opções.
*Observações.*
@@ -144,12 +148,18 @@
1. Selecione Arquivo > Novo Projeto (Ctrl-Shift-N; ⌘-Shift-N no Mac) no menu principal para abrir o assistente Novo Projeto.
2. Selecione Aplicação Java na categoria Maven. Clique em Próximo.
image::images/maven-project-wizard.png[title="Arquétipos do Maven no assistente Novo Projeto"]
-3. Insira *DVDStoreAdmin* como nome do projeto e defina a sua localização.
-4. Modifique o ID de Grupo default e a Versão (opcional).
+
+[start=3]
+. Insira *DVDStoreAdmin* como nome do projeto e defina a sua localização.
+
+[start=4]
+. Modifique o ID de Grupo default e a Versão (opcional).
O ID de Grupo e a Versão serão utilizadas como as coordenadas para o artefato em seu repositório local quando o projeto for construído.
-5. Clique em Finalizar.
+
+[start=5]
+. Clique em Finalizar.
Quando você clicar em Finalizar, o IDE criará o projeto Maven e abrirá o projeto na janela Projetos. O IDE cria automaticamente a classe ``App.java`` no pacote ``com.mycompany.dvdstoreadmin`` . É possível deletar o ``App.java`` porque ele não é necessário para a aplicação.
@@ -209,8 +219,12 @@
3. Clique em Adicionar para abrir a caixa de diálogo Adicionar Propriedade do Hibernate.
4. Na caixa de diálogo, selecione a propriedade ``hibernate.show_sql`` e defina o valor para ``true`` . Clique em OK. Isso ativa o log de depuração das instruções SQL.
image::images/add-property-showsql.png[title="Caixa de diálogo Adicionar Propriedade Hibernate que mostra o valor de definição de hibernate.show_sql"]
-5. Clique em Adicionar no nó Propriedades Diversas e selecione ``hibernate.query.factory_class`` na lista drop-down Nome da Propriedade.
-6. Digite *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* no campo de texto. Clique em OK.
+
+[start=5]
+. Clique em Adicionar no nó Propriedades Diversas e selecione ``hibernate.query.factory_class`` na lista drop-down Nome da Propriedade.
+
+[start=6]
+. Digite *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory* no campo de texto. Clique em OK.
*Observação.* Não selecione o valor na lista drop-down.
@@ -234,7 +248,9 @@
</session-factory>
</hibernate-configuration>
----
-7. Salve as alterações feitas no arquivo.
+
+[start=7]
+. Salve as alterações feitas no arquivo.
Quando você executar seu projeto, poderá visualizar a consulta SQL impressa na janela de Saída do IDE.
@@ -320,11 +336,21 @@
Quando o texto default for deletado, o campo de texto é será contraído. É possível redimensionar o campo de texto em outro momento ao ajustar o alinhamento dos elementos do form.
-4. Arraste um elemento Label da Paleta e altere o texto para *Sobrenome*.
-5. Arraste um elemento Campo de texto para perto do label Sobrenome e delete o texto default.
-6. Arraste um elemento de Botão da Paleta e altere o texto para *Consulta*.
-7. Arraste um elemento Tabela da Paleta para dentro do form.
-8. Modifique os valores do Nome da Variável dos seguintes elementos da UI de acordo com os valores na tabela a seguir.
+
+[start=4]
+. Arraste um elemento Label da Paleta e altere o texto para *Sobrenome*.
+
+[start=5]
+. Arraste um elemento Campo de texto para perto do label Sobrenome e delete o texto default.
+
+[start=6]
+. Arraste um elemento de Botão da Paleta e altere o texto para *Consulta*.
+
+[start=7]
+. Arraste um elemento Tabela da Paleta para dentro do form.
+
+[start=8]
+. Modifique os valores do Nome da Variável dos seguintes elementos da UI de acordo com os valores na tabela a seguir.
Você pode modificar o valor do Nome da Variável de um elemento clicando com o botão direito do mouse no elemento na view Design e, em seguida, escolhendo Alterar Nome da Variável. De modo alternativo, você pode alterar o Nome da Variável diretamente na janela Inspetor.
@@ -341,11 +367,15 @@
|Tabela | ``resultTable``
|===
-9. Redimensione os campos de texto e alinhe os elementos do form.
+
+[start=9]
+. Redimensione os campos de texto e alinhe os elementos do form.
É possível ativar a propriedade Redimensionável na Horizontal dos campos de texto para garantir que os campos de texto sejam redimensionados com a janela e que o espaçamento entre os elementos permaneçam constantes.
-10. Salve as alterações.
+
+[start=10]
+. Salve as alterações.
Na view Design, seu form deve parecer com a imagem a seguir.
@@ -364,14 +394,22 @@
Quando você clica em Compilar, o IDE submete a download os artefatos necessários para seu repositório Maven local.
-2. Expanda o nó do pacote de código-fonte ``<pacote default>`` sob o nó Outros Códigos-fonte na janela Projetos.
-3. Clique com o botão direito do mouse em ``hibernate.cfg.xml`` e escolha Executar Consulta HQL para abrir o Editor HQL.
-4. Teste a conexão inserindo ``from Actor`` no Editor de Consultas HQL. Clique no botão Executar Consulta HQL ( image::images/run_hql_query_16.png[title="Botão Executar Consulta HQL"] ) na barra de ferramentas.
+
+[start=2]
+. Expanda o nó do pacote de código-fonte ``<pacote default>`` sob o nó Outros Códigos-fonte na janela Projetos.
+
+[start=3]
+. Clique com o botão direito do mouse em ``hibernate.cfg.xml`` e escolha Executar Consulta HQL para abrir o Editor HQL.
+
+[start=4]
+. Teste a conexão inserindo ``from Actor`` no Editor de Consultas HQL. Clique no botão Executar Consulta HQL ( image::images/run_hql_query_16.png[title="Botão Executar Consulta HQL"] ) na barra de ferramentas.
Quando você clicar em Executar Consulta HQL, deverá visualizar os resultados da consulta no painel inferior do Editor de Consultas HQL.
image::images/hib-query-hqlresults.png[title="Hql Editor de Consulta mostrando resultados da consulta HQL"]
-5. Digite a consulta a seguir no Editor de Consultas HQL e clique em Executar consulta HQL para verificar os resultados da consulta quando a string de pesquisa for "PE".
+
+[start=5]
+. Digite a consulta a seguir no Editor de Consultas HQL e clique em Executar consulta HQL para verificar os resultados da consulta quando a string de pesquisa for "PE".
[source,java]
----
@@ -389,7 +427,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. Abra uma nova guia do Editor de Consulta HQL e insira a consulta a seguir no painel do editor. Clique em Executar Consulta HQL.
+
+[start=6]
+. Abra uma nova guia do Editor de Consulta HQL e insira a consulta a seguir no painel do editor. Clique em Executar Consulta HQL.
[source,java]
----
@@ -422,7 +462,9 @@
É possível copiar as consultas das guias do Editor de Consulta HQL para o campo e, em seguida, modificar o código.
-3. Adicione os métodos a seguir para criar a consulta com base na string de entrada do usuário.
+
+[start=3]
+. Adicione os métodos a seguir para criar a consulta com base na string de entrada do usuário.
[source,java]
----
@@ -438,7 +480,9 @@
Esses métodos chamam o método ``executeHQLQuery()`` e cria a consulta combinando a string de consulta com o usuário que inseriu a string de pesquisa.
-4. Adicione o método ``executeHQLQuery()`` .
+
+[start=4]
+. Adicione o método ``executeHQLQuery()`` .
[source,java]
----
@@ -459,12 +503,18 @@
O método ``executeHQLQuery()`` chama o Hibernate para executar a consulta selecionada. Esse método usa a classe de utilitário ``HibernateUtil.java`` para obter a Sessão Hibernate.
-5. Corrija suas importações e adicione instruções para as bibliotecas Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) e ``java.util.List`` .
-6. Crie um handler de eventos do botão Consulta alternando para a view Design e clicando duas vezes no botão Consulta.
+
+[start=5]
+. Corrija suas importações e adicione instruções para as bibliotecas Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) e ``java.util.List`` .
+
+[start=6]
+. Crie um handler de eventos do botão Consulta alternando para a view Design e clicando duas vezes no botão Consulta.
O IDE cria o método ``queryButtonActionPerformed`` e exibe o método na view Código-fonte.
-7. Modifique o método ``queryButtonActionPerformed`` na view Código-fonte adicionando o código a seguir de modo que uma consulta seja executada quando o usuário clicar no botão.
+
+[start=7]
+. Modifique o método ``queryButtonActionPerformed`` na view Código-fonte adicionando o código a seguir de modo que uma consulta seja executada quando o usuário clicar no botão.
[source,java]
----
@@ -477,7 +527,9 @@
}*
}
----
-8. Adicione o método a seguir para exibir os resultados na JTable.
+
+[start=8]
+. Adicione o método a seguir para exibir os resultados na JTable.
[source,java]
----
@@ -502,7 +554,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Corrija as importações (Ctrl+Shift+I) para adicionar o ``java.util.Vector`` e salve as alterações.
+
+[start=9]
+. Corrija as importações (Ctrl+Shift+I) para adicionar o ``java.util.Vector`` e salve as alterações.
Depois de salvar o form, você pode executar o projeto.
@@ -525,7 +579,9 @@
De modo alternativo, você pode clicar no botão Procurar e escolher a classe principal na caixa de diálogo.
image::images/browse-main-class.png[title="Definindo a Classe Principal na caixa de diálogo Procurar Classes Principais"]
-4. Clique em Executar Projeto principal na barra de ferramentas principal para iniciar a aplicação.
+
+[start=4]
+. Clique em Executar Projeto principal na barra de ferramentas principal para iniciar a aplicação.
Quando a ação Executar é chamada em um projeto Maven no IDE, o IDE executa os objetivos Maven associados com a ação Executar. O IDE possui objetivos default vinculados às ações do IDE de acordo com o pacote do projeto. É possível exibir os objetivos vinculados à ação Executar no painel Ações da janela Propriedades do projeto
@@ -550,14 +606,24 @@
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 nas Pastas do Repositório:
-4. Expanda o nó-raiz e selecione *samples/java/DVDStoreAdmin-Maven*. 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 nas Pastas do Repositório:
+
+[start=4]
+. Expanda o nó-raiz e selecione *samples/java/DVDStoreAdmin-Maven*. 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ções.*
@@ -585,13 +651,19 @@
private Date lastUpdate;*
}
----
-4. Gere os getters e setters para os campos colocando o cursor de inserção no editor de código-fonte, digitando Alt-Insert e, em seguida, selecionando Getter e Setter.
-5. Na caixa de diálogo Gerar Getters e Setters, selecione todos os campos e clique em Gerar.
+
+[start=4]
+. Gere os getters e setters para os campos colocando o cursor de inserção no editor de código-fonte, digitando Alt-Insert e, em seguida, selecionando Getter e Setter.
+
+[start=5]
+. Na caixa de diálogo Gerar Getters e Setters, selecione todos os campos e clique em Gerar.
image::images/getters-setters.png[title="Caixa de diálogo Gerar Getters e Setters"]
Na caixa de diálogo Gerar Getters e Setters, você pode usar a seta para cima no teclado para mover o item selecionado para o nó Ator e pressionar a barra de espaços para selecionar todos os campos em Ator.
-6. Corrija as importações e salve as alterações.
+
+[start=6]
+. Corrija as importações e salve as alterações.
Depois de criar o POJO para a tabela, você desejará criar um arquivo de mapeamento do Hibernate para ``Actor.java`` .
@@ -612,7 +684,9 @@
</session-factory>
</hibernate-configuration>
----
-6. Associe os campos ``Actor.java`` às colunas na tabela ACTOR fazendo as seguintes alterações (em negrito) no ``Actor.hbm.xml`` .
+
+[start=6]
+. Associe os campos ``Actor.java`` às colunas na tabela ACTOR fazendo as seguintes alterações (em negrito) no ``Actor.hbm.xml`` .
[source,xml]
----
@@ -649,7 +723,9 @@
</class>*
</hibernate-mapping>
----
-7. Clique no botão Validar XML na barra de ferramentas e salve as alterações.
+
+[start=7]
+. Clique no botão Validar XML na barra de ferramentas e salve as alterações.
A criação de POJOs individuais e arquivos de mapeamento do Hibernate pode ser um modo conveniente de personalizar ainda mais sua aplicação.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ru.asciidoc
index 01afccc..79894a5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_ru.asciidoc
@@ -81,7 +81,9 @@
При нажатии клавиши OК среда IDE запустит сценарий, который создаст базу данных Sakila и заполнит ее таблицы. Результаты работы сценария можно увидеть в окне "Результаты". В серверный узел MySQL будет добавлен подузел для базы данных Sakila.
-5. Щелкните правой кнопкой мыши узел "Sakila" и выберите "Connect".
+
+[start=5]
+. Щелкните правой кнопкой мыши узел "Sakila" и выберите "Connect".
При нажатии кнопки "Подключиться" узел подключения к базе данных "Sakila" ( ``jdbc:mysql://localhost:3306/sakila [по умолчанию: _username_]`` ) появится под узлом "Базы данных". При открытом подключении для просмотра данных в базе данных разверните этот узел подключения.
@@ -96,7 +98,9 @@
Можно использовать версию Maven, входящую в комплект среды IDE, либо указать местоположение локальной установки Maven (требуется версия 2.0.9 или более поздняя).
-4. Для закрытия окна "Параметры" нажмите кнопку "ОК".
+
+[start=4]
+. Для закрытия окна "Параметры" нажмите кнопку "ОК".
*Примечания.*
@@ -144,12 +148,18 @@
1. Выберите 'Файл' > 'Новый проект' (Ctrl-Shift-N; ⌘-Shift-N в Mac) в главном меню, чтобы открыть мастер создания проектов.
2. Выберите приложение Java из категорий Maven. Нажмите кнопку "Далее".
image::images/maven-project-wizard.png[title="Архетипы Maven в мастере создания проектов"]
-3. Введите *DVDStoreAdmin* в качестве имени проекта и укажите местоположение проекта.
-4. Измените указанные по умолчанию значения для "Group Id" и "Version" (необязательно).
+
+[start=3]
+. Введите *DVDStoreAdmin* в качестве имени проекта и укажите местоположение проекта.
+
+[start=4]
+. Измените указанные по умолчанию значения для "Group Id" и "Version" (необязательно).
Значения "Group Id" и "Version" используются в качестве координат артефакта в локальном репозитории при создании проекта.
-5. Нажмите кнопку "Завершить".
+
+[start=5]
+. Нажмите кнопку "Завершить".
После нажатия кнопки "Готово" проект Maven будет создан в среде IDE и открыт в окне "Проекты". Среда IDE автоматически создает класс ``App.java`` в пакете ``com.mycompany.dvdstoreadmin`` . Вы можете удалить этот класс ( ``App.java`` ), поскольку он не требуется приложению для работы.
@@ -209,8 +219,12 @@
3. Нажмите кнопку "Add" для открытия диалогового окна "Add Hibernate Property".
4. В диалоговом окне выберите свойство ``hibernate.show_sql`` и установите значение ``true`` . Нажмите кнопку "ОК". Это приведет ко включению протоколирования отладки операторов SQL.
image::images/add-property-showsql.png[title="Диалоговое окно 'Добавить свойство Hibernate', в котором отображаются значения настроек для свойства hibernate.show_sql"]
-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* в текстовое поле. Нажмите кнопку "ОК".
*Примечание.* Не выбирайте значение из раскрывающегося списка.
@@ -234,7 +248,9 @@
</session-factory>
</hibernate-configuration>
----
-7. Сохраните измененный файл.
+
+[start=7]
+. Сохраните измененный файл.
После запуска приложения появится возможность просмотра запроса SQL, представленного в окне "Output" среды IDE.
@@ -320,11 +336,21 @@
При удалении текста по умолчанию текстовое поле сворачивается. Позже можно будет изменить размер текстового поля для настройки выравнивания элементов формы.
-4. Перетащите элемент "Label" с палитры и измените текст на *Last Name*.
-5. Перетащите элемент "Text Field", поместите его рядом с меткой "Last Name" и удалите текст по умолчанию.
-6. Перетащите элемент "Button" с палитры и измените текст на *Query*.
-7. Перетащите элемент "Table" с палитры в форму.
-8. Измените значения "Variable Name" следующих элементов пользовательского интерфейса в соответствии со значениями, приведенными в следующей таблице.
+
+[start=4]
+. Перетащите элемент "Label" с палитры и измените текст на *Last Name*.
+
+[start=5]
+. Перетащите элемент "Text Field", поместите его рядом с меткой "Last Name" и удалите текст по умолчанию.
+
+[start=6]
+. Перетащите элемент "Button" с палитры и измените текст на *Query*.
+
+[start=7]
+. Перетащите элемент "Table" с палитры в форму.
+
+[start=8]
+. Измените значения "Variable Name" следующих элементов пользовательского интерфейса в соответствии со значениями, приведенными в следующей таблице.
Вы можете изменить значение 'Имя переменной' для элемента, щелкнув правой кнопкой мыши элемент в представлении конструктора и выбрав 'Изменить имя переменной'. Кроме того, значение "Variable Name" можно изменить непосредственно в окне "Inspector".
@@ -341,11 +367,15 @@
|Таблица | ``resultTable``
|===
-9. Измените размер текстового поля и выровняйте элементы формы.
+
+[start=9]
+. Измените размер текстового поля и выровняйте элементы формы.
Можно активировать свойство "Переменная ширина" для текстовых полей, чтобы обеспечить изменение размера текстовых полей вместе с окном и идентичность расстояний между элементами.
-10. Сохраните изменения.
+
+[start=10]
+. Сохраните изменения.
В режиме проектирования внешний вид формы выглядит так, как показано на следующем рисунке.
@@ -364,14 +394,22 @@
При нажатии кнопки "Сборка" IDE загрузит необходимые артефакты в локальный репозиторий Maven.
-2. Раскройте узел исходного пакета ``<default package>`` в узле "Другие исходные файлы" окна "Проекты".
-3. Щелкните правой кнопкой мыши файл ``hibernate.cfg.xml`` и выберите "Run HQL Query" для открытия редактора HQL Editor.
-4. Протестируйте подключение путем ввода ``from Actor`` в редакторе запросов HQL Query Editor. Нажмите кнопку 'Выполнить запрос HQL' ( image::images/run_hql_query_16.png[title="Кнопка 'Выполнить запрос HQL'"] ) на панели инструментов.
+
+[start=2]
+. Раскройте узел исходного пакета ``<default package>`` в узле "Другие исходные файлы" окна "Проекты".
+
+[start=3]
+. Щелкните правой кнопкой мыши файл ``hibernate.cfg.xml`` и выберите "Run HQL Query" для открытия редактора HQL Editor.
+
+[start=4]
+. Протестируйте подключение путем ввода ``from Actor`` в редакторе запросов HQL Query Editor. Нажмите кнопку 'Выполнить запрос HQL' ( image::images/run_hql_query_16.png[title="Кнопка 'Выполнить запрос HQL'"] ) на панели инструментов.
При нажатии кнопки "Run HQL Query" результаты запроса должны отображаться в нижней области редактора запросов HQL Query Editor.
image::images/hib-query-hqlresults.png[title="Редактор запросов HQL с отображением результатов запроса HQL"]
-5. Введите следующий запрос в редактор запросов HQL Query Editor и нажмите кнопку "Выполнить запрос HQL" для проверки результатов запроса при вводе значения "PE" в строку поиска.
+
+[start=5]
+. Введите следующий запрос в редактор запросов HQL Query Editor и нажмите кнопку "Выполнить запрос HQL" для проверки результатов запроса при вводе значения "PE" в строку поиска.
[source,java]
----
@@ -389,7 +427,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. Откройте новую вкладку редактора HQL Query Editor и введите следующий запрос на панели редактирования. Нажмите кнопку "Run HQL Query".
+
+[start=6]
+. Откройте новую вкладку редактора HQL Query Editor и введите следующий запрос на панели редактирования. Нажмите кнопку "Run HQL Query".
[source,java]
----
@@ -422,7 +462,9 @@
Запросы можно скопировать из вкладок редактора запросов HQL Query Editor в файл, а затем изменить код.
-3. Добавьте следующие методы для создания запроса на основе строки со вводимой пользователем информацией.
+
+[start=3]
+. Добавьте следующие методы для создания запроса на основе строки со вводимой пользователем информацией.
[source,java]
----
@@ -438,7 +480,9 @@
Эти методы обеспечивают вызов метода с именем ``executeHQLQuery()`` и создание запроса путем объединения строки запроса с информацией пользователя, вводимой в строку поиска.
-4. Добавьте метод ``executeHQLQuery()`` .
+
+[start=4]
+. Добавьте метод ``executeHQLQuery()`` .
[source,java]
----
@@ -459,12 +503,18 @@
Метод ``executeHQLQuery()`` обеспечивает вызов библиотеки Hibernate для выполнения выбранного запроса. В этом методе служебный класс ``HibernateUtil.java`` применяется для получения объекта Hibernate "Session".
-5. Исправьте параметры импорта для добавления операторов импорта в библиотеки Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) и ``java.util.List`` .
-6. Создайте обработчик событий для кнопки "Query", переключившись в режим проектирования и дважды нажав кнопку "Query".
+
+[start=5]
+. Исправьте параметры импорта для добавления операторов импорта в библиотеки Hibernate ( ``org.hibernate.Query`` , ``org.hibernate.Session`` ) и ``java.util.List`` .
+
+[start=6]
+. Создайте обработчик событий для кнопки "Query", переключившись в режим проектирования и дважды нажав кнопку "Query".
В среде IDE будет создан метод ``queryButtonActionPerformed`` , который затем отобразится в режиме просмотра исходного кода.
-7. Измените метод ``queryButtonActionPerformed`` в режиме просмотра исходного кода путем добавления следующего кода, обеспечивающего выполнение запроса при нажатии кнопки пользователем.
+
+[start=7]
+. Измените метод ``queryButtonActionPerformed`` в режиме просмотра исходного кода путем добавления следующего кода, обеспечивающего выполнение запроса при нажатии кнопки пользователем.
[source,java]
----
@@ -477,7 +527,9 @@
}*
}
----
-8. Добавьте следующий метод для просмотра результатов в "JTable".
+
+[start=8]
+. Добавьте следующий метод для просмотра результатов в "JTable".
[source,java]
----
@@ -502,7 +554,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. Исправьте параметры импорта (CTRL+SHIFT+I) для добавления ``java.util.Vector`` и сохраните измененные данные.
+
+[start=9]
+. Исправьте параметры импорта (CTRL+SHIFT+I) для добавления ``java.util.Vector`` и сохраните измененные данные.
После сохранения формы можно запустить проект.
@@ -525,7 +579,9 @@
В качестве альтернативы можно нажать кнопку "Browse" и выбрать главный класс в диалоговом окне.
image::images/browse-main-class.png[title="Установка главного класса в диалоговом окне 'Обзор главных классов'"]
-4. Нажмите кнопку "Run Project" на главной панели инструментов для запуска приложения.
+
+[start=4]
+. Нажмите кнопку "Run Project" на главной панели инструментов для запуска приложения.
При вызове в среде IDE в проекте Maven операции Run параметры Maven выполняются в среде IDE совместно с операцией Run. Среда IDE имеет цели по умолчанию, связанные с операциями IDE, соответствующими упаковке проекта. Связанные с операцией Run цели можно просмотреть на панели "Действия" окна "Свойства" проекта.
@@ -550,14 +606,24 @@
2. В диалоговом окне "Проверка" введите следующий URL-адрес репозитория:
``https://svn.netbeans.org/svn/samples~samples-source-code``
Нажмите кнопку "Далее".
-3. Нажмите кнопку "Обзор" для открытия диалогового окна "Обзор папок репозитория".
-4. Разверните корневой узел и выберите *samples/java/DVDStoreAdmin-Maven*. Нажмите кнопку "ОК".
-5. Укажите локальную папку для исходных файлов (папка должна быть пустой).
-6. Нажмите кнопку "Завершить".
+
+[start=3]
+. Нажмите кнопку "Обзор" для открытия диалогового окна "Обзор папок репозитория".
+
+[start=4]
+. Разверните корневой узел и выберите *samples/java/DVDStoreAdmin-Maven*. Нажмите кнопку "ОК".
+
+[start=5]
+. Укажите локальную папку для исходных файлов (папка должна быть пустой).
+
+[start=6]
+. Нажмите кнопку "Завершить".
После нажатия кнопки "Готово" среда IDE инициализирует локальную папку в качестве репозитория Subversion и выполняет проверку исходных файлов проекта на выходе.
-7. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
+
+[start=7]
+. Щелкните команду "Открыть проект" в диалоговом окне, которое появится после завершения проверки.
*Примечания.*
@@ -585,13 +651,19 @@
private Date lastUpdate;*
}
----
-4. Создайте методы получения и установки для полей, поместив курсор вставки в редактор исходного кода и введя Alt-Insert, а затем выбрав Getter и Setter.
-5. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
+
+[start=4]
+. Создайте методы получения и установки для полей, поместив курсор вставки в редактор исходного кода и введя Alt-Insert, а затем выбрав Getter и Setter.
+
+[start=5]
+. В диалоговом окне "Generate Getters and Setters" выберите все поля и нажмите кнопку "Generate".
image::images/getters-setters.png[title="Диалоговое окно 'Создание методов получения и установки'"]
В диалоговом окне "Generate Getters and Setters" можно использовать стрелку вверх на клавиатуре для перемещения выбранного элемента к узлу "Actor", а затем нажать клавишу "пробел" и выбрать все поля "Actor".
-6. Исправьте операторы импорта и сохраните измененные данные.
+
+[start=6]
+. Исправьте операторы импорта и сохраните измененные данные.
После создания объекта POJO для таблицы необходимо создать файл сопоставления библиотеки Hibernate для класса ``Actor.java`` .
@@ -612,7 +684,9 @@
</session-factory>
</hibernate-configuration>
----
-6. Сопоставьте поля в ``Actor.java`` со столбцами в таблице "ACTOR" путем внесения следующих изменений (выделены полужирным шрифтом) в ``Actor.hbm.xml`` .
+
+[start=6]
+. Сопоставьте поля в ``Actor.java`` со столбцами в таблице "ACTOR" путем внесения следующих изменений (выделены полужирным шрифтом) в ``Actor.hbm.xml`` .
[source,xml]
----
@@ -649,7 +723,9 @@
</class>*
</hibernate-mapping>
----
-7. Нажмите кнопку "Validate XML" на панели инструментов и сохраните изменения.
+
+[start=7]
+. Нажмите кнопку "Validate XML" на панели инструментов и сохраните изменения.
Создание объектов POJO и файлов сопоставления библиотеки Hibernate может эффективно использоваться для дальнейшей настройки приложения.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_zh_CN.asciidoc
index f76e3a4..3e8ad9c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/maven-hib-java-se_zh_CN.asciidoc
@@ -79,7 +79,9 @@
单击 "OK"（确定）后，IDE 将运行脚本以创建 Sakila 数据库，并填充数据库表。您可以在 "Output"（输出）窗口中查看运行脚本的结果。此时，还会在 MySQL 服务器节点下方添加 Sakila 数据库的节点。
-5. 右键单击 "Sakila" 节点，然后选择 "Connect"（连接）。
+
+[start=5]
+. 右键单击 "Sakila" 节点，然后选择 "Connect"（连接）。
单击 "Connect"（连接）后，"Databases"（数据库）节点下面将列出 Sakila 数据库连接节点 ( ``jdbc:mysql://localhost:3306/sakila [_username_ on Default]`` )。打开连接时，可通过展开该连接节点查看数据库中数据。
@@ -94,7 +96,9 @@
您可以使用与 IDE 捆绑在一起的 Maven 版本，也可以指定 Maven 在本地的安装位置（要求为 2.0.9 或更高版本）。
-4. 选择 "OK"（确定）以关闭 "Options"（选项）窗口。
+
+[start=4]
+. 选择 "OK"（确定）以关闭 "Options"（选项）窗口。
*注：*
@@ -142,12 +146,18 @@
1. 从主菜单中选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键；在 Mac 上为 ⌘-Shift-N 组合键），以打开新建项目向导。
2. 从 "Maven" 类别中选择 "Java Application"（Java 应用程序）。单击 "Next"（下一步）。
image::images/maven-project-wizard.png[title="新建项目向导中的 "Maven Archetypes"（Maven 原型）"]
-3. 键入 *DVDStoreAdmin* 作为项目名称并设置项目位置。
-4. 修改默认的组 ID 和版本（可选）。
+
+[start=3]
+. 键入 *DVDStoreAdmin* 作为项目名称并设置项目位置。
+
+[start=4]
+. 修改默认的组 ID 和版本（可选）。
构建项目时，组 ID 和版本将作为工件在本地资源库中的坐标使用。
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
单击 "Finish"（完成）后，IDE 将创建 Maven 项目并在 "Projects"（项目）窗口中打开该项目。IDE 将自动在 ``com.mycompany.dvdstoreadmin`` 包中创建类 ``App.java`` 。您可以删除 ``App.java`` ，因为应用程序不需要使用该类。
@@ -207,8 +217,12 @@
3. 单击 "Add"（添加）以打开 "Add Hibernate Property"（添加 Hibernate 属性）对话框。
4. 在此对话框中，选择 ``hibernate.show_sql`` 属性并将值设置为 ``true`` 。单击 "OK"（确定）。这将启用 SQL 语句的调试日志记录。
image::images/add-property-showsql.png[title="显示 hibernate.show_sql 属性的设置值的 "Add Hibernate Property"（添加 Hibernate 属性）对话框"]
-5. 单击 "Miscellaneous Properties"（其他属性）节点下的 "Add"（添加），然后选择 "Property Name"（属性名称）下拉列表中的 ``hibernate.query.factory_class`` 。
-6. 在文本字段中键入 *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory*。单击 "OK"（确定）。
+
+[start=5]
+. 单击 "Miscellaneous Properties"（其他属性）节点下的 "Add"（添加），然后选择 "Property Name"（属性名称）下拉列表中的 ``hibernate.query.factory_class`` 。
+
+[start=6]
+. 在文本字段中键入 *org.hibernate.hql.internal.classic.ClassicQueryTranslatorFactory*。单击 "OK"（确定）。
*注：*不要从下拉列表中选择值。
@@ -232,7 +246,9 @@
</session-factory>
</hibernate-configuration>
----
-7. 保存对该文件所做的更改。
+
+[start=7]
+. 保存对该文件所做的更改。
运行项目时，您将能够在 IDE 的 "Output"（输出）窗口中看到输出的 SQL 查询。
@@ -318,11 +334,21 @@
删除默认文本后，文本字段将折叠起来。您可以稍后调整文本字段的大小，以调整窗体元素的对齐方式。
-4. 从 "Palette"（组件面板）中拖出一个 "Label"（标签）元素，并将文本更改为 *Last Name*。
-5. 拖放一个 "Text Field"（文本字段）元素到 "Last Name" 标签旁边，并删除默认文本。
-6. 从 "Palette"（组件面板）中拖出一个 "Button"（按钮）元素，并将文本更改为 *Query*。
-7. 从 "Palette"（组件面板）中拖放一个 "Table"（表）元素到窗体中。
-8. 根据下表中的值更改以下 UI 元素的 "Variable Name"（变量名称）值。
+
+[start=4]
+. 从 "Palette"（组件面板）中拖出一个 "Label"（标签）元素，并将文本更改为 *Last Name*。
+
+[start=5]
+. 拖放一个 "Text Field"（文本字段）元素到 "Last Name" 标签旁边，并删除默认文本。
+
+[start=6]
+. 从 "Palette"（组件面板）中拖出一个 "Button"（按钮）元素，并将文本更改为 *Query*。
+
+[start=7]
+. 从 "Palette"（组件面板）中拖放一个 "Table"（表）元素到窗体中。
+
+[start=8]
+. 根据下表中的值更改以下 UI 元素的 "Variable Name"（变量名称）值。
您可以更改元素的 "Variable Name"（变量名称）值，方法是右键单击 "Design"（设计）视图中的元素并选择 "Change Variable Name"（更改变量名称）。或者，您可以直接在 "Inspector"（检查器）窗口中更改变量名称。
@@ -339,11 +365,15 @@
|表 | ``resultTable``
|===
-9. 调整文本字段的大小并对齐窗体元素。
+
+[start=9]
+. 调整文本字段的大小并对齐窗体元素。
您可以对文本字段启用 "Horizontal Resizable"（可水平调整大小）属性，以确保文本字段的大小可随窗口进行调整且元素间距保持不变。
-10. 保存所做的更改。
+
+[start=10]
+. 保存所做的更改。
在 "Design"（设计）视图中，您的窗体应与下图类似。
@@ -362,14 +392,22 @@
单击 "Build"（构建）后，IDE 会将所需的工件下载到您本地的 Maven 资源库。
-2. 在 "Projects"（项目）窗口中的 "Other Sources"（其他源）节点下展开 ``<默认包>`` 源包节点。
-3. 右键单击 ``hibernate.cfg.xml`` 配置文件，然后选择 "Run HQL Query"（运行 HQL 查询）以打开 HQL 编辑器。
-4. 通过在 HQL 查询编辑器中键入 ``from Actor`` 来测试连接。单击工具栏中的 "Run HQL Query"（运行 HQL 查询）按钮 (image::images/run_hql_query_16.png[title=""Run HQL Query"（运行 HQL 查询）按钮"])。
+
+[start=2]
+. 在 "Projects"（项目）窗口中的 "Other Sources"（其他源）节点下展开 ``<默认包>`` 源包节点。
+
+[start=3]
+. 右键单击 ``hibernate.cfg.xml`` 配置文件，然后选择 "Run HQL Query"（运行 HQL 查询）以打开 HQL 编辑器。
+
+[start=4]
+. 通过在 HQL 查询编辑器中键入 ``from Actor`` 来测试连接。单击工具栏中的 "Run HQL Query"（运行 HQL 查询）按钮 (image::images/run_hql_query_16.png[title=""Run HQL Query"（运行 HQL 查询）按钮"])。
单击 "Run HQL Query"（运行 HQL 查询）按钮之后，您应该能在 HQL 查询编辑器的底部窗格中看到查询结果。
image::images/hib-query-hqlresults.png[title="显示 HQL 查询结果的 HQL 查询编辑器"]
-5. 在 HQL 查询编辑器中键入以下查询，然后单击 "Run HQL Query"（运行 HQL 查询）查询搜索字符串为 "PE" 时的查询结果。
+
+[start=5]
+. 在 HQL 查询编辑器中键入以下查询，然后单击 "Run HQL Query"（运行 HQL 查询）查询搜索字符串为 "PE" 时的查询结果。
[source,java]
----
@@ -387,7 +425,9 @@
select actor0_.actor_id as col_0_0_ from sakila.actor actor0_ where (actor0_.first_name like 'PE%' )
----
-6. 打开一个新的 HQL 查询编辑器标签，在编辑器窗格中键入以下查询。单击 "Run HQL Query"（运行 HQL 查询）按钮。
+
+[start=6]
+. 打开一个新的 HQL 查询编辑器标签，在编辑器窗格中键入以下查询。单击 "Run HQL Query"（运行 HQL 查询）按钮。
[source,java]
----
@@ -420,7 +460,9 @@
可以将 HQL 查询编辑器标签中的查询复制到文件中，然后再修改代码。
-3. 添加以下方法，以根据用户输入字符串创建查询。
+
+[start=3]
+. 添加以下方法，以根据用户输入字符串创建查询。
[source,java]
----
@@ -436,7 +478,9 @@
这些方法调用一个名称为 ``executeHQLQuery()`` 的方法，并通过结合查询字符串与用户输入的搜索字符串来创建查询。
-4. 添加 ``executeHQLQuery()`` 方法。
+
+[start=4]
+. 添加 ``executeHQLQuery()`` 方法。
[source,java]
----
@@ -457,12 +501,18 @@
``executeHQLQuery()`` 方法调用 Hibernate 来执行选定的查询。该方法利用 ``HibernateUtil.java`` 实用程序类来获取 Hibernate 会话。
-5. 修复您的导入，为 Hibernate 库（ ``org.hibernate.Query`` , ``org.hibernate.Session`` ）和 ``java.util.List`` 添加导入语句。
-6. 切换到 "Design"（设计）视图并双击 "Query" 按钮，创建一个 "Query" 按钮事件处理程序。
+
+[start=5]
+. 修复您的导入，为 Hibernate 库（ ``org.hibernate.Query`` , ``org.hibernate.Session`` ）和 ``java.util.List`` 添加导入语句。
+
+[start=6]
+. 切换到 "Design"（设计）视图并双击 "Query" 按钮，创建一个 "Query" 按钮事件处理程序。
IDE 将创建 ``queryButtonActionPerformed`` 方法并在 "Source"（源）视图中显示该方法。
-7. 在 "Source"（源）视图中修改 ``queryButtonActionPerformed`` 方法，添加以下代码，以便查询能在用户单击按钮时正确运行。
+
+[start=7]
+. 在 "Source"（源）视图中修改 ``queryButtonActionPerformed`` 方法，添加以下代码，以便查询能在用户单击按钮时正确运行。
[source,java]
----
@@ -475,7 +525,9 @@
}*
}
----
-8. 添加以下方法，在 JTable 中显示结果。
+
+[start=8]
+. 添加以下方法，在 JTable 中显示结果。
[source,java]
----
@@ -500,7 +552,9 @@
resultTable.setModel(new DefaultTableModel(tableData, tableHeaders));
}
----
-9. 修复导入（Ctrl+Shift+I 组合键）以添加 ``java.util.Vector`` ，然后保存所做的更改。
+
+[start=9]
+. 修复导入（Ctrl+Shift+I 组合键）以添加 ``java.util.Vector`` ，然后保存所做的更改。
保存窗体之后，您可以运行项目。
@@ -523,7 +577,9 @@
或者，您可以单击 "Browse"（浏览）按钮并在对话框中选择主类。
image::images/browse-main-class.png[title="在 "Browse Main Classes"（浏览主类）对话框中设置主类"]
-4. 单击主工具栏中的 "Run Project"（运行项目）以启动应用程序。
+
+[start=4]
+. 单击主工具栏中的 "Run Project"（运行项目）以启动应用程序。
在 IDE 中对 Maven 项目调用 "Run"（运行）操作时，IDE 将运行与 "Run"（运行）操作关联的 Maven 目标。IDE 具有绑定到 IDE 操作的默认目标，这些目标依据项目包而定。在项目 "Properties"（属性）窗口的 "Actions"（操作）窗格中，可以查看绑定到 "Run"（运行）操作的目标。
@@ -548,14 +604,24 @@
2. 在 "Checkout"（检出）对话框中，输入以下资源库 URL：
``https://svn.netbeans.org/svn/samples~samples-source-code``
单击 "Next"（下一步）。
-3. 单击 "Browse"（浏览）以打开 "Browse Repostiory Folders"（浏览资源库文件夹）对话框。
-4. 展开根节点，然后选择 *samples/java/DVDStoreAdmin-Maven*。单击 "OK"（确定）。
-5. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
-6. 单击 "Finish"（完成）。
+
+[start=3]
+. 单击 "Browse"（浏览）以打开 "Browse Repostiory Folders"（浏览资源库文件夹）对话框。
+
+[start=4]
+. 展开根节点，然后选择 *samples/java/DVDStoreAdmin-Maven*。单击 "OK"（确定）。
+
+[start=5]
+. 指定用于存储源代码的本地文件夹（本地文件夹必须为空）。
+
+[start=6]
+. 单击 "Finish"（完成）。
单击 "Finish"（完成），此时 IDE 会将本地文件夹初始化为 Subversion 资源库，并检出项目源代码。
-7. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
+
+[start=7]
+. 在完成检出操作后将会显示一个对话框，在该对话框中单击 "Open Project"（打开项目）。
*注：*
@@ -583,13 +649,19 @@
private Date lastUpdate;*
}
----
-4. 为字段生成 getter 和 setter 方法，方法是将光标放置在源代码编辑器中，按下 Alt-Insert 并选择 "Getter and Setter"（Getter 和 Setter）。
-5. 在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，选择所有字段并单击 "Generate"（生成）。
+
+[start=4]
+. 为字段生成 getter 和 setter 方法，方法是将光标放置在源代码编辑器中，按下 Alt-Insert 并选择 "Getter and Setter"（Getter 和 Setter）。
+
+[start=5]
+. 在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，选择所有字段并单击 "Generate"（生成）。
image::images/getters-setters.png[title=""Generate Getters and Setters"（生成 getter 和 setter）对话框"]
在 "Generate Getters and Setters"（生成 Getter 和 Setter）对话框中，您可以使用键盘中的向上箭头将所选项目移动到 Actor 节点中，然后按空格键选择 Actor 中的所有字段。
-6. 修复导入并保存更改。
+
+[start=6]
+. 修复导入并保存更改。
为表创建 POJO 之后，您需要为 ``Actor.java`` 创建一个 Hibernate 映射文件。
@@ -610,7 +682,9 @@
</session-factory>
</hibernate-configuration>
----
-6. 对 ``Actor.hbm.xml`` 执行以下更改（黑体），将 ``Actor.java`` 中的字段映射到 ACTOR 表中的列。
+
+[start=6]
+. 对 ``Actor.hbm.xml`` 执行以下更改（黑体），将 ``Actor.java`` 中的字段映射到 ACTOR 表中的列。
[source,xml]
----
@@ -647,7 +721,9 @@
</class>*
</hibernate-mapping>
----
-7. 单击工具栏中的 "Validate XML"（验证 XML）按钮并保存更改。
+
+[start=7]
+. 单击工具栏中的 "Validate XML"（验证 XML）按钮并保存更改。
如果要进一步定制应用程序，单独创建 POJO 和 Hibernate 映射文件可能是一种非常方便的方法。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/native_pkg.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/native_pkg.asciidoc
index d357267..1771bef 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/native_pkg.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/native_pkg.asciidoc
@@ -121,8 +121,12 @@
image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
--
-4. In the Name and Location panel, leave the default values for the Project Name and Project Location fields.
-5. Click Finish.
+
+[start=4]
+. In the Name and Location panel, leave the default values for the Project Name and Project Location fields.
+
+[start=5]
+. Click Finish.
The IDE creates and opens the Java SE project.
To test that the created project works fine, run it by choosing Run > Run Project from the main menu.
@@ -149,7 +153,9 @@
image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
--
-3. Click OK.
+
+[start=3]
+. Click OK.
A Package as command is added to the project's context menu.
image::images/pkg_enabled.png[]
@@ -222,7 +228,9 @@
image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
--
-5. Click Finish.
+
+[start=5]
+. Click Finish.
The BrickBreaker JavaFX project displays in the Projects window in the IDE.
To test that the created project works fine, run it by choosing Run > Run Project(BrickBreaker) from the main menu.
@@ -252,7 +260,9 @@
image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
--
-3. Click OK.
+
+[start=3]
+. Click OK.
The Package as item is added to the project's context menu.
image::images/pkg_fx_enabled.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ja.asciidoc
index 67fbe1a..d60e45a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ja.asciidoc
@@ -131,8 +131,12 @@
image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
--
-4. 「名前と場所」パネルで、「プロジェクト名」および「プロジェクトの場所」フィールドのデフォルト値をそのままにします。
-5. 「終了」をクリックします。
+
+[start=4]
+. 「名前と場所」パネルで、「プロジェクト名」および「プロジェクトの場所」フィールドのデフォルト値をそのままにします。
+
+[start=5]
+. 「終了」をクリックします。
IDEによってJava SEプロジェクトが作成され、開かれます。
作成されたプロジェクトが正常に動作することをテストするには、メイン・メニューから「実行」>「プロジェクトの実行」を選択して実行します。
@@ -159,7 +163,9 @@
image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
--
-3. 「OK」をクリックします。
+
+[start=3]
+. 「OK」をクリックします。
「パッケージとして」コマンドがプロジェクトのコンテキスト・メニューに追加されます。
image::images/pkg_enabled.png[]
@@ -232,7 +238,9 @@
image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
--
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
IDEの「プロジェクト」ウィンドウにBrickBreaker JavaFXが表示されます。
作成されたプロジェクトが正常に動作することをテストするには、メイン・メニューから「実行」>「プロジェクトの実行(BrickBreaker)」を選択して実行します。
@@ -262,7 +270,9 @@
image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
--
-3. 「OK」をクリックします。
+
+[start=3]
+. 「OK」をクリックします。
「パッケージとして」項目がプロジェクトのコンテキスト・メニューに追加されます。
image::images/pkg_fx_enabled.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_pt_BR.asciidoc
index a3925cf..87e5ff8 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_pt_BR.asciidoc
@@ -131,8 +131,12 @@
image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
--
-4. No painel Nome e Local, deixe os valores default para os campos Nome do Projeto e Localização do Projeto.
-5. Clique em Finalizar.
+
+[start=4]
+. No painel Nome e Local, deixe os valores default para os campos Nome do Projeto e Localização do Projeto.
+
+[start=5]
+. Clique em Finalizar.
O IDE cria e abre o projeto Java SE.
Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto no menu principal.
@@ -159,7 +163,9 @@
image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
--
-3. Clique em OK.
+
+[start=3]
+. Clique em OK.
Um comando Encapsular como é adicionado ao menu de contexto do projeto.
image::images/pkg_enabled.png[]
@@ -232,7 +238,9 @@
image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
--
-5. Clique em Finalizar.
+
+[start=5]
+. Clique em Finalizar.
O projeto JavaFX do BrickBreaker é exibido na janela Projetos no IDE.
Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto (BrickBreaker) no menu principal.
@@ -262,7 +270,9 @@
image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
--
-3. Clique em OK.
+
+[start=3]
+. Clique em OK.
A opção Encapsular como item é adicionada ao menu de contexto do projeto.
image::images/pkg_fx_enabled.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ru.asciidoc
index b938e07..2fbc804 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_ru.asciidoc
@@ -131,8 +131,12 @@
image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
--
-4. На панели 'Имя и местоположение' оставьте без изменения данные в полях 'Имя проекта' и 'Местоположение проекта'.
-5. Нажмите 'Готово'.
+
+[start=4]
+. На панели 'Имя и местоположение' оставьте без изменения данные в полях 'Имя проекта' и 'Местоположение проекта'.
+
+[start=5]
+. Нажмите 'Готово'.
В IDE создается и открывается проект Java SE.
Чтобы проверить работоспособность проекта, запустите его с помощью команды 'Выполнить >Запуск проекта' в главном меню.
@@ -159,7 +163,9 @@
image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
--
-3. Нажмите ОК.
+
+[start=3]
+. Нажмите ОК.
В контекстном меню проекта появится команда 'Упаковать'.
image::images/pkg_enabled.png[]
@@ -232,7 +238,9 @@
image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
--
-5. Нажмите 'Готово'.
+
+[start=5]
+. Нажмите 'Готово'.
Проект JavaFX BrickBreaker отображается в IDE в окне 'Проекты'.
Чтобы проверить работоспособность проекта, запустите его с помощью команды 'Выполнить >Запуск проекта (BrickBreaker)' в главном меню.
@@ -262,7 +270,9 @@
image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
--
-3. Нажмите ОК.
+
+[start=3]
+. Нажмите ОК.
В контекстном меню проекта появится пункт 'Упаковать'.
image::images/pkg_fx_enabled.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_zh_CN.asciidoc
index 3d801b4..f0d3152 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/native_pkg_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/native_pkg_zh_CN.asciidoc
@@ -131,8 +131,12 @@
image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
--
-4. 在 "Name and Location"（名称和位置）面板中，保留 "Project Name"（项目名称）和 "Project Location"（项目位置）字段的默认值。
-5. 单击 "Finish"（完成）。
+
+[start=4]
+. 在 "Name and Location"（名称和位置）面板中，保留 "Project Name"（项目名称）和 "Project Location"（项目位置）字段的默认值。
+
+[start=5]
+. 单击 "Finish"（完成）。
IDE 将创建并打开 Java SE 项目。
要测试创建的项目是否正常运行，请通过从主菜单中选择 "Run"（运行）> "Run Project"（运行项目）来运行该项目。
@@ -159,7 +163,9 @@
image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
--
-3. 单击 "OK"（确定）。
+
+[start=3]
+. 单击 "OK"（确定）。
包将作为命令添加到项目的上下文菜单中。
image::images/pkg_enabled.png[]
@@ -232,7 +238,9 @@
image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
--
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
BrickBreaker JavaFX 项目将显示在 IDE 的 "Projects"（项目）窗口中。
要测试创建的项目是否正常运行，请通过从主菜单中选择 "Run"（运行）> "Run Project (BrickBreaker)"（运行项目 (BrickBreaker)）来运行该项目。
@@ -262,7 +270,9 @@
image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
--
-3. 单击 "OK"（确定）。
+
+[start=3]
+. 单击 "OK"（确定）。
包将作为项添加到项目的上下文菜单中。
image::images/pkg_fx_enabled.png[]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator.asciidoc
index 0674716..9d20865 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator.asciidoc
@@ -74,7 +74,9 @@
1. Choose Tools > Plugins from the main menu to open the Plugins manager.
2. Click the Available Plugins tab and select the checkboxes for the JMeter Kit and Load Generator plugins. Click Install.
image::images/generator-plugin.png[title="Load Generator plugins in Plugins manager"]
-3. Step through the installer to download and install the plugins and click Finish. Click Close to close the Plugins Manager.
+
+[start=3]
+. Step through the installer to download and install the plugins and click Finish. Click Close to close the Plugins Manager.
After installing the plugins, the category Load Testing Scripts is added to the New File wizard.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ja.asciidoc
index 6ec5eeb..6e24779 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ja.asciidoc
@@ -79,7 +79,9 @@
1. メイン・メニューから「ツール」>「プラグイン」を選択して、プラグイン・マネージャを開きます。
2. 「使用可能なプラグイン」タブをクリックし、JMeter Kitおよび負荷ジェネレータ・プラグインのチェックボックスを選択します。「インストール」をクリックします。
image::images/generator-plugin.png[title="プラグイン・マネージャの負荷ジェネレータ・プラグイン"]
-3. インストーラの手順に従ってプラグインをダウンロードおよびインストールし、「終了」をクリックします。「閉じる」をクリックしてプラグイン・マネージャを終了します。
+
+[start=3]
+. インストーラの手順に従ってプラグインをダウンロードおよびインストールし、「終了」をクリックします。「閉じる」をクリックしてプラグイン・マネージャを終了します。
プラグインをインストールすると、新規ファイル・ウィザードに負荷テスト・スクリプト・カテゴリが追加されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_pt_BR.asciidoc
index 6748a39..d021a0a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_pt_BR.asciidoc
@@ -72,7 +72,9 @@
1. Escolha Ferramentas > Plug-ins no menu principal para abrir o gerenciador de Plug-ins.
2. Clique na guia Plug-ins Disponíveis e marque as caixas de seleção dos plug-ins Kit do JMeter e Gerador de Carga. Clique em Instalar.
image::images/generator-plugin.png[title="Plug-ins do Gerador de Carga no Gerenciador de plug-ins"]
-3. Acompanhe as páginas do instalador para fazer download e instalar os plug-ins e clique em Finalizar. Clique em Fechar para sair do Gerenciador de Plug-ins.
+
+[start=3]
+. Acompanhe as páginas do instalador para fazer download e instalar os plug-ins e clique em Finalizar. Clique em Fechar para sair do Gerenciador de Plug-ins.
Depois de instalar os plug-ins, a categoria Scripts de Teste de Carga é adicionada ao assistente Novo Arquivo.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ru.asciidoc
index 509ffef..b308187 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_ru.asciidoc
@@ -72,7 +72,9 @@
1. Выберите "Tools" > "Plugins" (Сервис > Подключаемые модули) в главном меню, чтобы открыть диспетчер подключаемых модулей.
2. Перейдите на вкладку 'Доступные подключаемые модули' и установите флажки для подключаемых модулей JMeter Kit и Load Generator. Нажмите кнопку "Установить".
image::images/generator-plugin.png[title="Подключаемый модуль генератора загрузки в диспетчере подключаемых модулей"]
-3. Дождитесь, пока программа установки загрузит и установит подключаемые модули, затем нажмите кнопку "Готово". Нажмите кнопку "Закрыть, чтобы выйти из диспетчера подключаемых модулей.
+
+[start=3]
+. Дождитесь, пока программа установки загрузит и установит подключаемые модули, затем нажмите кнопку "Готово". Нажмите кнопку "Закрыть, чтобы выйти из диспетчера подключаемых модулей.
По завершении установки подключаемых модулей в мастер создания файла будет добавлена категория "Load Testing Scripts" (Сценарии нагрузочного тестирования).
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_zh_CN.asciidoc
index 73c47ab..c0fb25a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profile-loadgenerator_zh_CN.asciidoc
@@ -72,7 +72,9 @@
1. 从主菜单中选择 "Tools"（工具）> "Plugins"（插件）以打开插件管理器。
2. 单击 "Available Plugins"（可用插件）标签，然后选中 JMeter 工具包和负载生成器插件的复选框。单击 "Install"（安装）。
image::images/generator-plugin.png[title="插件管理器中的负载生成器插件"]
-3. 逐步执行安装程序，以下载并安装插件，然后单击 "Finish"（完成）。单击 "Close"（关闭），以关闭插件管理器。
+
+[start=3]
+. 逐步执行安装程序，以下载并安装插件，然后单击 "Finish"（完成）。单击 "Close"（关闭），以关闭插件管理器。
安装了插件之后，会将 "Load Testing Scripts"（负载测试脚本）类别添加到新建文件向导中。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro.asciidoc
index dad1bb7..a5b8f2c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro.asciidoc
@@ -60,7 +60,9 @@
When you click Finish, the IDE creates the Anagram Game sample project.
-5. Choose Run > Set Main Project > AnagramGame from the main menu.
+
+[start=5]
+. Choose Run > Set Main Project > AnagramGame from the main menu.
After you set the project as the main project you can see that the name of the Anagram Game project is in bold in the Projects window. By default, when using the IDE to profile a project, the IDE will profile the main project. If no project is set as the main project the IDE will profile the project that is selected in the Projects window.
@@ -111,8 +113,12 @@
Alternatively, right-click the project node in the Projects window and choose Profile.
-3. Select Monitor in the Select Profiling Task dialog box.
-4. Select additional monitor options, if desired. Click Run.
+
+[start=3]
+. Select Monitor in the Select Profiling Task dialog box.
+
+[start=4]
+. Select additional monitor options, if desired. Click Run.
image::images/monitor-task.png[title="Selecting the Monitor Application profiling task"]
You can hover the cursor over an option to view a tooltip with details about the option.
@@ -157,25 +163,37 @@
To use this option you also need to specify a profiling root method.
-5. Click *customize* to open the Edit Profiling Roots dialog box.
+
+[start=5]
+. Click *customize* to open the Edit Profiling Roots dialog box.
image::images/select-cpu-task.png[title="Select CPU Profiling Task"]
-6. In the Edit Profiling Roots dialog box, expand the AnagramGame node and select ``Sources/com.toy.anagrams.lib/WordLibrary`` . When profiling a project you can specify multiple root methods.
+
+[start=6]
+. In the Edit Profiling Roots dialog box, expand the AnagramGame node and select ``Sources/com.toy.anagrams.lib/WordLibrary`` . When profiling a project you can specify multiple root methods.
image::images/edit-profiling-roots.png[title="Dialog box for selecting the root methods"]
-7. Click the Advanced button to open the Edit Profiling Roots (Advanced) dialog box which provides more advanced options for adding, editing and removing root methods.
+
+[start=7]
+. Click the Advanced button to open the Edit Profiling Roots (Advanced) dialog box which provides more advanced options for adding, editing and removing root methods.
image::images/edit-profiling-roots-adv.png[title="Dialog box for specifying the root methods"]
You can see that ``WordLibrary`` is listed as the root method. Click OK to close the Edit Profiling Roots (Advanced) dialog box.
-8. Click OK to close the Edit Profiling Roots dialog box.
+
+[start=8]
+. Click OK to close the Edit Profiling Roots dialog box.
After you select the profiling root you can click *edit* in the Select Profiling Task dialog to modify the selected root method.
-9. Select *Profile only project classes* for the Filter value.
+
+[start=9]
+. Select *Profile only project classes* for the Filter value.
The filter enables you to limit the classes that are instrumented. You can choose from the IDE's predefined profiling filters or create your own custom filters. You can click *Show filter value* to see a list of the classes that will be profiled when the selected filter is applied.
image::images/show-filter-value.png[title="Show Filter Value Dialog box"]
-10. Click Run in the Select Profiling Task dialog box to start the profiling session.
+
+[start=10]
+. Click Run in the Select Profiling Task dialog box to start the profiling session.
When you click Run, the IDE launches the application and starts the profiling session. To view the profiling results, click Live Results in the Profiler window to open the Live Results window. The Live Results window displays the profiling data collected thus far. The data displayed is refreshed every few seconds by default. When analyzing CPU performance, the Live Results window displays information on the time spent in each method and the number of invocations of each method. You can see that in the Anagram Game application only the selected root methods are invoked initially.
@@ -236,7 +254,9 @@
1. Make sure the profiling session is still running.
(If you stopped the profiling session, repeat the steps to analyze memory performance and open the Live Results window.)
-2. Right-click the line containing ``java.lang.String`` in the Live Results window and choose Take Snapshot and Show Allocation Stack Traces.
+
+[start=2]
+. Right-click the line containing ``java.lang.String`` in the Live Results window and choose Take Snapshot and Show Allocation Stack Traces.
You can use the filter in the Live Results window to help you find the line.
@@ -244,13 +264,21 @@
The IDE takes a memory snapshot and opens the snapshot in the Allocation Stack Traces tab. In the Allocation Stack Traces tab you can explore the reverse call tree for the methods that instantiated the selected object.
-3. Click the Save Snapshot to Project button in the snapshot toolbar (Ctrl-S; ⌘-S on Mac) to save the memory snapshot to your project. When you save the snapshot to your project, the snapshot is added to the list of Anagram Game's saved snapshots in the Profiler window. By default, snapshots are physically saved in the ``nbproject/private/profiler`` directory of your project. Saved snapshots are appended with the ``.nps`` suffix.
+
+[start=3]
+. Click the Save Snapshot to Project button in the snapshot toolbar (Ctrl-S; ⌘-S on Mac) to save the memory snapshot to your project. When you save the snapshot to your project, the snapshot is added to the list of Anagram Game's saved snapshots in the Profiler window. By default, snapshots are physically saved in the ``nbproject/private/profiler`` directory of your project. Saved snapshots are appended with the ``.nps`` suffix.
*Note.* You can save snapshots anywhere on your filesystem, however only snapshots saved in the default location in your project will be listed in the Profiler window. You can also click the "Save current view to image" button in the snapshot's toolbar to save the snapshot as an image files ( ``.png`` ) that can be viewed outside of the IDE.
-4. Take another snapshot by clicking the Take Snapshot of Collected Results button in the Live Results toolbar (or alternatively, click the Take Snapshot button in the Profiler window). Save the snapshot.
-5. In the window of one of the memory snapshots, click the Compute Difference button ( image::images/comparesnapshots.png[title="Compare Snapshot button"] ) in the snapshot toolbar. Alternatively, choose Profile > Compare Memory Snapshots from the main menu.
-6. In the Select Snapshot to Compare, select one of the open snapshots from the list. Click OK.
+
+[start=4]
+. Take another snapshot by clicking the Take Snapshot of Collected Results button in the Live Results toolbar (or alternatively, click the Take Snapshot button in the Profiler window). Save the snapshot.
+
+[start=5]
+. In the window of one of the memory snapshots, click the Compute Difference button ( image::images/comparesnapshots.png[title="Compare Snapshot button"] ) in the snapshot toolbar. Alternatively, choose Profile > Compare Memory Snapshots from the main menu.
+
+[start=6]
+. In the Select Snapshot to Compare, select one of the open snapshots from the list. Click OK.
image::images/profile-java-selectsnap.png[title="Select Snapshots to Compare dialog box"]
When a memory snapshot is open, you can compare it to other comparable memory snapshots. You can compare the snapshot to unsaved snapshots that are currently open or to snapshots that are saved to the project or elsewhere on your system.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ja.asciidoc
index 9a390a6..a835190 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ja.asciidoc
@@ -95,7 +95,9 @@
「終了」をクリックすると、IDEによってAnagram Gameサンプル・プロジェクトが作成されます。
-5. メイン・メニューから「実行」>「メイン・プロジェクトとして設定」>「AnagramGame」を選択します。
+
+[start=5]
+. メイン・メニューから「実行」>「メイン・プロジェクトとして設定」>「AnagramGame」を選択します。
プロジェクトをメイン・プロジェクトに設定すると、Anagram Gameプロジェクトの名前が太字で「プロジェクト」ウィンドウに表示されます。デフォルトでは、IDEを使用してプロジェクトをプロファイルすると、IDEによってメイン・プロジェクトがプロファイルされます。メイン・プロジェクトとして設定されたプロジェクトがない場合、IDEでは、「プロジェクト」ウィンドウで選択されたプロジェクトがプロファイルされます。
@@ -149,8 +151,12 @@
または、「プロジェクト」ウィンドウでプロジェクト・ノードを右クリックし、「プロファイル」を選択します。
-3. 「プロファイリング・タスクの選択」ダイアログ・ボックスで「モニター」を選択します。
-4. 必要に応じて、追加のモニター・オプションを選択します。「実行」をクリックします。
+
+[start=3]
+. 「プロファイリング・タスクの選択」ダイアログ・ボックスで「モニター」を選択します。
+
+[start=4]
+. 必要に応じて、追加のモニター・オプションを選択します。「実行」をクリックします。
image::images/monitor-task.png[title="「アプリケーションのモニター」プロファイリング・タスクの選択"]
オプションの上にカーソルを置くと、ツールチップにそのオプションの詳細を表示できます。
@@ -196,25 +202,37 @@
このオプションを使用するには、プロファイリング用ルート・メソッドも指定する必要があります。
-5. 「*カスタマイズ*」をクリックして「プロファイリング・ルートの編集」ダイアログ・ボックスを開きます。
+
+[start=5]
+. 「*カスタマイズ*」をクリックして「プロファイリング・ルートの編集」ダイアログ・ボックスを開きます。
image::images/select-cpu-task.png[title="「CPU」プロファイリング・タスクの選択"]
-6. 「プロファイリング・ルートの編集」ダイアログ・ボックスで、「AnagramGame」ノードを展開し、 ``Sources/com.toy.anagrams.lib/WordLibrary`` を選択します。プロジェクトをプロファイリングする場合は、複数のルート・メソッドを指定できます。
+
+[start=6]
+. 「プロファイリング・ルートの編集」ダイアログ・ボックスで、「AnagramGame」ノードを展開し、 ``Sources/com.toy.anagrams.lib/WordLibrary`` を選択します。プロジェクトをプロファイリングする場合は、複数のルート・メソッドを指定できます。
image::images/edit-profiling-roots.png[title="ルート・メソッドを選択するためのダイアログ・ボックス"]
-7. 「詳細」ボタンをクリックして、ルート・メソッドを追加、編集、および除去するためのより詳細なオプションを提供する「プロファイリング・ルートの編集(詳細)」ダイアログ・ボックスを開きます。
+
+[start=7]
+. 「詳細」ボタンをクリックして、ルート・メソッドを追加、編集、および除去するためのより詳細なオプションを提供する「プロファイリング・ルートの編集(詳細)」ダイアログ・ボックスを開きます。
image::images/edit-profiling-roots-adv.png[title="ルート・メソッドを指定するためのダイアログ・ボックス"]
``WordLibrary`` がルート・メソッドとして表示されていることが確認できます。「OK」をクリックして「プロファイリング・ルートの編集(詳細)」ダイアログ・ボックスを閉じます。
-8. 「OK」をクリックして「プロファイリング・ルートの編集」ダイアログ・ボックスを閉じます。
+
+[start=8]
+. 「OK」をクリックして「プロファイリング・ルートの編集」ダイアログ・ボックスを閉じます。
プロファイリング・ルートを選択した後に、「プロファイリング・タスクの選択」ダイアログ・ボックスで「*編集*」をクリックし、選択したルート・メソッドを変更できます。
-9. 「フィルタ」値で「*プロジェクト・クラスだけをプロファイル*」を選択します。
+
+[start=9]
+. 「フィルタ」値で「*プロジェクト・クラスだけをプロファイル*」を選択します。
フィルタを使用すると、インストゥルメントされるクラスを制限できます。IDEの事前定義されたプロファイリング・フィルタから選択するか、または独自のカスタム・フィルタを作成することができます。「*フィルタ値を表示*」をクリックして、選択したフィルタが適用されたときにプロファイルされるクラスの一覧を確認できます。
image::images/show-filter-value.png[title="「フィルタ値を表示」ダイアログ・ボックス"]
-10. 「プロファイリング・タスクの選択」ダイアログ・ボックスで「実行」をクリックし、プロファイリング・セッションを開始します。
+
+[start=10]
+. 「プロファイリング・タスクの選択」ダイアログ・ボックスで「実行」をクリックし、プロファイリング・セッションを開始します。
「実行」をクリックすると、IDEによってアプリケーションが起動され、プロファイリング・セッションが開始されます。プロファイリング結果を表示するには、「プロファイラ」ウィンドウ内の「ライブ結果」をクリックして「ライブ結果」ウィンドウを開きます。「ライブ結果」ウィンドウには、これまでに収集されたプロファイリング・データが表示されます。表示されるデータは、デフォルトでは数秒ごとにリフレッシュされます。CPUパフォーマンスを解析している場合、「ライブ結果」ウィンドウには、各メソッドの所要時間と各メソッドの呼出し回数に関する情報が表示されます。Anagram Gameアプリケーションでは、選択されたルート・メソッドのみが最初に呼び出されていることが確認できます。
@@ -278,7 +296,9 @@
1. プロファイリング・セッションが引続き実行中であることを確認します。
(プロファイリング・セッションを停止した場合は、メモリー・パフォーマンスを解析するための手順を繰り返し、「ライブ結果」ウィンドウを開きます。)
-2. 「ライブ結果」ウィンドウで ``java.lang.String`` を含む行を右クリックし、「スナップショットを取得して割当てスタック・トレースを表示」を選択します。
+
+[start=2]
+. 「ライブ結果」ウィンドウで ``java.lang.String`` を含む行を右クリックし、「スナップショットを取得して割当てスタック・トレースを表示」を選択します。
「ライブ結果」ウィンドウでフィルタを使用して、行を検索できます。
@@ -286,13 +306,21 @@
IDEによってメモリー・スナップショットが作成され、そのスナップショットが「割当てスタック・トレース」タブに表示されます。「割当てスタック・トレース」タブでは、選択されたオブジェクトをインスタンス化したメソッドの逆コール・ツリーを調べることができます。
-3. スナップショット・ツールバーの「プロジェクトにスナップショットを保存」ボタンをクリックして([Ctrl]-[S]、Macの場合は[⌘]-[S])、メモリー・スナップショットをプロジェクトに保存します。スナップショットをプロジェクトに保存すると、そのスナップショットが「プロファイラ」ウィンドウ内のAnagram Gameの保存されたスナップショットの一覧に追加されます。デフォルトでは、スナップショットはプロジェクトの ``nbproject/private/profiler`` ディレクトリ内に物理的に保存されます。保存されたスナップショットには ``.nps`` の接尾辞が付加されます。
+
+[start=3]
+. スナップショット・ツールバーの「プロジェクトにスナップショットを保存」ボタンをクリックして([Ctrl]-[S]、Macの場合は[⌘]-[S])、メモリー・スナップショットをプロジェクトに保存します。スナップショットをプロジェクトに保存すると、そのスナップショットが「プロファイラ」ウィンドウ内のAnagram Gameの保存されたスナップショットの一覧に追加されます。デフォルトでは、スナップショットはプロジェクトの ``nbproject/private/profiler`` ディレクトリ内に物理的に保存されます。保存されたスナップショットには ``.nps`` の接尾辞が付加されます。
*注意:*スナップショットはファイルシステム上の任意の場所に保存できますが、「プロファイラ」ウィンドウに一覧表示されるのは、プロジェクト内のデフォルトの場所に保存されたスナップショットのみです。また、スナップショットのツールバーにある「現在のビューをイメージに保存」ボタンをクリックして、そのスナップショットをIDEの外部で表示できるイメージ・ファイル( ``.png`` )として保存することもできます。
-4. 「ライブ結果」ツールバーの「収集結果のスナップショットの作成」ボタンをクリックして、別のスナップショットを作成します(または、「プロファイラ」ウィンドウで「スナップショットの取得」ボタンをクリックします)。スナップショットを保存します。
-5. いずれかのメモリー・スナップショットのウィンドウで、スナップショット・ツールバーの「相違の計算」ボタン(image::images/comparesnapshots.png[title="スナップショットの比較ボタン"])をクリックします。または、メイン・メニューから「プロファイル」>「メモリー・スナップショットを比較」を選択します。
-6. 「比較するスナップショットを選択」で、一覧から開いたスナップショットのいずれかを選択します。「OK」をクリックします。
+
+[start=4]
+. 「ライブ結果」ツールバーの「収集結果のスナップショットの作成」ボタンをクリックして、別のスナップショットを作成します(または、「プロファイラ」ウィンドウで「スナップショットの取得」ボタンをクリックします)。スナップショットを保存します。
+
+[start=5]
+. いずれかのメモリー・スナップショットのウィンドウで、スナップショット・ツールバーの「相違の計算」ボタン(image::images/comparesnapshots.png[title="スナップショットの比較ボタン"])をクリックします。または、メイン・メニューから「プロファイル」>「メモリー・スナップショットを比較」を選択します。
+
+[start=6]
+. 「比較するスナップショットを選択」で、一覧から開いたスナップショットのいずれかを選択します。「OK」をクリックします。
image::images/profile-java-selectsnap.png[title="「比較するスナップショットを選択」ダイアログ・ボックス"]
メモリー・スナップショットが開いている場合は、それを他の比較可能なメモリー・スナップショットと比較できます。スナップショットを、現在開いている保存されていないスナップショットと比較することも、プロジェクトまたはシステム上の他の任意の場所に保存されたスナップショットと比較することもできます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_pt_BR.asciidoc
index 2b6e381..a15d1db 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_pt_BR.asciidoc
@@ -95,7 +95,9 @@
Quando você clica em Finalizar, o IDE cria o projeto de amostra Jogo de Anagramas.
-5. Escolha Executar >Definir Projeto Principal > Jogo de Anagramas do menu principal.
+
+[start=5]
+. Escolha Executar >Definir Projeto Principal > Jogo de Anagramas do menu principal.
Depois que você definir o projeto como o principal você pode ver o nome do projeto Jogo de Anagramas em negrito na janela Projetos. Por default, ao usar o IDE para criar o perfil de um projeto, o IDE criará o perfil do projeto principal. Se nenhum projeto estiver definido como o projeto principal, o IDE irá criar o perfil do projeto selecionado na janela Projetos.
@@ -149,8 +151,12 @@
Alternativamente, clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Perfil.
-3. Selecione Monitorar na caixa de diálogo Selecionar Tarefa de Criação de Perfil.
-4. Selecione opções do monitor adicionais, se desejado. Clique em Executar.
+
+[start=3]
+. Selecione Monitorar na caixa de diálogo Selecionar Tarefa de Criação de Perfil.
+
+[start=4]
+. Selecione opções do monitor adicionais, se desejado. Clique em Executar.
image::images/monitor-task.png[title="Selecionando a tarefas de criação de perfil Monitorar Aplicação"]
Você pode passar o cursor sobre uma opção para exibir uma dica de ferramenta com detalhes sobre a opção.
@@ -196,25 +202,37 @@
Para usar essa opção, é preciso também especificar um método-raiz de criação de perfil.
-5. Clique em *Personalizar* para abrir a caixa de diálogo Editar Raízes da Criação de Perfil.
+
+[start=5]
+. Clique em *Personalizar* para abrir a caixa de diálogo Editar Raízes da Criação de Perfil.
image::images/select-cpu-task.png[title="Selecione Tarefas de Criação de Perfil da CPU"]
-6. Na caixa de diálogo Editar Raízes da Criação de Perfil, expanda o nó Jogo de Anagramas e selecione ``Sources/com.toy.anagrams.lib/WordLibrary`` . Ao criar o perfil de um projeto, você pode especificar vários métodos-raiz.
+
+[start=6]
+. Na caixa de diálogo Editar Raízes da Criação de Perfil, expanda o nó Jogo de Anagramas e selecione ``Sources/com.toy.anagrams.lib/WordLibrary`` . Ao criar o perfil de um projeto, você pode especificar vários métodos-raiz.
image::images/edit-profiling-roots.png[title="Caixa de diálogo para selecionar os métodos-raiz"]
-7. Clique no botão Avançado para abrir a caixa de diálogo Editar Raízes da Criação de Perfil (Avançado), que fornece opções mais avançadas para adicionar, editar e remover métodos-raiz.
+
+[start=7]
+. Clique no botão Avançado para abrir a caixa de diálogo Editar Raízes da Criação de Perfil (Avançado), que fornece opções mais avançadas para adicionar, editar e remover métodos-raiz.
image::images/edit-profiling-roots-adv.png[title="Caixa de diálogo para especificar os métodos-raiz"]
É possível ver que ``WordLibrary`` está listado como o método-raiz. Clique em OK para fechar a caixa de diálogo Editar Raízes da Criação de Perfil.
-8. Clique em OK para fechar a caixa de diálogo Editar Raízes da Criação de Perfil.
+
+[start=8]
+. Clique em OK para fechar a caixa de diálogo Editar Raízes da Criação de Perfil.
Após você selecionar a raiz de criação do perfil é possível clicar em *editar* na caixa de diálogo Selecionar Tarefa de Criação de Perfil para modificar o método-raiz selecionado.
-9. Selecione *Criar perfil somente das classes do projeto* no valor Filtro.
+
+[start=9]
+. Selecione *Criar perfil somente das classes do projeto* no valor Filtro.
O Filtro permite que você limite as classes que estão instrumentadas. É possível selecionar entre os filtros predefinidos de criação de perfil do IDE ou criar seus próprios filtros personalizados. Você pode clicar em *Mostrar valor do filtro* para ver uma lista das classes que terá o perfil criado quando o filtro selecionado for aplicado.
image::images/show-filter-value.png[title="Caixa de Diálogo Mostrar Valor do Filtro"]
-10. Clique em Executar na caixa de diálogo Selecionar Tarefa de Criação de Perfil para iniciar a sessão de criação de perfil.
+
+[start=10]
+. Clique em Executar na caixa de diálogo Selecionar Tarefa de Criação de Perfil para iniciar a sessão de criação de perfil.
Quando você clica em Executar, o IDE inicia a aplicação e começa a sessão de criação de perfil. Para exibir os resultados da criação de perfil, clique em Resultados em tempo real na janela Criador de Perfil para abrir a janela Resultados em Tempo Real. A janela Resultados em Tempo Real exibe os dados de criação de perfil coletados até o momento. Os dados exibidos são atualizados, por default, a cada poucos segundos. Quando você analisa o desempenho da CPU, a janela Resultados em Tempo Real exibe informações sobre o tempo gasto em cada método e o número de chamadas de cada método. É possível ver que, no Jogo de Anagramas, somente os métodos-raiz selecionados são inicialmente chamados.
@@ -278,7 +296,9 @@
1. Assegure-se de que a sessão de criação de perfil ainda esteja em execução.
(Se você interrompeu a sessão de criação de perfil, repita as etapas para analisar o desempenho da memória e abra a janela Resultados em Tempo Real.)
-2. Clique com o botão direito do mouse na linha que contém ``java.lang.String`` na janela Resultados em Tempo Real e selecione Obter Snapshot e Mostrar Rastreamentos da Pilha de Alocação.
+
+[start=2]
+. Clique com o botão direito do mouse na linha que contém ``java.lang.String`` na janela Resultados em Tempo Real e selecione Obter Snapshot e Mostrar Rastreamentos da Pilha de Alocação.
Você pode usar o filtro na janela Resultados em Tempo Real para ajudá-lo a localizar a linha.
@@ -286,13 +306,21 @@
O IDE obtém um snapshot da memória e abre o snapshot na guia Rastreamentos da Pilha de Alocação. Na guia Rastreamentos da Pilha de Alocação, é possível explorar a árvore de chamadas reversa para os métodos que instanciaram o objeto selecionado.
-3. Clique no botão Salvar Snapshot para o Projeto na barra de ferramentas de snapshot (ou Ctrl+S no Mac) para salvar o snapshot para o seu projeto. Quando você salva um snapshot em seu projeto, ele é adicionado à lista dos snapshots salvos do Jogo de Anagramas na janela Profiler. Por default, os snapshots são salvos fisicamente no diretório ``nbproject/private/profiler`` de seu projeto. O sufixo ``.nps`` é acrescentado aos snapshots salvos.
+
+[start=3]
+. Clique no botão Salvar Snapshot para o Projeto na barra de ferramentas de snapshot (ou Ctrl+S no Mac) para salvar o snapshot para o seu projeto. Quando você salva um snapshot em seu projeto, ele é adicionado à lista dos snapshots salvos do Jogo de Anagramas na janela Profiler. Por default, os snapshots são salvos fisicamente no diretório ``nbproject/private/profiler`` de seu projeto. O sufixo ``.nps`` é acrescentado aos snapshots salvos.
*Observação.* Você pode salvar snapshots em qualquer lugar em seu sistema de arquivos, porém somente os snapshots salvos na localização default de seu projeto serão listados na janela Profiler. Também é possível clicar no botão "Salvar view atual na imagem" na barra de ferramenta de snapshot para salvar o snapshot como arquivos de imagem ( ``.png`` ) que podem ser exibidos fora do IDE.
-4. Obtenha outro snapshot clicando no botão Obter Snapshot de Resultados Coletados na barra de ferramentas Resultados em Tempo Real (ou, alternativamente, clique no botão Obter Snapshot na janela Profiler). Salve o snapshot.
-5. Na janela de um dos snapshots de memória, clique no botão Calcular Diferença ( image::images/comparesnapshots.png[title="Botão Comparar Snapshot"] ) na barra de ferramentas do snapshots. Como alternativa, selecione Perfil > Comparar Snapshots de Memória no menu principal.
-6. Em Selecionar Snapshot para Comparar, selecione um dos snapshots abertos na lista. Clique em OK.
+
+[start=4]
+. Obtenha outro snapshot clicando no botão Obter Snapshot de Resultados Coletados na barra de ferramentas Resultados em Tempo Real (ou, alternativamente, clique no botão Obter Snapshot na janela Profiler). Salve o snapshot.
+
+[start=5]
+. Na janela de um dos snapshots de memória, clique no botão Calcular Diferença ( image::images/comparesnapshots.png[title="Botão Comparar Snapshot"] ) na barra de ferramentas do snapshots. Como alternativa, selecione Perfil > Comparar Snapshots de Memória no menu principal.
+
+[start=6]
+. Em Selecionar Snapshot para Comparar, selecione um dos snapshots abertos na lista. Clique em OK.
image::images/profile-java-selectsnap.png[title="Caixa de diálogo Selecionar Snapshots para Comparar"]
Quando um snapshot de memória é aberto, você pode compará-lo a outros snapshots de memória comparáveis. É possível comparar o snapshot com snapshots não salvos que estejam atualmente abertos ou com snapshots que estão salvos para o projeto ou em outro local do sistema.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ru.asciidoc
index fffc29c..8402b93 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_ru.asciidoc
@@ -96,7 +96,9 @@
При нажатии кнопки "Готово" среда IDE создает пример проекта Anagram Game.
-5. Выберите 'Выполнить' > 'Настроить основной проект' > AnagramGame в главном меню.
+
+[start=5]
+. Выберите 'Выполнить' > 'Настроить основной проект' > AnagramGame в главном меню.
После настройки проекта как основного имя проекта Anagram Game будет выделено полужирным в окне 'Проекты'. По умолчанию при использовании среды IDE для профилирования проекта среда IDE профилирует главный проект. Если ни один проект не выбран в качестве главного, среда IDE выполнит профилирование проекта, который выбран в окне 'Проекты'.
@@ -150,8 +152,12 @@
Также можно щелкнуть правой кнопкой мыши узел проекта в окне 'Проекты' и выбрать 'Профиль'.
-3. Выберите "Наблюдение" в диалоговом окне "Выбор задачи профилирования".
-4. При необходимости выберите дополнительные параметры монитора. Нажмите кнопку "Выполнить".
+
+[start=3]
+. Выберите "Наблюдение" в диалоговом окне "Выбор задачи профилирования".
+
+[start=4]
+. При необходимости выберите дополнительные параметры монитора. Нажмите кнопку "Выполнить".
image::images/monitor-task.png[title="Выбор задачи профилирования приложения монитора"]
Можно подвести курсор к параметру для просмотра всплывающей подсказки со сведениями о параметре.
@@ -197,25 +203,37 @@
Для использования этого варианта также необходимо указать корневой метод профилирования.
-5. Нажмите кнопку *настроить*, чтобы открыть диалоговое окно "Изменение корневых методов профилирования".
+
+[start=5]
+. Нажмите кнопку *настроить*, чтобы открыть диалоговое окно "Изменение корневых методов профилирования".
image::images/select-cpu-task.png[title="Выбор задачи профилирования ЦП"]
-6. В диалоговом окне 'Изменение корневых методов профилирования' разверните узел AnagramGame и выберите ``Sources/com.toy.anagrams.lib/WordLibrary`` . При профилировании проекта можно указать несколько корневых методов профилирования.
+
+[start=6]
+. В диалоговом окне 'Изменение корневых методов профилирования' разверните узел AnagramGame и выберите ``Sources/com.toy.anagrams.lib/WordLibrary`` . При профилировании проекта можно указать несколько корневых методов профилирования.
image::images/edit-profiling-roots.png[title="Диалоговое окно для выбора корневых методов"]
-7. Нажмите кнопку "Дополнительно", чтобы открыть диалоговое окно "Изменение корневых методов профилирования (Дополнительно)", в котором доступны дополнительные параметры для добавления, изменения и удаления корневых методов.
+
+[start=7]
+. Нажмите кнопку "Дополнительно", чтобы открыть диалоговое окно "Изменение корневых методов профилирования (Дополнительно)", в котором доступны дополнительные параметры для добавления, изменения и удаления корневых методов.
image::images/edit-profiling-roots-adv.png[title="Диалоговое окно для указания корневых методов"]
Можно видеть, что ``WordLibrary`` указан как корневой метод. Нажмите "ОК", чтобы закрыть диалоговое окно "Изменение корневых методов профилирования (Расширенное)".
-8. Нажмите "ОК", чтобы закрыть диалоговое окно "Изменение корневых методов профилирования".
+
+[start=8]
+. Нажмите "ОК", чтобы закрыть диалоговое окно "Изменение корневых методов профилирования".
После выбора корневых методов профилирования можно щелкнуть *правка* в диалоговом окне 'Выбор задачи профилирования' дл изменения выбранного корневого метода.
-9. Выберите *Профилировать только классы проекта* для значения "Фильтр".
+
+[start=9]
+. Выберите *Профилировать только классы проекта* для значения "Фильтр".
Фильтр позволяет ограничить инструментируемые классы. Можно выбрать один из предварительно определенных фильтров профилирования IDE или создать собственные пользовательские фильтры. Щелкните *Показать значение фильтра* для просмотра списка классов, которые будут профилированы при применении выбранного фильтра.
image::images/show-filter-value.png[title="Диалоговое окно 'Показать значени фильтра'"]
-10. Нажмите кнопку "Выполнить" в диалоговом окне "Выбрать задачу профилирования" для начала сеанса профилирования.
+
+[start=10]
+. Нажмите кнопку "Выполнить" в диалоговом окне "Выбрать задачу профилирования" для начала сеанса профилирования.
При нажатии кнопки "Выполнить" среда IDE запускает приложение Anagram Game и запускает сеанс профилирования. Чтобы просмотреть результаты профилирования, нажмите кнопку "Текущие результаты" в окне "Средство профилирования", при этом откроется окно "Текущие результаты". В окне "Текущие результаты" отображаются собранные на этот момент данные профилирования. По умолчанию отображаемые данные обновляются каждые несколько секунд. При анализе производительности ЦП в окне "Текущие результаты" отображаются сведения о времени, затраченным для каждого метода, и число вызовов каждого метода. Можно видеть, что в приложении Anagram Game изначально вызываются только выбранные корневые методы.
@@ -279,7 +297,9 @@
1. Убедитесь, что сеанс профилирования по-прежнему выполняется.
(Если сеанс профилирования остановлен, повторите действия для анализа производительности памяти и откройте окно "Текущие результаты".)
-2. Правой кнопкой мыши щелкните строку, содержащую ``java.lang.String`` , в окне "Текущие результаты" и выберите "Получить снимок и показать стек операций выделения памяти".
+
+[start=2]
+. Правой кнопкой мыши щелкните строку, содержащую ``java.lang.String`` , в окне "Текущие результаты" и выберите "Получить снимок и показать стек операций выделения памяти".
Вы сможете использовать фильтр в окне 'Динамические результаты' для поиска строки.
@@ -287,13 +307,21 @@
Среда IDE получает моментальный снимок памяти и открывает его во вкладке "Трассировка стека операций выделения памяти". На вкладке "Трассировка стека операций выделения памяти" можно изучить обратное дерево вызовов для методов, создавших экземпляр выбранного объекта.
-3. Нажмите кнопку "Сохранить моментальный снимок в проекте" на панели инструментов моментального снимка (Ctrl-S; ⌘-S в Mac), чтобы сохранить моментальный снимок памяти в проекте. При сохранении моментального снимка в проекте он добавляется к списку сохраненных моментальных снимков Anagram Game в окне "Средство профилирования". По умолчанию моментальные снимки физически сохраняются в каталоге ``nbproject/private/profiler`` проекта. К сохраненным моментальным снимкам добавляются суффикс ``.nps`` .
+
+[start=3]
+. Нажмите кнопку "Сохранить моментальный снимок в проекте" на панели инструментов моментального снимка (Ctrl-S; ⌘-S в Mac), чтобы сохранить моментальный снимок памяти в проекте. При сохранении моментального снимка в проекте он добавляется к списку сохраненных моментальных снимков Anagram Game в окне "Средство профилирования". По умолчанию моментальные снимки физически сохраняются в каталоге ``nbproject/private/profiler`` проекта. К сохраненным моментальным снимкам добавляются суффикс ``.nps`` .
*Примечание.* Вы можете сохранять снимки в любом местоположении файловой системы, но только снимки, сохраненные в папке по умолчанию в проекте, будут указаны в окне средства профилирования. Также можно нажать кнопку "Сохранить текущее представление в изображении" на панели инструментов моментального снимка, чтобы сохранить снимок как файлы изображений ( ``.png`` ), которые можно просмотреть вне среды IDE.
-4. Получите другой моментальный снимок, нажав кнопку "Сделать моментальный снимок собранных результатов" на панели инструментов "Текущие результаты" (или нажмите кнопку "Сделать моментальный снимок" в окне "Средство профилирования"). Сохраните моментальный снимок.
-5. В окне одного из снимков памяти, нажмите кнопку 'Вычислить разницу' ( image::images/comparesnapshots.png[title="Кнопка 'Сравнить списки'"] ) на панели инструментов снимков. Или выберите "Профиль > Сравнить моментальные снимки памяти" в главном меню.
-6. В окне "Выбор моментального снимка для сравнения" выберите один из открытых моментальных снимков в списке. Нажмите кнопку "ОК".
+
+[start=4]
+. Получите другой моментальный снимок, нажав кнопку "Сделать моментальный снимок собранных результатов" на панели инструментов "Текущие результаты" (или нажмите кнопку "Сделать моментальный снимок" в окне "Средство профилирования"). Сохраните моментальный снимок.
+
+[start=5]
+. В окне одного из снимков памяти, нажмите кнопку 'Вычислить разницу' ( image::images/comparesnapshots.png[title="Кнопка 'Сравнить списки'"] ) на панели инструментов снимков. Или выберите "Профиль > Сравнить моментальные снимки памяти" в главном меню.
+
+[start=6]
+. В окне "Выбор моментального снимка для сравнения" выберите один из открытых моментальных снимков в списке. Нажмите кнопку "ОК".
image::images/profile-java-selectsnap.png[title="Диалоговое окно 'Выбрать снимки для сравнения'"]
После открытия моментального снимка памяти можно сравнить его с другими сравнимыми снимками памяти. Снимок экрана можно сравнить с текущими открытыми несохраненными снимками или со снимками, которые сохранены в проекте или где-либо в ином месте системы.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_zh_CN.asciidoc
index 4709665..09c478f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-intro_zh_CN.asciidoc
@@ -95,7 +95,9 @@
单击“完成”，此时 IDE 将创建 Anagram Game 样例项目。
-5. 从主菜单中选择“运行”>“设置为主项目”> "AnagramGame"。
+
+[start=5]
+. 从主菜单中选择“运行”>“设置为主项目”> "AnagramGame"。
在将项目设置为主项目后，您可以看到 Anagram Game 项目的名称在“项目”窗口中显示为粗体。默认情况下，使用 IDE 对项目进行性能分析时，IDE 也将对主项目进行性能分析。如果未将项目设置为主项目，则 IDE 将会对在“项目”窗口中选择的项目进行分析。
@@ -149,8 +151,12 @@
此外，也可以在 "Projects"（项目）窗口中右键单击项目节点，然后选择 "Profile"（性能分析）。
-3. 在 "Select Profiling Task"（选择性能分析任务）对话框中选择 "Monitor"（监视）。
-4. 根据需要，选择其他监视选项。单击 "Run"（运行）。
+
+[start=3]
+. 在 "Select Profiling Task"（选择性能分析任务）对话框中选择 "Monitor"（监视）。
+
+[start=4]
+. 根据需要，选择其他监视选项。单击 "Run"（运行）。
image::images/monitor-task.png[title="选择 "Monitor Application"（监视应用程序）性能分析任务"]
将光标悬停在某一选项上即可查看包含有关该选项详细信息的工具提示。
@@ -196,25 +202,37 @@
要使用此选项，还需要指定性能分析根方法。
-5. 单击 *Customize*（定制），打开 "Edit Profiling Roots"（编辑性能分析根目录）对话框。
+
+[start=5]
+. 单击 *Customize*（定制），打开 "Edit Profiling Roots"（编辑性能分析根目录）对话框。
image::images/select-cpu-task.png[title="选择 CPU 性能分析任务"]
-6. 在 "Edit Profiling Roots"（编辑性能分析根目录）对话框中，展开 "AnagramGame" 节点，然后选择 ``Sources/com.toy.anagrams.lib/WordLibrary`` 。对项目进行性能分析时，可以指定多个根方法。
+
+[start=6]
+. 在 "Edit Profiling Roots"（编辑性能分析根目录）对话框中，展开 "AnagramGame" 节点，然后选择 ``Sources/com.toy.anagrams.lib/WordLibrary`` 。对项目进行性能分析时，可以指定多个根方法。
image::images/edit-profiling-roots.png[title="用于选择根方法的对话框"]
-7. 单击 "Advanced"（高级）按钮，以打开 "Edit Profiling Roots (Advanced)"（编辑性能分析根目录（高级））对话框，该对话框提供了更高级的选项，用于添加、编辑和删除根方法。
+
+[start=7]
+. 单击 "Advanced"（高级）按钮，以打开 "Edit Profiling Roots (Advanced)"（编辑性能分析根目录（高级））对话框，该对话框提供了更高级的选项，用于添加、编辑和删除根方法。
image::images/edit-profiling-roots-adv.png[title="用于指定根方法的对话框"]
您可以看到 ``WordLibrary`` 被列为根方法。单击 "OK"（确定）以关闭 "Edit Profiling Roots (Advanced)"（编辑性能分析根目录（高级））对话框。
-8. 单击 "OK"（确定），以关闭 "Edit Profiling Roots"（编辑性能分析根目录）对话框。
+
+[start=8]
+. 单击 "OK"（确定），以关闭 "Edit Profiling Roots"（编辑性能分析根目录）对话框。
在选择性能分析根目录后，在 "Select Profiling Task"（选择性能分析任务）对话框中单击 *edit*（编辑）即可修改所选的根方法。
-9. 选择 *Profile only project classes*（只分析项目类）作为过滤器值。
+
+[start=9]
+. 选择 *Profile only project classes*（只分析项目类）作为过滤器值。
使用此过滤器可以限制所分析的类。您可以从 IDE 的预定义性能分析过滤器中选择，也可以创建自己的定制过滤器。单击 *Show filter value*（显示过滤器值）即可查看在应用所选过滤器时进行分析的类列表。
image::images/show-filter-value.png[title=""Show Filter Value"（显示过滤器值）对话框"]
-10. 在 "Select Profiling Task"（选择性能分析任务）对话框中单击 "Run"（运行）以启动性能分析会话。
+
+[start=10]
+. 在 "Select Profiling Task"（选择性能分析任务）对话框中单击 "Run"（运行）以启动性能分析会话。
单击 "Run"（运行）后，IDE 将启动应用程序，并开始性能分析会话。要查看性能分析结果，请在 "Profiler"（分析器）窗口中单击 "Live Results"（实时结果）以打开 "Live Results"（实时结果）窗口。"Live Results"（实时结果）窗口将显示迄今为止收集的性能分析数据。默认情况下，每几秒钟就刷新一次显示的数据。分析 CPU 性能时，"Live Results"（实时结果）窗口会显示与每个方法所花费时间相关的信息，以及与每个方法的调用次数相关的信息。您可以看到，在 Anagram Game 应用程序中，最初只调用选定的根方法。
@@ -278,7 +296,9 @@
1. 确保性能分析会话仍在运行中。
（如果停止了性能分析会话，则重复执行相应步骤以分析内存性能并打开 "Live Results"（实时结果）窗口。）
-2. 在 "Live Results"（实时结果）窗口中，右键单击 ``java.lang.String`` 所在行，然后选择 "Take Snapshot and Show Allocation Stack Traces"（生成快照并显示分配堆栈跟踪）。
+
+[start=2]
+. 在 "Live Results"（实时结果）窗口中，右键单击 ``java.lang.String`` 所在行，然后选择 "Take Snapshot and Show Allocation Stack Traces"（生成快照并显示分配堆栈跟踪）。
使用 "Live Results"（实时结果）窗口中的过滤器可帮助您查找该行。
@@ -286,13 +306,21 @@
IDE 将会生成内存快照，并在 "Allocation Stack Traces"（分配堆栈跟踪）标签中打开快照。在 "Allocation Stack Traces"（分配堆栈跟踪）标签中，可以在反向调用树中浏览实例化了选定对象的方法。
-3. 单击快照工具栏中的 "Save Snapshot to Project"（将快照保存到项目中）按钮（Ctrl-S 组合键；在 Mac 上为 ⌘-S 组合键），将内存快照保存到项目中。将快照保存到项目中时，会在 "Profiler"（分析器）窗口中将该快照添加到 Anagram Game 的已保存快照的列表中。默认情况下，快照实际上保存在项目的 ``nbproject/private/profiler`` 目录中。已保存的快照会附加 ``.nps`` 后缀。
+
+[start=3]
+. 单击快照工具栏中的 "Save Snapshot to Project"（将快照保存到项目中）按钮（Ctrl-S 组合键；在 Mac 上为 ⌘-S 组合键），将内存快照保存到项目中。将快照保存到项目中时，会在 "Profiler"（分析器）窗口中将该快照添加到 Anagram Game 的已保存快照的列表中。默认情况下，快照实际上保存在项目的 ``nbproject/private/profiler`` 目录中。已保存的快照会附加 ``.nps`` 后缀。
*注：*您可以将快照保存到文件系统上的任何位置，但只有保存在项目中默认位置的快照才会列在 "Profiler"（分析器）窗口中。此外，还可以单击快照工具栏中的 "Save current view to image"（将当前视图另存为图像）按钮，将快照保存为可以在 IDE 外部查看的图像文件 ( ``.png`` )。
-4. 生成另一个快照，方法是：单击 "Live Results"（实时结果）工具栏中的 "Take Snapshot of Collected Results"（生成收集结果的快照）按钮（或者，也可以在 "Profiler"（分析器）窗口中单击 "Take Snapshot"（生成快照）按钮）。保存该快照。
-5. 在某一内存快照的窗口中，单击快照工具栏中的 "Compute Difference"（计算差异）按钮 (image::images/comparesnapshots.png[title=""Compare Snapshot"（比较快照）按钮"])。此外，也可以从主菜单中选择 "Profile"（性能分析）> "Compare Memory Snapshots"（比较内存快照）。
-6. 在 "Select Snapshot to Compare"（选择要比较的快照）中，从列表中选择其中一个打开的快照。单击 "OK"（确定）。
+
+[start=4]
+. 生成另一个快照，方法是：单击 "Live Results"（实时结果）工具栏中的 "Take Snapshot of Collected Results"（生成收集结果的快照）按钮（或者，也可以在 "Profiler"（分析器）窗口中单击 "Take Snapshot"（生成快照）按钮）。保存该快照。
+
+[start=5]
+. 在某一内存快照的窗口中，单击快照工具栏中的 "Compute Difference"（计算差异）按钮 (image::images/comparesnapshots.png[title=""Compare Snapshot"（比较快照）按钮"])。此外，也可以从主菜单中选择 "Profile"（性能分析）> "Compare Memory Snapshots"（比较内存快照）。
+
+[start=6]
+. 在 "Select Snapshot to Compare"（选择要比较的快照）中，从列表中选择其中一个打开的快照。单击 "OK"（确定）。
image::images/profile-java-selectsnap.png[title=""Select Snapshots to Compare"（选择要比较的快照）对话框"]
内存快照处于打开状态时，可以将其与其他可比较的内存快照进行比较。您可以将该快照与当前打开的未保存快照进行比较，也可以将其与保存到项目或系统中其他位置的快照进行比较。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints.asciidoc
index 993d6d2..16f53a5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints.asciidoc
@@ -58,7 +58,9 @@
2. In the source editor, right-click in the line where you want to add the profiling point and choose *Profiling* > *Insert Profiling Point* to open the New Profiling Point wizard.
3. Select a profiling point type and the project. Click Next.
image::images/ppoints-newstopwatch.png[title="Screenshot of New Profiling Point dialog box"]
-4. Type a name for the profiling point and customize the properties of the profiling point. Click Finish.
+
+[start=4]
+. Type a name for the profiling point and customize the properties of the profiling point. Click Finish.
When you click Finish, an icon representing the profiling point type appears in the left margin of the source editor next to the line where you inserted the profiling point.
@@ -119,7 +121,9 @@
When you click Finish, the IDE creates the Anagram Game sample project.
-5. Choose Run > Set Main Project > AnagramGame from the main menu.
+
+[start=5]
+. Choose Run > Set Main Project > AnagramGame from the main menu.
After you set the project as the main project you can see that the name of the Anagram Game project is in bold in the Projects window. By default, when using the IDE to profile a project, the IDE will profile the main project. If no project is set as the main project the IDE will profile the project that is selected in the Projects window.
@@ -142,7 +146,9 @@
When you choose Timestamp and duration, the dialog box automatically sets the stopwatch to start at the beginning of the line of code and to end at the end of the following line. You can modify the lines where the stopwatch starts and stops.
-6. Modify the *Location (stop)* setting to change the end line to a couple lines after the begin line. Click Finish.
+
+[start=6]
+. Modify the *Location (stop)* setting to change the end line to a couple lines after the begin line. Click Finish.
image::images/stopwatch-dialog.png[title="Screenshot of New Profiling Point dialog box"]
When you set the profiling point, annotations for the start point and end point appear in the left margin of the editor.
@@ -151,13 +157,19 @@
If you open the Profiling Points window you can see that the stopwatch profiling point is added to the list.
-7. Click Profile Main Project in the toolbar.
-8. In the Select Profiling Task dialog box, click the *CPU* profiling task and select the *Advanced (instrumented)* option.
+
+[start=7]
+. Click Profile Main Project in the toolbar.
+
+[start=8]
+. In the Select Profiling Task dialog box, click the *CPU* profiling task and select the *Advanced (instrumented)* option.
image::images/select-profiling-task1.png[title="Select Profiling Task dialog box"]
*Note.* Profiling points can be used when analyzing performance or memory usage.
-9. Select *Use defined Profiling Points.* Click Run to start the profiling session.
+
+[start=9]
+. Select *Use defined Profiling Points.* Click Run to start the profiling session.
If you click *Show active profiling points* you can view the profiling points that are enabled for the profiling session.
@@ -184,9 +196,15 @@
5. Select either *Profiling data snapshot* or *Heap dump* as the Setting.
6. Specify a location where you want the files to be saved or keep the default location. Click Finish.
image::images/ppoints-profile-snapheap.png[title="New Take Snapshot profiling point with heap dump selected"]
-7. Click Profile Main Project in the toolbar.
-8. In the Select Profiling Task dialog box, click either *CPU* or *Memory* and select the *Advanced (instrumented)* option.
-9. Select *Use defined profiling points.* Click Run to start the profiling session.
+
+[start=7]
+. Click Profile Main Project in the toolbar.
+
+[start=8]
+. In the Select Profiling Task dialog box, click either *CPU* or *Memory* and select the *Advanced (instrumented)* option.
+
+[start=9]
+. Select *Use defined profiling points.* Click Run to start the profiling session.
If you click *Show active profiling points* you can view the profiling points that are enabled for the profiling session.
@@ -216,9 +234,15 @@
4. Select *Reset Results* as the Profiling Point Type. Click Next.
5. Specify a name for the profiling point and ensure the location of the profiling point is correct. Click Finish.
image::images/ppoints-newreset.png[title="Screenshot of New Reset Results pane"]
-6. Click Profile Main Project in the toolbar.
-7. In the Select Profiling Task dialog box, click either *CPU* or *Memory* and select the *Advanced (instrumented)* option
-8. Select *Use defined Profiling Points.* Click Run to start the profiling session.
+
+[start=6]
+. Click Profile Main Project in the toolbar.
+
+[start=7]
+. In the Select Profiling Task dialog box, click either *CPU* or *Memory* and select the *Advanced (instrumented)* option
+
+[start=8]
+. Select *Use defined Profiling Points.* Click Run to start the profiling session.
If you click *Show active profiling points* you can view the profiling points that are enabled for the profiling session.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ja.asciidoc
index ab7c184..c70c2e8 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ja.asciidoc
@@ -92,7 +92,9 @@
2. ソース・エディタで、プロファイリング・ポイントを追加する行を右クリックし、*「プロファイリング」*>*「プロファイリング・ポイントを挿入」*を選択して、新規プロファイリング・ポイント・ウィザードを開きます。
3. プロファイリング・ポイント・タイプとプロジェクトを選択します。「次」をクリックします。
image::images/ppoints-newstopwatch.png[title="「新規プロファイリング・ポイント」ダイアログ・ボックスのスクリーンショット"]
-4. プロファイリング・ポイントの名前を入力し、プロファイリング・ポイントのプロパティをカスタマイズします。「終了」をクリックします。
+
+[start=4]
+. プロファイリング・ポイントの名前を入力し、プロファイリング・ポイントのプロパティをカスタマイズします。「終了」をクリックします。
「終了」をクリックすると、プロファイリング・ポイント・タイプを表すアイコンが、ソース・エディタの左マージンの、プロファイリング・ポイントを挿入した行の横に表示されます。
@@ -157,7 +159,9 @@
「終了」をクリックすると、IDEによってAnagram Gameサンプル・プロジェクトが作成されます。
-5. メイン・メニューから「実行」>「メイン・プロジェクトとして設定」>「AnagramGame」を選択します。
+
+[start=5]
+. メイン・メニューから「実行」>「メイン・プロジェクトとして設定」>「AnagramGame」を選択します。
プロジェクトをメイン・プロジェクトに設定すると、Anagram Gameプロジェクトの名前が太字で「プロジェクト」ウィンドウに表示されます。デフォルトでは、IDEを使用してプロジェクトをプロファイルすると、IDEによってメイン・プロジェクトがプロファイルされます。メイン・プロジェクトとして設定されたプロジェクトがない場合、IDEでは、「プロジェクト」ウィンドウで選択されたプロジェクトがプロファイルされます。
@@ -181,7 +185,9 @@
「タイムスタンプと期間」を選択すると、ストップウォッチがコードのその行の先頭で開始し、次の行の最後で終了するようにダイアログ・ボックスによって自動的に設定されます。ストップウォッチが開始する行および停止する行は変更できます。
-6. 「*場所(停止)*」設定を変更して、終了行を開始行の数行後に変更します。「終了」をクリックします。
+
+[start=6]
+. 「*場所(停止)*」設定を変更して、終了行を開始行の数行後に変更します。「終了」をクリックします。
image::images/stopwatch-dialog.png[title="「新規プロファイリング・ポイント」ダイアログ・ボックスのスクリーンショット"]
プロファイリング・ポイントを設定すると、開始ポイントと終了ポイントの注釈がエディタの左マージンに表示されます。
@@ -190,13 +196,19 @@
「プロファイリング・ポイント」ウィンドウを開くと、「ストップウォッチ」プロファイリング・ポイントが一覧に追加されていることが確認できます。
-7. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
-8. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*プロファイリング・タスクをクリックし、*「詳細(計測済)」*オプションを選択します。
+
+[start=7]
+. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
+
+[start=8]
+. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*プロファイリング・タスクをクリックし、*「詳細(計測済)」*オプションを選択します。
image::images/select-profiling-task1.png[title="「プロファイリング・タスクの選択」ダイアログ・ボックス"]
*注意:*プロファイリング・ポイントは、パフォーマンスまたはメモリー使用状況を解析するときに使用できます。
-9. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
+
+[start=9]
+. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
「*アクティブなプロファイリング・ポイントを表示*」をクリックすると、そのプロファイリング・セッションに対して有効になっているプロファイリング・ポイントを表示できます。
@@ -224,9 +236,15 @@
5. 「設定」として「*プロファイリング・データのスナップショット*」または「*ヒープ・ダンプ*」のどちらかを選択します。
6. ファイルが保存される場所を指定するか、またはデフォルトの場所のままにします。「終了」をクリックします。
image::images/ppoints-profile-snapheap.png[title="「ヒープ・ダンプ」が選択された新しい「スナップショットの取得」プロファイリング・ポイント"]
-7. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
-8. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*または*「メモリー」*をクリックし、*「詳細(計測済)」*オプションを選択します。
-9. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
+
+[start=7]
+. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
+
+[start=8]
+. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*または*「メモリー」*をクリックし、*「詳細(計測済)」*オプションを選択します。
+
+[start=9]
+. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
「*アクティブなプロファイリング・ポイントを表示*」をクリックすると、そのプロファイリング・セッションに対して有効になっているプロファイリング・ポイントを表示できます。
@@ -257,9 +275,15 @@
4. 「プロファイリング・ポイント・タイプ」として「*結果のリセット*」を選択します。「次」をクリックします。
5. プロファイリング・ポイントの名前を指定し、そのプロファイリング・ポイントの場所が正しいことを確認します。「終了」をクリックします。
image::images/ppoints-newreset.png[title="新しい「結果のリセット」ペインのスクリーンショット"]
-6. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
-7. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*または*「メモリー」*をクリックし、*「詳細(計測済)」*オプションを選択します。
-8. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
+
+[start=6]
+. ツールバーの「メイン・プロジェクトのプロファイル」をクリックします。
+
+[start=7]
+. 「プロファイリング・タスクの選択」ダイアログ・ボックスで*「CPU」*または*「メモリー」*をクリックし、*「詳細(計測済)」*オプションを選択します。
+
+[start=8]
+. 「*定義済みプロファイリング・ポイントを使用*」を選択します。「実行」をクリックして、プロファイリング・セッションを開始します。
「*アクティブなプロファイリング・ポイントを表示*」をクリックすると、そのプロファイリング・セッションに対して有効になっているプロファイリング・ポイントを表示できます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_pt_BR.asciidoc
index a47363b..bd8af8f 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_pt_BR.asciidoc
@@ -92,7 +92,9 @@
2. No editor de código-fonte, clique com o botão direito do mouse na linha em que deseja adicionar o ponto de criação de perfil e escolha *Criação de Perfil* > *Inserir Ponto de Criação de Perfil* para abrir o assistente de Novo Ponto de Criação de Perfil.
3. Selecione um tipo de ponto de criação de perfil e o projeto. Clique em Próximo.
image::images/ppoints-newstopwatch.png[title="Tela da caixa de diálogo Novo Ponto de Criação de Perfil"]
-4. Insira um nome para o ponto de criação de perfil e personalize suas propriedades. Clique em Finalizar.
+
+[start=4]
+. Insira um nome para o ponto de criação de perfil e personalize suas propriedades. Clique em Finalizar.
Quando você clica em Finalizar, aparece um ícone que representa o tipo de ponto de criação de perfil na margem esquerda do editor de código-fonte ao lado da linha em que inseriu o ponto de criação de perfil.
@@ -157,7 +159,9 @@
Quando você clica em Finalizar, o IDE cria o projeto de amostra Jogo de Anagramas.
-5. Escolha Executar >Definir Projeto Principal > Jogo de Anagramas do menu principal.
+
+[start=5]
+. Escolha Executar >Definir Projeto Principal > Jogo de Anagramas do menu principal.
Depois que você definir o projeto como o principal você pode ver o nome do projeto Jogo de Anagramas em negrito na janela Projetos. Por default, ao usar o IDE para criar o perfil de um projeto, o IDE criará o perfil do projeto principal. Se nenhum projeto estiver definido como o projeto principal, o IDE irá criar o perfil do projeto selecionado na janela Projetos.
@@ -181,7 +185,9 @@
Quando escolher Timestamp e duração, a caixa de diálogo definirá automaticamente o cronômetro para iniciar no começo da linha de código até o final no término da linha seguinte. É possível modificar as linhas em que o cronômetro inicia e termina.
-6. Modifique a definição de *Localização (fim)* para alterar a linha final para algumas linhas depois da linha de início. Clique em Finalizar.
+
+[start=6]
+. Modifique a definição de *Localização (fim)* para alterar a linha final para algumas linhas depois da linha de início. Clique em Finalizar.
image::images/stopwatch-dialog.png[title="Tela da caixa de diálogo Novo Ponto de Criação de Perfil"]
Quando se define o ponto de criação de perfil, as anotações do ponto inicial e do ponto final aparecem na margem esquerda do editor.
@@ -190,13 +196,19 @@
Se você abrir a janela Pontos de Criação de Perfil verá que o ponto de criação de perfil do cronômetro é adicionado à lista.
-7. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
-8. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique na tarefa de criação de perfil *CPU* e selecione a opção *Avançado (instrumentado)*.
+
+[start=7]
+. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
+
+[start=8]
+. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique na tarefa de criação de perfil *CPU* e selecione a opção *Avançado (instrumentado)*.
image::images/select-profiling-task1.png[title="Caixa de diálogo Selecionar Tarefa de Criação de Perfil"]
*Observação.* Os pontos de criação de perfil podem ser usados ao analisar o desempenho ou uso de memória.
-9. Selecione *Usar Pontos de Criação de Perfil definidos.* Clique em Executar para iniciar a sessão de criação de perfil.
+
+[start=9]
+. Selecione *Usar Pontos de Criação de Perfil definidos.* Clique em Executar para iniciar a sessão de criação de perfil.
Se você clicar em *Mostrar pontos de criação de perfil ativos* você pode exibir os pontos de criação de perfil que são ativados para a sessão de criação de perfil.
@@ -224,9 +236,15 @@
5. Selecione *Snapshot de Dados de Criação de Perfil* ou *Dump de Heap* como Definição.
6. Especifique uma localização onde deseja que os arquivos sejam salvos ou deixe a localização default. Clique em Finalizar.
image::images/ppoints-profile-snapheap.png[title="Novo ponto de criação de perfil Obter Snapshot com dump de heap selecionado"]
-7. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
-8. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique em *CPU* ou *Memória* e selecione a opção *Avançado (instrumentado)*.
-9. Selecione *Usar pontos de criação de perfil definidos*. Clique em Executar para iniciar a sessão de criação de perfil.
+
+[start=7]
+. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
+
+[start=8]
+. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique em *CPU* ou *Memória* e selecione a opção *Avançado (instrumentado)*.
+
+[start=9]
+. Selecione *Usar pontos de criação de perfil definidos*. Clique em Executar para iniciar a sessão de criação de perfil.
Se você clicar em *Mostrar pontos de criação de perfil ativos* você pode exibir os pontos de criação de perfil que são ativados para a sessão de criação de perfil.
@@ -257,9 +275,15 @@
4. Selecione *Redefinir Resultados* como Tipo de Ponto de Criação de Perfil. Clique em Próximo.
5. Especifique um nome para o ponto de criação de perfil e certifique-se de que o local do ponto de criação de perfil esteja correto. Clique em Finalizar.
image::images/ppoints-newreset.png[title="Tela do painel Novo painel Redefinir Resultados"]
-6. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
-7. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique em *CPU* ou *Memória* e selecione a opção *Avançado (instrumentado)*.
-8. Selecione *Usar Pontos de Criação de Perfil definidos.* Clique em Executar para iniciar a sessão de criação de perfil.
+
+[start=6]
+. Clique em Criação de Perfil do Projeto Principal na barra de ferramentas.
+
+[start=7]
+. Na caixa de diálogo Selecionar Tarefa de Criação de Perfil, clique em *CPU* ou *Memória* e selecione a opção *Avançado (instrumentado)*.
+
+[start=8]
+. Selecione *Usar Pontos de Criação de Perfil definidos.* Clique em Executar para iniciar a sessão de criação de perfil.
Se você clicar em *Mostrar pontos de criação de perfil ativos* você pode exibir os pontos de criação de perfil que são ativados para a sessão de criação de perfil.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ru.asciidoc
index cefa5e1..1c3790a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_ru.asciidoc
@@ -93,7 +93,9 @@
2. В редакторе исходного кода правой кнопкой мыши щелкните строку, в которую необходимо добавить точку профилирования, и выберите *Профилирование* > *Вставить точку профилирования*, чтобы открыть мастер 'Новая точка профилирования'.
3. Выберите тип точки профилирования и проект. Нажмите кнопку "Далее".
image::images/ppoints-newstopwatch.png[title="Моментальный снимок диалогового окна 'Создать точку профилирования'"]
-4. Введите имя точки профилирования и настройки ее свойства. Нажмите кнопку 'Готово'.
+
+[start=4]
+. Введите имя точки профилирования и настройки ее свойства. Нажмите кнопку 'Готово'.
При нажатии кнопки "Готово" значок, обозначающий тип точки профилирования, появится в левом поле редактора исходного кода рядом со строкой для вставки точки профилирования.
@@ -158,7 +160,9 @@
При нажатии кнопки "Готово" среда IDE создает пример проекта Anagram Game.
-5. Выберите 'Выполнить' > 'Настроить основной проект' > AnagramGame в главном меню.
+
+[start=5]
+. Выберите 'Выполнить' > 'Настроить основной проект' > AnagramGame в главном меню.
После настройки проекта как основного имя проекта Anagram Game будет выделено полужирным в окне 'Проекты'. По умолчанию при использовании среды IDE для профилирования проекта среда IDE профилирует главный проект. Если ни один проект не выбран в качестве главного, среда IDE выполнит профилирование проекта, который выбран в окне 'Проекты'.
@@ -182,7 +186,9 @@
При выборе "Метка времени и длительность" диалоговое окно автоматически устанавливает запуск секундомера в начале строки кода и его остановку в конце следующей строки. Можно изменить строки запуска и остановки секундомера.
-6. Измените параметр *Местоположение (конец)*, чтобы изменить строку окончания на несколько строчек после строки начала. Нажмите кнопку 'Готово'.
+
+[start=6]
+. Измените параметр *Местоположение (конец)*, чтобы изменить строку окончания на несколько строчек после строки начала. Нажмите кнопку 'Готово'.
image::images/stopwatch-dialog.png[title="Моментальный снимок диалогового окна 'Создать точку профилирования'"]
При установке точки профилирования в левом поле редактора появляются аннотации для начальной и конечной точек.
@@ -191,13 +197,19 @@
При открытии окна "Точки профилирования" можно увидеть, что точка профилирования "секундомер" добавлена к списку.
-7. Щелкните "Профилировать главный проект" на панели инструментов.
-8. В диалоговом окне 'Выбрать задачу профилирования' щелкните задачу профилирования *ЦП* и выберите параметр *Расширенный (инструментарий)*.
+
+[start=7]
+. Щелкните "Профилировать главный проект" на панели инструментов.
+
+[start=8]
+. В диалоговом окне 'Выбрать задачу профилирования' щелкните задачу профилирования *ЦП* и выберите параметр *Расширенный (инструментарий)*.
image::images/select-profiling-task1.png[title="Диалоговое окно 'Выбор задачи профилирования'"]
*Примечание.* Точки профилирования могут быть использованы при анализе производительности и использования памяти.
-9. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
+
+[start=9]
+. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
При щелчке *Показать активные точки профилирования* можно просмотреть активные точки профилирования, включенные для сеанса профилирования.
@@ -225,9 +237,15 @@
5. Выберите *Моментальный снимок данных профилирования* или *Дамп кучи* в качестве параметра.
6. Укажите местоположение для сохранения файлов или оставьте местоположение по умолчанию. Нажмите кнопку "Завершить".
image::images/ppoints-profile-snapheap.png[title="Создать новый снимок точки профилирования с выбранным дампом кучи"]
-7. Щелкните "Профилировать главный проект" на панели инструментов.
-8. В диалоговом окне 'Выбрать задачу профилирования' щелкните *ЦП* или *Память* и выберите параметр *Расширенный (инструментарий)*.
-9. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
+
+[start=7]
+. Щелкните "Профилировать главный проект" на панели инструментов.
+
+[start=8]
+. В диалоговом окне 'Выбрать задачу профилирования' щелкните *ЦП* или *Память* и выберите параметр *Расширенный (инструментарий)*.
+
+[start=9]
+. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
При щелчке *Показать активные точки профилирования* можно просмотреть активные точки профилирования, включенные для сеанса профилирования.
@@ -258,9 +276,15 @@
4. Выберите *Сбросить результаты* в качестве типа точки профилирования. Нажмите кнопку "Далее".
5. Укажите имя точки профилирования и убедитесь в правильности местоположения точки профилирования. Нажмите кнопку "Завершить".
image::images/ppoints-newreset.png[title="Снимок панели 'Новые результаты сброса'"]
-6. Щелкните "Профилировать главный проект" на панели инструментов.
-7. В диалоговом окне 'Выбрать задачу профилирования' щелкните *ЦП* или *Память* и выберите параметр *Расширенный (инструментарий)*
-8. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
+
+[start=6]
+. Щелкните "Профилировать главный проект" на панели инструментов.
+
+[start=7]
+. В диалоговом окне 'Выбрать задачу профилирования' щелкните *ЦП* или *Память* и выберите параметр *Расширенный (инструментарий)*
+
+[start=8]
+. Выберите *Использовать определенные точки профилирования.* Нажмите кнопку "Выполнить" для начала сеанса профилирования.
При щелчке *Показать активные точки профилирования* можно просмотреть активные точки профилирования, включенные для сеанса профилирования.
diff --git a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_zh_CN.asciidoc
index 8be3607..fd72f40 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/profiler-profilingpoints_zh_CN.asciidoc
@@ -92,7 +92,9 @@
2. 在源代码编辑器中，右键单击要添加性能分析点的行，然后选择 *Profiling*（性能分析）> *Insert Profiling Point*（插入性能分析点），以打开新建性能分析点向导。
3. 选择性能分析点类型和项目。单击 "Next"（下一步）。
image::images/ppoints-newstopwatch.png[title=""New Profiling Point"（新建性能分析点）对话框的屏幕快照"]
-4. 键入性能分析点的名称并定制其属性。单击 "Finish"（完成）。
+
+[start=4]
+. 键入性能分析点的名称并定制其属性。单击 "Finish"（完成）。
单击 "Finish"（完成），此时在源代码编辑器的左旁注中，您会看到插入了性能分析点的行旁边将显示一个表示性能分析点类型的图标。
@@ -157,7 +159,9 @@
单击 "Finish"（完成），此时 IDE 将创建 Anagram Game 样例项目。
-5. 从主菜单中选择 "Run"（运行）> "Set Main Project"（设置为主项目）> "AnagramGame"。
+
+[start=5]
+. 从主菜单中选择 "Run"（运行）> "Set Main Project"（设置为主项目）> "AnagramGame"。
在将项目设置为主项目后，您可以看到 Anagram Game 项目的名称在 "Projects"（项目）窗口中显示为粗体。默认情况下，使用 IDE 对项目进行性能分析时，IDE 也将对主项目进行性能分析。如果未将项目设置为主项目，则 IDE 将会对在 "Projects"（项目）窗口中选择的项目进行分析。
@@ -181,7 +185,9 @@
选择 "Timestamp and duration"（时间戳和持续时间）时，对话框会自动将秒表设置为在代码行的开头开始，并在以下行的结尾结束。您可以修改秒表开始和结束所在的行。
-6. 修改 *Location (stop)*（位置 (停止)）设置，将结束行更改为开始行之后的几行。单击 "Finish"（完成）。
+
+[start=6]
+. 修改 *Location (stop)*（位置 (停止)）设置，将结束行更改为开始行之后的几行。单击 "Finish"（完成）。
image::images/stopwatch-dialog.png[title=""New Profiling Point"（新建性能分析点）对话框的屏幕快照"]
设置性能分析点时，开始和结束性能分析点的标注将显示在编辑器的左旁注中。
@@ -190,13 +196,19 @@
打开 "Profiling Points"（性能分析点）窗口时，可以看到秒表性能分析点添加到了列表中。
-7. 单击工具栏中的 "Profile Main Project"（分析主项目）。
-8. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 性能分析任务并选择 *Advanced (instrumented)*（高级（分析））选项。
+
+[start=7]
+. 单击工具栏中的 "Profile Main Project"（分析主项目）。
+
+[start=8]
+. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 性能分析任务并选择 *Advanced (instrumented)*（高级（分析））选项。
image::images/select-profiling-task1.png[title=""Select Profiling Task"（选择性能分析任务）对话框"]
*注：*可在分析性能或内存使用情况时使用性能分析点。
-9. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
+
+[start=9]
+. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
单击 *Show active profiling points*（显示活动的性能分析点）时，可以查看为性能分析会话启用的性能分析点。
@@ -224,9 +236,15 @@
5. 选择 *Profiling data snapshot*（性能分析数据快照）或 *Heap dump*（堆转储）作为设置。
6. 指定文件的保存位置或保留默认位置。单击 "Finish"（完成）。
image::images/ppoints-profile-snapheap.png[title="选择了堆转储的新生成快照性能分析点"]
-7. 单击工具栏中的 "Profile Main Project"（分析主项目）。
-8. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 或 *Memory*（内存）并选择 *Advanced (instrumented)*（高级（分析））选项。
-9. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
+
+[start=7]
+. 单击工具栏中的 "Profile Main Project"（分析主项目）。
+
+[start=8]
+. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 或 *Memory*（内存）并选择 *Advanced (instrumented)*（高级（分析））选项。
+
+[start=9]
+. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
单击 *Show active profiling points*（显示活动的性能分析点）时，可以查看为性能分析会话启用的性能分析点。
@@ -257,9 +275,15 @@
4. 选择 *Reset Results*（重置结果）作为性能分析点类型。单击 "Next"（下一步）。
5. 指定性能分析点的名称，并确保性能分析点的位置正确无误。单击 "Finish"（完成）。
image::images/ppoints-newreset.png[title=""New Reset Results"（新重置结果）窗格的屏幕快照"]
-6. 单击工具栏中的 "Profile Main Project"（分析主项目）。
-7. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 或 *Memory*（内存）并选择 *Advanced (instrumented)*（高级（分析））选项
-8. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
+
+[start=6]
+. 单击工具栏中的 "Profile Main Project"（分析主项目）。
+
+[start=7]
+. 在 "Select Profiling Task"（选择性能分析任务）对话框中，单击 *CPU* 或 *Memory*（内存）并选择 *Advanced (instrumented)*（高级（分析））选项
+
+[start=8]
+. 选择 *Use defined Profiling Points*（使用定义的性能分析点）。单击 "Run"（运行）以启动性能分析会话。
单击 *Show active profiling points*（显示活动的性能分析点）时，可以查看为性能分析会话启用的性能分析点。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend.asciidoc
index 5212fa0..3054e9e 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend.asciidoc
@@ -37,33 +37,33 @@
Alignment guidelines appear only when adding or moving components, indicating the preferred positions to which components snap when the mouse button is released. Once positioned, alignment guidelines are replaced by solid lines illustrating the common alignments shared among components as well as anchoring indicators.
|===
-|*Inset* |image::images/legend5.png[] |Insets are the preferred spacings between components and the containers within which they are located. Insets are suggested by dashed horizontal and vertical guidelines.
+|*Inset* |image:images/legend5.png[] |Insets are the preferred spacings between components and the containers within which they are located. Insets are suggested by dashed horizontal and vertical guidelines.
-|*Offset* |image::images/legend30.png[] |Offsets are the preferred spacings between adjacent components. Offsets are suggested by dashed horizontal and vertical guidelines.
+|*Offset* |image:images/legend30.png[] |Offsets are the preferred spacings between adjacent components. Offsets are suggested by dashed horizontal and vertical guidelines.
-|*Baseline* |image::images/legend13.png[] |Baseline alignment is the preferred relationship between adjacent components containing display text. Baseline alignment is suggested by dashed a horizontal guideline.
+|*Baseline* |image:images/legend13.png[] |Baseline alignment is the preferred relationship between adjacent components containing display text. Baseline alignment is suggested by dashed a horizontal guideline.
|*Edge*
|
-image::images/legend12.png[]
+image:images/legend12.png[]
-image::images/legend14.png[]
+image:images/legend14.png[]
-image::images/legend32.png[]
+image:images/legend32.png[]
-image::images/legend33.png[]
+image:images/legend33.png[]
|
Edge alignments (Top, Bottom, Left, and Right) are the alignment relationships possible between adjacent components. Edge alignments are suggested by dashed horizontal and vertical guidelines.
-|*Indentation* |image::images/legend31b.png[] |Indentation alignment is a special alignment relationship in which one component is located below another and offset slightly to the right. Indentation alignment is suggested by the appearance of two vertical dashed guidelines.
+|*Indentation* |image:images/legend31b.png[] |Indentation alignment is a special alignment relationship in which one component is located below another and offset slightly to the right. Indentation alignment is suggested by the appearance of two vertical dashed guidelines.
-|*Preferred Distance* |image::images/legend34.png[] |Preferred distances (Small, Medium, and Large) are gap sizes between adjacent components. Preferred distances are suggested by dashed horizontal or vertical guidelines.
+|*Preferred Distance* |image:images/legend34.png[] |Preferred distances (Small, Medium, and Large) are gap sizes between adjacent components. Preferred distances are suggested by dashed horizontal or vertical guidelines.
|===
-<<top,top>>
+
== Anchoring Indicators
@@ -72,53 +72,45 @@
|===
-|*Container* |image::images/legend50.png[] |Anchors connecting individual components to the containers within which they are located are represented by small semi-circular indicators with dashed lines extending from the container edge to the component itself.
+|*Container* |image:images/legend50.png[] |Anchors connecting individual components to the containers within which they are located are represented by small semi-circular indicators with dashed lines extending from the container edge to the component itself.
-|*Component* |image::images/legend51.png[] |Anchors connecting individual components to adjacent components are represented by small semi-circular indicators with dashed lines extending from the one component to the other.
+|*Component* |image:images/legend51.png[] |Anchors connecting individual components to adjacent components are represented by small semi-circular indicators with dashed lines extending from the one component to the other.
|===
-<<top,top>>
+
== Sizing Indicators
|===
-|*Same Size* |
+|*Same Size*
-image::images/legend28.png[]
+| image:images/legend28.png[] image:images/legend29.png[]
-image::images/legend29.png[]
+| Same Sizing is the state in which a group of components (adjacent or otherwise) are all set to have the same width or height. Same Sizing is illustrated by the appearance of small rectangular indicators appearing on the top edge of each component for which the property is set.
- |Same Sizing is the state in which a group of components (adjacent or otherwise) are all set to have the same width or height. Same Sizing is illustrated by the appearance of small rectangular indicators appearing on the top edge of each component for which the property is set.
+|*Auto-Resizing*
-|*Auto-Resizing* |
+| image:images/legend42.png[] image:images/legend41.png[] image:images/legend43.png[]
-image::images/legend42.png[]
-
-image::images/legend41.png[]
-
-image::images/legend43.png[]
-
- |
-Auto-Resizing is the state in which a component's width or height is set to resize dynamically at runtime. Auto-Resizing is indicated by the state of the horizontal and vertical Resizing buttons (called Change horizontal resizeability and Change vertical resizeability respectively) in the GUI Builder's toolbar. Auto-Resizing is enabled by selecting ``resizable`` in the Other Properties list in the Properties window.
+| Auto-Resizing is the state in which a component's width or height is set to resize dynamically at runtime. Auto-Resizing is indicated by the state of the horizontal and vertical Resizing buttons (called Change horizontal resizeability and Change vertical resizeability respectively) in the GUI Builder's toolbar. Auto-Resizing is enabled by selecting ``resizable`` in the Other Properties list in the Properties window.
|===
-<<top,top>>
+
== Highlighting and Handles
|===
-|* Highlighting* |image::images/legend10.png[] |Orange highlighting indicates where a selected component is going to be placed.
+|* Highlighting* |image:images/legend10.png[] |Orange highlighting indicates where a selected component is going to be placed.
-|*Handles* |image::images/legend11.png[] |Small square resize handles appear around a component's perimeter when a component is selected. Clicking, holding, and dragging a handle on the edge of a component resizes the latter.
+|*Handles* |image:images/legend11.png[] |Small square resize handles appear around a component's perimeter when a component is selected. Clicking, holding, and dragging a handle on the edge of a component resizes the latter.
|===
-<<top,top>>
-----
+
link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+Send Feedback on This Tutorial+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ja.asciidoc
index 50d882f..79df5ed 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ja.asciidoc
@@ -32,17 +32,13 @@
このドキュメントでは、IDEのGUIビルダー(旧コード名Matisse)でJava GUIを作成するときに表示される視覚的なフィード・バックについて説明します。
-=== 内容
-
-image::images/netbeans-stamp-80-74-73.png[title="このページの内容は、NetBeans IDE 6.9以降に適用されます"]
+== 内容
* <<alignment,位置揃えのガイドライン>>
* <<anchor,アンカーのインジケータ>>
* <<size,サイズのインジケータ>>
* <<highlight,強調表示とハンドル>>
* <<seealso,関連項目>>
-[quote]
-----
== 位置揃えのガイドライン
@@ -51,33 +47,33 @@
|===
-|*インセット* |image::images/legend5.png[] |インセットは、コンポーネントと、そのコンポーネントが配置されているコンテナの間隔です。インセットは、横方向と縦方向の点線のガイドラインで表示されます。
+|*インセット* |image:images/legend5.png[] |インセットは、コンポーネントと、そのコンポーネントが配置されているコンテナの間隔です。インセットは、横方向と縦方向の点線のガイドラインで表示されます。
-|*オフセット* |image::images/legend30.png[] |オフセットは、隣接するコンポーネントの間隔です。オフセットは、横方向と縦方向の点線のガイドラインで表示されます。
+|*オフセット* |image:images/legend30.png[] |オフセットは、隣接するコンポーネントの間隔です。オフセットは、横方向と縦方向の点線のガイドラインで表示されます。
-|*ベースライン* |image::images/legend13.png[] |ベースラインの位置揃えは、表示テキストを含む隣接するコンポーネント間の関係です。ベースラインの位置揃えは、横方向の点線のガイドラインで表示されます。
+|*ベースライン* |image:images/legend13.png[] |ベースラインの位置揃えは、表示テキストを含む隣接するコンポーネント間の関係です。ベースラインの位置揃えは、横方向の点線のガイドラインで表示されます。
|*エッジ*
- |
+|
-image::images/legend12.png[]
+image:images/legend12.png[]
-image::images/legend14.png[]
+image:images/legend14.png[]
-image::images/legend32.png[]
+image:images/legend32.png[]
-image::images/legend33.png[]
+image:images/legend33.png[]
- |
+|
エッジの位置揃え(上下左右)は、隣接するコンポーネント間の位置関係です。エッジの位置揃えは、横方向と縦方向の点線のガイドラインで表示されます。
-|*インデント設定* |image::images/legend31b.png[] |インデントの位置揃えは、1つのコンポーネントを別のコンポーネントの下に配置し、少し右にずらす特殊な位置関係です。インデントの位置揃えは、2本の縦方向の点線のガイドラインで表示されます。
+|*インデント設定* |image:images/legend31b.png[] |インデントの位置揃えは、1つのコンポーネントを別のコンポーネントの下に配置し、少し右にずらす特殊な位置関係です。インデントの位置揃えは、2本の縦方向の点線のガイドラインで表示されます。
-|*優先の距離* |image::images/legend34.png[] |優先の距離(小、中、および長)は、隣接するコンポーネント間の間隔のサイズです。優先の距離は、横方向または縦方向の点線のガイドラインで表示されます。
+|*優先の距離* |image:images/legend34.png[] |優先の距離(小、中、および長)は、隣接するコンポーネント間の間隔のサイズです。優先の距離は、横方向または縦方向の点線のガイドラインで表示されます。
|===
-<<top,先頭>>
+
== アンカーのインジケータ
@@ -86,53 +82,47 @@
|===
-|*コンテナ* |image::images/legend50.png[] |個々のコンポーネントを、そのコンポーネントが配置されているコンテナに接続するアンカーは、小さな半円のインジケータで表示され、コンテナの端からコンポーネントまで点線で結びます。
+|*コンテナ* |image:images/legend50.png[] |個々のコンポーネントを、そのコンポーネントが配置されているコンテナに接続するアンカーは、小さな半円のインジケータで表示され、コンテナの端からコンポーネントまで点線で結びます。
-|*コンポーネント* |image::images/legend51.png[] |個々のコンポーネントを隣接するコンポーネントに接続するアンカーは、小さな半円のインジケータで表示され、一方のコンポーネントから他方のコンポーネントまで点線で結びます。
+|*コンポーネント* |image:images/legend51.png[] |個々のコンポーネントを隣接するコンポーネントに接続するアンカーは、小さな半円のインジケータで表示され、一方のコンポーネントから他方のコンポーネントまで点線で結びます。
|===
-<<top,先頭>>
+
== サイズのインジケータ
|===
-|*同じサイズ* |
+|*同じサイズ*
+|
-image::images/legend28.png[]
+image:images/legend28.png[] image:images/legend29.png[]
-image::images/legend29.png[]
-
- |同じサイズは、コンポーネントのグループ(隣接しているかどうかに関係ない)が同じ幅と高さに設定されている状態です。同じサイズに設定されている場合、プロパティが設定されている各コンポーネントの上端に小さな四角形のインジケータが表示されます。
+|同じサイズは、コンポーネントのグループ(隣接しているかどうかに関係ない)が同じ幅と高さに設定されている状態です。同じサイズに設定されている場合、プロパティが設定されている各コンポーネントの上端に小さな四角形のインジケータが表示されます。
|*自動サイズ変更* |
-image::images/legend42.png[]
+image:images/legend42.png[] image:images/legend41.png[] image:images/legend43.png[]
-image::images/legend41.png[]
-
-image::images/legend43.png[]
-
- |
+|
自動サイズ変更は、コンポーネントの幅または高さが実行時に動的に変更されるように設定されている状態です。自動サイズ変更は、GUIビルダーのツールバーにある水平および垂直方向のサイズ変更ボタン(それぞれ、「水平方向のサイズ変更可能状態を変更」および「垂直方向のサイズ変更可能状態を変更」と呼ばれます)の状態で示されます。自動サイズ変更は、「プロパティ」ウィンドウ内の「他のプロパティ」リストにある「 ``resizable`` 」を選択することによって有効になります。
|===
-<<top,先頭>>
+
== 強調表示とハンドル
|===
-|*強調表示* |image::images/legend10.png[] |オレンジ色の強調表示は、選択されたコンポーネントが配置される場所を示します。
+|*強調表示* |image:images/legend10.png[] |オレンジ色の強調表示は、選択されたコンポーネントが配置される場所を示します。
-|*ハンドル* |image::images/legend11.png[] |コンポーネントが選択されると、そのコンポーネントの境界の周りに小さい四角形のサイズ変更ハンドルが表示されます。コンポーネントの端にあるハンドルをクリックしたままドラッグすると、コンポーネントのサイズが変更されます。
+|*ハンドル* |image:images/legend11.png[] |コンポーネントが選択されると、そのコンポーネントの境界の周りに小さい四角形のサイズ変更ハンドルが表示されます。コンポーネントの端にあるハンドルをクリックしたままドラッグすると、コンポーネントのサイズが変更されます。
|===
-<<top,先頭>>
-----
+
link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+このチュートリアルに関するご意見をお寄せください+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_pt_BR.asciidoc
index 5f8a563..b60470c 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_pt_BR.asciidoc
@@ -31,47 +31,39 @@
Este documento descreve o feedback visual que o GUI Builder do IDE (antes chamado de Matisse) fornece durante o processo de criação da GUI do Java.
-
-
-image::images/netbeans-stamp-80-74-73.png[title="O conteúdo desta página se aplica ao NetBeans IDE 6.9 e mais recente"]
-
-[quote]
-----
-
-
== Linhas-Guia de Alinhamento
As linhas-guia de alinhamento aparecem somente ao adicionar ou mover componentes, indicando as posições preferenciais nas quais deverão ser ajustados os componentes quando o botão do mouse é liberado. Uma vez posicionadas, as linhas-guia de alinhamento são substituídas por linhas sólidas, ilustrando os alinhamentos comuns compartilhados entre os componentes, assim como os indicadores de ancoramento.
|===
-|*Inset* |image::images/legend5.png[] |As inserções são os espaçamentos preferenciais entre os componentes e os contêineres nos quais eles estão localizados. Os insets são sugeridos por linhas-guia pontilhadas horizontais e verticais.
+|*Inset* |image:images/legend5.png[] |As inserções são os espaçamentos preferenciais entre os componentes e os contêineres nos quais eles estão localizados. Os insets são sugeridos por linhas-guia pontilhadas horizontais e verticais.
-|*Deslocamento* |image::images/legend30.png[] |Os deslocamentos são os espaçamentos preferenciais entre componentes adjacentes. Os deslocamentos são sugeridos por linhas-guias pontilhadas horizontais e verticais.
+|*Deslocamento* |image:images/legend30.png[] |Os deslocamentos são os espaçamentos preferenciais entre componentes adjacentes. Os deslocamentos são sugeridos por linhas-guias pontilhadas horizontais e verticais.
-|*Linha de Base* |image::images/legend13.png[] |O alinhamento de linha base é o relacionamento preferencial entre componentes adjacentes que contêm o texto de exibição. O alinhamento de linha de base é sugerido por uma linha-guia horizontal compartilhada.
+|*Linha de Base* |image:images/legend13.png[] |O alinhamento de linha base é o relacionamento preferencial entre componentes adjacentes que contêm o texto de exibição. O alinhamento de linha de base é sugerido por uma linha-guia horizontal compartilhada.
|*Borda*
- |
+|
-image::images/legend12.png[]
+image:images/legend12.png[]
-image::images/legend14.png[]
+image:images/legend14.png[]
-image::images/legend32.png[]
+image:images/legend32.png[]
-image::images/legend33.png[]
+image:images/legend33.png[]
- |
+|
Os alinhamentos de borda (Superior, Inferior, Esquerda e Direita) são as relações de alinhamento possíveis entre componentes adjacentes. Os alinhamentos de borda são sugeridos por linhas-guias pontilhadas horizontais e verticais.
-|*Recuo* |image::images/legend31b.png[] |O alinhamento de recuo é um relacionamento de alinhamento especial em que um componente é localizado abaixo de outro e deslocado ligeiramente para a direita. O alinhamento de recuo é sugerido pela apresentação de duas linhas-guias pontilhadas verticais.
+|*Recuo* |image:images/legend31b.png[] |O alinhamento de recuo é um relacionamento de alinhamento especial em que um componente é localizado abaixo de outro e deslocado ligeiramente para a direita. O alinhamento de recuo é sugerido pela apresentação de duas linhas-guias pontilhadas verticais.
-|*Distância Preferencial* |image::images/legend34.png[] |As distâncias preferenciais (pequeno, médio e grande) são tamanhos de lacunas entre componentes adjacentes. As distâncias preferenciais são sugeridas por linhas-guias horizontais e verticais.
+|*Distância Preferencial* |image:images/legend34.png[] |As distâncias preferenciais (pequeno, médio e grande) são tamanhos de lacunas entre componentes adjacentes. As distâncias preferenciais são sugeridas por linhas-guias horizontais e verticais.
|===
-<<top,início>>
+
== Indicadores de Ancoramento
@@ -80,53 +72,47 @@
|===
-|*Contêiner* |image::images/legend50.png[] |As âncoras que conectam componentes individuais aos contêineres nos quais elas se localizam são representadas por pequenos indicadores semicirculares com linhas pontilhadas que se estendem da borda do contêiner ao próprio componente.
+|*Contêiner* |image:images/legend50.png[] |As âncoras que conectam componentes individuais aos contêineres nos quais elas se localizam são representadas por pequenos indicadores semicirculares com linhas pontilhadas que se estendem da borda do contêiner ao próprio componente.
-|*Componente* |image::images/legend51.png[] |As âncoras que conectam componentes individuais aos componentes adjacentes são representadas por pequenos indicadores semicirculares com linhas pontilhadas que se estendem de um componente ao outro.
+|*Componente* |image:images/legend51.png[] |As âncoras que conectam componentes individuais aos componentes adjacentes são representadas por pequenos indicadores semicirculares com linhas pontilhadas que se estendem de um componente ao outro.
|===
-<<top,início>>
+
== Indicadores de Dimensionamento
|===
-|*Mesmo Tamanho* |
+|*Mesmo Tamanho*
+|
-image::images/legend28.png[]
+image:images/legend28.png[] image:images/legend29.png[]
-image::images/legend29.png[]
-
- |Mesmo dimensionamento é o estado em que um grupo de componentes (adjacentes ou não) é definido com a mesma largura ou altura. O mesmo dimensionamento é ilustrado pela aparição de pequenos indicadores retangulares sobre a borda superior de cada componente para o qual a propriedade é definida.
+|Mesmo dimensionamento é o estado em que um grupo de componentes (adjacentes ou não) é definido com a mesma largura ou altura. O mesmo dimensionamento é ilustrado pela aparição de pequenos indicadores retangulares sobre a borda superior de cada componente para o qual a propriedade é definida.
|*Redimensionamento Automático* |
-image::images/legend42.png[]
+image:images/legend42.png[] image:images/legend41.png[] image:images/legend43.png[]
-image::images/legend41.png[]
-
-image::images/legend43.png[]
-
- |
+|
O Redimensionamento Automático é o estado em que a largura ou a altura do componente é definida para se redimensionar dinamicamente no runtime. O redimensionamento automático é indicado pelo estado dos botões de Redimensionamento horizontais e verticais (chamados Alterar redimensionamento horizontal e Alterar redimensionamento vertical) na barra de ferramentas do GUI Builder. Para ativar o Redimensionamento Automático, selecione ``redimensionável`` na lista que fica na janela Outras Propriedades.
|===
-<<top,início>>
+
== Realce e Handles
|===
-|* Realce* |image::images/legend10.png[] |O realce laranja indica onde um componente selecionado será colocado.
+|* Realce* |image:images/legend10.png[] |O realce laranja indica onde um componente selecionado será colocado.
-|*Handles* |image::images/legend11.png[] |Aparecem pequenos handles quadrados em torno do perímetro do componente quando este é selecionado. A ação de clicar, pressionar e arrastar um handle na extremidade de um componente o redimensiona.
+|*Handles* |image:images/legend11.png[] |Aparecem pequenos handles quadrados em torno do perímetro do componente quando este é selecionado. A ação de clicar, pressionar e arrastar um handle na extremidade de um componente o redimensiona.
|===
-<<top,início>>
-----
+
link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+Enviar Feedback neste Tutorial+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ru.asciidoc
index 3dfee5c..97216c5 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_ru.asciidoc
@@ -33,45 +33,39 @@
-image::images/netbeans-stamp-80-74-73.png[title="Содержимое этой страницы применимо к IDE NetBeans 6.9 и более поздним версиям"]
-
-[quote]
-----
-
-
== Направляющие линии
Направляющие появляются только при добавлении или перемещении элементов и указывают предпочтительные позиции, согласно которым размещаются элементы при отпускании кнопки мыши. После размещения направляющие заменяются сплошными линиями, обозначающими выравнивание элементов и точки их привязки.
|===
-|*Отступ* |image::images/legend5.png[] |Отступы – это предпочтительные расстояния между элементами и контейнерами, в которых расположены эти элементы. Отступы обозначаются горизонтальными и вертикальными штриховыми линиями.
+|*Отступ* |image:images/legend5.png[] |Отступы – это предпочтительные расстояния между элементами и контейнерами, в которых расположены эти элементы. Отступы обозначаются горизонтальными и вертикальными штриховыми линиями.
-|*Смещение* |image::images/legend30.png[] |Смещения – это предпочтительный интервал между смежными элементами. Предлагаемые смещения обозначаются горизонтальными и вертикальными штриховыми линиями.
+|*Смещение* |image:images/legend30.png[] |Смещения – это предпочтительный интервал между смежными элементами. Предлагаемые смещения обозначаются горизонтальными и вертикальными штриховыми линиями.
-|*Базовая линия* |image::images/legend13.png[] |Выравнивание по базовой линии отражает предпочтительное соотношение между смежными элементами, содержащими отображаемый текст. Базовая линия обозначается штриховой горизонтальной линией.
+|*Базовая линия* |image:images/legend13.png[] |Выравнивание по базовой линии отражает предпочтительное соотношение между смежными элементами, содержащими отображаемый текст. Базовая линия обозначается штриховой горизонтальной линией.
|*Граница*
- |
+|
-image::images/legend12.png[]
+image:images/legend12.png[]
-image::images/legend14.png[]
+image:images/legend14.png[]
-image::images/legend32.png[]
+image:images/legend32.png[]
-image::images/legend33.png[]
+image:images/legend33.png[]
- |
+|
Границы (верхняя, нижняя, левая и правая) определяют возможные соотношения по выравниванию смежных элементов. Предлагаемые границы обозначаются штриховыми горизонтальными и вертикальными линиями.
-|*Сдвиг* |image::images/legend31b.png[] |Сдвиг определяет, на сколько один элемент смещен относительно другого в направлении вниз и вправо. Предлагаемый сдвиг обозначается двумя вертикальными штриховыми линиями.
+|*Сдвиг* |image:images/legend31b.png[] |Сдвиг определяет, на сколько один элемент смещен относительно другого в направлении вниз и вправо. Предлагаемый сдвиг обозначается двумя вертикальными штриховыми линиями.
-|*Предпочтительное расстояние* |image::images/legend34.png[] |Предпочтительные расстояния (маленькое, среднее и большое) представляют собой размеры промежутков между смежными компонентами. Предпочтительные расстояния предлагаются в виде горизонтальных или вертикальных штриховых направляющих.
+|*Предпочтительное расстояние* |image:images/legend34.png[] |Предпочтительные расстояния (маленькое, среднее и большое) представляют собой размеры промежутков между смежными компонентами. Предпочтительные расстояния предлагаются в виде горизонтальных или вертикальных штриховых направляющих.
|===
-<<top,В начало>>
+
== Точки привязки
@@ -80,53 +74,46 @@
|===
-|*Контейнер* |image::images/legend50.png[] |Привязки, соединяющие отдельные элементы c контейнерами, внутри которых они расположены, представлены в виде небольших полукруглых индикаторов со штриховыми линиями, идущими от границы контейнера непосредственно к элементу.
+|*Контейнер* |image:images/legend50.png[] |Привязки, соединяющие отдельные элементы c контейнерами, внутри которых они расположены, представлены в виде небольших полукруглых индикаторов со штриховыми линиями, идущими от границы контейнера непосредственно к элементу.
-|*Элемент* |image::images/legend51.png[] |Привязки, соединяющие отдельные элементы со смежным элементами, представлены в виде небольших полукруглых индикаторов со штриховыми линиями, идущими от одного элемента до другого.
+|*Элемент* |image:images/legend51.png[] |Привязки, соединяющие отдельные элементы со смежным элементами, представлены в виде небольших полукруглых индикаторов со штриховыми линиями, идущими от одного элемента до другого.
|===
-<<top,В начало>>
+
== Установка размеров индикаторов
|===
-|*Одинаковый размер* |
+|*Одинаковый размер*
+|
-image::images/legend28.png[]
+image:images/legend28.png[] image:images/legend29.png[]
-image::images/legend29.png[]
-
- |Если ряд элементов (не обязательно смежных) имеет одинаковую высоту или ширину, говорят, что они имеют одинаковый размер. Эта ситуация обозначается наличием небольших прямоугольников на верхней границе каждого элемента, имеющего это свойство.
+|Если ряд элементов (не обязательно смежных) имеет одинаковую высоту или ширину, говорят, что они имеют одинаковый размер. Эта ситуация обозначается наличием небольших прямоугольников на верхней границе каждого элемента, имеющего это свойство.
|*Автоматическое изменение размера* |
-image::images/legend42.png[]
-
-image::images/legend41.png[]
-
-image::images/legend43.png[]
-
- |
+image:images/legend42.png[] image:images/legend41.png[] image:images/legend43.png[]
+|
Автоматическое изменение размера – это динамическое изменение ширины или высоты элемента во время выполнения. Автоматическое изменение размера обозначается состоянием кнопок изменения размера в горизонтальном и вертикальном направлениях (переменность ширины и высоты соответственно) на панели инструментов Конструктора GUI. Для включения функции автоматического изменения размера выберите ``изменять размер`` в списке "Другие свойства" окна "Свойства".
|===
-<<top,В начало>>
+
== Выделение и ручки изменения размера
|===
-|* Выделение* |image::images/legend10.png[] |Выделение оранжевым цветом обозначает место, в которое будет перемещен выбранный компонент.
+|* Выделение* |image:images/legend10.png[] |Выделение оранжевым цветом обозначает место, в которое будет перемещен выбранный компонент.
-|*Ручки изменения размера* |image::images/legend11.png[] |Маленькие квадратные ручки изменения размера отображаются по периметру выбранного компонента. Для изменения размера компонента необходимо нажать ручку и, удерживая, перетащить ее в нужную позицию.
+|*Ручки изменения размера* |image:images/legend11.png[] |Маленькие квадратные ручки изменения размера отображаются по периметру выбранного компонента. Для изменения размера компонента необходимо нажать ручку и, удерживая, перетащить ее в нужную позицию.
|===
-<<top,В начало>>
-----
+
link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+Отправить отзыв по этому учебному курсу+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_zh_CN.asciidoc
index c8a201e..317f468 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui-legend_zh_CN.asciidoc
@@ -32,46 +32,39 @@
本文档介绍 IDE 的 GUI 构建器在处理 Java GUI 的创建期间提供的可视反馈（以前的代码名称为 Matisse）。
-
-image::images/netbeans-stamp-80-74-73.png[title="此页上的内容适用于 NetBeans IDE 6.9 及更高版本"]
-
-[quote]
-----
-
-
== 对齐基准线
只有当添加或移动组件时，才会出现对齐基准线，此基准线指示当松开鼠标按钮时组件将对齐的首选位置。定位后，对齐基准线将被实线和锚点指示符所取代，实线阐明组件之间共享的公共对齐位置。
|===
-|*插入量* |image::images/legend5.png[] |插入量是组件以及组件所在的容器之间的首选间距。插入量是通过水平和垂直基准虚线来指示的。
+|*插入量* |image:images/legend5.png[] |插入量是组件以及组件所在的容器之间的首选间距。插入量是通过水平和垂直基准虚线来指示的。
-|*偏移* |image::images/legend30.png[] |偏移是相邻组件之间的首选间距。偏移是通过水平和垂直基准虚线来指示的。
+|*偏移* |image:images/legend30.png[] |偏移是相邻组件之间的首选间距。偏移是通过水平和垂直基准虚线来指示的。
-|*基线* |image::images/legend13.png[] |基线对齐是包含显示文本的相邻组件之间的首选关系。基线对齐是通过水平基准虚线来指示的。
+|*基线* |image:images/legend13.png[] |基线对齐是包含显示文本的相邻组件之间的首选关系。基线对齐是通过水平基准虚线来指示的。
|*边*
- |
+|
-image::images/legend12.png[]
+image:images/legend12.png[]
-image::images/legend14.png[]
+image:images/legend14.png[]
-image::images/legend32.png[]
+image:images/legend32.png[]
-image::images/legend33.png[]
+image:images/legend33.png[]
- |
+|
边对齐（上、下、左、右）是相邻组件之间的可能的对齐关系。边对齐是通过水平和垂直基准虚线来指示的。
-|*缩进* |image::images/legend31b.png[] |缩进对齐是一种特殊的对齐关系，其中一个组件位于另一个组件的下方并稍稍向右偏移。缩进对齐是通过两条垂直的基准虚线来指示的。
+|*缩进* |image:images/legend31b.png[] |缩进对齐是一种特殊的对齐关系，其中一个组件位于另一个组件的下方并稍稍向右偏移。缩进对齐是通过两条垂直的基准虚线来指示的。
-|*首选间距* |image::images/legend34.png[] |首选间距（小、中、大）是相邻组件之间的间隙大小。首选间距是通过水平或垂直基准虚线来指示的。
+|*首选间距* |image:images/legend34.png[] |首选间距（小、中、大）是相邻组件之间的间隙大小。首选间距是通过水平或垂直基准虚线来指示的。
|===
-<<top,返回页首>>
+
== 锚点指示符
@@ -80,12 +73,12 @@
|===
-|*容器* |image::images/legend50.png[] |将各个组件连接到它们所在的容器的锚点由小的半圆指示符表示，这些指示符具有从容器边缘延伸到组件本身的虚线。
+|*容器* |image:images/legend50.png[] |将各个组件连接到它们所在的容器的锚点由小的半圆指示符表示，这些指示符具有从容器边缘延伸到组件本身的虚线。
-|*组件* |image::images/legend51.png[] |将各个组件连接到相邻组件的锚点由小的半圆指示符表示，这些指示符具有从一个组件延伸到另一个组件的虚线。
+|*组件* |image:images/legend51.png[] |将各个组件连接到相邻组件的锚点由小的半圆指示符表示，这些指示符具有从一个组件延伸到另一个组件的虚线。
|===
-<<top,返回页首>>
+
== 大小调整指示符
@@ -94,39 +87,32 @@
|===
|*相同大小* |
-image::images/legend28.png[]
+image:images/legend28.png[] image:images/legend29.png[]
-image::images/legend29.png[]
-
- |“相同大小”是一组组件（相邻或不相邻）均设置为具有相同宽度或高度的状态。“相同大小”由小的矩形指示符阐明，这些指示符显示在设置了该属性的每个组件的上边缘。
+|“相同大小”是一组组件（相邻或不相邻）均设置为具有相同宽度或高度的状态。“相同大小”由小的矩形指示符阐明，这些指示符显示在设置了该属性的每个组件的上边缘。
|*自动调整大小* |
-image::images/legend42.png[]
+image:images/legend42.png[] image:images/legend41.png[] image:images/legend43.png[]
-image::images/legend41.png[]
-
-image::images/legend43.png[]
-
- |
+|
“自动调整大小”是组件的宽度或高度设置为在运行时动态调整的状态。“自动调整大小”由 GUI 构建器工具栏中的水平调整大小按钮和垂直调整大小按钮（分别称为“更改水平大小可调性”和“更改垂直大小可调性”）的状态来指示。通过选择“属性”窗口的“其他属性”列表中的 ``可调整大小`` ，可以启用自动调整大小。
|===
-<<top,返回页首>>
+
== 突出显示和控柄
|===
-|*突出显示* |image::images/legend10.png[] |橙色突出显示指明了选定组件将要放置的位置。
+|*突出显示* |image:images/legend10.png[] |橙色突出显示指明了选定组件将要放置的位置。
-|*控柄* |image::images/legend11.png[] |选择了组件时，该组件周围会显示小方形大小调整控柄。单击、按住并拖动组件边缘的控柄可以调整该组件的大小。
+|*控柄* |image:images/legend11.png[] |选择了组件时，该组件周围会显示小方形大小调整控柄。单击、按住并拖动组件边缘的控柄可以调整该组件的大小。
|===
-<<top,返回页首>>
-----
+
link:/about/contact_form.html?to=3&subject=Feedback:%20GUI%20Builder%20Visual%20Feedback%20Legend,%20NetBeans%20IDE[+发送有关此教程的反馈意见+]
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui.asciidoc
index 46f02d9..f7dc268 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui.asciidoc
@@ -43,8 +43,7 @@
Because all Java development in the IDE takes place within projects, we first need to create a new ``ContactEditor`` project within which to store sources and other project files. An IDE project is a group of Java source files plus its associated meta data, including project-specific properties files, an Ant build script that controls the build and run settings, and a ``project.xml`` file that maps Ant targets to IDE commands. While Java applications often consist of several IDE projects, for the purposes of this tutorial, we will build a simple application which is stored entirely in a single project.
-|===
-|To create a new ``ContactEditor`` application project:
+To create a new ``ContactEditor`` application project:
1. Choose File > New Project. Alternately, you can click the New Project icon in the IDE toolbar.
2. In the Categories pane, select the Java node and in the Projects pane, choose Java Application. Click Next.
@@ -56,29 +55,27 @@
The IDE creates the ``ContactEditor`` folder on your system in the designated location. This folder contains all of the project's associated files, including its Ant script, folders for storing sources and tests, and a folder for project-specific metadata. To view the project structure, use the IDE's Files window.
-|===
-
-
=== Creating a JFrame Container
After creating the new application, you may have noticed that the Source Packages folder in the Projects window contains an empty ``<default package>`` node. To proceed with building our interface, we need to create a Java container within which we will place the other required GUI components. In this step we'll create a container using the ``JFrame`` component and place the container in a new package.
-|===
-|To add a ``JFrame`` container:
+To add a ``JFrame`` container:
1. In the Projects window, right-click the ``ContactEditor`` node and choose New > JFrame Form.
Alternatively, you can find a JFrame form by choosing New > Other > Swing GUI Forms > JFrame Form.
-2. Enter ``ContactEditorUI`` as the Class Name.
-3. Enter ``my.contacteditor`` as the package.
-4. Click Finish.
+
+[start=2]
+. Enter ``ContactEditorUI`` as the Class Name.
+
+[start=3]
+. Enter ``my.contacteditor`` as the package.
+
+[start=4]
+. Click Finish.
The IDE creates the ``ContactEditorUI`` form and the ``ContactEditorUI`` class within the ``ContactEditorUI.java`` application and opens the ``ContactEditorUI`` form in the GUI Builder. Notice that the ``my.contacteditor`` package replaces the default package.
-
-<<top,top>>
-
-
== Getting Familiar with the GUI Builder
Now that we've set up a new project for our application, let's take a minute to familiarize ourselves with the GUI Builder's interface.
@@ -103,16 +100,13 @@
NOTE: For advanced developers, the Palette Manager is available that enables you to add custom components from JARs, libraries, or other projects to the Palette. To add custom components through the Palette Manager, choose Tools > Palette > Swing/AWT Components.
-<<top,top>>
+
== Key Concepts
The IDE's GUI Builder solves the core problem of Java GUI creation by streamlining the workflow of creating graphical interfaces, freeing developers from the complexities of Swing layout managers. It does this by extending the current NetBeans IDE GUI Builder to support a straightforward "Free Design" paradigm with simple layout rules that are easy to understand and use. As you lay out your form, the GUI Builder provides visual guidelines suggesting optimal spacing and alignment of components. In the background, the GUI Builder translates your design decisions into a functional UI that is implemented using the new GroupLayout layout manager and other Swing constructs. Because it uses a dynamic layout model, GUI's built with the GUI Builder behave as you would expect at runtime, adjusting to accommodate any changes you make without altering the defined relationships between components. Whenever you resize the form, switch locales, or specify a different look and feel, your GUI automatically adjusts to respect the target look and feel's insets and offsets.
-[quote]
-----
-
=== Free Design
In the IDE's GUI Builder, you can build your forms by simply putting components where you want them as though you were using absolute positioning. The GUI Builder figures out which layout attributes are required and then generates the code for you automatically. You need not concern yourself with insets, anchors, fills, and so forth.
@@ -127,20 +121,12 @@
The GUI Builder also provides visual feedback regarding component anchoring and chaining relationships. These indicators enable you to quickly identify the various positioning relationships and component pinning behavior that affect the way your GUI will both appear and behave at runtime. This speeds the GUI design process, enabling you to quickly create professional-looking visual interfaces that work.
-
-----
-
-<<top,top>>
-
-
== First Things First
Now that you have familiarized yourself with the GUI builder's interface, it's time to begin developing the UI of our ContactEditor application. In this section we'll take a look at using the IDE's Palette to add the various GUI components that we need to our form.
Thanks to the IDE's Free Design paradigm, you no longer have to struggle with layout managers to control the size and position of the components within your containers. All you need to do is drag and drop the components you need to your GUI form as shown in the illustrations that follow.
-[quote]
-----
NOTE: Refer to the link:http://bits.netbeans.org/media/quickstart-gui-add.swf[+Adding individual and multiple components (.swf)+] screencast for an interactive demo on the section below.
@@ -150,8 +136,7 @@
Since we've already added a JFrame as our form's top-level container, the next step is to add a couple of JPanels which will enable us to cluster the components of our UI using titled borders. Refer to the following illustrations and notice the IDE's "drag and drop" behavior when accomplishing this.
-|===
-|To add a JPanel:
+To add a JPanel:
1. In the Palette window, select the Panel component from the Swing Containers category by clicking and releasing the mouse button.
2. Move the cursor to the upper left corner of the form in the GUI Builder. When the component is located near the container's top and left edges, horizontal and vertical alignment guidelines appear indicating the preferred margins. Click in the form to place the JPanel in this location.
@@ -159,8 +144,6 @@
The ``JPanel`` component appears in the ``ContactEditorUI`` form with orange highlighting signifying that it is selected. After releasing the mouse button, small indicators appear to show the component's anchoring relationships and a corresponding JPanel node is displayed in the Navigator window, as shown in the following illustration.
-|===
-
[.feature]
--
image::images/02_add_panels_1-small.png[role="left", link="images/02_add_panels_1.png"]
@@ -168,8 +151,7 @@
Next, we need to resize the JPanel to make room for the components we'll place within it a little later, but let's take a minute to point out another of the GUI Builder's visualization features first. In order to do this we need to deselect the JPanel we just added. Because we haven't added a title border yet, the panel disappears. Notice, however, that when you pass the cursor over the JPanel, its edges change to light gray so that its position can be clearly seen. You need only to click anywhere within the component to reselect it and cause the resize handles and anchoring indicators to reappear.
-|===
-|To resize the JPanel:
+To resize the JPanel:
1. Select the JPanel you just added. The small square resize handles reappear around the component's perimeter.
2. Click and hold the resize handle on the right edge of the JPanel and drag until the dotted alignment guideline appears near the form's edge.
@@ -178,8 +160,6 @@
The ``JPanel`` component is extended to span between the container's left and right margins in accordance with the recommended offset, as shown in the following illustration.
-|===
-
[.feature]
--
image::images/02_add_panels_2-small.png[role="left", link="images/02_add_panels_2.png"]
@@ -187,33 +167,26 @@
Now that we've added a panel to contain our UI's Name information, we need to repeat the process to add another directly below the first for the E-mail information. Referring to the following illustrations, repeat the previous two tasks, paying attention to the GUI Builder's suggested positioning. Notice that the suggested vertical spacing between the two JPanels is much narrower than that at the edges. Once you have added the second JPanel, resize it such that it fills the form's remaining vertical space.
-|===
-|[.feature]
+[.feature]
--
image::images/02_add_panels_3-small.png[role="left", link="images/02_add_panels_3.png"]
--
- |
-
[.feature]
--
image::images/02_add_panels_4-small.png[role="left", link="images/02_add_panels_4.png"]
--
-
-|[.feature]
+[.feature]
--
image::images/02_add_panels_5-small.png[role="left", link="images/02_add_panels_5.png"]
--
-|===
-
Because we want to visually distinguish the functions in the upper and lower sections of our GUI, we need to add a border and title to each JPanel. First we'll accomplish this using the Properties window and then we'll try it using the pop-up menu.
-|===
-|To add title borders to the JPanels:
+To add title borders to the JPanels:
1. Select the top JPanel in the GUI Builder.
2. In the Properties window, click the ellipsis button (...) next to the Border property.
@@ -225,8 +198,6 @@
Titled borders are added to both ``JPanel`` components.
-|===
-
[.feature]
--
image::images/02_add_borders-small.png[role="left", link="images/02_add_borders.png"]
@@ -237,8 +208,7 @@
Now we need to start adding the components that will present the actual contact information in our contact list. In this task we'll add four JTextFields that will display the contact information and the JLabels that will describe them. While accomplishing this, notice the horizontal and vertical guidelines that the GUI Builder displays, suggesting the preferred component spacing as defined by your operating system's look and feel. This ensures that your GUI is automatically rendered respecting the target operating system's look and feel at runtime.
-|===
-|To add a JLabel to the form:
+To add a JLabel to the form:
1. In the Palette window, select the Label component from the Swing Controls category.
2. Move the cursor over the ``Name`` JPanel we added earlier. When the guidelines appear indicating that the JLabel is positioned in the top left corner of the JPanel with a small margin at the top and left edges, click to place the label.
@@ -246,12 +216,10 @@
The JLabel is added to the form and a corresponding node representing the component is added to the Inspector window.
-|===
Before going further, we need to edit the display text of the JLabel we just added. Though you can edit component display text at any point, the easiest way is to do this as you add them.
-|===
-|To edit the display text of a JLabel:
+To edit the display text of a JLabel:
1. Double-click the JLabel to select its display text.
2. Type ``First Name:`` and press Enter.
@@ -259,12 +227,9 @@
The JLabel's new name is displayed and the component's width adjusts as a result of the edit.
-|===
-
Now we'll add a JTextField so we can get a glimpse of the GUI Builder's baseline alignment feature.
-|===
-|To add a JTextField to the form:
+To add a JTextField to the form:
1. In the Palette window, select the Text Field component from the Swing Controls category.
2. Move the cursor immediately to the right of the ``First Name:`` JLabel we just added. When the horizontal guideline appears indicating that the JTextField's baseline is aligned with that of the JLabel and the spacing between the two components is suggested with a vertical guideline, click to position the JTextField.
@@ -272,16 +237,13 @@
The JTextField snaps into position in the form aligned with the JLabel's baseline, as shown in the following illustration. Notice that the JLabel shifted downward slightly in order to align with the taller text field's baseline. As usual, a node representing the component is added to the Navigator window.
-|===
-
image::images/03_indy_add_1.png[]
Before proceeding further, we need to add an additional JLabel and JTextField immediately to the right of those we just added, as shown in the following illustration. This time enter ``Last Name:`` as the JLabel's display text and leave the JTextFields' placeholder text as it is for now.
image::images/03_indy_add_2.png[]
-|===
-|To resize a JTextField:
+To resize a JTextField:
1. Select the JTextField we just added to the right of the ``Last Name:`` JLabel.
2. Drag the JTextField's right edge resize handle toward the right edge of the enclosing JPanel.
@@ -290,8 +252,6 @@
The JTextField's right edge snaps into alignment with the JPanel's recommended edge margin, as shown in the following illustration.
-|===
-
image::images/03_indy_add_3.png[]
@@ -299,8 +259,7 @@
Now we'll add the ``Title:`` and ``Nickname:`` JLabels that describe two JTextFields that we're going to add in a minute. We'll drag and drop the components while pressing the Shift key, to quickly add them to the form. While accomplishing this, again notice that the GUI Builder displays horizontal and vertical guidelines suggesting the preferred component spacing.
-|===
-|To add multiple JLabels to the form:
+To add multiple JLabels to the form:
1. In the Palette window, select the Label component from the Swing Controls category by clicking and releasing the mouse button.
2. Move the cursor over the form directly below the ``First Name:`` JLabel we added earlier. When the guidelines appear indicating that the new JLabel's left edge is aligned with that of the JLabel above and a small margin exists between them, shift-click to place the first JLabel.
@@ -309,14 +268,11 @@
The JLabels are added to the form creating a second row, as shown in the following illustration. Nodes representing each component are added to the Navigator window.
-|===
-
image::images/04_multi-add_1.png[]
Before moving on, we need to edit the JLabels' name so that we'll be able to see the effect of the alignments we'll set later.
-|===
-|To edit the display text of JLabels:
+To edit the display text of JLabels:
1. Double-click the first JLabel to select its display text.
2. Type ``Title:`` and press Enter.
@@ -325,8 +281,6 @@
The JLabels' new names are displayed in the form and are shifted as a result of their edited widths, as shown in the following illustration.
-|===
-
image::images/04_multi-add_2.png[]
@@ -336,8 +290,7 @@
Often it is necessary to add a component between components that are already placed in a form. Whenever you add a component between two existing components, the GUI Builder automatically shifts them to make room for the new component. To demonstrate this, we'll insert a JTextField between the JLabels we added previously, as shown in the following two illustrations.
-|===
-|To insert a JTextField between two JLabels:
+To insert a JTextField between two JLabels:
1. In the Palette window, select the Text Field component from the Swing Controls category.
2. Move the cursor over the ``Title:`` and ``Nickname:`` JLabels on the second row such that the JTextField overlaps both and is aligned to their baselines. If you encounter difficulty positioning the new text field, you can snap it to the left guideline of the ``Nickname`` JLabel as shown in the first image below.
@@ -346,22 +299,16 @@
The JTextField snaps into position between the two JLabels. The rightmost JLabel shifts toward the right of the JTextField to accommodate the suggested horizontal offset.
-|===
-|===
-|image::images/05_insert_1.png[]
- |
+image::images/05_insert_1.png[]
image::images/05_insert_2.png[]
-
-|===
-
We still need to add one additional JTextField to the form that will display each contact's nickname on the right side of the form.
-|===
-|To add a JTextField:
+
+To add a JTextField:
1. In the Palette window, select the Text Field component from the Swing category.
2. Move the cursor to the right of the ``Nickname`` label and click to place the text field.
@@ -369,40 +316,30 @@
The JTextField snaps into position next to the JLabel on its left.
-|===
-|===
-
-|To resize a JTextField:
+To resize a JTextField:
1. Drag the resize handles of the ``Nickname:`` label's JTextField you added in the previous task toward the right of the enclosing JPanel.
2. When the vertical alignment guidelines appear suggesting the margin between the text field and JPanel edges, release the mouse button to resize the JTextField.
The JTextField's right edge snaps into alignment with the JPanel's recommended edge margin and the GUI Builder infers the appropriate resizing behavior.
-3. Press Ctrl-S to save the file.
-
-|===
-----
-
-<<top,top>>
+[start=3]
+. Press Ctrl-S to save the file.
== Moving Forward
Alignment is one of the most fundamental aspects of creating professional-looking GUIs. In the previous section we got a glimpse of the IDE's alignment features while adding the JLabel and JTextField components to our ContactEditorUI form. Next, we'll take a more in depth look at the GUI Builder's alignment features as we work with the various other components we need for our application.
-[quote]
-----
-
=== Component Alignment
NOTE: Refer to the link:http://bits.netbeans.org/media/quickstart-gui-align.swf[+Aligning and anchoring components (.swf)+] screencast for an interactive demo on the sections below.
Every time you add a component to a form, the GUI Builder effectively aligns them, as evidenced by the alignment guidelines that appear. It is sometimes necessary, however, to specify different relationships between groups of components as well. Earlier we added four JLabels that we need for our ContactEditor GUI, but we didn't align them. Now we'll align the two columns of JLabels so that their right edges line up.
-|===
-|To align components:
+
+To align components:
1. Hold down the ``Ctrl`` key and click to select the ``First Name:`` and ``Title:`` JLabels on the left side of the form.
2. Click the Align Right in Column button (image::images/align_r.png[]) in the toolbar. Alternately, you can right-click either one and choose Align > Right in Column from the pop-up menu.
@@ -411,12 +348,12 @@
The JLabels' positions shift such that the right edges of their display text are aligned. The anchoring relationships are updated, indicating that the components have been grouped.
-|===
+
Before we're finished with the JTextFields we added earlier, we need to make sure that the two JTextFields we inserted between the JLabels are set to resize correctly. Unlike the two JTextFields that we stretched to the right edge of our form, inserted components' resizeability behavior isn't automatically set.
-|===
-|To set component resizeability behavior:
+
+To set component resizeability behavior:
1. Control-click the two inserted JTextField components to select them in the GUI Builder.
2. With both JTextFields selected, right-click either one of them and choose Auto Resizing > Horizontal from the pop-up menu.
@@ -424,10 +361,10 @@
The JTextFields are set to resize horizontally at runtime. The alignment guidelines and anchoring indicators are updated, providing visual feedback of the component relationships.
-|===
-|===
-|To set components to be the same size:
+
+
+To set components to be the same size:
1. Control-click all four of the JTextFields in the form to select them.
2. With the JTextFields selected, right-click any one of them and choose Set Same Size > Same Width from the pop-up menu.
@@ -435,12 +372,12 @@
The JTextFields are all set to the same width and indicators are added to the top edge of each, providing visual feedback of the component relationships.
-|===
+
Now we need to add another JLabel describing the JComboBox that will enable users to select the format of the information our ContactEditor application will display.
-|===
-|To align a JLabel to a component group:
+
+To align a JLabel to a component group:
1. In the Palette window, select the Label component from the Swing category.
2. Move the cursor below the ``First Name`` and ``Title`` JLabels on the left side of the JPanel. When the guideline appears indicating that the new JLabel's right edge is aligned with the right edges of the component group above (the two JLabels), click to position the component.
@@ -448,7 +385,7 @@
The JLabel snaps into a right-aligned position with the column of JLabels above, as shown in the following illustration. The GUI Builder updates the alignment status lines indicating the component's spacing and anchoring relationships.
-|===
+
[.feature]
--
@@ -464,8 +401,8 @@
Now we'll add the combo box that will enable users to select the format of the information that our ContactEditor application will display. As we add the JComboBox, we'll align its baseline to that of the JLabel's text. Notice once again the baseline alignment guidelines that appear to assist us with the positioning.
-|===
-|To align the baselines of components:
+
+To align the baselines of components:
1. In the Palette window, select the Combo Box component from the Swing Controls category.
2. Move the cursor immediately to the right of the JLabel we just added. When the horizontal guideline appears indicating that the JComboBox's baseline is aligned with the baseline of the text in the JLabel and the spacing between the two components is suggested with a vertical guideline, click to position the combo box.
@@ -473,15 +410,15 @@
The component snaps into a position aligned with the baseline of the text in the JLabel to its left, as shown in the following illustration. The GUI Builder displays status lines indicating the component's spacing and anchoring relationships.
-|===
+
[.feature]
--
image::images/06_align_2-small.png[role="left", link="images/06_align_2.png"]
--
-|===
-|To resize the JComboBox:
+
+To resize the JComboBox:
1. Select the ComboBox in the GUI Builder.
2. Drag the resize handle on the JComboBox's right edge toward the right until the alignment guidelines appear suggesting the preferred offset between the JComboBox and JPanel edges.
@@ -493,33 +430,27 @@
image::images/06_align_3-small.png[role="left", link="images/06_align_3.png"]
--
-3. Press Ctrl-S to save the file.
+
+[start=3]
+. Press Ctrl-S to save the file.
-|===
+
Editing component models is beyond the scope of this tutorial, so for the time being we'll leave the JComboBox's placeholder item list as it is.
-----
-
-<<top,top>>
-
-
== Reviewing What We've Learned
We've got off to a good start building our ContactEditor GUI, but let's take a minute to recap what we've learned while we add a few more of the components our interface requires.
Until now we've concentrated on adding components to our ContactEditor GUI using the IDE's alignment guidelines to help us with positioning. It is important to understand, however, that another integral part of component placement is anchoring. Though we haven't discussed it yet, you've already taken advantage of this feature without realizing it. As mentioned previously, whenever you add a component to a form, the IDE suggests the target look and feel's preferred positioning with guidelines. Once placed, new components are also anchored to the nearest container edge or component to ensure that component relationships are maintained at runtime. In this section, we'll concentrate on accomplishing the tasks in a more streamlined fashion while pointing out the work the GUI builder is doing behind the scenes.
-[quote]
-----
-
=== Adding, Aligning, and Anchoring
The GUI Builder enables you to lay out your forms quickly and easily by streamlining typical workflow gestures. Whenever you add a component to a form, the GUI Builder automatically snaps them into the preferred positions and sets the necessary chaining relationships so you can concentrate on designing your forms rather than struggling with complicated implementation details.
-|===
-|To add, align, and edit the display text of a JLabel:
+
+To add, align, and edit the display text of a JLabel:
1. In the Palette window, select the Label component from the Swing Controls category.
2. Move the cursor over the form immediately below the bottom JPanel's E-mail title. When the guidelines appear indicating that it's positioned in the top left corner of the JPanel with a small margin at the top and left edges, click to place the JLabel.
@@ -528,27 +459,29 @@
The JLabel snaps into the preferred position in the form, anchored to the top and left edges of the enclosing JPanel. Just as before, a corresponding node representing the component is added to the Navigator window.
-|===
-|===
-|To add a JTextField:
+
+
+To add a JTextField:
1. In the Palette window, select the Text Field component from the Swing Controls category.
2. Move the cursor immediately to the right of the ``E-mail Address`` label we just added. When the guidelines appear indicating that the JTextField's baseline is aligned with the baseline of the text in the JLabel and the margin between the two components is suggested with a vertical guideline, click to position the text field.
The JTextField snaps into position on the right of the ``E-mail Address:`` JLabel and is chained to the JLabel. Its corresponding node is also added to the Inspector window.
-3. Drag the resize handle of the JTextField toward the right of the enclosing JPanel until the alignment guidelines appear suggesting the offset between the JTextField and JPanel edges.
+
+[start=3]
+. Drag the resize handle of the JTextField toward the right of the enclosing JPanel until the alignment guidelines appear suggesting the offset between the JTextField and JPanel edges.
The JTextField's right edge snaps to the alignment guideline indicating the preferred margins.
-|===
+
Now we need to add the JList that will display our ContactEditor's entire contact list.
-|===
-|To add and resize a JList:
+
+To add and resize a JList:
1. In the Palette window, select the List component from the Swing Controls category.
2. Move the cursor immediately below the ``E-mail Address`` JLabel we added earlier. When the guidelines appear indicating that the JList's top and left edges are aligned with the preferred margins along the JPanel's left edge and the JLabel above, click to position the JList.
@@ -557,7 +490,7 @@
The JList snaps into the position designated by the alignment guidelines and its corresponding node is displayed in the Inspector window. Notice also that the form expands to accommodate the newly added JList.
-|===
+
[.feature]
--
@@ -573,42 +506,43 @@
It is often beneficial to set several related components, such as buttons in modal dialogues, to be the same size for visual consistency. To demonstrate this we'll add four JButtons to our ContactEditor form that will allow us to add, edit, and remove individual entries from our contact list, as shown in the following illustrations. Afterwards, we'll set the four buttons to be the same size so they can be easily recognized as offering related functionality.
-|===
-|To add, align, and edit the display text of multiple buttons:
+
+To add, align, and edit the display text of multiple buttons:
1. In the Palette window, select the Button component from the Swing Controls category.
2. Move the JButton over the right edge of the ``E-mail Address`` JTextField in the lower JPanel. When the guidelines appear indicating that the JButton's baseline and right edge are aligned with that of the JTextField, shift-click to place the first button along the JFrame's right edge. The JTextField's width shrinks to accommodate the JButton when you release the mouse button.
-|===
-|[.feature]
+[.feature]
--
image::images/buttons_1-small.png[role="left", link="images/buttons_1.png"]
--
- |
-
[.feature]
--
image::images/buttons_2-small.png[role="left", link="images/buttons_2.png"]
--
-|===
-3. Move the cursor over the top right corner of the JList in the lower JPanel. When the guidelines appear indicating that the JButton's top and right edges are aligned with that of the JList, shift-click to place the second button along the JFrame's right edge.
+[start=3]
+. Move the cursor over the top right corner of the JList in the lower JPanel. When the guidelines appear indicating that the JButton's top and right edges are aligned with that of the JList, shift-click to place the second button along the JFrame's right edge.
[.feature]
--
image::images/buttons_3-small.png[role="left", link="images/buttons_3.png"]
--
-4. Add two additional JButtons below the two we already added to create a column. Make certain to position the JButtons such that the suggested spacing is respected and consistent. If you forget to release the Shift key prior to positioning the last JButton, simply press the Escape key.
+
+[start=4]
+. Add two additional JButtons below the two we already added to create a column. Make certain to position the JButtons such that the suggested spacing is respected and consistent. If you forget to release the Shift key prior to positioning the last JButton, simply press the Escape key.
[.feature]
--
image::images/buttons_4-small.png[role="left", link="images/buttons_4.png"]
--
-5. Set the display text for each JButton. (You can edit a button's text by right-clicking the button and choosing Edit Text. Or you can click the button, pause, and then click again.) Enter `Add` for the top button, `Edit` for the second, `Remove` for the third, and `As Default` for the fourth.
+
+[start=5]
+. Set the display text for each JButton. (You can edit a button's text by right-clicking the button and choosing Edit Text. Or you can click the button, pause, and then click again.) Enter `Add` for the top button, `Edit` for the second, `Remove` for the third, and `As Default` for the fourth.
The JButton components snap into the positions designated by the alignment guidelines. The width of the buttons changes to accommodate the new names.
@@ -618,12 +552,12 @@
--
-|===
+
Now that the buttons are positioned where we want them, we'll set the four buttons to be the same size for visual consistency as well as to clarify that they are related functionally.
-|===
-|To set components to the same size:
+
+To set components to the same size:
1. Select all four JButtons by pressing the Control key while making your selection.
2. Right-click one of them and choose Same Size > Same Width from the pop-up menu.
@@ -636,7 +570,7 @@
--
-|===
+
=== Indentation
@@ -645,8 +579,8 @@
In this section we'll add a few JRadioButtons below a JLabel that will allow users to customize the way the application displays data. Refer to the following illustrations while accomplishing this or click the View Demo link following the procedure to view an interactive demonstration.
-|===
-|To indent JRadioButtons below a JLabel:
+
+To indent JRadioButtons below a JLabel:
1. Add a JLabel named ``Mail Format`` to the form below the JList. Make certain the label is left aligned with the JList above.
2. In the Palette window, select the Radio Button component from the Swing category.
@@ -657,8 +591,12 @@
image::images/07_indent_1-small.png[role="left", link="images/07_indent_1.png"]
--
-4. Move the cursor to the right of the first JRadioButton. Shift-click to place the second and third JRadioButtons, being careful to respect the suggested component spacing. Make certain to release the Shift key prior to positioning the last JRadioButton.
-5. Set the display text for each JRadioButton. (You can edit a button's text by right-clicking the button and choosing Edit Text. Or you can click the button, pause, and then click again.) Enter `HTML` for the left radio button, `Plain Text ` for the second, and `Custom` for the third.
+
+[start=4]
+. Move the cursor to the right of the first JRadioButton. Shift-click to place the second and third JRadioButtons, being careful to respect the suggested component spacing. Make certain to release the Shift key prior to positioning the last JRadioButton.
+
+[start=5]
+. Set the display text for each JRadioButton. (You can edit a button's text by right-clicking the button and choosing Edit Text. Or you can click the button, pause, and then click again.) Enter `HTML` for the left radio button, `Plain Text ` for the second, and `Custom` for the third.
Three JRadioButtons are added to the form and indented below the ``Mail Format`` JLabel.
@@ -668,12 +606,12 @@
--
-|===
+
Now we need to add the three JRadioButtons to a ButtonGroup to enable the expected toggle behavior in which only one radio button can be selected at a time. This will, in turn, ensure that our ContactEditor application's contact information will be displayed in the mail format of our choosing.
-|===
-|To add JRadioButtons to a ButtonGroup:
+
+To add JRadioButtons to a ButtonGroup:
1. In the Palette window, select the Button Group component from the Swing Controls category.
2. Click anywhere in the GUI Builder design area to add the ButtonGroup component to the form. Notice that the ButtonGroup does not appear in the form itself, however, it is visible in the Navigator's Other Components area.
@@ -687,28 +625,21 @@
image::images/07_group-small.png[role="left", link="images/07_group.png"]
--
-5. Press Ctrl-S to save the file.
+
+[start=5]
+. Press Ctrl-S to save the file.
-|===
-
-----
-
-<<top,top>>
-
== Making the Final Adjustments
We've managed to rough out our ContactEditor application's GUI, but there are still a few things remaining to do. In this section, we'll take a look at a couple of other typical layout tasks that the GUI Builder streamlines.
-[quote]
-----
-
=== Finishing Up
Now we need to add the buttons that will enable users to confirm the information they enter for an individual contact and add it to the contact list or cancel, leaving the database unchanged. In this step, we'll add the two required buttons and then edit them so that they appear the same size in our form even though their display text are different lengths.
-|===
-|To add and edit the display text of buttons:
+
+To add and edit the display text of buttons:
1. If the lower JPanel is extended to the bottom edge of the JFrame form, drag the bottom edge of the JFrame down. This gives you space between the edge of the JFrame and the edge of the JPanel for your OK and Cancel buttons.
2. In the Palette window, select the Button component from the Swing Controls category.
@@ -719,9 +650,15 @@
image::images/08_cancel-small.png[role="left", link="images/08_cancel.png"]
--
-4. Add another JButton to the left of the first, making certain to place it using the suggested spacing along the JFrame's bottom edge.
-5. Set the display text for each JButton. Enter ``OK`` for the left button and ``Cancel`` for right one. Notice that the width of the buttons changes to accommodate the new names.
-6. Set the two JButtons to be the same size by selecting both, right-clicking either, and choosing Same Size > Same Width from the pop-up menu.
+
+[start=4]
+. Add another JButton to the left of the first, making certain to place it using the suggested spacing along the JFrame's bottom edge.
+
+[start=5]
+. Set the display text for each JButton. Enter ``OK`` for the left button and ``Cancel`` for right one. Notice that the width of the buttons changes to accommodate the new names.
+
+[start=6]
+. Set the two JButtons to be the same size by selecting both, right-clicking either, and choosing Same Size > Same Width from the pop-up menu.
[.feature]
--
@@ -730,18 +667,15 @@
The ``JButton`` components appear in the form and their corresponding nodes are displayed in the Navigator window. The ``JButton`` components' code is also added to the form's source file which is visible in the Editor's Source view. Each of the JButtons are set to the same size as the button with the longest name.
-7. Press Ctrl-S to save the file.
+
+[start=7]
+. Press Ctrl-S to save the file.
-|===
+
The last thing we need to do is delete the placeholder text in the various components. Note that while removing placeholder text after roughing out a form can be a helpful technique in avoiding problems with component alignments and anchoring relationships, most developers typically remove this text in the process of laying out their forms. As you go through the form, select and delete the placeholder text for each of the JTextFields. We'll leave the placeholder items in both the JComboBox and JList for a later tutorial.
-----
-
-<<top,top>>
-
-
== Previewing Your GUI
Now that you have successfully built the ContactEditor GUI, you can try your interface to see the results. You can preview your form as you work by clicking the Preview Form button (image::images/test_form.png[]) in the GUI Builder's toolbar. The form opens in its own window, allowing you to test it prior to building and running.
@@ -751,7 +685,7 @@
image::images/08_preview_gui-small.png[role="left", link="images/08_preview_gui.png"]
--
-<<top,top>>
+
== Deploying GUI Applications
@@ -777,21 +711,21 @@
1. Navigate to the project's ``dist`` folder.
2. Type the following:
-[quote]
+
+[source,bash]
----
``java -jar <jar_name>.jar``
----
-----
-
NOTE: If you encounter the following error:
+[source,bash]
----
- ``Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group``
+Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group
----
Ensure that the ``manifest.mf`` file references the currently installed version of the Swing Layout Extensions Library.
-<<top,top>>
+
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ja.asciidoc
index 2103351..324ed15 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ja.asciidoc
@@ -38,7 +38,7 @@
このチュートリアルを完了するのに要する時間は約30分です。
-=== 内容
+== 内容
* <<getting_started,開始>>
* <<project,プロジェクトの作成>>
@@ -67,13 +67,13 @@
*このチュートリアルを完了するには、次のソフトウェアとリソースが必要です。*
-|===
-|ソフトウェアまたはリソース |必須バージョン
-|link:http://netbeans.org/downloads/index.html[+NetBeans IDE+] |バージョン6.9以降
+ソフトウェアまたはリソース必須バージョン
-|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java Development Kit (JDK)+] |バージョン6、7または8
-|===
+link:http://netbeans.org/downloads/index.html[+NetBeans IDE+]バージョン6.9以降
+
+link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java Development Kit (JDK)+]バージョン6、7または8
+
== 開始
@@ -82,15 +82,12 @@
GUIビルダーの視覚的なフィード・バックの詳細は、link:quickstart-gui-legend.html[+GUIビルダーの視覚的なフィード・バックの説明+]を参照してください。
-[quote]
-----
-
=== プロジェクトの作成
IDEでは、プロジェクト内でJava開発をすべて行うので、ソースやその他のプロジェクト・ファイルを保存する ``ContactEditor`` プロジェクトを新規に作成する必要があります。IDEプロジェクトは、Javaソース・ファイルとそれに関連するメタデータのグループで、プロジェクト固有のプロパティ・ファイル、そのビルドと実行を制御するAntビルド・スクリプト、AntターゲットをIDEコマンドにマッピングする ``project.xml`` ファイルが含まれます。Javaアプリケーションは複数のIDEプロジェクトで構成されることがよくありますが、このチュートリアルでは、完全に1つのプロジェクトに収まる単純なアプリケーションを作成します。
-|===
-|新しい ``ContactEditor`` アプリケーションのプロジェクトを作成するには:
+
+新しい ``ContactEditor`` アプリケーションのプロジェクトを作成するには:
1. 「ファイル」>「新規プロジェクト」を選択します。または、IDEツールバーにある「新規プロジェクト」アイコンをクリックして選択することもできます。
2. 「カテゴリ」ペインで「Java」ノードを選択し、「プロジェクト」ペインで「Javaアプリケーション」を選択します。「次」をクリックします。
@@ -102,30 +99,34 @@
システム上の指定した場所に ``ContactEditor`` フォルダが作成されます。このフォルダには、プロジェクトのAntスクリプト、ソースとテストを保持するフォルダ、プロジェクト専用のメタデータ用のフォルダなど、プロジェクトに関連するすべてのファイルとフォルダが含まれます。プロジェクト構造を表示するには、IDEの「ファイル」ウィンドウを使用します。
-|===
+
=== JFrameコンテナの作成
新しいアプリケーションを作成すると、「プロジェクト」ウィンドウの「ソース・パッケージ」フォルダに空の「 ``<デフォルト・パッケージ>`` 」ノードが追加されます。インタフェースのビルドに進むには、他の必要なGUIコンポーネントを入れるJavaコンテナを作成する必要があります。この手順では、 ``JFrame`` コンポーネントを使用してコンテナを作成し、新しいパッケージにそのコンテナを配置します。
-|===
-| ``JFrame`` コンテナを追加するには:
+
+ ``JFrame`` コンテナを追加するには:
1. 「プロジェクト」ウィンドウで「 ``ContactEditor`` 」ノードを右クリックし、「新規」>「JFrameフォーム」を選択します。
または、「新規」>「その他」>「Swing GUIフォーム」>「JFrameフォーム」を選択してJFrameフォームを検索します。
-2. クラス名として「 ``ContactEditorUI`` 」と入力します。
-3. パッケージとして「 ``my.contacteditor`` 」と入力します。
-4. 「終了」をクリックします。
+
+[start=2]
+. クラス名として「 ``ContactEditorUI`` 」と入力します。
+
+[start=3]
+. パッケージとして「 ``my.contacteditor`` 」と入力します。
+
+[start=4]
+. 「終了」をクリックします。
IDEによって、 ``ContactEditorUI.java`` アプリケーション内に ``ContactEditorUI`` フォームと ``ContactEditorUI`` クラスが作成され、 ``ContactEditorUI`` フォームがGUIビルダー内で開きます。デフォルトのパッケージが ``my.contacteditor`` パッケージに置き換わります。
-|===
-----
-<<top,先頭>>
+
== GUIビルダーの操作
@@ -152,16 +153,13 @@
*注意:* 上級開発者は、パレット・マネージャを使用してカスタム・コンポーネントをJAR、ライブラリ、または他のプロジェクトからパレットに追加できます。パレット・マネージャを使用してカスタム・コンポーネントを追加するには、「ツール」>「パレット」>「Swing/AWTコンポーネント」を選択します。
-<<top,先頭>>
+
== 主な概念
IDEのGUIビルダーによって、グラフィカル・インタフェースの作成作業の流れが合理化され、開発者は複雑なSwingレイアウト・マネージャを使用する必要がないので、JavaのGUI作成の主な問題点が解決します。現在のNetBeans IDEのGUIビルダーは、理解しやすく簡単に利用できる単純レイアウト・ルールによって、「フリー・デザイン」方式をサポートするように拡張されました。GUIビルダーでフォームのレイアウトを調整するときは、コンポーネントの最適な間隔や位置揃えを示す視覚的なガイドラインが表示されます。バックグラウンドでは、GUIビルダーによってデザインが機能するUIに変換され、このUIは、新しいGroupLayoutレイアウト・マネージャやその他のSwingの構造を使用して実装されます。動的なレイアウト・モデルが使用されているため、GUIビルダーを使用してビルドしたGUIは、実行時に期待どおりに動作し、変更を加えた場合は、コンポーネント間で定義された関係を変更せずに調整されます。フォームのサイズを変更するか、ロケールを変更するか、異なるルック・アンド・フィールを指定すると、ターゲットのルック・アンド・フィールのインセットとオフセットにあわせてGUIが自動的に調整されます。
-[quote]
-----
-
=== フリー・デザイン
IDEのGUIビルダーでは、絶対位置決め方式を使用しているかのようにコンポーネントを任意の位置に置くことでフォームをビルドできます。GUIビルダーによって必要なレイアウト属性が判別され、自動的にコードが生成されます。インセット、アンカー、塗りつぶしなどを意識する必要はありません。
@@ -177,10 +175,6 @@
また、GUIビルダーは、コンポーネント間のアンカー関係と相互の繋がりを視覚的に表現します。これらのフィード・バックによって、実行時のGUIの表示と動作に影響する様々な配置の関係やコンポーネントの固定の動作を簡単に把握できます。その結果、GUIのデザイン・プロセスに要する期間を短縮でき、正常に機能する高度なビジュアル・インタフェースを短時間で作成できます。
-----
-
-<<top,先頭>>
-
== 作業の開始
@@ -188,8 +182,6 @@
IDEではフリー・デザイン方式が採用されているので、レイアウト・マネージャを使用してコンテナ内のコンポーネントのサイズや位置を制御する必要がありません。この後の各図に示すように、必要なコンポーネントをGUIフォームにドラッグ・アンド・ドロップするのみです。
-[quote]
-----
*注意:* 下の項に関する対話型デモについては、link:http://bits.netbeans.org/media/quickstart-gui-add.swf[+個々のコンポーネントおよび複数のコンポーネントの追加(.swf)+]スクリーンキャストを参照してください。
@@ -199,8 +191,8 @@
フォームの最上位のコンテナとしてJFrameをすでに追加したので、次のステップではJPanelをいくつか追加し、JPanelのタイトル付き境界線を使用してUIのコンポーネントをまとめることができます。この後の各図を参照するとともに、これを行うときのIDEの「ドラッグ・アンド・ドロップ」動作に注目してください。
-|===
-|JPanelを追加するには:
+
+JPanelを追加するには:
1. 「パレット」ウィンドウで、マウス・ボタンをクリックして離すことによって、「Swingコンテナ」カテゴリから「パネル」コンポーネントを選択します。
2. カーソルをGUIビルダー内のフォームの左上隅に移動します。コンポーネントをコンテナの左上隅に近づけると、適切なマージンを示す横方向と縦方向のガイドラインが表示されます。フォーム内をクリックしてこの位置にJPanelを配置します。
@@ -208,7 +200,7 @@
``JPanel`` コンポーネントが、選択されたことを示すオレンジ色の強調表示で ``ContactEditorUI`` フォームに表示されます。マウス・ボタンを離すと、次の図に示すように、コンポーネントのアンカーの関係を示す小さなインジケータが表示され、対応する「JPanel」ノードが「ナビゲータ」ウィンドウに表示されます。
-|===
+
[.feature]
--
@@ -217,8 +209,8 @@
次に、この後で別のコンポーネントを配置する領域を設定するためにJPanelのサイズを変更しますが、その前にGUIビルダーの別の表示機能について説明します。そのためには、追加したJPanelの選択を解除する必要があります。タイトル付き境界線をまだ追加していないので、パネルは表示されなくなります。ただし、JPanelの上にカーソルを置くと、パネルの位置がわかるように輪郭がグレーに変わります。コンポーネント内の任意の場所をクリックするとコンポーネントが再度選択され、サイズ変更のハンドルや、アンカーのインジケータが再度表示されます。
-|===
-|JPanelのサイズを変更するには:
+
+JPanelのサイズを変更するには:
1. 追加したJPanelを選択します。コンポーネントの周囲にサイズ変更のハンドル(小さい四角形)が表示されます。
2. JPanelの右端のサイズ変更のハンドルをクリックし、マウス・ボタンを押したまま、フォームの端の近くに点線のガイドラインが表示されるまでドラッグします。
@@ -227,7 +219,7 @@
次の図に示すように、適切なオフセットに従って、 ``JPanel`` コンポーネントがコンテナの左右のマージンまで広がります。
-|===
+
[.feature]
--
@@ -236,13 +228,13 @@
UIの名前情報を格納するパネルを追加できたので、このプロセスを繰り返して、このパネルの下に電子メール情報用の別のパネルを追加する必要があります。この後の各図を参考にし、GUIビルダーの提案された配置に注意して、前の2つの作業を繰り返します。2つのJPanel間でガイドラインが示す間隔は、左右の端のマージンよりも狭くなっています。2つ目のJPanelを追加したら、フォームの縦方向の残りのスペースが埋まるようにサイズを変更します。
-|===
-|[.feature]
+
+[.feature]
--
image::images/02_add_panels_3-small.png[role="left", link="images/02_add_panels_3.png"]
--
- |
+
[.feature]
--
@@ -251,18 +243,18 @@
-|[.feature]
+[.feature]
--
image::images/02_add_panels_5-small.png[role="left", link="images/02_add_panels_5.png"]
--
-|===
+
GUIの上下2つのセクションの機能を視覚的に区別するために、各JPanelに境界線とタイトルを追加します。まず、「プロパティ」ウィンドウでこの作業を実行し、次にポップアップ・メニューを使用して実行します。
-|===
-|JPanelにタイトル付き境界線を追加するには:
+
+JPanelにタイトル付き境界線を追加するには:
1. GUIビルダーで上のJPanelを選択します。
2. 「プロパティ」ウィンドウで、「border」プロパティの横にある省略符号ボタン(...)をクリックします。
@@ -274,7 +266,7 @@
両方の ``JPanel`` コンポーネントにタイトル付き境界線が追加されます。
-|===
+
[.feature]
--
@@ -286,8 +278,8 @@
連絡先リストで実際の連絡先情報を表示するコンポーネントを追加します。この作業では、連絡先情報を表示するJTextFieldと、これらのフィールドの説明を表示するJLabelをそれぞれ4つ追加します。このとき、オペレーティング・システムのルック・アンド・フィールの定義に従って、適切なコンポーネントの間隔を示す横方向と縦方向のガイドラインがGUIビルダーで表示されます。このガイドラインに従うと、ターゲットのオペレーティング・システムのルック・アンド・フィールにあわせてGUIが実行時に自動的にレンダリングされます。
-|===
-|フォームにJLabelを追加するには:
+
+フォームにJLabelを追加するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「ラベル」コンポーネントを選択します。
2. 先に追加した ``Name`` JPanelの上にカーソルを置きます。JLabelが、上端と左端にマージンを残してJPanelの左上隅にあることを示すガイドラインが表示されたら、クリックしてラベルを配置します。
@@ -295,12 +287,12 @@
JLabelがフォームに追加され、コンポーネントを表すノードが「インスペクタ」ウィンドウに追加されます。
-|===
+
ここで、追加したJLabelの表示テキストを編集します。コンポーネントの表示テキストはいつでも編集できますが、コンポーネントの追加時に編集するのが最も簡単な方法です。
-|===
-|JLabelの表示テキストを編集するには:
+
+JLabelの表示テキストを編集するには:
1. JLabelをダブルクリックして表示テキストを選択します。
2. 「 ``First Name:`` 」と入力して、[Enter]を押します。
@@ -308,12 +300,12 @@
JLabelの新しい名前が表示され、コンポーネントの幅がテキストの長さにあわせて調整されます。
-|===
+
ここで、JTextFieldを追加して、GUIビルダーのベースライン位置揃え機能を確認します。
-|===
-|フォームにJTextFieldを追加するには:
+
+フォームにJTextFieldを追加するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「テキスト・フィールド」コンポーネントを選択します。
2. ``First Name: `` JLabelの右側にカーソルを移動します。JTextFieldのベースラインがJLabelのベースラインとそろっていることを示す横方向のガイドラインが表示され、2つのコンポーネントの適切な間隔を示す縦方向のガイドラインが表示されたら、クリックしてJTextFieldを配置します。
@@ -321,7 +313,7 @@
次の図に示すように、JTextFieldは、フォーム内でベースラインがJLabelのベースラインとそろっている位置にスナップします。テキスト・フィールドのほうが高さがあるので、そのベースラインにあわせてJLabelが少し下に移動します。通常どおり、そのコンポーネントを表すノードが「ナビゲータ」ウィンドウに追加されます。
-|===
+
image::images/03_indy_add_1.png[]
@@ -329,8 +321,8 @@
image::images/03_indy_add_2.png[]
-|===
-|JTextFieldのサイズを変更するには:
+
+JTextFieldのサイズを変更するには:
1. ``Last Name: `` JLabelの右側に追加したJTextFieldを選択します。
2. JTextFieldの右端のサイズ変更のハンドルをJPanelの右端の方向にドラッグします。
@@ -339,7 +331,7 @@
次の図に示すように、JTextFieldの右端が、ガイドラインが示すJPanelの端のマージンにあわせてスナップします。
-|===
+
image::images/03_indy_add_3.png[]
@@ -348,8 +340,8 @@
これから追加する2つのJTextFieldの説明を示す ``Title:`` と ``Nickname:`` の2つのJLabelを追加します。[Shift]キーを押しながらコンポーネントをドラッグ・アンド・ドロップして、すばやくフォームに追加します。このとき、GUIビルダーで、コンポーネント間の適切な間隔を示す横方向と縦方向のガイドラインが表示されます。
-|===
-|フォームに複数のJLabelを追加するには:
+
+フォームに複数のJLabelを追加するには:
1. 「パレット」ウィンドウで、マウス・ボタンをクリックして離すことによって、「Swingコントロール」カテゴリから「ラベル」コンポーネントを選択します。
2. ``First Name: `` JLabelの下にカーソルを移動します。新しいJLabelの左端が上のJLabelの左端とそろっていて、これらのJLabel間に小さなマージンがあることを示すガイドラインが表示されたら、[Shift]を押しながらクリックして最初のJLabelを配置します。
@@ -358,14 +350,14 @@
次の図に示すように、2行目が作成され、JLabelがフォームに追加されます。各コンポーネントを表すノードが「ナビゲータ」ウィンドウに追加されます。
-|===
+
image::images/04_multi-add_1.png[]
ここで、この後で設定する位置揃えの結果を確認できるように、JLabelの名前を編集します。
-|===
-|JLabelの表示テキストを編集するには:
+
+JLabelの表示テキストを編集するには:
1. 最初のJLabelをダブルクリックして表示テキストを選択します。
2. 「 ``Title:`` 」と入力して、[Enter]を押します。
@@ -374,7 +366,7 @@
次の図に示すように、JLabelの新しい名前がフォームに表示され、編集後の長さにあわせてJLabelの位置が調整されます。
-|===
+
image::images/04_multi-add_2.png[]
@@ -385,8 +377,8 @@
フォーム内にすでに配置されているコンポーネントの間にコンポーネントを追加する必要がある場合があります。2つの既存のコンポーネントの間にコンポーネントを追加すると、GUIビルダーではその新しいコンポーネント用の領域を確保するために、既存のコンポーネントが自動的に移動します。この処理を確認するため、この後の2つの図に示すように、追加したJLabelの間にJTextFieldを挿入します。
-|===
-|2つのJLabelの間にJTextFieldを挿入するには:
+
+2つのJLabelの間にJTextFieldを挿入するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「テキスト・フィールド」コンポーネントを選択します。
2. JTextFieldが2行目の ``Title:`` と ``Nickname:`` の各JLabelと重なり、ベースラインがそろうようにカーソルを移動します。新しいテキスト・フィールドの位置決めをできない場合は、次の最初のイメージに示すように ``Nickname`` JLabelの左側のガイドラインにスナップしてもかまいません。
@@ -395,22 +387,22 @@
JTextFieldが2つのJLabelの間にスナップします。ガイドラインが示す横方向のオフセットに従って、右側にあるJLabelがJTextFieldの右に移動します。
-|===
-|===
-|image::images/05_insert_1.png[]
- |
+
+image::images/05_insert_1.png[]
+
+
image::images/05_insert_2.png[]
-|===
+
ここで、各連絡先の通称を表示するJTextFieldをフォームの右側に追加します。
-|===
-|JTextFieldを追加するには:
+
+JTextFieldを追加するには:
1. 「パレット」ウィンドウで、「Swing」カテゴリから「テキスト・フィールド」コンポーネントを選択します。
2. カーソルを ``Nickname`` ラベルの右側に移動し、クリックしてテキスト・フィールドを配置します。
@@ -418,40 +410,35 @@
JTextFieldがJLabelの右側にスナップします。
-|===
-|===
-|JTextFieldのサイズを変更するには:
+
+
+JTextFieldのサイズを変更するには:
1. 前のタスクで追加した ``Nickname: `` ラベルのJTextFieldのサイズ変更のハンドルをJPanelの右端の方向にドラッグします。
2. テキスト・フィールドとJPanelの端の間の適切なマージンを示す縦方向のガイドラインが表示されたら、マウス・ボタンを離してJTextFieldのサイズを変更します。
JTextFieldの右端が、ガイドラインが示すJPanelの端のマージンにあわせてスナップし、GUIビルダーで適切なサイズ変更の動作が表示されます。
-3. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=3]
+. [Ctrl]-[S]を押して、ファイルを保存します。
-|===
-----
-
-<<top,先頭>>
== 次の作業
位置揃えは、高度なGUIを作成するための最も基本的な方法です。前の項では、JLabelコンポーネントとJTextFieldコンポーネントをContactEditorUIフォームに追加するときにIDEの位置揃え機能を確認しました。ここでは、アプリケーションに必要な他のコンポーネントを操作しながら、GUIビルダーの位置揃え機能を詳しく見ていきます。
-[quote]
-----
-
=== コンポーネントの位置揃え
*注意:* 下の項に関する対話型デモについては、link:http://bits.netbeans.org/media/quickstart-gui-align.swf[+コンポーネントの位置揃えおよびアンカー設定(.swf)+]スクリーンキャストを参照してください。
コンポーネントをフォームに追加すると、表示されるガイドラインが示すように、GUIビルダーによって効果的にコンポーネントの位置揃えが実行されます。ただし、複数のコンポーネント間で異なる関係を指定する必要がある場合もあります。すでに、ContactEditorのGUIに必要なJLabelを4つ追加しましたが、位置揃えは実行しませんでした。ここでは、JLabelが縦2列に並ぶようにJLabelの右端をそろえます。
-|===
-|コンポーネントの位置揃えを行うには:
+
+コンポーネントの位置揃えを行うには:
1. ``[Ctrl]`` キーを押したままクリックして、フォーム左側の ``First Name:`` および ``Title:`` のJLabelを選択します。
2. ツールバーの「列内で右揃え」ボタン(image::images/align_r.png[])をクリックします。または、いずれか1つを右クリックし、ポップアップ・メニューから「位置揃え」>「列の右」を選択することもできます。
@@ -460,12 +447,12 @@
各JLabelの表示テキストの右端がそろうように、JLabelの位置が調整されます。アンカーの関係が更新され、コンポーネントがグループ化されたことを示します。
-|===
+
追加したJTextFieldの操作を終了する前に、JLabelの間に挿入した2つのJTextFieldが正しくサイズ変更されるように設定されていることを確認します。フォームの右端まで拡張した2つのJTextFieldとは異なり、挿入したコンポーネントのサイズ変更の動作は自動的に設定されません。
-|===
-|コンポーネントのサイズ変更の動作を設定するには:
+
+コンポーネントのサイズ変更の動作を設定するには:
1. GUIビルダーで、挿入した2つのJTextFieldコンポーネントを[Ctrl]を押しながらクリックし、選択します。
2. 両方のJTextFieldを選択した状態で、いずれか一方を右クリックし、ポップアップ・メニューから「自動サイズ変更」>「水平」を選択します。
@@ -473,10 +460,10 @@
JTextFieldは実行時に水平方向にサイズ変更するように設定されます。ガイドラインとアンカーのインジケータが更新され、コンポーネントの関係を視覚的なフィード・バックで示します。
-|===
-|===
-|コンポーネントを同じサイズにするには:
+
+
+コンポーネントを同じサイズにするには:
1. フォーム内の4つのJTextFieldをすべて[Ctrl]を押しながらクリックして選択します。
2. JTextFieldが選択された状態で、いずれか1つを右クリックし、ポップアップ・メニューから「同じサイズを設定」>「同じ幅」を選択します。
@@ -484,12 +471,12 @@
JTextFieldがすべて同じ幅に設定され、コンポーネントの関係を視覚的なフィード・バックで示すインジケータが各JTextFieldの上端に追加されます。
-|===
+
ここで、JComboBoxを説明する別のJLabelを追加します。JComboBoxは、ContactEditorアプリケーションに表示する情報の形式をユーザーが選択できます。
-|===
-|JLabelとコンポーネント・グループの位置揃えを実行するには:
+
+JLabelとコンポーネント・グループの位置揃えを実行するには:
1. 「パレット」ウィンドウで、「Swing」カテゴリから「ラベル」コンポーネントを選択します。
2. JPanelの左側の ``First Name:`` と ``Title:`` の各JLabelの下にカーソルを移動します。新しいJLabelの右端が、その上にあるコンポーネント・グループ(2つのJLabel)の右端とそろっていることを示すガイドラインが表示されたら、クリックしてコンポーネントを配置します。
@@ -497,7 +484,7 @@
次の図に示すように、JLabelの右端が、上にあるJLabelの列の右端とそろっている位置にスナップします。GUIビルダーでは、コンポーネントの間隔とアンカーの関係を示す位置揃えの状態線が更新されます。
-|===
+
[.feature]
--
@@ -513,8 +500,8 @@
ここで、ContactEditorアプリケーションに表示する情報の形式をユーザーが選択できるコンボ・ボックスを追加します。JComboBoxを追加するとき、そのベースラインをJLabelのテキストのベースラインにそろえます。このとき、位置決めに使用できるベースラインのガイドラインが表示されます。
-|===
-|コンポーネントのベースラインの位置揃えを実行するには:
+
+コンポーネントのベースラインの位置揃えを実行するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「コンボ・ボックス」コンポーネントを選択します。
2. 追加したJLabelの右側にカーソルを移動します。JComboBoxのベースラインがJLabelのテキストのベースラインとそろっていることを示す横方向のガイドラインが表示され、2つのコンポーネントの適切な間隔を示す縦方向のガイドラインが表示されたら、クリックしてコンボ・ボックスを配置します。
@@ -522,15 +509,15 @@
次の図に示すように、コンポーネントは、ベースラインが、左側にあるJLabel内のテキストのベースラインとそろっている位置にスナップします。GUIビルダーに、コンポーネントの間隔とアンカーの関係を示す状態線が表示されます。
-|===
+
[.feature]
--
image::images/06_align_2-small.png[role="left", link="images/06_align_2.png"]
--
-|===
-|JComboBoxのサイズを変更するには:
+
+JComboBoxのサイズを変更するには:
1. GUIビルダーでコンボ・ボックスを選択します。
2. JComboBoxとJPanelの間のオフセットを示すガイドラインが表示されるまで、JComboBoxの右端にあるサイズ変更のハンドルを右方向にドラッグします。
@@ -542,17 +529,15 @@
image::images/06_align_3-small.png[role="left", link="images/06_align_3.png"]
--
-3. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=3]
+. [Ctrl]-[S]を押して、ファイルを保存します。
-|===
+
コンポーネント・モデルの編集については、このチュートリアルで説明しないので、JComboBoxのプレースホルダの項目リストはそのままにします。
-----
-
-<<top,先頭>>
-
== 学習した内容の復習
@@ -560,15 +545,13 @@
これまでは、IDEのガイドラインを使用して、ContactEditorのGUIにコンポーネントを追加してきました。しかし、コンポーネントの配置には、アンカーも重要です。アンカーについてはまだ説明していませんが、意識せずにこの機能をすでに利用しています。前述したように、コンポーネントをフォームに追加すると、IDEではターゲットのルック・アンド・フィールに適切な配置を示すガイドラインが表示されます。新しいコンポーネントを配置すると、このコンポーネントは、コンポーネント間の関係が実行時に維持されるように、最も近いコンテナの端またはコンポーネントにアンカーで固定されます。この項では、GUIビルダーによってバックグラウンドで実行される処理を確認しながら、作業をより合理的に行う方法について説明します。
-[quote]
-----
=== 追加、位置揃え、アンカー
GUIビルダーを使用すると、一般的なワークフローを合理化し、短時間で簡単にフォームのレイアウトを調整できます。コンポーネントをフォームに追加すると、GUIビルダーで適切な位置にコンポーネントが自動的にスナップされ、必要なチェーン関係が設定されるため、複雑な実装の詳細を操作せずに、フォームのデザインに専念できます。
-|===
-|JLabelの表示テキストの追加、位置揃え、および編集を実行するには:
+
+JLabelの表示テキストの追加、位置揃え、および編集を実行するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「ラベル」コンポーネントを選択します。
2. フォーム内の一番下のJPanelの「E-mail」タイトルの下にカーソルを移動します。JLabelが、上端と左端にマージンを残してJPanelの左上隅にあることを示すガイドラインが表示されたら、クリックしてJLabelを配置します。
@@ -577,27 +560,29 @@
JLabelが、フォーム内の適切な位置にスナップし、JPanelの上端と左端にアンカーで固定されます。前と同じように、そのコンポーネントを表す対応するノードが「ナビゲータ」ウィンドウに追加されます。
-|===
-|===
-|JTextFieldを追加するには:
+
+
+JTextFieldを追加するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「テキスト・フィールド」コンポーネントを選択します。
2. 追加した ``E-mail Address`` ラベルの右側にカーソルを移動します。JTextFieldのベースラインがJLabelのテキストのベースラインとそろっていることを示すガイドラインが表示され、2つのコンポーネントの適切なマージンを示す縦方向のガイドラインが表示されたら、クリックしてテキスト・フィールドを配置します。
JTextFieldが ``E-mail Address: `` JLabelの右側にスナップし、JLabelに関連付けられます。対応するノードが「インスペクタ」ウィンドウに追加されます。
-3. JTextFieldとJPanelの間の適切なオフセットを示すガイドラインが表示されるまで、JTextFieldの右端にあるサイズ変更のハンドルをJPanelの右端の方向にドラッグします。
+
+[start=3]
+. JTextFieldとJPanelの間の適切なオフセットを示すガイドラインが表示されるまで、JTextFieldの右端にあるサイズ変更のハンドルをJPanelの右端の方向にドラッグします。
JTextFieldの右端が、適切なマージンを示すガイドラインにスナップします。
-|===
+
ここで、ContactEditorの連絡先リスト全体を表示するJListを追加します。
-|===
-|JListを追加してサイズを変更するには:
+
+JListを追加してサイズを変更するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「リスト」コンポーネントを選択します。
2. 前の手順で追加した ``E-mail Address`` JLabelの下にカーソルを移動します。JListの上端と左端に、JPanelの左端と上のJLabelとの間の適切なマージンとそろっていることを示すガイドラインが表示されたら、クリックしてJListを配置します。
@@ -606,7 +591,7 @@
JListは、ガイドラインが示す位置にスナップし、対応するノードが「インスペクタ」ウィンドウに表示されます。また、新しく追加したJListが入るようにフォームが拡張されます。
-|===
+
[.feature]
--
@@ -622,19 +607,19 @@
モーダル・ダイアログ内のボタンなど、複数の関連するコンポーネントを同じサイズにすると、視覚的な一貫性を保つことができます。このことを示すため、この後の各図に示すように、連絡先リストの各エントリを追加、編集、および除去できる4つのJButtonをContactEditorフォームに追加します。その後、4つのボタンを同じサイズにして、これらのボタンが関連する機能を提供することがすぐにわかるようにします。
-|===
-|複数のボタンの表示テキストの追加、位置揃え、および編集を実行するには:
+
+複数のボタンの表示テキストの追加、位置揃え、および編集を実行するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「ボタン」コンポーネントを選択します。
2. 下のJPanelでJButtonを ``E-mail Address`` JTextFieldの右端に移動します。JButtonのベースラインと右端が、JTextFieldのベースラインと右端とそろっていることを示すガイドラインが表示されたら、[Shift]を押しながらクリックし、最初のボタンをJFrameの右端に沿って配置します。マウス・ボタンを離すと、JButtonが入るようにJTextFieldの幅が小さくなります。
-|===
-|[.feature]
+
+[.feature]
--
image::images/buttons_1-small.png[role="left", link="images/buttons_1.png"]
--
- |
+
[.feature]
--
@@ -642,22 +627,26 @@
--
-|===
-3. 下のJPanel内のJListの右上隅にカーソルを移動します。JButtonの上端と右端が、JListの上端と右端とそろっていることを示すガイドラインが表示されたら、[Shift]を押しながらクリックし、2つ目のボタンをJFrameの右端に沿って配置します。
+[start=3]
+. 下のJPanel内のJListの右上隅にカーソルを移動します。JButtonの上端と右端が、JListの上端と右端とそろっていることを示すガイドラインが表示されたら、[Shift]を押しながらクリックし、2つ目のボタンをJFrameの右端に沿って配置します。
[.feature]
--
image::images/buttons_3-small.png[role="left", link="images/buttons_3.png"]
--
-4. 追加した2つのボタンの下にさらにJButtonを2つ縦に追加します。これらのJButtonは、ガイドラインに従い、間隔が同じになるように配置します。最後のJButtonを配置する前に[Shift]キーを離さなかった場合は、[Esc]キーを押します。
+
+[start=4]
+. 追加した2つのボタンの下にさらにJButtonを2つ縦に追加します。これらのJButtonは、ガイドラインに従い、間隔が同じになるように配置します。最後のJButtonを配置する前に[Shift]キーを離さなかった場合は、[Esc]キーを押します。
[.feature]
--
image::images/buttons_4-small.png[role="left", link="images/buttons_4.png"]
--
-5. 各JButtonの表示テキストを設定します。(ボタンのテキストを編集するには、ボタンを右クリックして「テキストを編集」を選択します。または、ボタンをクリックし、しばらくしてからもう一度クリックすることもできます。)一番上のボタンは「`Add`」、2つ目のボタンは「`Edit`」、3つ目のボタンは「`Remove`」、4つ目のボタンは「`As Default`」にします。
+
+[start=5]
+. 各JButtonの表示テキストを設定します。(ボタンのテキストを編集するには、ボタンを右クリックして「テキストを編集」を選択します。または、ボタンをクリックし、しばらくしてからもう一度クリックすることもできます。)一番上のボタンは「`Add`」、2つ目のボタンは「`Edit`」、3つ目のボタンは「`Remove`」、4つ目のボタンは「`As Default`」にします。
JButtonコンポーネントはガイドラインが示す位置にスナップします。名前の長さにあわせてボタンの幅が変わります。
@@ -667,12 +656,12 @@
--
-|===
+
ボタンを配置したら、これらのボタンが関連する機能であることを明確にするため、また視覚的な一貫性を保つために、4つのボタンを同じサイズにします。
-|===
-|コンポーネントを同じサイズにするには:
+
+コンポーネントを同じサイズにするには:
1. [Ctrl]キーを押しながらJButtonを選択し、4つすべてのJButtonを選択します。
2. いずれか1つを右クリックし、ポップアップ・メニューから「同じサイズ」>「同じ幅」を選択します。
@@ -685,7 +674,7 @@
--
-|===
+
=== インデント設定
@@ -694,8 +683,8 @@
この項では、ユーザーがアプリケーションでデータを表示する方法をカスタマイズできる複数のJRadioButtonをJLabelの下に追加します。作業を行うときには、この後の各図を参照してください。また、手順の後の「デモを表示」のリンクをクリックすると、対話型デモが表示されます。
-|===
-|JLabelの下のJRadioButtonのインデントを設定するには:
+
+JLabelの下のJRadioButtonのインデントを設定するには:
1. フォームのJListの下に ``Mail Format`` というJLabelを追加します。ラベルは左端を上にあるJListの左端にそろえます。
2. 「パレット」ウィンドウで、「Swing」カテゴリから「ラジオ・ボタン」コンポーネントを選択します。
@@ -706,8 +695,12 @@
image::images/07_indent_1-small.png[role="left", link="images/07_indent_1.png"]
--
-4. カーソルを最初のJRadioButtonの右側に移動します。[Shift]を押しながらクリックして、2つ目と3つ目のJRadioButtonを配置します(このとき、提示されたコンポーネントの間隔に従います)。[Shift]キーは、最後のJRadioButtonを配置する前に離します。
-5. 各JRadioButtonの表示テキストを設定します。(ボタンのテキストを編集するには、ボタンを右クリックして「テキストを編集」を選択します。または、ボタンをクリックし、しばらくしてからもう一度クリックすることもできます。)左端のラジオ・ボタンは「`HTML`」、2つ目のラジオ・ボタンは「`Plain Text`」、3つ目のラジオ・ボタンは「`Custom`」にします。
+
+[start=4]
+. カーソルを最初のJRadioButtonの右側に移動します。[Shift]を押しながらクリックして、2つ目と3つ目のJRadioButtonを配置します(このとき、提示されたコンポーネントの間隔に従います)。[Shift]キーは、最後のJRadioButtonを配置する前に離します。
+
+[start=5]
+. 各JRadioButtonの表示テキストを設定します。(ボタンのテキストを編集するには、ボタンを右クリックして「テキストを編集」を選択します。または、ボタンをクリックし、しばらくしてからもう一度クリックすることもできます。)左端のラジオ・ボタンは「`HTML`」、2つ目のラジオ・ボタンは「`Plain Text`」、3つ目のラジオ・ボタンは「`Custom`」にします。
3つのJRadioButtonがフォームに追加され、 ``Mail Format`` JLabelの下でインデントが設定されます。
@@ -717,12 +710,12 @@
--
-|===
+
ここで、3つのJRadioButtonをButtonGroupに追加し、一度に1つのラジオ・ボタンのみを選択できる切替えの動作を有効にします。これにより、ContactEditorアプリケーションの連絡先情報が、順番に選択したメール形式で表示されます。
-|===
-|JRadioButtonをButtonGroupに追加するには:
+
+JRadioButtonをButtonGroupに追加するには:
1. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「ボタン・グループ」コンポーネントを選択します。
2. GUIビルダーのデザイン領域内の任意の場所をクリックし、ButtonGroupコンポーネントをフォームに追加します。ButtonGroupはフォーム自体には表示されませんが、ナビゲータの「他のコンポーネント」領域に表示されることに注意してください。
@@ -736,28 +729,24 @@
image::images/07_group-small.png[role="left", link="images/07_group.png"]
--
-5. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=5]
+. [Ctrl]-[S]を押して、ファイルを保存します。
-|===
-----
-
-<<top,先頭>>
== 最後の調整
ContactEditorアプリケーションの大まかなGUIが完成しましたが、まだ必要な作業が残っています。この項では、GUIビルダーによって合理化される他の一般的なレイアウト作業を確認します。
-[quote]
-----
=== 仕上げ
ユーザーが、入力した連絡先情報を確定して連絡先リストに追加するか、入力を取り消してデータベースの変更を中止できるボタンを追加します。この手順では、2つの必要なボタンを追加した後、表示テキストの長さが違ってもボタンのサイズが同じになるように編集します。
-|===
-|ボタンの表示テキストを追加および編集するには:
+
+ボタンの表示テキストを追加および編集するには:
1. 下のJPanelが、JFrameフォームの下端まで拡張されている場合は、JFrameの下端を下にドラッグします。これで、JFrameの端とJPanelの端の間に「OK」ボタンと「Cancel」ボタン用のスペースができます。
2. 「パレット」ウィンドウで、「Swingコントロール」カテゴリから「ボタン」コンポーネントを選択します。
@@ -768,9 +757,15 @@
image::images/08_cancel-small.png[role="left", link="images/08_cancel.png"]
--
-4. 別のJButtonを最初のJButtonの左側に追加します。このとき、JFrameの下端に沿ってガイドラインが示す間隔で配置します。
-5. 各JButtonの表示テキストを設定します。左側のボタンには「 ``OK`` 」、右側のボタンには「 ``Cancel`` 」と入力します。名前の長さにあわせてボタンの幅が変わります。
-6. 両方のJButtonを選択し、いずれか一方を右クリックし、ポップアップ・メニューから「同じサイズ」>「同じ幅」を選択することで2つのボタンを同じサイズにします。
+
+[start=4]
+. 別のJButtonを最初のJButtonの左側に追加します。このとき、JFrameの下端に沿ってガイドラインが示す間隔で配置します。
+
+[start=5]
+. 各JButtonの表示テキストを設定します。左側のボタンには「 ``OK`` 」、右側のボタンには「 ``Cancel`` 」と入力します。名前の長さにあわせてボタンの幅が変わります。
+
+[start=6]
+. 両方のJButtonを選択し、いずれか一方を右クリックし、ポップアップ・メニューから「同じサイズ」>「同じ幅」を選択することで2つのボタンを同じサイズにします。
[.feature]
--
@@ -779,17 +774,15 @@
``JButton`` コンポーネントがフォームに表示され、それに対応するノードが「ナビゲータ」ウィンドウに表示されます。 ``JButton`` コンポーネントのコードがフォームのソース・ファイルに追加されます。このコードは、エディタのソース・ビューで確認できます。各JButtonが、最も長い名前のボタンと同じサイズになります。
-7. [Ctrl]-[S]を押して、ファイルを保存します。
+
+[start=7]
+. [Ctrl]-[S]を押して、ファイルを保存します。
-|===
+
最後に、各コンポーネントのプレースホルダのテキストを削除します。フォームの大まかなレイアウトが完成した後にプレースホルダのテキストを除去すると、コンポーネントの位置揃えやアンカーの関係の問題を避けることができますが、ほとんどの開発者はコンポーネントを配置しながらこのテキストを除去します。フォーム内で各JTextFieldのプレースホルダのテキストを選択し、削除します。JComboBoxとJListのプレースホルダの項目は、別のチュートリアルで使用するので残しておきます。
-----
-
-<<top,先頭>>
-
== GUIのプレビュー
@@ -800,7 +793,7 @@
image::images/08_preview_gui-small.png[role="left", link="images/08_preview_gui.png"]
--
-<<top,先頭>>
+
== GUIアプリケーションのデプロイ
@@ -812,8 +805,6 @@
JDK 6でIDEを実行している場合は、Java SE 6のGroupLayoutクラスを使用するように、アプリケーション・コードが生成されます。これは、インストールされているJava SE 6を使用してシステムを実行するようにアプリケーションをデプロイでき、Swingレイアウト拡張ライブラリを使用してアプリケーションをパッケージ化する必要がないことを意味します。
*注意:* JDK 6を使用してアプリケーションを作成するが、そのアプリケーションをJava SE 5でも実行する必要がある場合、Java SE 6のクラスでなく、Swingレイアウト拡張ライブラリを使用するようにコードを生成することができます。GUIエディタでContactEditorUIを開きます。ナビゲータで、フォームの「ContactEditorUI」ノードを右クリックし、ポップアップ・メニューで「プロパティ」を選択します。「プロパティ」ダイアログ・ボックスで、「レイアウト生成スタイル」プロパティの値を「Swingレイアウト拡張統合」に変更します。
-[quote]
-----
=== スタンドアロンのGUIアプリケーションの配布と実行
@@ -828,23 +819,22 @@
1. プロジェクトの ``dist`` フォルダまで移動します。
2. 次を入力します。
-[quote]
-----
- ``java -jar <jar_name>.jar``
-----
+[source, java]
+----
+java -jar <jar_name>.jar
----
*注意:* 次のエラーが発生する場合があります。
-[quote]
+[source,bash]
----
- ``Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group``
+Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group
----
- ``manifest.mf`` ファイルで、現在インストールされているバージョンのSwingレイアウト拡張ライブラリが指定されていることを確認してください。
+``manifest.mf`` ファイルで、現在インストールされているバージョンのSwingレイアウト拡張ライブラリが指定されていることを確認してください。
-<<top,先頭>>
+
link:/about/contact_form.html?to=3&subject=Feedback:%20Designing%20a%20Swing%20GUI%20in%20NetBeans%20IDE[+このチュートリアルに関するご意見をお寄せください+]
@@ -860,5 +850,5 @@
* link:../../trails/matisse.html[+Java GUIアプリケーションの学習+]
* _NetBeans IDEによるアプリケーションの開発_のlink:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG920[+Java GUIの実装+]
-<<top,先頭>>
+
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_pt_BR.asciidoc
index 214b64d..7eaff97 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_pt_BR.asciidoc
@@ -42,13 +42,13 @@
*Para concluir este tutorial, você precisa dos seguintes recursos e softwares.*
-|===
-|Software ou Recurso |Versão Necessária
-|link:http://netbeans.org/downloads/index.html[+NetBeans IDE+] |versão 6.9 e mais recente
+Software ou RecursoVersão Necessária
-|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+JDK (Java Development Kit)+] |versão 6, 7 ou 8
-|===
+link:http://netbeans.org/downloads/index.html[+NetBeans IDE+]versão 6.9 e mais recente
+
+link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+JDK (Java Development Kit)+]versão 6, 7 ou 8
+
== Introdução
@@ -57,15 +57,12 @@
Para obter descrições sobre o feedback visual do GUI Builder, é possível utilizar a link:quickstart-gui-legend.html[+Legenda de Feedback Visual do GUI Builder+].
-[quote]
-----
-
=== Criando um Projeto
Como todo o desenvolvimento em Java no IDE ocorre dentro dos projetos, precisamos primeiro criar um projeto ``ContactEditor`` para armazenar os códigos-fonte e outros arquivos do projeto. Um projeto do IDE é um grupo de arquivos de códigos-fonte Java e metadados associados que inclui arquivos de propriedades específicos do projeto, um script de construção Ant que controla as definições de construção e execução e um arquivo ``project.xml`` , que mapeia destinos de Ant para comandos do IDE. Embora as aplicações Java geralmente consistam em vários projetos do IDE, para o objetivo deste tutorial, construiremos uma aplicação simples, inteiramente armazenada em um único projeto.
-|===
-|Para criar um novo projeto de aplicação ``ContactEditor`` :
+
+Para criar um novo projeto de aplicação ``ContactEditor`` :
1. Escolha Arquivo > Novo Projeto. Se preferir, é possível clicar no ícone Novo Projeto na barra de ferramentas do IDE.
2. No painel Categorias, selecione o nó Java e no painel Projetos, escolha Aplicação Java. Clique em Próximo.
@@ -77,30 +74,31 @@
O IDE criará a pasta ``ContactEditor`` no sistema no local designado. Essa pasta contém todos os arquivos associados do projeto, como o script Ant, pastas para armazenamento de códigos-fontes e testes e uma pasta para os metadados específicos do projeto. Para exibir a estrutura do projeto, utilize a janela Arquivos do IDE.
-|===
+
=== Criando um Contêiner JFrame
Após criar a nova aplicação, você pode ter percebido que a pasta Pacotes de Códigos-fonte na janela Projetos contém um nó ``<pacote default>`` vazio. Para prosseguir com a construção da nossa interface, precisamos criar um contêiner Java no qual colocaremos os outros componentes requeridos da GUI. Nessa etapa, criaremos um contêiner utilizando o componente ``JFrame`` e o colocaremos em um novo pacote.
-|===
-|Para adicionar um contêiner ``JFrame`` :
+
+Para adicionar um contêiner ``JFrame`` :
1. na janela Projetos, clique com o botão direito do mouse no nó ``ContactEditor`` e selecione Novo > Form JFrame.
Outra opção é localizar um form JFrame escolhendo Novo > Outro > Forms da GUI Swing > Form JFrame.
-2. Insira ``ContactEditorUI`` como Nome da Classe.
-3. Insira ``my.contacteditor`` como o pacote.
-4. Clique em Finalizar.
+
+[start=2]
+. Insira ``ContactEditorUI`` como Nome da Classe.
+
+[start=3]
+. Insira ``my.contacteditor`` como o pacote.
+
+[start=4]
+. Clique em Finalizar.
O IDE criará o form ``ContactEditorUI`` e a classe ``ContactEditorUI`` na aplicação ``ContactEditorUI.java`` e abrirá o form ``ContactEditorUI`` no GUI Builder. Observe que o pacote ``my.contacteditor`` substitui o pacote default.
-|===
-
-----
-
-<<top,início>>
== Familiarizando-se com o GUI Builder
@@ -127,16 +125,13 @@
*Observação:* para os desenvolvedores avançados, está disponível o Gerenciador de Paleta, que ativa adicionar componentes personalizados de JARs, bibliotecas ou projetos à Paleta. Para adicionar componentes personalizados por meio do Gerenciador de Paleta, escolha Ferramentas > Paleta > Componentes Swing/AWT.
-<<top,início>>
+
== Conceitos-Chave
O GUI Builder do IDE resolve o problema central da criação de GUIs do Java otimizando o fluxo de dados da criação de interfaces gráficas, liberando os desenvolvedores das complexidades dos gerenciadores de layout do Swing. Ele faz isso estendendo o GUI Builder atual do NetBeans IDE para dar suporte ao paradigma "Design Livre" com regras simples de layout, fáceis de compreender e utilizar. À medida que você faz o layout do form, o GUI Builder fornece linhas-guias visuais sugerindo o espaçamento e alinhamento ideais dos componentes. Em segundo plano, o GUI Builder converte as decisões de design em uma UI funcional, que é implementada com o uso de um gerenciador de layouts GroupLayout e outras construções do Swing. Como ele utiliza um modelo de layout dinâmico, as GUIs construídas com o GUI Builder se comportam como o esperado em runtime, ajustando para acomodar as alterações feitas sem alterar os relacionamentos definidos entre os componentes. Quando você redimensionar o form, alterar configurações regionais ou especificar outra aparência, a GUI se ajustará automaticamente para respeitar a aparência do destino e os suplementos e deslocamentos da funcionalidade.
-[quote]
-----
-
=== Design Livre
No GUI Builder do IDE, é possível construir forms simplesmente colocando os componentes onde quiser, como se estivesse utilizando posicionamento absoluto. O GUI Builder descobre quais atributos de layout são obrigatórios e gera o código automaticamente. Você não precisa se preocupar com suplementos, âncoras, preenchimentos, etc.
@@ -152,19 +147,12 @@
O GUI Builder também oferece feedback visual sobre as relações de ancoragem e encadeamento de componentes. Esses indicadores permitem identificar rapidamente as várias relações de posicionamento e o comportamento fixo dos componentes que afetam a maneira como a GUI aparecerá e se comportará em runtime. Isso acelera o processo de design de GUI, permitindo que você crie rapidamente interfaces visuais com aspecto profissional e que funcionam.
-----
-
-<<top,início>>
-
-
== Primeiro o Principal
Agora que você está familiarizado com a interface do GUI Builder, este é o momento para começar a desenvolver a UI da nossa aplicação ContactEditor. Nesta seção, veremos a utilização da Paleta do IDE para adicionar os vários componentes GUI necessários ao nosso form.
Graças ao paradigma Design Livre do IDE, não é necessário entrar em conflito com os gerenciadores de layout para controlar o tamanho e posição dos componentes nos contêineres. Tudo o que você precisa fazer é arrastar e soltar os componentes necessários no form da GUI conforme exibido nas ilustrações abaixo.
-[quote]
-----
*Observação:* Consulte o screencast link:http://bits.netbeans.org/media/quickstart-gui-add.swf[+Adicionando componentes individuais e múltiplos componentes (.swf)+] para ver uma demonstração interativa na seção abaixo.
@@ -174,8 +162,8 @@
Como já adicionamos um JFrame como contêiner de nível superior do form, a próxima etapa é adicionar dois JPanels que nos permitirão unir os componentes da nossa UI utilizando bordas com títulos. Veja as ilustrações abaixo e observe o comportamento "arrastar e soltar" do IDE para fazer isso.
-|===
-|Para adicionar um JPanel:
+
+Para adicionar um JPanel:
1. Na janela Paleta, selecione o componente Painel na categoria Contêineres do Swing clicando e soltando o botão do mouse.
2. Mova o cursor até o canto esquerdo superior do form no GUI Builder. Quando o componente estiver localizado próximo às margens superior e esquerda do contêiner, linhas-guia de alinhamento horizontal e vertical aparecerão indicando as margens preferenciais. Clique no form para colocar o JPanel nesse local.
@@ -183,7 +171,7 @@
O componente ``JPanel`` aparece no form ``ContactEditorUI`` com realce na cor laranja, o que significa que ele está selecionado. Após soltar o botão do mouse, pequenos indicadores serão exibidos para mostrar as relações de ancoragem do componente e um nó JPanel correspondente será exibido na janela Navegador, como mostra a ilustração a seguir.
-|===
+
[.feature]
--
@@ -192,8 +180,8 @@
Depois, precisamos redimensionar o JPanel para dar espaço aos componentes que serão inseridos posteriormente, mas antes tomemos um minuto para indicar outras funcionalidades de visualização do GUI Builder. Para fazer isso, precisamos desmarcar o JPanel que acabamos de adicionar. Como nós ainda não adicionamos uma borda com título, o painel desaparecerá. Observe, entretanto, que quando ao passar o cursor sobre o JPanel, as margens mudarão para cinza claro para que sua posição possa ser vista claramente. Você precisa apenas clicar em qualquer lugar no componente para selecioná-lo novamente e fazer com que os handles de redimensionamento e os indicadores de ancoragem reapareçam.
-|===
-|Para redimensionar o JPanel:
+
+Para redimensionar o JPanel:
1. Selecione o JPanel recém-adicionado. Os pequenos handles de redimensionamento quadrados reaparecerão em torno do perímetro do componente.
2. Clique e segure o handle de redimensionamento na margem direita do JPanel e arraste-a até que a linha-guia de alinhamento pontilhada seja exibida próxima à margem do form.
@@ -202,7 +190,7 @@
O componente ``JPanel`` é estendido para ficar entre as margens esquerda e direita do contêiner de acordo com o deslocamento recomendado, como mostra a ilustração abaixo.
-|===
+
[.feature]
--
@@ -211,13 +199,13 @@
Agora que adicionamos um painel para conter a informação Nome da nossa UI, precisamos repetir o processo para adicionar outro diretamente abaixo da primeira para a informação de E-mail. Consultando as ilustrações abaixo, repita as duas tarefas anteriores, prestando atenção ao posicionamento sugerido pelo GUI Builder. Observe que o espaçamento vertical sugerido entre os dois JPanels é muito mais estreito que entre as margens. Quando você tiver adicionado o segundo JPanel, redimensione-o para que preencha o espaço vertical restante do form.
-|===
-|[.feature]
+
+[.feature]
--
image::images/02_add_panels_3-small.png[role="left", link="images/02_add_panels_3.png"]
--
- |
+
[.feature]
--
@@ -226,18 +214,18 @@
-|[.feature]
+[.feature]
--
image::images/02_add_panels_5-small.png[role="left", link="images/02_add_panels_5.png"]
--
-|===
+
Como queremos distinguir visualmente as funções nas seções superior e inferior da nossa GUI, precisamos adicionar uma borda e título a cada JPanel. Primeiro faremos isso utilizando a janela Propriedades e depois a experimentaremos utilizando o menu pop-up.
-|===
-|Para adicionar bordas de título aos JPanels:
+
+Para adicionar bordas de título aos JPanels:
1. Selecione o JPanel superior no GUI Builder.
2. Na janela Propriedades, clique no botão de reticências (...) ao lado da propriedade Borda.
@@ -249,7 +237,7 @@
As bordas com título serão adicionadas a ambos componentes ``JPanel`` .
-|===
+
[.feature]
--
@@ -261,8 +249,8 @@
Agora precisamos começar a adição dos componentes que apresentarão as informações de contato reais na nossa lista de contatos. Nessa tarefa, adicionaremos quatro JTextFields que exibirão as informações de contato e os JLabels que as descreverão. Ao fazer isso, observe as linhas-guia horizontais e verticais que o GUI Builder exibe, sugerindo o espaçamento preferencial dos componentes conforme definido pela aparência e funcionalidade do sistema operacional. Isso assegura que nossa GUI seja processada automaticamente respeitando a aparência do sistema operacional de destino em runtime.
-|===
-|Para adicionar um JLabel ao form:
+
+Para adicionar um JLabel ao form:
1. Na janela Paleta, selecione o componente Label na categoria Controles do Swing.
2. Mova o cursor acima do JPanel ``Name`` adicionado anteriormente. Quando as linhas-guias aparecerem, indicando que o JLabel está posicionado no canto superior esquerdo do JPanel com pequena margem nos cantos superior e esquerdo, clique para posicionar o label.
@@ -270,12 +258,12 @@
O JLabel será adicionado ao form e um nó correspondente, representando o componente, será adicionado à janela Inspetor.
-|===
+
Antes de prosseguir, precisamos editar o texto de exibição do JLabel que acabamos de adicionar. Embora seja possível editar o texto de exibição do componente em qualquer ponto, a maneira mais fácil é fazer isso à medida que o adiciona.
-|===
-|Para editar o texto de exibição de um JLabel:
+
+Para editar o texto de exibição de um JLabel:
1. Clique duas vezes no JLabel para selecionar a exibição de texto.
2. Digite ``Nome:`` e pressione Enter.
@@ -283,12 +271,12 @@
O novo nome do JLabel é exibido e a largura do componente será ajustada como resultado da edição.
-|===
+
Agora adicionaremos um JTextField para que possamos ter uma vista rápida da funcionalidade de alinhamento da linha de base do GUI Builder.
-|===
-|Para adicionar um JTextField ao form:
+
+Para adicionar um JTextField ao form:
1. Na janela Paleta, selecione o componente Campo de texto na categoria Controles do Swing.
2. Mova o cursor imediatamente à direita do JLabel ``Nome:`` recém-adicionado. Quando a linha-guia horizontal aparecer, indicando que a linha de base do JTextField está alinhada com aquela do JLabel e o espaçamento entre os dois componentes for sugerido com uma linha-guia vertical, clique para posicionar o JTextField.
@@ -296,7 +284,7 @@
O JTextField se encaixará na posição no form alinhado com a linha de base do JLabel, conforme mostra a ilustração abaixo. Observe que o JLabel mudou ligeiramente para baixo para se alinhar à linha de base do campo de texto mais alto. Como sempre, um nó representando o componente será adicionado à janela Navegador.
-|===
+
image::images/03_indy_add_1.png[]
@@ -304,8 +292,8 @@
image::images/03_indy_add_2.png[]
-|===
-|Para redimensionar um JTextField:
+
+Para redimensionar um JTextField:
1. selecione o JTextField que nós acabamos de adicionar à direita do JLabel ``Sobrenome:`` .
2. Arraste o handle de redimensionamento direito do JTextField em direção à margem direita do JPanel de fechamento.
@@ -314,7 +302,7 @@
A margem direita do JTextField se encaixará em alinhamento à margem recomendada do JPanel, conforme mostra a ilustração abaixo.
-|===
+
image::images/03_indy_add_3.png[]
@@ -323,8 +311,8 @@
Agora adicionaremos os JLabels ``Título:`` e ``Apelido:`` que descrevem dois JTextFields que adicionaremos em um minuto. Arrastaremos e soltaremos os componentes pressionando a tecla Shift para adicioná-los rapidamente ao form. Enquanto fazemos isso, observe novamente que o GUI Builder exibe linhas-guia horizontais e verticais sugerindo o espaçamento preferencial do componente.
-|===
-|Para adicionar vários JLabels ao form:
+
+Para adicionar vários JLabels ao form:
1. Na janela Paleta, selecione o componente Label na categoria Controles do Swing clicando e soltando o botão do mouse.
2. Mova o cursor sobre o form diretamente abaixo do JLabel ``Nome:`` adicionado anteriormente. Quando as linhas-guia aparecerem, indicando que a nova borda esquerda do JLabel está alinhada à do JLabel acima e houver uma pequena margem entre ambos, clique pressionando a tecla Shift para posicionar o primeiro JLabel.
@@ -333,14 +321,14 @@
Os JLabels serão adicionados ao form criando uma segunda linha, como mostra a ilustração abaixo. Os nós que representam os componentes serão adicionados à janela Navegador.
-|===
+
image::images/04_multi-add_1.png[]
Antes de continuar, precisamos editar o nome do JLabels para que possamos ver o efeito dos alinhamentos que definiremos posteriormente.
-|===
-|Para editar o texto de exibição de JLabels:
+
+Para editar o texto de exibição de JLabels:
1. clique duas vezes no primeiro JLabel para selecionar a exibição de texto.
2. Digite ``Título:`` e pressione Enter.
@@ -349,7 +337,7 @@
Os novos nomes dos JLabels serão exibidos no form e mudarão como resultado das larguras editadas, como mostra a ilustração abaixo.
-|===
+
image::images/04_multi-add_2.png[]
@@ -360,8 +348,8 @@
Geralmente, é necessário adicionar um componente entre componentes já colocados em um form. Quando você adiciona um componente entre dois componentes existentes, o GUI Builder automaticamente os mudará para dar espaço para o novo componente. Para demonstrar isso, inseriremos um JTextField entre os JLabels adicionados anteriormente, como mostram as duas ilustrações abaixo.
-|===
-|Para inserir um JTextField entre dois JLabels:
+
+Para inserir um JTextField entre dois JLabels:
1. Na janela Paleta, selecione o componente Campo de texto na categoria Controles do Swing.
2. Mova o cursor acima dos JLabels ``Título:`` e ``Apelido:`` na segunda linha de maneira que o JTextField sobreponha ambos e fique alinhado às suas linhas de base. Se você tiver dificuldade em posicionar o novo campo de texto, poderá encaixá-lo à linha-guia esquerda do JLabel ``Apelido`` , como mostra a primeira imagem abaixo.
@@ -370,22 +358,22 @@
O JTextField se encaixará entre os dois JLabels. O JLabel da extremidade direita muda em direção à direita do JTextField para acomodar o deslocamento horizontal sugerido.
-|===
-|===
-|image::images/05_insert_1.png[]
- |
+
+image::images/05_insert_1.png[]
+
+
image::images/05_insert_2.png[]
-|===
+
Ainda precisamos adicionar outro JTextField ao form que exibirá o apelido do contato no lado direito do form.
-|===
-|Para adicionar um JTextField:
+
+Para adicionar um JTextField:
1. Na janela Paleta, selecione o componente Campo de Texto na categoria Swing.
2. Mova o cursor para a direita do label ``Apelido`` e clique para posicionar o campo de texto.
@@ -393,40 +381,34 @@
O JTextField se encaixará ao lado esquerdo do JLabel.
-|===
-|===
-|Para redimensionar um JTextField:
+
+
+Para redimensionar um JTextField:
1. Arraste os handles de redimensionamento do JTextField do label ``Apelido:`` adicionado na tarefa anterior à direita do JPanel de fechamento.
2. Quando as linhas-guia de alinhamento vertical aparecerem sugerindo a margem entre o campo de texto e as margens do JPanel, solte o botão do mouse para redimensionar o JTextField.
A margem direita do JTextField se encaixará em alinhamento com a margem recomendada do JPanel e o GUI Builder deduzirá o comportamento de redimensionamento correto.
-3. Pressione Ctrl-S para salvar o arquivo.
+
+[start=3]
+. Pressione Ctrl-S para salvar o arquivo.
-|===
-
-----
-
-<<top,início>>
== Avançando
Alinhamento é um dos aspectos mais fundamentais da criação GUI com aparência profissional. Na seção anterior, tivemos uma vista rápida das funcionalidades de alinhamento do IDE durante a adição dos componentes JLabel e JTextField ao nosso form ContactEditorUI. Depois, veremos de maneira mais profunda as funcionalidades de alinhamento do GUI Builder, conforme trabalhamos com os outros componentes necessários para a nossa aplicação.
-[quote]
-----
-
=== Alinhamento de Componentes
*Observação:* Consulte o screencast link:http://bits.netbeans.org/media/quickstart-gui-align.swf[+Alinhando e ancorando componentes (.swf)+] para ver uma demonstração interativa na seção abaixo.
Sempre que você adiciona um componente a um form, o GUI Builder os alinha efetivamente, conforme evidenciado pelas linhas-guia de alinhamento exibidas. Entretanto, às vezes, também é necessário especificar diferentes relacionamentos entre os grupos de componentes. Anteriormente, nós adicionamos quatro JLabels necessários para a nossa GUI ContactEditor, mas nós não os alinhamos. Agora alinharemos as duas colunas de JLabels para que as margens direitas se alinhem.
-|===
-|Para alinhar componentes:
+
+Para alinhar componentes:
1. mantenha pressionada a tecla ``Ctrl`` e clique para selecionar os JLabels ``Nome:`` e ``Título:`` do lado esquerdo do form.
2. Clique no botão Alinhar à Direita na coluna (image::images/align_r.png[]) na barra de ferramentas. Alternativamente, clique com o botão direito do mouse em um deles e escolha Alinhar > Direita na coluna no menu pop-up.
@@ -435,12 +417,12 @@
A posição dos JLabels muda para que as margens direitas do texto de exibição sejam alinhadas. Os relacionamentos de ancoragem serão atualizados, indicando que os componentes foram agrupados.
-|===
+
Antes de finalizarmos com os JTextFields adicionados anteriormente, precisamos nos certificar de que os dois JTextFields que inserimos entre os JLabels estejam definidos para se redimensionarem corretamente. Ao contrário dos dois JTextFields que foram esticados para a margem direita do form, o procedimento de redimensionamento dos componentes inseridos não é definido automaticamente.
-|===
-|Para definir o procedimento de redimensionamento de um componente:
+
+Para definir o procedimento de redimensionamento de um componente:
1. Clique nos dois componentes JTextField inseridos para selecioná-los no GUI Builder.
2. Com os dois JTextFields selecionados, clique com o botão direito do mouse em um deles e escolha Redimensionamento automático > Horizontal no menu pop-up.
@@ -448,10 +430,10 @@
Os JTextFields serão definidos com redimensionamento horizontal em runtime. As linhas-guia de alinhamento e os indicadores de ancoragem serão atualizados, fornecendo comentário visual dos relacionamentos dos componentes.
-|===
-|===
-|Para configurar os componentes para que tenham o mesmo tamanho:
+
+
+Para configurar os componentes para que tenham o mesmo tamanho:
1. Clique em todos os quatro JTextFields do form para selecioná-los.
2. Com os JTextfields selecionados, clique com o botão direito do mouse em um deles e escolha Definir Mesmo Tamanho > Mesma Largura no menu pop-up.
@@ -459,12 +441,12 @@
Todos os JTextFields terão a mesma largura definida e os indicadores serão adicionados na parte superior destes, fornecendo feedback visual dos relacionamentos dos componentes.
-|===
+
Agora precisamos adicionar outro JLabel que descreva a JComboBox que permitirá aos usuários selecionar o formato das informações que nossa aplicação ContactEditor exibirá.
-|===
-|Para alinhar um JLabel a um grupo de componentes:
+
+Para alinhar um JLabel a um grupo de componentes:
1. Na janela Paleta, selecione o componente Label na categoria Swing.
2. Mova o cursor abaixo dos JLabels ``Nome:`` e ``Título:`` no lado esquerdo do JPanel. Quando as linhas-guia aparecerem, indicando que a nova borda direita do JLabel está alinhada às margens direitas do grupo de componentes acima (os dois JLabels), clique para posicionar o componente.
@@ -472,7 +454,7 @@
O JLabel se encaixará em uma posição alinhada à direita com a coluna dos JLabels acima, conforme mostra a ilustração abaixo. O GUI Builder atualiza as linhas de status de alinhamento, indicando as relações de espaçamento e ancoragem do componente.
-|===
+
[.feature]
--
@@ -488,8 +470,8 @@
Agora adicionaremos a caixa de combinação que permitirá aos usuários selecionar o formato das informações que nossa aplicação ContactEditor exibirá. À medida que adicionamos JComboBox, alinharemos a linha de base com o texto do JLabel. Observe, mais uma vez as linhas-guia de alinhamento da linha de base aparece para nos auxiliar com o posicionamento.
-|===
-|Para alinhar as linhas de base dos componentes:
+
+Para alinhar as linhas de base dos componentes:
1. Na janela Paleta, selecione o componente Caixa de combinação na categoria Controles do Swing.
2. Mova o cursor à direita do JLabel recém-adicionado. Quando a linha-guia horizontal aparecer, indicando que a linha de base do JComboBox está alinhada à linha de base do texto do JLabel e o espaçamento entre os dois componentes for sugerido com uma linha-guia vertical, clique para posicionar a caixa de combinação.
@@ -497,15 +479,15 @@
O componente se encaixará em uma posição alinhada com a linha de base do JLabel à esquerda, conforme mostra a ilustração abaixo. O GUI Builder exibe as linhas de status, indicando as relações de espaçamento e ancoragem do componente.
-|===
+
[.feature]
--
image::images/06_align_2-small.png[role="left", link="images/06_align_2.png"]
--
-|===
-|Para redimensionar o JComboBox:
+
+Para redimensionar o JComboBox:
1. Selecione a Caixa de Combinação no GUI Builder.
2. Arraste o handle de redimensionamento na margem direita do JComboBox até que as linhas-guia de alinhamento apareçam sugerindo o deslocamento preferencial entre as margens do JComboBox e do JPanel.
@@ -517,33 +499,27 @@
image::images/06_align_3-small.png[role="left", link="images/06_align_3.png"]
--
-3. Pressione Ctrl-S para salvar o arquivo.
+
+[start=3]
+. Pressione Ctrl-S para salvar o arquivo.
-|===
+
A edição de modelos de componentes está além do escopo desse tutorial, portanto deixaremos, por enquanto, a lista de itens de espaço reservada da JComboBox como está.
-----
-
-<<top,início>>
-
-
== Revisando o Que Aprendemos
Terminamos um bom início de construção da nossa GUI ContactEditor, mas tomemos um minuto para recapitular o que aprendemos enquanto adicionamos mais alguns componentes que nossa interface requer.
Até agora, nós nos concentramos na adição de componentes à nossa GUI ContactEditor utilizando as linhas-guia de alinhamento do IDE para nos ajudar no posicionamento. Entretanto, é importante compreender que a ancoragem é outra parte integrante do posicionamento de componentes. Embora ainda não tenhamos discutido isso, você já se beneficiou com essa funcionalidade sem perceber. Como mencionado antes, ao adicionar um componente a um form, o IDE sugere o posicionamento preferencial da aparência de destino com linhas-guia. Depois de posicionados, os novos componentes também são ancorados na margem mais próxima do contêiner ou componente para assegurar que os relacionamentos entre os componentes sejam mantidos em runtime. Nesta seção, nós nos concentraremos em concluir as tarefas de maneira mais otimizada, ao ressaltarmos o trabalho que o GUI Builder está fazendo nos bastidores.
-[quote]
-----
-
=== Adicionando, Alinhando e Ancorando
O GUI Builder permite fazer o layout de forms rápida e facilmente otimizando gestos típicos do fluxo de trabalho. Quando você adiciona um componente a um form, o GUI Builder o encaixa automaticamente na posição preferencial e define as relações de encadeamento necessárias para que você se concentre no design dos forms em vez de conflitar com detalhes de implementação complicados.
-|===
-|Para adicionar, alinhar e editar o texto de exibição de um JLabel:
+
+Para adicionar, alinhar e editar o texto de exibição de um JLabel:
1. Na janela Paleta, selecione o componente Label na categoria Controles do Swing.
2. Mova o cursor sobre o form imediatamente abaixo do título E-mail do JPanel inferior. Quando as linhas-guia aparecerem, indicando que está posicionado no canto superior esquerdo do JPanel com uma pequena margem nos cantos superior e esquerdo, clique para posicionar o JLabel.
@@ -552,27 +528,29 @@
O JLabel se encaixará na posição preferencial no form e será ancorado nas margens superior e esquerda do JPanel de fechamento. Assim como ocorreu anteriormente, um nó correspondente, representando o componente, também será adicionado à janela Navegador.
-|===
-|===
-|Para adicionar um JTextField:
+
+
+Para adicionar um JTextField:
1. Na janela Paleta, selecione o componente Campo de texto na categoria Controles do Swing.
2. Mova o cursor imediatamente à direita do label ``Endereço de E-mail`` recém-adicionado. Quando as linhas-guia aparecerem, indicando que a linha de base do JTextField está alinhada à linha de base do texto no JLabel e a margem entre os dois componentes for sugerida com uma linha-guia vertical, clique para posicionar o campo de texto.
O JTextField se encaixará à direita do JLabel ``Endereço de E-mail:`` e será encadeado ao JLabel. O nó correspondente também será adicionado à janela Inspetor.
-3. Arraste o handle de redimensionamento do JTextField em direção à direita do JPanel até que as linhas-guia de alinhamento sejam exibidas sugerindo o deslocamento entre as margens do JTextField e do JPanel.
+
+[start=3]
+. Arraste o handle de redimensionamento do JTextField em direção à direita do JPanel até que as linhas-guia de alinhamento sejam exibidas sugerindo o deslocamento entre as margens do JTextField e do JPanel.
A margem direita do JTextField se encaixará na linha-guia de alinhamento indicando as margens preferenciais.
-|===
+
Agora precisamos adicionar o JList que exibirá a lista de contatos completa do ContactEditor.
-|===
-|Para adicionar e redimensionar um JList:
+
+Para adicionar e redimensionar um JList:
1. Na janela Paleta, selecione o componente Lista na categoria Controles do Swing.
2. Mova o cursor imediatamente abaixo do JLabel ``Endereço de E-mail`` adicionado anteriormente. Quando as linhas-guia aparecerem, indicando que as margens superior e esquerda do JList estão alinhadas às margens preferenciais ao longo da margem esquerda do JPanel e do JLabel acima, clique para posicionar o JList.
@@ -581,7 +559,7 @@
O JList se encaixará na posição designada pelas linhas-guia de alinhamento e seu nó correspondente será exibido na janela Inspetor. Observe também que o form se expande para acomodar o JList recém-adicionado.
-|===
+
[.feature]
--
@@ -597,19 +575,19 @@
É sempre benéfico definir vários componentes relacionados, como botões em caixas de diálogo modais, para que tenham o mesmo tamanho a fim de oferecer consistência visual. Para demonstrar isso, adicionaremos quatro JButtons ao nosso form ContactEditor que permitirão adicionar, editar e remover entradas individuais da nossa lista de contatos, como mostram as ilustrações abaixo. Depois, definiremos os quatro botões para que tenham o mesmo tamanho e possam ser facilmente reconhecidos e ofereçam a funcionalidade relacionada.
-|===
-|Para adicionar, alinhar e editar o texto de exibição de vários botões:
+
+Para adicionar, alinhar e editar o texto de exibição de vários botões:
1. Na janela Paleta, selecione o componente Botão na categoria Controles do Swing.
2. Mova o JButton acima da margem direita do JTextField ``Endereço de E-mail`` no JPanel inferior. Quando as linhas-guia aparecerem, indicando que a linha de base e a margem direita do JButton estão alinhadas às margens do JTextField, clique pressionando Shift para posicionar o primeiro botão ao longo da margem direita do JFrame. A largura do JTextField diminui para acomodar o JButton onde você soltar o botão do mouse.
-|===
-|[.feature]
+
+[.feature]
--
image::images/buttons_1-small.png[role="left", link="images/buttons_1.png"]
--
- |
+
[.feature]
--
@@ -617,22 +595,26 @@
--
-|===
-3. Mova o cursor sobre o canto superior direito do JList no JPanel inferior. Quando as linhas-guia aparecerem, indicando que as margens superior e direita do JButton estão alinhadas às margens do JList, clique pressionando Shift para posicionar o segundo botão ao longo da margem direita do JFrame.
+[start=3]
+. Mova o cursor sobre o canto superior direito do JList no JPanel inferior. Quando as linhas-guia aparecerem, indicando que as margens superior e direita do JButton estão alinhadas às margens do JList, clique pressionando Shift para posicionar o segundo botão ao longo da margem direita do JFrame.
[.feature]
--
image::images/buttons_3-small.png[role="left", link="images/buttons_3.png"]
--
-4. Adicione dois outros JButtons abaixo dos dois já adicionados para criar uma coluna. Certifique-se de posicionar os JButtons de maneira que o espaçamento sugerido seja respeitado e consistente. Se você se esquecer de soltar a tecla Shift antes de posicionar o último JButton, basta pressionar a tecla Escape.
+
+[start=4]
+. Adicione dois outros JButtons abaixo dos dois já adicionados para criar uma coluna. Certifique-se de posicionar os JButtons de maneira que o espaçamento sugerido seja respeitado e consistente. Se você se esquecer de soltar a tecla Shift antes de posicionar o último JButton, basta pressionar a tecla Escape.
[.feature]
--
image::images/buttons_4-small.png[role="left", link="images/buttons_4.png"]
--
-5. Defina o texto de exibição de cada JButton. (Você pode editar o texto de um botão, clicando com o botão direito do mouse no botão e escolhendo Editar Texto. Ou você pode clicar no botão, pausar e clicar novamente.) Insira `Adicionar` para o botão superior, `Editar` para o segundo, `Remover` para o terceiro e `Default` para o quarto.
+
+[start=5]
+. Defina o texto de exibição de cada JButton. (Você pode editar o texto de um botão, clicando com o botão direito do mouse no botão e escolhendo Editar Texto. Ou você pode clicar no botão, pausar e clicar novamente.) Insira `Adicionar` para o botão superior, `Editar` para o segundo, `Remover` para o terceiro e `Default` para o quarto.
Os componentes JButton se encaixam nas posições designadas pelas linhas-guia de alinhamento. A largura dos botões muda para acomodar os novos nomes.
@@ -642,12 +624,12 @@
--
-|===
+
Agora que os botões estão posicionados onde queremos, nós definiremos os quatro botões para que tenham o mesmo tamanho e consistência visual, bem como para esclarecer a funcionalidade relacionada.
-|===
-|Para definir componentes do mesmo tamanho:
+
+Para definir componentes do mesmo tamanho:
1. Selecione os quatro JButtons pressionando a tecla Control enquanto faz a seleção.
2. Clique com o botão direito do mouse em um deles e escolha Mesmo Tamanho > Mesma Largura no menu pop-up.
@@ -660,7 +642,7 @@
--
-|===
+
=== Recuo
@@ -669,8 +651,8 @@
Nesta seção, adicionaremos alguns JRadioButtons abaixo de um JLabel que permitirá aos usuários personalizar a maneira como a aplicação exibe dados. Veja as ilustrações abaixo enquanto faz isso ou clique no link Exibir Demonstração seguindo o procedimento para ver uma demonstração interativa.
-|===
-|Para recuar JRadioButtons abaixo de um JLabel:
+
+Para recuar JRadioButtons abaixo de um JLabel:
1. Adicione um JLabel nomeado ``Formato de Correspondência`` ao form abaixo do JList. Certifique-se de que o label esteja alinhado à esquerda do JList acima.
2. Na janela Paleta, selecione o componente Botão de Opção na categoria Swing.
@@ -681,8 +663,12 @@
image::images/07_indent_1-small.png[role="left", link="images/07_indent_1.png"]
--
-4. Mova o cursor à direita do primeiro JRadioButton. Clique pressionando a tecla Shift para inserir o segundo e o terceiro JRadioButtons, respeitando o espaçamento sugerido do componente. Certifique-se de soltar a tecla Shift antes de posicionar o último JRadioButton.
-5. Defina o texto de exibição de cada JRadioButton. (Você pode editar o texto de um botão, clicando com o botão direito do mouse no botão e escolhendo Editar Texto. Ou você pode clicar no botão, pausar e clicar novamente.) Insira `HTML` para o botão de opção esquerdo, `Texto Simples ` para o segundo e `Personalizado` para o terceiro.
+
+[start=4]
+. Mova o cursor à direita do primeiro JRadioButton. Clique pressionando a tecla Shift para inserir o segundo e o terceiro JRadioButtons, respeitando o espaçamento sugerido do componente. Certifique-se de soltar a tecla Shift antes de posicionar o último JRadioButton.
+
+[start=5]
+. Defina o texto de exibição de cada JRadioButton. (Você pode editar o texto de um botão, clicando com o botão direito do mouse no botão e escolhendo Editar Texto. Ou você pode clicar no botão, pausar e clicar novamente.) Insira `HTML` para o botão de opção esquerdo, `Texto Simples ` para o segundo e `Personalizado` para o terceiro.
Três JRadioButtons serão adicionados ao form e recuados abaixo do JLabel ``Formato de Correio`` .
@@ -692,12 +678,12 @@
--
-|===
+
Agora, precisamos adicionar os três JRadioButtons a um ButtonGroup para permitir o comportamento de alternância esperado, no qual somente um botão de opção pode ser selecionado por vez. Por sua vez, isso assegurará que as informações de contato da aplicação ContactEditor serão exibidas no formato de e-mail da nossa escolha.
-|===
-|Para adicionar JRadioButtons a um ButtonGroup:
+
+Para adicionar JRadioButtons a um ButtonGroup:
1. Na janela Paleta, selecione o componente Grupo de Botões na categoria Controles do Swing.
2. Clique em qualquer lugar na área de design do GUI Builder para adicionar o componente ButtonGroup ao form. Observe que o ButtonGroup em si não é exibido no form, no entanto, é visível na área Outros Componentes do Navegador.
@@ -711,28 +697,23 @@
image::images/07_group-small.png[role="left", link="images/07_group.png"]
--
-5. Pressione Ctrl-S para salvar o arquivo.
+
+[start=5]
+. Pressione Ctrl-S para salvar o arquivo.
-|===
-----
-
-<<top,início>>
== Fazendo os Ajustes Finais
Conseguimos esboçar nossa GUI da aplicação ContactEditor, mas ainda há algumas coisas a serem feitas. Nesta seção, observaremos algumas das tarefas de layout típicas que o GUI Builder simplifica.
-[quote]
-----
-
=== Finalizando
Agora precisamos adicionar os botões que permitirão aos usuários confirmar as informações que inserirem de um contato individual e adicioná-las à lista de contatos ou cancelar, deixando o banco de dados inalterado. Nesta etapa, adicionaremos os dois botões requeridos e os editaremos para que sejam exibidos com o mesmo tamanho no form, embora seus textos de exibição tenham tamanhos diferentes.
-|===
-|Para adicionar e editar o texto de exibição dos botões:
+
+Para adicionar e editar o texto de exibição dos botões:
1. se o JPanel inferior estiver estendido na margem inferior do form JFrame, arraste a margem inferior do JFrame para baixo. Isso proporciona espaço entre as margens do JFrame e do JPanel para os botões OK e Cancelar.
2. Na janela Paleta, selecione o componente Botão na categoria Controles do Swing.
@@ -743,9 +724,15 @@
image::images/08_cancel-small.png[role="left", link="images/08_cancel.png"]
--
-4. Adicione outro JButton à esquerda do primeiro, certificando-se de colocá-lo utilizando o espaçamento sugerido ao longo da margem inferior do JFrame.
-5. Defina o texto de exibição de cada JButton. Insira ``OK`` para o botão esquerdo e ``Cancelar`` para o botão direito. Observe que a largura dos botões muda para acomodar os novos nomes.
-6. Defina os dois JButtons para terem o mesmo tamanho selecionando-os, clicando com o botão direito do mouse em um deles e selecionando Mesmo Tamanho > Mesma Largura no menu pop-up.
+
+[start=4]
+. Adicione outro JButton à esquerda do primeiro, certificando-se de colocá-lo utilizando o espaçamento sugerido ao longo da margem inferior do JFrame.
+
+[start=5]
+. Defina o texto de exibição de cada JButton. Insira ``OK`` para o botão esquerdo e ``Cancelar`` para o botão direito. Observe que a largura dos botões muda para acomodar os novos nomes.
+
+[start=6]
+. Defina os dois JButtons para terem o mesmo tamanho selecionando-os, clicando com o botão direito do mouse em um deles e selecionando Mesmo Tamanho > Mesma Largura no menu pop-up.
[.feature]
--
@@ -754,18 +741,15 @@
Os componentes ``JButton`` serão exibidos no form e seus nós correspondentes serão exibidos na janela Navegador. O código dos componentes ``JButton`` também será adicionado ao arquivo de código-fonte do form, que é visível na view Código-fonte do Editor. Todos os JButtons serão definidos com o mesmo tamanho do botão que possuir o maior nome.
-7. Pressione Ctrl-S para salvar o arquivo.
+
+[start=7]
+. Pressione Ctrl-S para salvar o arquivo.
-|===
+
A última coisa que precisamos fazer é deletar o texto do espaço reservado nos vários componentes. Observe que, embora a remoção do texto do placeholder após a configuração preliminar de um form possa ser uma técnica útil para evitar problemas de alinhamento e relações de ancoragem dos componentes, a maioria dos desenvolvedores geralmente remove esse texto no processo de layout de seus forms. À medida que percorre o form, selecione e delete o texto do espaço reservado de cada um dos JTextFields. Deixaremos os itens de placeholder no JComboBox e no JList para um tutorial posterior.
-----
-
-<<top,início>>
-
-
== Visualizando a GUI
Agora que você criou com êxito a GUI ContactEditor, é possível experimentar a interface para ver os resultados. É possível visualizar o form à medida que trabalha clicando no botão Visualizar Form (image::images/test_form.png[]) na barra de ferramentas do GUI Builder. O form será aberto em sua própria janela, permitindo que você o teste antes da construção e execução.
@@ -775,7 +759,7 @@
image::images/08_preview_gui-small.png[role="left", link="images/08_preview_gui.png"]
--
-<<top,início>>
+
== Implantando Aplicações GUI
@@ -787,9 +771,6 @@
Se você estiver executando o IDE no JDK 6, o IDE gera o código de sua aplicação para utilizar as classes GroupLayout que estão no Java SE 6. Isso significa que é possível implantar a aplicação para ser executada em sistemas com o Java SE 6 instalado e não é necessário encapsular sua aplicação com a biblioteca de extensões de layout Swing.
*Observação: * se a aplicação for criada com o JDK 6, mas você precisar que também seja executada no Java SE 5, poderá fazer com que o IDE gere seu código para utilizar a biblioteca de extensões de layout Swing em vez das classes no Java SE 6. Abra a classe ContactEditorUI no Editor de GUI. No Navegador, clique com o botão direito do mouse no Form ContactEditorUI e escolha Propriedades no menu pop-up. Na caixa de diálogo Propriedades, altere o valor da propriedade Estilo de Geração de Layout para Biblioteca de Extensões de Layout Swing.
-[quote]
-----
-
=== Distribuindo e Executando Aplicações GUI Standalone
@@ -803,23 +784,22 @@
1. Navegue até a pasta ``dist`` do projeto.
2. Digite o seguinte:
-[quote]
-----
- ``java -jar <nome do jar>.jar``
-----
+[source,java]
+----
+java -jar <nome do jar>.jar
----
*Observação:* se você encontrar este erro:
-[quote]
+[source,bash]
----
- ``Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group``
+Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group
----
Verifique se o arquivo ``manifest.mf`` faz referência à versão atualmente instalada da Biblioteca de extensões de Layout Swing.
-<<top,início>>
+
link:/about/contact_form.html?to=3&subject=Feedback:%20Designing%20a%20Swing%20GUI%20in%20NetBeans%20IDE[+Enviar Feedback neste Tutorial+]
@@ -835,5 +815,5 @@
* link:../../trails/matisse.html[+Trilha de Aprendizado das Aplicações de GUI do Java+]
* link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG920[+Implementando GUIs de Java+] em _Desenvolvendo Aplicações com o NetBeans IDE_
-<<top,início>>
+
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ru.asciidoc
index 519bef2..c44853a 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_ru.asciidoc
@@ -42,13 +42,13 @@
*Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.*
-|===
-|Программное обеспечение или материал |Требуемая версия
-|link:http://netbeans.org/downloads/index.html[+IDE NetBeans+] |версия 6.9 и более поздние
+Программное обеспечение или материалТребуемая версия
-|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+] |версия 6, 7 или 8
-|===
+link:http://netbeans.org/downloads/index.html[+IDE NetBeans+]версия 6.9 и более поздние
+
+link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработчика на языке Java (JDK)+]версия 6, 7 или 8
+
== Начало работы
@@ -57,15 +57,12 @@
Подробные сведения о визуальных средствах поддержки GUI Builder приведены в разделе link:quickstart-gui-legend.html[+Визуальные средства поддержки в GUI Builder+].
-[quote]
-----
-
=== Создание проекта
Поскольку разработка Java в среде IDE всегда выполняется в рамках проектов, сначала необходимо создать проект ``ContactEditor`` , в котором будут сохраняться исходные файлы и другие файлы проекта. Проект среды IDE представляет собой группу исходных файлов Java и связанные с ними метаданные, включая файлы свойств проекта, сценарий сборки Ant, управляющий параметрами сборки и выполнения, а также файл ``project.xml`` , отображающий целевые элементы Ant для команд среды IDE. Несмотря на то, что приложения на Java часто составляются из нескольких проектов среды IDE, в учебных целях предлагается собрать простое приложение, размещаемое в одном проекте.
-|===
-|Для создания проекта приложения ``ContactEditor`` выполните действия, описанные ниже.
+
+Для создания проекта приложения ``ContactEditor`` выполните действия, описанные ниже.
1. Выберите команду "Файл" > "Новый проект". Также можно щелкнуть значок "Новый проект" на панели инструментов среды IDE.
2. На панели "Категории" выберите узел Java и на панели "Проекты" выберите приложение Java. Нажмите кнопку "Далее".
@@ -77,30 +74,31 @@
Среда IDE создаст в системе папку ``ContactEditor`` по указанному пути. Эта папка содержит все файлы, связанные с проектом, включая сценарий Ant, папки для хранения исходных файлов и тестов, а также папку с метаданными проекта. Для просмотра структуры проекта используйте окно "Файлы" в среде IDE.
-|===
+
=== Создание контейнера JFrame
По завершении создания приложения можно заметить, что папка с исходными файлами в окне "Проекты" содержит пустой узел ``<default package>`` . Для продолжения процесса создания интерфейса необходимо создать контейнер Java, в который будут помещены другие требуемые элементы графического интерфейса. В этом действии будет выполнено создание контейнера с использованием компонента ``JFrame`` и размещение контейнера в новом пакете.
-|===
-|Добавление контейнера ``JFrame``
+
+Добавление контейнера ``JFrame``
1. В окне 'Проекты' щелкните правой кнопкой мыши узел ``ContactEditor`` и выберите 'Создать' > 'Форма JFrame'.
Также форму JFrame можно найти, выбрав "Создать" > "Другое" > "Формы графического интерфейса Swing" > "Форма JFrame".
-2. Введите ``ContactEditorUI`` в поле имени класса.
-3. Введите ``my.numberaddition`` в поле пакета.
-4. Нажмите кнопку "Завершить".
+
+[start=2]
+. Введите ``ContactEditorUI`` в поле имени класса.
+
+[start=3]
+. Введите ``my.numberaddition`` в поле пакета.
+
+[start=4]
+. Нажмите кнопку "Завершить".
Среда IDE создаст форму ``ContactEditorUI`` и класс ``ContactEditorUI`` в рамках приложения ``ContactEditorUI.java`` и открывает форму ``ContactEditorUI`` в средстве GUI Builder. Обратите внимание, что пакет ``my.contacteditor`` сохраняется вместо пакета по умолчанию.
-|===
-
-----
-
-<<top,В начало>>
== Знакомство со средством GUI Builder
@@ -127,15 +125,13 @@
*Примечание.* Для опытных разработчиков доступен диспетчер палитры, что позволяет добавлять нестандартные компоненты из файлов JAR, библиотек или других проектов к палитре. Для добавления пользовательских компонентов при помощи диспетчера палитры выберите "Сервис" > "Палитра" > "Компоненты Swing/AWT".
-<<top,В начало>>
+
== Ключевые понятия
GUI Builder в среде IDE разрешает основные проблемы, возникающие при создании графического интерфейса Java путем рационализации процесса создания графических интерфейсов, освобождая разработчиков от необходимости изучения особенностей диспетчеров компоновки Swing. Это выполняется путем расширения возможностей конструктора графического интерфейса пользователя IDE NetBeans для поддержки простой парадигмы "Произвольная структура" с простыми правилами компоновки, понятными и простыми в использовании. В процессе проектирования формы GUI Builder предоставляет визуальные средства поддержки, предлагая оптимальное расположение и выравнивание компонентов. GUI Builder способствует переносу пользовательских решений по разработке в функциональный пользовательский интерфейс, реализуемый при помощи диспетчера компоновки GroupLayout и других средств Swing. Благодаря динамической модели размещения компонентов поведение графического интерфейса в GUI Builder во время выполнения соответствует ожидаемому, что позволяет вносить корректировки без изменения установленных взаимосвязей между компонентами. При каждом изменении размеров форм, переключении локалей или применении нового общего стиля графический интерфейс автоматически изменяется в соответствии с новой настройкой вставок и смещений стиля.
-[quote]
-----
=== Свободное проектирование
@@ -152,9 +148,6 @@
Средство GUI Builder предоставляет визуальные средства поддержки для обеспечения привязки компонентов и установки отношений между ними. Эти индикаторы способствуют быстрому определению различных отношений при позиционировании и поведения при привязке компонентов, влияющие на внешний вид и работу графического интерфейса. Это ускоряет процесс проектирования графического интерфейса и позволяет быстро создавать профессиональные функционирующие визуальные интерфейсы.
-----
-
-<<top,В начало>>
== Первые действия
@@ -163,8 +156,6 @@
Благодаря парадигме свободного проектирования в среде IDE разработчики избавлены от длительного изучения тонкостей работы с диспетчерами компоновки для управления размером и позицией компонентов в контейнерах. Все, что им надо делать — это перетаскивать нужные компоненты в формы GUI, как показано на следующем рисунке.
-[quote]
-----
*Примечание.* Демо-ролик link:http://bits.netbeans.org/media/quickstart-gui-add.swf[+Adding individual and multiple components (.swf)+](Добавление отдельных компонентов и их множества) иллюстрирует информацию, описанную в разделе ниже.
@@ -174,8 +165,8 @@
После добавления компонента JFrame как контейнера формы верхнего уровня следует добавить несколько панелей JPanel, которые позволят объединить компоненты пользовательского интерфейса в кластеры с использованием границ с заголовками. Закончив изучение данного раздела, можно для иллюстрации процесса "перетаскивания" в среде IDE рассмотреть следующий рисунок.
-|===
-|Добавление панели JPanel
+
+Добавление панели JPanel
1. В окне "Палитра" выберите компонент "Панель" из категории "Контейнеры Swing", нажав и отпустив кнопку мыши.
2. Переместите курсор в левый верхний угол формы GUI Builder. При расположении компонента рядом с верхней или левой границами контейнера появляются горизонтальные и вертикальные направляющие, обозначающие предпочтительные поля. Щелкните в пространстве формы для расположения панели JPanel в позиции курсора мыши.
@@ -183,7 +174,7 @@
Компонент ``JPanel`` , который появляется в форме ``ContactEditorUI`` , подсвечен оранжевым, чтобы показать, что он выбран. После того, как кнопка мыши будет отпущена, появятся маленькие индикаторы, которые показывают привязки компонентов. А соответствующий узел JPanel отобразит окно "Навигатор", как изображено на следующем рисунке.
-|===
+
[.feature]
--
@@ -192,8 +183,8 @@
Теперь следует изменить размеры панели JPanel, чтобы подготовить пространство для размещения других компонентов. Однако сначала обратим внимание на еще одну функцию визуализации GUI Builder. Отмените выбор добавленной панели JPanel. Поскольку граница с заголовком еще не добавлена, панель исчезнет. Однако обратите внимание на то, что при наведении курсора на панель JPanel ее края становятся светло-серыми, что позволяет четко определить позицию этого компонента. Теперь щелкните в пределах границ панели для ее повторного выбора, в результате появятся метки-манипуляторы и индикаторы привязки.
-|===
-|Изменение размера панели JPanel
+
+Изменение размера панели JPanel
1. Выберите только что добавленную панель JPanel. По периметру компонента появятся небольшие квадратные метки-манипуляторы.
2. Щелкните метку-манипулятор на правой границе панели JPanel и, не отпуская кнопки мыши, перемещайте метку до тех пор, пока рядом с границей не появится пунктирная направляющая.
@@ -202,7 +193,7 @@
Теперь компонент ``JPanel`` расширен и охватывает пространство между левым и правым полем контейнера с учетом рекомендуемого смещения, как изображено на рисунке ниже.
-|===
+
[.feature]
--
@@ -211,13 +202,13 @@
Теперь, после добавления панели, содержащей сведений об имени пользовательского интерфейса, необходимо повторить этот процесс для добавления еще одного компонента с данными об адресе электронной почты непосредственно под первым компонентом. Повторите две предыдущих процедуры, как изображено на следующих рисунках, при этом обратите внимание на предлагаемое размещение компонентов в GUI Builder. Следует отметить, что предложенный вертикальный интервал между двумя панелями JPanel намного меньше, чем пространство до границ формы. После добавления второй панели JPanel следует изменить ее размеры так, чтобы она заполнила оставшееся пространство формы (по вертикали).
-|===
-|[.feature]
+
+[.feature]
--
image::images/02_add_panels_3-small.png[role="left", link="images/02_add_panels_3.png"]
--
- |
+
[.feature]
--
@@ -226,18 +217,18 @@
-|[.feature]
+[.feature]
--
image::images/02_add_panels_5-small.png[role="left", link="images/02_add_panels_5.png"]
--
-|===
+
Поскольку функции в верхних и нижних разделах графического интерфейса должны быть визуально различимы, в каждую панель JPanel необходимо добавить границу и заголовок. Это действие можно выполнить при помощи окна "Свойства" или с использованием всплывающего меню.
-|===
-|Для добавления границ с заголовком в панель JPanels выполните действия, описываемые ниже.
+
+Для добавления границ с заголовком в панель JPanels выполните действия, описываемые ниже.
1. Выберите верхнюю панель JPanel в GUI Builder.
2. В окне "Свойства" нажмите кнопку с многоточием (...) рядом со свойством "Граница".
@@ -249,7 +240,7 @@
К обоим компонентами ``JPanel`` будут добавлены границы с заголовками.
-|===
+
[.feature]
--
@@ -261,8 +252,8 @@
Теперь добавим компоненты, которые будут представлять фактическую контактную информацию списка контактов. Для этого необходимо добавить четыре текстовых поля "JTextField", в которых будет содержаться контактная информация, и четыре компонента "JLabel" для описания содержимого этих полей. При выполнении этого действия обратите внимание на горизонтальные и вертикальные направляющие, выводимые GUI Builder, которые отображают предпочтительное расстояние между компонентами согласно общему стилю операционной системы. Таким образом обеспечивается соответствие между создаваемым графическим интерфейсом и общим стилем операционной системы во время выполнения.
-|===
-|Добавление компонента JLabel в форму:
+
+Добавление компонента JLabel в форму:
1. В окне "Палитра" выберите компонент "Label" (Метка) из категории "Элементы управления Swing".
2. Переместите курсор на панель "JPanel" ``Name`` , созданную ранее. После появления направляющих, указывающих на размещение компонента "JLabel" в верхнем левом углу панели "JPanel" с небольшим полем у верхней и левой границ, щелкните кнопкой мыши для подтверждения расположения нового компонента.
@@ -270,12 +261,12 @@
К форме будет добавлен компонент "JLabel", а в окне "Инспектор" появится соответствующий узел.
-|===
+
Перед переходом к следующему действию необходимо отредактировать отображаемый текст в только что добавленном компоненте "JLabel". Несмотря на то, что этот текст можно изменить в любое время, проще всего это сделать при добавлении компонента.
-|===
-|Редактирование отображаемого текста компонента "JLabel"
+
+Редактирование отображаемого текста компонента "JLabel"
1. Дважды щелкните компонент "JLabel" для выбора отображаемого текста.
2. Введите ``First Name:`` и нажмите ENTER.
@@ -283,12 +274,12 @@
Будет выведено новое имя "JLabel", и ширина компонента будет изменена в соответствии с новым текстом.
-|===
+
Теперь следует добавить текстовое поле "JTextField", на примере которого можно рассмотреть функцию выравнивания по базовой линии в GUI Builder.
-|===
-|Добавление компонента "JLabel" в форму
+
+Добавление компонента "JLabel" в форму
1. В окне "Палитра" выберите компонент "Text field" (Текстовое поле) из категории "Элементы управления Swing".
2. Переместите курсор непосредственно к правому краю только что добавленного компонента "JLabel" ``First Name:`` . При появлении горизонтальной направляющей, указывающей на выравнивание базовой линии поля "JTextField" по базовой линии компонента "JLabel", и вертикальной направляющей, определяющей интервал между этими двумя компонентами, щелкните кнопкой мыши для подтверждения позиции "JTextField".
@@ -296,7 +287,7 @@
Компонент "JTextField" размещается в форме в позиции, выровненной по базовой линии "JLabel", как изображено на следующем рисунке. Обратите внимание на то, что компонент "JLabel" был немного смещен вниз с целью его выравнивания по базовой линии текстового поля, расположенной чуть выше. Узел, который представляет компонент, добавлен в окно "Навигатор", как обычно.
-|===
+
image::images/03_indy_add_1.png[]
@@ -304,8 +295,8 @@
image::images/03_indy_add_2.png[]
-|===
-|Изменение размера компонента "JTextField"
+
+Изменение размера компонента "JTextField"
1. Выберите только что добавленный компонент "JTextField" справа от компонента "JLabel" ``Last Name:`` .
2. Перетащите метку-манипулятор правого края компонента "JTextField" к правой границе панели JPanel.
@@ -314,7 +305,7 @@
Правая граница компонента "JTextField" будет выровнена по предложенной границе поля панели "JPanel", как показано на следующем рисунке.
-|===
+
image::images/03_indy_add_3.png[]
@@ -323,8 +314,8 @@
Теперь добавьте в форму компоненты "JLabel" ``Title:`` и ``Nickname:`` , описывающие два текстовых поля "JTextField", которые также будут добавлены. Перетащите компоненты, удерживая нажатой клавишу SHIFT, чтобы быстрее добавить их на форму. При этом в GUI Builder снова появятся соответствующие горизонтальные и вертикальные направляющие, указывающие на предпочтительное размещение компонента.
-|===
-|Для добавления нескольких компонентов "JLabel" в форму выполните действия, описываемые ниже.
+
+Для добавления нескольких компонентов "JLabel" в форму выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Label" (Метка) из категории "Элементы управления Swing", нажав и отпустив кнопку мыши.
2. Переместите курсор в форме непосредственно под ранее добавленным компонентом "JLabel" ``First Name:`` . При появлении направляющих, указывающих на выравнивание левой границы нового компонента "JLabel" по границе компонента "JLabel", расположенного выше, и при наличии небольшого пространства между этими компонентами, щелкните кнопкой мыши при нажатой клавише SHIFT для фиксации расположения первого компонента "JLabel".
@@ -333,14 +324,14 @@
Компоненты "JLabel" будут добавлены к форме и образуют второй ряд, как показано на рисунке ниже. Узлы, представляющие каждый компонент, добавлены в окно "Навигатор".
-|===
+
image::images/04_multi-add_1.png[]
Перед следующим действием необходимо изменить имя компонента "JLabel", что позволит проверить результаты выравнивания, которое будет произведено чуть позже.
-|===
-|Для редактирования отображаемого текста компонента "JLabel" выполните действия, описываемые ниже.
+
+Для редактирования отображаемого текста компонента "JLabel" выполните действия, описываемые ниже.
1. Дважды щелкните компонент "JLabel" для выбора отображаемого текста.
2. Введите ``Title:`` и нажмите ENTER.
@@ -349,7 +340,7 @@
Новые имена компонентов "JLabel" будут выведены в форме и смещены в результате изменения ширины текста, как изображено на рисунке ниже.
-|===
+
image::images/04_multi-add_2.png[]
@@ -360,8 +351,8 @@
Часто требуется вставить компонент между двумя уже размещенными в форме компонентами. При каждом добавлении компонента между двумя существующими компонентами GUI Builder автоматически смещает их для освобождения пространства для нового компонента. Для наглядности вставим компонент "JTextField" между уже добавленными компонентами "JLabel", как изображено на двух следующих рисунках.
-|===
-|Для вставки компонента "JTextField" между компонентами "JLabel" выполните действия, описываемые ниже.
+
+Для вставки компонента "JTextField" между компонентами "JLabel" выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Text field" (Текстовое поле) из категории "Элементы управления Swing".
2. Наведите курсор на компоненты JLabel ``Title:`` и ``Nickname:`` во втором ряду, что приведет к наложению поля "JTextField" на эти компоненты и выравниванию согласно их базовым линиям. В случае возникновения трудностей с размещением нового текстового поля можно привязать его к левой направляющей компонента "JLabel" ``Nickname`` , как показано на первом рисунке ниже.
@@ -370,22 +361,22 @@
Поле "JTextField" будет привязано к позиции между двумя компонентами "JLabel". Крайний правый компонент "JLabel" сдвигается к правой границе "JTextField" для соответствия рекомендуемому смещению по горизонтали.
-|===
-|===
-|image::images/05_insert_1.png[]
- |
+
+image::images/05_insert_1.png[]
+
+
image::images/05_insert_2.png[]
-|===
+
Теперь необходимо добавить к форме еще один компонент "JTextField", отображающий имя контакта в правой части формы.
-|===
-|Для добавления компонента "JTextField" выполните действия, описываемые ниже.
+
+Для добавления компонента "JTextField" выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Text field" (Текстовое поле) в категории "Swing".
2. Переместите курсор вправо от метки ``Nickname`` и щелкните кнопкой мыши для размещения текстового поля.
@@ -393,31 +384,29 @@
Поле "JTextField" будет привязано к позиции слева от компонента JLabel.
-|===
-|===
-|Изменение размера компонента "JTextField"
+
+
+Изменение размера компонента "JTextField"
1. Перетащите метки-манипуляторы поля "JTextField" метки ``Nickname:`` , добавленного в предыдущей задаче, к правой границе панели "JPanel".
2. При появлении вертикальных направляющих, отображающих расстояние между текстовым полем и краями панели "JPanel", отпустите кнопку мыши для изменения размеров поля "JTextField".
Правая граница компонента "JTextField" выравнивается согласно рекомендуемому размеру поля панели JPanel, и в GUI Builder выполняется соответствующая корректировка размеров.
-3. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=3]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
-|===
-----
-<<top,В начало>>
+
== Дальнейшие действия
Выравнивание – это один из наиболее важных аспектов создания профессионального графического интерфейса. В предыдущем разделе было приведено общее описание работы с функциями выравнивания в среде IDE при добавлении компонентов "JLabel" и "JTextField" к форме "ContactEditorUI". Далее будут представлены более подробные сведения о функциях выравнивания GUI Builder на примере использования других компонентов, необходимых для приложения.
-[quote]
-----
=== Выравнивание компонентов
@@ -425,8 +414,8 @@
При каждом добавлении компонента в форму позиция этого компонента корректируется в GUI Builder согласно появляющимся на экране направляющим. Однако иногда требуется изменить отношения между группами компонентов. В предыдущих действиях мы добавили к графическому интерфейсу ContactEditor четыре компонента "JLabel", однако для них не было выполнено выравнивание. Выровняйте два столбца этих компонентов по правому краю.
-|===
-|Для выравнивания компонентов выполните действия, описываемые ниже.
+
+Для выравнивания компонентов выполните действия, описываемые ниже.
1. Нажмите клавишу ``CTRL`` и щелкните кнопкой мыши для выбора компонентов "JLabel" ``First Name:`` и ``Title:`` левой части формы.
2. Нажмите кнопку "Выравнивание направо в столбце" (image::images/align_r.png[]) на панели инструментов. Также можно щелкнуть правой кнопкой мыши и выбрать команды "Выровнять" > "Направо" во всплывающем меню.
@@ -435,12 +424,12 @@
Позиции компонентов "JLabel" будут выровнены по правой границе отображаемого текста. Точки привязки будут обновлены, указывая на объединение компонентов в группу.
-|===
+
Перед завершением позиционирования текстовых полей "JTextField", ранее вставленных между компонентами "JLabel", убедитесь, что для этих компонентов правильно настроена корректировка размеров. В отличие от двух полей "JTextField", которые были выровнены по правому краю формы, функция изменения размера для вставляемых компонентов не установлена автоматически.
-|===
-|Для установки функции изменения размера компонента выполните действия, описываемые ниже.
+
+Для установки функции изменения размера компонента выполните действия, описываемые ниже.
1. Нажмите клавишу CTRL и щелкните кнопкой мыши два вставленных компонента "JTextField" для их выбора в GUI Builder.
2. После выбора обоих полей "JTextField" щелкните правой кнопкой мыши любой из них и выберите команды "Автоматическое изменение размера" > "Горизонтально" во всплывающем меню.
@@ -448,10 +437,10 @@
Для компонентов "JTextField" будет установлена функция автоматического изменения размера по горизонтали во время выполнения. Направляющие и точки привязки будут обновлены, предоставляя визуальное средство поддержки для отношений компонентов.
-|===
-|===
-|Для настройки одинакового размера компонентов выполните действия, перечисленные ниже.
+
+
+Для настройки одинакового размера компонентов выполните действия, перечисленные ниже.
1. Нажмите клавишу CTRL и выберите каждый из четырех компонентов "JTextField" в форме.
2. Щелкните любой из отмеченных компонентов "JTextField" правой кнопкой мыши и выберите элементы "Установить одинаковый размер" > "Одинаковая ширина" из всплывающего меню.
@@ -459,12 +448,12 @@
Для всех компонентов "JTextField" будет установлена одинаковая ширина и к верхней границе каждого компонента будет добавлен индикатор, визуально поддерживающий отношения между компонентами.
-|===
+
Теперь необходимо добавить еще один компонент "JLabel", содержащий описание компонента "JComboBox", который позволит пользователям выбирать формат вывода данных в приложении ContactEditor.
-|===
-|Для выравнивания "JLabel" в соответствии с позицией группы компонентов выполните действия, описываемые ниже.
+
+Для выравнивания "JLabel" в соответствии с позицией группы компонентов выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Label" (Метка) из категории "Swing".
2. Переместите курсор под компонентами "JLabel" ``First Name`` и ``Title`` в левой части панели "JPanel". После отображения направляющей, указывающей на выравнивание правой границы нового компонента "JLabel" по правому краю расположенной выше группы компонентов (два компонента "JLabel"), щелкните для подтверждения позиции компонента.
@@ -472,7 +461,7 @@
Компонент "JLabel" выравнивается по правому краю относительно столбца "JLabel", расположенного выше, как показано на следующем рисунке. GUI Builder обновляет линии выравнивания, указывающие на отношения интервалов и привязок компонента.
-|===
+
[.feature]
--
@@ -488,8 +477,8 @@
Теперь необходимо добавить поле со списком, позволяющее пользователям выбирать формат данных, отображаемых в приложении ContactEditor. При добавлении поля "JComboBox" его базовая линия будет выровнена по базовой линии текста в "JLabel". Обратите внимание на появляющиеся на экране направляющие, упрощающие позиционирование компонента.
-|===
-|Для выравнивания базовых линий компонентов выполните действия, перечисленные ниже.
+
+Для выравнивания базовых линий компонентов выполните действия, перечисленные ниже.
1. В окне "Палитра" выберите компонент "Combo Box" (Поле со списком) из категории "Элементы управления Swing".
2. Переместите курсор непосредственно к правому краю только что добавленного компонента "JLabel". При появлении горизонтальной направляющей, указывающей на выравнивание базовой линии поля "JComboBox" по базовой линии текста в компоненте "JLabel", и вертикальной направляющей, определяющей интервал между этими двумя компонентами, щелкните кнопкой мыши для подтверждения позиции поля со списком.
@@ -497,15 +486,15 @@
Компонент фиксируется в положении с выравниванием по базовой линии текста в "JLabel" слева, как показано на следующем рисунке. GUI Builder отображает линии выравнивания, указывающие на отношения интервалов и привязок компонента.
-|===
+
[.feature]
--
image::images/06_align_2-small.png[role="left", link="images/06_align_2.png"]
--
-|===
-|Для изменения размера поля со списком "JComboBox" выполните следующие действия.
+
+Для изменения размера поля со списком "JComboBox" выполните следующие действия.
1. Выберите компонент "ComboBox" в GUI Builder.
2. Перетащите метку-манипулятор на правой границе компонента "JComboBox" вправо, пока на экране не появятся направляющие, которые обозначают рекомендуемый интервал между границами "JPanel" и "JComboBox".
@@ -517,16 +506,16 @@
image::images/06_align_3-small.png[role="left", link="images/06_align_3.png"]
--
-3. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=3]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
-|===
+
Описание способов изменения моделей компонентов выходит за рамки задач данного учебного курса, поэтому список компонентов "JComboBox" будет оставлен без изменений.
-----
-<<top,В начало>>
== Обзор полученных навыков
@@ -535,15 +524,13 @@
До сих пор акцент ставился на добавлении компонентов к интерфейсу ContactEditor при помощи направляющих, позволяющих оптимизировать процесс позиционирования компонентов. Еще одним важным средством поддержки для расположения компонентов является функция точек привязки. Несмотря на то, что эта тема не была затронута, в одном из предыдущих примеров эта функция уже использовалась. Как было указано ранее, при каждом добавлении компонента к форме среда IDE предлагает предпочтительный вариант его расположения, обозначаемый при помощи направляющих. После размещения новые компоненты также привязываются к ближайшей границе контейнера или компоненту с целью сохранения корректных отношений между ними во время выполнения. В этом разделе будет рассмотрен более удобный способ выполнения подобных задач с кратким описанием внутреннего механизма работы GUI Builder.
-[quote]
-----
=== Добавление, выравнивание и привязка
GUI Builder позволяет быстро и удобно установить расположение компонентов формы за счет рационализации типичных операций. При каждом добавлении компонента к форме GUI Builder автоматически фиксирует его в предпочтительной позиции и устанавливает необходимые связи, позволяя пользователю сконцентрироваться на проектировании форм вместо изучения сложных деталей реализации.
-|===
-|Для добавления, выравнивания и редактирования отображаемого текста "JLabel" выполните действия, описываемые ниже.
+
+Для добавления, выравнивания и редактирования отображаемого текста "JLabel" выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Label" (Метка) из категории "Элементы управления Swing".
2. Переместите курсор в форме непосредственно под нижний заголовок "E-mail" на панели "JPanel". После появления направляющих, указывающих на размещение компонента "JLabel" в верхнем левом углу панели "JPanel" с небольшим полем у верхней и левой границ, щелкните кнопкой мыши для подтверждения расположения нового компонента.
@@ -552,27 +539,29 @@
Компонент "JLabel" будет зафиксирован в предпочтительной позиции в форме с привязкой к верхнему и левому краям панели "JPanel". Как обычно, соответствующий узел показывает, что компонент был добавлен в окно "Навигатор".
-|===
-|===
-|Для добавления компонента "JTextField" выполните действия, описываемые ниже.
+
+
+Для добавления компонента "JTextField" выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Text field" (Текстовое поле) из категории "Элементы управления Swing".
2. Переместите курсор непосредственно к правому краю только что добавленной метки ``E-mail Address`` . При появлении направляющих, указывающих на выравнивание базовой линии поля "JTextField" по базовой линии текста в компоненте "JLabel", и вертикальной направляющей, определяющей поле между этими двумя компонентами, щелкните кнопкой мыши для подтверждения позиции текстового поля.
Поле "JTextField" будет зафиксировано в позиции справа от компонента "JLabel" ``E-mail Address:`` и привязано к этому компоненту. В окне "Inspector" появится соответствующий узел.
-3. Перетащите метку-манипулятор компонента "JTextField" к правой границе панели "JPanel" до появления на экране направляющих, обозначающих рекомендуемый интервал между границами "JTextField" и "JPanel".
+
+[start=3]
+. Перетащите метку-манипулятор компонента "JTextField" к правой границе панели "JPanel" до появления на экране направляющих, обозначающих рекомендуемый интервал между границами "JTextField" и "JPanel".
Правая граница "JTextField" привязывается к направляющей, отображающей предпочтительные поля.
-|===
+
Теперь необходимо добавить компонент "JList", в котором будет отображаться весь список контактов ContactEditor.
-|===
-|Для добавления и изменения размеров компонента "JList" выполните действия, описываемые ниже.
+
+Для добавления и изменения размеров компонента "JList" выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "List" (Список) из категории "Элементы управления Swing".
2. Наведите курсор в позицию непосредственно под ранее добавленным компонентом "JLabel" ``E-mail Address`` . При появлении направляющих, указывающей на то, что верхняя и правая границы компонента "JList" выровнены согласно предпочтительным полям по левому краю панели "JPanel" и расположенному выше компоненту "JLabel", щелкните для подтверждения позиции списка.
@@ -581,7 +570,7 @@
Компонент "JList" будет зафиксирован в позиции, обозначенной направляющими, и в окне "Инспектор" появится соответствующий узел. Обратите также внимание на то, что форма расширяется для размещения нового компонента "JList".
-|===
+
[.feature]
--
@@ -597,19 +586,19 @@
Часто ряд связанных компонентов, например, кнопок в модальных диалогах, должен иметь один и тот же размер для обеспечения непротиворечивого визуального представления. Для наглядности добавим в форму "ContactEditor" четыре кнопки "JButton", которые будут использоваться для добавления, изменения и удаления отдельных записей из нашего списка контактов, как показано на рисунках ниже. По завершении кнопки будут настроены таким образом, чтобы они имели одинаковый размер и отражали связанную с ними функциональную возможность.
-|===
-|Для добавления, выравнивания и редактирования отображаемого текста нескольких кнопок выполните действия, описываемые ниже.
+
+Для добавления, выравнивания и редактирования отображаемого текста нескольких кнопок выполните действия, описываемые ниже.
1. В окне "Палитра" выберите компонент "Button" (Кнопка) из категории "Элементы управления Swing".
2. Разместите кнопку "JButton" над правой границей поля "JTextField" ``E-mail Address`` на нижней панели "JPanel". При появлении направляющих, указывающих на выравнивание базовой линии и правой границы кнопки "JButton" по полю "JTextField", щелкните кнопкой мыши при нажатой клавише SHIFT для позиционирования первой кнопки у правого края компонента "JFrame". После того как кнопка мыши будет отпущена, ширина "JTextField" будет уменьшена для размещения кнопки "JButton".
-|===
-|[.feature]
+
+[.feature]
--
image::images/buttons_1-small.png[role="left", link="images/buttons_1.png"]
--
- |
+
[.feature]
--
@@ -617,22 +606,26 @@
--
-|===
-3. Наведите курсор на верхний правый угол списка "JList" на нижней панели "JPanel". При появлении направляющих, указывающих на выравнивание верхней и правой границ кнопки "JButton" по верхней и правой границам поля "JTextField", щелкните кнопкой мыши при нажатой клавише SHIFT для размещения второй кнопки у правого края компонента "JFrame".
+[start=3]
+. Наведите курсор на верхний правый угол списка "JList" на нижней панели "JPanel". При появлении направляющих, указывающих на выравнивание верхней и правой границ кнопки "JButton" по верхней и правой границам поля "JTextField", щелкните кнопкой мыши при нажатой клавише SHIFT для размещения второй кнопки у правого края компонента "JFrame".
[.feature]
--
image::images/buttons_3-small.png[role="left", link="images/buttons_3.png"]
--
-4. Добавьте еще две кнопки "JButton" в позицию под ранее добавленными кнопками так, чтобы они образовали столбец. Эти кнопки должны размещаться с учетом требуемых интервалов, которые должны иметь одинаковый размер. В случае удерживания клавиши SHIFT во время размещения последней кнопки "JButton" можно нажать клавишу Escape для отмены действия.
+
+[start=4]
+. Добавьте еще две кнопки "JButton" в позицию под ранее добавленными кнопками так, чтобы они образовали столбец. Эти кнопки должны размещаться с учетом требуемых интервалов, которые должны иметь одинаковый размер. В случае удерживания клавиши SHIFT во время размещения последней кнопки "JButton" можно нажать клавишу Escape для отмены действия.
[.feature]
--
image::images/buttons_4-small.png[role="left", link="images/buttons_4.png"]
--
-5. Установите отображаемый текст для каждой кнопки "JButton". (Для изменения текста кнопки щелкните кнопку правой кнопкой мыши и выберите "Edit Text". В качестве альтернативы можно щелкнуть кнопку, выдержать паузу и щелкнуть еще раз.) Введите значение `Add` для верхней кнопки, `Edit` для второй, `Remove` для третьей и `As Default` для четвертой.
+
+[start=5]
+. Установите отображаемый текст для каждой кнопки "JButton". (Для изменения текста кнопки щелкните кнопку правой кнопкой мыши и выберите "Edit Text". В качестве альтернативы можно щелкнуть кнопку, выдержать паузу и щелкнуть еще раз.) Введите значение `Add` для верхней кнопки, `Edit` для второй, `Remove` для третьей и `As Default` для четвертой.
Компоненты "JButton" будут привязаны к позициям, обозначенным направляющими. Ширина кнопок будет изменена для размещения новых имен.
@@ -642,12 +635,12 @@
--
-|===
+
Теперь, после установки местоположения кнопок, следует установить для них поддержание одинакового размера для обеспечения непротиворечивого визуального представления, а также указать на их функциональные связи.
-|===
-|Для настройки одинакового размера компонентов выполните действия, перечисленные ниже.
+
+Для настройки одинакового размера компонентов выполните действия, перечисленные ниже.
1. Выделите все четыре кнопки с помощью мыши, удерживая нажатой клавишу CTRL.
2. Щелкните правой кнопкой мыши одну из них и выберите "Одинаковый размер" > "Одинаковая ширина" во всплывающем меню.
@@ -660,7 +653,7 @@
--
-|===
+
=== Отступ
@@ -669,8 +662,8 @@
В этом разделе будет рассмотрено добавление нескольких переключателей "JRadioButton" под компонентом "JLabel". Эти переключатели предназначены для настройки пользователем способа отображения данных в приложении. При выполнении этой процедуры обратитесь к рисункам, расположенным ниже, или щелкните ссылку "Демонстрация" для просмотра интерактивной демонстрации.
-|===
-|Для добавления отступа под компонентом "JLabel" для размещения переключателей "JRadioButton" выполните действия, описываемые ниже.
+
+Для добавления отступа под компонентом "JLabel" для размещения переключателей "JRadioButton" выполните действия, описываемые ниже.
1. Добавьте в форму компонент "JLabel" с именем ``Mail Format`` под списком "JList". Убедитесь, что этот компонент выровнен по левому краю списка.
2. В окне "Палитра" выберите компонент "Список" в категории "Swing".
@@ -681,8 +674,12 @@
image::images/07_indent_1-small.png[role="left", link="images/07_indent_1.png"]
--
-4. Переместите курсор вправо от первого компонента "JRadioButton". Щелкните мышью при нажатой клавише SHIFT для размещения второго и третьего переключателей, учитывая при этом рекомендуемый интервал между этими компонентами. Перед размещением последнего компонента "JRadioButton" отпустите клавишу SHIFT.
-5. Установите отображаемый текст для каждого переключателя "JRadioButton". (Для изменения текста кнопки щелкните кнопку правой кнопкой мыши и выберите "Edit Text". В качестве альтернативы можно щелкнуть кнопку, выдержать паузу и щелкнуть еще раз.) Введите значение `HTML` для крайнего переключателя слева, `Plain Text ` для второго переключателя и `Custom` для третьего.
+
+[start=4]
+. Переместите курсор вправо от первого компонента "JRadioButton". Щелкните мышью при нажатой клавише SHIFT для размещения второго и третьего переключателей, учитывая при этом рекомендуемый интервал между этими компонентами. Перед размещением последнего компонента "JRadioButton" отпустите клавишу SHIFT.
+
+[start=5]
+. Установите отображаемый текст для каждого переключателя "JRadioButton". (Для изменения текста кнопки щелкните кнопку правой кнопкой мыши и выберите "Edit Text". В качестве альтернативы можно щелкнуть кнопку, выдержать паузу и щелкнуть еще раз.) Введите значение `HTML` для крайнего переключателя слева, `Plain Text ` для второго переключателя и `Custom` для третьего.
Итак, в форму добавлены три компонента "JRadioButton", которые расположены под компонентом "JLabel" ``Mail Format`` с требуемым отступом.
@@ -692,12 +689,12 @@
--
-|===
+
Теперь необходимо добавить три переключателя "JRadioButton" к группе кнопок "ButtonGroup", что позволит установить требуемое поведение, согласно которому в один момент времени может быть выбран только один переключатель. Это обеспечит отображение контактной информация приложения ContactEditor в выбранном пользователем формате.
-|===
-|Для добавления переключателей "JRadioButtons" к группе "ButtonGroup" выполните действия, перечисленные ниже.
+
+Для добавления переключателей "JRadioButtons" к группе "ButtonGroup" выполните действия, перечисленные ниже.
1. В окне "Палитра" выберите компонент "Группа кнопок" из категории "Элементы управления Swing".
2. Щелкните в любом месте в рамках области проектирования GUI Builder для добавления компонента "ButtonGroup" к форме. Заметим, что компонент "ButtonGroup" не появляется на форме сам по себе, однако, он отображается в области "Другие компоненты навигатора".
@@ -711,28 +708,23 @@
image::images/07_group-small.png[role="left", link="images/07_group.png"]
--
-5. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=5]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
-|===
-
-----
-
-<<top,В начало>>
== Заключительная настройка
Итак, пользовательский интерфейс приложения ContactEditor практически готов, однако необходимо добавить к нему еще несколько компонентов. В этом разделе описываются некоторые типичные задачи по компоновке интерфейса, выполняемые при помощи GUI Builder.
-[quote]
-----
=== Последние штрихи
Теперь необходимо добавить кнопки, позволяющие пользователям подтверждать информацию, вводимую для определенного контакта, и добавлять ее в список контактов или отменять операцию без внесения изменений в базу данных. В этом действии будут добавлены две необходимые кнопки, а также рассмотрена настройка для них одинакового размера в форме даже при различной длине отображаемого текста.
-|===
-|Для добавления и редактирования отображаемого на кнопках текста выполните действия, описываемые ниже.
+
+Для добавления и редактирования отображаемого на кнопках текста выполните действия, описываемые ниже.
1. Если нижняя панель "JPanel" расширена до нижней границы формы "JFrame", перетащите нижний край компонента "JFrame" вниз. В результате между границей "JFrame" и краем панели "JPanel" появится пространство для кнопок "ОК" и "Cancel".
2. В окне "Палитра" выберите компонент "Button" (Кнопка) из категории "Элементы управления Swing".
@@ -743,9 +735,15 @@
image::images/08_cancel-small.png[role="left", link="images/08_cancel.png"]
--
-4. Добавьте еще одну кнопку "JButton" слева от первой с учетом необходимого пространства до нижнего края компонента "JFrame".
-5. Установите отображаемый текст для каждой кнопки "JButton". Введите значение ``ОК`` для левой кнопки и ``Cancel`` для правой. Обратите внимание, что ширина кнопок изменяется для размещения новых имен.
-6. Настройте сохранение одинакового размера для кнопок "JButton". Для этого выделите обе кнопки, щелкните правой кнопкой мыши одну из них и выберите "Одинаковый размер" > "Одинаковая ширина" во всплывающем меню.
+
+[start=4]
+. Добавьте еще одну кнопку "JButton" слева от первой с учетом необходимого пространства до нижнего края компонента "JFrame".
+
+[start=5]
+. Установите отображаемый текст для каждой кнопки "JButton". Введите значение ``ОК`` для левой кнопки и ``Cancel`` для правой. Обратите внимание, что ширина кнопок изменяется для размещения новых имен.
+
+[start=6]
+. Настройте сохранение одинакового размера для кнопок "JButton". Для этого выделите обе кнопки, щелкните правой кнопкой мыши одну из них и выберите "Одинаковый размер" > "Одинаковая ширина" во всплывающем меню.
[.feature]
--
@@ -754,16 +752,15 @@
Компоненты ``JButton`` появляются в форме, и соответствующие им узлы отображаются в окне "Навигатор". К исходному файлу формы также будет добавлен код компонентов ``JButton`` , что отображается в представлении "Source" редактора. Размер кнопок "JButton" будет скорректирован по размеру кнопки с самым длинным именем.
-7. Для сохранения файла нажмите сочетание клавиш CTRL+S.
+
+[start=7]
+. Для сохранения файла нажмите сочетание клавиш CTRL+S.
-|===
+
Последней необходимой операцией является удаление текста заполнителя из различных компонентов. Несмотря на то, что удаление этих текстов только после построения общей структуры формы позволяет избежать проблем с выравниванием компонентов и установкой их привязок, большинство разработчиков обычно удаляют этот текст еще в процессе размещения компонентов в форме. Последовательно выделите и удалите текст заполнителя для каждого поля "JTextField" в форме. Тексты компонентов "JComboBox" и "JList" еще потребуются для работы со следующим учебным курсом.
-----
-
-<<top,В начало>>
== Предварительной просмотр графического интерфейса
@@ -775,7 +772,7 @@
image::images/08_preview_gui-small.png[role="left", link="images/08_preview_gui.png"]
--
-<<top,В начало>>
+
== Развертывание приложений с графическим интерфейсом
@@ -787,8 +784,6 @@
При выполнении среды IDE на базе пакета JDK 6 автоматически создается код приложения с возможностью использования классов GroupLayout, существующих в Java SE 6. То есть отсутствует необходимость добавления в пакет приложения библиотеки Swing Layout Extensions для развертывания приложения в системах с установленной средой Java SE 6.
*Примечание.* При создании приложения с помощью JDK 6 и необходимости поддержки запуска приложения в Java SE 5, можно настроить в IDE создание кода для использования библиотеки Swing Layout Extensions вместо классов в Java SE 6. Откройте класс ContactEditorUI в редакторе графического интерфейса. В окне "Навигатор" щелкните правой кнопкой мыши по узлу "Форма ContactEditorUI" и выберите "Свойства" во всплывающем меню. В диалоговом окне "Свойства" измените значение свойства "Layout Generation Style" (Стиль создания размещения) на "Swing Layout Extensions Library" (Библиотека расширений размещения Swing).
-[quote]
-----
=== Подготовка дистрибутива и запуск отдельных приложений с графическим интерфейсом.
@@ -803,23 +798,23 @@
1. Перейдите к папке ``dist`` проекта.
2. Введите следующее значение:
-[quote]
-----
- ``java -jar <jar_name>.jar``
-----
+[source,java]
+----
+java -jar <jar_name>.jar
----
*Примечание.* При возникновении следующей ошибки:
-[quote]
+
+[source,bash]
----
- ``Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group``
+Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group
----
Убедитесь, что в файле ``manifest.mf`` существует ссылка на текущую установленную версию библиотеки Swing Layout Extensions.
-<<top,В начало>>
+
link:/about/contact_form.html?to=3&subject=Feedback:%20Designing%20a%20Swing%20GUI%20in%20NetBeans%20IDE[+Отправить отзыв по этому учебному курсу+]
@@ -835,5 +830,5 @@
* link:../../trails/matisse.html[+Учебная карта по приложениям с графическим интерфейсом Java +]
* link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG920[+Реализация Java GUI+] в документе _Разработка приложений в IDE NetBeans_
-<<top,В начало>>
+
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_zh_CN.asciidoc
index 7e6be0a..05675db 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart-gui_zh_CN.asciidoc
@@ -39,16 +39,15 @@
-
*要学完本教程，您需要具备以下软件和资源。*
-|===
-|软件或资源 |要求的版本
-|link:http://netbeans.org/downloads/index.html[+NetBeans IDE+] |版本 6.9 及更高版本
+软件或资源要求的版本
-|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java 开发工具包 (JDK)+] |版本 6、7 或 8
-|===
+link:http://netbeans.org/downloads/index.html[+NetBeans IDE+]版本 6.9 及更高版本
+
+link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Java 开发工具包 (JDK)+]版本 6、7 或 8
+
== 入门指南
@@ -57,15 +56,12 @@
有关 GUI 构建器可视反馈的描述，可参见 link:quickstart-gui-legend.html[+GUI 构建器可视反馈图例+]。
-[quote]
-----
-
=== 创建项目
由于 IDE 中的所有 Java 开发都是在项目内进行的，因此我们首先需要新建一个用来存储源文件及其他项目文件的 ``ContactEditor`` 项目。IDE 项目是一组 Java 源文件，外加与其关联的元数据，其中包括特定于项目的属性文件、控制构建和运行设置的 Ant 构建脚本以及一个将 Ant 目标映射到 IDE 命令的 ``project.xml`` 文件。尽管 Java 应用程序通常包括几个 IDE 项目，但是，在本教程中，我们将构建一个完全存储在单个项目中的简单应用程序。
-|===
-|要创建新的 ``ContactEditor`` 应用程序项目，请执行以下操作：
+
+要创建新的 ``ContactEditor`` 应用程序项目，请执行以下操作：
1. 选择“文件”>“新建项目”。或者，也可以单击 IDE 工具栏中的“新建项目”图标。
2. 在“类别”窗格中选择 "Java" 节点，在“项目”窗格中选择“Java 应用程序”。单击“下一步”。
@@ -77,30 +73,34 @@
IDE 在系统上的指定位置创建 ``ContactEditor`` 文件夹。此文件夹包含项目的所有关联文件，其中包括其 Ant 脚本、用于存储源文件和测试的文件夹以及用于存储特定于项目的元数据的文件夹。要查看项目结构，请使用 IDE 的“文件”窗口。
-|===
+
=== 创建 JFrame 容器
创建新应用程序后，您可能已注意到“项目”窗口中的“源包”文件夹包含一个空的 ``<默认包>`` 节点。要继续构建界面，我们需要创建一个 Java 容器，以便放置所需的其他 GUI 组件。在此步骤中，我们将使用 ``JFrame`` 组件创建一个容器，并将该容器置于一个新包中。
-|===
-|要添加 ``JFrame`` 容器，请执行以下操作：
+
+要添加 ``JFrame`` 容器，请执行以下操作：
1. 在“项目”窗口中，右键单击 ``ContactEditor`` 节点，然后选择“新建”>“JFrame 窗体”。
此外，也可以选择“新建”>“其他”>“Swing GUI 窗体”>“JFrame 窗体”以查找 JFrame 窗体。
-2. 输入 ``ContactEditorUI`` 作为类名。
-3. 在“包”中输入 ``my.contacteditor`` 。
-4. 单击“完成”。
+
+[start=2]
+. 输入 ``ContactEditorUI`` 作为类名。
+
+[start=3]
+. 在“包”中输入 ``my.contacteditor`` 。
+
+[start=4]
+. 单击“完成”。
IDE 在 ``ContactEditorUI.java`` 应用程序内创建 ``ContactEditorUI`` 窗体和 ``ContactEditorUI`` 类，并在 GUI 构建器中打开 ``ContactEditorUI`` 窗体。请注意， ``my.contacteditor`` 包取代了默认包。
-|===
-----
-<<top,返回页首>>
+
== 熟悉 GUI 构建器
@@ -127,15 +127,13 @@
*注：*还有一个供高级开发者使用的 "Palette Manager"（组件面板管理器），使用该管理器可以将 JAR、库或其他项目中的定制组件添加到 "Palette"（组件面板）中。要通过组件面板管理器添加定制组件，请选择 "Tools"（工具）> "Palette"（组件面板）> "Swing/AWT Components"（Swing/AWT 组件）。
-<<top,返回页首>>
+
== 主要概念
通过简化创建图形界面的工作流，IDE 的 GUI 构建器解决了创建 Java GUI 的核心问题，从而使开发者不必再使用复杂的 Swing 布局管理器。这一点是通过扩展目前的 NetBeans IDE GUI 构建器功能以支持直观的“自由设计”模式（具有易于理解和使用的简单布局规则）来实现的。设置窗体布局时，GUI 构建器将提供可视基准线，用于建议最佳组件间距和对齐方式。在后台，GUI 构建器会将您的设计理念转化为使用新的 GroupLayout 布局管理器和其他 Swing 结构实现的功能性 UI。由于它使用动态布局模型，因此使用 GUI 构建器构建的 GUI 在运行时将按预期方式工作，同时会在不改变组件之间的定义关系的情况下进行相应的调整以适应所做的任何更改。只要您调整窗体大小、转换语言环境或指定不同的外观，GUI 就会根据目标外观的插入和偏移量自动进行调整。
-[quote]
-----
=== 自由设计
@@ -152,9 +150,8 @@
GUI 构建器还提供有关组件锚点和链接关系的可视反馈。通过这些指示符，可以快速识别各种定位关系和组件锁定行为，这些关系和行为将影响 GUI 在运行时的显示和行为方式。这加快了 GUI 的设计过程，使您能够快速创建具有专业外观和相应功能的可视界面。
-----
-<<top,返回页首>>
+
== 先打基础
@@ -163,8 +160,6 @@
有了 IDE 的“自由设计”模式，您将不必再费力地使用布局管理器来控制容器内组件的大小和位置。只需将所需的组件拖放至 GUI 窗体中，如下面提供的各图所示。
-[quote]
-----
*注：*有关以下部分的交互式演示，请观看link:http://bits.netbeans.org/media/quickstart-gui-add.swf[+添加单个和多个组件 (.swf)+] 截屏视频。
@@ -174,8 +169,8 @@
由于我们已经将 JFrame 添加为窗体的顶层容器，因此下一步需要添加几个 JPanel，以便使用带标题的边框将 UI 的多个组件归到其中。请参见以下各图，并注意在完成此操作时 IDE 的“拖放”行为。
-|===
-|添加 JPanel：
+
+添加 JPanel：
1. 在 "Palette"（组件面板）窗口中，通过单击并松开鼠标按钮，从 "Swing Containers"（Swing 容器）类别中选择 "Panel"（面板）组件。
2. 将光标移到 GUI 构建器中窗体的左上角。当组件的位置靠近容器的左上边缘时，将出现指示首选边距的水平和垂直对齐基准线。在窗体中单击，将 JPanel 放在此位置上。
@@ -183,7 +178,7 @@
``JPanel`` 组件出现在 ``ContactEditorUI`` 窗体中，并以橙色突出显示，表示它已选中。在松开鼠标按钮后，将出现小指示符来显示组件的锚点关系，并在 "Navigator"（导航器）窗口中显示相应的 JPanel 节点，如下图所示。
-|===
+
[.feature]
--
@@ -192,8 +187,8 @@
接下来，需要调整 JPanel 的大小，为稍后在其中放置的组件留出空间，在此我们需要先花一些时间了解 GUI 构建器的另一个可视化功能。要执行此操作，我们需要取消选中刚添加的 JPanel。由于尚未添加标题边框，因此将看不到该面板。不过请注意，当将光标移动到 JPanel 上时，其边缘会变为浅灰色，这样便可以清楚地看见它的位置。只需单击该组件内的任意位置，便可以重新选中它，并且将会再次出现大小调整控柄和锚点指示符。
-|===
-|调整 JPanel 的大小：
+
+调整 JPanel 的大小：
1. 选中刚刚添加的 JPanel。小的方形大小调整控柄将会再次出现在组件周围。
2. 单击并按住 JPanel 右边缘上的大小调整控柄，然后拖动直到靠近窗体边缘处出现对齐基准虚线。
@@ -202,7 +197,7 @@
按照建议的偏移将 ``JPanel`` 组件延伸至容器的左边距和右边距，如下图所示。
-|===
+
[.feature]
--
@@ -211,13 +206,13 @@
至此，我们已添加了用于容纳 UI 名称信息的面板，接下来需要重复该过程来添加另一个面板，它位于第一个面板正下方，用于容纳电子邮件信息。请参见以下各图再次执行前面的两个任务，同时注意 GUI 构建器的建议位置。请注意，建议的两个 JPanel 之间的垂直间距要比边缘处的间距小得多。添加了第二个 JPanel 后，调整其大小，使它充满窗体的其余垂直空间。
-|===
-|[.feature]
+
+[.feature]
--
image::images/02_add_panels_3-small.png[role="left", link="images/02_add_panels_3.png"]
--
- |
+
[.feature]
--
@@ -226,18 +221,18 @@
-|[.feature]
+[.feature]
--
image::images/02_add_panels_5-small.png[role="left", link="images/02_add_panels_5.png"]
--
-|===
+
由于我们需要在外观上区分出 GUI 上半部分和下半部分的功能，因此需要为每个 JPanel 添加边框和标题。我们将首先使用 "Properties"（属性）窗口完成此操作，然后将尝试使用弹出式菜单完成此操作。
-|===
-|将标题边框添加到 JPanel 中：
+
+将标题边框添加到 JPanel 中：
1. 选择 GUI 构建器中的顶部 JPanel。
2. 在 "Properties"（属性）窗口中，单击 "border" 属性旁边的省略号按钮 (...)。
@@ -249,7 +244,7 @@
带标题的边框将添加到两个 ``JPanel`` 组件中。
-|===
+
[.feature]
--
@@ -261,8 +256,8 @@
现在，我们需要着手添加一些组件，它们实际上将提供联系人列表中的联系人信息。在此任务中，我们将添加四个显示联系人信息的 JTextField 以及描述它们的 JLabel。执行此任务时，请注意 GUI 构建器显示的水平和垂直基准线，它们用于根据操作系统外观所定义的间距来建议首选组件间距。这可确保在运行时自动呈现与目标操作系统的外观一致的 GUI。
-|===
-|将 JLabel 添加到窗体中：
+
+将 JLabel 添加到窗体中：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Label"（标签）组件。
2. 将光标移到先前添加的 ``Name`` JPanel 上。当出现基准线指示 JLabel 位于 JPanel 的左上角（此时与上边缘和左边缘之间存在较小的边距）时，请单击鼠标以放置此标签。
@@ -270,12 +265,12 @@
JLabel 将添加到窗体中，并且 "Inspector"（检查器）窗口中将添加表示该组件的相应节点。
-|===
+
在继续操作之前，我们需要编辑刚添加的 JLabel 的显示文本。尽管可以在任何时候编辑组件显示文本，但最简便的方法是在添加它们时进行编辑。
-|===
-|编辑 JLabel 的显示文本：
+
+编辑 JLabel 的显示文本：
1. 双击 JLabel 以选中其显示文本。
2. 键入 ``First Name:`` ，然后按 Enter 键。
@@ -283,12 +278,12 @@
将显示 JLabel 的新名称，并且组件的宽度会随着编辑的内容进行相应地调整。
-|===
+
接下来，我们将添加 JTextField，以便大致了解 GUI 构建器的基线对齐功能。
-|===
-|将 JTextField 添加到窗体中：
+
+将 JTextField 添加到窗体中：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Text Field"（文本字段）组件。
2. 将光标移到紧靠刚添加的 ``First Name:`` JLabel 右侧的位置。当出现水平基准线指示 JTextField 的基线与 JLabel 的基线对齐，并且以垂直基准线给出两个组件之间的建议间距时，请单击鼠标以放置 JTextField。
@@ -296,7 +291,7 @@
JTextField 将与窗体中 JLabel 的基线对齐，如下图所示。请注意，JLabel 略微向下进行了移动，以便与较高的文本字段的基线对齐。同以前一样，"Navigator"（导航器）窗口中将添加表示该组件的节点。
-|===
+
image::images/03_indy_add_1.png[]
@@ -304,8 +299,8 @@
image::images/03_indy_add_2.png[]
-|===
-|调整 JTextField 的大小：
+
+调整 JTextField 的大小：
1. 选中刚添加到 ``Last Name:`` JLabel 右侧的 JTextField。
2. 将 JTextField 右边缘的大小调整控柄向封闭 JPanel 的右边缘拖动。
@@ -314,7 +309,7 @@
JTextField 的右边缘将与 JPanel 的边缘对齐，并留出建议的边缘边距，如下图所示。
-|===
+
image::images/03_indy_add_3.png[]
@@ -323,8 +318,8 @@
现在，我们将添加 ``Title:`` 和 ``Nickname:`` JLabel，它们用于描述我们将在稍后添加的两个 JTextField。我们将在按住 Shift 键的同时拖放组件，以便将它们快速添加到窗体中。执行此任务时，同样请注意 GUI 构建器显示的用于建议首选组件间距的水平和垂直基准线。
-|===
-|将多个 JLabel 添加到窗体中：
+
+将多个 JLabel 添加到窗体中：
1. 在 "Palette"（组件面板）窗口中，通过单击并松开鼠标按钮，从 "Swing Controls"（Swing 控件）类别中选择 "Label"（标签）组件。
2. 将光标移到先前在窗体中添加的 ``First Name:`` JLabel 的正下方。当出现基准线指示新 JLabel 的左边缘与上方 JLabel 的左边缘对齐，并且它们之间存在较小边距时，请按住 Shift 键单击鼠标以放置第一个 JLabel。
@@ -333,14 +328,14 @@
JLabel 将添加到窗体中，从而创建第二行组件，如下图所示。"Navigator"（导航器）窗口中将添加表示每个组件的节点。
-|===
+
image::images/04_multi-add_1.png[]
在继续操作之前，我们需要编辑 JLabel 的名称，以便能够看到将在以后设置的对齐效果。
-|===
-|编辑 JLabel 的显示文本：
+
+编辑 JLabel 的显示文本：
1. 双击第一个 JLabel 以选中其显示文本。
2. 键入 ``Title:`` ，然后按 Enter 键。
@@ -349,7 +344,7 @@
JLabel 的新名称将显示在窗体中，并且它们会随着编辑内容的加宽而发生位移，如下图所示。
-|===
+
image::images/04_multi-add_2.png[]
@@ -360,8 +355,8 @@
通常，需要在窗体中已放置的组件之间添加组件。只要在两个现有组件之间添加组件，GUI 构建器就会自动移动它们，以便为新组件留出空间。为了对此进行演示，我们将在先前添加的两个 JLabel 之间插入一个 JTextField，如下面的两幅图所示。
-|===
-|在两个 JLabel 之间插入 JTextField：
+
+在两个 JLabel 之间插入 JTextField：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Text Field"（文本字段）组件。
2. 将光标移到位于第二行的 ``Title:`` 和 ``Nickname:`` JLabel 上，使 JTextField 与两者都重叠，并与它们的基线对齐。如果在放置新文本字段时遇到困难，可以将其与 ``Nickname`` JLabel 的左基准线对齐，如下面的第一幅图所示。
@@ -370,22 +365,22 @@
JTextField 在两个 JLabel 之间对齐放置。最右侧的 JLabel 会向 JTextField 的右侧移动，以适应建议的水平偏移。
-|===
-|===
-|image::images/05_insert_1.png[]
- |
+
+image::images/05_insert_1.png[]
+
+
image::images/05_insert_2.png[]
-|===
+
我们仍需要将另外一个 JTextField 添加到窗体中，它将在窗体的右侧显示每个联系人的昵称。
-|===
-|添加 JTextField：
+
+添加 JTextField：
1. 在 "Palette"（组件面板）窗口中，从 Swing 类别中选择 "Text Field"（文本字段）组件。
2. 将光标移到 ``Nickname`` 标签的右侧，然后单击鼠标以放置该文本字段。
@@ -393,31 +388,30 @@
JTextField 在其左侧的 JLabel 旁边对齐放置。
-|===
-|===
-|调整 JTextField 的大小：
+
+
+调整 JTextField 的大小：
1. 将在先前任务中添加的 ``Nickname:`` 标签的 JTextField 大小调整控柄向封闭 JPanel 的右侧拖动。
2. 当出现垂直对齐基准线以给出文本字段与 JPanel 边缘之间的建议边距时，请松开鼠标按钮以调整 JTextField 的大小。
JTextField 的右边缘将与 JPanel 的边缘对齐，并留出建议的边缘边距；同时，GUI 构建器会推断出合适的大小调整行为。
-3. 按 Ctrl-S 组合键保存该文件。
+
+[start=3]
+. 按 Ctrl-S 组合键保存该文件。
-|===
-----
-<<top,返回页首>>
+
+
== 更进一步
对齐是创建具有专业外观的 GUI 的一个最基本方面。在上一部分中，我们通过将 JLabel 和 JTextField 组件添加到 ContactEditorUI 窗体中，大致了解了 IDE 的对齐功能。接下来，我们将在使用应用程序所需的其他各种组件的过程中更深入地了解 GUI 构建器的对齐功能。
-[quote]
-----
=== 组件对齐
@@ -425,8 +419,8 @@
每次将组件添加到窗体中时，GUI 构建器都会有效地将它们对齐，出现的对齐基准线可以证明这一点。但是，有时也需要在组件组之间指定不同的关系。先前我们添加了四个 ContactEditor GUI 所需的 JLabel，但并未将它们对齐。现在，我们将对齐两列 JLabel，以使它们的右边缘排列整齐。
-|===
-|对齐组件：
+
+对齐组件：
1. 按住 ``Ctrl`` 键，然后单击以选择窗体左侧的 ``First Name:`` 和 ``Title:`` JLabel。
2. 单击工具栏中的 "Align Right in Column"（列向右对齐）按钮 (image::images/align_r.png[])。或者，也可以右键单击其中任一组件，然后从弹出式菜单中选择 "Align"（对齐）> "Right"（列右侧）。
@@ -435,12 +429,12 @@
JLabel 的位置将会移动，以使它们的显示文本的右边缘对齐。同时，也会更新锚点关系，指示组件已分组。
-|===
+
在结束先前添加的 JTextField 的操作之前，我们需要确保 JLabel 之间插入的两个 JTextField 设置为可正确调整大小。与拉伸到窗体右边缘的两个 JTextField 不同，所插入组件的大小可调性不是自动设置的。
-|===
-|设置调整组件大小行为：
+
+设置调整组件大小行为：
1. 按住 Ctrl 键单击两个插入的 JTextField 组件，以便在 GUI 构建器中将它们选中。
2. 在同时选中这两个 JTextField 的情况下，右键单击其中的任何一个，然后从弹出式菜单中选择 "Auto Resizing"（自动调整大小）> "Horizontal"（水平）。
@@ -448,10 +442,10 @@
JTextField 将被设置为在运行时水平调整大小。同时，也会更新对齐基准线和锚点指示符，以提供组件关系的可视反馈。
-|===
-|===
-|将组件设置为相同大小：
+
+
+将组件设置为相同大小：
1. 按住 Ctrl 键单击窗体中的所有四个 JTextField 以将它们选中。
2. 在选中了这些 JTextField 的情况下，右键单击其中任何一个，然后从弹出式菜单中选择 "Set Same Size"（设置相同大小）> "Same Width"（相同宽度）。
@@ -459,12 +453,12 @@
这些 JTextField 均会设置为相同的宽度，并且每个 JTextField 的上边缘都将添加指示符，以提供组件关系的可视反馈。
-|===
+
现在，我们需要添加另一个描述 JComboBox 的 JLabel，用户可以使用该 JComboBox 来选择 ContactEditor 应用程序将显示的信息格式。
-|===
-|将 JLabel 与组件组对齐：
+
+将 JLabel 与组件组对齐：
1. 在 "Palette"（组件面板）窗口中，从 Swing 类别中选择 "Label"（标签）组件。
2. 将光标移到 JPanel 左侧的 ``First Name`` 和 ``Title`` JLabel 下方。当出现基准线指示新 JLabel 的右边缘与上方组件组（两个 JLabel）的右边缘对齐时，请单击鼠标以放置该组件。
@@ -472,7 +466,7 @@
该 JLabel 将与上方的 JLabel 列右侧对齐，如下图所示。GUI 构建器将更新指示组件间距和锚点关系的对齐状态线。
-|===
+
[.feature]
--
@@ -488,8 +482,8 @@
现在，我们将添加一个组合框，用户可以使用它来选择 ContactEditor 应用程序将显示的信息格式。在添加 JComboBox 时，我们会将其基线与 JLabel 文本的基线对齐。请再次注意为帮助定位而出现的基线对齐基准线。
-|===
-|对齐组件的基线：
+
+对齐组件的基线：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Combo Box"（组合框）组件。
2. 将光标移到紧靠刚添加的 JLabel 右侧的位置。当出现水平基准线指示 JComboBox 的基线与 JLabel 中文本的基线对齐，并且以垂直基准线给出两个组件之间的建议间距时，请单击鼠标以放置该组合框。
@@ -497,15 +491,15 @@
该组件将与其左侧的 JLabel 中的文本的基线对齐，如下图所示。GUI 构建器将显示指示组件间距和锚点关系的状态线。
-|===
+
[.feature]
--
image::images/06_align_2-small.png[role="left", link="images/06_align_2.png"]
--
-|===
-|调整 JComboBox 的大小：
+
+调整 JComboBox 的大小：
1. 选中 GUI 构建器中的 ComboBox。
2. 将 JComboBox 右边缘上的大小调整控柄向右侧拖动，直到出现对齐基准线以给出 JComboBox 和 JPanel 边缘之间的建议首选偏移。
@@ -517,16 +511,16 @@
image::images/06_align_3-small.png[role="left", link="images/06_align_3.png"]
--
-3. 按 Ctrl-S 组合键保存该文件。
+
+[start=3]
+. 按 Ctrl-S 组合键保存该文件。
-|===
+
编辑组件模型不在本教程的涉及范围内，因此我们将暂时保留 JComboBox 的占位符项列表的原样。
-----
-<<top,返回页首>>
== 回顾所学内容
@@ -535,15 +529,13 @@
到目前为止，我们一直在介绍如何将组件添加到 ContactEditor GUI 中，并使用 IDE 的对齐基准线来帮助定位。但还有另一个重要方面，就是了解如何在组件放置过程中使用锚点。尽管我们尚未讨论它，但您已经利用了此功能，只是没有意识到。如前面所提到的，只要将组件添加到窗体中，IDE 就会通过基准线给出建议的目标外观首选位置。在放置新组件的同时，会将该组件锚定在最近的容器边缘或组件上，以确保在运行时保持组件关系。在此部分，我们将重点介绍如何以更简化的方式完成这些任务，同时指出 GUI 构建器在后台执行的工作。
-[quote]
-----
=== 添加、对齐和锚定
在 GUI 构建器中，可以通过简化典型工作流操作来快捷、轻松地设置窗体布局。只要将组件添加到窗体中，GUI 构建器就会自动将组件对齐放置到首选位置并设置所需的链接关系，以便您可以专注于设计窗体，而不必疲于应付复杂的实现细节。
-|===
-|添加并对齐 JLabel 以及编辑其显示文本：
+
+添加并对齐 JLabel 以及编辑其显示文本：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Label"（标签）组件。
2. 将光标移到窗体底部 JPanel 的 E-mail 标题的正下方。当出现基准线指示该标签位于 JPanel 的左上角（此时与上边缘和左边缘之间存在较小的边距）时，请单击鼠标以放置 JLabel。
@@ -552,27 +544,29 @@
JLabel 将对齐放置到窗体中的首选位置，并且锚定在封闭 JPanel 的上边缘和左边缘。同以前一样，"Navigator"（导航器）窗口中将添加表示该组件的相应节点。
-|===
-|===
-|添加 JTextField：
+
+
+添加 JTextField：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Text Field"（文本字段）组件。
2. 将光标移到紧靠刚添加的 ``E-mail Address`` 标签右侧的位置。当出现基准线指示 JTextField 的基线与 JLabel 中文本的基线对齐，并且以垂直基准线给出两个组件之间的建议边距时，请单击鼠标以放置该文本字段。
JTextField 在 ``E-mail Address:`` JLabel 的右侧对齐放置并链接到该 JLabel。"Inspector"（检查器）窗口中也将添加与其对应的节点。
-3. 将 JTextField 的大小调整控柄向封闭 JPanel 的右侧拖动，直到出现对齐基准线以给出 JTextField 和 JPanel 边缘之间的建议偏移。
+
+[start=3]
+. 将 JTextField 的大小调整控柄向封闭 JPanel 的右侧拖动，直到出现对齐基准线以给出 JTextField 和 JPanel 边缘之间的建议偏移。
JTextField 的右边缘将与指示首选边距的对齐基准线对齐。
-|===
+
现在，我们需要添加 JList，它将用于显示 ContactEditor 的整个联系人列表。
-|===
-|添加 JList 并调整其大小：
+
+添加 JList 并调整其大小：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "List"（列表）组件。
2. 将光标移到先前添加的 ``E-mail Address`` JLabel 的正下方。当出现基准线指示 JList 的左边缘和上边缘分别与 JPanel 的左边缘和上方的 JLabel 对齐（留出首选边距）时，请单击鼠标以放置 JList。
@@ -581,7 +575,7 @@
JList 在对齐基准线指定的位置对齐放置，并且 "Inspector"（检查器）窗口中显示与其对应的节点。另请注意，窗体将会扩展以适应新添加的 JList。
-|===
+
[.feature]
--
@@ -597,19 +591,19 @@
通常，将几个相关组件（如模态对话框中的按钮）设置为相同大小对保持外观一致性很有好处。为演示此操作，我们将在 ContactEditor 窗体中添加四个 JButton，这些按钮用于添加、编辑和删除联系人列表中的各个条目，如以下各图所示。之后，我们将四个按钮设置为相同大小，以便能够容易地识别出它们在提供相关的功能。
-|===
-|添加并对齐多个按钮以及编辑其显示文本：
+
+添加并对齐多个按钮以及编辑其显示文本：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Button"（按钮）组件。
2. 将 JButton 移到底部 JPanel 中 ``E-mail Address`` JTextField 的右边缘。当出现基准线指示 JButton 的基线和右边缘与 JTextField 的基线和右边缘对齐时，请按住 Shift 键单击鼠标，从而沿 JFrame 的右边缘放置第一个按钮。在松开鼠标按钮时，JTextField 的宽度会缩减以容纳 JButton。
-|===
-|[.feature]
+
+[.feature]
--
image::images/buttons_1-small.png[role="left", link="images/buttons_1.png"]
--
- |
+
[.feature]
--
@@ -617,22 +611,26 @@
--
-|===
-3. 将光标移到底部 JPanel 中 JList 的右上角。当出现基准线指示 JButton 的上边缘和右边缘与 JList 的上边缘和右边缘对齐时，请按住 Shift 键单击鼠标，从而沿 JFrame 的右边缘放置第二个按钮。
+[start=3]
+. 将光标移到底部 JPanel 中 JList 的右上角。当出现基准线指示 JButton 的上边缘和右边缘与 JList 的上边缘和右边缘对齐时，请按住 Shift 键单击鼠标，从而沿 JFrame 的右边缘放置第二个按钮。
[.feature]
--
image::images/buttons_3-small.png[role="left", link="images/buttons_3.png"]
--
-4. 在已添加的两个 JButton 的下方再添加两个 JButton，以创建一个列。请确保按照建议的间距放置 JButton 并保持间距的一致性。如果在放置最后一个 JButton 前忘记松开 Shift 键，只需按 Esc 键即可。
+
+[start=4]
+. 在已添加的两个 JButton 的下方再添加两个 JButton，以创建一个列。请确保按照建议的间距放置 JButton 并保持间距的一致性。如果在放置最后一个 JButton 前忘记松开 Shift 键，只需按 Esc 键即可。
[.feature]
--
image::images/buttons_4-small.png[role="left", link="images/buttons_4.png"]
--
-5. 设置每个 JButton 的显示文本。（可以通过右键单击按钮并选择 "Edit Text"（编辑文本）来编辑按钮的文本。或者，也可以单击按钮，稍等片刻，然后再次单击按钮。）为最上面的按钮输入 `Add`，为第二个按钮输入 `Edit`，为第三个按钮输入 `Remove`，为第四个按钮输入 `As Default`。
+
+[start=5]
+. 设置每个 JButton 的显示文本。（可以通过右键单击按钮并选择 "Edit Text"（编辑文本）来编辑按钮的文本。或者，也可以单击按钮，稍等片刻，然后再次单击按钮。）为最上面的按钮输入 `Add`，为第二个按钮输入 `Edit`，为第三个按钮输入 `Remove`，为第四个按钮输入 `As Default`。
JButton 组件在对齐基准线指定的位置对齐放置。按钮的宽度将会更改以适应新名称。
@@ -642,12 +640,12 @@
--
-|===
+
现在，已将按钮放置在所需的位置，接下来，我们要将四个按钮设置为相同的大小以保持外观一致性，同时表明它们在功能上是彼此相关的。
-|===
-|将组件设置为相同大小：
+
+将组件设置为相同大小：
1. 通过按住 Ctrl 键进行选择，选中所有四个 JButton。
2. 右键单击其中一个 JButton，然后从弹出式菜单中选择 "Same Size"（相同大小）> "Same Width"（相同宽度）。
@@ -660,7 +658,7 @@
--
-|===
+
=== 缩进
@@ -669,8 +667,8 @@
在此部分，我们将在一个 JLabel 下添加几个 JRadioButton，用户可以使用这些 JRadioButton 定制应用程序显示数据的方式。请参见以下各图来执行此任务，或者单击此操作过程之后的“查看演示”链接来查看交互式演示。
-|===
-|缩进 JLabel 下的 JRadioButton：
+
+缩进 JLabel 下的 JRadioButton：
1. 将一个名为 ``Mail Format`` 的 JLabel 添加到窗体中 JList 的下方。确保该标签与上方的 JList 左侧对齐。
2. 在 "Palette"（组件面板）窗口中，从 "Swing" 类别中选择 "Radio"（单选按钮）组件。
@@ -681,8 +679,12 @@
image::images/07_indent_1-small.png[role="left", link="images/07_indent_1.png"]
--
-4. 将光标移到第一个 JRadioButton 的右侧。按住 Shift 键单击鼠标以放置第二个和第三个 JRadioButton，同时注意保持建议的组件间距。请确保在放置最后一个 JRadioButton 前松开 Shift 键。
-5. 设置每个 JRadioButton 的显示文本。（可以通过右键单击按钮并选择 "Edit Text"（编辑文本）来编辑按钮的文本。或者，也可以单击按钮，稍等片刻，然后再次单击按钮。）为左侧的单选按钮输入 `HTML`，为第二个单选按钮输入 `Plain Text`，为第三个单选按钮输入 `Custom`。
+
+[start=4]
+. 将光标移到第一个 JRadioButton 的右侧。按住 Shift 键单击鼠标以放置第二个和第三个 JRadioButton，同时注意保持建议的组件间距。请确保在放置最后一个 JRadioButton 前松开 Shift 键。
+
+[start=5]
+. 设置每个 JRadioButton 的显示文本。（可以通过右键单击按钮并选择 "Edit Text"（编辑文本）来编辑按钮的文本。或者，也可以单击按钮，稍等片刻，然后再次单击按钮。）为左侧的单选按钮输入 `HTML`，为第二个单选按钮输入 `Plain Text`，为第三个单选按钮输入 `Custom`。
三个 JRadioButton 将添加到窗体中，并且缩进在 ``Mail Format`` JLabel 的下方。
@@ -692,12 +694,12 @@
--
-|===
+
现在，我们需要将三个 JRadioButton 添加到一个 ButtonGroup 中来实现所需的开启/关闭行为，即一次只能选中一个单选按钮。这又将确保 ContactEditor 应用程序的联系人信息能够以我们选择的邮件格式显示。
-|===
-|将 JRadioButton 添加到 ButtonGroup 中：
+
+将 JRadioButton 添加到 ButtonGroup 中：
1. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Button Group"（按钮组）组件。
2. 单击 GUI 构建器设计区域中的任何位置，以将 ButtonGroup 组件添加到窗体中。请注意，ButtonGroup 本身不会显示在窗体中，而是显示在 "Navigator"（导航器）的 "Other Components"（其他组件）区域中。
@@ -711,28 +713,24 @@
image::images/07_group-small.png[role="left", link="images/07_group.png"]
--
-5. 按 Ctrl-S 组合键保存该文件。
+
+[start=5]
+. 按 Ctrl-S 组合键保存该文件。
-|===
-----
-
-<<top,返回页首>>
== 进行最后的调整
我们已大致成功地生成了 ContactEditor 应用程序的 GUI，但还有几项工作尚待完成。在此部分，我们将介绍 GUI 构建器简化的其他几项典型布局任务。
-[quote]
-----
=== 最后加工
现在，我们需要添加一些按钮，使用户可以确认他们输入的单个联系人的信息，并将该信息添加到联系人列表中，或者取消添加，从而使数据库保持不变。在此步骤中，需要添加两个按钮并编辑这些按钮，以便它们在窗体中显示相同的大小，即使它们的显示文本具有不同的长度。
-|===
-|添加按钮并编辑其显示文本：
+
+添加按钮并编辑其显示文本：
1. 如果底部 JPanel 延伸到了 JFrame 窗体的下边缘处，请向下拖动 JFrame 的下边缘。这可以在 JFrame 的边缘和 JPanel 的边缘之间为 OK 和 Cancel 按钮留出空间。
2. 在 "Palette"（组件面板）窗口中，从 "Swing Controls"（Swing 控件）类别中选择 "Button"（按钮）组件。
@@ -743,9 +741,15 @@
image::images/08_cancel-small.png[role="left", link="images/08_cancel.png"]
--
-4. 将另一个 JButton 添加到第一个 JButton 的左侧，同时确保按照与 JFrame 下边缘的建议间距放置它。
-5. 设置每个 JButton 的显示文本。为左侧按钮输入 ``OK`` ，为右侧按钮输入 ``Cancel`` 。请注意，按钮的宽度将会更改以适应新名称。
-6. 将两个 JButton 设置为相同大小，方法是：选中它们，右键单击其中任何一个，然后从弹出式菜单中选择 "Same Size"（相同大小）> "Same Width"（相同宽度）。
+
+[start=4]
+. 将另一个 JButton 添加到第一个 JButton 的左侧，同时确保按照与 JFrame 下边缘的建议间距放置它。
+
+[start=5]
+. 设置每个 JButton 的显示文本。为左侧按钮输入 ``OK`` ，为右侧按钮输入 ``Cancel`` 。请注意，按钮的宽度将会更改以适应新名称。
+
+[start=6]
+. 将两个 JButton 设置为相同大小，方法是：选中它们，右键单击其中任何一个，然后从弹出式菜单中选择 "Same Size"（相同大小）> "Same Width"（相同宽度）。
[.feature]
--
@@ -754,16 +758,16 @@
``JButton`` 组件将出现在窗体中，且 "Navigator"（导航器）窗口中将显示与其对应的节点。 ``JButton`` 组件的代码也将添加到窗体的源文件中，可以在编辑器的 "Source"（源）视图中查看该文件。每个 JButton 的大小将被设置为与名称最长的按钮的大小相同。
-7. 按 Ctrl-S 组合键保存该文件。
+
+[start=7]
+. 按 Ctrl-S 组合键保存该文件。
-|===
+
需要做的最后一项工作是删除各个组件中的占位符文本。请注意，在设置了大致的窗体布局后删除占位符文本对避免出现组件对齐和锚点关系问题很有帮助，大多数开发者通常会在设置窗体布局的过程中删除此类文本。请在浏览窗体时选择并删除每个 JTextField 的占位符文本。我们将保留 JComboBox 和 JList 中的占位符项，供以后的教程使用。
-----
-<<top,返回页首>>
== 预览 GUI
@@ -775,7 +779,7 @@
image::images/08_preview_gui-small.png[role="left", link="images/08_preview_gui.png"]
--
-<<top,返回页首>>
+
== 部署 GUI 应用程序
@@ -787,8 +791,6 @@
如果在 JDK 6 上运行 IDE，IDE 可生成应用程序代码以使用 Java SE 6 中的 GroupLayout 类。这意味着您可以部署应用程序，使其在安装了 Java SE 6 的系统上运行，并且不需要将 Swing 布局扩展库打包到该应用程序中。
*注：*如果使用 JDK 6 创建应用程序，但需要在 Java SE 5 上运行此应用程序，则可以在 IDE 中生成代码以使用 Swing 布局扩展库，而不是 Java SE 6 中的类。在 GUI 编辑器中打开 ContactEditorUI 类。在“导航器”窗口中，右键单击“窗体 ContactEditorUI”节点，然后从弹出式菜单中选择“属性”。在“属性”对话框中，将“布局生成样式”属性的值更改为“Swing 布局扩展库”。
-[quote]
-----
=== 分发和运行独立的 GUI 应用程序
@@ -803,23 +805,23 @@
1. 导航至项目的 ``dist`` 文件夹。
2. 键入以下命令：
-[quote]
+
+[source,bash]
----
- ``java -jar <jar_name>.jar``
+java -jar <jar_name>.jar
----
-----
*注：*如果遇到以下错误：
-[quote]
+[source,bash]
----
- ``Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group``
+Exception in thread "main" java.lang.NoClassDefFoundError: org/jdesktop/layout/GroupLayout$Group
----
请确保 ``manifest.mf`` 文件引用的是当前安装的 Swing 布局扩展库版本。
-<<top,返回页首>>
+
link:/about/contact_form.html?to=3&subject=Feedback:%20Designing%20a%20Swing%20GUI%20in%20NetBeans%20IDE[+发送有关此教程的反馈意见+]
@@ -835,5 +837,5 @@
* link:../../trails/matisse.html[+Java GUI 应用程序学习资源+]
* _使用 NetBeans IDE 开发应用程序_中的link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG920[+实现 Java GUI+]
-<<top,返回页首>>
+
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc
index 89e2bcd..300ffb2 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart.asciidoc
@@ -44,7 +44,9 @@
1. In the IDE, choose File > New Project or click the "New Project" button in the toolbar.
-2. In the New Project wizard, select Java Application, as shown in the figure below. Then click Next.
+
+[start=2]
+. In the New Project wizard, select Java Application, as shown in the figure below. Then click Next.
[.feature]
--
@@ -53,8 +55,10 @@
NOTE: The first time you create a new Java project, you will be prompted to download and enable support for Java. Follow the prompts and install as recommended by the wizard.
+
+
[start=3]
-3. In the Name and Location page of the wizard, type `HelloWorldApp` in the Project Name field, (as shown in the figure below):
+. In the Name and Location page of the wizard, type `HelloWorldApp` in the Project Name field, (as shown in the figure below):
[.feature]
--
@@ -101,9 +105,13 @@
1. Between the braces, type `psvm` and press kbd:[Tab]. You should now see `public static void main` statement.
-2. Within the `public static void main` statement, type `sout` and press kbd:[Tab]. You should now see a `System.out.println` statement.
-3. Within the quotation marks, type `hello world`.
+[start=2]
+. Within the `public static void main` statement, type `sout` and press kbd:[Tab]. You should now see a `System.out.println` statement.
+
+
+[start=3]
+. Within the quotation marks, type `hello world`.
You should now see the following:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ca.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ca.asciidoc
index 9643659..5250fd1 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ca.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ca.asciidoc
@@ -68,8 +68,12 @@
image::images/new-proj.png[]
-3. En l'assistent de Nou projecte, expandiu la categoria Java i seleccioneu Aplicació Java, tal com es mostra en la següent figura. Després cliqueu a Següent. image::images/proj-wizard.png[]
-4. En la pàgina del nom i la localització de l'assistent, feu el següent (com es mostra en la següent figura):
+
+[start=3]
+. En l'assistent de Nou projecte, expandiu la categoria Java i seleccioneu Aplicació Java, tal com es mostra en la següent figura. Després cliqueu a Següent. image::images/proj-wizard.png[]
+
+[start=4]
+. En la pàgina del nom i la localització de l'assistent, feu el següent (com es mostra en la següent figura):
* En el camp del nom del projecte, escriviu `HelloWorldApp`.
* Deixeu sense marcar la casella de selecció, Utilitzar una carpeta dedicada per a emmagatzemar les biblioteques.
* En el camp Crear la classe principal, escriviu `helloworldapp.HelloWorldApp`.
@@ -77,7 +81,9 @@
image::images/proj-wizard2.png[]
-5. Cliqueu a Finalitzar
+
+[start=5]
+. Cliqueu a Finalitzar
Es crea el projecte i s'obre a l'IDE. Hauríeu de visualitzar els següent components:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ja.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ja.asciidoc
index bfaed8e..ed3c5ae 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ja.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ja.asciidoc
@@ -61,14 +61,18 @@
image::images/new-proj.png[]
-3. 次の図に示すように、新規プロジェクト・ウィザードの「Java」カテゴリを展開し、「Javaアプリケーション」を選択します。「次」をクリックします。
+
+[start=3]
+. 次の図に示すように、新規プロジェクト・ウィザードの「Java」カテゴリを展開し、「Javaアプリケーション」を選択します。「次」をクリックします。
[.feature]
--
image::images/proj-wizard-small.png[role="left", link="images/proj-wizard.png"]
--
-4. ウィザードの名前と場所ページで、次の操作を行います(次の図を参照)。
+
+[start=4]
+. ウィザードの名前と場所ページで、次の操作を行います(次の図を参照)。
* 「プロジェクト名」フィールドに`HelloWorldApp`と入力します。
* 「ライブラリの格納用に専用フォルダを使用」チェックボックスは選択されていない状態のままにします。
* 「メイン・クラスの作成」フィールドに`helloworldapp.HelloWorldApp`と入力します。
@@ -78,7 +82,9 @@
image::images/proj-wizard2-small.png[role="left", link="images/proj-wizard2.png"]
--
-5. 「終了」をクリックします。
+
+[start=5]
+. 「終了」をクリックします。
IDEでプロジェクトが作成され、表示されます。次のコンポーネントが表示されます。
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart_pt_BR.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart_pt_BR.asciidoc
index cd68210..f783e70 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart_pt_BR.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart_pt_BR.asciidoc
@@ -61,14 +61,18 @@
image::images/new-proj.png[]
-3. No assistente Novo Projeto, expanda a categoria Java e selecione Aplicação Java, como mostrado na figura abaixo. Em seguida, clique em Próximo.
+
+[start=3]
+. No assistente Novo Projeto, expanda a categoria Java e selecione Aplicação Java, como mostrado na figura abaixo. Em seguida, clique em Próximo.
[.feature]
--
image::images/proj-wizard-small.png[role="left", link="images/proj-wizard.png"]
--
-4. Na página Nome e Localização do assistente, adote o procedimento a seguir (como mostrado na figura abaixo):
+
+[start=4]
+. Na página Nome e Localização do assistente, adote o procedimento a seguir (como mostrado na figura abaixo):
* no campo Nome do Projeto, digite `HelloWorldApp`.
* Deixe desmarcada a caixa de seleção Utilizar Pasta Dedicada para Armazenar Bibliotecas.
* No campo Criar Classe Principal, digite `helloworldapp.HelloWorldApp`.
@@ -78,7 +82,9 @@
image::images/proj-wizard2-small.png[role="left", link="images/proj-wizard2.png"]
--
-5. Clique em Finalizar.
+
+[start=5]
+. Clique em Finalizar.
O projeto é criado e aberto no IDE. Agora você deve ver os seguintes componentes:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ru.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ru.asciidoc
index 606d09b..b245315 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart_ru.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart_ru.asciidoc
@@ -61,14 +61,18 @@
image::images/new-proj.png[]
-3. В мастере создания проекта разверните категорию "Java" и выберите "Приложение Java". Затем нажмите кнопку "Дальше".
+
+[start=3]
+. В мастере создания проекта разверните категорию "Java" и выберите "Приложение Java". Затем нажмите кнопку "Дальше".
[.feature]
--
image::images/proj-wizard-small.png[role="left", link="images/proj-wizard.png"]
--
-4. На странице мастера "Имя и местоположение" выполните следующие действия (см. рисунок ниже):
+
+[start=4]
+. На странице мастера "Имя и местоположение" выполните следующие действия (см. рисунок ниже):
* введите `HelloWorldApp` в поле "Имя проекта";
* Не устанавливайте флажок "Использовать отдельную папку для хранения библиотек".
* в поле "Создать главный класс" введите `helloworldapp.HelloWorldApp`;
@@ -78,7 +82,9 @@
image::images/proj-wizard2-small.png[role="left", link="images/proj-wizard2.png"]
--
-5. Нажмите кнопку "Завершить".
+
+[start=5]
+. Нажмите кнопку "Завершить".
Проект будет создан и открыт в среде IDE. На экране должны быть представлены следующие элементы:
diff --git a/netbeans.apache.org/src/content/kb/docs/java/quickstart_zh_CN.asciidoc b/netbeans.apache.org/src/content/kb/docs/java/quickstart_zh_CN.asciidoc
index d1ca7c3..12528be 100644
--- a/netbeans.apache.org/src/content/kb/docs/java/quickstart_zh_CN.asciidoc
+++ b/netbeans.apache.org/src/content/kb/docs/java/quickstart_zh_CN.asciidoc
@@ -61,14 +61,18 @@
image::images/new-proj.png[]
-3. 在新建项目向导中，展开 "Java" 类别，然后选择 "Java Application"（Java 应用程序），如下图所示。然后，单击 "Next"（下一步）。
+
+[start=3]
+. 在新建项目向导中，展开 "Java" 类别，然后选择 "Java Application"（Java 应用程序），如下图所示。然后，单击 "Next"（下一步）。
[.feature]
--
image::images/proj-wizard-small.png[role="left", link="images/proj-wizard.png"]
--
-4. 在向导的 "Name and Location"（名称和位置）页中，执行以下操作（如下图所示）：
+
+[start=4]
+. 在向导的 "Name and Location"（名称和位置）页中，执行以下操作（如下图所示）：
* 在 "Project Name"（项目名称）字段中，键入 `HelloWorldApp`。
* 将 "Use Dedicated Folder for Storing Libraries"（使用专用文件夹存储库）复选框保留为取消选中状态。
* 在 "Create Main Class"（创建主类）字段中，键入 `helloworldapp.HelloWorldApp`。
@@ -78,7 +82,9 @@
image::images/proj-wizard2-small.png[role="left", link="images/proj-wizard2.png"]
--
-5. 单击 "Finish"（完成）。
+
+[start=5]
+. 单击 "Finish"（完成）。
此时将创建项目并在 IDE 中打开。此时，您应该看到以下组件：
