XOOPS /
XoopsCore27
| Total Complexity | 237 |
| Total Lines | 1695 |
| Duplicated Lines | 0 % |
| Changes | 1 | ||
| Bugs | 0 | Features | 0 |
Complex classes like Parsedown often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use Parsedown, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 16 | class Parsedown |
||
| 17 | { |
||
| 18 | # ~ |
||
| 19 | |||
| 20 | const version = '1.7.4'; |
||
| 21 | |||
| 22 | # ~ |
||
| 23 | |||
| 24 | function text($text) |
||
|
|
|||
| 25 | { |
||
| 26 | # make sure no definitions are set |
||
| 27 | $this->DefinitionData = array(); |
||
| 28 | |||
| 29 | # standardize line breaks |
||
| 30 | $text = str_replace(array("\r\n", "\r"), "\n", $text); |
||
| 31 | |||
| 32 | # remove surrounding line breaks |
||
| 33 | $text = trim($text, "\n"); |
||
| 34 | |||
| 35 | # split text into lines |
||
| 36 | $lines = explode("\n", $text); |
||
| 37 | |||
| 38 | # iterate through lines to identify blocks |
||
| 39 | $markup = $this->lines($lines); |
||
| 40 | |||
| 41 | # trim line breaks |
||
| 42 | $markup = trim($markup, "\n"); |
||
| 43 | |||
| 44 | return $markup; |
||
| 45 | } |
||
| 46 | |||
| 47 | # |
||
| 48 | # Setters |
||
| 49 | # |
||
| 50 | |||
| 51 | function setBreaksEnabled($breaksEnabled) |
||
| 52 | { |
||
| 53 | $this->breaksEnabled = $breaksEnabled; |
||
| 54 | |||
| 55 | return $this; |
||
| 56 | } |
||
| 57 | |||
| 58 | protected $breaksEnabled; |
||
| 59 | |||
| 60 | function setMarkupEscaped($markupEscaped) |
||
| 61 | { |
||
| 62 | $this->markupEscaped = $markupEscaped; |
||
| 63 | |||
| 64 | return $this; |
||
| 65 | } |
||
| 66 | |||
| 67 | protected $markupEscaped; |
||
| 68 | |||
| 69 | function setUrlsLinked($urlsLinked) |
||
| 70 | { |
||
| 71 | $this->urlsLinked = $urlsLinked; |
||
| 72 | |||
| 73 | return $this; |
||
| 74 | } |
||
| 75 | |||
| 76 | protected $urlsLinked = true; |
||
| 77 | |||
| 78 | function setSafeMode($safeMode) |
||
| 79 | { |
||
| 80 | $this->safeMode = (bool) $safeMode; |
||
| 81 | |||
| 82 | return $this; |
||
| 83 | } |
||
| 84 | |||
| 85 | protected $safeMode; |
||
| 86 | |||
| 87 | protected $safeLinksWhitelist = array( |
||
| 88 | 'http://', |
||
| 89 | 'https://', |
||
| 90 | 'ftp://', |
||
| 91 | 'ftps://', |
||
| 92 | 'mailto:', |
||
| 93 | 'data:image/png;base64,', |
||
| 94 | 'data:image/gif;base64,', |
||
| 95 | 'data:image/jpeg;base64,', |
||
| 96 | 'irc:', |
||
| 97 | 'ircs:', |
||
| 98 | 'git:', |
||
| 99 | 'ssh:', |
||
| 100 | 'news:', |
||
| 101 | 'steam:', |
||
| 102 | ); |
||
| 103 | |||
| 104 | # |
||
| 105 | # Lines |
||
| 106 | # |
||
| 107 | |||
| 108 | protected $BlockTypes = array( |
||
| 109 | '#' => array('Header'), |
||
| 110 | '*' => array('Rule', 'List'), |
||
| 111 | '+' => array('List'), |
||
| 112 | '-' => array('SetextHeader', 'Table', 'Rule', 'List'), |
||
| 113 | '0' => array('List'), |
||
| 114 | '1' => array('List'), |
||
| 115 | '2' => array('List'), |
||
| 116 | '3' => array('List'), |
||
| 117 | '4' => array('List'), |
||
| 118 | '5' => array('List'), |
||
| 119 | '6' => array('List'), |
||
| 120 | '7' => array('List'), |
||
| 121 | '8' => array('List'), |
||
| 122 | '9' => array('List'), |
||
| 123 | ':' => array('Table'), |
||
| 124 | '<' => array('Comment', 'Markup'), |
||
| 125 | '=' => array('SetextHeader'), |
||
| 126 | '>' => array('Quote'), |
||
| 127 | '[' => array('Reference'), |
||
| 128 | '_' => array('Rule'), |
||
| 129 | '`' => array('FencedCode'), |
||
| 130 | '|' => array('Table'), |
||
| 131 | '~' => array('FencedCode'), |
||
| 132 | ); |
||
| 133 | |||
| 134 | # ~ |
||
| 135 | |||
| 136 | protected $unmarkedBlockTypes = array( |
||
| 137 | 'Code', |
||
| 138 | ); |
||
| 139 | |||
| 140 | # |
||
| 141 | # Blocks |
||
| 142 | # |
||
| 143 | |||
| 144 | protected function lines(array $lines) |
||
| 145 | { |
||
| 146 | $CurrentBlock = null; |
||
| 147 | |||
| 148 | foreach ($lines as $line) |
||
| 149 | { |
||
| 150 | if (chop($line) === '') |
||
| 151 | { |
||
| 152 | if (isset($CurrentBlock)) |
||
| 153 | { |
||
| 154 | $CurrentBlock['interrupted'] = true; |
||
| 155 | } |
||
| 156 | |||
| 157 | continue; |
||
| 158 | } |
||
| 159 | |||
| 160 | if (strpos($line, "\t") !== false) |
||
| 161 | { |
||
| 162 | $parts = explode("\t", $line); |
||
| 163 | |||
| 164 | $line = $parts[0]; |
||
| 165 | |||
| 166 | unset($parts[0]); |
||
| 167 | |||
| 168 | foreach ($parts as $part) |
||
| 169 | { |
||
| 170 | $shortage = 4 - mb_strlen($line, 'utf-8') % 4; |
||
| 171 | |||
| 172 | $line .= str_repeat(' ', $shortage); |
||
| 173 | $line .= $part; |
||
| 174 | } |
||
| 175 | } |
||
| 176 | |||
| 177 | $indent = 0; |
||
| 178 | |||
| 179 | while (isset($line[$indent]) and $line[$indent] === ' ') |
||
| 180 | { |
||
| 181 | $indent ++; |
||
| 182 | } |
||
| 183 | |||
| 184 | $text = $indent > 0 ? substr($line, $indent) : $line; |
||
| 185 | |||
| 186 | # ~ |
||
| 187 | |||
| 188 | $Line = array('body' => $line, 'indent' => $indent, 'text' => $text); |
||
| 189 | |||
| 190 | # ~ |
||
| 191 | |||
| 192 | if (isset($CurrentBlock['continuable'])) |
||
| 193 | { |
||
| 194 | $Block = $this->{'block'.$CurrentBlock['type'].'Continue'}($Line, $CurrentBlock); |
||
| 195 | |||
| 196 | if (isset($Block)) |
||
| 197 | { |
||
| 198 | $CurrentBlock = $Block; |
||
| 199 | |||
| 200 | continue; |
||
| 201 | } |
||
| 202 | else |
||
| 203 | { |
||
| 204 | if ($this->isBlockCompletable($CurrentBlock['type'])) |
||
| 205 | { |
||
| 206 | $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); |
||
| 207 | } |
||
| 208 | } |
||
| 209 | } |
||
| 210 | |||
| 211 | # ~ |
||
| 212 | |||
| 213 | $marker = $text[0]; |
||
| 214 | |||
| 215 | # ~ |
||
| 216 | |||
| 217 | $blockTypes = $this->unmarkedBlockTypes; |
||
| 218 | |||
| 219 | if (isset($this->BlockTypes[$marker])) |
||
| 220 | { |
||
| 221 | foreach ($this->BlockTypes[$marker] as $blockType) |
||
| 222 | { |
||
| 223 | $blockTypes []= $blockType; |
||
| 224 | } |
||
| 225 | } |
||
| 226 | |||
| 227 | # |
||
| 228 | # ~ |
||
| 229 | |||
| 230 | foreach ($blockTypes as $blockType) |
||
| 231 | { |
||
| 232 | $Block = $this->{'block'.$blockType}($Line, $CurrentBlock); |
||
| 233 | |||
| 234 | if (isset($Block)) |
||
| 235 | { |
||
| 236 | $Block['type'] = $blockType; |
||
| 237 | |||
| 238 | if ( ! isset($Block['identified'])) |
||
| 239 | { |
||
| 240 | $Blocks []= $CurrentBlock; |
||
| 241 | |||
| 242 | $Block['identified'] = true; |
||
| 243 | } |
||
| 244 | |||
| 245 | if ($this->isBlockContinuable($blockType)) |
||
| 246 | { |
||
| 247 | $Block['continuable'] = true; |
||
| 248 | } |
||
| 249 | |||
| 250 | $CurrentBlock = $Block; |
||
| 251 | |||
| 252 | continue 2; |
||
| 253 | } |
||
| 254 | } |
||
| 255 | |||
| 256 | # ~ |
||
| 257 | |||
| 258 | if (isset($CurrentBlock) and ! isset($CurrentBlock['type']) and ! isset($CurrentBlock['interrupted'])) |
||
| 259 | { |
||
| 260 | $CurrentBlock['element']['text'] .= "\n".$text; |
||
| 261 | } |
||
| 262 | else |
||
| 263 | { |
||
| 264 | $Blocks []= $CurrentBlock; |
||
| 265 | |||
| 266 | $CurrentBlock = $this->paragraph($Line); |
||
| 267 | |||
| 268 | $CurrentBlock['identified'] = true; |
||
| 269 | } |
||
| 270 | } |
||
| 271 | |||
| 272 | # ~ |
||
| 273 | |||
| 274 | if (isset($CurrentBlock['continuable']) and $this->isBlockCompletable($CurrentBlock['type'])) |
||
| 275 | { |
||
| 276 | $CurrentBlock = $this->{'block'.$CurrentBlock['type'].'Complete'}($CurrentBlock); |
||
| 277 | } |
||
| 278 | |||
| 279 | # ~ |
||
| 280 | |||
| 281 | $Blocks []= $CurrentBlock; |
||
| 282 | |||
| 283 | unset($Blocks[0]); |
||
| 284 | |||
| 285 | # ~ |
||
| 286 | |||
| 287 | $markup = ''; |
||
| 288 | |||
| 289 | foreach ($Blocks as $Block) |
||
| 290 | { |
||
| 291 | if (isset($Block['hidden'])) |
||
| 292 | { |
||
| 293 | continue; |
||
| 294 | } |
||
| 295 | |||
| 296 | $markup .= "\n"; |
||
| 297 | $markup .= isset($Block['markup']) ? $Block['markup'] : $this->element($Block['element']); |
||
| 298 | } |
||
| 299 | |||
| 300 | $markup .= "\n"; |
||
| 301 | |||
| 302 | # ~ |
||
| 303 | |||
| 304 | return $markup; |
||
| 305 | } |
||
| 306 | |||
| 307 | protected function isBlockContinuable($Type) |
||
| 308 | { |
||
| 309 | return method_exists($this, 'block'.$Type.'Continue'); |
||
| 310 | } |
||
| 311 | |||
| 312 | protected function isBlockCompletable($Type) |
||
| 313 | { |
||
| 314 | return method_exists($this, 'block'.$Type.'Complete'); |
||
| 315 | } |
||
| 316 | |||
| 317 | # |
||
| 318 | # Code |
||
| 319 | |||
| 320 | protected function blockCode($Line, $Block = null) |
||
| 321 | { |
||
| 322 | if (isset($Block) and ! isset($Block['type']) and ! isset($Block['interrupted'])) |
||
| 323 | { |
||
| 324 | return; |
||
| 325 | } |
||
| 326 | |||
| 327 | if ($Line['indent'] >= 4) |
||
| 328 | { |
||
| 329 | $text = substr($Line['body'], 4); |
||
| 330 | |||
| 331 | $Block = array( |
||
| 332 | 'element' => array( |
||
| 333 | 'name' => 'pre', |
||
| 334 | 'handler' => 'element', |
||
| 335 | 'text' => array( |
||
| 336 | 'name' => 'code', |
||
| 337 | 'text' => $text, |
||
| 338 | ), |
||
| 339 | ), |
||
| 340 | ); |
||
| 341 | |||
| 342 | return $Block; |
||
| 343 | } |
||
| 344 | } |
||
| 345 | |||
| 346 | protected function blockCodeContinue($Line, $Block) |
||
| 347 | { |
||
| 348 | if ($Line['indent'] >= 4) |
||
| 349 | { |
||
| 350 | if (isset($Block['interrupted'])) |
||
| 351 | { |
||
| 352 | $Block['element']['text']['text'] .= "\n"; |
||
| 353 | |||
| 354 | unset($Block['interrupted']); |
||
| 355 | } |
||
| 356 | |||
| 357 | $Block['element']['text']['text'] .= "\n"; |
||
| 358 | |||
| 359 | $text = substr($Line['body'], 4); |
||
| 360 | |||
| 361 | $Block['element']['text']['text'] .= $text; |
||
| 362 | |||
| 363 | return $Block; |
||
| 364 | } |
||
| 365 | } |
||
| 366 | |||
| 367 | protected function blockCodeComplete($Block) |
||
| 368 | { |
||
| 369 | $text = $Block['element']['text']['text']; |
||
| 370 | |||
| 371 | $Block['element']['text']['text'] = $text; |
||
| 372 | |||
| 373 | return $Block; |
||
| 374 | } |
||
| 375 | |||
| 376 | # |
||
| 377 | # Comment |
||
| 378 | |||
| 379 | protected function blockComment($Line) |
||
| 380 | { |
||
| 381 | if ($this->markupEscaped or $this->safeMode) |
||
| 382 | { |
||
| 383 | return; |
||
| 384 | } |
||
| 385 | |||
| 386 | if (isset($Line['text'][3]) and $Line['text'][3] === '-' and $Line['text'][2] === '-' and $Line['text'][1] === '!') |
||
| 387 | { |
||
| 388 | $Block = array( |
||
| 389 | 'markup' => $Line['body'], |
||
| 390 | ); |
||
| 391 | |||
| 392 | if (preg_match('/-->$/', $Line['text'])) |
||
| 393 | { |
||
| 394 | $Block['closed'] = true; |
||
| 395 | } |
||
| 396 | |||
| 397 | return $Block; |
||
| 398 | } |
||
| 399 | } |
||
| 400 | |||
| 401 | protected function blockCommentContinue($Line, array $Block) |
||
| 402 | { |
||
| 403 | if (isset($Block['closed'])) |
||
| 404 | { |
||
| 405 | return; |
||
| 406 | } |
||
| 407 | |||
| 408 | $Block['markup'] .= "\n" . $Line['body']; |
||
| 409 | |||
| 410 | if (preg_match('/-->$/', $Line['text'])) |
||
| 411 | { |
||
| 412 | $Block['closed'] = true; |
||
| 413 | } |
||
| 414 | |||
| 415 | return $Block; |
||
| 416 | } |
||
| 417 | |||
| 418 | # |
||
| 419 | # Fenced Code |
||
| 420 | |||
| 421 | protected function blockFencedCode($Line) |
||
| 422 | { |
||
| 423 | if (preg_match('/^['.$Line['text'][0].']{3,}[ ]*([^`]+)?[ ]*$/', $Line['text'], $matches)) |
||
| 424 | { |
||
| 425 | $Element = array( |
||
| 426 | 'name' => 'code', |
||
| 427 | 'text' => '', |
||
| 428 | ); |
||
| 429 | |||
| 430 | if (isset($matches[1])) |
||
| 431 | { |
||
| 432 | /** |
||
| 433 | * https://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes |
||
| 434 | * Every HTML element may have a class attribute specified. |
||
| 435 | * The attribute, if specified, must have a value that is a set |
||
| 436 | * of space-separated tokens representing the various classes |
||
| 437 | * that the element belongs to. |
||
| 438 | * [...] |
||
| 439 | * The space characters, for the purposes of this specification, |
||
| 440 | * are U+0020 SPACE, U+0009 CHARACTER TABULATION (tab), |
||
| 441 | * U+000A LINE FEED (LF), U+000C FORM FEED (FF), and |
||
| 442 | * U+000D CARRIAGE RETURN (CR). |
||
| 443 | */ |
||
| 444 | $language = substr($matches[1], 0, strcspn($matches[1], " \t\n\f\r")); |
||
| 445 | |||
| 446 | $class = 'language-'.$language; |
||
| 447 | |||
| 448 | $Element['attributes'] = array( |
||
| 449 | 'class' => $class, |
||
| 450 | ); |
||
| 451 | } |
||
| 452 | |||
| 453 | $Block = array( |
||
| 454 | 'char' => $Line['text'][0], |
||
| 455 | 'element' => array( |
||
| 456 | 'name' => 'pre', |
||
| 457 | 'handler' => 'element', |
||
| 458 | 'text' => $Element, |
||
| 459 | ), |
||
| 460 | ); |
||
| 461 | |||
| 462 | return $Block; |
||
| 463 | } |
||
| 464 | } |
||
| 465 | |||
| 466 | protected function blockFencedCodeContinue($Line, $Block) |
||
| 467 | { |
||
| 468 | if (isset($Block['complete'])) |
||
| 469 | { |
||
| 470 | return; |
||
| 471 | } |
||
| 472 | |||
| 473 | if (isset($Block['interrupted'])) |
||
| 474 | { |
||
| 475 | $Block['element']['text']['text'] .= "\n"; |
||
| 476 | |||
| 477 | unset($Block['interrupted']); |
||
| 478 | } |
||
| 479 | |||
| 480 | if (preg_match('/^'.$Block['char'].'{3,}[ ]*$/', $Line['text'])) |
||
| 481 | { |
||
| 482 | $Block['element']['text']['text'] = substr($Block['element']['text']['text'], 1); |
||
| 483 | |||
| 484 | $Block['complete'] = true; |
||
| 485 | |||
| 486 | return $Block; |
||
| 487 | } |
||
| 488 | |||
| 489 | $Block['element']['text']['text'] .= "\n".$Line['body']; |
||
| 490 | |||
| 491 | return $Block; |
||
| 492 | } |
||
| 493 | |||
| 494 | protected function blockFencedCodeComplete($Block) |
||
| 495 | { |
||
| 496 | $text = $Block['element']['text']['text']; |
||
| 497 | |||
| 498 | $Block['element']['text']['text'] = $text; |
||
| 499 | |||
| 500 | return $Block; |
||
| 501 | } |
||
| 502 | |||
| 503 | # |
||
| 504 | # Header |
||
| 505 | |||
| 506 | protected function blockHeader($Line) |
||
| 507 | { |
||
| 508 | if (isset($Line['text'][1])) |
||
| 509 | { |
||
| 510 | $level = 1; |
||
| 511 | |||
| 512 | while (isset($Line['text'][$level]) and $Line['text'][$level] === '#') |
||
| 513 | { |
||
| 514 | $level ++; |
||
| 515 | } |
||
| 516 | |||
| 517 | if ($level > 6) |
||
| 518 | { |
||
| 519 | return; |
||
| 520 | } |
||
| 521 | |||
| 522 | $text = trim($Line['text'], '# '); |
||
| 523 | |||
| 524 | $Block = array( |
||
| 525 | 'element' => array( |
||
| 526 | 'name' => 'h' . min(6, $level), |
||
| 527 | 'text' => $text, |
||
| 528 | 'handler' => 'line', |
||
| 529 | ), |
||
| 530 | ); |
||
| 531 | |||
| 532 | return $Block; |
||
| 533 | } |
||
| 534 | } |
||
| 535 | |||
| 536 | # |
||
| 537 | # List |
||
| 538 | |||
| 539 | protected function blockList($Line) |
||
| 540 | { |
||
| 541 | list($name, $pattern) = $Line['text'][0] <= '-' ? array('ul', '[*+-]') : array('ol', '[0-9]+[.]'); |
||
| 542 | |||
| 543 | if (preg_match('/^('.$pattern.'[ ]+)(.*)/', $Line['text'], $matches)) |
||
| 544 | { |
||
| 545 | $Block = array( |
||
| 546 | 'indent' => $Line['indent'], |
||
| 547 | 'pattern' => $pattern, |
||
| 548 | 'element' => array( |
||
| 549 | 'name' => $name, |
||
| 550 | 'handler' => 'elements', |
||
| 551 | ), |
||
| 552 | ); |
||
| 553 | |||
| 554 | if($name === 'ol') |
||
| 555 | { |
||
| 556 | $listStart = stristr($matches[0], '.', true); |
||
| 557 | |||
| 558 | if($listStart !== '1') |
||
| 559 | { |
||
| 560 | $Block['element']['attributes'] = array('start' => $listStart); |
||
| 561 | } |
||
| 562 | } |
||
| 563 | |||
| 564 | $Block['li'] = array( |
||
| 565 | 'name' => 'li', |
||
| 566 | 'handler' => 'li', |
||
| 567 | 'text' => array( |
||
| 568 | $matches[2], |
||
| 569 | ), |
||
| 570 | ); |
||
| 571 | |||
| 572 | $Block['element']['text'] []= & $Block['li']; |
||
| 573 | |||
| 574 | return $Block; |
||
| 575 | } |
||
| 576 | } |
||
| 577 | |||
| 578 | protected function blockListContinue($Line, array $Block) |
||
| 579 | { |
||
| 580 | if ($Block['indent'] === $Line['indent'] and preg_match('/^'.$Block['pattern'].'(?:[ ]+(.*)|$)/', $Line['text'], $matches)) |
||
| 581 | { |
||
| 582 | if (isset($Block['interrupted'])) |
||
| 583 | { |
||
| 584 | $Block['li']['text'] []= ''; |
||
| 585 | |||
| 586 | $Block['loose'] = true; |
||
| 587 | |||
| 588 | unset($Block['interrupted']); |
||
| 589 | } |
||
| 590 | |||
| 591 | unset($Block['li']); |
||
| 592 | |||
| 593 | $text = isset($matches[1]) ? $matches[1] : ''; |
||
| 594 | |||
| 595 | $Block['li'] = array( |
||
| 596 | 'name' => 'li', |
||
| 597 | 'handler' => 'li', |
||
| 598 | 'text' => array( |
||
| 599 | $text, |
||
| 600 | ), |
||
| 601 | ); |
||
| 602 | |||
| 603 | $Block['element']['text'] []= & $Block['li']; |
||
| 604 | |||
| 605 | return $Block; |
||
| 606 | } |
||
| 607 | |||
| 608 | if ($Line['text'][0] === '[' and $this->blockReference($Line)) |
||
| 609 | { |
||
| 610 | return $Block; |
||
| 611 | } |
||
| 612 | |||
| 613 | if ( ! isset($Block['interrupted'])) |
||
| 614 | { |
||
| 615 | $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); |
||
| 616 | |||
| 617 | $Block['li']['text'] []= $text; |
||
| 618 | |||
| 619 | return $Block; |
||
| 620 | } |
||
| 621 | |||
| 622 | if ($Line['indent'] > 0) |
||
| 623 | { |
||
| 624 | $Block['li']['text'] []= ''; |
||
| 625 | |||
| 626 | $text = preg_replace('/^[ ]{0,4}/', '', $Line['body']); |
||
| 627 | |||
| 628 | $Block['li']['text'] []= $text; |
||
| 629 | |||
| 630 | unset($Block['interrupted']); |
||
| 631 | |||
| 632 | return $Block; |
||
| 633 | } |
||
| 634 | } |
||
| 635 | |||
| 636 | protected function blockListComplete(array $Block) |
||
| 637 | { |
||
| 638 | if (isset($Block['loose'])) |
||
| 639 | { |
||
| 640 | foreach ($Block['element']['text'] as &$li) |
||
| 641 | { |
||
| 642 | if (end($li['text']) !== '') |
||
| 643 | { |
||
| 644 | $li['text'] []= ''; |
||
| 645 | } |
||
| 646 | } |
||
| 647 | } |
||
| 648 | |||
| 649 | return $Block; |
||
| 650 | } |
||
| 651 | |||
| 652 | # |
||
| 653 | # Quote |
||
| 654 | |||
| 655 | protected function blockQuote($Line) |
||
| 656 | { |
||
| 657 | if (preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) |
||
| 658 | { |
||
| 659 | $Block = array( |
||
| 660 | 'element' => array( |
||
| 661 | 'name' => 'blockquote', |
||
| 662 | 'handler' => 'lines', |
||
| 663 | 'text' => (array) $matches[1], |
||
| 664 | ), |
||
| 665 | ); |
||
| 666 | |||
| 667 | return $Block; |
||
| 668 | } |
||
| 669 | } |
||
| 670 | |||
| 671 | protected function blockQuoteContinue($Line, array $Block) |
||
| 672 | { |
||
| 673 | if ($Line['text'][0] === '>' and preg_match('/^>[ ]?(.*)/', $Line['text'], $matches)) |
||
| 674 | { |
||
| 675 | if (isset($Block['interrupted'])) |
||
| 676 | { |
||
| 677 | $Block['element']['text'] []= ''; |
||
| 678 | |||
| 679 | unset($Block['interrupted']); |
||
| 680 | } |
||
| 681 | |||
| 682 | $Block['element']['text'] []= $matches[1]; |
||
| 683 | |||
| 684 | return $Block; |
||
| 685 | } |
||
| 686 | |||
| 687 | if ( ! isset($Block['interrupted'])) |
||
| 688 | { |
||
| 689 | $Block['element']['text'] []= $Line['text']; |
||
| 690 | |||
| 691 | return $Block; |
||
| 692 | } |
||
| 693 | } |
||
| 694 | |||
| 695 | # |
||
| 696 | # Rule |
||
| 697 | |||
| 698 | protected function blockRule($Line) |
||
| 699 | { |
||
| 700 | if (preg_match('/^(['.$Line['text'][0].'])([ ]*\1){2,}[ ]*$/', $Line['text'])) |
||
| 701 | { |
||
| 702 | $Block = array( |
||
| 703 | 'element' => array( |
||
| 704 | 'name' => 'hr' |
||
| 705 | ), |
||
| 706 | ); |
||
| 707 | |||
| 708 | return $Block; |
||
| 709 | } |
||
| 710 | } |
||
| 711 | |||
| 712 | # |
||
| 713 | # Setext |
||
| 714 | |||
| 715 | protected function blockSetextHeader($Line, array $Block = null) |
||
| 716 | { |
||
| 717 | if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) |
||
| 718 | { |
||
| 719 | return; |
||
| 720 | } |
||
| 721 | |||
| 722 | if (chop($Line['text'], $Line['text'][0]) === '') |
||
| 723 | { |
||
| 724 | $Block['element']['name'] = $Line['text'][0] === '=' ? 'h1' : 'h2'; |
||
| 725 | |||
| 726 | return $Block; |
||
| 727 | } |
||
| 728 | } |
||
| 729 | |||
| 730 | # |
||
| 731 | # Markup |
||
| 732 | |||
| 733 | protected function blockMarkup($Line) |
||
| 734 | { |
||
| 735 | if ($this->markupEscaped or $this->safeMode) |
||
| 736 | { |
||
| 737 | return; |
||
| 738 | } |
||
| 739 | |||
| 740 | if (preg_match('/^<(\w[\w-]*)(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*(\/)?>/', $Line['text'], $matches)) |
||
| 741 | { |
||
| 742 | $element = strtolower($matches[1]); |
||
| 743 | |||
| 744 | if (in_array($element, $this->textLevelElements)) |
||
| 745 | { |
||
| 746 | return; |
||
| 747 | } |
||
| 748 | |||
| 749 | $Block = array( |
||
| 750 | 'name' => $matches[1], |
||
| 751 | 'depth' => 0, |
||
| 752 | 'markup' => $Line['text'], |
||
| 753 | ); |
||
| 754 | |||
| 755 | $length = strlen($matches[0]); |
||
| 756 | |||
| 757 | $remainder = substr($Line['text'], $length); |
||
| 758 | |||
| 759 | if (trim($remainder) === '') |
||
| 760 | { |
||
| 761 | if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) |
||
| 762 | { |
||
| 763 | $Block['closed'] = true; |
||
| 764 | |||
| 765 | $Block['void'] = true; |
||
| 766 | } |
||
| 767 | } |
||
| 768 | else |
||
| 769 | { |
||
| 770 | if (isset($matches[2]) or in_array($matches[1], $this->voidElements)) |
||
| 771 | { |
||
| 772 | return; |
||
| 773 | } |
||
| 774 | |||
| 775 | if (preg_match('/<\/'.$matches[1].'>[ ]*$/i', $remainder)) |
||
| 776 | { |
||
| 777 | $Block['closed'] = true; |
||
| 778 | } |
||
| 779 | } |
||
| 780 | |||
| 781 | return $Block; |
||
| 782 | } |
||
| 783 | } |
||
| 784 | |||
| 785 | protected function blockMarkupContinue($Line, array $Block) |
||
| 786 | { |
||
| 787 | if (isset($Block['closed'])) |
||
| 788 | { |
||
| 789 | return; |
||
| 790 | } |
||
| 791 | |||
| 792 | if (preg_match('/^<'.$Block['name'].'(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*>/i', $Line['text'])) # open |
||
| 793 | { |
||
| 794 | $Block['depth'] ++; |
||
| 795 | } |
||
| 796 | |||
| 797 | if (preg_match('/(.*?)<\/'.$Block['name'].'>[ ]*$/i', $Line['text'], $matches)) # close |
||
| 798 | { |
||
| 799 | if ($Block['depth'] > 0) |
||
| 800 | { |
||
| 801 | $Block['depth'] --; |
||
| 802 | } |
||
| 803 | else |
||
| 804 | { |
||
| 805 | $Block['closed'] = true; |
||
| 806 | } |
||
| 807 | } |
||
| 808 | |||
| 809 | if (isset($Block['interrupted'])) |
||
| 810 | { |
||
| 811 | $Block['markup'] .= "\n"; |
||
| 812 | |||
| 813 | unset($Block['interrupted']); |
||
| 814 | } |
||
| 815 | |||
| 816 | $Block['markup'] .= "\n".$Line['body']; |
||
| 817 | |||
| 818 | return $Block; |
||
| 819 | } |
||
| 820 | |||
| 821 | # |
||
| 822 | # Reference |
||
| 823 | |||
| 824 | protected function blockReference($Line) |
||
| 825 | { |
||
| 826 | if (preg_match('/^\[(.+?)\]:[ ]*<?(\S+?)>?(?:[ ]+["\'(](.+)["\')])?[ ]*$/', $Line['text'], $matches)) |
||
| 827 | { |
||
| 828 | $id = strtolower($matches[1]); |
||
| 829 | |||
| 830 | $Data = array( |
||
| 831 | 'url' => $matches[2], |
||
| 832 | 'title' => null, |
||
| 833 | ); |
||
| 834 | |||
| 835 | if (isset($matches[3])) |
||
| 836 | { |
||
| 837 | $Data['title'] = $matches[3]; |
||
| 838 | } |
||
| 839 | |||
| 840 | $this->DefinitionData['Reference'][$id] = $Data; |
||
| 841 | |||
| 842 | $Block = array( |
||
| 843 | 'hidden' => true, |
||
| 844 | ); |
||
| 845 | |||
| 846 | return $Block; |
||
| 847 | } |
||
| 848 | } |
||
| 849 | |||
| 850 | # |
||
| 851 | # Table |
||
| 852 | |||
| 853 | protected function blockTable($Line, array $Block = null) |
||
| 854 | { |
||
| 855 | if ( ! isset($Block) or isset($Block['type']) or isset($Block['interrupted'])) |
||
| 856 | { |
||
| 857 | return; |
||
| 858 | } |
||
| 859 | |||
| 860 | if (strpos($Block['element']['text'], '|') !== false and chop($Line['text'], ' -:|') === '') |
||
| 861 | { |
||
| 862 | $alignments = array(); |
||
| 863 | |||
| 864 | $divider = $Line['text']; |
||
| 865 | |||
| 866 | $divider = trim($divider); |
||
| 867 | $divider = trim($divider, '|'); |
||
| 868 | |||
| 869 | $dividerCells = explode('|', $divider); |
||
| 870 | |||
| 871 | foreach ($dividerCells as $dividerCell) |
||
| 872 | { |
||
| 873 | $dividerCell = trim($dividerCell); |
||
| 874 | |||
| 875 | if ($dividerCell === '') |
||
| 876 | { |
||
| 877 | continue; |
||
| 878 | } |
||
| 879 | |||
| 880 | $alignment = null; |
||
| 881 | |||
| 882 | if ($dividerCell[0] === ':') |
||
| 883 | { |
||
| 884 | $alignment = 'left'; |
||
| 885 | } |
||
| 886 | |||
| 887 | if (substr($dividerCell, - 1) === ':') |
||
| 888 | { |
||
| 889 | $alignment = $alignment === 'left' ? 'center' : 'right'; |
||
| 890 | } |
||
| 891 | |||
| 892 | $alignments []= $alignment; |
||
| 893 | } |
||
| 894 | |||
| 895 | # ~ |
||
| 896 | |||
| 897 | $HeaderElements = array(); |
||
| 898 | |||
| 899 | $header = $Block['element']['text']; |
||
| 900 | |||
| 901 | $header = trim($header); |
||
| 902 | $header = trim($header, '|'); |
||
| 903 | |||
| 904 | $headerCells = explode('|', $header); |
||
| 905 | |||
| 906 | foreach ($headerCells as $index => $headerCell) |
||
| 907 | { |
||
| 908 | $headerCell = trim($headerCell); |
||
| 909 | |||
| 910 | $HeaderElement = array( |
||
| 911 | 'name' => 'th', |
||
| 912 | 'text' => $headerCell, |
||
| 913 | 'handler' => 'line', |
||
| 914 | ); |
||
| 915 | |||
| 916 | if (isset($alignments[$index])) |
||
| 917 | { |
||
| 918 | $alignment = $alignments[$index]; |
||
| 919 | |||
| 920 | $HeaderElement['attributes'] = array( |
||
| 921 | 'style' => 'text-align: '.$alignment.';', |
||
| 922 | ); |
||
| 923 | } |
||
| 924 | |||
| 925 | $HeaderElements []= $HeaderElement; |
||
| 926 | } |
||
| 927 | |||
| 928 | # ~ |
||
| 929 | |||
| 930 | $Block = array( |
||
| 931 | 'alignments' => $alignments, |
||
| 932 | 'identified' => true, |
||
| 933 | 'element' => array( |
||
| 934 | 'name' => 'table', |
||
| 935 | 'handler' => 'elements', |
||
| 936 | ), |
||
| 937 | ); |
||
| 938 | |||
| 939 | $Block['element']['text'] []= array( |
||
| 940 | 'name' => 'thead', |
||
| 941 | 'handler' => 'elements', |
||
| 942 | ); |
||
| 943 | |||
| 944 | $Block['element']['text'] []= array( |
||
| 945 | 'name' => 'tbody', |
||
| 946 | 'handler' => 'elements', |
||
| 947 | 'text' => array(), |
||
| 948 | ); |
||
| 949 | |||
| 950 | $Block['element']['text'][0]['text'] []= array( |
||
| 951 | 'name' => 'tr', |
||
| 952 | 'handler' => 'elements', |
||
| 953 | 'text' => $HeaderElements, |
||
| 954 | ); |
||
| 955 | |||
| 956 | return $Block; |
||
| 957 | } |
||
| 958 | } |
||
| 959 | |||
| 960 | protected function blockTableContinue($Line, array $Block) |
||
| 961 | { |
||
| 962 | if (isset($Block['interrupted'])) |
||
| 963 | { |
||
| 964 | return; |
||
| 965 | } |
||
| 966 | |||
| 967 | if ($Line['text'][0] === '|' or strpos($Line['text'], '|')) |
||
| 968 | { |
||
| 969 | $Elements = array(); |
||
| 970 | |||
| 971 | $row = $Line['text']; |
||
| 972 | |||
| 973 | $row = trim($row); |
||
| 974 | $row = trim($row, '|'); |
||
| 975 | |||
| 976 | preg_match_all('/(?:(\\\\[|])|[^|`]|`[^`]+`|`)+/', $row, $matches); |
||
| 977 | |||
| 978 | foreach ($matches[0] as $index => $cell) |
||
| 979 | { |
||
| 980 | $cell = trim($cell); |
||
| 981 | |||
| 982 | $Element = array( |
||
| 983 | 'name' => 'td', |
||
| 984 | 'handler' => 'line', |
||
| 985 | 'text' => $cell, |
||
| 986 | ); |
||
| 987 | |||
| 988 | if (isset($Block['alignments'][$index])) |
||
| 989 | { |
||
| 990 | $Element['attributes'] = array( |
||
| 991 | 'style' => 'text-align: '.$Block['alignments'][$index].';', |
||
| 992 | ); |
||
| 993 | } |
||
| 994 | |||
| 995 | $Elements []= $Element; |
||
| 996 | } |
||
| 997 | |||
| 998 | $Element = array( |
||
| 999 | 'name' => 'tr', |
||
| 1000 | 'handler' => 'elements', |
||
| 1001 | 'text' => $Elements, |
||
| 1002 | ); |
||
| 1003 | |||
| 1004 | $Block['element']['text'][1]['text'] []= $Element; |
||
| 1005 | |||
| 1006 | return $Block; |
||
| 1007 | } |
||
| 1008 | } |
||
| 1009 | |||
| 1010 | # |
||
| 1011 | # ~ |
||
| 1012 | # |
||
| 1013 | |||
| 1014 | protected function paragraph($Line) |
||
| 1015 | { |
||
| 1016 | $Block = array( |
||
| 1017 | 'element' => array( |
||
| 1018 | 'name' => 'p', |
||
| 1019 | 'text' => $Line['text'], |
||
| 1020 | 'handler' => 'line', |
||
| 1021 | ), |
||
| 1022 | ); |
||
| 1023 | |||
| 1024 | return $Block; |
||
| 1025 | } |
||
| 1026 | |||
| 1027 | # |
||
| 1028 | # Inline Elements |
||
| 1029 | # |
||
| 1030 | |||
| 1031 | protected $InlineTypes = array( |
||
| 1032 | '"' => array('SpecialCharacter'), |
||
| 1033 | '!' => array('Image'), |
||
| 1034 | '&' => array('SpecialCharacter'), |
||
| 1035 | '*' => array('Emphasis'), |
||
| 1036 | ':' => array('Url'), |
||
| 1037 | '<' => array('UrlTag', 'EmailTag', 'Markup', 'SpecialCharacter'), |
||
| 1038 | '>' => array('SpecialCharacter'), |
||
| 1039 | '[' => array('Link'), |
||
| 1040 | '_' => array('Emphasis'), |
||
| 1041 | '`' => array('Code'), |
||
| 1042 | '~' => array('Strikethrough'), |
||
| 1043 | '\\' => array('EscapeSequence'), |
||
| 1044 | ); |
||
| 1045 | |||
| 1046 | # ~ |
||
| 1047 | |||
| 1048 | protected $inlineMarkerList = '!"*_&[:<>`~\\'; |
||
| 1049 | |||
| 1050 | # |
||
| 1051 | # ~ |
||
| 1052 | # |
||
| 1053 | |||
| 1054 | public function line($text, $nonNestables=array()) |
||
| 1055 | { |
||
| 1056 | $markup = ''; |
||
| 1057 | |||
| 1058 | # $excerpt is based on the first occurrence of a marker |
||
| 1059 | |||
| 1060 | while ($excerpt = strpbrk($text, $this->inlineMarkerList)) |
||
| 1061 | { |
||
| 1062 | $marker = $excerpt[0]; |
||
| 1063 | |||
| 1064 | $markerPosition = strpos($text, $marker); |
||
| 1065 | |||
| 1066 | $Excerpt = array('text' => $excerpt, 'context' => $text); |
||
| 1067 | |||
| 1068 | foreach ($this->InlineTypes[$marker] as $inlineType) |
||
| 1069 | { |
||
| 1070 | # check to see if the current inline type is nestable in the current context |
||
| 1071 | |||
| 1072 | if ( ! empty($nonNestables) and in_array($inlineType, $nonNestables)) |
||
| 1073 | { |
||
| 1074 | continue; |
||
| 1075 | } |
||
| 1076 | |||
| 1077 | $Inline = $this->{'inline'.$inlineType}($Excerpt); |
||
| 1078 | |||
| 1079 | if ( ! isset($Inline)) |
||
| 1080 | { |
||
| 1081 | continue; |
||
| 1082 | } |
||
| 1083 | |||
| 1084 | # makes sure that the inline belongs to "our" marker |
||
| 1085 | |||
| 1086 | if (isset($Inline['position']) and $Inline['position'] > $markerPosition) |
||
| 1087 | { |
||
| 1088 | continue; |
||
| 1089 | } |
||
| 1090 | |||
| 1091 | # sets a default inline position |
||
| 1092 | |||
| 1093 | if ( ! isset($Inline['position'])) |
||
| 1094 | { |
||
| 1095 | $Inline['position'] = $markerPosition; |
||
| 1096 | } |
||
| 1097 | |||
| 1098 | # cause the new element to 'inherit' our non nestables |
||
| 1099 | |||
| 1100 | foreach ($nonNestables as $non_nestable) |
||
| 1101 | { |
||
| 1102 | $Inline['element']['nonNestables'][] = $non_nestable; |
||
| 1103 | } |
||
| 1104 | |||
| 1105 | # the text that comes before the inline |
||
| 1106 | $unmarkedText = substr($text, 0, $Inline['position']); |
||
| 1107 | |||
| 1108 | # compile the unmarked text |
||
| 1109 | $markup .= $this->unmarkedText($unmarkedText); |
||
| 1110 | |||
| 1111 | # compile the inline |
||
| 1112 | $markup .= isset($Inline['markup']) ? $Inline['markup'] : $this->element($Inline['element']); |
||
| 1113 | |||
| 1114 | # remove the examined text |
||
| 1115 | $text = substr($text, $Inline['position'] + $Inline['extent']); |
||
| 1116 | |||
| 1117 | continue 2; |
||
| 1118 | } |
||
| 1119 | |||
| 1120 | # the marker does not belong to an inline |
||
| 1121 | |||
| 1122 | $unmarkedText = substr($text, 0, $markerPosition + 1); |
||
| 1123 | |||
| 1124 | $markup .= $this->unmarkedText($unmarkedText); |
||
| 1125 | |||
| 1126 | $text = substr($text, $markerPosition + 1); |
||
| 1127 | } |
||
| 1128 | |||
| 1129 | $markup .= $this->unmarkedText($text); |
||
| 1130 | |||
| 1131 | return $markup; |
||
| 1132 | } |
||
| 1133 | |||
| 1134 | # |
||
| 1135 | # ~ |
||
| 1136 | # |
||
| 1137 | |||
| 1138 | protected function inlineCode($Excerpt) |
||
| 1139 | { |
||
| 1140 | $marker = $Excerpt['text'][0]; |
||
| 1141 | |||
| 1142 | if (preg_match('/^('.$marker.'+)[ ]*(.+?)[ ]*(?<!'.$marker.')\1(?!'.$marker.')/s', $Excerpt['text'], $matches)) |
||
| 1143 | { |
||
| 1144 | $text = $matches[2]; |
||
| 1145 | $text = preg_replace("/[ ]*\n/", ' ', $text); |
||
| 1146 | |||
| 1147 | return array( |
||
| 1148 | 'extent' => strlen($matches[0]), |
||
| 1149 | 'element' => array( |
||
| 1150 | 'name' => 'code', |
||
| 1151 | 'text' => $text, |
||
| 1152 | ), |
||
| 1153 | ); |
||
| 1154 | } |
||
| 1155 | } |
||
| 1156 | |||
| 1157 | protected function inlineEmailTag($Excerpt) |
||
| 1158 | { |
||
| 1159 | if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<((mailto:)?\S+?@\S+?)>/i', $Excerpt['text'], $matches)) |
||
| 1160 | { |
||
| 1161 | $url = $matches[1]; |
||
| 1162 | |||
| 1163 | if ( ! isset($matches[2])) |
||
| 1164 | { |
||
| 1165 | $url = 'mailto:' . $url; |
||
| 1166 | } |
||
| 1167 | |||
| 1168 | return array( |
||
| 1169 | 'extent' => strlen($matches[0]), |
||
| 1170 | 'element' => array( |
||
| 1171 | 'name' => 'a', |
||
| 1172 | 'text' => $matches[1], |
||
| 1173 | 'attributes' => array( |
||
| 1174 | 'href' => $url, |
||
| 1175 | ), |
||
| 1176 | ), |
||
| 1177 | ); |
||
| 1178 | } |
||
| 1179 | } |
||
| 1180 | |||
| 1181 | protected function inlineEmphasis($Excerpt) |
||
| 1182 | { |
||
| 1183 | if ( ! isset($Excerpt['text'][1])) |
||
| 1184 | { |
||
| 1185 | return; |
||
| 1186 | } |
||
| 1187 | |||
| 1188 | $marker = $Excerpt['text'][0]; |
||
| 1189 | |||
| 1190 | if ($Excerpt['text'][1] === $marker and preg_match($this->StrongRegex[$marker], $Excerpt['text'], $matches)) |
||
| 1191 | { |
||
| 1192 | $emphasis = 'strong'; |
||
| 1193 | } |
||
| 1194 | elseif (preg_match($this->EmRegex[$marker], $Excerpt['text'], $matches)) |
||
| 1195 | { |
||
| 1196 | $emphasis = 'em'; |
||
| 1197 | } |
||
| 1198 | else |
||
| 1199 | { |
||
| 1200 | return; |
||
| 1201 | } |
||
| 1202 | |||
| 1203 | return array( |
||
| 1204 | 'extent' => strlen($matches[0]), |
||
| 1205 | 'element' => array( |
||
| 1206 | 'name' => $emphasis, |
||
| 1207 | 'handler' => 'line', |
||
| 1208 | 'text' => $matches[1], |
||
| 1209 | ), |
||
| 1210 | ); |
||
| 1211 | } |
||
| 1212 | |||
| 1213 | protected function inlineEscapeSequence($Excerpt) |
||
| 1214 | { |
||
| 1215 | if (isset($Excerpt['text'][1]) and in_array($Excerpt['text'][1], $this->specialCharacters)) |
||
| 1216 | { |
||
| 1217 | return array( |
||
| 1218 | 'markup' => $Excerpt['text'][1], |
||
| 1219 | 'extent' => 2, |
||
| 1220 | ); |
||
| 1221 | } |
||
| 1222 | } |
||
| 1223 | |||
| 1224 | protected function inlineImage($Excerpt) |
||
| 1225 | { |
||
| 1226 | if ( ! isset($Excerpt['text'][1]) or $Excerpt['text'][1] !== '[') |
||
| 1227 | { |
||
| 1228 | return; |
||
| 1229 | } |
||
| 1230 | |||
| 1231 | $Excerpt['text']= substr($Excerpt['text'], 1); |
||
| 1232 | |||
| 1233 | $Link = $this->inlineLink($Excerpt); |
||
| 1234 | |||
| 1235 | if ($Link === null) |
||
| 1236 | { |
||
| 1237 | return; |
||
| 1238 | } |
||
| 1239 | |||
| 1240 | $Inline = array( |
||
| 1241 | 'extent' => $Link['extent'] + 1, |
||
| 1242 | 'element' => array( |
||
| 1243 | 'name' => 'img', |
||
| 1244 | 'attributes' => array( |
||
| 1245 | 'src' => $Link['element']['attributes']['href'], |
||
| 1246 | 'alt' => $Link['element']['text'], |
||
| 1247 | ), |
||
| 1248 | ), |
||
| 1249 | ); |
||
| 1250 | |||
| 1251 | $Inline['element']['attributes'] += $Link['element']['attributes']; |
||
| 1252 | |||
| 1253 | unset($Inline['element']['attributes']['href']); |
||
| 1254 | |||
| 1255 | return $Inline; |
||
| 1256 | } |
||
| 1257 | |||
| 1258 | protected function inlineLink($Excerpt) |
||
| 1259 | { |
||
| 1260 | $Element = array( |
||
| 1261 | 'name' => 'a', |
||
| 1262 | 'handler' => 'line', |
||
| 1263 | 'nonNestables' => array('Url', 'Link'), |
||
| 1264 | 'text' => null, |
||
| 1265 | 'attributes' => array( |
||
| 1266 | 'href' => null, |
||
| 1267 | 'title' => null, |
||
| 1268 | ), |
||
| 1269 | ); |
||
| 1270 | |||
| 1271 | $extent = 0; |
||
| 1272 | |||
| 1273 | $remainder = $Excerpt['text']; |
||
| 1274 | |||
| 1275 | if (preg_match('/\[((?:[^][]++|(?R))*+)\]/', $remainder, $matches)) |
||
| 1276 | { |
||
| 1277 | $Element['text'] = $matches[1]; |
||
| 1278 | |||
| 1279 | $extent += strlen($matches[0]); |
||
| 1280 | |||
| 1281 | $remainder = substr($remainder, $extent); |
||
| 1282 | } |
||
| 1283 | else |
||
| 1284 | { |
||
| 1285 | return; |
||
| 1286 | } |
||
| 1287 | |||
| 1288 | if (preg_match('/^[(]\s*+((?:[^ ()]++|[(][^ )]+[)])++)(?:[ ]+("[^"]*"|\'[^\']*\'))?\s*[)]/', $remainder, $matches)) |
||
| 1289 | { |
||
| 1290 | $Element['attributes']['href'] = $matches[1]; |
||
| 1291 | |||
| 1292 | if (isset($matches[2])) |
||
| 1293 | { |
||
| 1294 | $Element['attributes']['title'] = substr($matches[2], 1, - 1); |
||
| 1295 | } |
||
| 1296 | |||
| 1297 | $extent += strlen($matches[0]); |
||
| 1298 | } |
||
| 1299 | else |
||
| 1300 | { |
||
| 1301 | if (preg_match('/^\s*\[(.*?)\]/', $remainder, $matches)) |
||
| 1302 | { |
||
| 1303 | $definition = strlen($matches[1]) ? $matches[1] : $Element['text']; |
||
| 1304 | $definition = strtolower($definition); |
||
| 1305 | |||
| 1306 | $extent += strlen($matches[0]); |
||
| 1307 | } |
||
| 1308 | else |
||
| 1309 | { |
||
| 1310 | $definition = strtolower($Element['text']); |
||
| 1311 | } |
||
| 1312 | |||
| 1313 | if ( ! isset($this->DefinitionData['Reference'][$definition])) |
||
| 1314 | { |
||
| 1315 | return; |
||
| 1316 | } |
||
| 1317 | |||
| 1318 | $Definition = $this->DefinitionData['Reference'][$definition]; |
||
| 1319 | |||
| 1320 | $Element['attributes']['href'] = $Definition['url']; |
||
| 1321 | $Element['attributes']['title'] = $Definition['title']; |
||
| 1322 | } |
||
| 1323 | |||
| 1324 | return array( |
||
| 1325 | 'extent' => $extent, |
||
| 1326 | 'element' => $Element, |
||
| 1327 | ); |
||
| 1328 | } |
||
| 1329 | |||
| 1330 | protected function inlineMarkup($Excerpt) |
||
| 1331 | { |
||
| 1332 | if ($this->markupEscaped or $this->safeMode or strpos($Excerpt['text'], '>') === false) |
||
| 1333 | { |
||
| 1334 | return; |
||
| 1335 | } |
||
| 1336 | |||
| 1337 | if ($Excerpt['text'][1] === '/' and preg_match('/^<\/\w[\w-]*[ ]*>/s', $Excerpt['text'], $matches)) |
||
| 1338 | { |
||
| 1339 | return array( |
||
| 1340 | 'markup' => $matches[0], |
||
| 1341 | 'extent' => strlen($matches[0]), |
||
| 1342 | ); |
||
| 1343 | } |
||
| 1344 | |||
| 1345 | if ($Excerpt['text'][1] === '!' and preg_match('/^<!---?[^>-](?:-?[^-])*-->/s', $Excerpt['text'], $matches)) |
||
| 1346 | { |
||
| 1347 | return array( |
||
| 1348 | 'markup' => $matches[0], |
||
| 1349 | 'extent' => strlen($matches[0]), |
||
| 1350 | ); |
||
| 1351 | } |
||
| 1352 | |||
| 1353 | if ($Excerpt['text'][1] !== ' ' and preg_match('/^<\w[\w-]*(?:[ ]*'.$this->regexHtmlAttribute.')*[ ]*\/?>/s', $Excerpt['text'], $matches)) |
||
| 1354 | { |
||
| 1355 | return array( |
||
| 1356 | 'markup' => $matches[0], |
||
| 1357 | 'extent' => strlen($matches[0]), |
||
| 1358 | ); |
||
| 1359 | } |
||
| 1360 | } |
||
| 1361 | |||
| 1362 | protected function inlineSpecialCharacter($Excerpt) |
||
| 1363 | { |
||
| 1364 | if ($Excerpt['text'][0] === '&' and ! preg_match('/^&#?\w+;/', $Excerpt['text'])) |
||
| 1365 | { |
||
| 1366 | return array( |
||
| 1367 | 'markup' => '&', |
||
| 1368 | 'extent' => 1, |
||
| 1369 | ); |
||
| 1370 | } |
||
| 1371 | |||
| 1372 | $SpecialCharacter = array('>' => 'gt', '<' => 'lt', '"' => 'quot'); |
||
| 1373 | |||
| 1374 | if (isset($SpecialCharacter[$Excerpt['text'][0]])) |
||
| 1375 | { |
||
| 1376 | return array( |
||
| 1377 | 'markup' => '&'.$SpecialCharacter[$Excerpt['text'][0]].';', |
||
| 1378 | 'extent' => 1, |
||
| 1379 | ); |
||
| 1380 | } |
||
| 1381 | } |
||
| 1382 | |||
| 1383 | protected function inlineStrikethrough($Excerpt) |
||
| 1384 | { |
||
| 1385 | if ( ! isset($Excerpt['text'][1])) |
||
| 1386 | { |
||
| 1387 | return; |
||
| 1388 | } |
||
| 1389 | |||
| 1390 | if ($Excerpt['text'][1] === '~' and preg_match('/^~~(?=\S)(.+?)(?<=\S)~~/', $Excerpt['text'], $matches)) |
||
| 1391 | { |
||
| 1392 | return array( |
||
| 1393 | 'extent' => strlen($matches[0]), |
||
| 1394 | 'element' => array( |
||
| 1395 | 'name' => 'del', |
||
| 1396 | 'text' => $matches[1], |
||
| 1397 | 'handler' => 'line', |
||
| 1398 | ), |
||
| 1399 | ); |
||
| 1400 | } |
||
| 1401 | } |
||
| 1402 | |||
| 1403 | protected function inlineUrl($Excerpt) |
||
| 1404 | { |
||
| 1405 | if ($this->urlsLinked !== true or ! isset($Excerpt['text'][2]) or $Excerpt['text'][2] !== '/') |
||
| 1406 | { |
||
| 1407 | return; |
||
| 1408 | } |
||
| 1409 | |||
| 1410 | if (preg_match('/\bhttps?:[\/]{2}[^\s<]+\b\/*/ui', $Excerpt['context'], $matches, PREG_OFFSET_CAPTURE)) |
||
| 1411 | { |
||
| 1412 | $url = $matches[0][0]; |
||
| 1413 | |||
| 1414 | $Inline = array( |
||
| 1415 | 'extent' => strlen($matches[0][0]), |
||
| 1416 | 'position' => $matches[0][1], |
||
| 1417 | 'element' => array( |
||
| 1418 | 'name' => 'a', |
||
| 1419 | 'text' => $url, |
||
| 1420 | 'attributes' => array( |
||
| 1421 | 'href' => $url, |
||
| 1422 | ), |
||
| 1423 | ), |
||
| 1424 | ); |
||
| 1425 | |||
| 1426 | return $Inline; |
||
| 1427 | } |
||
| 1428 | } |
||
| 1429 | |||
| 1430 | protected function inlineUrlTag($Excerpt) |
||
| 1431 | { |
||
| 1432 | if (strpos($Excerpt['text'], '>') !== false and preg_match('/^<(\w+:\/{2}[^ >]+)>/i', $Excerpt['text'], $matches)) |
||
| 1433 | { |
||
| 1434 | $url = $matches[1]; |
||
| 1435 | |||
| 1436 | return array( |
||
| 1437 | 'extent' => strlen($matches[0]), |
||
| 1438 | 'element' => array( |
||
| 1439 | 'name' => 'a', |
||
| 1440 | 'text' => $url, |
||
| 1441 | 'attributes' => array( |
||
| 1442 | 'href' => $url, |
||
| 1443 | ), |
||
| 1444 | ), |
||
| 1445 | ); |
||
| 1446 | } |
||
| 1447 | } |
||
| 1448 | |||
| 1449 | # ~ |
||
| 1450 | |||
| 1451 | protected function unmarkedText($text) |
||
| 1452 | { |
||
| 1453 | if ($this->breaksEnabled) |
||
| 1454 | { |
||
| 1455 | $text = preg_replace('/[ ]*\n/', "<br />\n", $text); |
||
| 1456 | } |
||
| 1457 | else |
||
| 1458 | { |
||
| 1459 | $text = preg_replace('/(?:[ ][ ]+|[ ]*\\\\)\n/', "<br />\n", $text); |
||
| 1460 | $text = str_replace(" \n", "\n", $text); |
||
| 1461 | } |
||
| 1462 | |||
| 1463 | return $text; |
||
| 1464 | } |
||
| 1465 | |||
| 1466 | # |
||
| 1467 | # Handlers |
||
| 1468 | # |
||
| 1469 | |||
| 1470 | protected function element(array $Element) |
||
| 1471 | { |
||
| 1472 | if ($this->safeMode) |
||
| 1473 | { |
||
| 1474 | $Element = $this->sanitiseElement($Element); |
||
| 1475 | } |
||
| 1476 | |||
| 1477 | $markup = '<'.$Element['name']; |
||
| 1478 | |||
| 1479 | if (isset($Element['attributes'])) |
||
| 1480 | { |
||
| 1481 | foreach ($Element['attributes'] as $name => $value) |
||
| 1482 | { |
||
| 1483 | if ($value === null) |
||
| 1484 | { |
||
| 1485 | continue; |
||
| 1486 | } |
||
| 1487 | |||
| 1488 | $markup .= ' '.$name.'="'.self::escape($value).'"'; |
||
| 1489 | } |
||
| 1490 | } |
||
| 1491 | |||
| 1492 | $permitRawHtml = false; |
||
| 1493 | |||
| 1494 | if (isset($Element['text'])) |
||
| 1495 | { |
||
| 1496 | $text = $Element['text']; |
||
| 1497 | } |
||
| 1498 | // very strongly consider an alternative if you're writing an |
||
| 1499 | // extension |
||
| 1500 | elseif (isset($Element['rawHtml'])) |
||
| 1501 | { |
||
| 1502 | $text = $Element['rawHtml']; |
||
| 1503 | $allowRawHtmlInSafeMode = isset($Element['allowRawHtmlInSafeMode']) && $Element['allowRawHtmlInSafeMode']; |
||
| 1504 | $permitRawHtml = !$this->safeMode || $allowRawHtmlInSafeMode; |
||
| 1505 | } |
||
| 1506 | |||
| 1507 | if (isset($text)) |
||
| 1508 | { |
||
| 1509 | $markup .= '>'; |
||
| 1510 | |||
| 1511 | if (!isset($Element['nonNestables'])) |
||
| 1512 | { |
||
| 1513 | $Element['nonNestables'] = array(); |
||
| 1514 | } |
||
| 1515 | |||
| 1516 | if (isset($Element['handler'])) |
||
| 1517 | { |
||
| 1518 | $markup .= $this->{$Element['handler']}($text, $Element['nonNestables']); |
||
| 1519 | } |
||
| 1520 | elseif (!$permitRawHtml) |
||
| 1521 | { |
||
| 1522 | $markup .= self::escape($text, true); |
||
| 1523 | } |
||
| 1524 | else |
||
| 1525 | { |
||
| 1526 | $markup .= $text; |
||
| 1527 | } |
||
| 1528 | |||
| 1529 | $markup .= '</'.$Element['name'].'>'; |
||
| 1530 | } |
||
| 1531 | else |
||
| 1532 | { |
||
| 1533 | $markup .= ' />'; |
||
| 1534 | } |
||
| 1535 | |||
| 1536 | return $markup; |
||
| 1537 | } |
||
| 1538 | |||
| 1539 | protected function elements(array $Elements) |
||
| 1540 | { |
||
| 1541 | $markup = ''; |
||
| 1542 | |||
| 1543 | foreach ($Elements as $Element) |
||
| 1544 | { |
||
| 1545 | $markup .= "\n" . $this->element($Element); |
||
| 1546 | } |
||
| 1547 | |||
| 1548 | $markup .= "\n"; |
||
| 1549 | |||
| 1550 | return $markup; |
||
| 1551 | } |
||
| 1552 | |||
| 1553 | # ~ |
||
| 1554 | |||
| 1555 | protected function li($lines) |
||
| 1556 | { |
||
| 1557 | $markup = $this->lines($lines); |
||
| 1558 | |||
| 1559 | $trimmedMarkup = trim($markup); |
||
| 1560 | |||
| 1561 | if ( ! in_array('', $lines) and substr($trimmedMarkup, 0, 3) === '<p>') |
||
| 1562 | { |
||
| 1563 | $markup = $trimmedMarkup; |
||
| 1564 | $markup = substr($markup, 3); |
||
| 1565 | |||
| 1566 | $position = strpos($markup, "</p>"); |
||
| 1567 | |||
| 1568 | $markup = substr_replace($markup, '', $position, 4); |
||
| 1569 | } |
||
| 1570 | |||
| 1571 | return $markup; |
||
| 1572 | } |
||
| 1573 | |||
| 1574 | # |
||
| 1575 | # Deprecated Methods |
||
| 1576 | # |
||
| 1577 | |||
| 1578 | function parse($text) |
||
| 1579 | { |
||
| 1580 | $markup = $this->text($text); |
||
| 1581 | |||
| 1582 | return $markup; |
||
| 1583 | } |
||
| 1584 | |||
| 1585 | protected function sanitiseElement(array $Element) |
||
| 1586 | { |
||
| 1587 | static $goodAttribute = '/^[a-zA-Z0-9][a-zA-Z0-9-_]*+$/'; |
||
| 1588 | static $safeUrlNameToAtt = array( |
||
| 1589 | 'a' => 'href', |
||
| 1590 | 'img' => 'src', |
||
| 1591 | ); |
||
| 1592 | |||
| 1593 | if (isset($safeUrlNameToAtt[$Element['name']])) |
||
| 1594 | { |
||
| 1595 | $Element = $this->filterUnsafeUrlInAttribute($Element, $safeUrlNameToAtt[$Element['name']]); |
||
| 1596 | } |
||
| 1597 | |||
| 1598 | if ( ! empty($Element['attributes'])) |
||
| 1599 | { |
||
| 1600 | foreach ($Element['attributes'] as $att => $val) |
||
| 1601 | { |
||
| 1602 | # filter out badly parsed attribute |
||
| 1603 | if ( ! preg_match($goodAttribute, $att)) |
||
| 1604 | { |
||
| 1605 | unset($Element['attributes'][$att]); |
||
| 1606 | } |
||
| 1607 | # dump onevent attribute |
||
| 1608 | elseif (self::striAtStart($att, 'on')) |
||
| 1609 | { |
||
| 1610 | unset($Element['attributes'][$att]); |
||
| 1611 | } |
||
| 1612 | } |
||
| 1613 | } |
||
| 1614 | |||
| 1615 | return $Element; |
||
| 1616 | } |
||
| 1617 | |||
| 1618 | protected function filterUnsafeUrlInAttribute(array $Element, $attribute) |
||
| 1619 | { |
||
| 1620 | foreach ($this->safeLinksWhitelist as $scheme) |
||
| 1621 | { |
||
| 1622 | if (self::striAtStart($Element['attributes'][$attribute], $scheme)) |
||
| 1623 | { |
||
| 1624 | return $Element; |
||
| 1625 | } |
||
| 1626 | } |
||
| 1627 | |||
| 1628 | $Element['attributes'][$attribute] = str_replace(':', '%3A', $Element['attributes'][$attribute]); |
||
| 1629 | |||
| 1630 | return $Element; |
||
| 1631 | } |
||
| 1632 | |||
| 1633 | # |
||
| 1634 | # Static Methods |
||
| 1635 | # |
||
| 1636 | |||
| 1637 | protected static function escape($text, $allowQuotes = false) |
||
| 1638 | { |
||
| 1639 | return htmlspecialchars($text, $allowQuotes ? ENT_NOQUOTES : ENT_QUOTES, 'UTF-8'); |
||
| 1640 | } |
||
| 1641 | |||
| 1642 | protected static function striAtStart($string, $needle) |
||
| 1643 | { |
||
| 1644 | $len = strlen($needle); |
||
| 1645 | |||
| 1646 | if ($len > strlen($string)) |
||
| 1647 | { |
||
| 1648 | return false; |
||
| 1649 | } |
||
| 1650 | else |
||
| 1651 | { |
||
| 1652 | return strtolower(substr($string, 0, $len)) === strtolower($needle); |
||
| 1653 | } |
||
| 1654 | } |
||
| 1655 | |||
| 1656 | static function instance($name = 'default') |
||
| 1668 | } |
||
| 1669 | |||
| 1670 | private static $instances = array(); |
||
| 1671 | |||
| 1672 | # |
||
| 1673 | # Fields |
||
| 1674 | # |
||
| 1675 | |||
| 1676 | protected $DefinitionData; |
||
| 1677 | |||
| 1678 | # |
||
| 1679 | # Read-Only |
||
| 1680 | |||
| 1681 | protected $specialCharacters = array( |
||
| 1682 | '\\', '`', '*', '_', '{', '}', '[', ']', '(', ')', '>', '#', '+', '-', '.', '!', '|', |
||
| 1683 | ); |
||
| 1684 | |||
| 1685 | protected $StrongRegex = array( |
||
| 1686 | '*' => '/^[*]{2}((?:\\\\\*|[^*]|[*][^*]*[*])+?)[*]{2}(?![*])/s', |
||
| 1687 | '_' => '/^__((?:\\\\_|[^_]|_[^_]*_)+?)__(?!_)/us', |
||
| 1688 | ); |
||
| 1689 | |||
| 1690 | protected $EmRegex = array( |
||
| 1691 | '*' => '/^[*]((?:\\\\\*|[^*]|[*][*][^*]+?[*][*])+?)[*](?![*])/s', |
||
| 1692 | '_' => '/^_((?:\\\\_|[^_]|__[^_]*__)+?)_(?!_)\b/us', |
||
| 1693 | ); |
||
| 1694 | |||
| 1695 | protected $regexHtmlAttribute = '[a-zA-Z_:][\w:.-]*(?:\s*=\s*(?:[^"\'=<>`\s]+|"[^"]*"|\'[^\']*\'))?'; |
||
| 1696 | |||
| 1697 | protected $voidElements = array( |
||
| 1698 | 'area', 'base', 'br', 'col', 'command', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'param', 'source', |
||
| 1699 | ); |
||
| 1700 | |||
| 1701 | protected $textLevelElements = array( |
||
| 1702 | 'a', 'br', 'bdo', 'abbr', 'blink', 'nextid', 'acronym', 'basefont', |
||
| 1703 | 'b', 'em', 'big', 'cite', 'small', 'spacer', 'listing', |
||
| 1704 | 'i', 'rp', 'del', 'code', 'strike', 'marquee', |
||
| 1705 | 'q', 'rt', 'ins', 'font', 'strong', |
||
| 1706 | 's', 'tt', 'kbd', 'mark', |
||
| 1707 | 'u', 'xm', 'sub', 'nobr', |
||
| 1708 | 'sup', 'ruby', |
||
| 1709 | 'var', 'span', |
||
| 1710 | 'wbr', 'time', |
||
| 1711 | ); |
||
| 1712 | } |
||
| 1713 |
Loading history...
Adding explicit visibility (
private,protected, orpublic) is generally recommend to communicate to other developers how, and from where this method is intended to be used.