Fix docusaurus config so it fails on broken links. (#4032)

* Fix docusaurus config so it fails on broken links. Closes #4031

* Fix broken links
This commit is contained in:
Antonin Delpeuch 2021-07-04 18:43:32 +02:00 committed by GitHub
parent aebcd41102
commit 9b24ba64f2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 13 additions and 13 deletions

View File

@ -29,9 +29,9 @@ To export data from a project, click the <span class="menuItems">Export</span> d
You can also export reconciled data to Wikidata, or export your Wikidata schema for future use with other OpenRefine projects: You can also export reconciled data to Wikidata, or export your Wikidata schema for future use with other OpenRefine projects:
* [Upload edits to Wikidata](wikidata#upload-edits-to-wikidata) * [Upload edits to Wikidata](wikibase/uploading#uploading-with-openrefine)
* [Export to QuickStatements](wikidata#quickstatements-export) (version 1) * [Export to QuickStatements](wikibase/uploading#uploading-with-quickstatements) (version 1)
* [Export Wikidata schema](wikidata#import-and-export-schema) * [Export Wikidata schema](wikibase/overview#import-and-export-schema)
### Custom tabular exporter {#custom-tabular-exporter} ### Custom tabular exporter {#custom-tabular-exporter}

View File

@ -6,7 +6,7 @@ sidebar_label: Reconciling
## Overview {#overview} ## Overview {#overview}
Reconciliation is the process of matching your dataset with that of an external source. Datasets for comparison might be produced by libraries, archives, museums, academic organizations, scientific institutions, non-profits, or interest groups. You can also reconcile against user-edited data on [Wikidata](wikidata), or reconcile against [a local dataset that you yourself supply](https://github.com/OpenRefine/OpenRefine/wiki/Reconcilable-Data-Sources#local-services). Reconciliation is the process of matching your dataset with that of an external source. Datasets for comparison might be produced by libraries, archives, museums, academic organizations, scientific institutions, non-profits, or interest groups. You can also reconcile against user-edited data on [Wikidata or other Wikibase instances](wikibase/reconciling), or reconcile against [a local dataset that you yourself supply](https://github.com/OpenRefine/OpenRefine/wiki/Reconcilable-Data-Sources#local-services).
To reconcile your OpenRefine project against an external dataset, that dataset must offer a web service that conforms to the [Reconciliation Service API standards](https://reconciliation-api.github.io/specs/0.1/). To reconcile your OpenRefine project against an external dataset, that dataset must offer a web service that conforms to the [Reconciliation Service API standards](https://reconciliation-api.github.io/specs/0.1/).
@ -31,7 +31,7 @@ OpenRefine maintains a [further list of sources on the wiki](https://github.com/
Other services may exist that are not yet listed in these two places: for example, the [310 datasets hosted by the Organized Crime and Corruption Reporting Project (OCCRP)](https://aleph.occrp.org/datasets/) each have their own reconciliation URL, or you can reconcile against their entire database with the URL [shared on the reconciliation API list](https://reconciliation-api.github.io/testbench/). For another example, you can reconcile against the entire Virtual International Authority File (VIAF) dataset, or [only the contributions from certain institutions](http://refine.codefork.com/). Search online to see if the authority you wish to reconcile against has an available service, or whether you can download a copy to reconcile against locally. Other services may exist that are not yet listed in these two places: for example, the [310 datasets hosted by the Organized Crime and Corruption Reporting Project (OCCRP)](https://aleph.occrp.org/datasets/) each have their own reconciliation URL, or you can reconcile against their entire database with the URL [shared on the reconciliation API list](https://reconciliation-api.github.io/testbench/). For another example, you can reconcile against the entire Virtual International Authority File (VIAF) dataset, or [only the contributions from certain institutions](http://refine.codefork.com/). Search online to see if the authority you wish to reconcile against has an available service, or whether you can download a copy to reconcile against locally.
OpenRefine includes Wikidata reconciliation in the installation package - see the [Wikidata](wikidata) page for more information particular to that service. Extensions can add reconciliation services, and can also add enhanced reconciliation capacities. Check the list of extensions on the [Downloads page](https://openrefine.org/download.html) for more information. OpenRefine includes Wikidata reconciliation in the installation package - see the [Wikibase](wikibase/reconciling) page for more information particular to that service. Extensions can add reconciliation services, and can also add enhanced reconciliation capacities. Check the list of extensions on the [Downloads page](https://openrefine.org/download.html) for more information.
Each source will have its own documentation on how it provides reconciliation. The table on [the reconciliation API list](https://reconciliation-api.github.io/testbench/) indicates whether your chosen service supports the features described below. Refer to the service's documentation if you have questions about its behaviors and which OpenRefine features it supports. Each source will have its own documentation on how it provides reconciliation. The table on [the reconciliation API list](https://reconciliation-api.github.io/testbench/) indicates whether your chosen service supports the features described below. Refer to the service's documentation if you have questions about its behaviors and which OpenRefine features it supports.
@ -75,7 +75,7 @@ Hovering over the suggestion will also offer the two matching options as buttons
For matched values (those appearing as dark blue links), the underlying cell value has not been altered - the cell is storing both the original string and the matched entity link at the same time. If you were to copy your column to a new column at this point using `value`, for example, the reconcilation data would not transfer - only the original strings. You can learn more about how OpenRefine stores different pieces of information in each cell in [the Variables section specific to reconciliation data](expressions#reconciliation). For matched values (those appearing as dark blue links), the underlying cell value has not been altered - the cell is storing both the original string and the matched entity link at the same time. If you were to copy your column to a new column at this point using `value`, for example, the reconcilation data would not transfer - only the original strings. You can learn more about how OpenRefine stores different pieces of information in each cell in [the Variables section specific to reconciliation data](expressions#reconciliation).
For each cell, you can manually “Create new item,” which will take the cells original value and apply it, as though it is a match. This will not become a dark blue link, because at this time there is nothing to link to: it is a draft entity stored only in your project. You can use this feature to prepare these entries for eventual upload to an editable service such as [Wikidata](wikidata), but most services do not yet support this feature. For each cell, you can manually “Create new item,” which will take the cells original value and apply it, as though it is a match. This will not become a dark blue link, because at this time there is nothing to link to: it is a draft entity stored only in your project. You can use this feature to prepare these entries for eventual upload to an editable service such as [Wikibase](wikibase/overview), but most services do not yet support this feature.
### Reconciliation facets {#reconciliation-facets} ### Reconciliation facets {#reconciliation-facets}
@ -237,6 +237,6 @@ You can find out more in the [reconciliaton variables](expressions#reconciliaton
## Exporting reconciled data {#exporting-reconciled-data} ## Exporting reconciled data {#exporting-reconciled-data}
Once you have data that is reconciled to existing entities online, you may wish to export that data to a user-editable service such as Wikidata. See the section on [uploading your edits to Wikidata](wikidata#upload-edits-to-wikidata) for more information, or the section on [exporting](exporting) to see other formats OpenRefine can produce. Once you have data that is reconciled to existing entities online, you may wish to export that data to a user-editable service such as Wikidata. See the section on [uploading your edits to Wikidata or other Wikibase instances](wikibase/uploading) for more information, or the section on [exporting](exporting) to see other formats OpenRefine can produce.
You can share reconciled data in progress through a [project export or import](exporting#export-a-project), with some preparation. The importing user needs to have the appropriate reconciliation services installed on their OpenRefine instance (by going to <span class="menuItems">Start reconciling</span> and clicking on <span class="buttonLabels">Add Standard Service...</span>) in advance of opening the project, in order to use candidate and match links. Otherwise, the links will be broken and the user will need to add the reconciliation service and re-reconcile the columns in question. [Wikidata](wikidata) reconciliation data can be shared more easily as the service comes bundled with OpenRefine. You can share reconciled data in progress through a [project export or import](exporting#export-a-project), with some preparation. The importing user needs to have the appropriate reconciliation services installed on their OpenRefine instance (by going to <span class="menuItems">Start reconciling</span> and clicking on <span class="buttonLabels">Add Standard Service...</span>) in advance of opening the project, in order to use candidate and match links. Otherwise, the links will be broken and the user will need to add the reconciliation service and re-reconcile the columns in question. [Wikidata](wikibase/reconciling) reconciliation data can be shared more easily as the service comes bundled with OpenRefine.

View File

@ -7,7 +7,7 @@ explains how to work around these cases.
Sometimes your source provides data in a structured format, such as XML, Sometimes your source provides data in a structured format, such as XML,
JSON or RDF. OpenRefine can import these files and will convert them to JSON or RDF. OpenRefine can import these files and will convert them to
tables. These tables will reflect some of the hierarchy in the file by tables. These tables will reflect some of the hierarchy in the file by
means of null cells, using the [records mode](manual/exploring#rows-vs-records). means of null cells, using the [records mode](/manual/exploring#rows-vs-records).
The Wikibase extension always works in rows mode, so if we want to add The Wikibase extension always works in rows mode, so if we want to add
statements which reference both the artist and the song, we need to fill statements which reference both the artist and the song, we need to fill

View File

@ -36,7 +36,7 @@ Do not worry about the ordering of items in the schema or the order of
your rows, as OpenRefine will rearrange your edits to optimize their your rows, as OpenRefine will rearrange your edits to optimize their
upload. If your project makes edits on the same item across multiple upload. If your project makes edits on the same item across multiple
rows, these edits will be merged together and performed in one edit. See rows, these edits will be merged together and performed in one edit. See
[Uploading your changes](./upload) about that. [Uploading your changes](./uploading) about that.
## Terms {#terms} ## Terms {#terms}

View File

@ -1,6 +1,6 @@
module.exports = { module.exports = {
onBrokenLinks: 'error', onBrokenLinks: 'throw',
onBrokenMarkdownLinks: 'error', onBrokenMarkdownLinks: 'throw',
title: 'OpenRefine', title: 'OpenRefine',
tagline: 'A power tool for working with messy data.', tagline: 'A power tool for working with messy data.',
url: 'https://docs.openrefine.org/', url: 'https://docs.openrefine.org/',