Tutov1/fr - Revision history

A Lyapounov at 14:41, 1 April 2025

2025-04-01T14:41:29Z

A Lyapounov at 13:29, 1 April 2025

2025-04-01T13:29:55Z

← Older revision		Revision as of 13:29, 1 April 2025
Line 83:		Line 83:
	<li><code>WHERE { ... }</code>:<br>		<li><code>WHERE { ... }</code>:<br>
	Describes the structure and conditions of the query:		Describes the structure and conditions of the query:
	<ul>		<ul><ul>
	~~<li><code>?person wdt:P1 wd:Q2</code>: selects items that are classified as people.</li>~~
	~~<li><code>wdt:P3 ?lastName</code>: retrieves the last name of the person.</li>~~
	~~<li><code>wdt:P2 ?firstName</code>: retrieves the first name of the person.</li>~~
	~~</ul>~~
	~~</li>~~
	~~</ol>~~

	~~<!--T:18-->~~
	<ul>
	<li><code>?person wdt:P1 wd:Q2</code>: selects items that are human beings (P1 = item type, Q2 = person).</li>		<li><code>?person wdt:P1 wd:Q2</code>: selects items that are human beings (P1 = item type, Q2 = person).</li>
	<li><code>wdt:P3 ?lastName</code>: associates the last name with the variable <code>?lastName</code> (P3).</li>		<li><code>wdt:P3 ?lastName</code>: associates the last name with the variable <code>?lastName</code> (P3).</li>
	<li><code>wdt:P2 ?firstName</code>: associates the first name with the variable <code>?firstName</code> (P2).</li>		<li><code>wdt:P2 ?firstName</code>: associates the first name with the variable <code>?firstName</code> (P2).</li>
	</ul>		</ul>
			</ol>

	<!--T:19-->		<!--T:19-->

A Lyapounov at 13:01, 1 April 2025

2025-04-01T13:01:40Z

← Older revision		Revision as of 13:01, 1 April 2025
Line 41:		Line 41:
	<!--T:11-->		<!--T:11-->
	To help you get started, you can:		To help you get started, you can:
	* ~~Consult~~ our ~~<b>~~examples ~~of SPARQL queries</b>~~;		* Check out our [https://data.arch.be/wiki/In-depth_search SPARQL query examples];
	* Use <b>artificial intelligence tools</b> that can generate queries based on your needs.		* Use <b>artificial intelligence tools</b> that can generate queries based on your needs.

Line 182:		Line 182:

	<!--T:33-->		<!--T:33-->
	To enrich your results, you can add multiple columns containing additional information, such as residence, date of birth, or other relevant details.		To enrich your results, you can add multiple columns containing additional information, such as residence, date of birth, or other relevant details.
			To get inspired: check out the [https://data.arch.be/wiki/Special:ListProperties list of properties] or see how data is modeled using an example, like [https://data.arch.be/wiki/Item:Q6793 Andrée De Jongh].

	~~To get inspired: check out the <b>list of properties</b> or see how data is modeled in real examples, such as <i>Andrée De Jongh</i>.~~

	<!--T:34-->		<!--T:34-->
Line 294:		Line 294:
	This allows you to combine multiple conditions.		This allows you to combine multiple conditions.
	For example: select individuals living in Anderlecht and born after January 1st, 1920		For example: select individuals living in Anderlecht and born after January 1st, 1920
	([Link to test the query]).		([https://tinyurl.com/26b2wdxc Link to test the query]).

	<syntaxhighlight lang="sparql">		<syntaxhighlight lang="sparql">
Line 327:		Line 327:
	To create charts from your SPARQL queries, you have two options:		To create charts from your SPARQL queries, you have two options:

	* Use the features of the <b>Query Service</b>: visualize data ~~as spreadsheets~~, maps, bar charts, or timelines.		* Use the features of the <i>Query Service</i>: visualize the data in the form of tables, maps, bar charts, and timelines. For more details, see [https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/Wikidata_Query_Help/Result_Views the Wikidata documentation].
	For more details, see the ~~<b>~~Wikidata documentation~~</b>~~.		* Export the data and use other tools: you can export your results in CSV or TSV format, and then process them with data visualization tools.
	* Export data and use other tools: you can export your results as CSV or TSV ~~files~~ and process them with ~~other~~ data visualization tools.

	<!--T:48-->		<!--T:48-->
Line 337:		Line 336:

	<!--T:49-->		<!--T:49-->
	<b>Advanced feature</b>: If you want to query multiple databases ~~simultaneously~~ to enrich your results, you can use <b>federated queries</b>.		<b>Advanced feature</b>: If you want to query multiple databases at once to enrich your results, you can use <b>federated queries</b>.
	~~To see~~ an example, ~~check out <b>~~[this query ~~example~~]~~</b>~~, which extracts ~~data~~ from <i>Resistance in Belgium</i> and combines it with ~~information~~ from external sources (e.g., Wikidata).		For an example, see [https://data.arch.be/wiki/In-depth_search#%3E_Enriching_data_on_resistance_members_using_external_sources_(federated_query) this sample query], which extracts information from <i>Resistance in Belgium</i> and combines it with data from external sources (e.g., Wikidata).

	<!--T:50-->		<!--T:50-->

A Lyapounov at 12:46, 1 April 2025

2025-04-01T12:46:24Z

← Older revision		Revision as of 12:46, 1 April 2025
Line 382:		Line 382:
	Although these examples use the same software (Wikibase) as this project, note that the data and query structure are specific to Wikidata and do not apply directly to the content of <i>Resistance in Belgium</i>.		Although these examples use the same software (Wikibase) as this project, note that the data and query structure are specific to Wikidata and do not apply directly to the content of <i>Resistance in Belgium</i>.

	* ~~<b>~~Wikidata Query Service Tutorial (interactive)~~</b>~~: an interactive ~~guide~~ for beginners to explore SPARQL queries practically (in English).		* [https://wdqs-tutorial.toolforge.org/ '''Wikidata Query Service Tutorial (interactive)''']: An interactive tutorial for beginners to explore SPARQL queries practically. <i>(Resource in English)</i>.
	* ~~<b>~~A ~~beginner-friendly~~ introduction~~</b>~~ to the Wikidata Query Service: a simple, step-by-step guide to understand the interface and write queries.		* [https://www.wikidata.org/wiki/Wikidata:SPARQL_query_service/A_gentle_introduction_to_the_Wikidata_Query_Service '''A gentle introduction to the Wikidata Query Service''']: A simple step-by-step guide to understand the interface and write queries.
	* ~~<b>~~Wikidata:SPARQL Tutorial~~</b>~~: a detailed and structured SPARQL guide for those who want to ~~go further with~~ writing ~~queries~~.		* [https://www.wikidata.org/wiki/Wikidata:SPARQL_tutorial '''Wikidata:SPARQL Tutorial''']: A detailed and structured SPARQL guide for those who want to deepen their query writing.
	* <b>AI-powered tools</b> that can assist you in ~~drafting SPARQL~~ queries.		* <b>AI-powered tools</b> that can assist you in writing queries.

	</translate>		</translate>

A Lyapounov at 12:43, 1 April 2025

2025-04-01T12:43:08Z

Show changes

A Lyapounov at 12:21, 1 April 2025

2025-04-01T12:21:17Z

@@ Line 40: / Line 40: @@
 <!--T:11-->
-This approach helps you:
+To help you get started, you can:
-* <b>Save time</b>;
+* Consult our <b>examples of SPARQL queries</b>;
-* <b>Avoid common errors</b>;
+* Use <b>artificial intelligence tools</b> that can generate queries based on your needs.
 <!--T:12-->
-This tutorial will guide you through the basics of SPARQL and show you how to identify the key elements to successfully adapt an existing query.
+This tutorial will guide you through the basics of <b>SPARQL</b> and help you identify the <b>key elements</b> to adapt an existing query successfully.
 </translate>

A Lyapounov at 12:17, 1 April 2025

2025-04-01T12:17:43Z

← Older revision		Revision as of 12:17, 1 April 2025
Line 7:		Line 7:

	<!--T:2-->		<!--T:2-->
	Using SPARQL is like being a detective in a vast archive collection. Instead of browsing through each document one by one, you use a ~~query~~ language that ~~lets~~ you instantly ~~retrieve~~ information ~~that matches~~ your criteria.		Using <b>SPARQL</b> is like being a detective in a vast archive collection. Instead of browsing through each document one by one, you use a language that allows you to instantly find the information matching your criteria with a single precise query.

	<!--T:3-->		<!--T:3-->
	In the context of ''Resistance in Belgium'', SPARQL makes it easier to access data on resistance members: place of birth, residence, official recognition statuses, or affiliation with resistance ~~organizations~~.		In the context of <i>Resistance in Belgium</i>, SPARQL makes it easier to access data on resistance members: place of birth, residence, official recognition statuses, or affiliation with a resistance organization.

	<!--T:4-->		<!--T:4-->
	~~'''~~With SPARQL, you can:~~'''~~		With SPARQL, you can:
	* Filter and cross-reference information;		* <b>Filter and cross-reference information</b>;
	* Customize your searches with specific criteria;		* <b>Customize your searches</b> with specific criteria;
	* Extract precise data without ~~manually browsing~~ thousands of records;		* <b>Extract precise data</b> without going through thousands of records manually;
	* Generate visualizations to better interpret your results.		* <b>Generate visualizations</b> to better interpret your results.

	<!--T:5-->		<!--T:5-->
	This approach gives you valuable autonomy in ~~analyzing the dataset~~. You can not only extract ~~name~~ lists, but also identify complex ~~relationships~~, such as ~~individuals~~ affiliated with multiple organizations or ~~holding various recognition~~ statuses.		This approach gives you <b>valuable autonomy</b> when analyzing data from <i>Resistance in Belgium</i>. You can not only extract <b>lists of names</b>, but also identify <b>complex connections</b>, such as members affiliated with multiple organizations or recognized with different statuses.

	<!--T:6-->		<!--T:6-->
	SPARQL gives you the superpower ~~coveted by researchers everywhere~~: ~~asking~~ ultra-specific ~~questions~~ and ~~getting answers within~~ milliseconds. Of course, like any superpower, it takes ~~a bit of~~ practice to master. But don’t ~~worry—this~~ tutorial is here to guide you and turn challenges into ~~opportunities.~~ Who said ~~archival~~ research had to be dusty?		SPARQL gives you the <b>superpower every researcher wants</b>: ask an ultra-specific question and see the results appear in milliseconds. Of course, like any superpower, it takes some practice to master. But don’t worry! This tutorial is here to guide you and turn challenges into opportunities… Who said archive research had to be dusty?

	<!--T:7-->		<!--T:7-->
	<~~span style="color:#158f68;"~~>Ready to master the force of SPARQL? Let’s go.</~~span~~>		<b>Ready to master the force of SPARQL? Let’s go!</b>

	<!--T:8-->		<!--T:8-->
Line 34:		Line 34:

	<!--T:9-->		<!--T:9-->
	Now that you have a general idea of what SPARQL is, here’s a strategy to help you ~~get started with~~ your research.		Now that you have a general idea of what SPARQL is, here’s a strategy to help you start your research.

	<!--T:10-->		<!--T:10-->
	There are tools ~~that assist in writing~~ SPARQL queries, but to gain autonomy and flexibility, it’s often more effective to start from an existing query and adapt it to your needs.		There are <b>tools to help write SPARQL queries</b>, but to gain <b>autonomy</b> and <b>flexibility</b>, it’s often more effective to start from an <b>existing query</b> and adapt it to your specific needs.

	<!--T:11-->		<!--T:11-->
	This approach ~~allows~~ you to:		This approach helps you:
	* Save time;		* <b>Save time</b>;
	* Avoid common errors;		* <b>Avoid common errors</b>;
	* Personalize your ~~research~~ with precision.		* <b>Personalize your searches</b> with precision.

	<!--T:12-->		<!--T:12-->
	~~'''To get started, you can:'''~~		This tutorial will guide you through the basics of SPARQL and show you how to identify the key elements to successfully adapt an existing query.
	* Consult our examples of SPARQL queries;
	* Use artificial intelligence tools capable of generating queries based on your needs.

	~~<!--T:13-->~~
	This tutorial will guide you through the basics of SPARQL and ~~teach~~ you how to identify the key elements ~~needed~~ to adapt an existing query ~~effectively.~~

	~~<!--T:14-->~~
	~~<div style="border:2px ;padding:9px; background-color:#158f68;">~~
	~~<span style="color:#FFFFFF;"><big>3/ The Basics of a SPARQL Query</big></span> </div>~~
	~~<br>~~

	~~<!--T:15-->~~
	~~A SPARQL query is built around two essential components:~~
	* '''SELECT''' – defines which information to display in the results.
	* '''WHERE''' – filters the data by setting specific conditions that the results must meet.

	~~<!--T:16-->~~
	~~'''Simple Example'''~~

	~~<!--T:17-->~~
	~~Here’s a query that retrieves the first and last names of people in the database.~~
	~~Lines starting with <code>#</code> are comments to help explain each part of the query.~~

	~~<syntaxhighlight lang="sparql">~~
	~~SELECT ?lastName ?firstName~~
	~~WHERE {~~
	~~?person wdt:P1 wd:Q2 ; # Selects individuals~~
	~~wdt:P3 ?lastName ; # Retrieves last name~~
	~~wdt:P2 ?firstName .# Retrieves first name~~
	}
	~~</syntaxhighlight>~~

	~~<!--T:18-->~~
	~~'''Explanation:'''~~
	~~1. <code>SELECT ?lastName ?firstName</code>: specifies that we want to display the values of the <code>?lastName</code> and <code>?firstName</code> variables.~~
	~~2. <code>WHERE { ... }</code>: defines the conditions the data must meet to be included in the results.~~

	~~<!--T:19-->~~
	~~'''Line-by-line breakdown:'''~~
	* <code>?person wdt:P1 wd:Q2</code>: selects items classified as human beings (P1 = item type, Q2 = person).
	* <code>wdt:P3 ?lastName</code>: retrieves the person’s last name.
	* <code>wdt:P2 ?firstName</code>: retrieves the person’s first name.

	~~<!--T:20-->~~
	~~You now know the foundation of any SPARQL query. You’ll be able to adapt them to your needs by selecting the right variables and adding filters, extra columns, or advanced options~~.

	</translate>		</translate>

A Lyapounov at 12:15, 1 April 2025

2025-04-01T12:15:40Z

← Older revision		Revision as of 12:15, 1 April 2025
Line 67:		Line 67:

	<!--T:17-->		<!--T:17-->
	Here’s a query that retrieves the first and last names of people in the database. Lines starting with <code>#</code> are comments to help explain each part of the query.		Here’s a query that retrieves the first and last names of people in the database.
			Lines starting with <code>#</code> are comments to help explain each part of the query.

	<syntaxhighlight lang="sparql">		<syntaxhighlight lang="sparql">
	SELECT ?~~nom~~ ?~~prenom~~		SELECT ?lastName ?firstName
	WHERE {		WHERE {
	?~~personne~~ wdt:P1 wd:Q2 ; # Selects ~~people~~		?person wdt:P1 wd:Q2 ; # Selects individuals
	wdt:P3 ?~~nom~~ ; # Retrieves last name		wdt:P3 ?lastName ; # Retrieves last name
	wdt:P2 ?~~prenom~~ . # Retrieves first name		wdt:P2 ?firstName .# Retrieves first name
	}		}
	</syntaxhighlight>		</syntaxhighlight>
Line 80:		Line 81:
	<!--T:18-->		<!--T:18-->
	'''Explanation:'''		'''Explanation:'''
	1. <code>SELECT ?~~nom~~ ?~~prenom~~</code>: specifies that we want to display the values of the <code>?~~nom~~</code> and <code>?~~prenom~~</code> variables.		1. <code>SELECT ?lastName ?firstName</code>: specifies that we want to display the values of the <code>?lastName</code> and <code>?firstName</code> variables.
	2. <code>WHERE { ... }</code>: defines the conditions the data must meet to be included in the results.		2. <code>WHERE { ... }</code>: defines the conditions the data must meet to be included in the results.

	<!--T:19-->		<!--T:19-->
	'''Line-by-line breakdown:'''		'''Line-by-line breakdown:'''
	* <code>?~~personne~~ wdt:P1 wd:Q2</code>: selects items classified as human beings (P1 = item type, Q2 = person).		* <code>?person wdt:P1 wd:Q2</code>: selects items classified as human beings (P1 = item type, Q2 = person).
	* <code>wdt:P3 ?~~nom~~</code>: retrieves the last name ~~of the person~~.		* <code>wdt:P3 ?lastName</code>: retrieves the person’s last name.
	* <code>wdt:P2 ?~~prenom~~</code>: retrieves the first name ~~of the person~~.		* <code>wdt:P2 ?firstName</code>: retrieves the person’s first name.

	<!--T:20-->		<!--T:20-->

A Lyapounov at 12:12, 1 April 2025

2025-04-01T12:12:28Z

← Older revision		Revision as of 12:12, 1 April 2025
Line 2:		Line 2:

	<!--T:1-->		<!--T:1-->
	<div style="border:2px; padding:9px; background-color:#158f68;">		<div style="border:2px ;padding:9px; background-color:#158f68;">
	<span style="color:#FFFFFF;"><big>1/ Introduction to SPARQL</big></span>		<span style="color:#FFFFFF;"><big>1/ Introduction to SPARQL</big></span> </div>
	</div>		<br>

	<!--T:2-->		<!--T:2-->
Line 26:		Line 26:

	<!--T:7-->		<!--T:7-->
	<span style="color:#158f68;"~~><b~~>Ready to master the force of SPARQL? Let’s go.~~</b>~~</span>		<span style="color:#158f68;">Ready to master the force of SPARQL? Let’s go.</span>

	<!--T:8-->		<!--T:8-->
	<div style="border:2px; padding:9px; background-color:#158f68;">		<div style="border:2px ;padding:9px; background-color:#158f68;">
	<span style="color:#FFFFFF;"><big>2/ Strategy for Your First Queries</big></span>		<span style="color:#FFFFFF;"><big>2/ Strategy for Your First Queries</big></span> </div>
	</div>		<br>

	<!--T:9-->		<!--T:9-->
Line 54:		Line 54:

	<!--T:14-->		<!--T:14-->
	<div style="border:2px; padding:9px; background-color:#158f68;">		<div style="border:2px ;padding:9px; background-color:#158f68;">
	<span style="color:#FFFFFF;"><big>3/ The Basics of a SPARQL Query</big></span>		<span style="color:#FFFFFF;"><big>3/ The Basics of a SPARQL Query</big></span> </div>
	</div>		<br>

	<!--T:15-->		<!--T:15-->
	A SPARQL query is built around two essential components:		A SPARQL query is built around two essential components:

	* '''SELECT''' – defines which information to display in the results.		* '''SELECT''' – defines which information to display in the results.
	* '''WHERE''' – filters the data by setting specific conditions that the results must meet.		* '''WHERE''' – filters the data by setting specific conditions that the results must meet.

A Lyapounov at 11:53, 1 April 2025

2025-04-01T11:53:34Z

← Older revision		Revision as of 11:53, 1 April 2025
Line 1:		Line 1:
	<translate>		<translate>

	== <span style="color:#~~158f68~~;">1. Introduction to SPARQL</span> == <~~!--T:1--~~>		<!--T:1-->
			<div style="border:2px; padding:9px; background-color:#158f68;">
			<span style="color:#FFFFFF;"><big>1/ Introduction to SPARQL</big></span>
			</div>

	<!--T:2-->		<!--T:2-->
	Using SPARQL is like being a detective in a vast archive collection.		Using SPARQL is like being a detective in a vast archive collection. Instead of browsing through each document one by one, you use a query language that lets you instantly retrieve information that matches your criteria.
	Instead of browsing through each document one by one, you use a query language that lets you instantly retrieve information that matches your criteria.

	<!--T:3-->		<!--T:3-->
Line 21:		Line 23:

	<!--T:6-->		<!--T:6-->
	SPARQL gives you the superpower coveted by researchers everywhere: asking ultra-specific questions and getting answers within milliseconds. Of course, like any superpower, it takes a bit of practice to master.		SPARQL gives you the superpower coveted by researchers everywhere: asking ultra-specific questions and getting answers within milliseconds. Of course, like any superpower, it takes a bit of practice to master. But don’t worry—this tutorial is here to guide you and turn challenges into opportunities. Who said archival research had to be dusty?
	But don’t worry—this tutorial is here to guide you and turn challenges into opportunities.
	Who said archival research had to be dusty?

	<!--T:7-->		<!--T:7-->
	<span style="color:#158f68;"><b>Ready to master the force of SPARQL? Let’s go.</b></span>		<span style="color:#158f68;"><b>Ready to master the force of SPARQL? Let’s go.</b></span>

	<!--T:21-->		<!--T:8-->
	-~~---~~		<div style="border:2px; padding:9px; background-color:#158f68;">
			<span style="color:#FFFFFF;"><big>2/ Strategy for Your First Queries</big></span>
	== <span style="color:#~~158f68~~;">2. Strategy for Your First Queries</span> == <~~!--T:8--~~>		</div>

	<!--T:9-->		<!--T:9-->
Line 53:		Line 53:
	This tutorial will guide you through the basics of SPARQL and teach you how to identify the key elements needed to adapt an existing query effectively.		This tutorial will guide you through the basics of SPARQL and teach you how to identify the key elements needed to adapt an existing query effectively.

	<!--T:22-->		<!--T:14-->
	-~~---~~		<div style="border:2px; padding:9px; background-color:#158f68;">
			<span style="color:#FFFFFF;"><big>3/ The Basics of a SPARQL Query</big></span>
	== <span style="color:#~~158f68~~;">3. The Basics of a SPARQL Query</span> == <~~!--T:14--~~>		</div>

	<!--T:15-->		<!--T:15-->
	A SPARQL query is built around two essential components:		A SPARQL query is built around two essential components:

	~~<!--T:23-->~~
	* '''SELECT''' – defines which information to display in the results.		* '''SELECT''' – defines which information to display in the results.
	* '''WHERE''' – filters the data by setting specific conditions that the results must meet.		* '''WHERE''' – filters the data by setting specific conditions that the results must meet.

	~~=== Simple Example ===~~ <!--T:16-->		<!--T:16-->
			'''Simple Example'''

	<!--T:17-->		<!--T:17-->
	Here’s a query that retrieves the first and last names of people in the database.		Here’s a query that retrieves the first and last names of people in the database. Lines starting with <code>#</code> are comments to help explain each part of the query.
	Lines starting with <code>#</code> are comments to help explain each part of the query.

	~~<!--T:24-->~~
	<syntaxhighlight lang="sparql">		<syntaxhighlight lang="sparql">
	SELECT ?nom ?prenom		SELECT ?nom ?prenom
Line 93:		Line 91:

	<!--T:20-->		<!--T:20-->
	You now know the foundation of any SPARQL query.		You now know the foundation of any SPARQL query. You’ll be able to adapt them to your needs by selecting the right variables and adding filters, extra columns, or advanced options.
	You’ll be able to adapt them to your needs by selecting the right variables and adding filters, extra columns, or advanced options.

	</translate>		</translate>