How it works

From Redazione
Revision as of 19:26, 27 December 2020 by Admin (talk | contribs)
Jump to navigation Jump to search

Introduction

Cultura italiana is a project aiming to create a network and to enhance cooperation among centers of Italian culture and language at abroad.

It is meant to be composed of at least 2 components: a back-end platform, represented by this Mediawiki site where authorized staff of centers of Italian culture and language can add or structure their organization information in a collaborative way and with attention for semantic data, and by a front-end platform, currently represented by this site, where the created contents can be viewed, searched and enjoyed by visitors in an attractive and modern way, including from mobile devices. (depending on what side you are reading this content, one of the links will point to itself)

The project has been initially implemented, since November 2019, within the frame of a European Solidarity Corps project (funded by European Union), is supported at the moment by the center of Italian culture and language in charge of the project which ensures its continuity over time (as well as that the requirements of the project are met) and foresees the inclusion of other institutions and organizations interested in taking part to the initiative.


Find out more...


Application form

The use of this platform is free for all Italian language and culture organizations world-wide.

Just fill-in the form below and we will contact you promptly in order to set up your account and to send you any useful information.
You will be immediately able to:

  • manage a wiki-like page of your organization plus an arbitrary number of sub-pages (like the following)
  • structure your data and information through a reach set of features allowing their visualization in a front-end like the following, where external visitors can find all the material created by organizations, divided by geographical area and kind of contents


Find out more...


Tips & guidelines

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.


Find out more...


Pages structure

After registration, you will be assigned with a specific "domain" corresponding to a page in the form

https://culturaitaliana.org/wiki/[organization name]


which can contain an arbitrary number of sub-pages within it. Here are some information of a sub-page from wikipedia:

Making a new [[link]] that begins with a / (slash) is the common way to start a subpage. The page to which this link points is considered "subordinate" to its host page, and is titled and linked as [[Parentpage/Subpage]]. It is possible to create a subpage of a subpage (or a sub-subpage). At the top of each subpage or sub-subpage, you can find a backlink (a.k.a. breadcrumb) to the higher levels of the page.

In short all the pages of your organization will be located under a dedicated address but at the same time they will reside in a shared environment, both to ensure collaborativeness among organizations, and because by this way you can enjoy, de facto, a fully maintained platform, where site's administrators (meant to be IT professionals) will advice you of any consistency of the wiki text (which entails some complexity) and will take care of extensions, templates, modules, semantic properties, and all other elements which guarantee a profitable and rich experience both from the side of visitors, and the organizations themselves.

By default, your organization's data structure will take this form:


Find out more...


Every page of your organization can be headed by your organization's banner. Just upload a banner image under your page named "Banner.jpg", so that it will appear in the following url:

https://culturaitaliana.org/wiki/[organization name]/Banner.jpg

(the banner is therefore expected to be in jpeg format) and the system will automatically display it on the top of each of your pages, including on the front end site !



Find out more...


Forms & semantic data

Forms & semantic data

Find out more...


Images upload & gallery

The Mediawiki version (1.35) powering this platform has been improved in order to support the storage of images and media files at a specific path, so that each organization can save all their images within a specific "folder" (under the main page itself of the organization, or whatever sub-page within it) and can easily retrieve them from the Visual editor's Media gallery, without mixing up their files with those of other organizations, and without file names conflicts or restrictions.


Find out more...


Page status & SEO

Since the Mediawiki site containing all the public pages of Cultura italiana is both a standalone site which can be autonomously visited, and a "content management system" (CMS) of a font-end allowing a more interactive and "streamlined" experience (as an example this is the "front-end" url of this page https://culturaitaliana.org/pages/How_it_works/Page_status_&_SEO and this is the "back-end" url https://culturaitaliana.org/wiki/How_it_works/Page_status_&_SEO, in the sense now explained), we have integrated the "back-end" with a way to define some property for each page, and specifically its publishing state, its language, and even some meta-data to be used for SEO ("search engine optimization") purposes.


Find out more...



Table of contents

The system automatically creates a Table of contents for each organization (as well as for any other set of pages which includes a TOC template on top of it) with the tree of all its sub-pages, at a location like the following:

https://culturaitaliana.org/wiki/[organization name]/Table of contents

The Table of contents (which can contain an arbitrary number of nested sub-pages) can be interactively edited through the related form (pages can be shown/hidden and rearranged) and is used as a reference to display the organization's pages (which could be also called "site") on the front-end, in the desired order, with only the desired pages, and in a way that they can be easily navigated, both through previous/next buttons below each page, and through a side navigation panel.

Currently (November 2020) the system is designed in such a way that a TOC can be put within any set of pages intended to be displayed on any front-end, and is not limited to the pages of organizations themselves. We are using such feature, for instance, to populate a directory of authors and open-source books, currently using a general TOC, but as soon as the number of authors grow, the TOC will be split simply creating a TOC on top of each author's page and then programmatically recomposed if a data-consumer wants to display all the authors and all the works of them in a single-page application: which should be discouraged both because writers tend to be prolific, once they reached a perfect command over the language of their mind, and, I would say, even before, to achieve that level – and because authors are expected to be different each other, to be such.


Find out more...


Front-end features

The front-end side of this wiki (a streamlined single-page-application allowing an instantaneous access to set of pages) is automatically created and updated as you create, edit, move or delete pages on the back-end, and it includes the following features:

  • Server side rendering
  • Navigable table of contents
  • Dynamic components
  • Offline navigation
  • Breadcrumbs and navigation between pages
  • Hyphenation
  • Filtering of contents in multiple languages
  • email widget


Find out more...


Multiple choice questions

"Multiple choice questions" are a way to implement a "reading comprehension test" to determine that the text served has been actually read, and in this sense the solution exceeds the requirements inasmuch as a read text (of a certain value) typically is not fully understood, but just, "understood to some degree", with reference to the intellectual contents of the reader in that specific time. On the other side, we simply couldn't rely on the amount of scroll as a meaningful indicator that the text was read "to some degree", and for this reason, in the absence of a scan of mind miniaturized in the user's device (which hypothetically might measure precisely the portions of text actually read, and the kind of comprehension for each of them) we opted for "Multiple choice questions" as an appreciable compromise, given that you might equally go through the text of which to provide proof of understanding, quite chaotically and instructing yourself to just recognizing the elements useful for passing the test: so that, in this case, the solution would not exceed the requirements and would appear to be perfectly adequate.

Currently (November 2020) a "Multiple choice questions" test is implemented as a parser function in the following form:

{{#CI_multiple_choice_questions:

At what time the family members gather together ?
- 20
- 21
+ 17
- 19 

| What does"reumi" mean ?
- dialectal variation for "remi"
- a typo
- a piece of clothing in vogue at that time
+ designation of diseases or disorders in the rheumatic area
}}


which, on the front-end, will produce this result.


Find out more...



Templates

Templates are a way to insert elements commonly used among your pages by reference, and they are usually invoked with one or more parameters which will be wrapped or transformed by the template in various ways. Besides all the Wikipedia's or Mediawiki's templates which can be used or imported if missing, here are some additional templates specifically created for this platform. To use them, go to "Edit source" in the top menu, and insert the wiki text as shown below.


text highlight

{{CI text highlight| text to highlight }}

produces:

text to highlight


Find out more...


Private WIKIs

Besides the two main components composing this platform (the back-end part represented by this wiki, and the front-end for the navigation among contents within the scope of a single-page-application) a third component completing its design is represented by an arbitrary number of private WIKIs where to store all reserved information and to make them conditionally available on the front-end, for instance to students accessing their own data or the digital representation of their classes, to readers accessing some paid content, and so on: through the combination of a streamlined interface as client, a collaborative wiki for contents intended to the public domain, and an arbitrary number of private wikis managed by the respective owners or by a data controller, every requirement conceivable within the frame of IT, information technology, may be potentially met.

The overall structure of this platform therefore is expected to be composed by a public wiki at this address (1)

https://culturaitaliana.org/wiki


Find out more...


Advanced use

Magic words & parser functions

APIs


Join team

If you would like to participate to enrich the content of this platform for creating an unique eco-system of Italian culture and language, fill in this form and we will be happy to discuss the kind of contribution you might bring with you!


Find out more...



Technology we use

Here is a list of the tools we use to make this platform work. Of course each of them depends in turn by other tools (for instance Quasar Framework depends on Vue.js, and Vue.js is in turn composed by several components, like the router and vuex, a "state management pattern"), however, given a set even arbitrary of the most prominent tools we use, the reader might explore on his or her own both in extension and in depth the vast areas not covered by the following table.


Find out more...


Logically related questions (L.R.Q.)

(another way of indicating "frequently asked questions" which have not yet been asked)


Why Mediawiki rather than Wordpress ?
Why a platform representing the Italian culture is conceived in English ?
How the front-end counterpart of this site is created or updated?
Why Mediawiki rather than Wordpress ? (again)