PHP: Aufruf Markdown-Libary (1.8.0) von 2018

edit | delete

Autor: Ralf v.d.Mark

eingetragen: Freitag, 16. November 2018 um 14:01 Uhr (46/2018 Kalenderwoche)

geändert: Freitag, 16. November 2018 um 14:12 Uhr (46/2018 Kalenderwoche)

Keywords: Markdown Libary Bibliothek

Kategorien: PHP,

Text:

Ruft die Markdown-Libary (MARKDOWNLIB_VERSION = "1.8.0") von 2018 auf.
Die Funktion soll die alten Aufrufe "Markdown(...)" bedienen.


Funktion enthaelt meinen früheren Markdown-Erweiterungen für
- einen Zeilenumbruch ($$$$UMBRUCH$$$$) und
- den Link-Target ($$$$$$_blank)


Für die PHP version 7.2, läuft aber auch auf 5.4!


QUELLE der Markdown-Libary: https://github.com/michelf/php-markdown


Aus der Libary-Quelle benötigt man folgende Dateien (s.Screenshot):
- /michelf/Markdown.inc.php
- /michelf/Markdown.php
- /michelf/MarkdownInterface.php

Quellcode:  

//use Michelf\Markdown;//so geht es auch!
require_once dirname(__FILE__) . '/Michelf/Markdown.inc.php';
//echo Michelf\Markdown::defaultTransform($text);
/**
 * Ruft die Markdown-Libary (MARKDOWNLIB_VERSION = "1.8.0") von 2018 auf.
 * Die Funktion soll die alten Aufrufe "Markdown(...)" bedienen.
 *
 * Funktion enthaelt meinen früheren Markdown-Erweiterungen für
 *  - einen Zeilenumbruch ($$$$UMBRUCH$$$$) und
 *  - den Link-Target ($$$$$$_blank)
 *
 * QUELLE der Markdown-Libary: https://github.com/michelf/php-markdown
 *
 * PHP version 5
 *
 * @name       Funktion/Methode "Markdown()"
 * @author     Ralf von der Mark (vdM), Ref. 414, BLE <Ralf.vonderMark@BLE.de>
 * @copyright  2018, BLE
 * @version    16.11.2018, GIT: Yes
 *
 * @param  string  $textMitMarkdown (Text der Markdown-Auszeichungen enthält)
 *
 * @return string  (Fertig umgewandelter Text mit (X)HTML-Auszeichungen)
 *
 * @example
 *      echo Markdown(##ich bin eine h2-Überschrift
 *                    und ich bin **fett**!);
 */
function Markdown($textMitMarkdown)
{
    //Erstmal Markdown die Arbeit erledigen:
    $markdownRueckgabe = Michelf\Markdown::defaultTransform($textMitMarkdown);


    /** Ralf von der Mark, 16.11.2018
     *  Im alten Markdown hatte ich "doCodeBlocks()" deaktiviert, da es oft
     *  zur Ausgabe des HTML-Quelltextes fuehrte.
     *  ...
     *      function doCodeBlocks($text) {
     *          return $text;//fuehrt oft zu Quelltextausgaben
     *          ...
     *      }
     * Wenn es wieder zu Problemem führt, das auch in der neuen Libary einbauen. */


    if (strpos($markdownRueckgabe, '$$$$')) {
        // Umsetzung des Platzhalters '$$$$UMBRUCH$$$$' in '<br>':
        $markdownRueckgabe = str_replace('$$$$UMBRUCH$$$$',
            '<br class="br-rms"><!-- Markdown-Ergaenzung von Ralf vdM -->'.PHP_EOL,
            $markdownRueckgabe);


        // Umsetzung des Platzhalters '$$$$$$_blank' an der Url in 'target="blank"':
        $markdownRueckgabe = str_replace('$$$$$$_blank',
            '" target="_blank',
            $markdownRueckgabe);

    }//ENDE: if (strpos($markdownRueckgabe, '$$$$'))


    return $markdownRueckgabe;//Fertig umgewandelter Text mit (X)HTML-Auszeichungen

}//ENDE: function Markdown(...)

Anhänge: 1 Dateien

Abb. 1.) "Unbenannt.PNG"