You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2015/07/27 10:57:56 UTC
[1/2] isis git commit: ISIS-1052: reference extended version of
petclinic tutorial.
Repository: isis
Updated Branches:
refs/heads/master c67e372f0 -> 042846428
ISIS-1052: reference extended version of petclinic tutorial.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/5fbad072
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/5fbad072
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/5fbad072
Branch: refs/heads/master
Commit: 5fbad0724b009a1e9eb025f237c06c83d44d2400
Parents: c67e372
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Mon Jul 27 09:56:52 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Mon Jul 27 09:56:52 2015 +0100
----------------------------------------------------------------------
.../main/asciidoc/guides/_tg_pet-clinic-extended.adoc | 12 ++++++++++++
.../src/main/asciidoc/guides/_tg_pet-clinic.adoc | 4 ++--
.../guides/_tg_stop-scaffolding-start-coding.adoc | 6 +++---
adocs/documentation/src/main/asciidoc/guides/tg.adoc | 7 +++++--
4 files changed, 22 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/5fbad072/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic-extended.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic-extended.adoc b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic-extended.adoc
new file mode 100644
index 0000000..72b2b46
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic-extended.adoc
@@ -0,0 +1,12 @@
+[[_tg_tutorials_pet-clinic-extended]]
+= Pet Clinic (Extended)
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+An extended version of the xref:tg.adoc#_tg_tutorials_pet-clinic[pet clinic] can be found on link:https://github.com/johandoornenbal/tutorial_code/blob/master/AsciiDoc/1_petclinic_introduction.adoc[this github repo]. It was written by Johan Doornenbal.
+
+This version also includes a link:https://github.com/johandoornenbal/petclinic_mynewcode[sample solution], also as a github repo.
+
http://git-wip-us.apache.org/repos/asf/isis/blob/5fbad072/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
index 3c0994f..b27403c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
@@ -1,11 +1,11 @@
-[[_ug_tutorials_pet-clinic]]
+[[_tg_tutorials_pet-clinic]]
= Pet Clinic
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
-This is a step-by-step tutorial to build up a simple "petclinic" application, starting from the xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp archetype].
+This is a step-by-step tutorial to build up a simple "petclinic" application, starting from the xref:ug.adoc#_ug_getting-started_simpleapp-archetype[SimpleApp archetype]. It was originally written by Jeroen van der Wal.
It consists of just three domain classes (http://yuml.me/edit/3db2078c[http://yuml.me/3db2078c]):
http://git-wip-us.apache.org/repos/asf/isis/blob/5fbad072/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc b/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
index 819f6f6..6aeb3bd 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
@@ -1,13 +1,13 @@
-[[_ug_tutorials_stop-scaffolding-start-coding]]
+[[_tg_tutorials_stop-scaffolding-start-coding]]
= Stop scaffolding, start coding
:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
:_basedir: ../
:_imagesdir: images/
-This is a half-day tutorial on developing domain-driven apps using Apache Isis. Actually, you could probably spend a full day working through this tutorial if you wanted to, so pick and choose the bits that look interesting.
+This is a half-day tutorial on developing domain-driven apps using Apache Isis. Actually, you could probably spend a full day working through this tutorial if you wanted to, so pick and choose the bits that look interesting. It was originally written by Dan Haywood.
-There's a bit of overlap with the xref:ug.adoc#_ug_tutorials_pet-clinic[Pet Clinic] tutorial initially, but it then sets off on its own.
+There's a bit of overlap with the xref:tg.adoc#_tg_tutorials_pet-clinic[Pet Clinic] tutorial initially, but it then sets off on its own.
http://git-wip-us.apache.org/repos/asf/isis/blob/5fbad072/adocs/documentation/src/main/asciidoc/guides/tg.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/tg.adoc b/adocs/documentation/src/main/asciidoc/guides/tg.adoc
index 20b6517..8856b4c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/tg.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/tg.adoc
@@ -10,13 +10,16 @@
This page contains a couple of tutorials for you to follow.
-* the "petclinic" tutorial takes you step-by-step through building a simple application of just three classes. There are example solutions in the github repo in case you get lost.
+* the xref:tg.adoc#_tg_tutorials_pet-clinic["petclinic"] tutorial takes you step-by-step through building a simple application of just three classes. There are example solutions in the github repo in case you get lost.
-* the "stop scaffolding, start coding" tutorial is taken from a conference workshop. It has less hand-holding, but lists out the steps for you to follow. It's a good cookbook to follow when you're readng to take things further.
+* an xref:tg.adoc#_tg_tutorials_pet-clinic-extended[extended version] of the "petclinic" tutorial, (with the text hosted on github repo).
+
+* the xref:tg.adoc#_tg_tutorials_stop-scaffolding-start-coding["stop scaffolding, start coding"] tutorial is taken from a conference workshop. It has less hand-holding, but lists out the steps for you to follow. It's a good cookbook to follow when you're readng to take things further.
Have fun!
include::_tg_pet-clinic.adoc[leveloffset=+1]
+include::_tg_pet-clinic-extended.adoc[leveloffset=+1]
include::_tg_stop-scaffolding-start-coding.adoc[leveloffset=+1]
[2/2] isis git commit: ISIS-1052: update contributors guide,
moving IntelliJ plugins section to tips-n-tricks.
Posted by da...@apache.org.
ISIS-1052: update contributors guide, moving IntelliJ plugins section to tips-n-tricks.
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/04284642
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/04284642
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/04284642
Branch: refs/heads/master
Commit: 0428464286e9fdea3512c44a4d7460dbe66fd371
Parents: 5fbad07
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Mon Jul 27 09:57:36 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Mon Jul 27 09:57:36 2015 +0100
----------------------------------------------------------------------
.../main/asciidoc/guides/_cg_ide_intellij.adoc | 85 ++++++++++----------
1 file changed, 43 insertions(+), 42 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/04284642/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc b/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
index 739e062..46d025a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cg_ide_intellij.adoc
@@ -143,48 +143,9 @@ image::{_imagesdir}appendices/dev-env/intellij-idea/040-other-settings/040-auto-
-=== Plugins
-
-You might also want to set up some additional plugins, using `File > Settings > Plugins` (or equivalently `File > Other Settings > Configure Plugins`).
-
-Recommended are:
-
-* link:https://plugins.jetbrains.com/plugin/7179?pr=idea[Maven Helper] plugin
-+
-More on this below.
-
-* link:https://github.com/asciidoctor/asciidoctor-intellij-plugin[AsciiDoctor] plugin
-+
-Useful if you are doing any authoring of documents.
-
-Some others you might like to explore are:
-
-.IntelliJ Plugins
-image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png[width="600px"]
-==== Maven Helper Plugin
-This plugin provides a couple of great features. One is better visualization of dependency trees (similar to Eclipse).
-
-If you open a `pom.xml` file, you'll see an additional "Dependencies" tab:
-
-image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/010-dependency-tab.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/010-dependency-tab.png"]
-
-Clicking on this gives a graphical tree representation of the dependencies, similar to that obtained by `mvn dependency:tree`, but filterable.
-
-image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/020-dependency-as-tree.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/020-dependency-as-tree.png"]
-
-The plugin also provides the ability to easily run a Maven goal on a project:
-
-image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/030-maven-run-goal.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/030-maven-run-goal.png"]
-
-This menu can also be bound to a keystroke so that it is available as a pop-up:
-
-image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/040-maven-quick-run.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/040-maven-quick-run.png"]
-
-
-
-== Importing and Managing Maven Modules
+== Importing Maven Modules
Let's load in some actual code! We do this by importing the Maven modules.
@@ -282,7 +243,7 @@ image::{_imagesdir}appendices/dev-env/intellij-idea/110-running-the-app/050-runn
== Hints and Tips
-=== Keyboard Shortcuts Cheat Sheets
+=== Keyboard Cheat Sheets
You can download 1-page PDFs cheat sheets for IntelliJ's keyboard shortcuts:
* for link:https://www.jetbrains.com/idea/docs/IntelliJIDEA_ReferenceCard.pdf[Windows]
@@ -294,7 +255,7 @@ Probably the most important shortcut on them is for `Find Action`:
This will let you search for any action just by typing its name.
-### Switching between Tool Windows and Editors
+### Switch between Tools & Editors
The Tool Windows are the views around the editor (to left, bottom and right). It's possible to move these around to your preferred locations.
@@ -365,6 +326,46 @@ Loads of good stuff on the `Refactor` menu; most used are:
If you can't remember all those shortcuts, just use `ctrl-shift-alt-T` (might want to rebind that to something else!) and get a context-sensitive list of refactorings available for the currently selected object
+=== Plugins
+
+You might want to set up some additional plugins. You can do this using `File > Settings > Plugins` (or equivalently `File > Other Settings > Configure Plugins`).
+
+Recommended are:
+
+* link:https://plugins.jetbrains.com/plugin/7179?pr=idea[Maven Helper] plugin
++
+More on this below.
+
+* link:https://github.com/asciidoctor/asciidoctor-intellij-plugin[AsciiDoctor] plugin
++
+Useful if you are doing any authoring of documents.
+
+Some others you might like to explore are:
+
+.IntelliJ Plugins
+image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/020-some-plugins-confirmation.png[width="600px"]
+
+==== Maven Helper Plugin
+
+This plugin provides a couple of great features. One is better visualization of dependency trees (similar to Eclipse).
+
+If you open a `pom.xml` file, you'll see an additional "Dependencies" tab:
+
+image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/010-dependency-tab.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/010-dependency-tab.png"]
+
+Clicking on this gives a graphical tree representation of the dependencies, similar to that obtained by `mvn dependency:tree`, but filterable.
+
+image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/020-dependency-as-tree.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/020-dependency-as-tree.png"]
+
+The plugin also provides the ability to easily run a Maven goal on a project:
+
+image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/030-maven-run-goal.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/030-maven-run-goal.png"]
+
+This menu can also be bound to a keystroke so that it is available as a pop-up:
+
+image::{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/040-maven-quick-run.png[width="600px",link="{_imagesdir}appendices/dev-env/intellij-idea/050-some-plugins/maven-helper/040-maven-quick-run.png"]
+
+
=== Troubleshooting
When a Maven module is imported, IntelliJ generates its own project files (suffix `.ipr`), and the application is actually built from that.