diff --git a/content/Haskell/Advantages.md b/content/Haskell/Advantages.md index f2e8c1f..fb0f708 100644 --- a/content/Haskell/Advantages.md +++ b/content/Haskell/Advantages.md @@ -32,7 +32,7 @@ Gründe Haskell zu nutzen und wo Vorteile liegen. - [Parallel and Concurrent Programming in Haskell](http://chimera.labs.oreilly.com/books/1230000000929/pr01.html) - [Slides of a Quickcheck-Talk](http://scholar.google.de/scholar?cluster=7602244452224287116&hl=de&as_sdt=0,5) - [Understanding F-Algebras](https://www.fpcomplete.com/user/bartosz/understanding-algebras) - schöne Erklärung. Man könnte danach anfangen den [[Morphsims|Morphismen-zoo]]# + schöne Erklärung. Man könnte danach anfangen den [[Morphisms|Morphismen-zoo]]# zu verstehen... - [Monad Transformers](https://github.com/kqr/gists/blob/master/articles/gentle-introduction-monad-transformers.md) @@ -40,7 +40,7 @@ Gründe Haskell zu nutzen und wo Vorteile liegen. - [Tom LaGatta on Category-Theory](https://www.youtube.com/watch?v=o6L6XeNdd_k) - [Unifying Structured Recursion Schemes](https://www.youtube.com/watch?v=9EGYSb9vov8) - aka. [[Morphsims|The Morphism-Zoo]] + aka. [[Morphisms|The Morphism-Zoo]] - [Hole-Driven-Development Teaser (Enthusiasticon, raichoo)](https://www.youtube.com/watch?v=IRGKkiGG5CY) ## Unsorted/Unseen diff --git a/static_gen/-/all.html b/static_gen/-/all.html new file mode 100644 index 0000000..f02af5f --- /dev/null +++ b/static_gen/-/all.html @@ -0,0 +1,1017 @@ + + + + + + + Index – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

+ Index +

+ +
+ +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + About + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Stefan Dresselhaus + + + +
+ + + + + +
+ + + + + + + + + + + + + + +
+ + + + + + + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Work-Experience + + + +
+ + + + + +
+ + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Android + + + +
+ + + + + + + + + + + + + + + + + +
+ + + + + + + +
+ + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Haskell + + + +
+ + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Code-Snippets + + + +
+ + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + *-Morpisms + + + +
+ + + + + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Monoid? Da war doch was… + + + +
+ + + + + +
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Lenses + + + +
+ + + + + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Talks und Posts zu Haskell + + + +
+ + + + + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Webapp-Development in Haskell + + + +
+ + + + + +
+ + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Logik für Dummies + + + +
+ + + + + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Uni + + + +
+ + + + + + + + + + + + + + + + + +
+ + + + + + + +
+ + +
+ + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + Unix + + + +
+ + + + + + + + + + + + + + + + + +
+ +
+ + + + + + + + + + SSH-Filter + + + +
+ + + + + +
+ + +
+ +
+ +
+
+ +
+ + + + + \ No newline at end of file diff --git a/static_gen/-/export.json b/static_gen/-/export.json new file mode 100644 index 0000000..e9e3ecf --- /dev/null +++ b/static_gen/-/export.json @@ -0,0 +1 @@ +{"files":{"About.md":{"filePath":"About.md","links":[],"meta":null,"parentNote":"index.md","title":"About","url":"About"},"About/CV.md":{"filePath":"About/CV.md","links":[{"resolvedRelTarget":{"contents":"About/Work","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Work"],"tag":"URTWikiLink"}},{"resolvedRelTarget":{"contents":"Haskell/FFPiH","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","FFPiH"],"tag":"URTWikiLink"}},{"resolvedRelTarget":{"contents":"About/Extracurricular","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Extracurricular"],"tag":"URTWikiLink"}},{"resolvedRelTarget":{"contents":"About/Experience","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Experience"],"tag":"URTWikiLink"}}],"meta":{"page":{"description":"Oct. 2018 to Aug. 2021:"},"tags":[],"title":"Stefan Dresselhaus"},"parentNote":"About.md","title":"Stefan Dresselhaus","url":"About/CV"},"About/Experience.md":{"filePath":"About/Experience.md","links":[{"resolvedRelTarget":{"contents":"About/Work","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Work"],"tag":"URTWikiLink"}}],"meta":{"page":{"description":"(as far as NDA and other things allow it)"},"tags":[]},"parentNote":"About.md","title":"Highlights of my experiences in the programming world","url":"About/Experience"},"About/Extracurricular.md":{"filePath":"About/Extracurricular.md","links":[{"resolvedRelTarget":{"contents":"Haskell/FFPiH","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","FFPiH"],"tag":"URTWikiLink"}}],"meta":{"page":{"description":"(What I did at university besides studying 😎 )"},"tags":[]},"parentNote":"About.md","title":"Studium generale / University-Life","url":"About/Extracurricular"},"About/Work.md":{"filePath":"About/Work.md","links":[],"meta":{"page":{"description":"Oct. 2018 to Aug. 2021:"},"tags":[]},"parentNote":"About.md","title":"Work-Experience","url":"About/Work"},"Android.md":{"filePath":"Android.md","links":[],"meta":null,"parentNote":"index.md","title":"Android","url":"Android"},"Android/Einrichtung.md":{"filePath":"Android/Einrichtung.md","links":[],"meta":{"categories":"Android, Tutorial","page":{"description":"Hier stelle ich meine Erfahrungen und die Einrichtung meines Smartphones vor. Keine Garantie auf Übertragbarkeit und Aktualität."},"tags":[],"title":"Einrichtung Android-Smartphones","toc":true},"parentNote":"Android.md","title":"Einrichtung Android-Smartphones","url":"Android/Einrichtung"},"Haskell.md":{"filePath":"Haskell.md","links":[],"meta":null,"parentNote":"index.md","title":"Haskell","url":"Haskell"},"Haskell/Advantages.md":{"filePath":"Haskell/Advantages.md","links":[{"resolvedRelTarget":{"contents":"Haskell/Code%20Snippets/Morphisms","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Morphisms"],"tag":"URTWikiLink"}},{"resolvedRelTarget":{"contents":"Haskell/Lenses","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Lenses"],"tag":"URTWikiLink"}},{"resolvedRelTarget":{"contents":"Haskell/Code%20Snippets/Morphisms","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkNormal","Morphisms"],"tag":"URTWikiLink"}}],"meta":{"page":{"description":"Gründe Haskell zu nutzen und wo Vorteile liegen."},"tags":[]},"parentNote":"Haskell.md","title":"Talks und Posts zu Haskell","url":"Haskell/Advantages"},"Haskell/Code Snippets.md":{"filePath":"Haskell/Code Snippets.md","links":[],"meta":{"page":{"description":"Hier schreiben wir ein paar Code-Highlights auf, die uns begegnet sind."},"tags":[]},"parentNote":"Haskell.md","title":"Code-Snippets","url":"Haskell/Code%20Snippets"},"Haskell/Code Snippets/Monoid.md":{"filePath":"Haskell/Code Snippets/Monoid.md","links":[],"meta":{"page":{"description":"Stellen wir uns vor, dass wir eine Funktion schreiben, die einen String bekommt (mehrere Lines mit ACSII-Text) und dieses Wort-für-Wort rückwärts ausgeben soll. Das ist ein einfacher Einzeiler:"},"tags":[]},"parentNote":"Haskell/Code Snippets.md","title":"Monoid? Da war doch was…","url":"Haskell/Code%20Snippets/Monoid"},"Haskell/Code Snippets/Morphisms.md":{"filePath":"Haskell/Code Snippets/Morphisms.md","links":[],"meta":{"page":{"description":"Backup eines Blogposts eines Kommilitonen:"},"tags":[]},"parentNote":"Haskell/Code Snippets.md","title":"*-Morpisms","url":"Haskell/Code%20Snippets/Morphisms"},"Haskell/FFPiH.md":{"filePath":"Haskell/FFPiH.md","links":[{"resolvedRelTarget":{"contents":"Haskell/Lenses","tag":"RRTFound"},"unresolvedRelTarget":{"contents":["WikiLinkBranch","Lenses"],"tag":"URTWikiLink"}}],"meta":{"page":{"description":"FFPiH ist eine Vorlesung, die ich zusammen mit einem Kommilitonen im Sommer 2015 erstmals erstellt und gehalten haben."},"tags":[]},"parentNote":"Haskell.md","title":"Fortgeschrittene funktionale Programmierung in Haskell","url":"Haskell/FFPiH"},"Haskell/Lenses.md":{"filePath":"Haskell/Lenses.md","links":[],"meta":{"page":{"description":"Die Idee dahinter ist, dass man Zugriffsabstraktionen über Daten verknüpfen kann. Als einfachen Datenstruktur kann man einen Record mit der entsprechenden Syntax nehmen."},"tags":[]},"parentNote":"Haskell.md","title":"Lenses","url":"Haskell/Lenses"},"Haskell/Webapp_Development.md":{"filePath":"Haskell/Webapp_Development.md","links":[],"meta":{"page":{"description":"Step-by-Step-Anleitung, wie man ein neues Projekt mit einer bereits erprobten Pipeline erstellt."},"tags":[]},"parentNote":"Haskell.md","title":"Webapp-Development in Haskell","url":"Haskell/Webapp_Development"},"Logik.md":{"filePath":"Logik.md","links":[],"meta":{"categories":"Mathematik","page":{"description":"Logik ist das ziehen von Schlüssen, die innerhalb der Logik widerspruchsfrei und kohärent sind."},"tags":[],"title":"Logik für Dummies","toc":true},"parentNote":"index.md","title":"Logik für Dummies","url":"Logik"},"Uni.md":{"filePath":"Uni.md","links":[],"meta":null,"parentNote":"index.md","title":"Uni","url":"Uni"},"Uni/Lernerfolg_an_der_Uni.md":{"filePath":"Uni/Lernerfolg_an_der_Uni.md","links":[],"meta":{"page":{"description":"Dies ist eine gute Frage. Da ich im laufe der Zeit einige Antworten gesammelt habe, wollte ich diese mal hier niederschreiben. Vorweg eine Warnung: All das hier spiegelt nur meine persönlichen Erfahrungen aus Gesprächen wieder. Es kann sein, dass die z.B. für euren Fachbereich nicht gilt. Da wir das nun aus dem Weg haben, geht es auch gleich los."},"tags":[]},"parentNote":"Uni.md","title":"Wie lerne ich richtig an der Uni?","url":"Uni/Lernerfolg_an_der_Uni"},"Unix.md":{"filePath":"Unix.md","links":[],"meta":null,"parentNote":"index.md","title":"Unix","url":"Unix"},"Unix/SSH-Filter.md":{"filePath":"Unix/SSH-Filter.md","links":[],"meta":{"page":{"description":"To filter incoming SSH-Connections by Country/Login do:"},"tags":[]},"parentNote":"Unix.md","title":"SSH-Filter","url":"Unix/SSH-Filter"},"index.md":{"filePath":"index.md","links":[],"meta":{"page":{"description":"Unsortierte Einsichten und Erfahrungen. Archiviert zum verlinken, späteren Überdenken oder Diskutieren."},"tags":[]},"parentNote":null,"title":"Home","url":""}},"version":1} \ No newline at end of file diff --git a/static_gen/-/stork.st b/static_gen/-/stork.st new file mode 100644 index 0000000..d29025e Binary files /dev/null and b/static_gen/-/stork.st differ diff --git a/static_gen/-/tags.html b/static_gen/-/tags.html new file mode 100644 index 0000000..2a8c18d --- /dev/null +++ b/static_gen/-/tags.html @@ -0,0 +1,254 @@ + + + + + + + Tag Index – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

+ Tag Index +

+ +
+ +
+ +
+ + +
+
+ +
+
+ +
+ + + + + \ No newline at end of file diff --git a/static_gen/-/tasks.html b/static_gen/-/tasks.html new file mode 100644 index 0000000..6a62bda --- /dev/null +++ b/static_gen/-/tasks.html @@ -0,0 +1,239 @@ + + + + + + + Task Index – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+

+ Task Index +

+ +
+ +
+
+ +
+
+ +
+
+ +
+ + + + + \ No newline at end of file diff --git a/static_gen/.nojekyll b/static_gen/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/static_gen/About.html b/static_gen/About.html new file mode 100644 index 0000000..04dc1f2 --- /dev/null +++ b/static_gen/About.html @@ -0,0 +1,1208 @@ + + + + + + + + About – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + About + +

+ +
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/About/CV.html b/static_gen/About/CV.html new file mode 100644 index 0000000..7403104 --- /dev/null +++ b/static_gen/About/CV.html @@ -0,0 +1,1338 @@ + + + + + + + + Stefan Dresselhaus – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Stefan Dresselhaus + +

+
+ +

About me

+

Work

+
    + +
  • + +

    + Oct. 2018 to Aug. 2021: +

    + +
      + +
    • + ML-Specialist at Jobware (Paderborn; german Job-Advertising-Platform) +
    • + +
    + +
  • + +
  • + +

    + 2013-2018 several jobs at my University including +

    + +
      + +
    • + Worked 6 Months in the Workgroup “Theoretical Computer Science” on migrating algorithms to CUDA +
    • + +
    • + Tutor “Introduction to Machine Learning” +
        + +
      • + Was awarded Tutoring-Award of the Faculty of Technology for excellent tutoring +
      • + +
      + +
    • + +
    • + Lecture "Intermediate Functional Programming in Haskell" +
    • + +
    • + Development of Pandoc-Filters for effective generation of lecture-slides for Mario Botsch (Leader Workgroup Computer Graphics) using Pandoc & reveal.js +
    • + +
    + +
  • + +
+

Education

+
    + +
  • + Bachelor “Kognitive Informatik” (Cognitive Informatics) in Bielefeld 2010-2014 +
  • + +
  • + Master “Naturwissenschaftliche Informatik” (Informatics in the natural sciences) 2014-2018 +
  • + +
+

Extraordinary grades (Excerpt of my Transcript)

+

+ Note: Scale of grades in Germany is 1.0 to 4.0 with 1.0 being best, 4.0 being passing grade, 5.0 being failed grade +

+ +
    + +
  • + 1.0 in Modern Data Analysis +
      + +
    • + Master course on data-analysis (time-series, core-vector-machines, gaussian processes, …) +
    • + +
    + +
  • + +
  • + 1.0 in Computergraphics +
      + +
    • + Raytracing, Modern OpenGL +
    • + +
    + +
  • + +
  • + 1.3 in Computer-Animation +
      + +
    • + Dual-Quarternion-Skinning, Character-Animation, FACS-Poses, etc. +
    • + +
    + +
  • + +
  • + 1.3 in GPU-Computing (CUDA) +
      + +
    • + originally a 1.7 by timing (task was de-mosaicing on images, grade was measured in ms, whereby 400ms equated to 4.0 and 100ms equated to 1.0), but because my deep knowledge was visible in the code i was given a 1.3 after oral presentation. +
    • + +
    + +
  • + +
  • + 1.0 in Parallel Algorithms and Data-Structures +
  • + +
  • + Ethical Hacking +
      + +
    • + Reverse Engineering with IDApro +
    • + +
    + +
  • + +
+

Further information

+ + + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/About/DresselhausStefan_klein2.jpg b/static_gen/About/DresselhausStefan_klein2.jpg new file mode 100644 index 0000000..0603cc8 Binary files /dev/null and b/static_gen/About/DresselhausStefan_klein2.jpg differ diff --git a/static_gen/About/Experience.html b/static_gen/About/Experience.html new file mode 100644 index 0000000..63b27d6 --- /dev/null +++ b/static_gen/About/Experience.html @@ -0,0 +1,1294 @@ + + + + + + + + Highlights of my experiences in the programming world – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Highlights of my experiences in the programming world + +

+
+ + +

+ (as far as NDA and other things allow it) +

+

Haskell-Enthusiast

+
    + +
  • + Learning/Writing Haskell since ~2014 +
  • + +
  • + Created and held advanced Haskell-Lecture at my University +
  • + +
+

github

+ +

gitea

+

+ I also have a gitea-instance where one can finde more current things and backups of old. +

+

Highlights

+ + + +
+
+ + +
+
Links to this page
+ +
+ +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/About/Extracurricular.html b/static_gen/About/Extracurricular.html new file mode 100644 index 0000000..fb0cfb1 --- /dev/null +++ b/static_gen/About/Extracurricular.html @@ -0,0 +1,1354 @@ + + + + + + + + Studium generale / University-Life – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Studium generale / University-Life + +

+
+ + +

+ (What I did at university besides studying 😎 ) +

+

Committees / Student Body

+
    + +
  • + Student Member of Studienbeirat Informatik (Study-Profile Commission) +
  • + +
  • + Student Member of Tutorenauswahlkommission (Tutor-Selection Committee) +
      + +
    • + Leader Tutorenevaluation (Evaluation of Tutors) +
    • + +
    + +
  • + +
  • + Student Member of NWI-Master-Auswahlausschuss (Master-Application Committee for my course of study) +
  • + +
  • + Student Member of NWI-Master-Prüfungsausschuss (Committee for Exam-disputes of my Master course) +
  • + +
  • + Member of the Admin-Team for the student-body pcs +
  • + +
+

Summer 15

+ +

Summer 16

+ +

Winter 16/17

+ +

Summer 17

+ + + +
+
+ + +
+
Links to this page
+ +
+ +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/About/Work.html b/static_gen/About/Work.html new file mode 100644 index 0000000..3a68564 --- /dev/null +++ b/static_gen/About/Work.html @@ -0,0 +1,1452 @@ + + + + + + + + Work-Experience – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Work-Experience + +

+
+ + +
    + +
  • + +

    + Oct. 2018 to Aug. 2021: +

    + +
      + +
    • + ML-Specialist at Jobware (Paderborn; german Job-Advertising-Platform) +
        + +
      • + Extraction/Classification of sentences from JobAds (Requirements, Benefits, Tasks, …) +
      • + +
      • + Extraction of Information from JobAds (Location of company, Location of workplay, contact-details, application-procedure, etc.) including geocoding of those information (backed by OpenStreetMap) +
      • + +
      • + Embedding of JobAds into a meaningful space (i.e. “get me similar ads. btw. i dislike ad a, b, c”). +
      • + +
      • + Analyse & predict search-queries of users on the webpage and offer likely but distinct queries (i.e. similar when typo or complete different words (synonyms, hyponyms, etc.)) +
      • + +
      + +
    • + +
    • + Technologies used: +
        + +
      • + Haskell (currently GHC 8.6, soon GHC 8.8) +
          + +
        • + stack + stackage-lts +
        • + +
        • + fixplate (recursion-schemes-implementation) +
        • + +
        • + many usual technologies like lens, http-simple, mtl, .. +
        • + +
        • + golden-testing via tasty +
        • + +
        • + several inhouse-developments: +
            + +
          • + templating based on text-replacement via generics (fieldname in Template-Type == variable replaced in template) +
          • + +
          • + activeMQ/Kibana-bridge for logging via hs-stomp +
          • + +
          • + generic internal logging-framework +
          • + +
          + +
        • + +
        + +
      • + +
      • + Python +
          + +
        • + tensorflow +
        • + +
        • + pytorch +
        • + +
        • + sklearn +
        • + +
        • + nltk +
        • + +
        + +
      • + +
      + +
    • + +
    + +
  • + +
  • + +

    + 2013-2018: +

    + +
      + +
    • + several jobs at my University including +
        + +
      • + Worked 6 Months in the Workgroup “Theoretical Computer Science” on migrating algorithms to CUDA +
      • + +
      • + Tutor “Introduction to Machine Learning” +
          + +
        • + Was awarded Tutoring-Award of the Faculty of Technology for excellent tutoring +
        • + +
        + +
      • + +
      • + Lecture “Intermediate Functional Programming in Haskell” +
          + +
        • + Originally developed as student-project in cooperation with Jonas Betzendahl +
        • + +
        • + First held in Summer 2015 +
        • + +
        • + Due to high demand held again in Summer 2016 and 2017 +
        • + +
        • + Was awarded Lecturer-Award “silver Chalk” in 2016 +
            + +
          • + First time that this award was given to students +
          • + +
          • + Many lecturers at our faculty never get any teaching-award until retirement +
          • + +
          + +
        • + +
        + +
      • + +
      • + Development of Pandoc-Filters for effective generation of lecture-slides for Mario Botsch (Leader “Workgroup Computer Graphics”) using Pandoc & reveal.js + + +
      • + +
      + +
    • + +
    + +
  • + +
+ + +
+
+ + +
+
Links to this page
+ +
+ +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Android.html b/static_gen/Android.html new file mode 100644 index 0000000..9f95cd9 --- /dev/null +++ b/static_gen/Android.html @@ -0,0 +1,1178 @@ + + + + + + + + Android – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Android + +

+
+ +
+

+ Note: To override the auto-generated content here, create a file named one of: Android.md, Android.org +

+
+ +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Android/Einrichtung.html b/static_gen/Android/Einrichtung.html new file mode 100644 index 0000000..3fe5849 --- /dev/null +++ b/static_gen/Android/Einrichtung.html @@ -0,0 +1,1273 @@ + + + + + + + + Einrichtung Android-Smartphones – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Einrichtung Android-Smartphones + +

+
+ + +

+ Hier stelle ich meine Erfahrungen und die Einrichtung meines Smartphones vor. Keine Garantie auf Übertragbarkeit und Aktualität. +

+

HTC One (M7)

+

+ Ich nehme an, dass das Smartphone gerooted ist - andernfalls gibt es dazu viele Anleitungen im Netz. Von Vorteil ist hier ein “international”-Phone (Also OHNE Vertrag). Telefone MIT Vertrag lassen sich nur ohne Sicherheitsgurte flashen und man kann diese Sicherheitsmaßnahmen auch im Nachhinein nicht mehr anschalten. Hierdurch kann (wenn eine Applikation root bekommt UND sie böse ist UND nen paar Sachen richtig macht) das Smartphone in einen teuren Ziegelstein verwandeln. +

+

ROM

+

+ Ich benutze Android Revolution HD - die auf dem Original von HTC aufsetzt und für mich extrem stabil läuft (kein Absturz bisher). Bei anderen ROMs (CyanogenMod, ..) hab ich bei anderen Leuten mäßige Erfahrungen gemacht, die ein weiteres Patchen etc. notwendig gemacht haben. Allerdings kann man hier auch durchaus flexibel sein. +

+

Interface

+

+ Bei meiner ROM wird das original HTC-Interface mitgeliefert, welches dem Standard-Android ähnlich sieht. Dies ist für meine Zwecke kompletter Mist. Ich will mit max 3 Klicks/Gesten was gestartet haben - und nicht erst 3 Wischgesten machen, drölf Widgets, die blinken etc. haben. +

+ +

+ Daher nutze ich den SmartLauncher (YouTube-Preview) mit KDE-Theme und Notify-App +

+ +

+ Dies sorgt für eine sehr simple Oberfläche (für dich mich bisher viele beneidet haben). +

+

Kalender/Kontakte

+

+ Kürzlich habe ich meinen Kalender eingerichtet. Ich wollte, dass dieser synchron ist mit meiner (owncloud), welche auf meinem Server läuft. Dies kann man sich auch selbst zu Haus einrichten (z.b. auf einem Raspberry Pi und per dyndns nach außen freigeben). Ich gebe meine Kalender und Kontaktdaten ungerne an Google, Yahoo, Facebook, etc. pp. +

+ +

+ SolCalendar ist einer der wenigen, welche das CalDav-Format frei konfigurierbar unterstützten. Bei vielen anderen hat man dort Google oder Yahoo zur Auswahl - aber kann keinen eigenen Server eingeben. Dies synchronisiert auch in den Android-Eigenen Kalender hinein (Vorsicht: Google-Kalender-Synchronisation ausschalten! Sonst hat man wieder alles da..) und kann somit z.b. vom Standard “Sperrbildschirm” angezeigt werden. +

+ +

+ Meine owncloud kann ich so vom PC (Thunderbird oder Browser) steuern, per Cronjob mit Terminen versorgen (z.b. spielt mein Server jeden Tag den ekVV-Stundenplan ein) und auch auf dem Smartphone alles editieren. +

+ +

+ Für die Kontakte lege ich jedem diesen Programmierer ans Herz: Marten Gajda - sämtliche Apps funktionieren miteinander, sind aber zum Teil kostenbehaftet. CardDav Sync free synchronisiert Kontakte allerdings tadellos. Für den Kalender (mit ähnlichen Features wie beim SolCalendar) werden aber 2,59€ fällig. Langfristig soll dieser aber auch OpenSource (und damit kostenfrei) werden. +

+

Nützliche Apps

+

+ Hier kurz nützliche Apps und wofür diese da sind: +

+ +
    + +
  • + ES Datei Explorer Dateien öffnen, verschieben, suchen, … Inkl. Media-Player etc. +
  • + +
  • + Free Note Kurze Notizen +
  • + +
  • + Alkido eBook-Reader (auch für pdf) +
  • + +
  • + Folder Sync Sync von Dateien mit meiner ownCloud (z.Zt. nur manueller batch-upload von Fotos bei mir) +
  • + +
  • + GnuPG-Client +
  • + +
  • + Mail +
  • + +
  • + VLC Alternativer Media-Player für “komische” Formate, kaputte Dateien etc. +
  • + +
  • + Root Uninstaller Entfernen von Applikationen auf der Systempartition (z.b. Facebook, Chromium, …) Vorsicht: KANN eine Neuinstallation nötig machen, wenn wichtige Dinge gelöscht werden! +
  • + +
  • + AnkiDroid Vokabeln/Sprachen etc. lernen unterwegs. +
  • + +
+

LMT

+

+ Der letzte Schrei auf gerooteten Smartphones ist LMT: YouTube-Demo. +

+ +

+ Installations-Anleitung +

+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell.html b/static_gen/Haskell.html new file mode 100644 index 0000000..eb6ca72 --- /dev/null +++ b/static_gen/Haskell.html @@ -0,0 +1,1218 @@ + + + + + + + + Haskell – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Haskell + +

+ +
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Advantages.html b/static_gen/Haskell/Advantages.html new file mode 100644 index 0000000..3ad6662 --- /dev/null +++ b/static_gen/Haskell/Advantages.html @@ -0,0 +1,1301 @@ + + + + + + + + Talks und Posts zu Haskell – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Talks und Posts zu Haskell + +

+
+ + +

+ Gründe Haskell zu nutzen und wo Vorteile liegen. +

+

Talks

Simon Peyton Jones

+ +

Others

+ +

Bücher/Paper

Simon Peyton Jones

+ +

Others

+ +

Funny Talks

+ +

Unsorted/Unseen

+ +

Tutorials

+ + + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Code Snippets.html b/static_gen/Haskell/Code Snippets.html new file mode 100644 index 0000000..e2d1caf --- /dev/null +++ b/static_gen/Haskell/Code Snippets.html @@ -0,0 +1,1212 @@ + + + + + + + + Code-Snippets – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Code-Snippets + +

+ +
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Code Snippets/Monoid.html b/static_gen/Haskell/Code Snippets/Monoid.html new file mode 100644 index 0000000..0e4792e --- /dev/null +++ b/static_gen/Haskell/Code Snippets/Monoid.html @@ -0,0 +1,1363 @@ + + + + + + + + Monoid? Da war doch was… – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Monoid? Da war doch was… + +

+
+ + +

+ Stellen wir uns vor, dass wir eine Funktion schreiben, die einen String bekommt (mehrere Lines mit ACSII-Text) und dieses Wort-für-Wort rückwärts ausgeben soll. Das ist ein einfacher Einzeiler: +

+
module Main where
+
+import System.Environment (getArgs)
+import Data.Monoid (mconcat)
+import Data.Functor ((<$>))
+
+main = do
+    ls <- readFile =<< head <$> getArgs
+    mconcat <$> mapM (putStrLn . unwords . reverse . words) (lines ls) --die eigentliche Funktion, ls ist das argument.
+

+ Was passiert hier an Vodoo? Und was machen die ganzen wilden Zeichen da? +

+ +

+ Gehen wir die Main zeilenweise durch: Wir lesen die Datei, die im ersten Kommandozeilen-Argument gegeben wird. getArgs hat folgende Signatur: +

+
getArgs :: IO [String]
+

+ Wir bekommen als eine Liste der Argumente. Wir wollen nur das erste. Also machen wir head getArgs. Allerdings fliegt uns dann ein Fehler. head sieht nämlich so aus: +

+
head :: [a] -> a
+

+ Irgendwie müssen wird as in das IO bekommen. Hierzu gibt es fmap. Somit ist +

+
fmap head :: IO [a] -> IO a
+

+ Ein inline-Alias (um die Funktion links und das Argument rechts zu schreiben und sich ne Menge Klammern zu sparen) ist <$>. Somit ist schlussendlich der Inhalt der Datei aus dem ersten Argument (lazy) in ls. +

+ +

+ Eine andere Möglichkeit sich das (in diesem Fall) zu merken, bzw. drauf zu kommen ist, dass [] AUCH ein Funktor (sogar eine Monade) ist. Man könnte das also auch so schreiben: +

+
head                ::              [] a      ->   a
+head                :: Functor f => [] (f a)     -> f a -- das "a" geschickt ersetzt zur Verdeutlichung
+getArgs             ::              IO [] String
+fmap head           :: Functor f => f  [] a      -> f a
+

+ fmap “packt” die Funktion quasi 1 Umgebung (Funktor, Monade, ..) weiter rein - Sei es nun in Maybe, Either oder irgendwas anderes. +

+ +

+ Alternatives (ausführliches) Beispiel am Ende. +

+ +

+ Wenn wir uns die Signatur ansehen, dann haben wir nun +

+
head <$> getArgs :: IO String
+

+ readFile will aber nun ein String haben. Man kann nun +

+
f  <- head <$> getArgs
+ls <- readFile f
+

+ kann man auch “inline” mit =<< die Sachen “auspacken”. +

+ +

+ Die 2. Zeile lesen wir nun einfach “von hinten”, wie man das meistens tun sollte. Hier ist ein +

+
lines ls :: [String]
+

+ was uns den Inhalt der Datei zeilenweise gibt. Mit jeder Zeile möchten wir nun folgendes machen: +

+ +
    + +
  • + nach Wörtern trennen (words) +
  • + +
  • + Wörter in der reihenfolge umkehren (reverse) +
  • + +
  • + Wörter wider zu einer Zeile zusammensetzen (unwords) +
  • + +
  • + diese Zeile ausgeben (putStrLn) +
  • + +
+ +

+ Wenn wir uns die Signatur ansehen: +

+
(putStrLn . unwords . reverse . words) :: String -> IO ()
+

+ Das mag im ersten Moment verwirren, daher noch die Signaturen der Einzelfunktionen: +

+
words    :: String -> [String]
+reverse  :: [a] -> [a]
+unwords  :: [String] -> String
+putStrLn :: String -> IO ()
+

+ Da wir am Ende in der IO-Monade landen müssen wir das auf unsere Zeilen mit mapM statt map anwenden. Dies sorgt auch dafür, dass die Liste der reihe nach durchgegangen wird. mapM mit unserer Funktion schaut dann so aus: +

+
mapM (putStrLn . unwords . reverse . words) :: [String] -> [IO ()]
+

+ eek! Das [IO ()] sieht ekelig aus. Wir haben eine Liste von IO-gar nichts. Das können wir eigentlich entsorgen. Da wir innerhalb der main-Funktion in einer IO-Monade sind, wollen wir IO () anstatt [IO ()] zurück haben. +

+ +

+ Wenn wir uns jetzt erinnern, dass [] auch nur eine Monade ist und dass jede Monade ein Monoid ist, dann ist die Lösung einfach. Monoide haben eine “append”-funktion (mappend oder (<>) genannt). Wenn wir “nichts” an “nichts” anhängen, dann erhalten wir …. Trommelwirbel “nichts”! Wir müssen die [IO ()]-Liste also “nur noch” mit mappend falten. Hierzu gibt es schon eine vorgefertigte Funktion: +

+
mconcat :: [a] -> a
+mconcat = foldr mappend mempty
+

+ Was genau die gewünschte Faltung macht. Wir müssen nun wieder fmap nehmen, da wir die Liste selbst falten wollen - und nicht map, welches auf den IO () innerhalb der Liste arbeiten würde. Durch die Faltung fällt die Liste nun auf IO () zusammen. +

+ +

+ Viel Voodoo in wenig Code, aber wenn man sich dran gewöhnt hat, sind Monaden in Monaden auch nicht schlimm. Man muss sich immer nur richtig “rein” fmap’en. +

+ +
+ +

+ Kleinen Tipp gab es noch: mapM_ macht genau das, was oben mit mconcat erreicht werden sollte. Somit kann man auch +

+
mapM_ (putStrLn . unwords . reverse . words) (lines ls)
+

+ schreiben. Ich hab es aber mal wegen der klarheit oben so gelassen. +

+

Alternatives fmap-Beispiel

+

+ Nehmen wir als alternatives Beispiel mal an: +

+
a :: IO Maybe State t
+

+ Um Funktionen vom Typ +

+
f :: IO a -> IO a
+f a             -- valide
+

+ zu nehmen, brauchen wir nichts machen. Bei +

+
f' :: Maybe a -> Maybe a
+

+ brauchen wir 1 fmap, also ein +

+
f' a            -- error
+f' <$> a
+

+ um eine Funktion +

+
f'' :: State t -> State t
+

+ zu benutzen folglich: +

+
f'' a           -- error
+f'' <$> a       -- error
+fmap f'' <$> a
+ +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Code Snippets/Morphisms.html b/static_gen/Haskell/Code Snippets/Morphisms.html new file mode 100644 index 0000000..05fbcb3 --- /dev/null +++ b/static_gen/Haskell/Code Snippets/Morphisms.html @@ -0,0 +1,1480 @@ + + + + + + + + *-Morpisms – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + *-Morpisms + +

+
+ + +

+ Backup eines Blogposts eines Kommilitonen: +

+ +

+ This weekend I spend some time on Morphisms. +

+ +

+ Knowing that this might sound daunting to many dabbling Haskellers (like I am), I decided to write a real short MergeSort hylomorphism quickstarter. +

+ +
+ +

+ For those who need a refresher: MergeSort works by creating a balanced binary tree from the input list and directly collapsing it back into itself while treating the children as sorted lists and merging these with an O(n) algorithm. +

+ +
+ +

+ First the usual prelude: +

+
{-# LANGUAGE DeriveFunctor #-}
+{-# LANGUAGE TypeFamilies #-}
+
+import Data.Functor.Foldable 
+import Data.List (splitAt, unfoldr)
+
+ +

+ We will use a binary tree like this. Note that there is no explicit recursion used, but NodeF has two holes. These will eventually filled later. +

+
data TreeF c f = EmptyF | LeafF c | NodeF f f
+  deriving (Eq, Show, Functor)
+
+ +

+ Aside: We could use this as a normal binary tree by wrapping it in Fix: type Tree a = Fix (TreeF a) But this would require us to write our tree like Fix (NodeF (Fix (LeafF 'l')) (Fix (LeafF 'r'))) which would get tedious fast. Luckily Edward build a much better way to do this into recursion-schemes. I will touch on this later. +

+ +
+ +

+ Without further ado we start to write a Coalgebra, which in my book is just a scary name for “function that is used to construct datastructures”. +

+
unflatten :: [a] -> TreeF a [a]
+unflatten (  []) = EmptyF
+unflatten (x:[]) = LeafF x
+unflatten (  xs) = NodeF l r   where (l,r) = splitAt (length xs `div` 2) xs
+

+ From the type signature it’s immediately obvious, that we take a list of ’a’s and use it to create a part of our tree. +

+ +

+ The nice thing is that due to the fact that we haven’t commited to a type in our tree nodes we can just put lists in there. +

+ +
+ +

+ Aside: At this point we could use this Coalgebra to construct (unsorted) binary trees from lists: +

+
example1 = ana unflatten [1,3] == Fix (NodeF (Fix (LeafF 1)) (Fix (LeafF 3)))
+
+ +

+ On to our sorting, tree-collapsing Algebra. Which again is just a creepy word for “function that is used to deconstruct datastructures”. +

+ +

+ The function mergeList is defined below and just merges two sorted lists into one sorted list in O(n), I would probably take this from the ordlist package if I were to implement this for real. +

+ +

+ Again we see that we can just construct our sorted output list from a TreeF that apparently contains just lists. +

+
flatten :: Ord a => TreeF a [a] -> [a]
+flatten EmptyF      = []
+flatten (LeafF c)   = [c]
+flatten (NodeF l r) = mergeLists l r 
+
+ +

+ Aside: We could use a Coalgebra to deconstruct trees: +

+
example2 = cata flatten (Fix (NodeF (Fix (LeafF 3)) (Fix (LeafF 1)))) == [1,3]
+
+ +

+ Now we just combine the Coalgebra and the Algebra with one from the functions from Edwards recursion-schemes library: +

+
mergeSort :: Ord a => [a] -> [a]
+mergeSort = hylo flatten unflatten
+
+example3 = mergeSort [5,2,7,9,1,4] == [1,2,4,5,7,9] 
+
+ +

+ What have we gained? +

+ +

+ We have implemented a MergeSort variant in 9 lines of code, not counting the mergeLists function below. Not bad, but this implementation is not much longer. +

+ +

+ On the other hand the morphism based implementation cleanly describes what happens during construction and deconstruction of our intermediate structure. +

+ +

+ My guess is that, as soon as the algortihms get more complex, this will really make a difference. +

+ +
+ +

+ At this point I wasn’t sure if this was useful or remotely applicable. Telling someone “I spend a whole weekend learning about Hylomorphism” isn’t something the cool developer kids do. +

+ +

+ It appeared to me that maybe I should have a look at the Core to see what the compiler finally comes up with (edited for brevity): +

+
    mergeSort :: [Integer] -> [Integer]
+    mergeSort =
+      \ (x :: [Integer]) ->
+        case x of wild {
+          [] -> [];
+          : x1 ds ->
+            case ds of _ {
+              [] -> : x1 ([]);
+              : ipv ipv1 ->
+                unfoldr
+                  lvl9
+                  (let {
+                     p :: ([Integer], [Integer])
+                     p =
+                       case $wlenAcc wild 0 of ww { __DEFAULT ->
+                       case divInt# ww 2 of ww4 { __DEFAULT ->
+                       case tagToEnum# (<# ww4 0) of _ {
+                         False ->
+                           case $wsplitAt# ww4 wild of _ { (# ww2, ww3 #) -> (ww2, ww3) };
+                         True -> ([], wild)
+                       }
+                       }
+                       } } in
+                   (case p of _ { (x2, ds1) -> mergeSort x2 },
+                    case p of _ { (ds1,  y) -> mergeSort y  }))
+            }
+        }
+    end Rec }
+

+ While I am not really competent in reading Core and this is actually the first time I bothered to try, it is immediately obvious that there is no trace of any intermediate tree structure. +

+ +

+ This is when it struck me. I was dazzled and amazed. And am still. Although we are writing our algorithm as if we are working on a real tree structure the library and the compiler are able to just remove the whole intermediate step. +

+ +
+ +

+ Aftermath: +

+ +

+ In the beginning I promised a way to work on non-functor data structures. Actually that was how I began to work with the recursion-schemes library. +

+ +

+ We are able to create a ‘normal’ version of our tree from above: +

+
data Tree c = Empty | Leaf c | Node (Tree c) (Tree c)
+  deriving (Eq, Show)
+

+ But we can not use this directly with our (Co-)Algebras. Luckily Edward build a little bit of type magic into the library: +

+
type instance Base (Tree c) = (TreeF c)
+
+instance Unfoldable (Tree c) where
+  embed EmptyF      = Empty
+  embed (LeafF c)   = Leaf c
+  embed (NodeF l r) = Node l r
+
+instance Foldable (Tree c) where
+  project Empty      = EmptyF
+  project (Leaf c)   = LeafF c
+  project (Node l r) = NodeF l r
+

+ Without going into detail by doing this we establish a relationship between Tree and TreeF and teach the compiler how to translate between these types. +

+ +

+ Now we can use our Alebra on our non functor type: +

+
example4 = cata flatten (Node (Leaf 'l') (Leaf 'r')) == "lr"
+

+ The great thing about this is that, looking at the Core output again, there is no traces of the TreeF structure to be found. As far as I can tell, the algorithm is working directly on our Tree type. +

+ +
+ +

+ Literature: +

+ + + +
+ +

+ Appendix: +

+
mergeLists :: Ord a => [a] -> [a] -> [a]
+mergeLists = curry $ unfoldr c where
+  c ([], [])     = Nothing
+  c ([], y:ys)   = Just (y, ([], ys))
+  c (x:xs, [])   = Just (x, (xs, []))
+  c (x:xs, y:ys) | x <= y = Just (x, (xs, y:ys)) 
+                 | x > y  = Just (y, (x:xs, ys))
+ +
+
+ + +
+
Links to this page
+ +
+ +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/FFPiH.html b/static_gen/Haskell/FFPiH.html new file mode 100644 index 0000000..48e04a6 --- /dev/null +++ b/static_gen/Haskell/FFPiH.html @@ -0,0 +1,1331 @@ + + + + + + + + Fortgeschrittene funktionale Programmierung in Haskell – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Fortgeschrittene funktionale Programmierung in Haskell + +

+
+ + +

+ FFPiH ist eine Vorlesung, die ich zusammen mit einem Kommilitonen im Sommer 2015 erstmals erstellt und gehalten haben. +

+ +

+ Insgesamt haben wir die Vorlesung 3x gehalten, wobei von der ersten zur zweiten Iteration der Inhalt massiv überarbeitet wurde und bei der Iteration von der zweiten zur dritten Vorlesung die Übungen komplett neu erstellt wurden. +

+ +

+ Die gesamten Übungen sind unter anderem in der FFPiH-Organisation in meinem gitea hinterlegt: https://gitea.dresselhaus.cloud/FFPiH +

+ +

+ Einige der aktualisierten Übungen sind privat geschaltet, da diese iterativ aufeinander aufbauen und jeweils die Musterlösung der vorherigen enthalten. +

+

Aufbau der Vorlesung

+

+ Vorausgesetzt wurde, dass die Studierenden das erste Semester abgeschlossen hatten und somit bereits leichte Grundlagen in Haskell kannten (aber z.b. Dinge wie Functor/Applicative/Monad noch nicht wirklich erklärt bekommen haben). +

+ +

+ Stück für Stück werden die Studis dann zunächst in abstrakte Konstrukte eingeführt, aber diese werden dann schnell in die Praxis umgesetzt. Etwa mit dem Schreiben eines eigenen Parsers. +

+ +

+ Schlussendlich gibt es dann einen “Rundumschlag” durch die gesamte Informatik. Erstellung eines Spieles (auf basis einer kleinen Grundlage), erstellung von WebApps mit Yesod, Parallelisierung und Nebenläufigkeit für rechenintensive Anwendungen inkl. synchronisation mittels STM. +

+ +

+ Optional gab es weitere Übungen zu dingen wie “verteiltes Rechnen”. +

+ +

+ Ziel hierbei war nicht, diese ganzen Themen in der Tiefe beizubringen, sondern aufzuzeigen, wie sie sehr schnell abstrakte Konstrukte, die ihnen ggf. 3 Semester später erst begegnen bugfrei benutzen können, da Haskell hier in sehr vielen Fällen einfach nur die “richtige” Lösung kompilieren lässt und alle gängigen Fallen schlicht ausschließt. Beispiel ist z.b. STM innerhalb von STM, Mischen von DB-Monade, Handler-Monade und Template-Engine in Yesod, Process () statt IO () in der Nutzung von CloudHaskell, etc. pp. +

+

Studentisches Feedback

+

+ Sehr gutes Feedback von den Studenten bekamen wir insbesondere für Übungen wie: +

+ +

+ Übung 2, Aufgabe 2, weil hier durch “einfaches” umformen hin zu Abstraktionen und mit den Regeln dieser im ersten Fall die Laufzeit (vor Compileroptimierungen) von O(n²) auf O(0) ändert. +

+ +

+ Übung 4, welche ein komplett fertigen (sehr rudimentären und simplen) Dungeon-Crawler bereitstellt, der “nur” 1-2 bugs hat und “wie ein echtes Projekt” erweitert werden muss. Diese Übung hat sich dann über 4 weitere Übungen gestreckt, wobei folgende Aufgaben gelöst werden müssen: +

+ +
    + +
  • + Einarbeitung in QuickCheck zur Behebung eines Bugs im Test +
  • + +
  • + Umschreiben von explizitem Argument-Passing hin zu Monad-Transformers mit stateful lenses +
  • + +
  • + Continuation-Basierendes Event-System +
  • + +
  • + Hinzufügen eines Parsers für Level, Items & deren Effekte und implementation dieser +
  • + +
  • + Ändern des GUI-Parts von CLI auf 2D GL mittels gloss +
  • + +
  • + Ändern von StateT World auf RWST GameConfig Log World und somit nutzen von individuellen Konfigurationen für z.b. Keybindings +
  • + +
+ + +
+ + +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Lenses.html b/static_gen/Haskell/Lenses.html new file mode 100644 index 0000000..82d06fe --- /dev/null +++ b/static_gen/Haskell/Lenses.html @@ -0,0 +1,1800 @@ + + + + + + + + Lenses – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Lenses + +

+
+ +

Wofür brauchen wir das überhaupt?

+

+ Die Idee dahinter ist, dass man Zugriffsabstraktionen über Daten verknüpfen kann. Als einfachen Datenstruktur kann man einen Record mit der entsprechenden Syntax nehmen. +

+

Beispiel

data Person = P { name :: String
+                , addr :: Address
+                , salary :: Int }
+data Address = A { road :: String
+                 , city :: String
+                 , postcode :: String }
+-- autogeneriert unten anderem: addr :: Person -> Address
+    
+    setName :: String -> Person -> Person
+    setName n p = p { name = n } --record update notation
+    
+    setPostcode :: String -> Person -> Person
+    setPostcode pc p
+        = p { addr = addr p { postcode = pc } }
+    -- update of a record inside a record

Probleme

+

+ Probleme mit diesem Code: +

+ +
    + +
  • + für 1-Dimensionale Felder ist die record-syntax ok. +
  • + +
  • + tiefere Ebenen nur umständlich zu erreichen +
  • + +
  • + eigentlich wollen wir nur pe in p setzen, müssen aber über addr etc. gehen. +
  • + +
  • + wir brauchen wissen über die “Zwischenstrukturen”, an denen wir nicht interessiert sind +
  • + +
+

Was wir gern hätten

data Person = P { name :: String
+                , addr :: Address
+                , salary :: Int }
+-- a lens for each field
+lname   :: Lens' Person String
+laddr   :: Lens' Person Adress
+lsalary :: Lens' Person Int
+-- getter/setter for them
+view    :: Lens' s a -> s -> a
+set     :: Lens' s a -> a -> s -> s
+-- lens-composition
+composeL :: Lens' s1 s2 -> Lens s2 a -> Lens' s1 a

Wie uns das hilft

+

+ Mit diesen Dingen (wenn wir sie hätten) könnte man dann +

+
data Person = P { name :: String
+                , addr :: Address
+                , salary :: Int }
+data Address = A { road :: String
+                 , city :: String
+                 , postcode :: String }
+setPostcode :: String -> Person -> Person
+setPostcode pc p
+    = set (laddr `composeL` lpostcode) pc p
+

+ machen und wäre fertig. +

+

Trivialer Ansatz

Getter/Setter als Lens-Methoden

data LensR s a = L { viewR :: s -> a
+                   , setR  :: a -> s -> s }
+
+composeL (L v1 u1) (L v2 u2)
+  = L (\s -> v2 (v1 s))
+      (\a s -> u1 (u2 a (v1 s)) s)

Wieso ist das schlecht?

+
    + +
  • + extrem ineffizient +
  • + +
+ +

+ Auslesen traversiert die Datenstruktur, dann wird die Funktion angewendet und zum setzen wird die Datenstruktur erneut traversiert: +

+
over :: LensR s a -> (a -> a) -> s -> s
+over ln f s = setR l (f (viewR l s)) s
+
    + +
  • + Lösung: modify-funktion hinzufügen +
  • + +
+
data LensR s a
+   = L { viewR :: s -> a
+       , setR  :: a -> s -> s
+       , mod   :: (a->a) -> s -> s
+       , modM  :: (a->Maybe a) -> s -> Maybe s
+       , modIO :: (a->IO a) -> s -> IO s }
+

+ Neues Problem: Für jeden Spezialfall muss die Lens erweitert werden. +

+

Something in common

+

+ Man kann alle Monaden abstrahieren. Functor reicht schon: +

+
data LensR s a
+   = L { viewR :: s -> a
+       , setR  :: a -> s -> s
+       , mod   :: (a->a) -> s -> s
+       , modF  :: Functor f => (a->f a) -> s -> f s }
+

+ Idee: Die 3 darüberliegenden durch modF ausdrücken. +

+

Typ einer Lens

+

+ Wenn man das berücksichtigt, dann hat einen Lens folgenden Typ: +

+
type Lens' s a = forall f. Functor f
+                           => (a -> f a) -> s -> f s
+

+ Allerdings haben wir dann noch unseren getter/setter: +

+
data LensR s a = L { viewR :: s -> a
+                   , setR :: a -> s -> s }
+

+ Stellt sich raus: Die sind isomorph! Auch wenn die von den Typen her komplett anders aussehen. +

+

Benutzen einer Lens als Setter

set :: Lens' s a -> (a -> s -> s)
+set ln a s = --...umm...
+--:t ln => (a -> f a) -> s -> f s
+--            => get s out of f s to return it
+

+ Wir können für f einfach die “Identity”-Monade nehmen, die wir nachher wegcasten können. +

+
newtype Identity a = Identity a
+-- Id :: a -> Identity a
+
+runIdentity :: Identity s -> s
+runIdentity   (Identity x) = x
+
+instance Functor Identity where
+    fmap f (Identity x) = Identity (f x)
+

+ somit ist set einfach nur +

+
set :: Lens' s a -> (a -> s -> s)
+set ln x s
+   = runIdentity (ls set_fld s)
+   where
+     set_fld :: a -> Identity a
+     set_fld _ = Identity x
+     -- a was the OLD value.
+     -- We throw that away and set the new value
+

+ oder kürzer (für nerds wie den Autor der Lens-Lib) +

+
set :: Lens' s a -> (a -> s -> s)
+set ln x = runIdentity . ln (Identity . const x)

Benutzen einer Lens als Modify

+

+ Dasselbe wie Set, nur dass wir den Parameter nicht entsorgen, sondern in die mitgelieferte Funktion stopfen. +

+
over :: Lens' s a -> (a -> a) -> s -> s
+over ln f = runIdentity . ln (Identity . f)

Benutzen einer Lens als Getter

view :: Lens' s a -> (s -> a)
+view ln s = --...umm...
+--:t ln => (a -> f a) -> s -> f s
+--            => get a out of the (f s) return-value
+--            Wait, WHAT?
+

+ Auch hier gibt es einen netten Funktor. Wir packen das “a” einfach in das “f” und werfen das “s” am Ende weg. +

+
newtype Const v a = Const v
+
+getConst :: Const v a -> v
+getConst (Const x) = x
+
+instance Functor (Const v) where
+    fmap f (Const x) = Const x
+    -- throw f away. Nothing changes our const!
+

+ somit ergibt sich +

+
view :: Lens' s a -> (s -> a)
+view ln s 
+  = getConst (ln Const s)
+              -- Const :: s -> Const a s
+

+ oder nerdig +

+
view :: Lens' s a -> (s -> a)
+view ln = getConst . ln Const

Lenses bauen

+

+ Nochmal kurz der Typ: +

+
type Lens' s a = forall f. Functor f
+                     => (a -> f a) -> s -> f s
+

+ Für unser Personen-Beispiel vom Anfang: +

+
data Person = P { _name :: String, _salary :: Int }
+
+name :: Lens' Person String
+-- name :: Functor f => (String -> f String)
+--                    -> Person -> f Person
+
+name elt_fn (P n s)
+  = fmap (\n' -> P n' s) (elt_fn n)
+-- fmap :: Functor f => (a->b) -> f a -> f b - der Funktor, der alles verknüpft
+-- \n' -> .. :: String -> Person - Funktion um das Element zu lokalisieren (WO wird ersetzt/gelesen/...)
+-- elt_fn n  :: f String         - Funktion um das Element zu verändern (setzen, ändern, ...)
+

+ Die Lambda-Funktion ersetzt einfach den Namen. Häufig sieht man auch +

+
name elt_fn (P n s)
+  = (\n' -> P n' s) <$> (elt_fn n)
+--  |    Focus    |     |Function|

Wie funktioniert das intern?

view name (P {_name="Fred", _salary=100})
+   -- inline view-function
+= getConst (name Const (P {_name="Fred", _salary=100})
+   -- inline name
+= getConst (fmap (\n' -> P n' 100) (Const "Fred"))
+   -- fmap f (Const x) = Const x - Definition von Const
+= getConst (Const "Fred")
+   -- getConst (Const x) = x
+= "Fred"
+

+ Dieser Aufruf hat KEINE Runtime-Kosten, weil der Compiler direkt die Adresse des Feldes einsetzen kann. Der gesamte Boilerplate-Code wird vom Compiler wegoptimiert. +

+ +

+ Dies gilt für jeden Funktor mit newtype, da das nur ein Typalias ist. +

+

Composing Lenses und deren Benutzung

+

+ Wie sehen denn die Typen aus? +

+ +

+ Wir wollen ein +

+ +
+ +

+ Lens’ s1 s2 -> Lens’ s2 a -> Lens’ s1 a +

+ +
+ +

+ Wir haben 2 Lenses +

+ +
+ +

+ ln1 :: (s2 -> f s2) -> (s1 -> f s1) ln2 :: (a -> f a) -> (s2 -> f s2) +

+ +
+ +

+ wenn man scharf hinsieht, kann man die verbinden +

+ +
+ +

+ ln1 . ln2 :: (a -> f s) -> (s1 -> f s1) +

+ +
+ +

+ und erhält eine Lens. Sogar die Gewünschte!
Somit ist Lens-Composition einfach nur Function-Composition (.). +

+

Automatisieren mit Template-Haskell

+

+ Der Code um die Lenses zu bauen ist für records immer Identisch: +

+
data Person = P { _name :: String, _salary :: Int }
+
+name :: Lens' Person String
+name elt_fn (P n s) = (\n' -> P n' s) <$> (elt_fn n)
+

+ Daher kann man einfach +

+
import Control.Lens.TH
+data Person = P { _name :: String, _salary :: Int }
+
+$(makeLenses ''Person)
+

+ nehmen, was einem eine Lens für “name” und eine Lens für “salary” generiert.
Mit anderen Templates kann man auch weitere Dinge steuern (etwa wofür Lenses generiert werden, welches Prefix (statt _) man haben will etc. pp.). +

+ +

+ Will man das aber haben, muss man selbst in den Control.Lens.TH-Code schauen. +

+

Lenses für den Beispielcode

import Control.Lens.TH
+
+data Person = P { _name :: String
+                , _addr :: Address
+                , _salary :: Int }
+data Address = A { _road :: String
+                 , _city :: String
+                 , _postcode :: String }
+
+$(makeLenses ''Person)
+$(makeLenses ''Address)
+
+setPostcode :: String -> Person -> Person
+setPostcode pc p = set (addr . postcode) pc p

Shortcuts mit “Line-Noise”

-- ...
+
+setPostcode :: String -> Person -> Person
+setPostcode pc p = addr . postcode .~ pc     $ p
+--                 |   Focus     |set|to what|in where
+
+getPostcode :: Person -> String
+getPostcode p = p   ^. $ addr . postcode
+--            |from|get|    Focus       |
+

+ Es gibt drölf-zillionen weitere Infix-Operatoren (für Folds, Listenkonvertierungen, -traversierungen, …) +

+

Virtuelle Felder

+

+ Man kann mit Lenses sogar Felder emulieren, die gar nicht da sind. Angenommen folgender Code: +

+
data Temp = T { _fahrenheit :: Float }
+
+$(makeLenses ''Temp)
+-- liefert Lens: fahrenheit :: Lens Temp Float
+
+centigrade :: Lens Temp Float
+centigrade centi_fn (T faren)
+  = (\centi' -> T (cToF centi'))
+    <$> (centi_fn (fToC faren))
+-- cToF & fToC as Converter-Functions defined someplace else
+

+ Hiermit kann man dann auch Funktionen, die auf Grad-Celsius rechnen auf Daten anwenden, die eigenlich nur Fahrenheit speichern, aber eine Umrechnung bereitstellen. Analog kann man auch einen Zeit-Datentypen definieren, der intern mit Sekunden rechnet (und somit garantiert frei von Fehlern wie -3 Minuten oder 37 Stunden ist) +

+

Non-Record Strukturen

+

+ Das ganze kann man auch parametrisieren und auf Non-Record-Strukturen anwenden. Beispielhaft an einer Map verdeutlicht: +

+
-- from Data.Lens.At
+at :: Ord k => k -> Lens' (Map k v) (Maybe v)
+
+-- oder identisch, wenn man die Lens' auflöst:
+at :: Ord k, forall f. Functor f => k -> (Maybe v -> f Maybe v) -> Map k v -> f Map k v
+
+at k mb_fn m
+  = wrap <$> (mb_fn mv)
+  where
+    mv = Map.lookup k m
+    
+    wrap :: Maybe v -> Map k v
+    wrap (Just v') = Map.insert k v' m
+    wrap Nothing   = case mv of
+                       Nothing -> m
+                       Just _  -> Map.delete k m
+
+-- mb_fn :: Maybe v -> f Maybe v

Weitere Beispiele

+
    + +
  • + +

    + Bitfields auf Strukturen die Bits haben (Ints, …) in Data.Bits.Lens +

    + +
  • + +
  • + +

    + Web-scraper in Package hexpat-lens +

    +
    p ^.. _HTML' . to allNodes
    +             . traverse . named "a"
    +             . traverse . ix "href"
    +             . filtered isLocal
    +             . to trimSpaces
    +

    + Zieht alle externen Links aus dem gegebenen HTML-Code in p um weitere ziele fürs crawlen zu finden. +

    + +
  • + +
+

Erweiterungen

+

+ Bisher hatten wir Lenses nur auf Funktoren F. Die nächstmächtigere Klasse ist Applicative. +

+
type Traversal' s a = forall f. Applicative f
+                             => (a -> f a) -> (s -> f s)
+

+ Da wir den Container identisch lassen (weder s noch a wurde angefasst) muss sich etwas anderes ändern. Statt eines einzelnen Focus erhalten wir viele Foci. +

+ +

+ Was ist ein Applicative überhaupt? Eine schwächere Monade (nur 1x Anwendung und kein Bind - dafür kann man die beliebig oft hintereinanderhängen). +

+
class Functor f => Applicative f where
+  pure  :: a -> f a
+  (<*>) :: f (a -> b) -> f a -> f b
+
+-- Monade als Applicative:
+pure = return
+mf <*> mx = do { f <- mf; x <- mx; return (f x) }
+

+ Recap: Was macht eine Lens: +

+
data Adress = A { _road :: String
+                , _city :: String
+                , _postcode :: String }
+
+road :: Lens' Adress String
+road elt_fn (A r c p) = (\r' -> A r' c p) <$> (elt_fn r)
+--                      |    "Hole"     |     | Thing to put in|
+

+ Wenn man nun road & city gleichzeitig bearbeiten will: +

+
addr_strs :: Traversal' Address String
+addr_strs elt_fn (A r c p)
+  = ... (\r' c' -> A r' c' p)    .. (elt_fn r) .. (elt_fn c) ..
+--      | function with 2 "Holes"|  first Thing |  second Thing
+

+ fmap kann nur 1 Loch stopfen, aber nicht mit n Löchern umgehen. Applicative mit <*> kann das.
Somit gibt sich +

+
addr_strs :: Traversal' Address String
+addr_strs elt_fn (A r c p)
+  = pure           (\r' c' -> A r' c' p)  <*> (elt_fn r) <*> (elt_fn c)
+--  lift in Appl. | function with 2 "Holes"|  first Thing |  second Thing
+-- oder kürzer
+addr_strs :: Traversal' Address String
+addr_strs elt_fn (A r c p)
+  = (\r' c' -> A r' c' p)  <$> (elt_fn r) <*> (elt_fn c)
+-- pure x <*> y == x <$> y
+

+ Wie würd eine modify-funktion aussehen? +

+
over :: Lens' s a -> (a -> a) -> s -> s
+over ln f = runIdentity . ln (Identity . f)
+
+over :: Traversal' s a -> (a -> a) -> s -> s
+over ln f = runIdentity . ln (Identity . f)
+

+ Der Code ist derselbe - nur der Typ ist generischer. Auch die anderen Dinge funktioniert diese Erweiterung (für Identity und Const muss man noch ein paar dummy-Instanzen schreiben um sie von Functor auf Applicative oder Monad zu heben +

+ +
    + +
  • + konkret reicht hier die Instanzierung von Monoid). In der Lens-Library ist daher meist Monad m statt Functor f gefordert. +
  • + +
+

Wozu dienen die Erweiterungen?

+

+ Man kann mit Foci sehr selektiv vorgehen. Auch kann man diese durch Funktionen steuern. Beispisweise eine Funktion anwenden auf +

+ +
    + +
  • + Jedes 2. Listenelement +
  • + +
  • + Alle graden Elemente in einem Baum +
  • + +
  • + Alle Namen in einer Tabelle, deren Gehalt > 10.000€ ist +
  • + +
+ +

+ Traversals und Lenses kann man trivial kombinieren (lens . lens => lens, lens . traversal => traversal etc.) +

+

Wie es in Lens wirklich aussieht

+

+ In diesem Artikel wurde nur auf Monomorphic Lenses eingegangen. In der richtigen Library ist eine Lens +

+
type Lens' s a = Lens s s a a
+type Lens s t a b = forall f. Functor f => (a -> f b) -> (s -> f t)
+

+ sodass sich auch die Typen ändern können um z.B. automatisch einen Konvertierten (sicheren) Typen aus einer unsicheren Datenstruktur zu geben. +

+ +

+ Die modify-Funktion over ist auch +

+
> over :: Profunctor p => Setting p s t a b -> p a b -> s -> t
+
+ +

+ Edward is deeply in thrall to abstractionitis - Simon Peyton Jones +

+ +
+ +

+ Lens alleine definiert 39 newtypes, 34 data-types und 194 Typsynonyme…
Ausschnitt +

+
-- traverseOf :: Functor f => Iso s t a b           -> (a -> f b) -> s -> f t
+-- traverseOf :: Functor f => Lens s t a b          -> (a -> f b) -> s -> f t
+-- traverseOf :: Applicative f => Traversal s t a b -> (a -> f b) -> s -> f t
+
+traverseOf :: Over p f s t a b -> p a (f b) -> s -> f t
+

+ dafuq? +

+ + +
+
+ + +
+
Links to this page
+ +
+ +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Haskell/Webapp_Development.html b/static_gen/Haskell/Webapp_Development.html new file mode 100644 index 0000000..d14bb50 --- /dev/null +++ b/static_gen/Haskell/Webapp_Development.html @@ -0,0 +1,1824 @@ + + + + + + + + Webapp-Development in Haskell – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Webapp-Development in Haskell + +

+
+ + +

+ Step-by-Step-Anleitung, wie man ein neues Projekt mit einer bereits erprobten Pipeline erstellt. +

+

Definition der API

+

+ Erster Schritt ist immer ein wünsch-dir-was bei der Api-Defenition. +

+ +

+ Die meisten Services haben offensichtliche Anforderungen (Schnittstellen nach draußen, Schnittstellen intern, …). Diese kann man immer sehr gut in einem Request -> Response-Model erfassen. +

+ +

+ Diese Definition läuft über openapi-v3 und kann z.b. mit Echtzeit-Vorschau im http://editor.swagger.io/ erspielen. Per Default ist der noch auf openapi-v2 (aka swagger), kann aber auch v3. +

+ +

+ Nach der Definition, was man am Ende haben möchte, muss man sich entscheiden, in welcher Sprache man weiter entwickelt. Ich empfehle aus verschiedenen Gründen primär 2 Sprachen: Python-Microservices (weil die ML-Libraries sehr gut sind, allerdings Änderungen meist schwer sind und der Code wenig robust - meist nur 1 API-Endpunkt pro service) und Haskell (stabilität, performace, leicht zu ändern, gut anzupassen). +

+ +

+ Im folgenden wird (aus offensichtlichen Gründen) nur auf das Haskell-Projekt eingegangen. +

+

Startprojekt in Haskell

Erstellen eines neuen Projektes

+

+ zunächst erstellen wir in normales Haskell-Projekt ohne funktionalität & firlefanz: +

+
stack new myservice
+

+ Dies erstellt ein neues Verzeichnis und das generelle scaffolding. Nach einer kurzen anpassung der stack.yaml (resolver auf unserer setzen; aktuell: lts-17.4) fügen wir am Ende der Datei +

+
allow-newer: true
+ghc-options:
+    "$locals": -fwrite-ide-info
+

+ ein. Anschließend organisieren wir uns noch eine gute .gitignore und initialisieren das git mittels git init; git add .; git commit -m "initial scaffold" +

+

Generierung der API

+

+ Da die API immer wieder neu generiert werden kann (und sollte!) liegt sich in einem unterverzeichnis des Haputprojektes. +

+ +

+ Initial ist es das einfachste ein leeres temporäres Verzeichnis woanders zu erstellen, die api-doc.yml hinein kopieren und folgendes ausführen: +

+
openapi-generator generate -g haskell -o . -i api-doc.yml
+

+ Dieses erstellt einem dann eine komplette library inkl. Datentypen. Wichtig: Der Name in der api-doc sollte vom Namen des Services (oben myservice) abweichen - entweder in Casing oder im Namen direkt. Suffixe wie API schneidet der Generator hier leider ab. (Wieso das ganze? Es entstehen nachher 2 libraries, foo & fooAPI. Da der generator das API abschneidet endet man mit foo & foo und der compiler meckert, dass er nicht weiss, welche lib gemeint ist). +

+ +

+ danach: wie gewohnt git init; git add .; git commit -m "initial". Auf dem Server der Wahl (github, gitea, gitlab, …) nun ein Repository erstellen (am Besten: myserviceAPI - alles auf API endend ist autogeneriert!) und den Anweisungen nach ein remote hinzufügen & pushen. +

+

Wieder zurück im Haskell-Service

+

+ In unserem eigentlichen Service müssen wir nun die API einbinden. Dazu erstellen wir ein Verzeichnis libs (konvention) und machen ein git submodule add <repository-url> libs/myserviceAPI +

+ +

+ Git hat nun die API in das submodul gepackt und wir können das oben erstellte temporäre verzeichnis wieder löschen. +

+ +

+ Anschließend müssen wir stack noch erklären, dass wir die API da nun liegen haben und passen wieder die stack.yaml an, indem wir das Verzeichnis unter packages hinzufügen. +

+
packages:
+- .
+- libs/myserviceAPI # <<
+

+ nun können wir in der package.yaml (oder myservice.cabal, falls kein hpack verwendet wird) unter den dependencies unsere api hinzufügen (name wie die cabal-datei in libs/myserviceAPI). +

+

Einbinden anderer Microservices

+

+ Funktioniert komplett analog zu dem vorgehen oben (ohne das generieren natürlich ;) ). stack.yaml editieren und zu den packages hinzufügen: +

+
packages:
+- .
+- libs/myserviceAPI
+- libs/myCoolMLServiceAPI
+

+ in der package.yaml (oder der cabal) die dependencies hinzufügen und schon haben wir die Features zur Verfügung und können gegen diese Services reden. +

+

Entfernen von anderen Technologien/Microservices

+

+ In git ist das entfernen von Submodules etwas frickelig, daher hier ein copy&paste der GitHub-Antwort: +

+
## Remove the submodule entry from .git/config
+git submodule deinit -f path/to/submodule
+
+## Remove the submodule directory from the superproject's .git/modules directory
+rm-rf .git/modules/path/to/submodule
+
+## Remove the entry in .gitmodules and remove the submodule directory located at path/to/submodule
+git rm-f path/to/submodule
+

+ Falls das nicht klappt, gibt es alternative Vorschläge unter dem Link oben. +

+

Woher weiss ich, was wo liegt? Dokumentation? Halloo??

+

+ Keine Panik. Ein stack haddock --open hilft da. Das generiert die Dokumentation für alle in der package.yaml (oder cabal-file) eingetragenen dependencies inkl. aller upstream-dependencies. Man bekommt also eine komplette lokale Dokumentation von allem. Geöffnet wird dann die Paket-Startseite inkl. der direkten dependencies: +

+ +

+ Es gibt 2 wichtige Pfade im Browser: +

+ +
    + +
  • + …../all/index.html - hier sind alle Pakete aufgeführt +
  • + +
  • + …../index.html - hier sind nur die direkten dependencies aufgeführt. +
  • + +
+ +

+ Wenn man einen lokalen Webserver startet kann man mittels “s” auch die interaktive Suche öffnen (Suche nach Typen, Funktionen, Signaturen, etc.). In Bash mit python3 geht das z.b. einfach über: +

+
cd $(stack path --local-doc-root)
+python3 -m SimpleHTTPServer 8000
+firefox "http://localhost:8000"

Implementation des Services und Start

Loader/Bootstrapper

+

+ Generelles Vorgehen: +

+ +
    + +
  • + +

    + in app/Main.hs: Hier ist quasi immer nur eine Zeile drin: main = myServiceMain +

    + +

    + Grund: Applications tauchen nicht im Haddock auf. Also haben wir ein “src”-Modul, welches hier nur geladen & ausgeführt wird. +

    + +
  • + +
  • + +

    + in src/MyService.hs: myServiceMain :: IO () definieren +

    + +
  • + +
+ +

+ Für die Main kann man prinzipiell eine Main andere Services copy/pasten. Im folgenden eine Annotierte main-Funktion - zu den einzelnen Vorraussetzungen kommen wir im Anschluss. +

+
{-# OPTIONS_GHC -Wno-name-shadowing #-}
+{-# LANGUAGE FlexibleContexts    #-}
+{-# LANGUAGE LambdaCase          #-}
+{-# LANGUAGE OverloadedStrings   #-}
+{-# LANGUAGE RankNTypes          #-}
+{-# LANGUAGE RecordWildCards     #-}
+{-# LANGUAGE ScopedTypeVariables #-}
+module MyService where
+ 
+-- generische imports aus den dependencies/base, nicht in der prelude
+import           Codec.MIME.Type
+import           Configuration.Dotenv                 as Dotenv
+import           Control.Concurrent                   (forkIO, threadDelay)
+import           Control.Concurrent.Async
+import           Control.Concurrent.STM
+import           Control.Monad
+import           Control.Monad.Catch
+import           Control.Monad.Except
+import           Conversion
+import           Conversion.Text                      ()
+import           Data.Binary.Builder
+import           Data.String                          (IsString (..))
+import           Data.Time
+import           Data.Time.Clock
+import           Data.Time.Format
+import           Data.Default
+import           Network.HostName
+import           Network.HTTP.Client                  as HTTP hiding
+                                                               (withConnection)
+import           Network.HTTP.Types                   (Status, statusCode)
+import           Network.Mom.Stompl.Client.Queue
+import           Network.Wai                          (Middleware)
+import           Network.Wai.Logger
+import           Network.Wai.Middleware.Cors
+import           Network.Wai.Middleware.RequestLogger (OutputFormat (..),
+                                                       logStdout,
+                                                       mkRequestLogger,
+                                                       outputFormat)
+import           Servant.Client                       (mkClientEnv,
+                                                       parseBaseUrl)
+import           System.Directory
+import           System.Envy
+import           System.IO
+import           System.Log.FastLogger
+import           Text.PrettyPrint.GenericPretty
+ 
+-- generische imports, aber qualified, weil es sonst zu name-clashes kommt
+ 
+import qualified Data.ByteString                      as BS
+-- import qualified Data.ByteString.Char8 as BS8
+import qualified Data.ByteString.Lazy                 as LBS
+import qualified Network.HTTP.Client.TLS              as UseDefaultHTTPSSettings (tlsManagerSettings)
+import qualified Network.Mom.Stompl.Client.Queue      as AMQ
+import qualified Network.Wai                          as WAI
+ 
+-- Handler für den MyServiceBackend-Typen und Imports aus den Libraries
+import           MyService.Handler                    as H  -- handler der H.myApiEndpointV1Post implementiert
+import           MyService.Types                            -- weitere Type (s. nächste box)
+import           MyServiceGen.API                     as MS -- aus der generierten library
+
+ 
+myServicemain :: IO ()
+myServicemain = do
+  -- .env-Datei ins Prozess-Environment laden, falls noch nicht von außen gesetzt
+  void $ loadFile $ Dotenv.Config [".env"] [] False
+  -- Config holen (defaults + overrides aus dem Environment)
+  sc@ServerConfig{..} <- decodeWithDefaults defConfig
+  -- Backend-Setup
+  -- legt sowas wie Proxy-Server fest und wo man wie dran kommt. Benötigt für das Sprechen mit anderen Microservices
+  let defaultHTTPSSettings = UseDefaultHTTPSSettings.tlsManagerSettings { managerResponseTimeout = responseTimeoutMicro $ 1000 * 1000 * myserviceMaxTimeout }
+      createBackend url proxy = do
+        manager <- newManager . managerSetProxy proxy
+          $ defaultHTTPSSettings
+        url' <- parseBaseUrl url
+        return (mkClientEnv manager url')
+      internalProxy = case myserviceInternalProxyUrl of
+                        ""  -> noProxy
+                        url -> useProxy $ HTTP.Proxy (fromString url) myserviceInternalProxyPort
+      -- externalProxy = case myserviceExternalProxyUrl of
+      --                   ""  -> noProxy
+      --                   url -> useProxy $ HTTP.Proxy (fromString url) myserviceExternalProxyPort
+ 
+  -- Definieren & Erzeugen der Funktionen um die anderen Services anzusprechen.
+  calls <- (,)
+           <$> createBackend myserviceAUri internalProxy  
+           <*> createBackend myserviceBUri internalProxy 
+ 
+  -- Logging-Setup
+  hSetBuffering stdout LineBuffering
+  hSetBuffering stderr LineBuffering
+ 
+ 
+  -- Infos holen, brauchen wir später
+  myName <- getHostName
+  today <- formatTime defaultTimeLocale "%F" . utctDay <$> getCurrentTime
+ 
+ 
+  -- activeMQ-Transaktional-Queue zum schreiben nachher vorbereiten
+  amqPost <- newTQueueIO
+ 
+ 
+  -- bracket a b c == erst a machen, ergebnis an c als variablen übergeben. Schmeisst c ne exception/wird gekillt/..., werden die variablen an b übergeben.
+  bracket
+   -- logfiles öffnen
+   (LogFiles <$> openFile ("/logs/myservice-"<>myName<>"-"<>today<>".info") AppendMode
+             <*> openFile (if myserviceDebug then "/logs/myservice-"<>myName<>"-"<>today<>".debug" else "/dev/null") AppendMode
+             <*> openFile ("/logs/myservice-"<>myName<>"-"<>today<>".error") AppendMode
+             <*> openFile ("/logs/myservice-"<>myName<>"-"<>today<>".timings") AppendMode
+   )
+   -- und bei exception/beendigung schlißen.h
+   (\(LogFiles a b c d) -> mapM_ hClose [a,b,c,d])
+   $ \logfiles -> do
+ 
+ 
+    -- logschreibe-funktionen aliasen; log ist hier abstrakt, iolog spezialisiert auf io.
+    let log = printLogFiles logfiles :: MonadIO m => [LogItem] -> m ()
+        iolog = printLogFilesIO logfiles :: [LogItem] -> IO ()
+ 
+ 
+        -- H.myApiEndpointV1Post ist ein Handler (alle Handler werden mit alias H importiert) und in einer eigenen Datei
+        -- Per Default bekommen Handler sowas wie die server-config, die Funktionen um mit anderen Services zu reden, die AMQ-Queue um ins Kibana zu loggen und eine Datei-Logging-Funktion
+        -- Man kann aber noch viel mehr machen - z.b. gecachte Daten übergeben, eine Talk-Instanz, etc. pp.
+        server = MyServiceBackend{ myApiEndpointV1Post = H.myApiEndpointV1Post sc calls amqPost log
+                                   }
+        config = MS.Config $ "http://" ++ myserviceHost ++ ":" ++ show myservicePort ++ "/"
+    iolog . pure . Info $ "Using Server configuration:"
+    iolog . pure . Info $ pretty sc { myserviceActivemqPassword = "******" -- Do NOT log the password ;)
+                                    , myserviceMongoPassword = "******"
+                                    }
+    -- alle Services starten (Hintergrund-Aktionen wie z.b. einen MongoDB-Dumper, einen Talk-Server oder wie hier die ActiveMQ
+    void $ forkIO $ keepActiveMQConnected sc iolog amqPost
+    -- logging-Framework erzeugen
+    loggingMW <- loggingMiddleware
+    -- server starten
+    if myserviceDebug
+       then runMyServiceMiddlewareServer config (cors (\_ -> Just (simpleCorsResourcePolicy {corsRequestHeaders = ["Content-Type"]})) . loggingMW . logStdout) server
+       else runMyServiceMiddlewareServer config (cors (\_ -> Just (simpleCorsResourcePolicy {corsRequestHeaders = ["Content-Type"]}))) server
+ 
+ 
+-- Sollte bald in die Library hs-stomp ausgelagert werden
+-- ist ein Beispiel für einen ActiveMQ-Dumper
+keepActiveMQConnected :: ServerConfig -> ([LogItem] -> IO ()) -> TQueue BS.ByteString -> IO ()
+keepActiveMQConnected sc@ServerConfig{..} printLog var = do
+  res <- handle (\(e :: SomeException) -> do
+      printLog . pure . Error $ "Exception in AMQ-Thread: "<>show e
+      return $ Right ()
+    ) $ AMQ.try $ do -- catches all AMQ-Exception that we can handle. All others bubble up.
+        printLog . pure . Info $ "AMQ: connecting..."
+        withConnection myserviceActivemqHost myserviceActivemqPort [ OAuth myserviceActivemqUsername myserviceActivemqPassword
+                                                                   , OTmo (30*1000) {- 30 sec timeout -}
+                                                                   ]
+                                                                   [] $ \c -> do
+          let oconv = return
+          printLog . pure . Info $ "AMQ: connected"
+          withWriter c "Chaos-Logger for Kibana" "chaos.logs" [] [] oconv $ \writer -> do
+            printLog . pure . Info $ "AMQ: queue created"
+            let postfun = writeQ writer (Type (Application "json") []) []
+            void $ race
+              (forever $ atomically (readTQueue var) >>= postfun)
+              (threadDelay (600*1000*1000)) -- wait 10 Minutes
+          -- close writer
+        -- close connection
+  -- get outside of all try/handle/...-constructions befor recursing.
+  case res of
+    Left ex -> do
+      printLog . pure . Error $ "AMQ: "<>show ex
+      keepActiveMQConnected sc printLog var
+    Right _ -> keepActiveMQConnected sc printLog var
+ 
+ 
+-- Beispiel für eine Custom-Logging-Middleware.
+-- Hier werden z.B. alle 4xx-Status-Codes inkl. Payload ins stdout-Log geschrieben.
+-- Nützlich, wenn die Kollegen ihre Requests nicht ordentlich schreiben können und der Server das Format zurecht mit einem BadRequest ablehnt ;)
+loggingMiddleware :: IO Middleware
+loggingMiddleware = liftIO $ mkRequestLogger $ def { outputFormat = CustomOutputFormatWithDetails out }
+  where
+    out :: ZonedDate -> WAI.Request -> Status -> Maybe Integer -> NominalDiffTime -> [BS.ByteString] -> Builder -> LogStr
+    out _ r status _ _ payload _
+      | statusCode status < 300 = ""
+      | statusCode status > 399 && statusCode status < 500 = "Error code "<>toLogStr (statusCode status) <>" sent. Request-Payload was: "<> mconcat (toLogStr <$> payload) <> "\n"
+      | otherwise = toLogStr (show r) <> "\n"
+

Weitere Instanzen und Definitionen, die der Generator (noch) nicht macht

+

+ In der Myservice.Types werden ein paar hilfreiche Typen und Typinstanzen definiert. Im Folgenden geht es dabei um Dinge für: +

+ +
    + +
  • + Envy +
      + +
    • + Laden von $ENV_VAR in Datentypen +
    • + +
    • + Definitionen für Default-Settings +
    • + +
    + +
  • + +
  • + ServerConfig +
      + +
    • + Definition der Server-Konfiguration & Benennung der Environment-Variablen +
    • + +
    + +
  • + +
  • + ExtraTypes +
      + +
    • + ggf. Paketweite extra-Typen, die der Generator nicht macht, weil sie nicht aus der API kommen (z.B. cache) +
    • + +
    + +
  • + +
  • + Out/BSON-Instanzen +
      + +
    • + Der API-Generator generiert nur wenige Instanzen automatisch (z.B. Aeson), daher werden hier die fehlenden definiert. +
    • + +
    • + BSON: Kommunakation mit MongoDB +
    • + +
    • + Out: pretty-printing im Log +
    • + +
    + +
  • + +
+
{-# OPTIONS_GHC -Wno-orphans #-}
+{-# OPTIONS_GHC -Wno-name-shadowing #-}
+{-# LANGUAGE DeriveAnyClass        #-}
+{-# LANGUAGE DeriveFunctor         #-}
+{-# LANGUAGE DeriveGeneric         #-}
+{-# LANGUAGE DerivingVia           #-}
+{-# LANGUAGE DuplicateRecordFields #-}
+{-# LANGUAGE FlexibleContexts      #-}
+{-# LANGUAGE FlexibleInstances     #-}
+{-# LANGUAGE GADTs                 #-}
+{-# LANGUAGE LambdaCase            #-}
+{-# LANGUAGE MultiParamTypeClasses #-}
+{-# LANGUAGE OverloadedStrings     #-}
+{-# LANGUAGE RankNTypes            #-}
+{-# LANGUAGE RecordWildCards       #-}
+module MyService.Types where
+ 
+import           Data.Aeson                     (FromJSON, ToJSON)
+import           Data.Text
+import           Data.Time.Clock
+import           GHC.Generics
+import           System.Envy
+import           Text.PrettyPrint               (text)
+import           Text.PrettyPrint.GenericPretty
+ 
+-- Out hat hierfür keine Instanzen, daher kurz eine einfach Definition.
+instance Out Text where
+  doc = text . unpack
+  docPrec i a = text $ showsPrec i a ""
+ 
+instance Out UTCTime where
+  doc = text . show
+  docPrec i a = text $ showsPrec i a ""
+ 
+-- Der ServerConfig-Typ. Wird mit den defaults unten initialisiert, dann mit den Variablen aus der .env-Datei überschrieben und zum Schluss können Serveradmins diese via $MYSERVICE_FOO nochmal überschreiben.
+data ServerConfig = ServerConfig
+                  { myserviceHost              :: String -- ^ Environment: $MYSERVICE_HOST
+                  , myservicePort              :: Int    -- ^ Environment: $MYSERVICE_PORT
+                  , myserviceMaxTimeout        :: Int    -- ^ Environment: $MYSERVICE_MAX_TIMEOUT
+                  , myserviceInternalProxyUrl  :: String -- ^ Environment: $MYSERVICE_INTERNAL_PROXY_URL
+                  , myserviceInternalProxyPort :: Int    -- ^ Environment: $MYSERVICE_INTERNAL_PROXY_PORT
+                  , myserviceExternalProxyUrl  :: String -- ^ Environment: $MYSERVICE_EXTERNAL_PROXY_URL
+                  , myserviceExternalProxyPort :: Int    -- ^ Environment: $MYSERVICE_EXTERNAL_PROXY_PORT
+                  , myserviceActivemqHost      :: String -- ^ Environment: $MYSERVICE_ACTIVEMQ_HOST
+                  , myserviceActivemqPort      :: Int    -- ^ Environment: $MYSERVICE_ACTIVEMQ_PORT
+                  , myserviceActivemqUsername  :: String -- ^ Environment: $MYSERVICE_ACTIVEMQ_USERNAME
+                  , myserviceActivemqPassword  :: String -- ^ Environment: $MYSERVICE_ACTIVEMQ_PASSWORD
+                  , myserviceMongoUsername     :: String -- ^ Environment: $MYSERVICE_MONGO_USERNAME
+                  , myserviceMongoPassword     :: String -- ^ Environment: $MYSERVICE_MONGO_PASSWORD
+                  , myserviceDebug             :: Bool   -- ^ Environment: $MYSERVICE_DEBUG
+                  } deriving (Show, Eq, Generic)
+ 
+-- Default-Konfigurations-Instanz für diesen Service.
+instance DefConfig ServerConfig where
+  defConfig = ServerConfig "0.0.0.0" 8080 20
+                           ""
+                           ""
+                           ""
+                           0
+                           ""
+                           0
+                           ""
+                           0
+                           ""
+                           ""
+                           ""
+                           ""
+                           False
+ 
+-- Kann auch aus dem ENV gefüllt werden
+instance FromEnv ServerConfig
+-- Und hübsch ausgegeben werden.
+instance Out ServerConfig
+ 
+ 
+instance Out Response
+instance FromBSON Repsonse -- FromBSON-Instanz geht immer davon aus, dass alle keys da sind (ggf. mit null bei Nothing).

Was noch zu tun ist

+

+ Den Service implementieren. Einfach ein neues Modul aufmachen (z.B. MyService.Handler oder MyService.DieserEndpunktbereich/MyService.JenerEndpunktbereich) und dort die Funktion implementieren, die man in der Main.hs benutzt hat. In dem Handler habt ihr dann keinen Stress mehr mit validierung, networking, logging, etc. pp. weil alles in der Main abgehandelt wurde und ihr nur noch den “Happy-Case” implementieren müsst. Beispiel für unseren Handler oben: +

+
myApiEndpointV1Post :: MonadIO m => ServerConfig -> (ClientEnv,ClientEnv) -> TQueue BS.ByteString -> ([LogItem] -> IO ()) -> Request -> m Response
+myApiEndpointV1Post sc calls amqPost log req = do
+    liftIO . log $ [Info $ "recieved "<>pretty req]                                                                   -- input-logging
+    liftIO . atomically . writeTQueue . LBS.toStrict $ "{\"hey Kibana, i recieved:\"" <> A.encode (pretty req) <> "}" -- log in activeMQ/Kibana
+ 
+ 
+    --- .... gaaaanz viel komplizierter code um die Response zu erhalten ;)
+    let ret = Response 1337 Nothing -- dummy-response ;)
+    -- gegeben wir haben eine gültige mongodb-pipe;
+    -- mehr logik will ich in die Beispiele nicht packen.
+    -- Man kann die z.b. als weiteren Wert in einer TMVar (damit man sie ändern & updaten kann) an die Funktion übergeben.
+    liftIO . access pipe master "DatabaseName" $ do
+        ifM (auth (myServiceMongoUsername sc) (myServiceMongoPassword sc)) (return ()) (liftIO . printLog . pure . Error $ "MongoDB: Login failed.")
+        save "DatabaseCollection" ["_id" =: 1337, "entry" =: ret] -- selbe id wie oben ;)
+    return ret
+

+ Diese dummy-Antwort führt auf, wie gut man die ganzen Sachen mischen kann. +

+ +
    + +
  • + Logging in die Dateien/stdout nach config +
  • + +
  • + Logging von Statistiker in Kibana +
  • + +
  • + Speichern der Antwort in der MongoDB +
  • + +
  • + Generieren einer Serverantwort und ausliefern dieser über die Schnittstelle +
  • + +
+

Tipps & Tricks

Dateien, die statisch ausgeliefert werden sollen
+

+ Hierzu erstellt man ein Verzeichnis static/ (konvention; ist im generator so generiert, dass das ausgeliefert wird). Packt man hier z.b. eine index.html rein, erscheint die, wenn man den Service ansurft. +

+
Wie bekomme ich diese fancy Preview hin?
+

+ Der Editor, der ganz am Anfang zum Einsatz gekommen ist, braucht nur die api-doc.yml um diese Ansicht zu erzeugen. Daher empfielt sich hier ein angepasster Fork davon indem die Pfade in der index.html korrigiert sind. Am einfachsten (und von den meisten services so benutzt): In meiner Implementation liegt dann nach dem starten auf http://localhost:PORT/ui/ und kann direkt dort getestet werden. +

+
Wie sorge ich für bessere Warnungen, damit der Compiler meine Bugs fängt?
stack build --file-watch --ghc-options '-freverse-errors -W -Wall -Wcompat' --interleaved-output
+

+ Was tut das? +

+ +
    + +
  • + --file-watch: automatisches (minimales) kompilieren bei dateiänderungen +
  • + +
  • + --ghc-options +
      + +
    • + -freverse-errors: Fehlermeldungen in umgekehrter Reihenfolge (Erster Fehler ganz unten; wenig scrollen ) +
    • + +
    • + -W: Warnungen an +
    • + +
    • + -Wall: Alle sinnvollen Warnungen an (im gegensatz zu -Weverything, was WIRKLICH alles ist ) +
    • + +
    • + -Wcompat: Warnungen für Sachen, die in der nächsten Compilerversion kaputt brechen werden & vermieden werden sollten +
    • + +
    + +
  • + +
  • + --interleaved-output: stack-log direkt ausgeben & nicht in dateien schreiben und die dann am ende zusammen cat'en. +
  • + +
+ +

+ Um pro Datei Warnungen auszuschalten (z.B. weil man ganz sicher weiss, was man tut -.-): {-# OPTIONS_GHC -Wno-whatsoever #-} als Pragma in die Datei. +

+ +

+ Idealerweise sollte das Projekt keine Warnungen erzeugen. +

+

Deployment

+

+ Als Beispiel sei hier ein einfaches Docker-Build mit Jenkins-CI gezeigt, weil ich das aus Gründen rumliegen hatte. Kann man analog in fast alle anderen CI übrsetzen. +

+

Docker

+

+ Die angehängten Scripte gehen von einer Standard-Einrichtung aus (statische sachen in static, 2-3 händische Anpassungen auf das eigene Projekt nach auspacken). Nachher liegt dann auch unter static/version die gebaute Versionsnummer & kann abgerufen werden. In der Dockerfile.release und der Jenkinsfile müssen noch anpassungen gemacht werden. Konkret: +

+ +
    + +
  • + in der Dockerfile.release: alle <<<HIER>>>-Stellen sinnvoll befüllen +
  • + +
  • + in der Jenkinsfile die defs für “servicename” und “servicebinary” ausfüllen. Binary ist das, was bei stack exec aufgerufen wird; name ist der Image-Name für das docker-repository. +
  • + +
+

Jenkins

+

+ Änderungen die dann noch gemacht werden müssen: +

+ +
    + +
  • + git-repository url anpassen +
  • + +
  • + Environment-Vars anpasses ($BRANCH = test & live haben keine zusatzdinger im docker-image-repository; ansonsten hat das image $BRANCH im namen) +
  • + +
+ +

+ Wenn das durchgebaut ist, liegt im test/live-repository ein docker-image namens servicename:version. +

+

OMG! Ich muss meine API ändern. Was mache ich nun?

+
    + +
  • + api-doc.yml bearbeiten, wie gewünscht +
  • + +
  • + mittels generator die Api & submodule neu generieren +
  • + +
  • + ggf. custom Änderungen übernehmen (:Gitdiffsplit hilft) +
  • + +
  • + Alle Compilerfehler + Warnungen in der eigentlichen Applikation fixen +
  • + +
  • + If it comipilez, ship it! (Besser nicht ;) ) +
  • + +
+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Logik.html b/static_gen/Logik.html new file mode 100644 index 0000000..eb75d4f --- /dev/null +++ b/static_gen/Logik.html @@ -0,0 +1,1405 @@ + + + + + + + + Logik für Dummies – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Logik für Dummies + +

+
+ + +

+ Logik ist das ziehen von Schlüssen, die innerhalb der Logik widerspruchsfrei und kohärent sind. +

+

minimale Logik

+

+ Für eine minimale Logik braucht man folgende Annahmen: +

+ +

+ Im folgenden ist jedes Merkmal als Dreiklang definiert, bestehend aus einer Formaldefinition (F - WAS ist das), einer Einführung (I - WIE kann ich das “erzeugen”) und einer Elimination (E - WIE bekomme ich das wieder weg). +

+ +

+ Formal kurz: +

+ +
    + +
  • + prop ist eine Eigenschaft, die zu true oder false evaluieren kann. Wir berüchsichtigen nur ein weiteres schließen, wenn prop entweder wahr oder unevaluiert ist. +
  • + +
  • + A, B, C sind Aussagen +
  • + +
  • + \(\Gamma\) sind Aussagensammlungen (eine beliebige Anzahl an Aussagen in beliebiger Reihenfolge) +
  • + +
+ +

+ Alle weiteren Operationen werden eingeführt. +

+

Wahrheit T

+

+ Eine Wahrheit T, auf die jede Aussage die logisch ist reduzierbar sein muss: +

+ +

+ \(\frac{}{T prop} (T-F)\) +

+ +

+ “prop” ist einfach eine Aussage. +

+ +

+ \(\frac{}{T true} (T-I)\) +

+ +

+ Es gibt keine “ultimative” Wahrheit, aus der ich trivial “wahr” ableiten kann. Normalerweise bekannt als “Axiome”. Später einfach Grundannahmen. +

+ +

+ \(- (T-E)\) +

+ +

+ Es gibt keine Elimination. Etwas, was inherent Wahr ist, kann ich nicht im Nachhinein ändern (ohne zuvor einen Fehler gemacht zu haben). +

+

Verknüpfung \(\wedge\)

+

+ Eine Verknüpfung \(\wedge\), die zutrifft, wenn 2 Aussagen A, B wahr sind: +

+ +

+ \(\frac{A prop; B prop}{A \wedge B prop} (\wedge F)\) +

+ +

+ A & B sind Aussagen, Ergebnis ist eine Aussage über beides +

+ +

+ \(\frac{A true; B true}{A \wedge B true} (\wedge I)\) +

+ +

+ Wenn A wahr & B wahr, dann ist beides zusammen auch wahr. +

+ +

+ \(\frac{A \wedge B true}{A true} (\wedge E_1)\quad \frac{A \wedge B true}{B true} (\wedge E_2)\) +

+ +

+ Wenn A & B wahr sind, dann auch die Teile +

+

Implikation \(\supset\)

+

+ Eine Implikation (B ist in A enthalten): +

+ +

+ \(\frac{A prop; B prop}{A \supset B prop} (\supset F)\) +

+ +

+ A & B sind Aussagen, Ergebnis ist eine Aussage über beides +

+ +

+ \(\frac{A true \vdash B true}{A \supset B true} (\supset I)\) +

+ +

+ Wenn A B impliziert, dann ist A eine größere Aussage als B. +

+ +

+ \(\frac{A \supset B true; A true}{B true} (\supset E)\) +

+ +

+ Wenn A B umfasst und A wahr ist, dann muss B wahr sein. +

+

Entailment \(\vdash\)

+

+ Was soll nun dieser \(\vdash\)-Operator sein? Nun, dass ist “folgerbarkeit”. Folgende Bedingungen müssen erfüllt sein, damit das (für uns) sinnvoll ist: +

+ +
    + +
  • + \(A true \vdash A true\) (Reflexiv, Wenn A wahr ist, dann folgt daraus, dass A wahr ist!) +
  • + +
  • + \(\frac{\Gamma_1 \vdash A true; \Gamma_2, A true \vdash B true}{\Gamma_1, \Gamma_2 \vdash B true}\) (Transitiv, Wenn A unter Bedingung X wahr ist, und B unter Bedingung AY, dann ist B auch unter XY wahr. Wenn 1 + 1 = 2 und 3+2 = 5, dann auch 3 + (1+1) = 5) +
  • + +
+ +

+ und folgendes sollte erfüllt sein, außer wir bewegen uns auf ganz krudem Terrain: +

+ +
    + +
  • + \(\frac{\Gamma \vdash A true}{\Gamma, B true \vdash A true}\) (Weakening. Wenn A schon bewiesen ist, dann wird es nicht falsch durch hinzufügen einer wahren Vorraussetzung (die für den Beweis nicht nötig wäre)). +
  • + +
  • + \(\frac{\Gamma, A true, A true \vdash B true}{\Gamma, A true \vdash B true}\) (Contraction. Wenn ich A 2x verwende, dann kann ich es auch nur 1x oben drüber schreiben). +
  • + +
  • + \(\frac{\Gamma \vdash A true}{\Pi(\Gamma) A true}\) (Permutation. Egal in welcher Permutation \(\pi\) ich die Argumente aufführe, der Schluss ist gleich). +
  • + +
+

Unwahrheit \(\perp\)

+

+ Eine Aussage, die nie Eintreten darf. Wenn wird dieses Schlussfolgern können, dann haben wir einen Fehler +

+ +

+ \(\frac{}{\perp prop} (\perp F)\) +

+ +

+ bottom ist eine Aussage +

+ +

+ \(-(\perp I)\) +

+ +

+ bottom kann nicht Abgeleitet werden +

+ +

+ \(\frac{\perp true}{A true} (\perp E)\) +

+ +

+ Wenn wir bottom Ableiten können, gilt alles (1=0, Gott existiert und existiert nicht zugleich, …). +

+

Disjunktion \(\vee\)

+

+ \(\frac{A prop, B prop}{A \vee B prop} (\vee F)\) +

+ +

+ A & B sind Aussagen, A oder B ist auch eine Aussage +

+ +

+ \(\frac{A true}{A \vee B true} (\vee I_1)\quad \frac{B true}{A \vee B true} (\vee I_2)\) +

+ +

+ Wenn eins von beidem Wahr ist, dann ist A oder B wahr. Sprich, ich kann einfach irgendeine Aussage (egal ob wahr oder falsch) zu einer Aussage hinzufügen und die Disjunktion bleibt gleich. +

+ +

+ \(\frac{A \vee B true, A true \vdash C true, B true \vdash C true}{C true} (\vee E)\) +

+ +

+ Wenn C aus A folgt UND C aus B folgt UND entweder A oder B wahr sind, ist C wahr. OB jetzt entweder A oder B wahr sind interessiert für den Schluss nicht. Es reicht, dass Eines von beiden wahr ist. +

+

Folgerungen

+
    + +
  • + Eine Aussage A ist immer \(\perp \le A \le T\). Sie ist also wahr oder falsch (=trivial) oder je nach Bedingung anders. +
  • + +
  • + Es gibt eine “Mächtigkeitsreihenfolge” bei Aussagen. Die Aussagen, die mit den wenigsten Vorraussetzungen auskommen sind mächtiger und enthalten mehr Aussagen, als die speziellen. +
  • + +
  • + Zu einer Aussage A gibt es eine Gegenaussage \(\neg A := A \supset \perp\). Diese ist genau dann falsch, wenn A wahr ist. Formal: \(\frac{A \wedge C \le \perp }{C \le \neg A}\). Wenn A widerlegt werden kann, ist \(\neg A\) die mächtigste Widerlegung. +
  • + +
  • + Zu einer Aussage A gibt es ein Inverses \(\bar{A}\), sodass \(A \vee \bar{A} \simeq T\), also \(T \le A \vee \bar{A}\). \(\bar{A}\) ist somit die größte Aussage, die dazu führt, dass sie mit A ver-odert wahr wird. +
  • + +
  • + Bemerkenswert ist: Im Allgemeinen gilt nicht: \(\neg A = \bar{A}\). +
  • + +
+ +

+ Zu 5. noch eine Bemerkung: Dies ist trivial klar, wenn man sich bewusst macht, dass nicht jedes Problem gelöst ist. Dies sind Dinge, über die die Logik alleine keine Aussage treffen KANN. Allerdings müssen wir Berücksichtigen, dass es solche Annahmen GIBT. +

+ +

+ Ein Beispiel für eine Logik, die Annahme 5 macht: Bool’sche Algebra +

+ +

+ Ein Beispiel für eine Logik, die Annahme 5 nicht macht: Heyting Algebra, u.U. auch Lindenbaum Algebra (nicht geprüft) +

+ +

+ Damit ist letztere qua definitionem mächtiger als Erstgenannte, da diese in letztgenannter enthalten ist. +

+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Uni.html b/static_gen/Uni.html new file mode 100644 index 0000000..2d48322 --- /dev/null +++ b/static_gen/Uni.html @@ -0,0 +1,1178 @@ + + + + + + + + Uni – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Uni + +

+
+ +
+

+ Note: To override the auto-generated content here, create a file named one of: Uni.md, Uni.org +

+
+ +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Uni/Lernerfolg_an_der_Uni.html b/static_gen/Uni/Lernerfolg_an_der_Uni.html new file mode 100644 index 0000000..0542a90 --- /dev/null +++ b/static_gen/Uni/Lernerfolg_an_der_Uni.html @@ -0,0 +1,1335 @@ + + + + + + + + Wie lerne ich richtig an der Uni? – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Wie lerne ich richtig an der Uni? + +

+
+ + +

+ Dies ist eine gute Frage. Da ich im laufe der Zeit einige Antworten gesammelt habe, wollte ich diese mal hier niederschreiben. Vorweg eine Warnung: All das hier spiegelt nur meine persönlichen Erfahrungen aus Gesprächen wieder. Es kann sein, dass die z.B. für euren Fachbereich nicht gilt. Da wir das nun aus dem Weg haben, geht es auch gleich los. +

+

Uni ist nicht Schule

+

+ Einige mögen sagen: “duh!”, aber es ist erschreckend, wie viele Leute meinen, dass ihnen die Uni etwas schuldet oder das Dozenten und Tutoren dafür verantwortlich sind, dass man hier etwas lernt. Studium ist eine komplett freiwillige Veranstaltung. Man kann jederzeit sagen: “Passt mir nicht. Ich gehe.” An der Uni wird erwartet, dass man sich ggf. einarbeitet, wenn man etwas nicht weiss; dass man Sekundärliteratur fragt (z.B. in Mathe auch mal in Bücher schaut um eine andere Erklärung zu bekommen, als der Prof an die Tafel geklatscht hat). +

+

Etwas Lerntheorie

+

+ Es gibt einen sehr schönen Talk von Edwand Kmett in dem er über seine Erfahrungen berichtet. Kurzum: Man lernt durch stete Wiederholung. Und der beste Moment etwas zu wiederholen ist, kurz bevor man es vergisst. Das stimmt ziemlich genau mit meiner Erfahrung überein. +

+

Auswendig lernen

+

+ Grade die oben genannte Theorie steht beim Auswendiglernen im Vordergrund. Wenn man etwas langfristig auswendig lernen will (Fremdsprachen, etc.), dann gibt es hierzu Software, die herausfindet, wann es der beste Zeitpunkt ist, dich wieder abzufragen: Anki gibt es für jede Platform kostenlos (außer iPhone - hier 25$, weil Apple so viel Geld für das einstellen im AppStore haben will). Anki ist dazu gedacht, dass man zu jedem Thema einen Stapel hat (z.b. Klausurfragen, Sprachen, …) und jeden Tag lernt. Nach einiger Zeit wird die vorhersage der Lernzeit ziemlich genau. Anfangs beantwortet man noch viele Fragen täglich, aber je häufiger man die Antworten kennt, desto weiter hinten landen sie im Stapel. Schlussendlich kommt dieselbe Frage dann nur noch 1x/Monat oder noch seltener. +

+ +

+ Ich benutze dies insbesondere zum Auswendiglernen von Fakten, Formeln, Fachbegriffen etc. Bei Mathe bietet sich zum Beispiel an einen Stapel mit allen Definitionen zu haben; in der Biologie eine Liste der Schema und Kreisläufe etc. +

+ +

+ Man kann auch einen Hardcore-Lernmarathon machen. Meine letzten beiden Klausuren waren nur auf “bestehen” - also ohne Note. Ich habe mir eine alte Klausur organisiert (mehr genaues unten) und dann daraus Karten erstellt. Dies hat nur wenige Stunden gedauert (2-3 verteilt auf 2 Tage). Damit habe ich dann am Tag vor der Klausur 2x gelernt (1x nach dem Aufstehen, 1x vorm schlafengehen; jeweils nach 30 Minuten hatte ich alle Fragen min. 1x korrekt beantwortet). Am Morgen der Klausur hab ich die Fragen vor dem Aufstehen noch einmal durchgemacht (wieder 25-30 min), habe mir zur Klausur fertig gemacht und bin 30 Min vor der Klausur die Fragen nochmals durchgegangen (15-30 min), aber konnte sie mittlerweile alle auswendig. Insgesamt habe ich mit Anki so für die Klausur effektiv 2h gelernt (+2-3h für das erstellen der Karten), habe die Klausur geschrieben und mit einer 3.0 bestanden (also wäre 3.0 gewesen, wenn es nicht unbenotet gewesen wäre). Kommilitonen, die sich (nach eigener Aussage) 1-2 Wochen auf die Klausur vorbereitet haben und eine Note wollten, schnitten teilweise schlechter ab (viele aber auch viel besser). +

+

Methodik lernen

+

+ Im Gegensatz zum plumpen auswendig lernen gibt es dann auch Anforderungen, wo es darum geht Methoden und Anwendungen zu verstehen. Inbesondere ist dies in Vorbereitung auf z.B. mündliche Prüfungen der Fall. Hier steht eher die Theorie im Vordergrund. +

+ +

+ Um solche Konzepte zu verstehen braucht es leider Zeit. Hier hilft kein 48h-Lernmarathon um das “mal eben” auf die Kette zu kriegen. Am besten bereitet man sich das gesamte Semester über vor (haha! Als ob! :p). Das “Geheimnis” hier liegt in einer Kombination der Ansätze. Zum einen muss man natürlich verstehen, worum es geht. Hier hilft es Definitionen und Fachbegriffe z.B. mit Anki zu lernen. Allerdings muss man sich zusätzlich noch nach jeder(!) Vorlesung hinsetzen und versuchen den Inhalt zu verdauen. Dies können nur 10 Minuten sein oder auch 2h. Hier kommen dann Dinge zum Tragen, wie Sekundärliteratur, Wikipedia, Google, … Man muss die Zusammenhänge einmal verstehen - da kommt man nicht drumherum. ABER: Unser Gehirn arbeitet Assoziativ. Zusammenhänge sind meist logisch oder krass widersprüchlich. Hieraus kann man dann z.B. “Stichwortketten” bauen, von denen man nur das erste auswendig lernt und von da aus sich an den Rest “erinnert”. +

+ +

+ Kleines Beispiel aus der Welt der Mathematik: +

+
Vektorraum -> Ist zu einer Basis definiert -> Basis ist die größtmögliche Zahl lin. unabh. Vektoren. Lin. Hülle der Basis ist der VR -> Lin. Hülle ist jede Lin.-Komb. von Vektoren
+           -> Hat eine Vektoraddition und skalare Multiplikation
+           -> Wird über einem Körper aufgespannt -> Körper sind 2 abelsche Gruppen mit Distributivgesetz -> abelsche Gruppe ist Menge mit K.A.I.N. -> ....
+

+ So kann man sich über 5-6 Stichwörter fast am gesamten Stoff der Vorlesung entlanghangeln und merkt schnell, wo es hakt. Hier kann man dann nochmal gezielt nachhaken. Auch kann man bei so einer Struktur aus jedem “a -> b -> c” Anki-Karten machen mit “a” auf der Vorderseite, “b” auf der Rückseite bzw. “b” auf der Vorderseite und “c” auf der Rückseite und so gezielt diese “Ketten” trainieren. Grade in einer mündlichen Prüfung hangeln sich Prüfer ebenfalls an diesen Ketten entlang. +

+

Vorbereiten auf eine Klausur

+
    + +
  • + Herausfinden, um was für eine Art von Klausur es sich handelt +
      + +
    • + Ankreuzklausur? +
    • + +
    • + Auswendiglern-Klausur? +
    • + +
    • + Praktische Klausur (z.b. fast 1:1 Übungsaufgaben, feste Schema, ..)? +
    • + +
    • + Open-Book? +
    • + +
    • + Annotation von Grafiken? +
    • + +
    + +
  • + +
  • + Klausuren von der Fachschaft organisieren +
      + +
    • + Falls keine Vorhanden: Altfachschaftler fragen, wie die Klausur bei ihnen war +
    • + +
    • + Neue Klausur mit in die FS bringen, falls möglich (z.b. schreiend rausrennen und Klausur dabei mitnehmen, bevor man offiziell registriert wurde) +
    • + +
    + +
  • + +
+ +

+ Je nach Klausurtyp dann mit Anki stumpf Karten machen und auswendig lernen (z.b. Ankreuzklausur, Grafik-annotations-Klausur, ..) oder Übungsaufgaben/Altklausuren durchrechnen +

+

Vorbereiten auf eine mündliche Prüfung

+
    + +
  • + Protokolle aus der Fachschaft organisieren +
      + +
    • + Häufig gegen Pfand, dass man bei Abgabe eines Protokolls wieder bekommt +
    • + +
    • + Wenn keins vorhanden für die nachfolgede Generation eins ausfüllen +
    • + +
    + +
  • + +
+ +

+ Wenn ihr einen Reihe von Protokollen vorliegen habt, dann schreibt alle Fragen heraus und notiert, wie häufig diese Frage gestellt wurde. So findet ihr heraus, auf welche Punkte der Prüfer besonders Wert legt (z.B. häufig sein eigenes Forschungsfeld). Diese Fragen dann restlos klären und zu Anki-Karten verarbeiten. Das reicht meistens für ein Bestehen. Wenn ihr auf eine gute Note wert legt, dann solltet ihr auch noch die Vorlesung, wie im Bereich “Methodik lernen” erwähnt, nacharbeiten. Insbesondere helfen hier die Assoziationsketten weiter den Stoff auch in der Prüfung in der richtigen Reihenfolge abzurufen. Vielleicht erkennt ihr solche Ketten schon aus den Prüfungsprotokollen und könnt euch ausmalen, wie man z.b. von da aus auf andere Themen der Vorlesung kommt (die z.b. neu sind oder überarbeitet wurden). +

+

Unterschiede mündliche Bachelor/Master-Prüfungen

+

+ Einige Dozenten machen unterschiedliche Anforderungen, ob sie einen Bachelor oder einen Master-Studenten prüfen. Abgesehen von der anderen Prüfungszeit (15-30min bei bachelor, 25-45 bei Master) ist hier auch das Vorgehen anders. Bei einem Bachelor wird klassischerweise alles oberflächlich abgefragt und nur wenig in die Tiefe gegangen. Bei einem Master wir nur noch stichpunktartig gefragt, dafür aber bis ins Detail. +

+ +

+ Beispiel: Ich hatte eine mündliche Masterprüfung, bei der in der Vorlesung 7 verschiedene Themen behandelt wurden. In der Prüfung wurden dann nur die Themenübersicht abgefragt und bei 2 Themen komplett in die Tiefe gegangen - inkl. Formeln, Bedeutung, Übertragung auf in der Vorlesung nicht angesprochene Aspekte etc. Die anderen 5 Themen kamen nicht dran. Bei meinen Bachelorprüfungen war das eher umgekehrt: Hier wurde sich grob an der Vorlesung entlang gehangelt und zumindest alles einmal kurz angetestet, ob die zentralen Inhalte der Vorlesung verstanden wurden. +

+ +

+ Dies hat häufig auch damit zu tun, dass man im Bachelor eher Grundlagen hört und somit ein grobes Verständnis aller Dinge wichtig ist, während im Master auf die Aneignung von Tiefenwissen ankommt. +

+

Prüfungsangt

+

+ Zu guter Letzt noch ein paar Worte zum Thema Prüfungsangst. Es ist normal, dass man vor einer Prüfung angespannt ist. Es ist nicht normal, wenn die Anspannung so ausartet, dass man sich übergibt, Krämpfe bekommt oder ähnlich starke Symptome zeigt. Ich leide selbst an solchen Problemen und habe mich schon mehrfach vor Prüfungen übergeben. Eine klassische Konfrontationstherapie funktioniert aufgrund der Seltenheit der Prüfungen nicht oder nur sehr schwer. Ich habe mich an meinen Arzt gewendet und habe nun genau für solche Situationen ein Medikament. 1-2h vor einer Prüfung nehme ich das und komme in einen komischen Zustand. Ich merke zwar noch, dass ich Angespannt bin und eigentlich Angst hätte, aber es “stört” mich nicht wirklich. Es versetzt mich nicht in Panik oder sonstwas. Es schaltet mein Gehirn nicht aus oder hat andere negative Effekte. Natürlich geht das auch mit Nachteilen einher: ein paar Tage keinen Alkohol, kein Auto fahren, etc. - Aber meist ist das ja nur 2-3x/Semester der Fall. Wenn man nicht so stark betroffen ist, dann ist davon allerdings abzuraten. Das Medikament gleicht die Panik durch Gelassenheit aus - wenn man keine Panik hat, dann wird man hierdurch so “gelassen” dass man mehrere Stunden einschläft - was in einer Prüfung vielleicht nicht ganz so gut ist ;) +

+ +

+ Es gibt auch zahlreiche Regularien und Rechtsansprüche, die ihr bei sowas habt. Ihr habt zum Beispiel (sofern ein (Amts?-)Arzt eine Prüfungsangst bestätigt hat) Anspruch auf mehr Prüfungszeit, die Prüfung alleine abzulegen (z.b. bei einem Mitarbeiter, während andere im Hörsaal schreiben), eine mündliche durch eine schriftliche zu tauschen (oder umgekehrt), etc. Das kann man individuell mit dem Prüfer absprechen. Ich weiss nicht, wie das in anderen Fakultäten läuft - aber in der Technischen Fakultät hat fast jeder Prüfer dafür volles Verständnis (einige litten sogar früher selbst an sowas). +

+ +

+ Die kostenlose psychologische Beratung an der Uni (aka. “Das rote Sofa” im X) bietet hier auch Hilfestellung bei und vermittelt in schwereren Fällen auch gleich noch eine Therapie/Ärzte. Hier kann man z.b. Prüfungssimulationen abhalten oder sich Hilfe holen, wenn ein Dozent sich querstellt. Die Mitarbeiter begleiten einen z.B. auch zu einer Prüfung (nach Absprache mit dem Veranstalter), falls das hilft, etc. +

+ +

+ Es ist keine Schande so ein Problem zu haben und es gibt genug, die sich damit rumschlagen. Aber man ist hier an der Uni auch nicht alleine damit. Es gibt zahlreiche Hilfsangebote. +

+ +

+ Ein kleiner Hinweis hier noch auf das Prüfungsangst-Stipendium, dass einem eine Belohnung gibt, wenn man sich seinen Ängsten stellt und sie überwindet. :) +

+

Schlusswort

+

+ Viel Erfolg bei euren Prüfungen. Falls euch dieser Artikel geholfen hat oder ihr noch Anregungen/Verbessenguswünsche habt, schreibt mir einfach unter sdressel@techfak.uni-bi..., ich werde die dann einbauen. +

+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Unix.html b/static_gen/Unix.html new file mode 100644 index 0000000..88a0c07 --- /dev/null +++ b/static_gen/Unix.html @@ -0,0 +1,1178 @@ + + + + + + + + Unix – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Unix + +

+
+ +
+

+ Note: To override the auto-generated content here, create a file named one of: Unix.md, Unix.org +

+
+ +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/Unix/SSH-Filter.html b/static_gen/Unix/SSH-Filter.html new file mode 100644 index 0000000..0646851 --- /dev/null +++ b/static_gen/Unix/SSH-Filter.html @@ -0,0 +1,1227 @@ + + + + + + + + SSH-Filter – Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + SSH-Filter + +

+
+ + +

+ To filter incoming SSH-Connections by Country/Login do: +

+ +

+ Create a filter-binary (i.e. /usr/local/bin/sshfilter.sh) with contents like: +

+
#!/bin/bash
+
+# UPPERCASE space-separated country codes to ACCEPT
+ALLOW_COUNTRIES="DE NL"
+
+if [ $# -ne 2 ]; then
+  echo "Usage:  `basename $0` <ip> <user>" 1>&2
+  exit 0 # return true in case of config issue
+fi
+
+COUNTRY=`/usr/bin/geoiplookup $1 | awk -F ": " '{ print $2 }' | awk -F "," '{ print $1 }' | head -n 1`
+
+if [[ $COUNTRY == "IP Address not found" || $ALLOW_COUNTRIES =~ $COUNTRY ]]; then
+    RESPONSE="ALLOW"
+else
+    RESPONSE="DENY"
+fi
+
+#root-user is denied directly - no matter from where
+#can be used to also auto-ban ip in $1
+if [[ $2 == "root" ]]; then
+    RESPONSE="DENY"
+fi
+
+#allow few users from everywhere
+if [[ $2 == "juser" ]]; then
+    RESPONSE="ALLOW"
+fi
+
+if [[ $RESPONSE == "ALLOW" ]]; then
+  exit 0
+else
+  logger "$RESPONSE sshd connection for $2 from $1 ($COUNTRY)"
+  exit 1
+fi
+

+ Installation of geoiplookup from ubuntuwiki +

+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/_emanote-bin/compile-css b/static_gen/_emanote-bin/compile-css new file mode 100644 index 0000000..6b06b8c --- /dev/null +++ b/static_gen/_emanote-bin/compile-css @@ -0,0 +1,4 @@ +#!/usr/bin/env bash +set -xe + +echo "Deprecation Warning: this script should not be used anymore" diff --git a/static_gen/_emanote-static/emanote-logo.svg b/static_gen/_emanote-static/emanote-logo.svg new file mode 100644 index 0000000..e059d25 --- /dev/null +++ b/static_gen/_emanote-static/emanote-logo.svg @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/MavenPro-VariableFont_wght.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/MavenPro-VariableFont_wght.ttf new file mode 100644 index 0000000..05f8ecf Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/MavenPro-VariableFont_wght.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Black.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Black.ttf new file mode 100644 index 0000000..0a5eb4a Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Black.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Bold.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Bold.ttf new file mode 100644 index 0000000..77cf375 Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Bold.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-ExtraBold.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-ExtraBold.ttf new file mode 100644 index 0000000..dbf7528 Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-ExtraBold.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Medium.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Medium.ttf new file mode 100644 index 0000000..942d984 Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Medium.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Regular.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Regular.ttf new file mode 100644 index 0000000..1308467 Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-Regular.ttf differ diff --git a/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-SemiBold.ttf b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-SemiBold.ttf new file mode 100644 index 0000000..e86807c Binary files /dev/null and b/static_gen/_emanote-static/fonts/Maven_Pro/static/MavenPro-SemiBold.ttf differ diff --git a/static_gen/_emanote-static/inverted-tree.css b/static_gen/_emanote-static/inverted-tree.css new file mode 100644 index 0000000..56eb702 --- /dev/null +++ b/static_gen/_emanote-static/inverted-tree.css @@ -0,0 +1,118 @@ +/* Adapted from https://neuron.zettel.page/uplink-tree + Originally from https://codepen.io/philippkuehn/pen/QbrOaN +*/ + +body .tree.flipped { + -webkit-transform: rotate(180deg); + -moz-transform: rotate(180deg); + -ms-transform: rotate(180deg); + -o-transform: rotate(180deg); + transform: rotate(180deg); +} +body .tree { + overflow: auto; + /* See more-head.tpl */ + font-family: 'MavenPro', sans-serif; + font-variation-settings: 'wght' 475; + + font-size: 0.8em; +} +body .tree ul.root { + padding-top: 0px; + margin-top: 0px; +} +body .tree ul { + position: relative; + padding: 1em 0px 0px 0px; + white-space: nowrap; + margin: 0px auto 0px auto; + text-align: center; +} +body .tree ul::after { + content: ""; + display: table; + clear: both; +} +body .tree ul:last-child { + padding-bottom: 0.1em; +} +body .tree li { + display: inline-block; + vertical-align: top; + text-align: center; + list-style-type: none; + position: relative; + padding: 1em 0.5em 0em 0.5em; +} +body .tree li::before { + content: ""; + position: absolute; + top: 0px; + right: 50%; + border-top: solid 2px #cccccc; + width: 60%; + height: 1.19999em; +} +body .tree li::after { + content: ""; + position: absolute; + top: 0px; + right: 50%; + border-top: solid 2px #cccccc; + width: 50%; + height: 1.19999em; +} +body .tree li::after { + right: auto; + left: 50%; + border-left: solid 2px #cccccc; +} +body .tree li:only-child { + padding-top: 0em; +} +body .tree li:only-child::after { + display: none; +} +body .tree li:only-child::before { + display: none; +} +body .tree li:first-child::before { + border-style: none; + border-width: 0px; +} +body .tree li:first-child::after { + border-radius: 5px 0px 0px 0px; +} +body .tree li:last-child::after { + border-style: none; + border-width: 0px; +} +body .tree li:last-child::before { + border-right: solid 2px #cccccc; + border-radius: 0px 5px 0px 0px; +} +body .tree ul ul::before { + content: ""; + position: absolute; + top: 0px; + left: 50%; + border-left: solid 2px #cccccc; + width: 0px; + height: 1.19999em; +} +body .tree li div.forest-link { + border: solid 2px #cccccc; + padding: 0.2em 0.29999em 0.2em 0.29999em; + text-decoration: none; + display: inline-block; + border-radius: 5px 5px 5px 5px; + position: relative; + top: 2px; +} +body .tree.flipped li div.forest-link { + -webkit-transform: rotate(180deg); + -moz-transform: rotate(180deg); + -ms-transform: rotate(180deg); + -o-transform: rotate(180deg); + transform: rotate(180deg); +} diff --git a/static_gen/favicon.svg b/static_gen/favicon.svg new file mode 100644 index 0000000..e059d25 --- /dev/null +++ b/static_gen/favicon.svg @@ -0,0 +1,92 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/static_gen/index.html b/static_gen/index.html new file mode 100644 index 0000000..9fbaf94 --- /dev/null +++ b/static_gen/index.html @@ -0,0 +1,1143 @@ + + + + + + + + Home + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + +
+ + + + +
+
+ + + + +

+ + Home + +

+
+ + +

+ Unsortierte Einsichten und Erfahrungen. Archiviert zum verlinken, späteren Überdenken oder Diskutieren. +

+ +

+ Keine Garantie auf Richtigkeit oder Trollfreiheit 😁 +

+ + +
+
+ + +
+ +
+ +
+ + +
+
+
+ +
+ + + + + diff --git a/static_gen/tailwind.css b/static_gen/tailwind.css new file mode 100644 index 0000000..f35742e --- /dev/null +++ b/static_gen/tailwind.css @@ -0,0 +1 @@ +/*! tailwindcss v3.1.3 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:initial}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;font-weight:inherit;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:initial}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input:-ms-input-placeholder,textarea:-ms-input-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[multiple],[type=date],[type=datetime-local],[type=email],[type=month],[type=number],[type=password],[type=search],[type=tel],[type=text],[type=time],[type=url],[type=week],select,textarea{-webkit-appearance:none;-moz-appearance:none;appearance:none;background-color:#fff;border-color:#6b7280;border-width:1px;border-radius:0;padding:.5rem .75rem;font-size:1rem;line-height:1.5rem;--tw-shadow:0 0 #0000}[multiple]:focus,[type=date]:focus,[type=datetime-local]:focus,[type=email]:focus,[type=month]:focus,[type=number]:focus,[type=password]:focus,[type=search]:focus,[type=tel]:focus,[type=text]:focus,[type=time]:focus,[type=url]:focus,[type=week]:focus,select:focus,textarea:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow);border-color:#2563eb}input::-moz-placeholder,textarea::-moz-placeholder{color:#6b7280;opacity:1}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:#6b7280;opacity:1}input::placeholder,textarea::placeholder{color:#6b7280;opacity:1}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-date-and-time-value{min-height:1.5em}::-webkit-datetime-edit,::-webkit-datetime-edit-day-field,::-webkit-datetime-edit-hour-field,::-webkit-datetime-edit-meridiem-field,::-webkit-datetime-edit-millisecond-field,::-webkit-datetime-edit-minute-field,::-webkit-datetime-edit-month-field,::-webkit-datetime-edit-second-field,::-webkit-datetime-edit-year-field{padding-top:0;padding-bottom:0}select{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 20 20'%3E%3Cpath stroke='%236b7280' stroke-linecap='round' stroke-linejoin='round' stroke-width='1.5' d='m6 8 4 4 4-4'/%3E%3C/svg%3E");background-position:right .5rem center;background-repeat:no-repeat;background-size:1.5em 1.5em;padding-right:2.5rem;-webkit-print-color-adjust:exact;color-adjust:exact;print-color-adjust:exact}[multiple]{background-image:none;background-position:0 0;background-repeat:unset;background-size:initial;padding-right:.75rem;-webkit-print-color-adjust:unset;color-adjust:unset;print-color-adjust:unset}[type=checkbox],[type=radio]{-webkit-appearance:none;-moz-appearance:none;appearance:none;padding:0;-webkit-print-color-adjust:exact;color-adjust:exact;print-color-adjust:exact;display:inline-block;vertical-align:middle;background-origin:border-box;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;flex-shrink:0;height:1rem;width:1rem;color:#2563eb;background-color:#fff;border-color:#6b7280;border-width:1px;--tw-shadow:0 0 #0000}[type=checkbox]{border-radius:0}[type=radio]{border-radius:100%}[type=checkbox]:focus,[type=radio]:focus{outline:2px solid #0000;outline-offset:2px;--tw-ring-inset:var(--tw-empty,/*!*/ /*!*/);--tw-ring-offset-width:2px;--tw-ring-offset-color:#fff;--tw-ring-color:#2563eb;--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}[type=checkbox]:checked,[type=radio]:checked{border-color:#0000;background-color:currentColor;background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Cpath d='M12.207 4.793a1 1 0 0 1 0 1.414l-5 5a1 1 0 0 1-1.414 0l-2-2a1 1 0 0 1 1.414-1.414L6.5 9.086l4.293-4.293a1 1 0 0 1 1.414 0z'/%3E%3C/svg%3E")}[type=radio]:checked{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg viewBox='0 0 16 16' fill='%23fff' xmlns='http://www.w3.org/2000/svg'%3E%3Ccircle cx='8' cy='8' r='3'/%3E%3C/svg%3E")}[type=checkbox]:checked:focus,[type=checkbox]:checked:hover,[type=checkbox]:indeterminate,[type=radio]:checked:focus,[type=radio]:checked:hover{border-color:#0000;background-color:currentColor}[type=checkbox]:indeterminate{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 16 16'%3E%3Cpath stroke='%23fff' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M4 8h8'/%3E%3C/svg%3E");background-size:100% 100%;background-position:50%;background-repeat:no-repeat}[type=checkbox]:indeterminate:focus,[type=checkbox]:indeterminate:hover{border-color:#0000;background-color:currentColor}[type=file]{background:unset;border-color:inherit;border-width:0;border-radius:0;padding:0;font-size:unset;line-height:inherit}[type=file]:focus{outline:1px solid ButtonText;outline:1px auto -webkit-focus-ring-color}*,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }::-webkit-backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.visible{visibility:visible}.static{position:static}.fixed{position:fixed}.inset-0{top:0;right:0;bottom:0;left:0}.z-40{z-index:40}.float-right{float:right}.mx-auto{margin-left:auto;margin-right:auto}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.mx-2{margin-left:.5rem;margin-right:.5rem}.mb-4{margin-bottom:1rem}.mb-8{margin-bottom:2rem}.mb-2{margin-bottom:.5rem}.mr-2{margin-right:.5rem}.mb-3{margin-bottom:.75rem}.mt-2{margin-top:.5rem}.mt-10{margin-top:2.5rem}.ml-6{margin-left:1.5rem}.mt-6{margin-top:1.5rem}.mt-8{margin-top:2rem}.ml-2{margin-left:.5rem}.inline-block{display:inline-block}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.contents{display:contents}.hidden{display:none}.h-5{height:1.25rem}.h-4{height:1rem}.h-6{height:1.5rem}.h-screen{height:100vh}.w-full{width:100%}.w-auto{width:auto}.w-4{width:1rem}.w-6{width:1.5rem}.w-screen{width:100vw}.flex-1{flex:1 1 0%}.flex-shrink{flex-shrink:1}.flex-shrink-0{flex-shrink:0}.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-pointer{cursor:pointer}.list-inside{list-style-position:inside}.list-disc{list-style-type:disc}.list-decimal{list-style-type:decimal}.flex-row{flex-direction:row}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.flex-nowrap{flex-wrap:nowrap}.items-end{align-items:flex-end}.items-center{align-items:center}.justify-center{justify-content:center}.space-x-2>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-right:calc(.5rem*var(--tw-space-x-reverse));margin-left:calc(.5rem*(1 - var(--tw-space-x-reverse)))}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(.5rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.5rem*var(--tw-space-y-reverse))}.space-x-4>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-right:calc(1rem*var(--tw-space-x-reverse));margin-left:calc(1rem*(1 - var(--tw-space-x-reverse)))}.space-y-1>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-top:calc(.25rem*(1 - var(--tw-space-y-reverse)));margin-bottom:calc(.25rem*var(--tw-space-y-reverse))}.overflow-auto{overflow:auto}.overflow-x-auto{overflow-x:auto}.overflow-y-scroll{overflow-y:scroll}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.rounded{border-radius:.25rem}.border-l-2{border-left-width:2px}.border-t-2{border-top-width:2px}.border-b-2{border-bottom-width:2px}.border-l-4{border-left-width:4px}.border-red-200{--tw-border-opacity:1;border-color:rgb(254 202 202/var(--tw-border-opacity))}.border-gray-400{--tw-border-opacity:1;border-color:rgb(156 163 175/var(--tw-border-opacity))}.bg-gray-400{--tw-bg-opacity:1;background-color:rgb(156 163 175/var(--tw-bg-opacity))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity))}.bg-red-600{--tw-bg-opacity:1;background-color:rgb(220 38 38/var(--tw-bg-opacity))}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity))}.bg-red-100{--tw-bg-opacity:1;background-color:rgb(254 226 226/var(--tw-bg-opacity))}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235/var(--tw-bg-opacity))}.bg-gray-300{--tw-bg-opacity:1;background-color:rgb(209 213 219/var(--tw-bg-opacity))}.p-2{padding:.5rem}.p-3{padding:.75rem}.p-10{padding:2.5rem}.p-4{padding:1rem}.px-2{padding-left:.5rem;padding-right:.5rem}.py-2{padding-top:.5rem;padding-bottom:.5rem}.px-1{padding-left:.25rem;padding-right:.25rem}.py-1{padding-top:.25rem;padding-bottom:.25rem}.px-4{padding-left:1rem;padding-right:1rem}.py-4{padding-top:1rem;padding-bottom:1rem}.py-0\.5{padding-top:.125rem;padding-bottom:.125rem}.px-0\.5{padding-left:.125rem;padding-right:.125rem}.py-0{padding-top:0;padding-bottom:0}.px-0{padding-left:0;padding-right:0}.px-3{padding-left:.75rem;padding-right:.75rem}.pl-2{padding-left:.5rem}.pb-2{padding-bottom:.5rem}.pt-0\.5{padding-top:.125rem}.pt-0{padding-top:0}.pt-1{padding-top:.25rem}.pl-4{padding-left:1rem}.text-center{text-align:center}.text-right{text-align:right}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-5xl{font-size:3rem;line-height:1}.text-sm{font-size:.875rem;line-height:1.25rem}.text-4xl{font-size:2.25rem;line-height:2.5rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.text-2xl{font-size:1.5rem;line-height:2rem}.text-6xl{font-size:3.75rem;line-height:1}.font-bold{font-weight:700}.font-extrabold{font-weight:800}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.italic{font-style:italic}.leading-relaxed{line-height:1.625}.tracking-tighter{letter-spacing:-.05em}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity))}.text-gray-400{--tw-text-opacity:1;color:rgb(156 163 175/var(--tw-text-opacity))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity))}.text-gray-800{--tw-text-opacity:1;color:rgb(31 41 55/var(--tw-text-opacity))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity))}.text-red-600{--tw-text-opacity:1;color:rgb(220 38 38/var(--tw-text-opacity))}.text-gray-900{--tw-text-opacity:1;color:rgb(17 24 39/var(--tw-text-opacity))}.text-black{--tw-text-opacity:1;color:rgb(0 0 0/var(--tw-text-opacity))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99/var(--tw-text-opacity))}.text-gray-300{--tw-text-opacity:1;color:rgb(209 213 219/var(--tw-text-opacity))}.underline{-webkit-text-decoration-line:underline;text-decoration-line:underline}.outline-none{outline:2px solid #0000;outline-offset:2px}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.backdrop-blur-sm{--tw-backdrop-blur:blur(4px)}.backdrop-blur-sm,.backdrop-filter{-webkit-backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia);backdrop-filter:var(--tw-backdrop-blur) var(--tw-backdrop-brightness) var(--tw-backdrop-contrast) var(--tw-backdrop-grayscale) var(--tw-backdrop-hue-rotate) var(--tw-backdrop-invert) var(--tw-backdrop-opacity) var(--tw-backdrop-saturate) var(--tw-backdrop-sepia)}.transition{transition-property:color,background-color,border-color,fill,stroke,opacity,box-shadow,transform,filter,-webkit-text-decoration-color,-webkit-backdrop-filter;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,backdrop-filter;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke,opacity,box-shadow,transform,filter,backdrop-filter,-webkit-text-decoration-color,-webkit-backdrop-filter;transition-timing-function:cubic-bezier(.4,0,.2,1);transition-duration:.15s}.hover\:scale-110:hover{--tw-scale-x:1.1;--tw-scale-y:1.1;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.hover\:border-red-500:hover{--tw-border-opacity:1;border-color:rgb(239 68 68/var(--tw-border-opacity))}.hover\:bg-red-50:hover{--tw-bg-opacity:1;background-color:rgb(254 242 242/var(--tw-bg-opacity))}.hover\:bg-gray-50:hover{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity))}.hover\:text-red-700:hover{--tw-text-opacity:1;color:rgb(185 28 28/var(--tw-text-opacity))}.hover\:underline:hover{-webkit-text-decoration-line:underline;text-decoration-line:underline}.hover\:opacity-80:hover{opacity:.8}.focus\:outline-none:focus{outline:2px solid #0000;outline-offset:2px}@media (min-width:768px){.md\:sticky{position:-webkit-sticky;position:sticky}.md\:top-0{top:0}.md\:mt-8{margin-top:2rem}.md\:mb-8{margin-bottom:2rem}.md\:block{display:block}.md\:hidden{display:none}.md\:h-full{height:100%}.md\:w-48{width:12rem}.md\:flex-row{flex-direction:row}.md\:shadow-2xl{--tw-shadow:0 25px 50px -12px #00000040;--tw-shadow-colored:0 25px 50px -12px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}}@media (min-width:1024px){.lg\:max-w-screen-md{max-width:768px}.lg\:flex-row{flex-direction:row}.lg\:space-x-2>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-right:calc(.5rem*var(--tw-space-x-reverse));margin-left:calc(.5rem*(1 - var(--tw-space-x-reverse)))}}@media (min-width:1280px){.xl\:w-64{width:16rem}} \ No newline at end of file