palse

a31f694c · Islam Hajosman · 0350b7a1 · a31f694c · a31f694c · a31f694c
Commit a31f694c authored 2 years ago by Islam Hajosman
--- a/Darmstadt.txt
+++ b/Darmstadt.txt
+<!DOCTYPE html>
+<html> 
+  <head>
+	<meta charset="UTF-8"/>
+	<style>
+		.key	{background-color:lightgrey;}
+	</style>
+	<title>User manual for Bluedot Darmstadt</title>
+  </head>
+  <body>
+	<h1>Bluedot Darmstadt</h1>
+	
+	<h2>Station tuning</h2>
+		<h3>Automatic tuning <span class="key">&uarr;</span> / <span class="key">&darr;</span></h3>
+			<p>Press <span class="key">&uarr;</span> / <span class="key">&darr;</span>;
+				the car radio will automatically search for the next station</p>
+			<p>If you hold <span class="key">&uarr;</span> / <span class="key">&darr;</span>,
+				seek tuning will speed up in upwards or downwards direction.
+			</p>
+		
+		<h3>Seek tuning</h3>
+			<table>
+				<tr>
+					<td><span class="key">&uarr;</span></td>
+					<td>Up</td>
+				</tr>
+				<tr>
+					<td><span class="key">&darr;</span></td>
+					<td>Down</td>
+				</tr>
+				<tr>
+					<td><span class="key">&lt;&lt;</span></td>
+					<td>Down in short intervals</td>
+				</tr>
+				<tr>
+					<td><span class="key">&gt;&gt;</span></td>
+					<td>Up in short intervals</td>
+				</tr>
+			</table>
+		<h3>Manual tuning with <span class="key">&lt;&lt;</span> or <span class="key">&gt;&gt;</span></h3>
+			<p>Press <span class="key">&lt;&lt;</span> or <span class="key">&gt;&gt;</span>,
+				the frequency will change in short intervals downwards or upwards.
+			</p>
+			<p>
+				If you hold <span class="key">&lt;&lt;</span> or <span class="key">&gt;&gt;</span> down,
+				the frequency scan will accelerate.
+			</p>
+  </body>
+</html>
--- a/Dieburg.txt
+++ b/Dieburg.txt
+<!DOCTYPE html>
+<html>  
+  <head>
+    <meta charset="UTF-8" />
+	<style>
+		.key	{background-color:lightgrey;}
+	</style>
+    <title>User manual for Bluedot Dieburg</title>
+  </head>
+  <body>
+	<h1>Bluedot Dieburg</h1>
+	
+		<h2>Tuning into a station</h2>
+		<p>There are various ways of tuning into a station.</p>
+		
+		<h3>Automatic station seek tuning</h3>
+			<p>Press the <span class="key">&uarr;</span> or <span class="key">&darr;</span> button.</p>
+			<p>The radio tunes into the next receiavable station</p>
+		
+		<h3>Tuning into stations manually</h3>
+			<p>You can also tune into stations manually.</p>
+			<p>Press the <span class="key">&larr;</span> or <span class="key">&rarr;</span> button.</p>
+  </body>
+</html>
--- a/Griesheim.txt
+++ b/Griesheim.txt
+<!DOCTYPE html>
+<html>
+  <head>
+	<meta charset="UTF-8"/>
+	<style>
+		.key	{background-color:lightgrey;}
+	</style>
+	<title>User manual for Bluedot Griesheim</title>
+  </head>
+  <body>
+	<h1>Bluedot Griesheim</h1>
+	
+		<h2>Selecting a station</h2>
+		<p>The display will indicate the station name or, if no data is received, the frequency of the station currently playing.</p>
+		<p>There are several different ways of selecting a station:</p>
+		
+		<h3>...by station search or manually</h3>
+			<h4>Start the station search function by pressing</h4>
+				<p><span class="key">&uarr;</span> (up) or <span class="key">&darr;</span> (down).</p>
+				<p>The station search will stop at the next station within reception range. 
+					If you hold down <span class="key">&uarr;</span> or <span class="key">&darr;</span>,
+					the station search will run forwards or backwards quickly.
+				</p>
+			
+			<h4>Start the manual search</h4>
+				<p>by pressing <span class="key">&lt;&lt;</span> or <span class="key">&gt;&gt;</span>,
+					the frequency will move up or down in increments.
+				</p>
+				<p>
+					If you hold <span class="key">&lt;&lt;</span> or <span class="key">&gt;&gt;</span> down,
+					then the frequency will run through quickly.
+				</p>
+  </body>
+</html>
--- a/_RadioManual.cpp
+++ b/_RadioManual.cpp
+#define make_string(s) str(s)
+
+#define str(s) #s
+
+
+#ifdef CONFIGFILE
+#include make_string(configurations/CONFIGFILE.h)
+#ifndef LANGUAGE
+#define LANGUAGE EN
+#endif
+#ifdef RADIO_NAME
+#include make_string(languages/LANGUAGE/header.txt)
+#endif
+
+#if defined AUTOMATIC_FORWORD && defined AUTOMATIC_BACKWORD
+#include make_string(languages/LANGUAGE/automatic.txt)
+#endif
+#if  (defined SEEKUP &&  defined SEEKDOWN) || (defined SEEKLEFT &&  defined SEEKRIGHT)
+#include make_string(languages/LANGUAGE/seekOpenning.txt)
+#endif
+#if  defined SEEKUP && defined SEEKDOWN
+
+#include make_string(languages/LANGUAGE/seekUpDown.txt)
+
+#endif
+
+#if  defined SEEKLEFT && defined SEEKRIGHT
+#include make_string(languages/LANGUAGE/seekLeftRight.txt)
+
+#endif
+
+#if  defined SEEKUP || defined SEEKDOWN || defined SEEKLEFT || defined SEEKRIGHT
+</table>
+#endif
+
+#if defined MANUAL_FORWORD && defined MANUAL_BACKWORD
+#include make_string(languages/LANGUAGE/manual.txt)		
+#endif 
+
+#ifdef HEADER
+</body>
+</html>
+#endif
+#endif
+
--- a/__ReadMe.txt
+++ b/__ReadMe.txt
+In this folder you find 
+- a windows batch file (createManual.bat) that creates the manuals on windows
+- a linux batch file (createManual.sh) that creates the manuals on linux
+- 3 text files with the manual pages for 3 car radios (Darmstadt.txt, Dieburg.txt, Griesheim.txt)
+- a cpp file (_RadioManual.cpp) that uses the C-preprocessor to include the txt-files depending on parameters passed
+
+This exercise requires the GNU C-preprocessor. So please make sure that the command gcc is working in a console window.
+Maybe you have to adopt your path-Variable to make sure that gcc is found.
+
+Be aware that the scripts compare strings. So it is important to use the correct spelling and to take care of uppercase letters.
+
+It your environment is properly set up you can start the script (.sh or .bat) in a console window as follows
+on windows:		.\createManual.bat DARMSTADT darmstadt.html  or
+on Linux:		./createManual.sh DARMSTADT darmstadt.html 
+
+If you need some help about C-Preprocessor commands, look at
+https://de.wikibooks.org/wiki/C-Programmierung:_Pr%C3%A4prozessor
--- a/configurations/darmstadtConfig.h
+++ b/configurations/darmstadtConfig.h
+#define RADIO_NAME Darmstadt
+#define AUTOMATIC_FORWORD &uarr;
+#define AUTOMATIC_BACKWORD &darr;
+#define MANUAL_FORWORD &gt;&gt;
+#define MANUAL_BACKWORD &lt;&lt;
+//#define MANUAL_NUMERIC_KEYPAD
+//#define LANGUAGE DE
--- a/configurations/dieburgConfig.h
+++ b/configurations/dieburgConfig.h
+#define RADIO_NAME Dieburg
+#define AUTOMATIC_FORWORD &uarr;
+#define AUTOMATIC_BACKWORD &darr;
+#define MANUAL_FORWORD &rarr;
+#define MANUAL_BACKWORD &larr;
+//#define MANUAL_NUMERIC_KEYPAD
+//#define LANGUAGE DE
--- a/configurations/giersheimConfig.h
+++ b/configurations/giersheimConfig.h
+#define RADIO_NAME Giersheim
+#define AUTOMATIC_FORWORD &uarr;
+#define AUTOMATIC_BACKWORD &darr;
+#define MANUAL_BACKWORD &lt;&lt;
+#define MANUAL_FORWORD &gt;&gt;
+#define MANUAL_NUMERIC_KEYPAD
+#define LANGUAGE DE
--- a/createManual.bat
+++ b/createManual.bat
+@ECHO OFF
+rem param1 is target, param2 is output-file (e.g.)
+IF NOT "%2"=="" GOTO 2Params
+
+IF NOT "%1"=="" GOTO 1Params
+
+GOTO 0Params
+
+:0Params
+  ECHO No Radio specified. Try again!
+  ECHO 1st parameter specifies radio (e.g. DARMSTADT)
+  ECHO 2nd parameter specifies filename for output (e.g. Darmstadt.html)
+GOTO End1
+
+:1Params
+@ECHO ON
+  gcc -E -P -Wall -D %1 _RadioManual.cpp
+@ECHO OFF
+GOTO End1
+
+:2Params
+@ECHO ON
+  gcc -E -P -Wall -D %1 -o %2 _RadioManual.cpp
+@ECHO OFF
+GOTO End1
+
+:End1
\ No newline at end of file
--- a/createManual.sh
+++ b/createManual.sh
+#!/bin/sh
+#clear
+
+# param1 is target, param2 is output-file
+
+NoOfParams="0"
+if [ $1 ]; then 
+	NoOfParams="*" 
+fi 
+
+if [ $2 ]; then 
+	NoOfParams="1" 
+fi 
+if [ $3 ]; then 
+	NoOfParams="2" 
+fi 
+if [ $4 ]; then 
+	NoOfParams="3" 
+fi 
+if [ $5 ]; then 
+	NoOfParams="4" 
+fi 
+
+case $NoOfParams in 
+   1)
+      gcc -E -P -Wall -D $1 -o $2 _RadioManual.cpp
+      ;;
+   2)
+      gcc -E -P -Wall -D $1 -D $3 -o $2 _RadioManual.cpp
+      ;;
+   3)
+      gcc -E -P -Wall -D $1 -D $3 -D $4 -o $2 _RadioManual.cpp
+      ;;
+   4)
+      gcc -E -P -Wall -D $1 -D $3 -D $4 -D $5 -o $2 _RadioManual.cpp
+      ;;
+   *)
+      echo "No Radio specified. Try again!"
+      echo "1st parameter specifies radio (e.g. DARMSTADT)" 
+      echo "2nd parameter specifies filename for output (e.g. Darmstadt.html)"
+      echo "other parameters specifies Automatic tuning , Seek tuning and/or Manual tuning (e.g. AUTOMATIC SEEK MANAUAL)"
+      ;;
+esac 
--- a/darmstadt.html
+++ b/darmstadt.html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+ <style>
+  .key {background-color:lightgrey;}
+ </style>
+    <title>User manual for Bluedot
+ Darmstadt </title></head><body><h1>Bluedot Darmstadt</h1>
+ <h2>Tuning into a station</h2>
+ <p>There are various ways of tuning into a station.</p>
+  <h3>Automatic station seek tuning</h3>
+   <p>Press the <span class="key">&uarr;</span> or <span class="key">&darr;</span> button.</p>
+   <p>The radio tunes into the next receiavable station</p>
+<h3>Seek tuning</h3>
+   <table>
+    <tr>
+     <td><span class="key">&uarr;</span></td>
+     <td>Up</td>
+    </tr>
+    <tr>
+     <td><span class="key">&darr;</span></td>
+     <td>Down</td>
+    </tr>
+<tr>
+     <td><span class="key">&uarr;</span></td>
+     <td>Down in short intervals</td>
+    </tr>
+    <tr>
+     <td><span class="key">&uarr;</span></td>
+     <td>Up in short intervals</td>
+    </tr>
+</table>
+<h4>Start the manual tuning</h4>
+    <p>by pressing <span class="key">&uarr;</span> or <span class="key">&uarr;</span>,
+     the frequency will move up or down in increments.
+    </p>
+    <p>
+     If you hold <span class="key">&uarr;</span> or <span class="key">&uarr;</span> down,
+     then the frequency will run through quickly.
+    </p>
+</body>
+</html>
--- a/dieburg.html
+++ b/dieburg.html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+ <style>
+  .key {background-color:lightgrey;}
+ </style>
+    <title>User manual for Bluedot Dieburg</title>
+  </head>
+  <body>
+ <h1>Bluedot Dieburg</h1>
+  <h2>Tuning into a station</h2>
+  <p>There are various ways of tuning into a station.</p>
+  <h3>Automatic station seek tuning</h3>
+   <p>Press the <span class="key">&uarr;</span> or <span class="key">&darr;</span> button.</p>
+   <p>The radio tunes into the next receiavable station</p>
+  <h3>Tuning into stations manually</h3>
+   <p>You can also tune into stations manually.</p>
+   <p>Press the <span class="key">&larr;</span> or <span class="key">&rarr;</span> button.</p>
+  </body>
+</html>
--- a/dieburgDE.html
+++ b/dieburgDE.html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+ <style>
+  .key {background-color:lightgrey;}
+ </style>
+    <title>Benutzerhandbuch für Bluedot
+     Dieburg </title></head><body><h1>Bluedot Dieburg</h1>
+ <h2>Einstellen eines Senders</h2>
+ <p>Es gibt verschiedene Möglichkeiten, einen Sender einzustellen.</p>
+<h3>Automatische Sendersuche</h3>
+   <p>Drücken Sie die Taste <span class="key">&uarr;</span> oder <span class="key">&darr;</span>.</p>
+   <p>Das Radio stellt den nächsten empfangbaren Sender ein</p>
+</table>
+<h4>Starten Sie die manuelle Abstimmung</h4>
+    <p>durch Drücken von <span class="key">&larr;</span> oder <span class="key">&rarr;</span>,
+     wird die Frequenz schrittweise nach oben oder unten verschoben.
+    </p>
+    <p>
+     Wenn Sie <span class="key">&larr;</span> oder <span class="key">&rarr;</span> gedrückt halten,
+     dann wird die Frequenz schnell durchlaufen.
+    </p>
+</body>
+</html>
--- a/giersheimDE.html
+++ b/giersheimDE.html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+ <style>
+  .key {background-color:lightgrey;}
+ </style>
+    <title>Benutzerhandbuch für Bluedot
+     Giersheim </title></head><body><h1>Bluedot Giersheim</h1>
+ <h2>Einstellen eines Senders</h2>
+ <p>Es gibt verschiedene Möglichkeiten, einen Sender einzustellen.</p>
+<h3>Automatische Sendersuche</h3>
+   <p>Drücken Sie die Taste <span class="key">&uarr;</span> oder <span class="key">&darr;</span>.</p>
+   <p>Das Radio stellt den nächsten empfangbaren Sender ein</p>
+</table>
+<h4>Starten Sie die manuelle Abstimmung</h4>
+    <p>durch Drücken von <span class="key">&lt;&lt;</span> oder <span class="key">&gt;&gt;</span>,
+     wird die Frequenz schrittweise nach oben oder unten verschoben.
+    </p>
+    <p>
+     Wenn Sie <span class="key">&lt;&lt;</span> oder <span class="key">&gt;&gt;</span> gedrückt halten,
+     dann wird die Frequenz schnell durchlaufen.
+    </p>
+<br>
+<br>
+ <p>Sie können die gewünschte Frequenz eingeben, um direkt im Kanal zu navigieren.</p>
+</body>
+</html>
--- a/griesheim.html
+++ b/griesheim.html
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8" />
+ <style>
+  .key {background-color:lightgrey;}
+ </style>
+    <title>Benutzerhandbuch für Bluedot
+     Giersheim </title></head><body><h1>Bluedot Giersheim</h1>
+ <h2>Einstellen eines Senders</h2>
+ <p>Es gibt verschiedene Möglichkeiten, einen Sender einzustellen.</p>
+<h3>Automatische Sendersuche</h3>
+   <p>Drücken Sie die Taste <span class="key">&uarr;</span> oder <span class="key">&darr;</span>.</p>
+   <p>Das Radio stellt den nächsten empfangbaren Sender ein</p>
+<h4>Starten Sie die manuelle Abstimmung</h4>
+    <p>durch Drücken von <span class="key">&lt;&lt;</span> oder <span class="key">&gt;&gt;</span>,
+     wird die Frequenz schrittweise nach oben oder unten verschoben.
+    </p>
+    <p>
+     Wenn Sie <span class="key">&lt;&lt;</span> oder <span class="key">&gt;&gt;</span> gedrückt halten,
+     dann wird die Frequenz schnell durchlaufen.
+    </p>
+<br>
+<br>
+ <p>Sie können die gewünschte Frequenz eingeben, um direkt im Kanal zu navigieren.</p>
--- a/languages/DE/automatic.txt
+++ b/languages/DE/automatic.txt
+<h3>Automatische Sendersuche</h3>
+			<p>Drücken Sie die Taste <span class="key">AUTOMATIC_FORWORD</span> oder <span class="key">AUTOMATIC_BACKWORD</span>.</p>
+			<p>Das Radio stellt den nächsten empfangbaren Sender ein</p>
--- a/languages/DE/header.txt
+++ b/languages/DE/header.txt
+<!DOCTYPE html>
+<html>  
+  <head>
+    <meta charset="UTF-8" />
+	<style>
+		.key	{background-color:lightgrey;}
+	</style>
+    <title>Benutzerhandbuch für Bluedot
+    	RADIO_NAME </title></head><body><h1>Bluedot RADIO_NAME</h1> 
+	<h2>Einstellen eines Senders</h2>
+	<p>Es gibt verschiedene Möglichkeiten, einen Sender einzustellen.</p>
--- a/languages/DE/manual.txt
+++ b/languages/DE/manual.txt
+<h4>Starten Sie die manuelle Abstimmung</h4>
+				<p>durch Drücken von <span class="key">MANUAL_BACKWORD</span> oder <span class="key">MANUAL_FORWORD</span>,
+					wird die Frequenz schrittweise nach oben oder unten verschoben.
+				</p>
+				<p>
+					Wenn Sie <span class="key">MANUAL_BACKWORD</span> oder <span class="key">MANUAL_FORWORD</span> gedrückt halten,
+					dann wird die Frequenz schnell durchlaufen.
+				</p>
+#if defined MANUAL_NUMERIC_KEYPAD 
+<br> 
+<br>
+ <p>Sie können die gewünschte Frequenz eingeben, um direkt im Kanal zu navigieren.</p>	
+#endif	
--- a/languages/DE/seekLeftRight.txt
+++ b/languages/DE/seekLeftRight.txt
+
+<tr>
+					<td><span class="key">SEEKLEFT</span></td>
+					<td>In kurzen Abständen nach unten</td>
+				</tr>
+				<tr>
+					<td><span class="key">SEEKRIGHT</span></td>
+					<td>In kurzen Abständen aufwärts</td>
+				</tr>
+			
--- a/languages/DE/seekOpenning.txt
+++ b/languages/DE/seekOpenning.txt
+<h3>Stimmung suchen</h3>
+			<table>