The contributor centre is in English only.
Overall
The wiki is organised in these namespaces, or categories:
- fr:XXX, pages in French, with XXX being the page name in English
- en:XXX, pages in English (UK variant), with XXX being the page name in English
- de:XXX, pages in German, with XXX being the page name in English
- es:XXX, pages in Spanish with XXX being the page name in English
- it:XXX, pages in Italian, with XXX being the page name in English
- zh:XXX, pages in Chinese (simplifed), with XXX being the page name in English
- YYY, pages about contribution or development of Aseba and Thymio
When you include an image located in another page (often the case because of multiple languages), please use a relative URL, such as /en:stuff/thing.jpg, and not the complete URL beginning with https://www.thymio.org/. That way, the wiki source is more readable and will still work should we change the top-level URL.
Translation de-synchronisation
When updating a page or creating a new page, the translations will get desynchronised. There are two types of pages, normal ones and work-in-progress ones. When doing a non-trivial modification (content change instead of correction) to a normal page, please tag it as explained in the translation page. Work-in-progress pages do not require immediate translation and are listed here. If you are working on a page of this type, please tag it with inprogress.
Big files
The space on the Wiki is limited, so please be moderate when uploading images. Do not upload crazily hi-resolution images, in particular when they have been captured by a mobile phone or a small camera and are blurred when seen at 100%. Also, do not upload videos here: upload to YouTube and link. Finally, do not upload PDF with bitmap images in 2400 DPI; most PDF toolchains have an option to reduce file size, a setting of quality printer is certainly good enough (see here for Linux). Thank you for your understanding.
Aseba code snippets
Colourizing of code snippets in Aseba can now be applied easily, please read this page for details.
Thymio-related
On firmware upgrade
Some pages such as the tutorial or API might require update when a new firmware is released, due to changes in names. The correct way to proceed is to copy/paste the content of the page into a new temporary page ending with -vX where X is the firmware version, adapting this page to the new firmware, and upon release, renaming this page to the normal name just after having renamed the old page to -vY where Y was the previous release.
Example pages will be corrected to match the latest version of the firmware, without keeping previous versions.
General structure of the wiki
The wiki is structured in sections. In each language category, you will find the same high-level structure. The sections are displayed with the top bar:
- Thymio
- How to program
- Help
- Community
- Schools
- About us
Each section has a corresponding side bar in which there are the parent pages. These parent pages can have children. For example, the page https://www.thymio.org/en:visualprogramming is a parent page of the "How to program" section. It has one child: https://www.thymio.org/en:thymiovpl. When pages are created, they must be parented if they are not a parent page themselves.
In order to see all the pages, there connections, their parents, you can go on the sitemap page (one per language) where they are displayed following sections.
Detailled structure of each page
Every category (meaning languages or the contribute region) has a template page. In order to access it, type www.thymio.org/category:_template (with category being the name of the category, for example de, or en). These template should not be modified by everyone!
They are composed of different parts.
The languages selection
A first div block manages the languages on the top left of all pages:
[[div class="langues" ]]
* [[[en:{%%page_name%%}|ENG]]]
* [[span class="orange-link"]][[[fr:{%%page_name%%}|FRA]]][[/span]]
* [[[de:{%%page_name%%}|DEU]]]
* [[[it:{%%page_name%%}|ITA]]]
* [[[es:{%%page_name%%}|ESP]]]
* [[[zh:{%%page_name%%}|ZHO]]]
[[/div]]
As you see, there are links towards the same page but in another category (meaning another language). One of them has a special orange span attribute for it to be displayed as orange (it shows in which language category you are). The position and look of these links is managed thanks to the CSS of the wiki.
The selective top bar
The top bar depends on the language and on the section where you are on the wiki. Here is the beginning of the corresponding div block:
[[div class="menu_test"]]
[[iftags +_section_thymio]]
# [[span class="orange-link"]][[[fr:thymio|Thymio]]][[/span]]
# [[[fr:start|Programmation]]]
# [[[fr:thymiosupport|Aide]]]
# [[[fr:creations|Communauté]]]
# [[[fr:thymioschool|Écoles]]]
# [[[fr:thymiophilosophy|À propos]]]
[[/iftags]]
The look is also managed thanks to the CSS of the wiki. Then, we test the tags of the page, that's how the wiki knows where you are on the website. It looks the tags of the page you are on and, following the tag, displays one link in orange and the other ones in blue (the classical color of links).
We test each tag corresponding to the sections and if there is no tag on the page, we display everything in blue. That's why every page should have a section tag corresponding on the section they are in.
[[iftags -_section_thymio -_section_program -_section_help -_section_community -_section_schools -_section_about]]
# [[[fr:thymio|Thymio]]]
# [[[fr:start|Programmation]]]
# [[[fr:thymiosupport|Aide]]]
# [[[fr:creations|Communauté]]]
# [[[fr:thymioschool|Écoles]]]
# [[[fr:thymiophilosophy|À propos]]]
[[/iftags]]
Section tags
The section tags are listed here:
- _section_thymio
- _section_program
- _section_help
- _section_community
- _section_schools
- _section_about
Temporary Crowdfunding banner
There is a banner for the duration of the crowdfunding about Wireless Thymio that is just below the top bar. Here is the corresponding div. It will be deleted when the crowdfunding is over.
[[div class="banner_indiegogo_crowdfunding"]]
[[image /en:crowdfundingwireless/banner_crowdfunding.png width="1000px" link="*https://www.indiegogo.com/projects/wireless-thymio#/story"]]
[[/div]]
Selective side bar
The side bar is also selective following the section and the page you are on. Here too, we test the page tags to determine which section it is, allowing the display of the different links and which page this is (or what is the parent page) to display the correct link in orange.
Here is the beginning of the corresponding div:
[[div class="side-bar-menu"]]
[[iftags +_section_thymio +_page_thymio]]
[[span class="orange-link"]] [[[fr:thymio |Présentation]]] [[/span]]
[[[fr:news |News]]]
[[[fr:thymioexamples |Exemples]]]
[[[fr:thymiostarting |Premiers pas]]]
[[[fr:thymioaccessory |Accessoires]]]
[[[fr:thymiospecifications |Spécifications]]]
[[[fr:thymiobuy |Acheter]]]
[[[fr:mediakit |Médias]]]
[[/iftags]]
We can see that we test the section tag and the page tag. The page tags represent the pages which links are displayed on the side bar. For the pages that are the children of these parent pages (the pages which links are displayed on the side bar), we have to add the tag of the parent page.
An example: The page https://www.thymio.org/en:thymiovpl has for parent the page https://www.thymio.org/en:visualprogramming. These two pages have thus the same section and page tags: _section_program and _page_vpl.
Page tags
The page tags are listed here:
For the Thymio section
- _page_media
- _page_buy
- _page_specifications
- _page_accessory
- _page_starting
- _page_examples
- _page_news
- _page_thymio
For the Program section
- _page_start
- _page_vpl
- _page_aseba
- _page_update
- _page_robots
- _page_scratch
For the Help section
- _page_faq
- _page_search
For the Community section
- _page_creations
- _page_gallery
- _page_join
- _page_workshops
For the School section
- _page_schools
- _page_thool
- _page_training
- _page_schoolproject
For the About section
- _page_project
- _page_history
- _page_science
- _page_partners
In case there is no section tags, there is a div that displays every links of the side bar. This way, we are sure that the links are available even in case we forget to set the tag.
Content div
The last part of the template page is a content div that just displays the content of the page that is written through the Edit window of each page.
[[div class="content-pages"]]
%%content%%
[[/div]]