社区文档构建进行中,欢迎编辑。社区答疑群(非官方):717421103

全站通知:

帮助:解析函数/concept

来自WIKI实验室WIKI_BWIKI_哔哩哔哩
跳到导航 跳到搜索

concept是一个解析函数。帮助:解析函数页列出了所有解析函数的说明。

concept

定义概念。出自扩展 Semantic MediaWiki SMW功能强大,应用广泛。<br>如需单页内大量调用,请考虑使用模板、模块批量查询,这能提升综合体验、降低资源消耗。<br>另请参阅灰机、Fandom的相关文档,他们详述了对SMW的顾虑和限制。

概念(Concept,一个SMW术语),是通过指定条件创建的“动态类别”。可以将概念看作一组预先存储的SMW查询条件,可供SMW查询调用。


当概念修改后,使用此概念的SMW查询也会更新(类似于更新页面属性后,SMW查询结果会更新)。 比如,有16处SMW查询包含对同一概念的筛选(如“好武器”,指攻击≥70的特品武器),就可以为其定义一个概念。当查询条件需要修改时(比如改为攻击≥75),仅需修改概念就可以完成对这16处查询的更新。


概念需要在概念命名空间定义(比如概念:好武器),这与模板、Widget等相似。概念定义后,其页面会像分类页面一样展示符合条件的页面列表。

语法

{{#concept:条件|说明}}

  • 条件:SMW查询条件,可以包含其他概念。
  • 说明:描述概念的文本

示例

文档concept页面示例.png
“概念:好武器”页面内容

比如将攻击≥70的特品武器称为“好武器”。

概念:好武器 页面填入以下内容:

{{#concept: [[类型::武器]][[品级::特品]][[攻击::>70]]
| 特品高攻击武器
}}

基于此,可进行查询:

文档concept查询示例.png

此后,如果对于“好武器”的评判标准改变了,那么只需要修改 概念:好武器 页面,不必逐个寻找、更新SMW查询条件。


底层代码

/* SemanticMediaWiki-4.0.0\src\ParserFunctions\ConceptParserFunction.php */

namespace SMW\ParserFunctions;

use Html;
use Parser;
use SMW\Services\ServicesFactory as ApplicationFactory; 
use SMW\DIConcept;
use SMW\DIProperty;
use SMW\MessageFormatter;
use SMW\ParserData;
use SMW\PostProcHandler;
use SMWInfolink;
use SMWQueryProcessor as QueryProcessor;
use Title;

/**
 * Class that provides the {{#concept}} parser function
 *
 * @license GNU GPL v2+
 * @since   1.9
 *
 * @author Markus Krötzsch
 * @author Jeroen De Dauw
 * @author mwjames
 */
class ConceptParserFunction {

	/**
	 * @var ParserData
	 */
	private $parserData;

	/**
	 * @var MessageFormatter
	 */
	private $messageFormatter;

	/**
	 * @var PostProcHandler
	 */
	private $postProcHandler;

	/**
	 * @since 1.9
	 *
	 * @param ParserData $parserData
	 * @param MessageFormatter $messageFormatter
	 */
	public function __construct( ParserData $parserData, MessageFormatter $messageFormatter ) {
		$this->parserData = $parserData;
		$this->messageFormatter = $messageFormatter;
	}

	/**
	 * @since 3.0
	 *
	 * @param PostProcHandler $postProcHandler
	 */
	public function setPostProcHandler( PostProcHandler $postProcHandler ) {
		$this->postProcHandler = $postProcHandler;
	}

	/**
	 * Parse parameters, return concept information box and update the
	 * ParserOutput with the concept object
	 *
	 * @since 1.9
	 *
	 * @param array $params
	 *
	 * @return string|null
	 */
	public function parse( array $rawParams ) {
		$this->parserData->getOutput()->addModules( 'ext.smw.style' );

		$title = $this->parserData->getTitle();
		$property = new DIProperty( '_CONC' );

		if ( !( $title->getNamespace() === SMW_NS_CONCEPT ) ) {
			return $this->messageFormatter->addFromKey( 'smw_no_concept_namespace' )->getHtml();
		} elseif ( count( $this->parserData->getSemanticData()->getPropertyValues( $property ) ) > 0 ) {
			return $this->messageFormatter->addFromKey( 'smw_multiple_concepts' )->getHtml();
		}

		// Remove parser object from parameters array
		if ( isset( $rawParams[0] ) && $rawParams[0] instanceof Parser ) {
			array_shift( $rawParams );
		}

		// Use first parameter as concept (query) string
		$conceptQuery = array_shift( $rawParams );

		// Use second parameter, if any as a description
		$conceptDocu = array_shift( $rawParams );

		$query = $this->buildQuery( $conceptQuery );

		$conceptQueryString = $query->getDescription()->getQueryString();

		$this->parserData->getSemanticData()->addPropertyObjectValue(
			$property,
			new DIConcept(
				$conceptQueryString,
				$conceptDocu,
				$query->getDescription()->getQueryFeatures(),
				$query->getDescription()->getSize(),
				$query->getDescription()->getDepth()
			)
		);

		$this->messageFormatter
			->addFromArray( $query->getErrors() )
			->addFromArray( $this->parserData->getErrors() );

		if ( $this->postProcHandler !== null ) {
			$this->postProcHandler->addCheck( $query );
		}

		$this->addQueryProfile( $query );

		$this->parserData->pushSemanticDataToParserOutput();

		if ( $this->messageFormatter->exists() ) {
			return $this->messageFormatter->getHtml();
		}

		return $this->createHtml( $title, $conceptQueryString, $conceptDocu );
	}

	private function createHtml( Title $title, $queryString, $documentation ) {

		$message = '';

		if ( wfMessage( 'smw-concept-introductory-message' )->exists() ) {
			$message = Html::rawElement(
				'div',
				[
					'class' => 'plainlinks smw-callout smw-callout-info'
				],
				wfMessage( 'smw-concept-introductory-message', $title->getText() )->text()
			);
		}

		return $message . Html::rawElement( 'div', [ 'class' => 'smwfact' ],
			Html::rawElement( 'span', [ 'class' => 'smwfactboxhead' ],
				wfMessage( 'smw_concept_description', $title->getText() )->text() ) .
			Html::rawElement( 'span', [ 'class' => 'smwrdflink' ], $this->getRdfLink( $title )->getWikiText() ) .
			Html::element( 'br', [] ) .
			Html::element( 'p', [ 'class' => 'concept-documenation' ], $documentation ? $documentation : '' ) .
			Html::rawElement( 'pre', [], str_replace( '[', '&#91;', $queryString ) ) .
			Html::element( 'br', [] )
		);
	}

	private function getRdfLink( Title $title ) {
		return SMWInfolink::newInternalLink(
			wfMessage( 'smw_viewasrdf' )->text(),
			$title->getPageLanguage()->getNsText( NS_SPECIAL ) . ':ExportRDF/' . $title->getPrefixedText(), 'rdflink'
		);
	}

	private function buildQuery( $conceptQueryString ) {
		$rawParams = [ $conceptQueryString ];

		list( $query, ) = QueryProcessor::getQueryAndParamsFromFunctionParams(
			$rawParams,
			SMW_OUTPUT_WIKI,
			QueryProcessor::CONCEPT_DESC,
			false
		);

		return $query;
	}

	private function addQueryProfile( $query ) {

		// If the smwgQueryProfiler is marked with FALSE then just don't create a profile.
		if ( ApplicationFactory::getInstance()->getSettings()->get( 'smwgQueryProfiler' ) === false ) {
			return;
		}

		$query->setContextPage(
			$this->parserData->getSemanticData()->getSubject()
		);

		$profileAnnotatorFactory = ApplicationFactory::getInstance()->getQueryFactory()->newProfileAnnotatorFactory();

		$descriptionProfileAnnotator = $profileAnnotatorFactory->newDescriptionProfileAnnotator(
			$query
		);

		$descriptionProfileAnnotator->pushAnnotationsTo(
			$this->parserData->getSemanticData()
		);
	}

}

实际用例

  • 尚未收录