Felix Riesterer: attraktivere Beispiele im WIki

Beitrag lesen

Liebe Mitlesende,

ich möchte eine Diskussion wiederbeleben, die inzwischen längst im Archiv gelandet ist. Es geht darum, Beispiele im Wiki als "fiddle" (lies: Ausprobierbeispiel auf SELFHTML, lies nicht: fsFiddle-Link) anzubieten.

Alte Diskussion

Der Gedanke ist ebensowenig neu wie ursprünglich von mir. Ein Artikel im hiesigen Blog belegt das. Wenngleich die Idee fremde Dienste für die Doku in Anspruch zu nehmen auf gewisse Bedenken stieß (u.a. auch bei mir), so war in der Forumsdiskussion zweifelsfrei eine Begeisterung für die Art der Präsentation an sich deutlich spürbar. Anstatt nun aber eine Lösung zu finden, um die Begeisterung für diese Art der Beispielführung für die SELFHTML-Doku (im Wiki) zu ermöglichen, ist diese Diskussion recht bald eingeschlafen und im Forumsarchiv gelandet.

Mir ist der Gedanke zu wertvoll, um es dabei zu belassen. Wenigstens einen Versuch möchte ich vorher noch starten. Daher habe ich mir ein paar Gedanken gemacht, wie man die Vorteile eines fiddles doch nutzen könnte.

Individuelle JavaScript-AddOns

Man kann selbstverständlich zu jeder Beispielseite ein neugeschnitztes JavaScript anflanschen, das ein Herumspielen mit diversen Parametern ermöglicht, sodass in gewisser Weise die Veranschaulichung plastischer wird. Das bedeutet aber einen immens hohen Entwicklungsaufwand für jedes einzelne Beispiel! Ob das der Sache immer gerecht wird, und ob die Pflege solcher Beispiele dadurch nicht unnötig verkompliziert würde, sind berechtigte Bedenken, die von einem solches Vorgehen abraten. An eine eher universelle Lösung á la jsFiddle oder dabblet käme sie ohnehin nie heran. Daher ist es meiner Meinung nach lohnender, sich darüber Gedanken zu machen, ob man für SELFHTML (insbesondere die Doku-Beispiele) nicht eine Plattform baut, die solcherlei fiddles anbieten kann.

fiddle.selfhtml.org?

Wenn SELFHTML eine selbstgestrickte Lösung hosten könnte, wäre das sicherlich sinnvoller, als auf externe Dienste (und die möglicherweise entstehenden rechtlichen Belange wie Urheberrecht/Benutertracking/etc. oder auch Verfügbarkeit) zu setzen. Desweiteren scheint es meiner Recherche nach so, dass man nicht einfach eine "fertige Lösung" bei den Anbietern solcher Dienste herunterladen und auf dem eigenen Webspace hosten könnte. Das hat auch seinen guten Grund.

Selbermachen wäre also angesagt. In der oben verlinkten Diskussion hatte ich seinerzeit eine Eigenbeteiligung an einer selbstgestrickten Lösung abgelehnt. Ob ich überhaupt über genügend Wissen und Können verfüge, eine solche Plattform (mit) zu entwickeln, weiß ich nicht. Zumindest aber konzeptionell möchte ich dazu beitragen, dass sich vielleicht in naher Zukunft doch etwas auf die Beine stellen lässt, das die Beispiele im Wiki auf Dauer attraktiver macht. Daher nun einige Überlegungen von mir, zu denen ich gerne auch die Meinung der hier Mitlesenden lesen möchte.

Ideen für ein eigenes Konzept

Da die Wiki-Beispiele ausschließlich zur Veranschaulichung von clientseitiger Technik gedacht sind, könnte ich mir vorstellen, dass man anders als z.B. bei jsFiddle auf die dort üblichen Speichermöglichkeiten (und Forks) gänzlich verzichtet und nur ein "Frontend" entwickelt. Dieses soll ein bereits existierendes Beispiel anzeigen - sonst nichts. Keinesfalls sollen Benutzereingaben in irgendeiner Weise serverseitig verarbeitet werden (außer dem Request-URI). Damit fiele eine Menge an Sicherheitsproblematiken von vornherein vom Tisch, da eine solche selbstgestrickte fiddle-Plattform keinerlei Schreibzugriffe auf den SELFHTML-Server bräuchte.

Die Basis der Beispiele holt sich ein "irgendwie intelligenter Holmechanismus" entweder aus einem hochgeladenen HTML-Dokument im Wiki, oder aus einem passend verlinkten <sourcecode>-Block einer Wiki-Seite. Ob dieser Mechanismus das ausschließlich anhand eines Query-Strings tut (der zwingend von Quellen auf wiki.selfhtml.org ausgeht), oder ob es eine tiefere Verquickung mit der Mediawiki-Software (Plugin?) braucht, wäre genauer zu überlegen.

Was meint ihr dazu?

Liebe Grüße,

Felix Riesterer.

--
"Wäre die EU ein Staat, der die Aufnahme in die EU beantragen würde, müsste der Antrag zurückgewiesen werden - aus Mangel an demokratischer Substanz." (Martin Schulz, Präsident des EU-Parlamentes)
0 114

attraktivere Beispiele im WIki

Felix Riesterer
  • selfhtml-wiki
  1. 0
    Matthias Scharwies
  2. 0

    hab da mal was gebastelt... bitte ausprobieren!

    Felix Riesterer
    1. 0
      Auge
      1. 0
        Felix Riesterer
        1. 0
          Auge
          1. 0
            Felix Riesterer
      2. 0

        speichern-Button implementiert

        Felix Riesterer
    2. 0
      tami
      1. 0
        Felix Riesterer
    3. 0
      Christian Kruse
      1. 0
        Felix Riesterer
        1. 0
          Christian Kruse
          1. 0
            Felix Riesterer
            1. 0
              Christian Kruse
    4. 0
      Christian Kruse
      1. 0
        Felix Riesterer
        1. 0
          Christian Kruse
          1. 0
            Felix Riesterer
    5. 0
      1UnitedPower
      1. 0
        Felix Riesterer
        1. 0
          1UnitedPower
          1. 0
            Matthias Apsel
            1. 0
              1UnitedPower
              1. 0
                Matthias Apsel
                1. 1
                  Christian Kruse
                  1. 0
                    Felix Riesterer
                    1. 0
                      Christian Kruse
                      1. 1
                        Felix Riesterer
                  2. 0
                    1UnitedPower
                    1. 0
                      Christian Kruse
              2. 0
                Christian Kruse
                1. 0
                  1UnitedPower
                  1. 0
                    Matthias Apsel
          2. 0
            Felix Riesterer
            1. 0
              Matthias Apsel
            2. 0
              1UnitedPower
    6. 0
      Der-Dennis
      1. 0
        Felix Riesterer
    7. 0

      Work in progress...

      Felix Riesterer
      1. 0
        Matthias Apsel
        1. 0
          Matthias Apsel
        2. 0
          Matthias Apsel
        3. 0
          Felix Riesterer
          1. 0
            Felix Riesterer
            1. 0
              Matthias Apsel
              1. 0
                Felix Riesterer
                1. 0
                  Matthias Apsel
                2. 0
                  Matthias Apsel
                  1. 0
                    Felix Riesterer
          2. 0
            Matthias Apsel
            1. 0
              Felix Riesterer
            2. 0

              hover umgesetzt

              Felix Riesterer
    8. 0
      Felix Riesterer
      1. 0
        Matthias Apsel
        1. 0
          Felix Riesterer
          1. 0
            Matthias Apsel
          2. 0
            Tabellenkalk
            1. 0
              Felix Riesterer
              1. 0
                Matthias Apsel
                1. 0
                  Felix Riesterer
                  1. 1
                    Auge
                    1. 0
                      Felix Riesterer
                      1. 0
                        Matthias Apsel
                        1. 0
                          Felix Riesterer
                          1. 0
                            Christian Kruse
                            1. 0
                              Felix Riesterer
                          2. 0
                            Auge
                          3. 0
                            Matthias Apsel
        2. 0
          Felix Riesterer
          1. 0
            Matthias Apsel
            1. 0
              Felix Riesterer
            2. 0
              Felix Riesterer
              1. 0
                Matthias Apsel
                1. 0
                  dedlfix
                  1. 0
                    Felix Riesterer
                2. 0
                  Tabellenkalk
                  1. 0
                    Auge
  3. 0

    Liste aller Beispiele zum live testen

    Felix Riesterer
    1. 0
      Matthias Apsel
      1. 0
        Felix Riesterer
    2. 0
      Felix Riesterer
  4. 0
    Matthias Apsel
    1. 0
      Felix Riesterer
      1. 0
        Matthias Scharwies
    2. 0
      Auge
      1. 0
        Felix Riesterer
  5. 0

    UI vorläufig gertig - Kritik?

    Felix Riesterer
    1. 0
      Der-Dennis
      1. 0
        Felix Riesterer
        1. 0
          Matthias Apsel
          1. 0
            Felix Riesterer
            1. 1
              Camping_RIDER
              1. 1
                Felix Riesterer
    2. 0

      Editorfenster: dynamische Breite vs. Vollbild-Modus

      Camping_RIDER
  6. 0

    Im Test-Wiki schon implementiert!

    Felix Riesterer
    1. 0
      Camping_RIDER
    2. 3

      Jetzt auch im offiziellen Wiki implementiert!

      Felix Riesterer
      1. 0
        Auge
        1. 0
          Matthias Apsel
          1. 0
            Auge
            1. 0
              Christian Kruse
              1. 0
                Auge
                1. 0
                  Felix Riesterer
                  1. 0
                    Auge
                    1. 0
                      Felix Riesterer
                      1. 0
                        Auge
                  2. 0
                    Auge
      2. 0

        externe CSS-Dateien werden berücksichtigt

        Felix Riesterer
        1. 0
          Matthias Apsel
          1. 0
            Felix Riesterer
            1. 0
              Matthias Apsel
              1. 0
                Felix Riesterer
                1. 1
                  dedlfix