u.a. eine Hilfe zum Formatieren von Code in Tutorials |
K kleine Fehler verbessert |
||
| Zeile 5: | Zeile 5: | ||
=== <pre>-Tag === | === <pre>-Tag === | ||
Code ist auf dem Knuddels-Wiki am besten in einem <pre>-Tag aufgehoben.<br> | Code ist auf dem Knuddels-Wiki am besten in einem '''<pre>'''-Tag aufgehoben.<br> | ||
Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt. | Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt. | ||
=== Whitespaces === | === Whitespaces === | ||
Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch ''' | Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch '''&nbsp;''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden.<br> | ||
In Python sähe das so aus: | In Python sähe das so aus: | ||
| Zeile 44: | Zeile 44: | ||
# Code in einem Kommentar '''<!-- -->''' sichern | # Code in einem Kommentar '''<!-- -->''' sichern | ||
# Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: | # Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: https://mothereff.in/html-entities | ||
# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch | # alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch '''&nbsp;''' ersetzen | ||
# das Ergebnis in einem <pre></pre>-Tag einfügen | # das Ergebnis in einem '''<pre></pre>'''-Tag einfügen | ||
Version vom 12. Juli 2019, 15:51 Uhr
Tipps für das Schreiben von Tutorials zu UserApps.
Code-Beispiele einfügen
<pre>-Tag
Code ist auf dem Knuddels-Wiki am besten in einem <pre>-Tag aufgehoben.
Allerdings gibt es auch hier noch Probleme mit der Formatierung, zum Beispiel werden Whitespaces am Anfang der Zeile entfernt.
Whitespaces
Die Whitespaces am Anfang der Zeile (oder einfach alle) können durch (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden.
In Python sähe das so aus:
>>> s = """... hier der Quellcode ...
... noch mehr Quellcode ...
..."""
>>> print(s.replace(" ", " ")
HTML-Quellcode
Bei Verwendung von XML-Tags sollte der Quellcode außerdem zuerst einmal durch dieses Tool "escaped" werden: https://mothereff.in/html-entities
Syntax-Highlighting
Das Knuddels-Wiki hat derzeit leider kein Syntax-Highlighting.
Quellcode sichern
Das Ergebnis ist durch diese Änderungen im Bearbeitungsfeld im Wiki nicht mehr gut lesbar. Um für spätere Änderungen noch die originale Version des Code-Beispiels zu erhalten, kann es in einem XML-Kommentar gesichert werden:
<!-- hier die Originalversion --> <pre> hier die "escapte" Version </pre>
Zusammenfassung
- Code in einem Kommentar <!-- --> sichern
- Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: https://mothereff.in/html-entities
- alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch ersetzen
- das Ergebnis in einem <pre></pre>-Tag einfügen