Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:texts [28.11.2014 11:37] – admin
+++ de:create:texts [26.04.2023 08:18] (aktuell) – alte Version wiederhergestellt (06.04.2023 18:30) admin
@@ Zeile 1: / Zeile 1: @@
 ====== Texte im Fragebogen ======
-Um im Fragebogen einen Text (außerhalb einer Frage) anzuzeigen, gehen Sie im einfachsten Fall vor wie folgt:
+Texte sind -- neben Fragen -- der wichtigste Bestandteil von Fragebögen. Man benötigt sie für die Begrüßung, längere Erläuterungen und oftmals als Stimuli (z.B. Artikel). Texte werden ähnlich wie Frage in einer Rubrik erstellt. Wählen Sie die gewünschte Rubrik aus und klicken Sie links im **Fragenkatalog** auf //Text hinzufügen//.
-  - Wählen Sie links unter **Fragebogen** die Funktion **Textbausteine u. Beschriftung**
+Geben Sie eine //Beschreibung// für den Text ein, die nur Sie als Projektleiter sehen. Anschließend können Sie unterschiedliche Darstellungsvarianten für den Text auswählen.
-  - Klicken Sie auf //Neuer Textbaustein//
-  - Geben Sie eine kurze //Kennung// ein (z.B. "welcome")
-  - Geben Sie den //Text// ein, Sie können den Text mit HTML-Tags formatieren (s. unten)
-  - Speichern Sie den Textbaustein mit //OK//
-  - Beim **Fragebogen zusammenstellen** erscheint der Textbaustein nun rechts unter //Texte, Bilder, Audio//. Den Text kann man einfach mit der Maus auf die Fragebogen-Seite ziehen. Sie können Textbausteine alleine auf eine Fragebogen-Seite stellen, oder ihn über, unter oder zwischen anderen Elementen platzieren.
-===== Verschiedene Möglichkeiten =====
+  * Standard ist ein "einfacher Text". Dieser passt sich von der Formatierung nahtlos in den Fragebogen ein und erlaubt einfache Formatierungen per [[#wiki-notation|Wiki-Notation]].
+  * Die Darstellung "Formatierter Text" erlaubt Formatierungen mit einem Editor. **Wichtig:** Bitte kopieren Sie aber keine Texte direkt aus Microsoft Word in einen formatierten Text. Dabei wird sehr viel unnötige Formatierung kopiert, welche später zu Anzeigefehlern führen kann.
+  * Für anspruchsvollere Gestaltung können Sie mit der Darstellung "HTML-Code" direkt HTML oder JavaScript eingeben. So können Sie etwa auch Videos einbinden ([[:de:create:media]]).
+  * Umfangreiche Informationen können Sie als Text-Akkordeon übersichtlich darstellen ([[:de:create:accordion]])
-Es gibt 4 verschiedene Möglichkeiten, Texte im Fragebogen einzubinden.
+Falls gewünscht, können Sie im Karteireiter //Titel// auch Textinhalte eingeben, die wie eine Frage formatiert werden. Sobald Sie den Text speichern ({{:button.save.png?nolink|Speichern-Knopf}}), erscheint er im Fragenkatalog.
-  * //Textbausteine//\\ Verwenden Sie nach Möglichkeit für Texte immer Textbausteine. Zum einen bleibt der Fragebogen schlanker und übersichtlicher, zum anderen können Sie Funktionen wie die Unterstützung mehrsprachiger Fragebögen nutzen.
-    * Einen Textbaustein via [[:de:glossary#drag_drop|Drag & Drop]] in den Fragebogen ziehen.
+===== Verwendung im Fragebogen =====
-    * Einen Textbaustein mit der PHP-Funktion ''[[functions-base#text|text()]]'' einbinden.
+Es gibt 4 verschiedene Möglichkeiten, Texte im Fragebogen einzubinden. Zum einen können Sie im Fragebogen direkt HTML-Code eingeben, zum anderen Textbausteine verwenden (s. oben). Das direkte Eingeben von HTML-Code macht das **Fragebogen zusammenstellen** recht unübersichtlich, daher empfehlen wir das Anlegen von Texten im Fragenkatalog. Diese unterstützen neben unterschiedlichen Formatierungen auch [[:de:create:multilang|mehrsprachige Fragebögen]].
+  * //Texte//\\ Texte aus dem Fragenkatalog werden wie Fragen unter **Fragebogen zusammenstellen** in den Fragebogen eingebunden:
+    * Text via [[:de:glossary#drag_drop|Drag & Drop]] in den Fragebogen ziehen.
+    * Text mit der PHP-Funktion ''[[:de:create:functions:text|text()]]'' oder ''[[:de:create:functions:show|show()]]'' einbinden.
   * //HTML-Code direkt im Fragebogen//\\ Verwenden Sie HTML-Code im Fragebogen nur, wenn Sie entweder ganz kurze Schnipsel HTML-Code benötigen (z.B. um Fragebogen-Elemente zu platzieren) oder wenn Sie dynamisch erzeugte Inhalte direkt (nicht mittels Platzhalter) einfügen müssen.
     * Einen Baustein vom Typ //HTML-Code// in den Fragebogen ziehen und dort direkt HTML-Code eintippen.
-    * HTML-Code mit der PHP-Funktion ''[[functions-output#html|html()]]'' in den Fragebogen einbinden. Wie Sie im folgenden Beispiel sehen, kann der HTML-Code der Übersichtlichkeit halber auf mehrere Zeilen verteilt werden:
+    * HTML-Code mit der PHP-Funktion ''[[:de:create:functions:html|html()]]'' in den Fragebogen einbinden. Wie Sie im folgenden Beispiel sehen, kann der HTML-Code der Übersichtlichkeit halber auf mehrere Zeilen verteilt werden:
 <code php>
@@ Zeile 28: / Zeile 31: @@
 </code>
-===== Text-Formatierung =====
-Für die Text-Formatierung haben Sie zwei Möglichkeiten: Eine Wiki-Notation für einfache Formatierungen (v.a. innerhalb von Fragen) und HTML für anspruchsvollere Formate (z.B. im Begrüßungstext). HTML und Wiki-Notation können beliebig gemischt werden.
+===== Texte formatieren =====
+Wenn Sie einen Text im Fragenkatalog anlegen, können Sie diesen direkt via Editor formatieren. Im Hintergrund wird die Formatierung in HTML-Code übersetzt. Aber auch Fragen, Erklärungen, Items und andere Beschriftungen können formatiert werden. Dafür haben Sie zwei Möglichkeiten: Eine Wiki-Notation für einfache Formatierungen (v.a. innerhalb von Fragen) und HTML für anspruchsvollere Formate (z.B. im Begrüßungstext). HTML und Wiki-Notation können beliebig gemischt werden.
 ==== Wiki-Notation ====
-Die Wiki-Notation erlaubt mittels doppelter Unterstriche (''_''), Schrägstriche (''/'') und Sternchen (''*'') einfache Hervorhebungen. Außerdem können Sie an einigen Stellen (insb. bei Frage-Texten und in den verbalen Verankerungen von Skalen) Texte mit der Eingabetaste auf mehrere Zeilen bzw. Absätze verteilen.
+Die Wiki-Notation erlaubt einfache Hervorhebungen -- egal ob in eigenständigen Texten, Fragen, Items oder verbalen Skalenverankerungen.
 **Tipp:** Verwenden Sie Hervorherbungen __sehr__ sparsam. Ein homogenes Layout wirkt i.d.R. deutlich professioneller. Mehr als 2 oder 3 Hervorherbungen pro Seite sorgen eher für ein chaotisches Erscheinungsbild als für Orientierung.
@@ Zeile 42: / Zeile 47: @@
 | fett | <nowiki>**Text**</nowiki> | <nowiki>Wie ist **Ihre Meinung** dazu?</nowiki> | Wie ist **Ihre Meinung** dazu? |
 | kursiv | <nowiki>//Text//</nowiki> | <nowiki>Bewertung zwischen //nie// und //häufig//</nowiki> | Bewertung zwischen //nie// und //häufig// |
+| Überschrift 1 | <nowiki>=== Text ===</nowiki> | <nowiki>=== A. Hauptteil ===</nowiki> | {{scr.texts.example.h1.png}} |
+| Überschrift 2 | <nowiki>== Text ==</nowiki> | <nowiki>== A.1. Definition ==</nowiki> | {{scr.texts.example.h2.png}} |
+| Trennlinie | <nowiki>--</nowiki> | Absatz\\ <nowiki>--</nowiki>\\ Absatz | {{scr.texts.example.hr.png}}|
 | kein Umbruch | <nowiki>$$Text$$</nowiki> | <nowiki>Kein Umbruch am Bindestrich: $$E-Mail-</nowiki>\\ <nowiki>Addresse$$</nowiki> | Kein Umbruch am Bindestrich:\\ E-Mail-Addresse |
+| Tooltip | <nowiki>((*|Inhalt))</nowiki> | <nowiki>Wiki-((Notation|Notation bedeutet Schreibweise))</nowiki> |
+| Link | <nowiki>[[URL|Titel]]</nowiki> | <nowiki>[[https://www.soscisurvey.de/|SoSci Survey]]</nowiki> | [[https://www.soscisurvey.de/|SoSci Survey]] |
-Eine Sonderform der Wiki-Notation ist die Definition von Textteilen "nur zur Anzeige im Fragebogen" mittels doppelter geschweifter Klammern (''{'' bzw. ''}''). Solche Textteile werden im Fragebogen angezeigt, nicht aber in den Variablen-Labels Ihres Datensatzes oder bei der Abfrage mittels [[:de:create:functions:value|value()]] in Verbindung mit dem Format-Code ''label''.
+Eine Sonderform der Wiki-Notation ist die Definition von Textteilen "nur zur Anzeige im Fragebogen" mittels doppelter geschweifter Klammern. Solche Textteile werden im Fragebogen angezeigt, nicht aber in den Variablen-Labels Ihres Datensatzes oder bei der Abfrage mittels [[:de:create:functions:value|value()]] in Verbindung mit dem Format-Code ''label''.
 ^ Beschreibung ^ Format-Code ^ Beispiel ^ Anzeige im Fragebogen ^ Im Datensatz ^
 | Nur im Fragebogen zeigen | <nowiki>{{Text}}</nowiki> | <nowiki>Sonstige{{s:}}</nowiki> | Sonstiges: | Sonstige |
 ==== Formatierung mit HTML ====
 Technisch gesehen fügen Sie an einer beliebigen Stelle im Fragebogen HTML-Code ein. HTML, die HyperText Markup Language, ist das Standard-Format für Informationen im Internet. Keine Angst - um Text oder ein Bild in den Fragebogen einzubauen, müssen Sie HTML nicht gleich von vorne bis hinten erlernen. Aber zumindest die Grundzüge sind sehr hilfreich, um einfache Formatierungen vorzunehmen.
+**Tipp:** Wenn Sie sich mit dem Schreiben von HTML-Code zunächst ein wenig schwer tun, kann ein Online-HTML-Editor wie z.B. [[https://html-online.com/editor/|HTML-Online.com]] hilfreich sein.
 HTML-Code beinhaltet einerseits die eigentlichen Inhalte - zum Beispiel das was Sie hier gerade lesen - zum anderen Kürzel, die beschreiben, wie die Informationen aussehen sollen. Die Formatierung wird mit so genannten Tags ("Täg" gesprochen) erreicht. Tags werden in HTML immer in spitzen Klammern notiert. Im folgenden Beispiel sind die Tags hervorgehoben:
-**HTML-Code**
 <code html>
 <h1>Hallo Welt</h1>
@@ Zeile 61: / Zeile 73: @@
 </code>
-Auf gut deutsch übersetzt, steht im Beispiel nichts anderes als:
+In gewöhnliche Sprache übersetzt, steht im Beispiel nichts anderes als:
   * Schreibe "Hallo Welt" und zwar als Überschrift ("header") ersten Grades (1).
@@ Zeile 73: / Zeile 85: @@
 **Tipp:** Das <br>-Tag ist sehr hilfreich, wenn die Beschriftungen (verbale Verankerungen) in einer Skala nicht optimal umbrechen.
-**HTML-Code**
 <code html>
 <p>Trifft gar<br>nicht zu</p>
@@ Zeile 83: / Zeile 94: @@
 Wie man im folgenden Beispiel sieht, können Tags auch weitere Attribute beinhalten. Dem <img>-Tag muss man z.B. sagen, welches Bild es zeigen soll (src, "source") und welchen Text (alt, "alternative") es anzeigen soll, wenn das Bild nicht angezeigt werden kann.
-**HTML-Code**
 <code html>
 <img src="logo.gif" alt="Logo">
@@ Zeile 91: / Zeile 101: @@
 {{scr.texts.example3.png}}
-===== Die wichtigsten Tags zum Formatieren von Texten =====
+===== Die wichtigsten HTML-Tags =====
 Neben Texten, die Sie mit html() ausgeben, können Sie auch Frage-Titel, Erklärungen und Beschriftungen von Skalen mit HTML-Tags formatieren. Hier eine Aufstellung einiger wichtiger Tags:
@@ Zeile 105: / Zeile 116: @@
 | **<h1>** | Überschrift ersten Grades | ''<h1>A. Hauptteil</h1>'' | {{scr.texts.example.h1.png}} |
 | **<h2>** | Überschrift zweiten Grades | ''<h2>A.1. Definition</h2>'' | {{scr.texts.example.h2.png}} |
-| **<a>** | Hyperlink zu einer Website | ''%%<a href="https://www.soscisurvey.de" target="_blank">SoSciSurvey</a>%%'' | [[https://www.soscisurvey.de|SoSciSurvey]] |
+| **<a>** | Link zu einer Website | ''%%<a href="https://www.soscisurvey.de" target="_blank">SoSciSurvey</a>%%'' | [[https://www.soscisurvey.de|SoSciSurvey]] |
 | **<span>** | Textabschnitt, der mit CSS zu formatieren ist | ''%%Dies ist <span style="color: #FF0000">roter Text</span>%%'' | {{scr.texts.example.span.png}} |
 | **<div>** | Textblock, der mit CSS zu formatieren ist | ''%%<div style="border: 2px solid #FF0000; background-color: #FFCCCC">Text im roten Kasten</div>%%'' | {{scr.texts.example.div.png}} |
@@ Zeile 139: / Zeile 150: @@
 {{scr.texts.example4.png}}
-**Tipp:** Wenn ein Text im Fragebogen standardmäßig fett formatiert wird - Sie den Text aber einmalig nicht fett wünschen, so hilft ''<span style="font-weight: normal">Text</span>''. Falls Sie das entsprechende Element nie fett haben möchten, so sollten Sie das Layout entsprechend ändern.
+**Tipp:** Wenn ein Text im Fragebogen standardmäßig fett formatiert wird - Sie den Text aber einmalig nicht fett wünschen, so hilft ''%%<span style="font-weight: normal">Text</span>%%''. Falls Sie das entsprechende Element nie fett haben möchten, so sollten Sie das Layout entsprechend ändern.
 ===== HTML-Entitäten =====