Outils pour utilisateurs
ontome:index
Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
ontome:index [2021/08/30 16:52] Vincent Alamercery |
ontome:index [2024/04/29 12:10] (Version actuelle) Vincent Alamercery Avertissement |
||
|---|---|---|---|
| Ligne 3: | Ligne 3: | ||
| **https://ontome.net/** | **https://ontome.net/** | ||
| - | For any feedback, bug report: https://github.com/Semantic-Data-for-Humanities/OntoME | + | For any feedback, bug report: https://github.com/orgs/geovistory/discussions |
| ======== User guide ======== | ======== User guide ======== | ||
| Work in progress! | Work in progress! | ||
| + | |||
| + | :!: We apologise for the fact that this guide is not up to date. If you need any help, please do not hesitate to contact us: | ||
| + | * GitHub discussion: https://github.com/orgs/geovistory/discussions | ||
| + | * Discord: https://discord.gg/dV74NzaN5g | ||
| + | * Email: contact at ontome.net | ||
| ======= What is OntoME? ======= | ======= What is OntoME? ======= | ||
| Ligne 84: | Ligne 89: | ||
| :!: You can only create classes, properties and relations or modify those that exist in the ongoing namespace managed by the project you have activated.\\ | :!: You can only create classes, properties and relations or modify those that exist in the ongoing namespace managed by the project you have activated.\\ | ||
| The current active project is displayed at the top right of the screen. | The current active project is displayed at the top right of the screen. | ||
| - | |||
| ==== My current namespaces tab ==== | ==== My current namespaces tab ==== | ||
| Ligne 133: | Ligne 137: | ||
| ===== Namespaces menu ===== | ===== Namespaces menu ===== | ||
| - | This menu directly displays the list of namespaces created or imported into OntoME. | + | This menu directly displays the list of root namespaces. |
| * Filter this list by using the Search box at the top right. For example, try entering "CIDOC". | * Filter this list by using the Search box at the top right. For example, try entering "CIDOC". | ||
| * Adjust the number of lines displayed by using the drop-down menu at the top left. | * Adjust the number of lines displayed by using the drop-down menu at the top left. | ||
| Ligne 342: | Ligne 346: | ||
| * Property: the property that is in relation. | * Property: the property that is in relation. | ||
| * Justification: the explanation of the relation. | * Justification: the explanation of the relation. | ||
| - | * Relation defined in: the namespace version in which the relation is set. | + | * Relation defined in: the namespace version in which the relation is defined. |
| * Click on the “information” icon to view the details and the comments posted for a relation. If you have created an account, you can also post a new comment or reply to an existing one. | * Click on the “information” icon to view the details and the comments posted for a relation. If you have created an account, you can also post a new comment or reply to an existing one. | ||
| - | * Click on a property to open the details. | + | * Click on a property label to open its details. |
| ==== Profiles tab ==== | ==== Profiles tab ==== | ||
| Ligne 350: | Ligne 354: | ||
| This tab lists the profiles using the property. | This tab lists the profiles using the property. | ||
| - | * Click on a profile to open the details. | + | * Click on a profile to open its details. |
| ==== Comments tab ==== | ==== Comments tab ==== | ||
| Ligne 360: | Ligne 364: | ||
| ==== What is a namespace? ==== | ==== What is a namespace? ==== | ||
| - | The concept of namespaces is at the core of OntoME. A namespace refers to a set of classes and properties designed to accommodate terms from the same domain. It ensures that all the identifiers within it have unique names so that they can be easily identified. | + | The concept of namespaces is at the core of OntoME. A namespace refers to a set of classes and properties designed to accommodate terms from the same domain. It ensures that all the identifiers within it have unique names so that they can be easily identified.\\ |
| + | In OntoME, a namespace includes a root namespace and versions. The root namespace does not contain any classes or properties, it serves to bring together its different versions in which classes and properties are defined, as well as relationships. | ||
| ==== Summary tab ==== | ==== Summary tab ==== | ||
| Ligne 370: | Ligne 375: | ||
| This tab gathers the information allowing the identification of the namespace:\\ | This tab gathers the information allowing the identification of the namespace:\\ | ||
| - | * Identification: this part displays the root namespace URI, its project of belonging and its status (ongoing, published or deprecated). | + | === Root namespace === |
| - | * Namespaces to which this ongoing namespace refers: the list of reference namespaces of the namespace. A reference namespace is a namespace referenced by another namespace, for instance in the case of a relationship (property, hierarchical relation, other type of relation...). So, if you want to create a relationship between classes and properties in your namespace A to classes and properties in another namespace B, you must first indicate here that the namespace B is a reference namespace to your space A. | + | |
| - | * Labels: the list of namespace labels. | + | * Identification: this part displays the namespace URI, its project of belonging and its prefix. |
| + | * Labels: the list of namespace labels in the different languages. There can only be one standard label per language. | ||
| + | |||
| + | === Versions === | ||
| + | |||
| + | * Identification: this part displays the root namespace URI, its project of belonging, its status (ongoing, published or deprecated) and its version information. | ||
| + | * Namespaces to which this ongoing namespace refers: the list of reference namespaces of the namespace. A reference namespace is a namespace referenced by another namespace, for instance in the case of a relationship (property, hierarchical relation, other type of relation...). If you want to create a relationship between classes and properties in your namespace A to classes and properties in another namespace B, you must first indicate here that the namespace B is a reference namespace to your space A. | ||
| + | * Labels: the list of namespace labels in the different languages. There can only be one standard label per language. | ||
| ==== Definition tab ==== | ==== Definition tab ==== | ||
| This tab gathers the information to define a namespace: | This tab gathers the information to define a namespace: | ||
| + | |||
| + | === Root namespace === | ||
| + | |||
| + | * Description: the list of texts presenting the root namespace in the different languages. A root namespace must have at least one description in any language. | ||
| + | * Additional notes: the list of additional notes in the different languages. These notes, which are not mandatory, are used to specify the description. | ||
| + | |||
| + | === Version === | ||
| * Description: the list of texts presenting the namespace in the different languages. A namespace must have at least one description in any language. | * Description: the list of texts presenting the namespace in the different languages. A namespace must have at least one description in any language. | ||
| - | * Contributors [only for ongoing/published namespaces]: contributors to the namespace. This is a free-text field. | + | * Contributors: contributors to the namespace. This is a free-text field. |
| * Additional notes: the list of additional notes in the different languages. These notes, which are not mandatory, are used to specify the description. | * Additional notes: the list of additional notes in the different languages. These notes, which are not mandatory, are used to specify the description. | ||
| Ligne 385: | Ligne 404: | ||
| * For a root namespace, this tab lists the versions of the namespace. The ongoing namespace row appears in green if you have edit rights. The column "Current namespace" indicates wether the namespace is selected in the tab "[[ontome:index#my_current_namespaces_tab|My current namespace]]" in your dashboard.\\ | * For a root namespace, this tab lists the versions of the namespace. The ongoing namespace row appears in green if you have edit rights. The column "Current namespace" indicates wether the namespace is selected in the tab "[[ontome:index#my_current_namespaces_tab|My current namespace]]" in your dashboard.\\ | ||
| - | * For an ongoing/published/deprecated namespace, this tab only displays the root namespace. | + | * For a version of a namespace, this tab only displays the root namespace. |
| ==== Classes tab ==== | ==== Classes tab ==== | ||
| - | Only for an ongoing/published/deprecated namespace. | + | Only for a version of a namespace. |
| This tab lists the classes in the namespace. For an ongoing namespace, the column "Validation status" indicates the class status (candidate/validation request/validated/denied). | This tab lists the classes in the namespace. For an ongoing namespace, the column "Validation status" indicates the class status (candidate/validation request/validated/denied). | ||
| Ligne 395: | Ligne 414: | ||
| ==== Properties tab ==== | ==== Properties tab ==== | ||
| - | Only for an ongoing/published/deprecated namespace. | + | Only for a version of a namespace. |
| This tab lists the properties in the namespace. For an ongoing namespace, the column "Validation status" indicates the class status (candidate/validation request/validated/denied). | This tab lists the properties in the namespace. For an ongoing namespace, the column "Validation status" indicates the class status (candidate/validation request/validated/denied). | ||
| Ligne 401: | Ligne 420: | ||
| ==== Relations tab ==== | ==== Relations tab ==== | ||
| - | Only for an ongoing/published/deprecated namespace. | + | Only for a version of a namespace. |
| This tab lists the relations in the namespace. You can filter the display by relations type. | This tab lists the relations in the namespace. You can filter the display by relations type. | ||
| Ligne 407: | Ligne 426: | ||
| ==== Graph tab ==== | ==== Graph tab ==== | ||
| - | Only for an ongoing/published/deprecated namespace. | + | Only for a version of a namespace. |
| This tab displays the namespace graph dynamically. | This tab displays the namespace graph dynamically. | ||
| Ligne 454: | Ligne 473: | ||
| If the project does not manage any namespaces, "//There is currently no namespace managed by this project//" is displayed and you can create a new one. | If the project does not manage any namespaces, "//There is currently no namespace managed by this project//" is displayed and you can create a new one. | ||
| - | === Create a new namespace === | ||
| - | Creating a namespace means creating a root namespace, which will host all versions of your namespace, and an ongoing namespace where you can create new classes and properties. | ||
| - | |||
| - | Click on the "Create" button to open the creation form:\\ | ||
| - | * Enter a label and select a language. English is the default language. You can only add one label when creating the namespace. You can add more labels once the namespace is created. Please note this is the label of your root namespace. Your ongoing namespace will be labelled as follows: "Root namespace label //ongoing//". | ||
| - | * External namespace: only tick this checkbox if your namespace already has its URI outside OntoME. Otherwise leave it unchecked. If you don't know what this means, leave this box unchecked. | ||
| - | * OntoME URI generator: fill this field to generate automatically the namespace URI. Eg. "my namespace" generates "https://ontome.net/ns/my-namespace". The URI is constructed by default from the label entered above. | ||
| - | * Description: type or copy/paste the namespace description in this field. Use only plain text format if you copy/paste a note to clean up all unnecessary tags. You can edit your text using the included rich text editor functions. Your description must be at least 40 characters long. Select the required language in the list below. English is the default language. You can only add one description when creating the namespace. You can add more description in other languages once the namespace is created. | ||
| - | * If you want to add a different description for the ongoing namespace, click on “Add a description for your ongoing namespace” below the form. You can do it later if needed. | ||
| ==== Profiles tab ==== | ==== Profiles tab ==== | ||
| Ligne 513: | Ligne 523: | ||
| [...] | [...] | ||
| + | ====== Create a new namespace ====== | ||
| + | |||
| + | Creating a namespace means creating a root namespace, which will host all versions of your namespace, and an ongoing namespace where you can create new classes and properties. | ||
| + | |||
| + | Click on the "Create" button to open the creation form:\\ | ||
| + | * Enter a label and select a language. English is the default language. You can only add one label when creating the namespace. You can add more labels once the namespace is created. Please note this is the label of your root namespace. Your ongoing namespace will be labelled as follows: "Root namespace label //ongoing//". | ||
| + | * External namespace: only tick this checkbox if your namespace already has its URI outside OntoME. Otherwise leave it unchecked. If you don't know what this means, leave this box unchecked. | ||
| + | * OntoME URI generator: fill this field to generate automatically the namespace URI. Eg. "my namespace" generates "https://ontome.net/ns/my-namespace". The URI is constructed by default from the label entered above. | ||
| + | * Description: type or copy/paste the namespace description in this field. Use only plain text format if you copy/paste a note to clean up all unnecessary tags. You can edit your text using the included rich text editor functions. Your description must be at least 40 characters long. Select the required language in the list below. English is the default language. You can only add one description when creating the namespace. You can add more description in other languages once the namespace is created. | ||
| + | * If you want to add a different description for the ongoing namespace, click on “Add a description for your ongoing namespace” below the form. You can do it later if needed. | ||
| + | |||
| + | ===== Adding external namespaces to which this namespace refers ===== | ||
| + | |||
| + | If you want your classes and properties to refer to classes or properties in other namespaces (in a hierarchy or equivalence sense), you can add the relevant external namespace or namespaces as follows: | ||
| + | * Activate the ongoing namespace card | ||
| + | * Activate the "Identification" tab | ||
| + | * Choose (Pick!) a reference namespace from the list of the available namespaces | ||
| + | * Choose the version you would use in your project and add it (use the "+" icon before the envisaged version) to your namespace | ||
| + | * You will see this namespace and the its dependencies (other namespaces it refers to) appear in the list of "Namespaces to which this ongoing namespace refers" | ||
| + | |||
| + | |||
| + | The classes and properties of all the activated namespaces will now appear in your project and you can use them to refer to them from your own classes and properties. | ||
| ====== Creating and aligning entities ====== | ====== Creating and aligning entities ====== | ||
ontome/index.1630335176.txt.gz · Dernière modification: 2021/08/30 16:52 par Vincent Alamercery
