Tips & guidelines link
Jump to navigation
Jump to search
| Line 6: | Line 6: | ||
<!-- | <!-- | ||
On a first stage, edits or creation of your pages will be moderated. That means that once an administrator does not grant you with the role of "moderator", your edits or created pages will be not publicly visible until they are not approved by an administrator. Usually we expect that the contents have to be moderated until a registered user of a center of Italian language and culture shows a sufficient expertise (however this is achieved), or their set of pages reaches a certain degree of completeness: after that, all the affiliated users of that center will be assigned to the role of "moderator" and their edits will not be required of being approved anymore.--> | On a first stage, edits or creation of your pages will be moderated. That means that once an administrator does not grant you with the role of "moderator", your edits or created pages will be not publicly visible until they are not approved by an administrator. Usually we expect that the contents have to be moderated until a registered user of a center of Italian language and culture shows a sufficient expertise (however this is achieved), or their set of pages reaches a certain degree of completeness: after that, all the affiliated users of that center will be assigned to the role of "moderator" and their edits will not be required of being approved anymore.--> | ||
| − | *Privileges for editing and accessing pages throughout this platform are automatically handled. Typically, an account managed by a given center of Italian culture and language, can edit only the pages to the organization to which it is affiliated, and can create contents of public interest (like ([[Opportunities]], [[Reading suggestions]], [[Digital_library/Authors|open source books]]) as long as they are being | + | |
| − | * After signing up, your organization's page and sub-pages will be only accessible and editable by your staff and the administrators of {{CI inline logo}} and they will not yet be visible to the general audience. Once that your organization's page and its related pages will reach a sufficient level of completeness, they will be "enabled" by site-administrators and from that moment you, as organization, will be fully responsible of your pages, and any page that you create/edit/delete/move (within your "domain") will be not anymore moderated in any way. | + | *Privileges for editing and accessing pages throughout this platform are automatically handled. Typically, an account managed by a given center of Italian culture and language, can edit only the pages to the organization to which it is affiliated, and can create contents of public interest (like ([[Opportunities]], [[Reading suggestions]], [[Digital_library/Authors|open source books]]) as long as they are being created through a form (see picture 1, which displays a list visible in the side panel once logged-in) or as long they have been created using the same account. |
| − | * Any new additional page that you create is automatically set as "draft", that is, it has an unpublished state. Please check [[How_it_works/Page status & SEO|Page status & SEO]] to find out more about that feature: you can publish it as soon as is ready for that and even to set some meta information | + | *After signing up, your organization's page and sub-pages will be only accessible and editable by your staff and the administrators of {{CI inline logo}} and they will not yet be visible to the general audience. Once that your organization's page and its related pages will reach a sufficient level of completeness, they will be "enabled" by site-administrators and from that moment you, as organization, will be fully responsible of your pages, and any page that you create/edit/delete/move (within your "domain") will be not anymore moderated in any way. |
| − | * Once it has been created, the page of your organization contains a standard content model, that is a predefined set a sections (like Abstract, | + | *Any new additional page that you create is automatically set as "draft", that is, it has an unpublished state. Please check [[How_it_works/Page status & SEO|Page status & SEO]] to find out more about that feature: you can publish it as soon as is ready for that and even to set some meta information intended to search engines. |
| + | *Once it has been created, the page of your organization contains a standard content model, that is a predefined set a sections (like Abstract, Location, Gallery, Courses, etc.) that you can use to organize your contents. Of course they are so just as an example, and everything can be reorganized as you think it's better. However, contents/pages created using available forms (like [[Special:FormEdit/Post|Post]], [[Special:FormEdit/Article|Article]], and so on – check [[How_it_works/Forms_&_semantic_data|Forms & semantic data]] for all available kind of contents) will be saved at a specific path, like [your organization]/Articles/[article name] and the intermediate pages (in this case the page "Articles") will be created as well if not existing, and filled-in with with an [https://www.semantic-mediawiki.org/wiki/Help:Inline_queries ask query] to display a table of related contents. Of course this is done for convenience, but again contents created, either automatically or not, can be edited/rearranged in whatever way.<!-- Following we will add the possibility to include an arbitrary path --> | ||
<!-- | <!-- | ||
Upon sign-up, either that your main organization page will be created by our staff, or directly by you through the [[Special:FormEdit/Organization|appropriate form]], the form itself will create a predefined page model, so you can just fill-in the related sections, provided that your page and its sub-pages can be organized how do you think it is better: the model is to be considered just as a suggestion. Also, each time that you create a content through the related form (for instance an article, a "post", a language course, etc.) and that kind of content is being created for the first time, our platform will automatically create the related intermediate pages, with a list of relevant contents within them: again, these contents are created for convenience, and they can be used as a reference to organize your data in the proper way, but finally all that can be deleted or replaced with contents entirely created **comment start**a formatting entirely decided**comment end** by you. --> | Upon sign-up, either that your main organization page will be created by our staff, or directly by you through the [[Special:FormEdit/Organization|appropriate form]], the form itself will create a predefined page model, so you can just fill-in the related sections, provided that your page and its sub-pages can be organized how do you think it is better: the model is to be considered just as a suggestion. Also, each time that you create a content through the related form (for instance an article, a "post", a language course, etc.) and that kind of content is being created for the first time, our platform will automatically create the related intermediate pages, with a list of relevant contents within them: again, these contents are created for convenience, and they can be used as a reference to organize your data in the proper way, but finally all that can be deleted or replaced with contents entirely created **comment start**a formatting entirely decided**comment end** by you. --> | ||
| − | * | + | *In a first time, please create all your organization's contents either in English or Italian, inasmuch as the contents of this platform are not only addressed to your specific audience, but to other organizations as well (or in the first place), so they can be accessible by a common language, or "lingua franca" (English for the international community, and the national language for the related community. In a second time you can create pages also in the official language of your hosting country, and the internationalization for each of them (i.e., the page's language) will be either automatically determined by our platform, or manually inserted/adjusted by you, in order to show on the front-end pages in a language fitted to visitors. <br />Currently (December 2020) we have not yet implemented a method to handle internationalization of the main organization's page itself, inasmuch that should be done on the basis of specific feedback and requirements by organizations interested in that feature. |
<!-- | <!-- | ||
Create your contents in the language which usually you adopt dealing with your audience. That could be the official language of your hosting country, English (if not all the members of your team are fluent with the local language) or Italian itself. If the main language of your contents is not English or Italian, we require that you create an alternate page in English or Italian at least for the primary pages: otherwise, a generic audience will not be able to access those pages, given that the main purpose of this platform is precisely the interrelation among organizations and their audience.--> | Create your contents in the language which usually you adopt dealing with your audience. That could be the official language of your hosting country, English (if not all the members of your team are fluent with the local language) or Italian itself. If the main language of your contents is not English or Italian, we require that you create an alternate page in English or Italian at least for the primary pages: otherwise, a generic audience will not be able to access those pages, given that the main purpose of this platform is precisely the interrelation among organizations and their audience.--> | ||
| − | + | ===Interface overview=== | |
| − | === | ||
Revision as of 16:31, 27 December 2020
Once that you are provided with an account, and consequently with the privileges to edit your organization's page and sub-pages, just keep in mind the following principles and guidelines.
- Thus Mediawiki and wiki text are not precisely user-friendly (for a legitimate reason, that is precisely to encourage the creation of quality contents) we have provided this platform with all the tools to make the creation and editing of contents as easy and profitable as possible, in such a way that supposedly any member of a center of Italian culture and language with an average IT literacy, will be able to create and edit all the required information, and to address himself or herself either to the IT department of their organization or to the editorial staff of this platform, only to enhance the general structure of their pages, or to fix some issue.
- Privileges for editing and accessing pages throughout this platform are automatically handled. Typically, an account managed by a given center of Italian culture and language, can edit only the pages to the organization to which it is affiliated, and can create contents of public interest (like (Opportunities, Reading suggestions, open source books) as long as they are being created through a form (see picture 1, which displays a list visible in the side panel once logged-in) or as long they have been created using the same account.
- After signing up, your organization's page and sub-pages will be only accessible and editable by your staff and the administrators of Cultura italiana and they will not yet be visible to the general audience. Once that your organization's page and its related pages will reach a sufficient level of completeness, they will be "enabled" by site-administrators and from that moment you, as organization, will be fully responsible of your pages, and any page that you create/edit/delete/move (within your "domain") will be not anymore moderated in any way.
- Any new additional page that you create is automatically set as "draft", that is, it has an unpublished state. Please check Page status & SEO to find out more about that feature: you can publish it as soon as is ready for that and even to set some meta information intended to search engines.
- Once it has been created, the page of your organization contains a standard content model, that is a predefined set a sections (like Abstract, Location, Gallery, Courses, etc.) that you can use to organize your contents. Of course they are so just as an example, and everything can be reorganized as you think it's better. However, contents/pages created using available forms (like Post, Article, and so on – check Forms & semantic data for all available kind of contents) will be saved at a specific path, like [your organization]/Articles/[article name] and the intermediate pages (in this case the page "Articles") will be created as well if not existing, and filled-in with with an ask query to display a table of related contents. Of course this is done for convenience, but again contents created, either automatically or not, can be edited/rearranged in whatever way.
- In a first time, please create all your organization's contents either in English or Italian, inasmuch as the contents of this platform are not only addressed to your specific audience, but to other organizations as well (or in the first place), so they can be accessible by a common language, or "lingua franca" (English for the international community, and the national language for the related community. In a second time you can create pages also in the official language of your hosting country, and the internationalization for each of them (i.e., the page's language) will be either automatically determined by our platform, or manually inserted/adjusted by you, in order to show on the front-end pages in a language fitted to visitors.
Currently (December 2020) we have not yet implemented a method to handle internationalization of the main organization's page itself, inasmuch that should be done on the basis of specific feedback and requirements by organizations interested in that feature.
Interface overview
- Check the list of forms on the side panel on the left (picture 1) inasmuch as they inspire all the data structure that will take the information you will insert or create. Once followed one of the link, you will find a notice on top of the form (picture 2) with the path (that is the full title) of the page that will be created upon submitting the form: indeed, the form links on the navigation panel will create a new page, while to add a form to an existing page which does not already contain one, you have to navigate to that page, and then to use the menu on top after "View history" (picture 3). Usually the form does not create the content itself of the page (i.e., the article content, in this case) but it specifies the relevant semantic data of that page, so that it can be accurately cataloged and each of their data retrieved when needed.
- Other pieces of the interface to be noted before starting are the link "My organization" still in the left navigation panel (picture 4) and the link "Create or edit page" right below. (picture 5) The first (predictably) will bring you to the main page of your organization, and the second will bring you to a form where you can search for existing pages to edit, or to create new ones. The input takes into account the organization to which you are affiliated so that you have not to insert the complete path each time.
- Keep looking at the interface. On the top you will find the page-related menu (picture 6) with the button "Edit", through which you can access the Visual Editor of the article, and "Edit source", through which you can edit the wiki text of the article. Of course we expect that you use Visual editor at first since it's the most immediate and avoid you to deal with the intricacy (sometimes) of wiki text. However by accessing the source text of an example page allows you to just copy the elements you are interested in, and then editing them on your page.
(to be continued!)