======Anleitung verbessern====== Ist die Anleitung unklar oder unvollständig? Fehlen wichtige Inhalte? Sind einige Seiten nicht in allen Sprachen verfügbar? Dann helfen Sie mit: Machen Sie die Anleitung besser! =====Wie kann ich etwas ändern? ===== Sie benötigen ein Benutzerkonto auf SoSciSurvey.de [[http://www.soscisurvey.de]], um die Anleitung zu bearbeiten. Wenn Sie auf www.soscisurvey.de angemeldet sind, sind Sie automatisch auch in der Anleitung angemeldet. Mit dem Buch-Symbol links oben in SoSci Survey kommen Sie auch direkt in die Anleitung. Sobald Sie eingeloggt sind, sehen Sie in der Anleitung unten links einen Knopf //Diese Seite bearbeiten//, nur einzelne Seiten können nicht bearbeitet werden. Auf Seiten mit mehreren Überschriften sehen Sie rechts unten an jedem Abschnitt auch einen kleinen Knopf //Bearbeiten//, um den einzelnen Absatz zu bearbeiten. Der Text lässt sich dann ganz einfach ändern. Für die Formatierung von Text kommen ähnliche Kürzel wie auch bei Wikipedia zum Einsatz. Weitere Erklärungen zum Formatieren von Text finden Sie stets unter [[de:wiki:syntax|syntax]] (zu finden auch im Bearbeitungsmodus). **Hinweis:** Wenn Sie keine Knöpfe zum Bearbeiten oder Anmelden sehen, sind Sie wahrscheinlich in einer Offline-Kopie der Anleitung. Klicken Sie in diesem Fall zur [[https://www.soscisurvey.de/help/|aktuellen Anleitung]] auf SoSciSurvey.de. =====Was muss ich beachten?===== * Bitte achten Sie darauf, dass Ihre Änderungen die Anleitung besser machen, z.B. aktueller, vollständiger oder verständlicher. * Keine Angst: Sollte etwas schief gehen, kann der Administrator die Änderungen wieder rückgängig machen. * Verwenden Sie vor dem Speichern der Änderungen bitte immer die Vorschau-Funktion und kontrollieren Sie, ob alles wie erwartet aussieht. * Wenn Sie bei etwas nicht sicher sind, fragen Sie einfach schnell im [[http://forum.onlineforschung.org/viewforum.php?f=7|Support-Forum]]. * Wenn Sie einen Inhalt vermissen, notieren Sie es bitte auf dieser Seite weiter unten. ===== Hervorhebungen in Texten ===== Damit man sich in der Anleitung schnell zurecht findet, sind folgende Konventionen zur Formatierung hilfreich. * Der Titel des Kapitels ist eine Überschrift ersten Grades\\ z.B. ''%%====== Titel des Kapitels ======%%'' * Die Überschriften innerhalb des Kapitels sind zweiten, Unterteilungen Überschriften dritten Grades\\ z.B. ''%%===== Überschrift innerhalb des Kapitels =====%%''\\ z.B. ''%%==== Unterteilung innerhalb eines Abschnitts ====%%'' * Menüpunkte im Programm (links in der Navigation) werden fett gesetzt\\ z.B. ''%%Wählen Sie den Menüpunkt **Fragebogen zusammenstellen**%%''\\ z.B. Wählen Sie den Menüpunkt **Fragebogen zusammenstellen** * Beschriftungen von Karteireitern (Tabs), Schaltflächen und Attribute werden kursiv gesetzt\\ z.B. ''%%Klicken Sie auf //Neuen Fragebogen erstellen//%%''\\ z.B. Klicken Sie auf //Neuen Fragebogen erstellen// * Text-Inhalte werden in Anführungszeichen gesetzt\\ z.B. ''%%Geben Sie als //Kennung// "default" ein%%''\\ z.B. Geben Sie als //Kennung// "default" ein * Programmier-Code wird im Text als Code formatiert\\ z.B. ''%%der Befehl ''value()'' liefert die Antwort des Teilnehmers%%''\\ z.B. der Befehl ''value()'' liefert die Antwort des Teilnehmers * Hinweise, Warnungen und Tipps werden fett abgesetzt\\ z.B. ''%%**Tipp:** Sie können im Fragebogen beliebigen HTML-Code einbinden.%%''\\ z.B. **Tipp:** Sie können im Fragebogen beliebigen %%HTML-Code%% einbinden. * Verneinungen und andere wichtige Worte können unterstrichen werden -- allerdings sparsam\\ z.B. ''%%unterstreichen Sie __nicht__ alles, was zunächst wichtig erscheint%%''\\ z.B. unterstreichen Sie __nicht__ alles, was zunächst wichtig erscheint **Hinweis:** Nach der Umstellung der alten Anleitung auf das Wiki sind viele Kapitel noch nicht entsprechende formatiert -- das ist keine Absicht und darf sehr gerne korrigiert werden. ===== Bilder in der Anleitung ===== Bilder machen die Anleitung erst anschaulich. Wenn Sie sich die Mühe machen, gute Abbildungen und Screenshots zu erstellen, dann gewährleisten die folgenden Richtlinien ein einheitliches Aussehen. **Hinweis:** In der Anleitung werden fast ausschließlich Grafiken (i.d.R. mit wenigen Farben) und kaum Fotos verwendet. Die nachfolgenden Hinweise beziehen sich daher nicht auf Fotos. **Hinweis:** Wenn Sie ein bestehendes Bild ersetzen möchten, geben Sie beim //Hochladen als// den gleichen Dateinamen an, den das alte Bild hatte. Setzen Sie außerdem ein Kreuzchen bei //Bestehende Datei überschreiben//. Dann muss die Seite mit dem Bild nicht weiter angepasst werden. Das funktioniert natürlich nur, wenn die neue Datei dasselbe Dateiformat (z.B. PNG oder GIF) verwendet. * Bilder sollen eine Breite von 600 Pixel (inkl. Rahmen) nicht überschreiten. * Screenshots und viele andere Abbildungen sehen am besten aus, wenn außen herum ein weißer Abstand von ca. 10 Pixel und darum ein hellgrauer Rahmen (1 Pixel, Farbe #CCCCCC) gesetzt wird. * Reduzieren Sie die Anzahl der Farben vor dem Speichern auf 2, 4, 8, 16, 32, 64, 128 oder 265 Farben. Je weniger Farben Sie benötigen, desto schneller laden die Bilder. Natürlich ist die Ladezeit sekundär - vor allem sollte das Bild sauber aussehen. * Speichern Sie die Grafik im Dateiformat PNG. * Benennen Sie die Datei nach dem Muster: //typ//.//seite//.//inhalt//.png * //typ// beschreibt den Typus: "scr" für Screenshot, "exp" für ein anderes beispielhaftes Bild, "fig" für eine schematische Abbildung, "div" für sonstige Bilder * //seite// beschreibt die Kennung der Anleitungs-Seite. Diese Seite hier hat z.B: die Kennung "contribute" (s. ganz oben) * //inhalt// beschreibt knapp den Inhalt der Grafik, vorzugsweise in Englisch z.B. "item.delete", "question.place" oder "convert-to-php" * Um ein Bild in die Anleitung hochzuladen, verwenden Sie beim Bearbeiten der entsprechenden Seite das Bilderrahmen-Symbol oben bei den Symbolen (viertes Symbol von rechts). * Fügen Sie der Grafik beim Einbinden in die Anleitung eine kurze Beschreibung bei.\\ z.B. ''%%{{scr.create.question.new.png?nolink|Neue Frage im Fragenkatalog anlegen}}%%'' * Wählen Sie zur Anzeige immer die Originalgröße (keine Größenangabe beim Einbinden), wenn es keine zwingenden Gründe für eine verkleinerte Darstellung gibt. * Sie brauchen den Dateinamen nicht manuell eintippen ([[:wiki:syntax#bilder_und_andere_dateien|Bilder einbinden]]), nach dem Hochladen eines Bildes im Wiki erscheint links vom Bild ein Knopf, um das Bild direkt in den Inhalt zu übernehmen. Wenn Sie auf das Symbol geklickt haben, wählen Sie als Einstellungen für das Einfügen //kein Link//, //linksbündig// und //Originalgröße//. ===== Kapitel übersetzen ===== Dank fleißiger Mithilfe einiger Anwender ist SoSci Survey seit 2011 auch in Englisch verfügbar. Die Sprache der Bedienoberfläche kann man im Benutzerkonto einfach umschalten. Seit Anfang 2015 liegt auch die Anleitung nahezu vollständig in Englisch vor -- lediglich die neusten Kapitel fehlen noch. Wollen Sie sich einem solchen Kapitels annehmen? Der technische Teil der Übersetzung ist relativ unkompliziert: - Öffnen Sie das entsprechende Kapitel der Anleitung - Überprüfen Sie links im Menü (bei //Übersetzungen dieser Seite//), ob es schon eine englische Version gibt (englische Flagge nicht ausgegraut). Falls es schon eine englische Version gibt, können Sie diese natürlich gerne bearbeiten, verbessern und aktualisieren. - Klicken Sie in der deutschen Version auf //Diese Seite bearbeiten// - Markieren Sie den kompletten Inhalt (Strg+A) und kopieren Sie diesen in die Zwischenablage (Strg+C) - Klicken Sie unten auf //Abbrechen// - Wechseln Sie mit dem Umschalter links zur englischen Version. Wenn es noch keine englische Seite gibt, steht dort nur "This topic does not exist yet" - Klicken Sie auf //Create this page// - Fügen Sie den (deutschen) Inhalt aus der Zwischenablage ein (Strg+V) - Übersetzen Sie das Kapitel, sehen Sie sich die Seite gelegentlich via //Preview// an und //Speichern// Sie hin und wieder * Bitte schalten Sie die Sprache in Ihrem Benutzerkonto auf Englisch um, um in der Benutzeroberfläche die korrekten Beschriftungen nachzusehen. * Bei Überschriften beginnen auch in der englischen Übersetzung alle relevanten Wörter (nicht and, or, not, is, ...) mit einem Großbuchstaben. * Bei Links zu anderen Seiten ersetzen Sie das '':de:...'' am Anfang bitte durch '':en:...''. * Bei Bildern können Sie gerne aktualisierte Screenshots aus der englischen GUI anfertigen -- oder alternativ das '':de:...'' stehen lassen. * Damit die Übersetzung schnell von der Hand geht, empfiehlt sich [[https://www.deepl.com/translator|DeepL]] für das Grobe -- dann bleibt mehr Zeit für die Feinheiten. - Vielen Dank für die Mithilfe!