Difference between revisions of "Tutorial:Einführung"

From Freepascal Amiga wiki
Jump to: navigation, search
(Initial contents for Tutorial Start german, needs some more work)
 
(some more german translation)
Line 47: Line 47:
 
[[File:Tut3.png]]
 
[[File:Tut3.png]]
  
<!--
+
In der linken oberen Ecke ist der Schliessknopf (das kleine grüne Quadrat). Die Titelzeile des Fensters zeigt den derzeitigen Filenamen. Das Fenster kann verschoben werden, indem man auf die Titelleiste klickt und das Fenster zieht (natürlich sollte man das Fenster etwas verkleinern). Die "1" and der rechten oberen Seite steht für die Nummer des Editorfensters, damit man die Fenster einfacher unterscheiden kann. Der grüne Pfeil daneben maximiert das Fenster oder stellt die Größe wieder her.
In der  
+
Auf der rechten Seite sieht man einen karierten Bereich mit zwei Pfeilen oben und unten. Dies ist ein Rollbalken wie man sie auch vom Amiga her kennt, und die funktioniert auch ähnlich, nur das er nicht proportional ist. Der Slider ist also immer gleich groß (ein blaues Quadrat wie im unteren Rollbalken sichtbar) und zeigt die Position an.
On the left upper side we have the close Button (the little green square). The title line with the current file name can be used to move the window around and double click maximize or restore the window (of course the size has to be reduced before to see an effect, just keep reading). The one at the upper right side indicates the number of the editor window. The green arrow next to it is used to maximize and restore the window.
+
Der untere Rand hat auch einen Rollbalken für die horizontale Richtung. Die grüne Ecke zwischen den beiden Rollbalken dient zum Verändern der Größe des Fensters, wie man es auch von normalen Amiga Fenstern kennt.  
On the right side you can see a checkered area with two arrow which represents the scrollbar for the editor text, it works exactly like the Amiga one (But it is not proportional just a blue square represent the current position as visible at the lower border). The lower border as the same scroll bar for the horizontal direction. Between the two scrollbars in the lower left corner is the size gadget, click and drag to resize the window.
+
Neben der unteren Rollbalken auf der linken Seite zeigt die derzeitige Position der Schreibmarke, <code>1:1</code> im Moment.
on the left lower side the current line and char in line is shown, <code>1:1</code> at the moment.
+
Im Editor kann man die Schreibmarke als blinkenden Linie, wo wir unser Programm eingeben können.
In the editor you can see the blinking cursor where you can type program.
+
 
We want to type in out very first program, of course "Hello World"
+
So jetzt wollen wir aber unser erstes Programm schreiben, natürlich das berühmte "Hello World".
 
<source lang="pascal">
 
<source lang="pascal">
program helloworld;
+
program HelloWorld;
 
begin
 
begin
 
   writeln('Hello World');
 
   writeln('Hello World');
 
end.
 
end.
 
</source>
 
</source>
Sometimes it's difficult to find the right quotation mark, especially on UAE (on a german keyboard seems Alt+Ä does work, for english it should be the single quotation mark directly on the keyboard). If you found the right key it should show the quotation mark in turquoise color, if it is yellow then it's the wrong one. Notice that behind the last <code>end</code> there should be a point.
+
Manchmal ist es etwas schwierig das richtige Anführungszeichen für Zeichenketten zu finden, for allem mit UAE. (Auf meiner deutschen Tastatur A1200 ist es auf Alt+Ä, man kann auch probieren auf englische Tastatur umzuschalten dann sollte es die Erstbelegung der "Ä" Taste sein, bzw. die Tast die sich dort befindet bei anderssprachiger Bedruckung).
 +
Ob es das richtige Anführungszeichen ist ist einfach zu erkennen, die Farbe des textes dahinter (und auch das Zeichen selbst) ändert sich zu türkis (sonst gelb oder weiß)
 +
Achtung hinter dem Letzen "end" ist immer ein Punkt (kein Semikolon)
  
 
[[File:Tut4.png]]
 
[[File:Tut4.png]]
  
Before we can compile and run that, we have to save it. To Save the file one can use the Menu entry or press F2. The save as dialog Window will open. To navigate type the path into the edit field for <code>Name</code> and press Enter key e.g. <code>work:</code> the contents of the Drawer/Device will be shown in the area underneath. Use Mouse or cursorkeys + Enter to navigate where you want to save your file (<code>../</code> means parent directory and is always at the end of the list). e.g. Work:Sources in this example as you can see in the lower part of the dialog window.
+
Bevor wir das Programm übersetzen (kompilieren) können, müssen wir es Abspeichern, dafür kann man entweder den Menü Eintrag (Save im File Menu) auswählen oder man kann wie in der Hotkey Zeile angezeigt F2 drücken.
In the <code>Name</code> edit field the currently selected file name is written delete the name and type in <code>helloworld.pas</code> and press enter or press <code>OK</code>.
+
Der Speicherdialog öffnet sich. Der funktioniert etwas anders als man es vom Amiga gewöhnt ist. Um zu einem Laufwerk zu wechseln einfach den Pfad in das <code>Name</code> Feld eingeben und Enter drücken. Der Inhalt des Verzeichnisses wird dann darunter in der Liste angezeigt. Dort kann man dann Verzeichnisse oder Dateien mit der Maus oder den Pfeiltasten (+ Enter) auswählen, sich durch die Verzeichnisstruktur bewegen und einen Ort für die Datei finden (Mit <code>../</code> am Ende jeder Liste kann man in das Überverzeichnis wechseln). z.B. Work:Sources in diesem Beispiel wie man es auch im unteren Bereich des Speicherdialogs erkennen kann.
 +
Im <code>Name</code> Feld wird immer der Name der angewählten Datei angezeigt, wir löschen den Inhalt und tippen <code>helloworld.pas</code> und drücken Enter oder drücken auf den <code>OK</code> Knopf.
  
 
[[File:Tut5.png]]
 
[[File:Tut5.png]]
 
+
<!--
 
Now we can compile our program, press F9 or choose Compile from the Compile Menu. Depending on your computer (especially Hardrive speed) it will need some time to compile (a real Amiga around 30 s, NG Amiga should be only some seconds).
 
Now we can compile our program, press F9 or choose Compile from the Compile Menu. Depending on your computer (especially Hardrive speed) it will need some time to compile (a real Amiga around 30 s, NG Amiga should be only some seconds).
 
FP-IDE should now tell you "Compile successfully: Press any key" if not, it found some errors. A green window opens with the error messages. Try to check the source carefully for typing errors (also care about the colors, which can give you a hint about wrong chars). The compiler should tell you the position of error, navigate to the error and press enter to jump to the position of the error. If you have no idea maybe you want to ask me on Forum or IRC whats wrong.
 
FP-IDE should now tell you "Compile successfully: Press any key" if not, it found some errors. A green window opens with the error messages. Try to check the source carefully for typing errors (also care about the colors, which can give you a hint about wrong chars). The compiler should tell you the position of error, navigate to the error and press enter to jump to the position of the error. If you have no idea maybe you want to ask me on Forum or IRC whats wrong.

Revision as of 20:49, 6 February 2017

Installation

Englische Installationsanleitungen:

Eine kurze Anleitung in deutsch:

  • Release Archiv für deine Plattform herunterladen z.B. von hier [1]
    • Amiga OS3 = m68k-amiga
    • Amiga OS4 = powerpc-amiga
    • AROS = i386-aros, x86_64-aros, arm-aros
    • MorphOS = powerpc-morphos
  • Entpacken des Archivs mit deinem bevorzugtem Entpacker. Im Archiv ist eine Ordner namens pp mit Icon, man kann also den Ordner auch erstmal nach RAM: entpacken und dann hinschieben wo man es möchte.
  • AROS: Öffne eine Shell, navigiere zum pp Ordner und gebe ein: execute install, neu booten, fertig. User-startup muss daher auf AROS nicht editiert werden.
  • user-startup editieren und am ende anfügen (nicht AROS):
    • erstellen eines Assigns FreePascal: zum pp Ordner e.g. assign FreePascal: Work:pp
    • setzen des Pfades zum compiler:
      • AmigaOS3: path FreePascal:bin/m68k-amiga add
      • AmigaOS4: path FreePascal:bin/powerpc-amiga add
      • MorphOS: path FreePascal:bin/powerpc-morphos add

Grundlegende Benutzung

Kommandozeile

Üblicherweise benutzt man den Kommandozeilencompiler fpc aber in diesem Tutorial wollen wir vor allem die FP-IDE benutzen daher gibt es hier nur eine kurze Einführung für den Kommandozeilencompiler

  • Shell öffnen
  • fpc -l eingeben, freepascal Meldet sich mit einigen Versionsinformationen (und beschewrt sich das keine Source datei angegeben wurde). Wenn das erscheint wurde der Compiler richtig installiert.
  • Um einen Pascal file zu compilieren fpc source.pas eingeben. Pascal files habend meistens die Fileendung .pas andere Pascalcompiler benutzen oftmals .pp oder .p
  • Um Lazarusprojekte zu compilieren, benutze das .lpr file fpc lazarusproject.lpr falls das eine Delphi kompatibles Projekt ist könnte es auch .dpr sein.

FP-IDE

Die FreePascal IDE ist ein auf ANSI Zeichen basierender Editor mit einem enthaltenem Pascal Compiler, wir der sehr bekannte Turbo Pascal unter MS-DOS. Es benutzt das FreeVision Paket. Das ist ein Open Source Paket mit vergleichbarer Oberfläche wir TurboVision bei TurboPascal. FP-IDE läuft am besten mit mindestens einen 8 Farben Bildschirm (mehr ist natürlich besser), es funktioniert auch mit einem 4 Farbbildschirm, aber dann sieht es etwas seltsam aus und man kann vielleicht einige Schriften nicht richtig lesen. Gehe zur FreePascal Schublade. Dort gibt es ein Piktogram für die FP-IDE.

Tut1.png

Zum Starten einfach doppelt klicken. Es öffnet sich ein Fenster mit dem FP-IDE Desktop. Außerdem öffnet sich ein Shell Fenster wo Ausgaben der gestarteten Programme erscheinen. Es ist eine gute Idee die beiden Fenster so anzuordnen, dass man beide sehen kann.

Tut2.png

Oben im Hautpfenster kann man die Menuzeile sehen. Es ist ein altes DOS basierendes Programm, daher funktioniert das Menu ein wenig anders als auf dem Amiga. Man kann die Maus benutzen, allerdings wählt man die Menus mit der linken Taste aus. Alternativ kann man die linke Alt Taste drücken und dazu einen der roten Buchstaben in der Menüzeile, damit öffnet sie das betreffende Menü, jetzt kann man einen weiteren Buchstaben drücken um den jeweilige Eintrag zu starten. Oder man benutzt die Pfeiltasten und Enter Taste um Einträge auszuwählen. In der Mitte des Fensters werden später die Editorfenster erscheinen. In der unteren Zeile sind einige Hotkeys gezeigt.

Als erstes wollen wir ein neues File erstellen, dafür öffnet man das File Menü und wählt New aus. Ein neues Editorfenster öffnet sich. (Zum rumspielen ruhig mal noch mehr öffnen um zu lernen wie die funktionieren)

Tut3.png

In der linken oberen Ecke ist der Schliessknopf (das kleine grüne Quadrat). Die Titelzeile des Fensters zeigt den derzeitigen Filenamen. Das Fenster kann verschoben werden, indem man auf die Titelleiste klickt und das Fenster zieht (natürlich sollte man das Fenster etwas verkleinern). Die "1" and der rechten oberen Seite steht für die Nummer des Editorfensters, damit man die Fenster einfacher unterscheiden kann. Der grüne Pfeil daneben maximiert das Fenster oder stellt die Größe wieder her. Auf der rechten Seite sieht man einen karierten Bereich mit zwei Pfeilen oben und unten. Dies ist ein Rollbalken wie man sie auch vom Amiga her kennt, und die funktioniert auch ähnlich, nur das er nicht proportional ist. Der Slider ist also immer gleich groß (ein blaues Quadrat wie im unteren Rollbalken sichtbar) und zeigt die Position an. Der untere Rand hat auch einen Rollbalken für die horizontale Richtung. Die grüne Ecke zwischen den beiden Rollbalken dient zum Verändern der Größe des Fensters, wie man es auch von normalen Amiga Fenstern kennt. Neben der unteren Rollbalken auf der linken Seite zeigt die derzeitige Position der Schreibmarke, 1:1 im Moment. Im Editor kann man die Schreibmarke als blinkenden Linie, wo wir unser Programm eingeben können.

So jetzt wollen wir aber unser erstes Programm schreiben, natürlich das berühmte "Hello World".

program HelloWorld;
begin
  writeln('Hello World');
end.

Manchmal ist es etwas schwierig das richtige Anführungszeichen für Zeichenketten zu finden, for allem mit UAE. (Auf meiner deutschen Tastatur A1200 ist es auf Alt+Ä, man kann auch probieren auf englische Tastatur umzuschalten dann sollte es die Erstbelegung der "Ä" Taste sein, bzw. die Tast die sich dort befindet bei anderssprachiger Bedruckung). Ob es das richtige Anführungszeichen ist ist einfach zu erkennen, die Farbe des textes dahinter (und auch das Zeichen selbst) ändert sich zu türkis (sonst gelb oder weiß) Achtung hinter dem Letzen "end" ist immer ein Punkt (kein Semikolon)

Tut4.png

Bevor wir das Programm übersetzen (kompilieren) können, müssen wir es Abspeichern, dafür kann man entweder den Menü Eintrag (Save im File Menu) auswählen oder man kann wie in der Hotkey Zeile angezeigt F2 drücken. Der Speicherdialog öffnet sich. Der funktioniert etwas anders als man es vom Amiga gewöhnt ist. Um zu einem Laufwerk zu wechseln einfach den Pfad in das Name Feld eingeben und Enter drücken. Der Inhalt des Verzeichnisses wird dann darunter in der Liste angezeigt. Dort kann man dann Verzeichnisse oder Dateien mit der Maus oder den Pfeiltasten (+ Enter) auswählen, sich durch die Verzeichnisstruktur bewegen und einen Ort für die Datei finden (Mit ../ am Ende jeder Liste kann man in das Überverzeichnis wechseln). z.B. Work:Sources in diesem Beispiel wie man es auch im unteren Bereich des Speicherdialogs erkennen kann. Im Name Feld wird immer der Name der angewählten Datei angezeigt, wir löschen den Inhalt und tippen helloworld.pas und drücken Enter oder drücken auf den OK Knopf.

Tut5.png