UserApp-Entwicklung/Tutorials/UserApp-Tutorials-Meta - Versionsgeschichte

Tom Unterwegs: zu Kategorie "UserApp-Entwicklung" hinzugefügt

2019-07-23T08:29:09Z

zu Kategorie "UserApp-Entwicklung" hinzugefügt

← Nächstältere Version		Version vom 23. Juli 2019, 10:29 Uhr
Zeile 60:		Zeile 60:
	# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch '''&nbsp;''' ersetzen		# 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

			[[Kategorie:UserApp-Entwicklung]]

Tom Unterwegs am 15. Juli 2019 um 09:10 Uhr

2019-07-15T09:10:47Z

← Nächstältere Version		Version vom 15. Juli 2019, 11:10 Uhr
Zeile 1:		Zeile 1:
	Tipps für das Schreiben von Tutorials zu UserApps.		Tipps und Konventionen für das Schreiben von Tutorials zu UserApps.

			== Erstellen des Wiki-Artikels ==

			* [[Knuddels-Wiki:Tutorial01\|Registriere dich zunächst im Wiki und logge dich ein.]]<br>
			* [[Knuddels-Wiki:Tutorial03\|Hier wird erklärt, wie du neue Artikel erstellst.]]

			Wichtig: Der '''Titel''' deines Tutorials sollte mit '''UserApp-Entwicklung/Tutorials/''' beginnen!
			Artikel, die kein Tutorial sind, sondern lediglich etwas dokumentieren, sollten mit '''UserApp-Entwicklung/Doku/''' beginnen.

			Beispiele:
			* Tutorial: [[UserApp-Entwicklung/Tutorials/HTML-UI]]
			* Doku: [[UserApp-Entwicklung/Doku/AppId]]


	== Code-Beispiele einfügen ==		== Code-Beispiele einfügen ==

Tom Unterwegs: kleine Fehler verbessert

2019-07-12T13:51:05Z

kleine Fehler verbessert

← Nächstältere Version		Version vom 12. Juli 2019, 15:51 Uhr
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 '''"&nbsp;"''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden.<br>		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: [https://mothereff.in/html-entities]		# Falls XML-Tags im Code vorkommen, durch dieses Tool jagen: https://mothereff.in/html-entities
	# alle Leerzeichen (eigentlich nur am Anfang jeder Zeile) durch "&nbsp" ersetzen ~~→ daher am besten keine Tabs im Quellcode verwenden~~		# 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

Tom Unterwegs: u.a. eine Hilfe zum Formatieren von Code in Tutorials

2019-07-12T13:41:08Z

u.a. eine Hilfe zum Formatieren von Code in Tutorials

Neue Seite

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.<br>
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 '''"&nbsp;"''' (geschütztes Leerzeichen) ersetzt werden, damit sie trotzdem angezeigt werden.<br>

In Python sähe das so aus:
<pre>
>>> s = """... hier der Quellcode ...
... noch mehr Quellcode ...
..."""
>>> print(s.replace(" ", "&nbsp;")
</pre>

=== 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:

<pre>

<pre>
hier die "escapte" Version
</pre>
</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 "&nbsp" ersetzen → daher am besten keine Tabs im Quellcode verwenden
# das Ergebnis in einem <pre></pre>-Tag einfügen