@kirigami/php-prepros 1.1.0 → 1.6.0

package/src/libraries/md.plugins.php

@@ -3,7 +3,13 @@
 
 
 // =============================================================================
-// PLUGINS FOURNIS PAR DÉFAUT (optionnels, décommentez ce dont vous avez besoin)
+// DEFAULT MARKDOWN PLUGINS
+//
+// Auto-loaded from md.class.php, so these are available in every render without
+// any setup ("registered out of the box"). To drop one, call
+// MD::unregisterPlugin('name') (or md_unregister_plugin('name')) from an
+// `includes` file; to change one, MD::registerPlugin() your own under the same
+// name.
 // =============================================================================
 
 // --- CodePen (inline) ---
@@ -13,7 +19,7 @@ MD::registerPlugin('codepen', function (array $args, string $body): string {
     $id     = htmlspecialchars($args[0] ?? '', ENT_QUOTES, 'UTF-8');
     $user   = htmlspecialchars($args[1] ?? 'anonymous', ENT_QUOTES, 'UTF-8');
     $height = intval($args[2] ?? 400);
-    if ($id === '') return '<!-- codepen: id manquant -->';
+    if ($id === '') return '<!-- codepen: missing id -->';
     return "<iframe height=\"{$height}\" style=\"width:100%\" "
          . "scrolling=\"no\" "
          . "src=\"https://codepen.io/{$user}/embed/{$id}?default-tab=result\" "
@@ -28,7 +34,7 @@ MD::registerPlugin('youtube', function (array $args, string $body): string {
     $id     = htmlspecialchars($args[0] ?? '', ENT_QUOTES, 'UTF-8');
     $width  = intval($args[1] ?? 560);
     $height = intval($args[2] ?? 315);
-    if ($id === '') return '<!-- youtube: id manquant -->';
+    if ($id === '') return '<!-- youtube: missing id -->';
     return "<iframe width=\"{$width}\" height=\"{$height}\" "
          . "src=\"https://www.youtube.com/embed/{$id}\" "
          . "title=\"YouTube video player\" frameborder=\"0\" loading=\"lazy\" "
@@ -36,22 +42,22 @@ MD::registerPlugin('youtube', function (array $args, string $body): string {
          . "allowfullscreen></iframe>";
 });
 
-// --- Checklist (bloc multi-ligne) ---
+// --- Checklist (multi-line block) ---
 // {% checklist
-// Faire la vaisselle
-// Promener le chien
-// Lire un livre
+// Do the dishes
+// Walk the dog
+// Read a book
 // %}
 //
-// Optionnellement avec un titre :
-// {% checklist "Mes tâches du jour"
-// Tâche 1
-// Tâche 2
+// Optionally with a title:
+// {% checklist "My tasks for today"
+// Task 1
+// Task 2
 // %}
 MD::registerPlugin('checklist', function (array $args, string $body): string {
     $title = !empty($args[0]) ? '<p class="checklist-title"><strong>' . htmlspecialchars($args[0], ENT_QUOTES, 'UTF-8') . '</strong></p>' : '';
     $items = array_filter(array_map('trim', explode("\n", $body)));
-    if (empty($items)) return '<!-- checklist: aucun élément -->';
+    if (empty($items)) return '<!-- checklist: no items -->';
     $html = "<div class=\"checklist\">{$title}<ul>\n";
     foreach ($items as $item) {
         $html .= '  <li><label><input type="checkbox" /> ' . htmlspecialchars($item, ENT_QUOTES, 'UTF-8') . '</label></li>' . "\n";
@@ -59,22 +65,22 @@ MD::registerPlugin('checklist', function (array $args, string $body): string {
     return $html . "</ul></div>";
 });
 
-// --- Avertissement personnalisé (inline ou bloc) ---
-// Inline :  {% callout warning "Attention !" Contenu sur une ligne %}
-// Bloc   :  {% callout danger "Titre"
-//            Paragraphe 1
+// --- Custom callout (inline or block) ---
+// Inline:  {% callout warning "Warning!" Content on one line %}
+// Block :  {% callout danger "Title"
+//            Paragraph 1
 //
-//            Paragraphe 2
+//            Paragraph 2
 //            %}
 MD::registerPlugin('callout', function (array $args, string $body): string {
     $validTypes = ['info', 'success', 'warning', 'danger'];
     $type  = in_array($args[0] ?? '', $validTypes, true) ? $args[0] : 'info';
     $title = !empty($args[1]) ? htmlspecialchars($args[1], ENT_QUOTES, 'UTF-8') : '';
 
-    // Contenu : $body si tag bloc, sinon les args restants sur la ligne d'ouverture
+    // Content: $body for a block tag, otherwise the remaining args on the opening line
     if ($body !== '') {
         $content = htmlspecialchars($body, ENT_QUOTES, 'UTF-8');
-        // Remplace les doubles sauts de ligne par des <br><br> pour préserver les paragraphes
+        // Replace double line breaks with <br><br> to preserve paragraphs
         $content = str_replace("\n\n", '<br><br>', $content);
         $content = str_replace("\n", '<br>', $content);
     } else {