diff --git a/Doc/Sd1/Ref/GettingStarted/idea.png b/Doc/Sd1/Ref/GettingStarted/idea.png new file mode 100644 index 0000000000000000000000000000000000000000..78a364f2356714f8da8ab3642021f0785f71710b Binary files /dev/null and b/Doc/Sd1/Ref/GettingStarted/idea.png differ diff --git a/Doc/Sd1/gettingStarted.xml b/Doc/Sd1/gettingStarted.xml index d58bb022ee27576874a33672ca9398c4f16f5a58..f68bffd8fdc42eeab28661d26bd4556cecb72207 100644 --- a/Doc/Sd1/gettingStarted.xml +++ b/Doc/Sd1/gettingStarted.xml @@ -57,22 +57,25 @@ </itemizedlist> </glossdef> </glossentry> + </glosslist> + </figure> - <glossentry> - <glossterm>Online <xref linkend="glo_Java"/> programming - tutorial</glossterm> + <figure xml:id="sd1_fig_onlineRurorial"> + <title>Online <xref linkend="glo_Java"/> programming tutorial</title> - <glossdef> - <para>The <quote - xlink:href="https://www.udemy.com/java-tutorial/learn/v4/content">Java - Tutorial for Complete Beginners</quote> allows for free access - requiring either creating a local account or logging in via an - existing <orgname>Google+</orgname> or <orgname>Facebook</orgname> - account. It offers both a series of video tutorials and related - source code examples for download.</para> - </glossdef> - </glossentry> + <para>The <quote + xlink:href="https://www.udemy.com/java-tutorial/learn/v4/content">Java + Tutorial for Complete Beginners</quote> offers both a series of video + tutorials and related source code examples for download.</para> + + <para>Free access requiring either a local account or logging in via + <orgname>Google+</orgname> or <orgname>Facebook.</orgname></para> + </figure> + + <figure xml:id="sd1_fig_unixIntro"> + <title>Unix and the terminal</title> + <glosslist> <glossentry xml:id="glossSda1LectureUnixShell"> <glossterm>UNIX shell introduction</glossterm> @@ -80,9 +83,9 @@ <itemizedlist> <listitem> <para><link - xlink:href="https://software-carpentry.org/v4/shell">The Unix - Shell</link> / Software-carpentry, nice video collection. Each - section is also available in PDF and + xlink:href="https://swcarpentry.github.io/shell-novice">The + Unix Shell</link> / Software-carpentry, nice video collection. + Each section is also available in PDF and <trademark>PowerPoint</trademark> format.</para> </listitem> @@ -104,89 +107,31 @@ </glosslist> </figure> - <figure xml:id="sd1_fig_unixIntro"> - <title>Unix and the terminal</title> + <figure xml:id="sd1_fig_programmingExercises"> + <title>Online programming, automated feedback</title> <glosslist> - <glossentry xml:id="glossSda1PrimaryLectures"> - <glossterm>Primary</glossterm> - - <glossdef> - <itemizedlist> - <listitem> - <para><xref linkend="bib_Kurniawan2015"/>.</para> - </listitem> - </itemizedlist> - </glossdef> - </glossentry> - - <glossentry xml:id="glossSda1SecondaryLectures"> - <glossterm>Secondary</glossterm> - - <glossdef> - <itemizedlist> - <listitem> - <para xml:lang="de">Older free online version <link - xlink:href="http://openbook.rheinwerk-verlag.de/javainsel">Java - ist auch eine Insel</link> of current book <xref - linkend="bib_Ullenboom2014"/> including <xref - linkend="glo_Java"/> 8.</para> - </listitem> - - <listitem> - <para><link - xlink:href="http://shop.oreilly.com/product/9780596009205.do">Head - First Java, 2nd Edition</link>. German translation <link - xlink:href="http://www.oreilly.de/catalog/hfjava2ger">Java von - Kopf bis Fuß</link> available.</para> - </listitem> - - <listitem> - <para><xref linkend="bib_Jobst2014"/>.</para> - </listitem> - </itemizedlist> - </glossdef> - </glossentry> - <glossentry> - <glossterm>Online <xref linkend="glo_Java"/> programming - tutorial</glossterm> + <glossterm><link + xlink:href="http://codingbat.com">http://codingbat.com</link></glossterm> <glossdef> - <para>The <quote - xlink:href="https://www.udemy.com/java-tutorial/learn/v4/content">Java - Tutorial for Complete Beginners</quote> allows for free access - requiring either creating a local account or logging in via an - existing <orgname>Google+</orgname> or <orgname>Facebook</orgname> - account. It offers both a series of video tutorials and related - source code examples for download.</para> + <para>No registration required.</para> </glossdef> </glossentry> - <glossentry xml:id="glossSda1LectureUnixShell"> - <glossterm>UNIX shell introduction</glossterm> + <glossentry> + <glossterm><link + xlink:href="https://www.programmr.com/zone/java">https://www.programmr.com/zone/java</link></glossterm> <glossdef> <itemizedlist> <listitem> - <para><link - xlink:href="https://software-carpentry.org/v4/shell">The Unix - Shell</link> / Software-carpentry, nice video collection. Each - section is also available in PDF and - <trademark>PowerPoint</trademark> format.</para> + <para>Hunt for <quote>Challenges</quote> within page.</para> </listitem> <listitem> - <para><link - xlink:href="http://www.ee.surrey.ac.uk/Teaching/Unix">UNIX - Tutorial for Beginners</link>, text oriented.</para> - </listitem> - - <listitem> - <para><link - xlink:href="http://vic.gedris.org/Manual-ShellIntro/1.2/ShellIntro.pdf">An - Introduction to ...</link>, small reference of important - command names, filename conventions etc.</para> + <para>Registration required.</para> </listitem> </itemizedlist> </glossdef> @@ -194,183 +139,144 @@ </glosslist> </figure> - <glosslist> - <glossentry> - <glossterm>Supplementary exercises providing automated - feedback</glossterm> + <figure xml:id="sd1_fig_javaVisualizer"> + <title>Java Visualizer</title> - <glossdef> - <para><link - xlink:href="http://codingbat.com">http://codingbat.com</link></para> - </glossdef> - </glossentry> + <para><link + xlink:href="https://prog.mi.hdm-stuttgart.de/java_visualize/visualize.html">http://prog.mi.hdm-stuttgart.de/java_visualize/visualize.html</link></para> - <glossentry> - <glossterm>Java Visualizer</glossterm> + <para>Help understanding a <xref linkend="glo_Java"/> program's internal + memory management: Stack and heap</para> - <glossdef> - <para>This will help you understanding a <xref linkend="glo_Java"/> - program's memory management:</para> + <para>Credits to <link + xlink:href="https://github.com/pgbovine/OnlinePythonTutor/graphs/contributors">David + Pritchard et. alt</link>.</para> + </figure> - <para><link - xlink:href="https://prog.mi.hdm-stuttgart.de/java_visualize/visualize.html">http://prog.mi.hdm-stuttgart.de/java_visualize/visualize.html</link></para> + <figure xml:id="sd1_fig_liveLectureAdditions"> + <title>Live lecture additions</title> - <para>Credits to <link - xlink:href="https://github.com/pgbovine/OnlinePythonTutor/graphs/contributors">David - Pritchard et. alt</link>.</para> - </glossdef> - </glossentry> + <para><uri + xlink:href="https://cloud.mi.hdm-stuttgart.de/owncloud/index.php/s/df9f296af3298f96361a15a679390e59">https://cloud.mi.hdm-stuttgart.de/owncloud/index.php/s/df9f296af3298f96361a15a679390e59</uri></para> - <glossentry xml:id="glossSda1LiveLectureAdditions"> - <glossterm>Live lecture additions</glossterm> + <para>Access to code being discussed during the lectures.</para> + </figure> - <glossdef> - <para><uri - xlink:href="https://cloud.mi.hdm-stuttgart.de/owncloud/index.php/s/df9f296af3298f96361a15a679390e59">https://cloud.mi.hdm-stuttgart.de/owncloud/index.php/s/df9f296af3298f96361a15a679390e59</uri></para> - </glossdef> - </glossentry> + <figure xml:id="sd1_fig_IntelliJidea"> + <title><xref linkend="glo_Soft_IntellijIDEA"/> <xref + linkend="glo_IDE"/></title> - <glossentry xml:id="glossSda1EclipseDownload"> - <glossterm><xref linkend="glo_Soft_IntellijIDEA"/> <xref - linkend="glo_IDE"/></glossterm> + <mediaobject> + <imageobject> + <imagedata fileref="Ref/GettingStarted/idea.png"/> + </imageobject> + </mediaobject> - <glossdef> - <para>See <link linkend="sd1SectToolsOfTheTrade1">installation - details</link>.</para> - </glossdef> - </glossentry> + <para>See <link linkend="sd1SectToolsOfTheTrade1">installation + details</link>.</para> + </figure> - <glossentry xml:id="virtualboxCsmImage"> - <glossterm><trademark - xlink:href="https://www.virtualbox.org">Virtualbox</trademark> image / - native (dual boot) installation</glossterm> + <figure xml:id="sd1_fig_VirtualboxImage"> + <title><trademark + xlink:href="https://www.virtualbox.org">Virtualbox</trademark> image / + native (dual boot) installation</title> + + <para>A <trademark + xlink:href="https://www.virtualbox.org">Virtualbox</trademark> <link + xlink:href="https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox">Linux + image with MI supplements</link> as <filename + xlink:href="https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/mibuntu.rar">mibuntu.rar</filename> + (compressed) or <filename + xlink:href="https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/mibuntu.vdi">mibuntu.vdi</filename> + (uncompressed)</para> + + <caution> + <itemizedlist> + <listitem> + <para>Mind the subsequent setting related hints.</para> + </listitem> - <glossdef> - <para>A <trademark - xlink:href="https://www.virtualbox.org">Virtualbox</trademark> - <productname>Ubuntu</productname> 16.04 based image containing MI - added software components is available at <uri - xlink:href="https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox">https://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox</uri> - in the following formats:</para> + <listitem> + <para>The beast is quite big! You may prefer a wired connection in + favour of WiFi.</para> + </listitem> + </itemizedlist> + </caution> + </figure> - <glosslist> - <glossentry> - <glossterm>Compressed:</glossterm> + <para>The following <trademark + xlink:href="https://www.virtualbox.org">Virtualbox</trademark> settings + are particularly helpful:</para> - <glossdef> - <para><filename>mibuntu.rar</filename> or - <filename>mibuntu.vdi.xz</filename></para> - </glossdef> - </glossentry> + <orderedlist> + <listitem> + <para>Settings below <option>General</option> --> + <option>Advanced</option> allow for text exchange between host and + guest.</para> + </listitem> - <glossentry> - <glossterm>Uncompressed:</glossterm> + <listitem> + <para><option>Display</option> --> <option>Screen</option> --> + <option>Video Memory</option> should be set to maximum possible + value.</para> + </listitem> - <glossdef> - <para><filename>mibuntu.vdi</filename></para> - </glossdef> - </glossentry> - </glosslist> + <listitem> + <para><option>Network</option> --> <option>AdapterX</option> --> + <option>Advanced</option> --> <option>Adapter type</option> should + be set to <quote>Paravirtualized Network (virtio-net)</quote>.</para> + </listitem> - <caution> - <itemizedlist> - <listitem> - <para><xref linkend="glo_Ftp"/> access <uri - xlink:href="ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox/mibuntu.rar">ftp://mirror.mi.hdm-stuttgart.de/ubuntu/VirtualBox</uri> - requires <acronym - xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">VPN</acronym>.</para> - </listitem> + <listitem> + <para>You may want to install the <link + xlink:href="https://www.virtualbox.org/wiki/Downloads">Oracle VM + VirtualBox Extension Pack</link> on your host system. The MI guest + image already contains the appropriate »guest additions« which allow + for e.g. <link + xlink:href="https://askubuntu.com/questions/366742/how-to-share-the-files-from-host-to-guest-in-virtual-box-host-ubunutu-guest-ubu">exchanging + files between host and guest</link>.</para> + </listitem> + </orderedlist> + + <para>If you experience bad <productname>Virtualbox</productname> + performance on your system please consider <link + xlink:href="http://blog.jdpfu.com/2012/09/14/solution-for-slow-ubuntu-in-virtualbox">solution-for-slow-ubuntu-in-virtualbox</link> + and the <link + xlink:href="http://blog.jdpfu.com/ALE/ALE-NW/Ubuntu-12.04-x32-install.pdf">referenced + collection of screenshots</link>.</para> + + <para>The image (hopefully) contains all related <link + xlink:href="https://www.mi.hdm-stuttgart.de">CSM</link> department tools + being installed on Linux in the lecture rooms with respect to the current + and upcoming lectures.</para> + + <para>If you experience bad <productname>Virtualbox</productname> + performance on your system please consider <link + xlink:href="http://blog.jdpfu.com/2012/09/14/solution-for-slow-ubuntu-in-virtualbox">solution-for-slow-ubuntu-in-virtualbox</link> + and the <link + xlink:href="http://blog.jdpfu.com/ALE/ALE-NW/Ubuntu-12.04-x32-install.pdf">referenced + collection of screenshots</link>.</para> + + <figure xml:id="sd1_fig_alternateLinuxInstall"> + <title>Alternatives using Linux</title> - <listitem> - <para>The beast is quite big! You may prefer a wired - connection in favour of WiFi.</para> - </listitem> - </itemizedlist> - </caution> + <itemizedlist> + <listitem> + <para>Native or dual boot <orgname + xlink:href="https://www.ubuntu.com">Ubuntu</orgname> <quote + xlink:href="https://www.ubuntu.com/download/desktop">Desktop</quote> + installation.</para> + </listitem> - <para>The following <trademark + <listitem> + <para>Use <productname + xlink:href="https://my.vmware.com/en/web/vmware/free#desktop_end_user_computing/vmware_workstation_player/14_0">VMware + Workstation Player</productname> in favour of <trademark xlink:href="https://www.virtualbox.org">Virtualbox</trademark> - settings are particularly helpful:</para> - - <orderedlist> - <listitem> - <para>Settings below <option>General</option> --> - <option>Advanced</option> allow for text exchange between host - and guest.</para> - </listitem> - - <listitem> - <para><option>Display</option> --> <option>Screen</option> - --> <option>Video Memory</option> should be set to maximum - possible value.</para> - </listitem> - - <listitem> - <para><option>Network</option> --> <option>AdapterX</option> - --> <option>Advanced</option> --> <option>Adapter - type</option> should be set to <quote>Paravirtualized Network - (virtio-net)</quote>.</para> - </listitem> - - <listitem> - <para>You may want to install the <link - xlink:href="https://www.virtualbox.org/wiki/Downloads">Oracle VM - VirtualBox Extension Pack</link> on your host system. The MI - guest image already contains the appropriate »guest additions« - which allow for e.g. <link - xlink:href="https://askubuntu.com/questions/366742/how-to-share-the-files-from-host-to-guest-in-virtual-box-host-ubunutu-guest-ubu">exchanging - files between host and guest</link>.</para> - </listitem> - </orderedlist> - - <para>If you experience bad <productname>Virtualbox</productname> - performance on your system please consider <link - xlink:href="http://blog.jdpfu.com/2012/09/14/solution-for-slow-ubuntu-in-virtualbox">solution-for-slow-ubuntu-in-virtualbox</link> - and the <link - xlink:href="http://blog.jdpfu.com/ALE/ALE-NW/Ubuntu-12.04-x32-install.pdf">referenced - collection of screenshots</link>.</para> - - <para>The image (hopefully) contains all related <link - xlink:href="https://www.mi.hdm-stuttgart.de">CSM</link> department - tools being installed on Linux in the lecture rooms with respect to - the current and upcoming lectures:</para> - - <itemizedlist> - <listitem> - <para>IntelliJ <quote>Ultimate</quote> edition.</para> - </listitem> - - <listitem> - <para>A running <productname - xlink:href="https://www.mysql.com/">Mysql</productname> server - preconfigured with user <quote><code>hdmuser</code></quote>, - password <quote><code>XYZ</code></quote> (<emphasis - role="bold">capital letters!</emphasis>) and database - <quote><code>hdm</code></quote>.</para> - </listitem> - - <listitem> - <para><productname - xlink:href="http://www.xmlmind.com/xmleditor">Xmlmind XML - editor</productname> for visually editing technical documents - based on <productname - xlink:href="http://docbook.org/tdg5/index.html">docbook</productname> - or <productname - xlink:href="https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture">DITA</productname>.</para> - </listitem> - </itemizedlist> - - <caution> - <para>If the VirtualBox solution does not work for you we highly - recommend a native (possibly dual boot) <orgname - xlink:href="http://www.ubuntu.com">Ubuntu</orgname> 16.04 <quote - xlink:href="http://www.ubuntu.com/download/desktop">Desktop</quote> - installation to get the <quote>look and feel</quote> with respect - to the online examination.</para> - </caution> - </glossdef> - </glossentry> - </glosslist> + installing Linux on top of your operating system.</para> + </listitem> + </itemizedlist> + </figure> </section> <section xml:id="sd1_sect_usingTheExercises">