145 lines
3.0 KiB
PHP
145 lines
3.0 KiB
PHP
|
<?php
|
||
|
/**
|
||
|
* @copyright Copyright 2014 Carsten Brandt, 2024 Daniel Pimley
|
||
|
* @license https://github.com/xenocrat/chyrp-markdown/blob/master/LICENSE
|
||
|
* @link https://github.com/xenocrat/chyrp-markdown#readme
|
||
|
*/
|
||
|
|
||
|
namespace xenocrat\markdown;
|
||
|
|
||
|
/**
|
||
|
* Markdown parser for GitLab-Flavored Markdown.
|
||
|
*
|
||
|
* @see https://docs.gitlab.com/ee/user/markdown.html
|
||
|
* @author Carsten Brandt
|
||
|
* @author Daniel Pimley
|
||
|
*/
|
||
|
class GitlabMarkdown extends Markdown
|
||
|
{
|
||
|
// Include block element parsing using traits.
|
||
|
use block\FencedQuoteTrait;
|
||
|
use block\FootnoteTrait;
|
||
|
use block\FrontMatterTrait;
|
||
|
use block\TableTrait;
|
||
|
use block\TocTrait;
|
||
|
|
||
|
// Include inline element parsing using traits.
|
||
|
use inline\AutoLinkTrait;
|
||
|
use inline\MediaLinkTrait;
|
||
|
use inline\StrikeoutTrait;
|
||
|
|
||
|
/**
|
||
|
* @inheritDoc
|
||
|
*/
|
||
|
protected $blockPriorities = [
|
||
|
'FrontMatter',
|
||
|
'Hr',
|
||
|
'Ul',
|
||
|
'FencedCode',
|
||
|
'Code',
|
||
|
'FootnoteList',
|
||
|
'Html',
|
||
|
'Ol',
|
||
|
'FencedQuote',
|
||
|
'Quote',
|
||
|
'Reference',
|
||
|
'Table',
|
||
|
'Toc',
|
||
|
'Headline',
|
||
|
];
|
||
|
|
||
|
/**
|
||
|
* @var boolean Whether to interpret newlines as `<br />` tags.
|
||
|
*
|
||
|
* This feature is useful for comments where newlines are often
|
||
|
* meant to be hard line breaks.
|
||
|
*/
|
||
|
public $enableNewlines = false;
|
||
|
|
||
|
/**
|
||
|
* @inheritDoc
|
||
|
*/
|
||
|
protected function prepare(): void
|
||
|
{
|
||
|
parent::prepare();
|
||
|
|
||
|
// Reset TOC.
|
||
|
$this->toc = [];
|
||
|
|
||
|
// Reset footnote properties.
|
||
|
$this->footnotes = [];
|
||
|
$this->footnoteLinkNum = 0;
|
||
|
$this->footnoteLinks = [];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @inheritDoc
|
||
|
*/
|
||
|
protected function consumeParagraph($lines, $current): array
|
||
|
{
|
||
|
$content = [];
|
||
|
|
||
|
// Consume until blank line or end condition...
|
||
|
for ($i = $current, $count = count($lines); $i < $count; $i++) {
|
||
|
$line = $lines[$i];
|
||
|
if (
|
||
|
$line === ''
|
||
|
|| ($trimmed = ltrim($line)) === ''
|
||
|
|| (
|
||
|
(ctype_punct($trimmed[0]) || ctype_digit($trimmed[0]))
|
||
|
&& (
|
||
|
$this->identifyFencedQuote($line, $lines, $i)
|
||
|
|| $this->identifyQuote($line, $lines, $i)
|
||
|
|| $this->identifyFencedCode($line, $lines, $i)
|
||
|
|| $this->identifyFrontMatter($line, $lines, $i)
|
||
|
|| $this->identifyToc($line, $lines, $i)
|
||
|
|| $this->identifyUl($line, $lines, $i)
|
||
|
|| $this->identifyOl($line, $lines, $i)
|
||
|
|| $this->identifyHr($line, $lines, $i)
|
||
|
|| $this->identifyHtml($line, $lines, $i)
|
||
|
)
|
||
|
)
|
||
|
|| $this->identifyHeadline($line, $lines, $i)
|
||
|
) {
|
||
|
break;
|
||
|
} else {
|
||
|
$content[] = ltrim($line);
|
||
|
}
|
||
|
}
|
||
|
$block = [
|
||
|
'paragraph',
|
||
|
'content' => $this->parseInline(trim(implode("\n", $content))),
|
||
|
];
|
||
|
|
||
|
return [$block, --$i];
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @inheritDoc
|
||
|
*
|
||
|
* Parses all newlines as hard line breaks if `enableNewlines` is set.
|
||
|
*/
|
||
|
protected function renderText($text): string
|
||
|
{
|
||
|
if ($this->enableNewlines) {
|
||
|
$br = $this->html5 ? "<br>\n" : "<br />\n";
|
||
|
$text[1] = preg_replace("/ *\n/", $br, $text[1]);
|
||
|
}
|
||
|
return parent::renderText($text);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* @inheritDoc
|
||
|
*
|
||
|
* Add parsed footnotes and TOC, then post-process markup.
|
||
|
*/
|
||
|
function postprocess($markup): string
|
||
|
{
|
||
|
return parent::postprocess(
|
||
|
$this->addParsedFootnotes(
|
||
|
$this->addToc($markup)
|
||
|
)
|
||
|
);
|
||
|
}
|
||
|
}
|