... |
... |
@@ -11,7
+11,7 @@ |
11 |
11 |
Die Bedienung des Theme-Konfigurators gliedert sich in zwei Abschnitte, die sich jeweils an unterschiedliche Nutzergruppen richten: |
12 |
12 |
|
13 |
13 |
; Erstellen von Layout-Vorlagen |
14 |
|
-: Dies richtet sich an technisch versierte Nutzer, die Vorlagen für Layouts erstellen möchten. In einer Vorlage wird etwa festgelegt, welche Eigenschaften (Farben, Schriftgrößen etc.) bearbeitbar sein sollen. Basierend auf einer Vorlage kann dann ein Layout erstellt werden, in dem jeder Eigenschaft entsprechende Werte zugewiesen werden (Farbe=rot, Schriftgröße=12px etc.). Hierzu sind grundlegende Kenntnisse über {{smallcaps}}Css{{/smallcaps}} und [[{{smallcaps}}Scss{{/smallcaps}}>>url:https://sass-lang.com/]] notwendig. Für Nutzer, die keine Vorlagen erstellen sollen oder dürfen, kann diese Möglichkeit über ein [[Rollenrecht>>doc:Formcycle.UserInterface.UserSettings.Roles]] entzogen werden. |
|
14 |
+: Dies richtet sich an technisch versierte Nutzer, die Vorlagen für Layouts erstellen möchten. In einer Vorlage wird etwa festgelegt, welche Eigenschaften (Farben, Schriftgrößen etc.) bearbeitbar sein sollen. Basierend auf einer Vorlage kann dann ein Layout erstellt werden, in dem jeder Eigenschaft entsprechende Werte zugewiesen werden (Farbe=rot, Schriftgröße=12px etc.). Hierzu sind grundlegende Kenntnisse über {{smallcaps}}Css{{/smallcaps}} und [[{{smallcaps}}Scss{{/smallcaps}}>>url:https://sass-lang.com/||target="_blank"]] notwendig. Für Nutzer, die keine Vorlagen erstellen sollen oder dürfen, kann diese Möglichkeit über ein [[Rollenrecht>>doc:Formcycle.UserInterface.UserSettings.Roles]] entzogen werden. |
15 |
15 |
; Erstellen von konkreten Layouts |
16 |
16 |
: Dies richtet sich an gestalterisch versierte Nutzer. Basierend auf einer Vorlage kann ein konkretes Layout erstellt werden. Es ist auch möglich, mehrere Layouts basierend auf einer Vorlage zu erstellen, etwa eine Variation in Rot und eine Variation in Blau. Nachdem ein Layout erstellt wurde, kann es entwender als [[Design (CSS)>>doc:Formcycle.UserInterface.FilesAndTemplates.Design]]-Vorlage für den {{designer/}} oder als {{smallcaps}}Css{{/smallcaps}}-[[Mandantdatei>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]] abgespeichert werden. |
17 |
17 |
|
... |
... |
@@ -144,7
+144,7 @@ |
144 |
144 |
|
145 |
145 |
Im {{smallcaps}}Scss{{/smallcaps}}-Tab im rechten Bereich kann eine entsprechende {{smallcaps}}Scss{{/smallcaps}}-Datei erstellt werden. |
146 |
146 |
|
147 |
|
-Es können dabei sogenannte [[{{smallcaps}}Scss{{/smallcaps}}-Variablen>>url:https://sass-lang.com/documentation/variables]] verwendet werden. Der Wert der Variablen wird dann pro Layout entsprechend durch den Nutzer festgelegt. {{smallcaps}}Scss{{/smallcaps}}-Variablen beginnen immer mit einem Dollarzeichen ($) und sollten nicht mit [[{{smallcaps}}Css{{/smallcaps}}-Variablen>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties]] verwechselt werden. |
|
147 |
+Es können dabei sogenannte [[{{smallcaps}}Scss{{/smallcaps}}-Variablen>>url:https://sass-lang.com/documentation/variables||target="_blank"]] verwendet werden. Der Wert der Variablen wird dann pro Layout entsprechend durch den Nutzer festgelegt. {{smallcaps}}Scss{{/smallcaps}}-Variablen beginnen immer mit einem Dollarzeichen ($) und sollten nicht mit [[{{smallcaps}}Css{{/smallcaps}}-Variablen>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties||target="_blank"]] verwechselt werden. |
148 |
148 |
|
149 |
149 |
Um die [{{smallcaps}}Scss{{/smallcaps}}-Variablen für ein Layout mit Werten zu befüllen, werden die Variablen mit ihren Werten der [{{smallcaps}}Scss{{/smallcaps}}-Datei vorangestellt: |
150 |
150 |
|
... |
... |
@@ -256,7
+256,7 @@ |
256 |
256 |
{{/figure}} |
257 |
257 |
|
258 |
258 |
{{figure image="plugin_theme_config_template_settings_2_de.png"}} |
259 |
|
- In den Einstellungen kann zudem weiter festgelegt werden, ob etwa [[Vendor-Präfix>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix]] automatisch angefügt werden sollen oder diverse {{smallcaps}}Css{{/smallcaps}}-Features automatisch für ältere Browser kompatibel gemacht werden. |
|
259 |
+ In den Einstellungen kann zudem weiter festgelegt werden, ob etwa [[Vendor-Präfix>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix||target="_blank"]] automatisch angefügt werden sollen oder diverse {{smallcaps}}Css{{/smallcaps}}-Features automatisch für ältere Browser kompatibel gemacht werden. |
260 |
260 |
{{/figure}} |
261 |
261 |
|
262 |
262 |
Im Tab //Einstellungen// im rechten Bereich können einige fortgeschrittene Einstellungen getroffen werden, welche unter anderem beeinflussen, wie genau das {{smallcaps}}Scss{{/smallcaps}} in {{smallcaps}}Css{{/smallcaps}} transpiliert wird. Die Einstellungen gliedern sich in vier Unterbereiche: |
... |
... |
@@ -293,7
+293,7 @@ |
293 |
293 |
:; NESTED |
294 |
294 |
:: Im {{smallcaps}}Scss{{/smallcaps}} verschachtelte Regeln Selektoren durch Einrückung im {{smallcaps}}Css{{/smallcaps}} dargestellt. |
295 |
295 |
; Zu unterstützende Browser |
296 |
|
-: Hier kann festgelegt werden, welche Browser unterstützt werden sollen. Dies hat etwa Auswirkungen darauf, welche {{smallcaps}}Css{{/smallcaps}}-Präfix automatisch hinzugefügt werden. Die Auswahl der Browser geschieht über eine sogenannte Browser-Query, zur Syntax siehe [[github.com/browserslist>>url:https://github.com/browserslist/browserslist#queries]]. Durch Betätigen der Schaltfläche //Browser aufzeigen// kann angezeigt werden, welche Browser letzlich bei einer Query herauskommen. |
|
296 |
+: Hier kann festgelegt werden, welche Browser unterstützt werden sollen. Dies hat etwa Auswirkungen darauf, welche {{smallcaps}}Css{{/smallcaps}}-Präfix automatisch hinzugefügt werden. Die Auswahl der Browser geschieht über eine sogenannte Browser-Query, zur Syntax siehe [[github.com/browserslist>>url:https://github.com/browserslist/browserslist#queries||target="_blank"]]. Durch Betätigen der Schaltfläche //Browser aufzeigen// kann angezeigt werden, welche Browser letzlich bei einer Query herauskommen. |
297 |
297 |
; Anzahl der Leerzeichen für die Einrückung |
298 |
298 |
: Falls in der Ausgabe Zeilen eingerückt werden, kann hier festgelegt werden, wieviele Leerzeichen pro Einrückungslevel verwendet werden sollen. |
299 |
299 |
; Genaugikeit für nummerische Berechnungen |
... |
... |
@@ -303,18
+303,18 @@ |
303 |
303 |
|
304 |
304 |
==== Postcss-Einstellungen ==== |
305 |
305 |
|
306 |
|
-Hier können einige Einstellungen für [[postcss>>url:https://github.com/postcss/postcss]] getroffen werden, um das erzeugte {{smallcaps}}Css{{/smallcaps}} nachzubearbeiten. |
|
306 |
+Hier können einige Einstellungen für [[postcss>>url:https://github.com/postcss/postcss||target="_blank"]] getroffen werden, um das erzeugte {{smallcaps}}Css{{/smallcaps}} nachzubearbeiten. |
307 |
307 |
|
308 |
308 |
; Doppelte {{smallcaps}}Css{{/smallcaps}}-Regeln entfernen |
309 |
309 |
: Wenn diese Option aktiviert ist, werden doppelte {{smallcaps}}Css{{/smallcaps}}-Regeln entfernt. In der Regel ist dies unproblematisch. Wenn Selektoren sich gegenseitig überschreiben, kann dies in Einzelfällen das Layout beeinflussen. |
310 |
|
-; Unterstützung für [[Polyfiller>>url:https://de.wikipedia.org/wiki/Polyfill]] für neue {{smallcaps}}Css{{/smallcaps}}-Features aktivieren |
311 |
|
-: Wenn aktiviert, wird das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env]]-Plugin für postcss aktiviert. Damit können aktuelle {{smallcaps}}Css{{/smallcaps}}-Features auch in älteren Browsern genutzt werden. Ob ein [[Polyfill>>url:https://de.wikipedia.org/wiki/Polyfill]] für ein bestimmtes {{smallcaps}}Css{{/smallcaps}}-Features aktiviert ist, wird von den zu unterstützenden Browsern bestimmt (siehe oben). |
|
310 |
+; Unterstützung für [[Polyfiller>>url:https://de.wikipedia.org/wiki/Polyfill||target="_blank"]] für neue {{smallcaps}}Css{{/smallcaps}}-Features aktivieren |
|
311 |
+: Wenn aktiviert, wird das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env||target="_blank"]]-Plugin für postcss aktiviert. Damit können aktuelle {{smallcaps}}Css{{/smallcaps}}-Features auch in älteren Browsern genutzt werden. Ob ein [[Polyfill>>url:https://de.wikipedia.org/wiki/Polyfill||target="_blank"]] für ein bestimmtes {{smallcaps}}Css{{/smallcaps}}-Features aktiviert ist, wird von den zu unterstützenden Browsern bestimmt (siehe oben). |
312 |
312 |
; Minimale {{smallcaps}}Css{{/smallcaps}}-Stage für unterstützte Features |
313 |
|
-: Bestimmt die [[{{smallcaps}}Css{{/smallcaps}}-Stage>>url:https://cssdb.org/#staging-process]], die ein {{smallcaps}}Css{{/smallcaps}}-Feature wenigstens haben muss, um durch das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env]]-Plugin potentiell mit einem Polyfill versehen zu werden. |
|
313 |
+: Bestimmt die [[{{smallcaps}}Css{{/smallcaps}}-Stage>>url:https://cssdb.org/#staging-process||target="_blank"]], die ein {{smallcaps}}Css{{/smallcaps}}-Feature wenigstens haben muss, um durch das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env||target="_blank"]]-Plugin potentiell mit einem Polyfill versehen zu werden. |
314 |
314 |
|
315 |
315 |
==== Autoprefixer-Einstellungen ==== |
316 |
316 |
|
317 |
|
-In diesem Abschnitt kann das [[autprefixer>>url:https://github.com/postcss/autoprefixer]]-Plugin für [[postcss>>url:https://github.com/postcss/postcss]] konfiguriert werden. Diese fügt automatisch [[Vendor-Präfixe>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix]] automatisch hinzu. Welche Präfixe hinzugefügt werden, hängt von den eingestellten Browsern ab (siehe oben). |
|
317 |
+In diesem Abschnitt kann das [[autprefixer>>url:https://github.com/postcss/autoprefixer||target="_blank"]]-Plugin für [[postcss>>url:https://github.com/postcss/postcss||target="_blank"]] konfiguriert werden. Diese fügt automatisch [[Vendor-Präfixe>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix||target="_blank"]] automatisch hinzu. Welche Präfixe hinzugefügt werden, hängt von den eingestellten Browsern ab (siehe oben). |
318 |
318 |
|
319 |
319 |
; Automatisches Hinzufügen von Präfixen aktivieren |
320 |
320 |
: Wenn diese Option aktiviert ist, werden Vendor-Präfixe automatisch hinzugefügt. |
... |
... |
@@ -321,13
+321,13 @@ |
321 |
321 |
; Unbenötigte Präfixe entfernen |
322 |
322 |
: Wenn diese Option aktiviert ist, werden unbenötigte Vendor-Präfixe automatisch entfernt. Etwa werden Präfixe für alte Browser entfernt, die nicht mehr unterstützt werden brauchen. |
323 |
323 |
; Präfix für @supports-Regeln hinzufügen |
324 |
|
-: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[@supports>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/@supports]]-Regeln hinzugefügt. |
|
324 |
+: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[@supports>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/@supports||target="_blank"]]-Regeln hinzugefügt. |
325 |
325 |
; {{smallcaps}}Css{{/smallcaps}} einrücken wenn nicht minifiziert (Visual Cascade) |
326 |
326 |
: Aktiviert die //cascade//-Option von //autprefixer// (Deklarationen am Doppelpunkt ausrichten). |
327 |
327 |
; Präfixe für Flexbox-Eigenschaften hinzufügen |
328 |
|
-: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Flexbox>>url:https://css-tricks.com/snippets/css/a-guide-to-flexbox/]]-Eigenschaften hinzugefügt. |
|
328 |
+: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Flexbox>>url:https://css-tricks.com/snippets/css/a-guide-to-flexbox/||target="_blank"]]-Eigenschaften hinzugefügt. |
329 |
329 |
; Präfixe für Rastereigenschaften (grid) hinzufügen |
330 |
|
-: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Grid>>url:https://css-tricks.com/snippets/css/complete-guide-grid/]]-Eigenschaften hinzugefügt. |
|
330 |
+: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Grid>>url:https://css-tricks.com/snippets/css/complete-guide-grid/||target="_blank"]]-Eigenschaften hinzugefügt. |
331 |
331 |
|
332 |
332 |
== Changelog |
333 |
333 |
|