WIP: add additional resources and images

doc.zih.tu-dresden.de/docs/access/ssh_mit_putty.md

@@ -2,26 +2,25 @@
 
 To work at an HPC system at ZIH you need
 
-- a program that provides you a command shell (like \<a
-    href="<http://www.chiark.greenend.org.uk/%7Esgtatham/putty/download.html>"
-    target="\_top">"putty"\</a> or \<a
-    href="<http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/dienste/datennetz_dienste/secure_shell/>"
-    target="\_top">"Secure Shell ssh3.2"\</a>; both free)\<br /> (The
-    putty.exe is only to download at the desctop. (No installation))
+- a program that provides you a command shell (like
+  [PuTTY](http://www.chiark.greenend.org.uk/%7Esgtatham/putty/download.html)
+  or
+  [Secure Shell ssh3.2](http://tu-dresden.de/die_tu_dresden/zentrale_einrichtungen/zih/dienste/datennetz_dienste/secure_shell/);
+  both free) (The putty.exe is only to download at the desktop. (No installation))
 
 and if you would like to use graphical software from the HPC system
 
-- an X-Server (like [X-Ming](<http://www.straightrunning.com/XmingNotes/)
+- an X-Server (like [X-Ming](http://www.straightrunning.com/XmingNotes/)
   or [CygWin32](http://www.cygwin.com/cygwin/)
 
-at your local PC. Here, you can find installation descriptions for the X
-servers: [X-Ming Installation] **todo** 
-<!--href="<https://doc.zih.tu-dresden.de/hpc-wiki/pub/Compendium/Login/install-Xming.pdf>"-->
-[CygWin Installation] **todo**
-<!--https://doc.zih.tu-dresden.de/hpc-wiki/pub/Compendium/Login/cygwin_doku_de.pdf-->
+at your local PC. Here, you can find installation descriptions for the X servers:
+[X-Ming Installation](misc/install-Xming.pdf)
+
+[CygWin Installation](misc/cygwin_doku_de.pdf)
+
 Please note: You have also to install additional fonts for X-Ming at your PC. (also to find at
-[this website](http://www.straightrunning.com/XmingNotes/).
-If you would like transfer files between your PC and an HPC machine, you should also have
+[this website](http://www.straightrunning.com/XmingNotes/).  If you would like transfer files
+between your PC and an HPC machine, you should also have
 
 - [WinSCP](http://winscp.net/eng/docs/lang:de>) (an SCP program is also included in the
   "Secure Shell ssh3.2" software; see above)
@@ -38,37 +37,48 @@ will get an new icon (a black X for X-Ming).  Now you can start putty.exe. A win
 where you have to give the name of the computer and you have to switch ON the "X11 forwarding".
 (please look at the figures)
 
-\<img alt="" src="%PUBURL%/Compendium/Login/putty1.jpg" title="putty:
-name of HPC-machine" width="300" /> \<img alt=""
-src="%PUBURL%/Compendium/Login/putty2.jpg" title="putty: switch on X11"
-width="300" /> \<br />
+![PuTTY: Name of HPC System](misc/putty1.jpg)
+
+![PuTTY: Switch on X11](misc/putty2.jpg){: align="center"}
 
-Now you can "Open" the connection. You will get a window from the remote
-machine, where you can put your linux commands. If you would like to use
-commercial software, please follow the next instructions about the
-modules.
+<!--\<img alt="" src="%PUBURL%/Compendium/Login/putty1.jpg" title="putty:-->
+<!--name of HPC-machine" width="300" /> \<img alt=""-->
+<!--src="%PUBURL%/Compendium/Login/putty2.jpg" title="putty: switch on X11"-->
+<!--width="300" /> \<br />-->
 
-## Copy Files From the HRSK Machines to Your Local Machine
+Now you can *Open* the connection. You will get a window from the remote machine, where you can put
+your Linux commands. If you would like to use commercial software, please follow the next
+instructions about the modules.
 
-Take the following steps if your Workstation has a Windows operating
-system. You need putty (see above) and your favorite SCP program, in
-this example WinSCP.
+## Copy Files from the HRSK Machines to Your Local Machine
 
-- Make a connection to login1.zih.tu-dresden.de\<br /> \<img
-  alt="tunnel1.png" src="%PUBURL%/Compendium/Login/tunnel1.png"
-  width="300" />
+Take the following steps if your Workstation has a Windows operating system. You need putty (see
+above) and your favorite SCP program, in this example WinSCP.
+
+- Make a connection to `login1.zih.tu-dresden.de`
+  ![Tunnel 1](misc/tunnel1.png)
+  <!--\<br /> \<img-->
+  <!--alt="tunnel1.png" src="%PUBURL%/Compendium/Login/tunnel1.png"-->
+  <!--width="300" />-->
 - Setup SSH tunnel (data from your machine port 1222 will be directed
-  to deimos port 22)\<br /> \<img alt="tunnel2.png"
-  src="%PUBURL%/Compendium/Login/tunnel2.png" width="300" />
-- After clicking on the "Add" button, the tunnel should look like
-  that\<br /> \<img alt="tunnel3.png"
-  src="%PUBURL%/Compendium/Login/tunnel3.png" width="300" />
+  to deimos port 22)
+  ![Tunnel 2](misc/tunnel2.png)
+  <!--\<br /> \<img alt="tunnel2.png"-->
+  <!--src="%PUBURL%/Compendium/Login/tunnel2.png" width="300" />-->
+- After clicking on the "Add" button, the tunnel should look like that
+  ![Tunnel 3](misc/tunnel3.png)
+  <!--\<br /> \<img alt="tunnel3.png"-->
+  <!--src="%PUBURL%/Compendium/Login/tunnel3.png" width="300" />-->
 - Click "Open" and enter your login and password (upon successful
-  login, the tunnel will exist)\<br /> \<img alt="tunnel4.png"
-  src="%PUBURL%/Compendium/Login/tunnel4.png" width="300" />
+  login, the tunnel will exist)
+  ![Tunnel 4](misc/tunnel4.png)
+  <!--\<br /> \<img alt="tunnel4.png"-->
+  <!--src="%PUBURL%/Compendium/Login/tunnel4.png" width="300" />-->
 - Put the putty window in the background (leave it running) and open
-  WinSCP (or your favorite SCP program), connect to localhost:1222\<br
-  /> \<img alt="tunnel5.png"
-  src="%PUBURL%/Compendium/Login/tunnel5.png" width="300" />
+  WinSCP (or your favorite SCP program), connect to localhost:1222
+
+  ![Tunnel 5](misc/tunnel5.png)
+  <!--\<br/> \<img alt="tunnel5.png"-->
+  <!--src="%PUBURL%/Compendium/Login/tunnel5.png" width="300" />-->
 - After hitting "Login" and entering your username/password, you can
   access your files on deimos.