PhutilRemarkupEngine.php
c1d330c5b77bproduction

PhutilRemarkupEngine.php
View Options

			<?php

			/**
			* @group markup
			*/
			final class PhutilRemarkupEngine extends PhutilMarkupEngine {

			const MODE_DEFAULT = 0;
			const MODE_TEXT = 1;

			private $blockRules = array();
			private $config = array();
			private $mode;
			private $metadata = array();
			private $states = array();

			public function setConfig($key, $value) {
			$this->config[$key] = $value;
			return $this;
			}

			public function getConfig($key, $default = null) {
			return idx($this->config, $key, $default);
			}

			public function setMode($mode) {
			$this->mode = $mode;
			return $this;
			}

			public function isTextMode() {
			return $this->mode & self::MODE_TEXT;
			}

			public function setBlockRules(array $rules) {
			assert_instances_of($rules, 'PhutilRemarkupEngineBlockRule');
			$this->blockRules = $rules;
			return $this;
			}

			public function getTextMetadata($key, $default = null) {
			return idx($this->metadata, $key, $default);
			}

			public function setTextMetadata($key, $value) {
			$this->metadata[$key] = $value;
			return $this;
			}

			public function storeText($text) {
			if ($this->isTextMode()) {
			$text = phutil_safe_html($text);
			}
			return $this->storage->store($text);
			}

			public function overwriteStoredText($token, $new_text) {
			if ($this->isTextMode()) {
			$new_text = phutil_safe_html($new_text);
			}
			$this->storage->overwrite($token, $new_text);
			return $this;
			}

			public function markupText($text) {
			return $this->postprocessText($this->preprocessText($text));
			}

			public function pushState($state) {
			if (empty($this->states[$state])) {
			$this->states[$state] = 0;
			}
			$this->states[$state]++;
			return $this;
			}

			public function popState($state) {
			if (empty($this->states[$state])) {
			throw new Exception("State '{$state}' pushed more than popped!");
			}
			$this->states[$state]--;
			if (!$this->states[$state]) {
			unset($this->states[$state]);
			}
			return $this;
			}

			public function getState($state) {
			return !empty($this->states[$state]);
			}

			private function setupProcessing() {
			$this->metadata = array();
			$this->storage = new PhutilRemarkupBlockStorage();

			$block_rules = $this->blockRules;
			if (empty($block_rules)) {
			throw new Exception("Remarkup engine not configured with block rules.");
			}
			foreach ($block_rules as $rule) {
			$rule->setEngine($this);
			}
			}

			public function preprocessText($text) {
			$this->setupProcessing();

			// Apply basic block and paragraph normalization to the text. NOTE: We don't
			// strip trailing whitespace because it is semantic in some contexts,
			// notably inlined diffs that the author intends to show as a code block.
			$text = preg_replace("/\r\n?/", "\n", $text);
			$text = preg_split("/\n\n/", $text);

			$block_rules = $this->blockRules;

			$blocks = array();
			$last = null;
			$last_block = null;
			foreach ($text as $block) {

			$action = null;
			if ($last !== null) {
			if ($block_rules[$last]->shouldContinueWithBlock($block, $last_block)) {
			$action = 'merge';
			}
			}

			if (!$action) {
			foreach ($block_rules as $key => $block_rule) {
			if (!$block_rule->shouldMatchBlock(trim($block, "\n"))) {
			continue;
			}
			if (($last !== null) &&
			($key == $last) &&
			$block_rule->shouldMergeBlocks()) {
			$action = 'merge';
			} else {
			$action = 'append';
			}
			$last = $key;
			break;
			}
			}

			$last_block = $block;

			switch ($action) {
			case 'merge':
			end($blocks);
			$last_block_key = key($blocks);
			$blocks[$last_block_key]['block'] .= "\n\n".$block;
			$last_block = $blocks[$last_block_key]['block'];
			break;
			case 'append':
			$blocks[] = array(
			'rule' => $block_rules[$last],
			'block' => $block,
			);
			break;
			default:
			throw new Exception("Block in text did not match any block rule.");
			}
			}

			$output = array();
			foreach ($blocks as $block) {
			$output[] = $block['rule']->markupText($block['block']);
			}

			$map = $this->storage->getMap();
			unset($this->storage);
			$metadata = $this->metadata;

			if ($this->isTextMode()) {
			$output = implode("\n\n", $output)."\n";
			} else {
			$output = phutil_implode_html("\n\n", $output);
			}

			return array(
			'output' => $output,
			'storage' => $map,
			'metadata' => $metadata,
			);
			}

			public function postprocessText(array $dict) {
			$this->setupProcessing();

			$this->metadata = idx($dict, 'metadata', array());
			$this->storage->setMap(idx($dict, 'storage', array()));

			foreach ($this->blockRules as $block_rule) {
			$block_rule->postprocess();
			}

			return $this->restoreText(idx($dict, 'output'));
			}

			public function restoreText($text) {
			return $this->storage->restore($text);
			}
			}

libphutil/src/markup/engine/PhutilRemarkupEngine.phpc1d330c5b77bproduction

PhutilRemarkupEngine.phpView Options

libphutil/src/markup/engine/PhutilRemarkupEngine.php
c1d330c5b77bproduction

PhutilRemarkupEngine.php
View Options