Den eigenen Code lesbar im Forum präsentieren

  • Hallo liebe Forenmitglieder,


    aus aktuellem Anlass klären wir in diesem Beitrag einmal wie man seinen eigenen Code hier im Forum so präsentieren kann, dass andere Mitglieder ihn leicht lesen können. Gehäuft konnte man beobachten, dass keine Codeblöcke (gleich mehr) genutzt wurden und der Quelltext vor lauter Leerzeilen überquoll, dies wollen wir möglichst verhindern da es unsere Arbeit deutlich erschwert.


    Sollte dir etwas einfallen, was man diesem Beitrag noch hinzufügen könnte, bitte schreibe eine Private Nachricht an mich oder lauras.


    Zusammenfassung

    • Bitte die BB-Codes zum hervorheben von Quelltext nutzen, wie das funktioniert wird weiter unten erklärt
    • Bitte unnötige Leerzeilen entfernen, zwischen 2 Codezeilen sollte maximal eine leere Zeile stehen
    • Bitte nicht den Quellcode eigenständig mit Farben versehen, das machen die Codeblöcke automatisch
    • Bitte ordentliche Tabgrößen nutzen, Einrückung ist gut, Einrückung mit 8 Leerzeichen pro Zeile ist schlecht (siehe unteres Ende des Beitrags)
    • Bitte möglichst vollständigen Code posten, mit kleinen Ausschnitten ist helfen meist schwer, oft muss zuerst nach mehr Code gefragt werden und das kostet Zeit
    • Fehlermeldungen angeben: Wir haben einen Beitrag dazu geschrieben wie ihr Fehlermeldungen entdecken könnt, dieser findet sich hier
    • Bitte nach Möglichkeit den Code irgendwo hochladen, am Besten bei einem gratis Hoster, oder kleinere Codes bei zum Beispiel JSFIDDLE, CodePen oder für z.B. PHP codepad oder 3v4l oder Ideone


    Für PHP-Quelltext ist hier ein Beitrag zu finden wo diskutiert wird wie man sauberen Code schreibt.


    Codeblöcke (Siehe auch: Forum - Hilfe - 4.3.16. Code)
    Zuerst klären wir ab worum es sich bei den Codeblöcken handelt. Das Forum bietet beim Verfassen von Beiträgen die Möglichkeit Quelltext in einem abgetrennten Bereich anzuzeigen, dieser wird zusätzlich am linken Rand automatisch nummeriert:


    HTML
    1. Mein Code
    2. Zeile 3 aus meinem Code


    Dieser BB-Code wird verwendet wie jeder andere auch:

    Code
    1. [code=html]
    2. Mein Code
    3. Zeile 4 aus meinem Code

    [/code]


    Einrückung im Code wird somit beibehalten, wenn meine Codezeile 2 Leerzeichen am Anfang beinhaltet werden diese nicht entfernt, außerdem wird der Code farblich hervorgehoben:

    HTML
    1. <body>
    2. <header>
    3. <h1>Meine Überschrift</h1>
    4. </header>
    5. [...]


    Nun bietet das Forum nicht nur BB-Code für HTML Blöcke sondern auch für PHP, SQL, CSS, JavaScript und einen für sonstigen Code (ohne farbliche Hervorhebung), diese schreiben sich wie folgt:

    Code
    1. [code=php] Mein PHP-Code


    SQL
    1. Mein SQL-Code


    CSS
    1. Mein CSS-Code


    HTML
    1. Mein HTML-Code


    JavaScript
    1. Mein JavaScript-Code

    [/code]seminar.jpgEntweder schreiben wir den BB-Code selber oder wir nutzen die vorgegebenen Schaltflächen. (siehe Bild)



    Weiterführended
    Es kann manchmal sinnvoll sein wenn bei Ausschnitten die Nummerierung am Rand nicht bei 1 beginnt sondern mit den Zahlen aus der kompletten Datei übereinstimmt, hierzu können wir die Zahl mit der begonnen wird angeben:

    Code
    1. [code=php,381]

    [/code]

    PHP: 381
    1. function chance($value){
    2. if($value > 100 || $value < 0)
    3. return false;
    4. else if($value == 100)
    5. return true;
    6. else if(rand(1, 100) < $value)
    7. return true;
    8. else
    9. return false;
    10. }


    Schlechte Einrückung vermeiden: