MediaWiki  master
CategoriesRdf.php
Go to the documentation of this file.
1 <?php
20 
28  const ONTOLOGY_PREFIX = 'mediawiki';
32  const ONTOLOGY_URL = 'https://www.mediawiki.org/ontology#';
36  const OWL_URL = 'https://www.mediawiki.org/ontology/ontology.owl';
40  const FORMAT_VERSION = "1.1";
46  const SPECIAL_DUMP = 'Special:CategoryDump';
50  private $rdfWriter;
51 
52  public function __construct( RdfWriter $writer ) {
53  $this->rdfWriter = $writer;
54  }
55 
59  public function setupPrefixes() {
60  $this->rdfWriter->prefix( self::ONTOLOGY_PREFIX, self::ONTOLOGY_URL );
61  $this->rdfWriter->prefix( 'rdfs', 'http://www.w3.org/2000/01/rdf-schema#' );
62  $this->rdfWriter->prefix( 'owl', 'http://www.w3.org/2002/07/owl#' );
63  $this->rdfWriter->prefix( 'schema', 'http://schema.org/' );
64  $this->rdfWriter->prefix( 'cc', 'http://creativecommons.org/ns#' );
65  }
66 
72  public function writeCategoryLinkData( $fromName, $toName ) {
73  $titleFrom = Title::makeTitle( NS_CATEGORY, $fromName );
74  $titleTo = Title::makeTitle( NS_CATEGORY, $toName );
75  $this->rdfWriter->about( $this->titleToUrl( $titleFrom ) )
76  ->say( self::ONTOLOGY_PREFIX, 'isInCategory' )
77  ->is( $this->titleToUrl( $titleTo ) );
78  }
79 
87  public function writeCategoryData( $categoryName, $isHidden, $pages, $subcategories ) {
88  if ( $pages < 0 ) {
89  // Bugfix for T201119
90  $pages = 0;
91  }
92  $title = Title::makeTitle( NS_CATEGORY, $categoryName );
93  $this->rdfWriter->about( $this->titleToUrl( $title ) )
94  ->say( 'a' )
95  ->is( self::ONTOLOGY_PREFIX, 'Category' );
96  if ( $isHidden ) {
97  $this->rdfWriter->is( self::ONTOLOGY_PREFIX, 'HiddenCategory' );
98  }
99  $titletext = $title->getText();
100  $this->rdfWriter->say( 'rdfs', 'label' )->value( $titletext );
101  $this->rdfWriter->say( self::ONTOLOGY_PREFIX, 'pages' )->value( $pages );
102  $this->rdfWriter->say( self::ONTOLOGY_PREFIX, 'subcategories' )->value( $subcategories );
103  // TODO: do we want files too here? Easy to add, but don't have use case so far.
104  }
105 
111  public function labelToUrl( $titleLabel ) {
112  return $this->titleToUrl( Title::makeTitle( NS_CATEGORY, $titleLabel ) );
113  }
114 
120  private function titleToUrl( Title $title ) {
121  return $title->getFullURL( '', false, PROTO_CANONICAL );
122  }
123 
128  public function getDumpURI() {
129  return $this->titleToUrl( Title::makeTitle( NS_MAIN, self::SPECIAL_DUMP ) );
130  }
131 
132 }
titleToUrl(Title $title)
Convert Title to link to target page.
__construct(RdfWriter $writer)
const NS_MAIN
Definition: Defines.php:60
Helper class to produce RDF representation of categories.
const SPECIAL_DUMP
Special page for Dump identification.
const ONTOLOGY_URL
Base URL for Mediawiki ontology.
setupPrefixes()
Setup prefixes relevant for the dump.
const NS_CATEGORY
Definition: Defines.php:74
getFullURL( $query='', $query2=false, $proto=PROTO_RELATIVE)
Get a real URL referring to this title, with interwiki link and fragment.
Definition: Title.php:2108
static makeTitle( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:586
const PROTO_CANONICAL
Definition: Defines.php:203
labelToUrl( $titleLabel)
Make URL from title label.
RdfWriter $rdfWriter
const FORMAT_VERSION
Current version of the dump format.
writeCategoryData( $categoryName, $isHidden, $pages, $subcategories)
Write out the data for single category.
const ONTOLOGY_PREFIX
Prefix used for Mediawiki ontology in the dump.
getDumpURI()
Get URI of the dump for this particular wiki.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU Ge...
writeCategoryLinkData( $fromName, $toName)
Write RDF data for link between categories.
const OWL_URL
OWL description of the ontology.