HowTo

From data.leibnitiana.eu
Jump to: navigation, search

Here you can find some information about the LCA back-end structure and about how to edit structured data and add biographies and other texts.

The Guidelines for LCA Authors can be found here: https://tinyurl.com/LCA-auth-gl.

The Correspondent item page

If you open a Correspondent's page, you'll see that each Correspondent is described in a single item page.

The Correspondent is identified by an alphanumerical code, a "Q" followed by some digits (in the case of Guglielmini: Q613).

Label, description, aliases

On the top of the page you have a box where you can set a short description and (also multiple) aliases. The label provided by the LCA project must not be changed. Unlike Wikidata, the LCA project currently implements only the English language (so, if you add some data in other languages, they won't be shown in the Website).

How to edit description, aliases

To edit the description or aliases, click on "edit" on the bottom-right of the box, make your edit and click on "save".

Each change you make is immediately shown in the Website page as well (obviously, only in the case of elements part of the Website page structure).

You are strongly encouraged to give a short description of the Correspondent, otherwise no description will appear on the Website.

Statements

All structured information about Correspondets are expressed through statements, in the form of triples subject-predicate-object, where the Correspondent is the subject of several statements.

Depending on the property type, the object may be a value (e.g. a string representing the family name, or a date) or another item part of the Wikibase dataset (e.g. the item representing a religious order or a keyword - it means that those fields are normalized).

How to edit existing statements

You are encouraged by the boarding staff of the LCA Project to check if all the biographical data provided in the Correspondent item page are correct. If they are, you just should leave them as they are.

If, as an example, the birth place is not correct, you should leave it as it is, (or, if set to "preferred", change its rank from "preferred" to "normal" or "deprecated"). Then, if possible, you have to add the correct statement and set its rank to "preferred":

  • click on "edit" (on the right side of the box related to the statement);
  • click on "add" on the bottom of the box;
  • now you are supposed to fill in the object field; there are 2 possibilities, depending on the property type:
    • you just have to put a value (maybe a valid date in the case you are inserting a date) and click on "save";
    • you have to select an item from a list; in this case, if you start typing the label of the item (remember to start exactly from the beginning of the label) an autocompletion function suggests you a list of items. Choose the correct one and click on "save". If you can't find the correct item, look a the lists of controlled vocabularies available in the home page. If you can't find the item, contact the LCA Project editorial board, or, only if you are filling in keywords or tags, you should create one new item (see how to create a new item).

How to add new statements

The LCA Project provided to upload a set of biographical data about Correspondents. Furthermore, if you look at the Domenico Guglielmini page, you'll see that there's a lot of contextual data that you are enabled to add in order to improve the quality of the Correspondent's voice. In both cases, you have the possibility to add new statements that were not provided by the LCA Project.

How to do it:

  • scroll down the Correspondent page and click on "add" on the bottom of the box;
  • insert the correct property, using the autocompletion function. If you can't find the correct property, see the ontology for the list of properties;
  • to fill in the object field, follow the last passages exposed in How to edit existing statements

References

Each statement that has been imported through an automatic upload during the previous phases of the LCA Project has been referenced (in order to keep track of the source), while information added manually won't generally be referenced.

Ranks

On the left of each statement's object you have the rank button. The default rank is the "normal" rank. Ranks provide a mechanism for annotating multiple values for a statement; as an example, if you have two discordant birth dates, you may decide which one is the preferred one by setting its rank to "preferred". You can also set the "preferred" rank on a date which is more granular (e.g. YYYY-MM-DD instead of YYYY).

Create a new item

All controlled vocabularies are provided and mantained by the LCA Project editorial board, except for keywords and tags list, that may be extended accessing the New item special page. To create a new item:

  • leave the "language" field as it is ("English");
  • insert a label (mandatory);
  • insert a short description and/or aliases (optional);
  • click on "create";
  • a new page will appear: add a new statement in order to define the type of item, using the following elements:
  • the new item is now available for data entry, so it will show up in the autocompletion box.

Edit Correspondent's biography and bibliography

Each Correspondent item page is provided with a Mediawiki page, where you can add biography and bibliography.

To reach the Mediawiki page:

  • scroll down the Correspondent item page and look for the mediawiki page property;
  • click on the name of the Correspondent (e.g. Domenico_Guglielmini), in order to be redirected to the MediaWiki page;
  • by default, the Mediawiki page is structured in 3 sections, whose structure must not be modified:
    • biography;
    • the Correspondent and Leibniz;
    • bibliography.

To edit the Mediawiki page:

  • click on "edit" to use the advanced editor, or click to "edit source" if you prefer to use the wiki syntax (en fr).
  • click "enter" on your keyboard and fill in the text (selecting the "paragraph" type of heading).
  • use the advanced editor for formatting the text:
    • bold/italic;
    • links;
    • lists;
    • special characters;
    • don't change the type of heading nor insert images, footnotes, or tables.
  • click on "save".

To edit the Bibliography, one must pass through the Zotero Group bibliography (see the Guidelines). Do not modify the hook to Zotero in the Mediawiki page.