Page Menu
Home
WickedGov Phorge
Search
Configure Global Search
Log In
Files
F7430379
CategoriesRdf.php
No One
Temporary
Actions
Download File
Edit File
Delete File
View Transforms
Subscribe
Flag For Later
Award Token
Size
4 KB
Referenced Files
None
Subscribers
None
CategoriesRdf.php
View Options
<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
*/
namespace
MediaWiki\Category
;
use
MediaWiki\Title\Title
;
use
Wikimedia\Purtle\RdfWriter
;
/**
* Helper class to produce RDF representation of categories.
*/
class
CategoriesRdf
{
/**
* Prefix used for MediaWiki ontology in the dump.
*/
private
const
ONTOLOGY_PREFIX
=
'mediawiki'
;
/**
* Base URL for MediaWiki ontology.
*/
private
const
ONTOLOGY_URL
=
'https://www.mediawiki.org/ontology#'
;
/**
* OWL description of the ontology.
*/
public
const
OWL_URL
=
'https://www.mediawiki.org/ontology/ontology.owl'
;
/**
* Current version of the dump format.
*/
public
const
FORMAT_VERSION
=
"1.1"
;
/**
* Special page for Dump identification.
* Used as head URI for each wiki's category dump, e.g.:
* https://en.wikipedia.org/wiki/Special:CategoryDump
*/
private
const
SPECIAL_DUMP
=
'Special:CategoryDump'
;
/**
* @var RdfWriter
*/
private
$rdfWriter
;
public
function
__construct
(
RdfWriter
$writer
)
{
$this
->
rdfWriter
=
$writer
;
}
/**
* Setup prefixes relevant for the dump
*/
public
function
setupPrefixes
()
{
$this
->
rdfWriter
->
prefix
(
self
::
ONTOLOGY_PREFIX
,
self
::
ONTOLOGY_URL
);
$this
->
rdfWriter
->
prefix
(
'rdfs'
,
'http://www.w3.org/2000/01/rdf-schema#'
);
$this
->
rdfWriter
->
prefix
(
'owl'
,
'http://www.w3.org/2002/07/owl#'
);
$this
->
rdfWriter
->
prefix
(
'schema'
,
'http://schema.org/'
);
$this
->
rdfWriter
->
prefix
(
'cc'
,
'http://creativecommons.org/ns#'
);
}
/**
* Write RDF data for link between categories.
* @param string $fromName Child category name
* @param string $toName Parent category name
*/
public
function
writeCategoryLinkData
(
$fromName
,
$toName
)
{
$titleFrom
=
Title
::
makeTitle
(
NS_CATEGORY
,
$fromName
);
$titleTo
=
Title
::
makeTitle
(
NS_CATEGORY
,
$toName
);
$this
->
rdfWriter
->
about
(
$this
->
titleToUrl
(
$titleFrom
)
)
->
say
(
self
::
ONTOLOGY_PREFIX
,
'isInCategory'
)
->
is
(
$this
->
titleToUrl
(
$titleTo
)
);
}
/**
* Write out the data for single category.
* @param string $categoryName
* @param bool $isHidden Hidden category?
* @param int $pages Page count (note this includes only Wiki articles, not subcats or files)
* @param int $subcategories Subcategory count
*/
public
function
writeCategoryData
(
$categoryName
,
$isHidden
,
$pages
,
$subcategories
)
{
if
(
$pages
<
0
)
{
// Bugfix for T201119
$pages
=
0
;
}
$title
=
Title
::
makeTitle
(
NS_CATEGORY
,
$categoryName
);
$this
->
rdfWriter
->
about
(
$this
->
titleToUrl
(
$title
)
)
->
say
(
'a'
)
->
is
(
self
::
ONTOLOGY_PREFIX
,
'Category'
);
if
(
$isHidden
)
{
$this
->
rdfWriter
->
is
(
self
::
ONTOLOGY_PREFIX
,
'HiddenCategory'
);
}
$titletext
=
$title
->
getText
();
$this
->
rdfWriter
->
say
(
'rdfs'
,
'label'
)->
value
(
$titletext
);
// @phan-suppress-next-line PhanTypeMismatchArgument T302667
$this
->
rdfWriter
->
say
(
self
::
ONTOLOGY_PREFIX
,
'pages'
)->
value
(
$pages
);
// @phan-suppress-next-line PhanTypeMismatchArgument T302667
$this
->
rdfWriter
->
say
(
self
::
ONTOLOGY_PREFIX
,
'subcategories'
)->
value
(
$subcategories
);
// TODO: do we want files too here? Easy to add, but don't have use case so far.
}
/**
* Make URL from title label
* @param string $titleLabel Short label (without namespace) of the category
* @return string URL for the category
*/
public
function
labelToUrl
(
$titleLabel
)
{
return
$this
->
titleToUrl
(
Title
::
makeTitle
(
NS_CATEGORY
,
$titleLabel
)
);
}
/**
* Convert Title to link to target page.
* @param Title $title
* @return string URL for the category
*/
private
function
titleToUrl
(
Title
$title
)
{
return
$title
->
getFullURL
(
''
,
false
,
PROTO_CANONICAL
);
}
/**
* Get URI of the dump for this particular wiki.
* @return string
*/
public
function
getDumpURI
()
{
return
$this
->
titleToUrl
(
Title
::
makeTitle
(
NS_MAIN
,
self
::
SPECIAL_DUMP
)
);
}
}
/** @deprecated class alias since 1.40 */
class_alias
(
CategoriesRdf
::
class
,
'CategoriesRdf'
);
File Metadata
Details
Attached
Mime Type
text/x-php
Expires
Sun, Nov 22, 10:26 (5 h, 34 m ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
63/40/327c706446f03d1b1f7bb6d957f6
Default Alt Text
CategoriesRdf.php (4 KB)
Attached To
Mode
rMWPROD MediaWiki Production
Attached
Detach File
Event Timeline
Log In to Comment