2724
Kommentar:
|
2633
|
Gelöschter Text ist auf diese Art markiert. | Hinzugefügter Text ist auf diese Art markiert. |
Zeile 8: | Zeile 8: |
1. Wie kann ich Berichte mit *reStructuredText* oder *Sphinx* schreiben? | **Wie kann ich Berichte mit *reStructuredText* oder *Sphinx* schreiben?** |
Zeile 10: | Zeile 10: |
Antwort: Ich habe drei Texte geschrieben, in denen das erklärt wird: | Antwort: Ich habe drei Texte geschrieben, in denen das erklärt wird: |
Zeile 12: | Zeile 12: |
* **Berichte mit Sphinx schreiben** | * **Berichte mit Sphinx schreiben** |
Zeile 14: | Zeile 14: |
http://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht | http://hhoegl.informatik.hs-augsburg.de/dva/sphinxbericht |
Zeile 16: | Zeile 16: |
* **Übungen mit reStructuredText schreiben** | * **Übungen mit reStructuredText schreiben** |
Zeile 18: | Zeile 18: |
http://hhoegl.informatik.hs-augsburg.de/etc/uebungen-mit-rst/uebungen-mit-rst.html | http://hhoegl.informatik.hs-augsburg.de/etc/uebungen-mit-rst/uebungen-mit-rst.html |
Zeile 20: | Zeile 20: |
* **reStructuredText Demo mit Jinja Preprocessor** | * **reStructuredText Demo mit Jinja Preprocessor** |
Zeile 22: | Zeile 22: |
Bei diesem Beispiel wird ein einheitliches Deckblatt mit dem Jinja2 Preprozessor erstellt. Man kann sowohl eine Ausgabe im HTML Format (make html) als auch im PDF Format (make pdf) erstellen. |
Bei diesem Beispiel wird ein einheitliches Deckblatt mit dem Jinja2 Preprozessor erstellt. Man kann sowohl eine Ausgabe im HTML Format (make html) als auch im PDF Format (make pdf) erstellen. |
Zeile 26: | Zeile 26: |
HTML http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.html | HTML http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.html |
Zeile 28: | Zeile 28: |
PDF http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.pdf | PDF http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.pdf |
Zeile 30: | Zeile 30: |
Das gitlab Repository liegt hier: https://r-n-d.informatik.hs-augsburg.de:8080/hubert.hoegl/demo-rst-jinja (bitte die "README.md" dort lesen) |
Das gitlab Repository liegt hier: https://r-n-d.informatik.hs-augsburg.de:8080/hubert.hoegl/demo-rst-jinja (bitte die "README.md" dort lesen) |
Zeile 34: | Zeile 34: |
| | | |
Zeile 36: | Zeile 36: |
#. Gibt es eine Zusammenfassung der Git Kommandos, die wir üblicherweise an der Hochschule (gitlab) brauchen? |
**Gibt es eine Zusammenfassung der Git Kommandos, die wir üblicherweise an der Hochschule (gitlab) brauchen?** |
Zeile 39: | Zeile 39: |
Antwort: Siehe den **Git Spicker** http://hhoegl.informatik.hs-augsburg.de/hhwiki/GitSpicker | Antwort: Siehe den **Git Spicker** http://hhoegl.informatik.hs-augsburg.de/hhwiki/GitSpicker |
Zeile 42: | Zeile 42: |
#. Gibt es Literatur zum Schreiben von Berichten, zur Teamarbeit und zum Programmieren? | **Gibt es Literatur zum Schreiben von Berichten, zur Teamarbeit und zum Programmieren?** |
Zeile 44: | Zeile 44: |
Antwort: | Antwort: |
Zeile 46: | Zeile 46: |
1. In der Bibliothek gibt es ein Regal gleich in der Nähe des Empfangs, das ausgewählte Literatur enthält für Studierende die Berichte, Seminararbeiten, Bachelor- und Masterarbeiten schreiben müssen. Schauen Sie sich dort einfach mal um! |
1. In der Bibliothek gibt es ein Regal gleich in der Nähe des Empfangs, das ausgewählte Literatur enthält für Studierende die Berichte, Seminararbeiten, Bachelor- und Masterarbeiten schreiben müssen. Schauen Sie sich dort einfach mal um! |
Zeile 51: | Zeile 51: |
2. Brian W. Fitzpatrick, Ben Collins-Sussman, *Team Geek. A Software Developer's Guide to Working Well with Others*, O'Reilly, 2012 (http://proquest.tech.safaribooksonline.de/book/work-relationships/9781449329839). |
2. Brian W. Fitzpatrick, Ben Collins-Sussman, *Team Geek. A Software Developer's Guide to Working Well with Others*, O'Reilly, 2012 (http://proquest.tech.safaribooksonline.de/book/work-relationships/9781449329839). |
Zeile 55: | Zeile 55: |
Es gibt eine neuere Auflage mit dem Titel *Debugging Teams*, O'Reilly 2015. (http://proquest.tech.safaribooksonline.de/book/software-engineering-and-development/9781491932049) |
Es gibt eine neuere Auflage mit dem Titel *Debugging Teams*, O'Reilly 2015. (http://proquest.tech.safaribooksonline.de/book/software-engineering-and-development/9781491932049) |
Zeile 58: | Zeile 58: |
3. Kathrin Passig und Johannes Jander, *Weniger schlecht programmieren*, O'Reilly 2013 (http://proquest.tech.safaribooksonline.de/book/programming/9783955615697). |
3. Kathrin Passig und Johannes Jander, *Weniger schlecht programmieren*, O'Reilly 2013 (http://proquest.tech.safaribooksonline.de/book/programming/9783955615697). |
Zeile 61: | Zeile 61: |
4. Christina Czeschik und Matthias Lindhorst, Weniger schlecht über IT schreiben, O'Reilly 2018 (https://proquest.tech.safaribooksonline.de/book/communications/9781492070177). |
4. Christina Czeschik und Matthias Lindhorst, Weniger schlecht über IT schreiben, O'Reilly 2018 (https://proquest.tech.safaribooksonline.de/book/communications/9781492070177). |
Zeile 64: | Zeile 64: |
| | |
Zeile 65: | Zeile 66: |
#. Was muss ich beim Vortragen und Schreiben beachten? | **Was muss ich beim Vortragen und Schreiben beachten?** |
Zeile 67: | Zeile 68: |
Antwort: **Tipps zum Vortragen und Schreiben** http://hhoegl.informatik.hs-augsburg.de/etc/Vortragen-und-Schreiben | Antwort: **Tipps zum Vortragen und Schreiben** http://hhoegl.informatik.hs-augsburg.de/etc/Vortragen-und-Schreiben |
Häufig gestellte Fragen (FAQ)
Wie kann ich Berichte mit *reStructuredText* oder *Sphinx* schreiben?
Antwort: Ich habe drei Texte geschrieben, in denen das erklärt wird:
Berichte mit Sphinx schreiben
Übungen mit reStructuredText schreiben
http://hhoegl.informatik.hs-augsburg.de/etc/uebungen-mit-rst/uebungen-mit-rst.html
reStructuredText Demo mit Jinja Preprocessor
Bei diesem Beispiel wird ein einheitliches Deckblatt mit dem Jinja2 Preprozessor erstellt. Man kann sowohl eine Ausgabe im HTML Format (make html) als auch im PDF Format (make pdf) erstellen.
HTML http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.html
PDF http://hhoegl.informatik.hs-augsburg.de/etc/demo-rst-jina/bericht.pdf
Das gitlab Repository liegt hier: https://r-n-d.informatik.hs-augsburg.de:8080/hubert.hoegl/demo-rst-jinja (bitte die "README.md" dort lesen)
Gibt es eine Zusammenfassung der Git Kommandos, die wir üblicherweise an der Hochschule (gitlab) brauchen?
Antwort: Siehe den Git Spicker http://hhoegl.informatik.hs-augsburg.de/hhwiki/GitSpicker
Gibt es Literatur zum Schreiben von Berichten, zur Teamarbeit und zum Programmieren?
Antwort:
- In der Bibliothek gibt es ein Regal gleich in der Nähe des Empfangs, das ausgewählte Literatur enthält für Studierende die Berichte, Seminararbeiten, Bachelor- und Masterarbeiten schreiben müssen. Schauen Sie sich dort einfach mal um!
Brian W. Fitzpatrick, Ben Collins-Sussman, Team Geek. A Software Developer's Guide to Working Well with Others, O'Reilly, 2012 (http://proquest.tech.safaribooksonline.de/book/work-relationships/9781449329839).
Es gibt eine neuere Auflage mit dem Titel Debugging Teams, O'Reilly 2015. (http://proquest.tech.safaribooksonline.de/book/software-engineering-and-development/9781491932049)
- Kathrin Passig und Johannes Jander, Weniger schlecht programmieren, O'Reilly 2013 (http://proquest.tech.safaribooksonline.de/book/programming/9783955615697).
- Christina Czeschik und Matthias Lindhorst, Weniger schlecht über IT schreiben, O'Reilly 2018 (https://proquest.tech.safaribooksonline.de/book/communications/9781492070177).
Was muss ich beim Vortragen und Schreiben beachten?
Antwort: Tipps zum Vortragen und Schreiben http://hhoegl.informatik.hs-augsburg.de/etc/Vortragen-und-Schreiben