Module:PersonPaperList/doc

From MaRDI portal

This is the documentation page for Module:PersonPaperList

Overview

This Lua module is designed for use in a MediaWiki environment. It provides functionality to execute a SPARQL query and present its results in an HTML table format. The module is particularly tailored for generating tables from SPARQL query results, relevant to specific entities identified by a dynamic parameter.

Dependencies

  • SPARQL Module: Used to execute SPARQL queries.
  • mw.html Module: Utilized for generating HTML content, specifically tables.

Module Functions

buildTableFromSparql(frame)

Generates an HTML table based on the results of a SPARQL query.

Parameters
* frame: The frame object containing arguments passed to the module.
Behavior
* Extracts target1 from frame.args[1]. If target1 is not provided or is empty, the function returns "No records found".
* Constructs and executes a SPARQL query using the target1 value. The query retrieves publication dates and work details related to target1.
* Handles errors in SPARQL query execution and logs them.
* Converts the SPARQL query results (JSON format) into a Lua table.
* Generates an HTML table with predefined headers ("Publication", "Date of Publication") and returns it as a string.

trimAndLower(str)

Utility function for string manipulation.

Parameters
* str: The string to be processed.
Returns
* The trimmed and lowercased version of the input string.

convertJsonToTable(jsonResults)

Converts SPARQL query results in JSON format into a Lua table.

Parameters
* jsonResults: JSON object containing SPARQL query results.
Returns
* A Lua table representing the SPARQL query results.

createHtmlTableWithMergedCols(dataTable, headers)

Creates an HTML table from a Lua data table, with specific column handling.

Parameters
* dataTable: The data table from which the HTML table will be generated.
* headers: A table containing header names for the HTML table.
Behavior
* Generates an HTML table with provided headers.
* Merges the first two columns of data into a single column in the resultant HTML table.
* Skips the third column and includes subsequent columns in the HTML table.
* Returns the HTML table as a string.

Return Value

The module returns a table containing the converted information (publication name and date).

Usage Example

{{#invoke:ModuleName|buildTableFromSparql|Arguments}}

Replace ModuleName with the actual name of the module when invoking it in a MediaWiki template or page. Arguments should be replaced with the appropriate arguments as required by the module's functionality.


Note: For the Debug console, you can use this:

local mockFrame = { args = { 'Q161115'} }
p.buildTableFromSparql(mockFrame)