Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!
Get Started for Free

links

lists links on a Wikipedia page


Description

lists all links (to wikipedia and to external url) that are present in a specific wikipedia page.

Usage

links(page = NULL, domain = "en")

Arguments

page

numeric identifier or character title of the specific wikipedia page

domain

a character value specifying the language of the wikipedia url.The default value is "en" for "english language".

Details

This function uses the MediaWiki API query syntax: "prop=links". For more details, see http://www.mediawiki.org/wiki/API:Properties#links_.2F_pl.

Value

an object of class linksClass containing:

  • call the command line

  • page title, identification number, and domain of the Wikipedia page

  • links a data frame containing title, the titles of the linked pages, ns, numbers of the namespaces (identification of the type of pages, defining nscat et nssubj, the two next variables), nscat, the categories of linked pages (Subject, Talk, or Virtual), nssubj, the subjects of the linked pages (Main Article, User, Wikipedia, File, MediaWiki, Template, Help, Category, Protal, Book, Draft, Education Program, TimedText, Module, Topic, Special, Media, Other). For more details about namespace, see http://www.mediawiki.org/wiki/Help:Namespaces and http://en.wikipedia.org/wiki/Wikipedia:Namespace#Subject_namespaces

  • extlinks a vector containing the list of url of external links. If there is no external link in the page, this item is not created.

  • testWikiPagea list of four elements,

    • takeOnlyFirst a boolean indicating if the class of page parameter is invalid, for example vector, list, matrix..., and in that case, only the first element is considered.

    • redirPage title of the redirected url. This item is NULL if the page is not redirected.

    • test an integer with value:

      • 4 for invalid domain,

      • 3 for an empty parameter page,

      • 2 when Wikipedia does not have an article with this exact name,

      • 1 for ambiguous page, direct or redirect,

      • 0 for valid an unambiguous page, direct or redirect.

    • warnMessage is a vector of warning messages.

Author(s)

Avner Bar-Hen, Louise Baschet, Francois-Xavier Jollois, Jeremie Riou

See Also

print.linksClass backLinks

Examples

## Not run: 
# a simple example
links("Louis Pasteur") # default domain : en

# with a redirected page
links.Obama <- links(page ="Obama")
links.Obama
# warning message

# a simple example with page specified by its page ID number
links(page = 976, domain = "fr" )

# with a page that not exist (at the moment of the redaction of this help page)
links("zzzzz") 

## End(Not run)

WikipediaR

R-Based Wikipedia Client

v1.1
GPL (> 2)
Authors
Avner Bar-Hen [aut, cre], Louise Baschet [ctb], Francois-Xavier Jollois [ctb], Jeremie Riou [ctb]
Initial release
2016-02-05

We don't support your browser anymore

Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.