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 Prochaine révision Les deux révisions suivantes | ||
|
ontome:index [2020/10/16 19:20] Vincent Alamercery |
ontome:index [2021/04/19 12:55] Vincent Alamercery [Namespaces tab] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ========= OntoME wiki ========= | ========= OntoME wiki ========= | ||
| - | **https://ontome.dataforhistory.org/** | + | **https://ontome.net/** |
| ======== User guide ======== | ======== User guide ======== | ||
| Ligne 25: | Ligne 25: | ||
| You can access other classes and properties from the namespaces menu but if you want to display them in your lists or create you own classes and properties you need to create an account. | You can access other classes and properties from the namespaces menu but if you want to display them in your lists or create you own classes and properties you need to create an account. | ||
| + | |||
| + | ===== How to? ===== | ||
| + | |||
| + | * [[ontome:index#create_an_account|Create an account]] | ||
| + | * [[ontome:index#create_a_new_project|Create a project]] | ||
| + | * Create a profile | ||
| + | * [[ontome:index#create_a_new_namespace|Create a namespace]] | ||
| + | * [[ontome:index#add_a_new_class|Add a class]] | ||
| + | * [[ontome:index#add_a_new_property|Add a property]] | ||
| ====== Manage your account ====== | ====== Manage your account ====== | ||
| Ligne 32: | Ligne 41: | ||
| * Click on the LOGIN button in the top right corner. | * Click on the LOGIN button in the top right corner. | ||
| * On the LOGIN page, click on "Register". | * On the LOGIN page, click on "Register". | ||
| - | * Fill the form and accept the terms and conditions of use. | + | * Fill the form and accept [[http://ontome.net/terms-of-service|the terms and conditions of use]]. |
| You are automatically logged in after creating your account. | You are automatically logged in after creating your account. | ||
| Ligne 59: | Ligne 68: | ||
| ==== My projects tab ==== | ==== My projects tab ==== | ||
| - | This tab lists the projects you have created or of which you are a member.\\ | + | This tab lists the [[ontome:index#what_is_a_project|projects]] you have created or of which you are a member.\\ |
| By default you're a member of the Public Project which displays the classes and properties of the CIDOC CRM and its extensions. | By default you're a member of the Public Project which displays the classes and properties of the CIDOC CRM and its extensions. | ||
| - | Here you can activate the project you want to work on. The current active project is displayed at the top right of the screen.\\ | + | === Create a new project === |
| - | Activating a project allows you to automatically select namespaces associated with that project. You can only create classes, properties and relations or modify those that exist in the ongoing namespace managed by the project you have activated. | + | |
| + | Click on "Create" to create a new project.\\ | ||
| + | Once a project is created, it is automatically activated. As no namespace is associated with this new project, the list of classes and properties and the class tree will appear empty.\\ | ||
| + | Manage the namespaces you wish to display in relation to your project in the [[ontome:index#my_current_namespaces_tab|My current namespaces]] tab. | ||
| + | |||
| + | === Activate a project === | ||
| + | |||
| + | Activating a project allows you to automatically select namespaces associated with that project. 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. | ||
| ==== My current namespaces tab ==== | ==== My current namespaces tab ==== | ||
| Ligne 186: | Ligne 204: | ||
| superclass without exceptions. | superclass without exceptions. | ||
| * Parent classes: the list of all superclasses of the class. | * Parent classes: the list of all superclasses of the class. | ||
| + | * Class: the parent class. | ||
| * Class namespace: the namespace of the parent class. | * Class namespace: the namespace of the parent class. | ||
| * Relation defined in: the namespace version in which the hierarchical relation is set. | * Relation defined in: the namespace version in which the hierarchical relation is set. | ||
| Ligne 197: | Ligne 216: | ||
| This tab lists the non-hierarchical relations of the class. | This tab lists the non-hierarchical relations of the class. | ||
| - | * Relation: the type of the relation. Two of them are currently offerd: "equivalent class" and "disjoint with". | + | * Relation: the type of the relation. Two of them are currently offered: "equivalent class" and "disjoint with". |
| * Class: the class that is in relation. | * Class: the class that is in relation. | ||
| * Justification: the explanation of the relation. | * Justification: the explanation of the relation. | ||
| Ligne 243: | Ligne 262: | ||
| ==== Namespaces tab ==== | ==== Namespaces tab ==== | ||
| + | This tab lists the namespace versions in which the property is defined. Different versions of the same property can only exist in different versions of a single root namespace. | ||
| + | * Click on a namespace to open the details. | ||
| + | * Filter this list by using the Search box at the top right. | ||
| + | * Adjust the number of lines displayed by using the drop-down menu at the top left. | ||
| + | ==== Hierarchy tab ==== | ||
| + | |||
| + | This tab lists the hierarchical relations of the property.\\ | ||
| + | A property can be a superproperty or a subproperty of another. A superproperty is a property that is a generalisation of one or more other properties, its subproperties. A subproperty is a property that is a specialisation of an another property, its superproperty. | ||
| + | |||
| + | * Parent properties: the list of all superproperties of the class. | ||
| + | * Domain: the domain class of the parent property, with its quantifiers. | ||
| + | * Property: the parent property. | ||
| + | * Range: the range class of the parent property, with its quantifiers. | ||
| + | * Property namespace: the namespace of the parent class. | ||
| + | * Relation defined in: the namespace version in which the hierarchical relation is set. | ||
| + | * Justification: the explanation of the hierarchical relation. | ||
| + | * Click on the “information” icon to view the details and the comments posted for a hierarchical relation. If you have created an account, you can also post a new comment or reply to an existing one. | ||
| + | * Ancestor properties: the list of all ancestor properties of the class, i.e. all superproperties of its superproperties, with the indication of the depth and the namespace of the ancestor property. | ||
| + | * Child and descendant properties: the list of all child and descendant properties, i.e. all subproperties of the properties and all subproperties of its subproperties, with the indication of the depth and the namespace of the child or descendant property. | ||
| + | * Click on a property to open the details. | ||
| + | |||
| + | ==== Relations tab ==== | ||
| + | |||
| + | This tab lists the non-hierarchical relations of the property. | ||
| + | |||
| + | * Relation: the type of the relation. Two of them are currently offered: “equivalent property” and “inverse of”. | ||
| + | * Property: the property that is in relation. | ||
| + | * Justification: the explanation of the relation. | ||
| + | * Relation defined in: the namespace version in which the relation is set. | ||
| + | * 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. | ||
| + | |||
| + | ==== Profiles tab ==== | ||
| + | |||
| + | This tab lists the profiles using the property. | ||
| + | |||
| + | * Click on a profile to open the details. | ||
| + | |||
| + | ==== Comments tab ==== | ||
| + | |||
| + | This tab lists the general comments posted on the property. If you have created an account, you can also post a new comment or reply to an existing one. | ||
| + | |||
| + | ===== Namespace ===== | ||
| + | |||
| + | ==== Summary tab ==== | ||
| + | |||
| + | This tab presents all the information about the namespace in a compact display. | ||
| + | |||
| + | ==== Identification tab ==== | ||
| + | |||
| + | This tab gathers the information allowing the identification of the namespace:\\ | ||
| [...] | [...] | ||
| + | |||
| + | ==== Definition tab ==== | ||
| + | |||
| + | * Identification: this part displays the namespace URI, its project of belonging and its status (ongoing, published or deprecated). | ||
| + | * 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...). | ||
| + | * Labels: the list of namespace labels. | ||
| ==== Hierarchy tab ==== | ==== Hierarchy tab ==== | ||
| Ligne 249: | Ligne 325: | ||
| [...] | [...] | ||
| - | ==== Relations tab ==== | + | ==== Classes tab ==== |
| [...] | [...] | ||
| - | ==== Profiles tab ==== | + | ==== Properties tab ==== |
| [...] | [...] | ||
| - | ==== Comments tab ==== | + | ==== Graph tab ==== |
| [...] | [...] | ||
| - | ===== Namespace ===== | + | ==== Comments tab ==== |
| [...] | [...] | ||
| ===== Project ===== | ===== Project ===== | ||
| + | |||
| + | ==== What is a project? ==== | ||
| + | |||
| + | A "project" is a set that will allow you to create a namespace, one or more profiles and associate users (members) with different rights.\\ | ||
| + | A project also allows you to configure the view and namespaces you wish to display in the application.\\ | ||
| + | You can be a member of several projects, but you can only activate one project at a time to delimit the namespaces you wish to work on in each case. | ||
| + | |||
| + | ==== Summary tab ==== | ||
| + | |||
| + | This tab presents all the information about the project in a compact display. | ||
| + | |||
| + | ==== Identification tab ==== | ||
| + | |||
| + | This tab gathers the information allowing the identification of the project:\\ | ||
| + | |||
| + | * Labels: the list of project labels in the different languages. There can only be one standard label per language. A project must have at least one standard label in any language. | ||
| + | |||
| + | ==== Definition tab ==== | ||
| + | |||
| + | This tab gathers the information to define a class:\\ | ||
| + | |||
| + | * Description: the list of texts presenting the project in the different languages. A project 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. | ||
| + | |||
| + | ==== Hierarchy tab ==== | ||
| + | |||
| + | This tab lists the hierarchical relations of the project.\\ | ||
| + | A master project may have one or more subprojects linked to it. A subproject cannot have a subproject in turn. | ||
| + | |||
| + | ==== Namespaces tab ==== | ||
| + | |||
| + | This tab lists the versions of the root namespace - if it exists - managed by the project. A project can only manage one root namespace.\\ | ||
| + | |||
| + | * Root namespace: link to the root namespace managed by the project. | ||
| + | * Versions of this namespace: the list of the different versions of the root namespace. At least the ongoing version. | ||
| + | |||
| + | 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 ==== | ||
| [...] | [...] | ||
| + | |||
| + | ==== Members tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| ===== Profile ===== | ===== Profile ===== | ||
| + | |||
| + | ==== What is a profile? ==== | ||
| [...] | [...] | ||
| + | ==== Summary tab ==== | ||
| + | |||
| + | This tab presents all the information about the profile in a compact display. | ||
| + | |||
| + | ==== Identification tab ==== | ||
| + | |||
| + | This tab gathers the information allowing the identification of the project:\\ | ||
| + | [...] | ||
| + | |||
| + | ==== Definition tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| + | ==== Namespaces tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| + | ==== Classes tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| + | ==== Properties tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| + | ==== Projects tab ==== | ||
| + | |||
| + | [...] | ||
| + | |||
| + | ==== Graph tab ==== | ||
| + | |||
| + | [...] | ||
| ====== Creating and aligning entities ====== | ====== Creating and aligning entities ====== | ||
| Ligne 278: | Ligne 446: | ||
| ===== Classes ===== | ===== Classes ===== | ||
| - | ==== Adding a new class ==== | + | ==== Add a new class ==== |
| After login, select the ongoing namespace to which you want to add a class. | After login, select the ongoing namespace to which you want to add a class. | ||
| Ligne 291: | Ligne 459: | ||
| Click on the "Save" button, your class is created! | Click on the "Save" button, your class is created! | ||
| - | ==== Editing an existing class ==== | + | ==== Edit an existing class ==== |
| Select a class and switch to edit mode by clicking the large green button on the upper right. | Select a class and switch to edit mode by clicking the large green button on the upper right. | ||
| Ligne 309: | Ligne 477: | ||
| ===== Properties ===== | ===== Properties ===== | ||
| - | ==== Adding a new property ==== | + | ==== Add a new property ==== |
| Check first the property you want to create does not already exist by searching the property list. | Check first the property you want to create does not already exist by searching the property list. | ||
| Ligne 328: | Ligne 496: | ||
| Click on the "Save" button, your property is created! | Click on the "Save" button, your property is created! | ||
| - | ==== Editing an existing property ==== | + | ==== Edit an existing property ==== |
| Select a property and switch to edit mode by clicking the large green button on the upper right. | Select a property and switch to edit mode by clicking the large green button on the upper right. | ||
| Ligne 346: | Ligne 514: | ||
| ===== Hierarchy ===== | ===== Hierarchy ===== | ||
| - | ==== Adding a new parent entity ==== | + | ==== Add a new parent entity ==== |
| Select the class/property to which you want to add an existing parent class/property. Note: you can only add a hierarchical association to a parent class/property that is part of a namespace managed by a project you're belonging to. | Select the class/property to which you want to add an existing parent class/property. Note: you can only add a hierarchical association to a parent class/property that is part of a namespace managed by a project you're belonging to. | ||
ontome/index.txt · Dernière modification: 2024/04/29 12:10 par Vincent Alamercery
