Wiki Clubelek - Contributions [fr]

MediaWiki:Categorylockdown-error

2024-06-25T13:37:10Z

Antoine.rochebois :

<big><big><big>Il faut être connecté pour lire cette page.
'''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion&redirectto= cliquez ici !]'''</big></big></big>

Cette page est restreinte aux groupes d’utilisateurs suivants : $1

Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail.

MediaWiki:Categorylockdown-error

2024-06-25T13:34:48Z

Antoine.rochebois :

<big><big><big>Il faut être connecté pour lire cette page.
'''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion&redirectto={{urlencode:{{FULLPAGENAME}}|QUERY}} cliquez ici !]'''</big></big></big>

$2
$3
$4

Cette page est restreinte aux groupes d’utilisateurs suivants : $1

Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail.

MediaWiki:Categorylockdown-error

2024-06-25T13:18:14Z

Antoine.rochebois :

<big><big><big>Il faut être connecté pour lire cette page.
'''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion&redirectto={{urlencode:{{FULLPAGENAME}}|QUERY}} cliquez ici !]'''</big></big></big>

Cette page est restreinte aux groupes d’utilisateurs suivants : $1

Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail.

MediaWiki:Categorylockdown-error

2024-06-25T13:17:09Z

Antoine.rochebois :

<big><big><big>Il faut être connecté pour lire cette page.
'''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion&redirectto={{urlencode:FULLPAGENAME|QUERY}} cliquez ici !]'''</big></big></big>

Cette page est restreinte aux groupes d’utilisateurs suivants : $1

Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail.

MediaWiki:Categorylockdown-error

2024-06-25T13:08:16Z

Antoine.rochebois : Page créée avec « <big><big><big>Il faut être connecté pour lire cette page. '''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion cliquez ici !]'''</big></big></big> Cette page est restreinte aux groupes d’utilisateurs suivants : $1 Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail. »

<big><big><big>Il faut être connecté pour lire cette page.
'''Pour vous connecter, [https://wiki.clubelek.fr/w/index.php?title=Sp%C3%A9cial:Connexion cliquez ici !]'''</big></big></big>

Cette page est restreinte aux groupes d’utilisateurs suivants : $1

Si vous êtes connecté et ne voyez toujours pas cette page, vous ne faites peut-être pas parti de ces groupes, contactez le bureau du Clubelek pour plus de détail.

Accueil

2024-06-23T23:11:49Z

Antoine.rochebois :

Ce Wiki contient des articles relatifs à l'organisation et à la vie du Clubelek (l'association de mécatronique de l'INSA Lyon), afin de vous aider à y faire vos premiers pas.

Il contient également (et surtout) des '''articles détaillant le fonctionnement, les spécifications et l'architecture de nos projets techniques'''. Ce site contient beaucoup de matériel issu du travail de nos membres et stocké ici pour que ce soit encore utile quand ils ne seront plus là: utilisation de logiciels, projets réalisés, ...

Toutes les pages sont accessibles en lecture pour qu'elles soient utiles à quiconque le souhaite, mais seulement les membres vérifiés du Clubelek peuvent les modifier.

== Liste des articles disponibles ==

<categorytree mode="pages" class="categories">Toutes les catégories</categorytree>
== Contribuer à ce Wiki ==

Vous pouvez contribuer à ce Wiki (si vous êtes membre du Clubelek) en vous connectant. Vous pourrez ainsi modifier les pages existantes.

'''<big>Pour créer de nouvelles pages, référez vous à [[Créer un nouvel article|ce guide.]]</big>'''

Utilisation des services informatiques du Clubelek

2024-06-20T13:21:20Z

Antoine.rochebois :

= Objectifs =

Les services informatiques du Club sont ensemble de logiciels et plateformes en ligne, hébergés par le club. Certains sont des logiciels libres que nous avons configuré et installé, d'autres sont des logiciels développés spécifiquement par et pour le Club.

'''L'objectif des services informatiques du club est de pouvoir acompagner la vie courante de l'association en fournissant des outils de communication, de collaboration, de partage et d'organisation.''' Ils sont également un passage obligatoire pour la périnisation des projets (documentation, archives).

= Fonctionnement général =

{{Note|text=Cette page Wiki vise à donner une description de chaque outil. Pour un tutoriel détaillé sur chaque service, référez vous aux guides disponible sur 3615 Clubelek ;)}}

== 3615 Clubelek, à mettre dans vos favoris ! ==

'''[https://3615.clubelek.fr 3615 Clubelek] est le portail d'accès aux services du Clubelek.''' Il permet de se rediriger facilement vers chacun des services détaillés ci-dessous.

== Choisissez l'outil adapté à votre besoin ;) ==

== Comptes et authentification centralisée ==

Le Clubelek utilise [https://login.clubelek.fr Keycloak] comme gestionnaire d'authentification centralisée. Cette solution permet d'avoir un seul compte pour tous les services compatibles. Ce service permet également d'ajouter les utilisateurs à différents groupes (bureau, pôles, etc) afin de leur associer des droits et accès. Ce paramètrage des applications est assuré par les sysadmins du Clubelek.

'''Le compte Clubelek est automatiquement créé lorsque le bureau valide une primo-adhésion depuis l'intranet.''' Un mail est alors envoyé au membre pour qu'il puisse initialiser son mot de passe.

'''Le mot de passe et le mail sont modifiables depuis [https://login.clubelek.fr l'interface Keycloak] ou depuis le menu "Mon compte" de l'intranet.'''

<blockquote>Pour les membres du bureau ou les admins, il est possible d'accéder à [https://login.clubelek.fr/auth/admin/master/console/ l'interface d'administration] pour modifier les comptes, les groupes, les applications, etc. La documentation officielle Keycloak est assez fournie, il est cependant très vivement conseillé de passer par un sysadmin pour utiliser cette interface. Pour les opérations régulières opérées par le bureau, des outils agissant directement sur Keycloak sont proposés dans l'intranet. {.is-info}
</blockquote>
== Les mailing lists INSA ==

Les mailing lists du Clubelek utilisent le service de listes de diffusion de l'INSA. Un lien a été configuré entre l'intranet et ce service afin de pouvoir synchroniser automatiquement ces mailings avec les groupes du système d'authentification centralisé.

Les correspondances groupe/mailing list sont les suivantes :

* clubelek@insa-lyon.fr ou clubelek@listes.insa-lyon.fr : bureau
* clubelek-actifs@listes.insa-lyon.fr : membres-clubelek
* clubelek-anciens@listes.insa-lyon.fr : anciens
* clubelek-coupe@listes.insa-lyon.fr : Pôle coupe
* clubelek.drsstc.asso@listes.insa-lyon.fr : Pôle Electrotech'
* clubelek-formations@listes.insa-lyon.fr : NEANT
* clubelek-stages@listes.insa-lyon.fr : NEANT
* clubelek.handiresps.asso@listes.insa-lyon.fr : NEANT

Les listes ont des règles de diffusion différentes en fonction de leur nature (par exemple, seuls les mails approuvés par le bureau peuvent être envoyé à la liste des membres)

= Les services principaux =

Les services principaux sont '''les outils qui servent au quotidien du Clubelek''' et dont l'usage est vivement recommandé pour les projets perso et <ins>'''imposé'''</ins> (dans la mesure du raisonnable) pour les projets internes au club.

== L'[https://intranet.clubelek.fr intranet] : vie du club ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
L'intranet est une plateforme spécifiquement développée par le Clubelek et pour le Clubelek. '''C'est ce service qu'il faudra utiliser pour tout ce qui touche à la vie de l'asso''' :

* Adhésion
* Suivi de vos to-do lists de formations/compétences
* Consultation de la liste des membres formés sur les compétences sensibles
* Gestion de votre compte (mot de passe/mail, lier la carte étudiante)
* Calendrier de l'association (réunions, événements)
* Gestion des permanences au local
* Accès aux comptes rendus de réunions
* Gestion de la trésorerie et des achats (affichage des budgets publics, notes de frais, achats au club, demandes d'achats)
* Gestion des emprunts de matériel

L'intranet s'adapte aux droits de votre compte : si vous êtes répertorié comme ayant les accès au local, vous pourrez créer des crénaux de permanence et vous y inscrire, si vous êtes au bureau vous pourrez gérer les adhésions, etc.

'''Certains services requierent d'être connecté''' (accès aux CR des réunions, outils de trésorerie, etc).

'''Beaucoup de services de l'intranet ne sont pas accessibles aux membres par défaut :'''

* Le carnet de contact du Club (bureau et responsables de pôles)
* Suivi et modification des compétences (bureau)
* La gestion et le suivi des adhésions (bureau)
* La gestion de la trésorerie (bureau)
* La gestion des droits et des groupes d'utilisateurs (bureau)
* L'édition du catalogue d'emprunts et d'achats (bureau)
* La création d'évenements et de réunions (resp'pôles et bureau)
* L'inscription et la création de permanences (membres avec accès local)
* L'édition des listes de demandes d'achats des pôles (resp' pôles)
* L'édition du budget prévisionnel des pôles (resp' pôles)

== [https://chat.clubelek.fr Zulip] : le chat officiel ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' Il est cependant possible de créer un compte indépendant sur Zulip (utile pour les externes). {.is-success}
</blockquote>
Zulip est le chat du Clubelek. '''Il est impératif de savoir l'utiliser puisqu'il constitue, avec les mails, le moyen de communication officiel du Clubelek.''' Le chat est disponible depuis un navigateur mais également via des applications mobiles et PC. '''Nous recommandons vivement l'installation de l'application mobile.'''

== [https://cloud.clubelek.fr Nextcloud] : le partage et l'archivages de fichiers ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Sur Nexcloud, vous trouverez toutes les ressources des projets et de l'administration ainsi que les archives du Club. Les différents groupes auxquels vous pourrez apartenir vous donneront des droits d'accès et/ou d'écriture dans différents dossiers.

'''L'archivage des ressources utilisées pour un projet interne au club est obligatoire sur NextCloud ou Gitlab.'''

Le Nextcloud du club est organisé de la façon suivante :

* '''Projets hors pôles :''' ressources (modèles 3D, images, documents, etc) liés aux projets internes au Clubelek ou interassociatifs
* '''Projets des pôles :''' ressources (modèles 3D, images, documents, etc) liés aux projets des pôles du Clubelek
* '''Photos et vidéos :''' Toutes les photos et vidéos non techniques/administratives : archives de la vie du Club, des évenements, etc
* '''Communication et templates :''' ressources graphiques du Clubelek, template de formulaires ou d'affiches, vidéos de communication instituionnelles, campagnes d'affichages, etc
* '''Bureau et administratif :''' documentation liée à la vie administrative du Club et à l'action du bureau (demandes de subventions, BMF, etc)

== [https://gitlab.clubelek.fr Gitlab] : la forge logicielle ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
'''Gitlab est la forge logicielle du Clubelek.''' Reposant sur le système de versionnage Git. C'est sur cette plateforme que vous pouvez collaborer autour de projets de code ou autres fichiers versionnables (e.g. simulations LTSpice et PCB KiCAD). Les différents projets et groupes (ensembles de projets) sont liés aux équipes dont vous faites partie.

Certains projets ont un déploiement automatisé depuis Gitlab (atelier Apollo, site du Club) via des mécanismes de CI/CD.

== [https://wiki.clubelek.fr/ Wiki.js] : la documentation ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Wiki.js est le service que vous êtes actuellement en train de consulter. C'est ici que vous trouverez toute la documentation indispensable aux projets du Club ainsi que des articles liés à la vie du Club ou même de culture technique.

N'hésitez pas à créer et mettre à jour les pages existantes !

= Les services secondaires =

== CodiMD : prise de notes collaborative ==

<blockquote>'''''Ce service N'EST PAS intégré avec l'authentification centralisée.''''' L'authentification n'est pas nécessaire pour accéder au service. {.is-warning}
</blockquote>
CodiMD est le logiciel de prise de notes collaboratif utilisé au Clubelek. Les comptes rendus de réunion sont pris sur cette plateforme. La prise de note se fait au format Markdown, un format texte très simple de compréhension et très lisible permettant une mise en forme du texte. Une liste des syntaxes est disponible [https://www.markdownguide.org/cheat-sheet/ ici].

La création d'une compte rendu se fait, selon les bonnes pratiques, en cochant la case "générer un compte rendu CodiMD" lors de la création de l'événement correspondant sur le calendrier de l'intranet.

La liste des comptes rendus générés de cette façon est disponible, pour tout membre connecté, soit dans la fiche de chaque événement sur le calendrier de l'intranet, soit sur la plage dédiée de l'intranet.

== [https://tasks.clubelek.fr/ Wekan] : organisation des tâches ==[[Catégorie:Vie de l'association]]
2

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Wekan est un espace de collaboration similaire à Trello (tableau Kanban), permettant l'organisation du travail et sa décomposition en diverses tâches qui peuvent être assignées à des utilisateurs. Ces tâches, sous forme de "post-it", sont déplaçables de colonnes en colonnes. Cela permet de suivre efficacement l'avancement d'un projet complexe.

Cet outil d'organisation est mis à la disposition des équipes qui le souhaite mais son usage n'est en rien imposé.

== [https://passwords.clubelek.fr/ BitWarden] : gestion des mots de passe du bureau ==

<blockquote>'''''Ce service N'EST PAS intégré avec l'authentification centralisée.''''' BitWarden est destiné à l'usage exclusif du bureau et des sysadmins du Clubelek dans leurs gestions des mots de passe. {.is-warning}
</blockquote>
Le club dispose de son serveur compatible BitWarden, '''permettant le stockage et le partage sécurisé des mots de passe.''' La plateforme sert à stocker les mots de passe du bureau et des sysadmins.

Chaque utilisateur possède un compte ('''la création du compte doit être faite depuis l'interface d'administration''') et peut être ajouté à des organisations (bureau et/ou sysadmins) qui partagent des collections de mots de passe. L'extension pour navigateur, l'interface en ligne ou l'application mobile BitWarden peuvent ensuite être utilisées simplement pour modifier, consulter ou ajouter des mots de passe.

= Les services internes aux équipes =

== [https://tesla-player.clubelek.fr Tesla player] : contrôlez les bobines Tesla ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' L'accès à ce service est possible seulement aux membres du bureau et aux membres du pôle électrotech. {.is-success}
</blockquote>
Le Tesla Player est un outil dédié au pôle électrotechnique. Associé au Syntherrupter, il permet de controler musicalement (en mode orchestre) les bobines Tesla sans avoir à installer de logiciel ou de fichiers de configuration sur son ordinateur. Il a été développé en interne du Clubelek et est partagé à la communauté en opensource.

Le site permet d'associer des configurations du syntherrupteur à un fichier MIDI pour former des "morceaux". Chaque morceau peut être ajouté à une playlist ou joué directement sur les bobines (le site est capable de les controller quand l'adaptateur USB/MIDI est branché au PC)

Modèle:Note

2024-06-20T13:21:00Z

Antoine.rochebois : Page créée avec « <languages/> <onlyinclude>{{#if: {{{1|{{{content|{{{text|{{{demo|<noinclude>demo</noinclude>}}}}}}}}}}}} | <templatestyles src="Note/styles.css" /><div role="note" class="note note-{{#switch: {{{2|{{{type|}}}}}} |gotcha=error |warning=warn |notice=info |=info |#default={{{2|{{{type|}}}}}} }} {{#ifeq:{{{inline|}}}|1|note-inline}}">{{{1|{{{content|{{{text}}}}}}}}}</div> | File:OOjs UI icon lightbulb-yellow.svg|18px|alt=<translate><!--T:1... »

<languages/>
<onlyinclude>{{#if: {{{1|{{{content|{{{text|{{{demo|<noinclude>demo</noinclude>}}}}}}}}}}}} | <templatestyles src="Note/styles.css" /><div role="note" class="note note-{{#switch: {{{2|{{{type|}}}}}}
|gotcha=error
|warning=warn
|notice=info
|=info
|#default={{{2|{{{type|}}}}}}
}} {{#ifeq:{{{inline|}}}|1|note-inline}}">{{{1|{{{content|{{{text}}}}}}}}}</div>
| [[File:OOjs UI icon lightbulb-yellow.svg|18px|alt=<translate> Note</translate>|link=]] '''<translate> Note:</translate>''' }}</onlyinclude>
{{documentation|content=
<translate>
== Usage == 
</translate>
<pre>
{{Note|text=Foo}}
{{Note|type=info|text=Foo}}
{{Note|type=reminder|text=Foo}}
{{Note|type=reminder|text=Multiple lines of text}}
{{Note|type=warn|text=Foo}}
{{Note|type=error|text=Foo}}
{{Note}} <translate nowrap> Loose test</translate>

* Text {{Note|inline=1|text=Foo}}
</pre>
{{Note|text=Foo}}
{{Note|type=info|text=Foo}}
{{Note|type=reminder|text=Foo}}
{{Note|type=reminder|text=Multiple lines of text}}
{{Note|type=warn|text=Foo}}
{{Note|type=error|text=Foo}}
{{Note}} <translate> Loose test</translate>

* Text {{Note|inline=1|text=Foo}}

== Parameters ==

{{Note/doc}}

== See also ==
* {{tl|warn}}, shortcut for this template with <code>type=warning</code>.
* {{tl|mbox}}, and in particular the namespace-agnostic {{tl|ombox}}, which by default resembles a typical "info" template.

}}
[[Category:Templates{{#translation:}}|{{PAGENAME}}]]

Contrôle musical des bobines Tesla

2024-05-17T09:35:04Z

Antoine.rochebois :

Le Syntherrupter est un outil permettant de contrôler les bobines Telsa et de jouer des fichiers MIDI dessus.

Le projet a été créé par Max Zuidberg.

== Enveloppes ==

=== Principe ===
L'enveloppe est un moyen de modifier le son en sortie de Tesla en modulant les phases de montée et de descente d'une note.

=== Conversion instrument MIDI editor, enveloppe ===
{| class="wikitable"
|+
!PRG
!Linéaire
!Exponentielle
!Enveloppe
|-
|0
|Acoustic Grand Piano
|
|No envelope. Constant ontime (except for other effects like modulation).
|-
|1
|B.A. Piano
|Vibraphone
|Roughly like a piano. Attack peaks to 1 (= not exceeding the given ontime)
|-
|2
|E.G. Piano
|Marimba
|Sloooowwww rise, sloooww fall. Good for soft background, but too slow for shorter notes. Attack peaks to 1 (= not exceeding the given ontime)
|-
|3
|H.T. Piano
|Xylophone
|Like program 1, but with a small step, to make shorter notes more audible. Attack peaks to 1 (= not exceeding the given ontime)
|-
|4
|E. Piano 1
|Tubular Bells
|Twice as fast as program 1. Attack peaks to 1 (= not exceeding the given ontime)
|-
|5
|E. Piano 2
|Dulimer
|Forced Staccato. All notes are always short. Attack peaks to 1 (= not exceeding the given ontime)
|-
|6
|Harpsichord
|Drawbar Organ
|Forced Legato. All notes are hold for quite some time. Attack peaks to 1 (= not exceeding the given ontime)
|-
|7
|Clavinette
|Percussio Organ
|Like program 2, but with a faster release. Attack peaks to 1 (= not exceeding the given ontime)
|-
|8
|Celesta
|Rock Organ
|Roughly like a piano. Attack peaks to 2 (= doublingt he given ontime for a few milliseconds)
|-
|9
|Glockenspeil
|Church Organ
|Forced Staccato with slight sustain. Attack peaks to 3 (= tripling the given ontime for a few milliseconds)
|-
|10
|Music Box
|Reed Organ
|My best approximation of an actual piano. Attack peaks to 2 (= doubling the given ontime for a few milliseconds)
|}
[[Catégorie:Bobines Tesla]]

Utilisation des services informatiques du Clubelek

2024-04-16T09:29:22Z

Antoine.rochebois :

= Objectifs =

Les services informatiques du Club sont ensemble de logiciels et plateformes en ligne, hébergés par le club. Certains sont des logiciels libres que nous avons configuré et installé, d'autres sont des logiciels développés spécifiquement par et pour le Club.

'''L'objectif des services informatiques du club est de pouvoir acompagner la vie courante de l'association en fournissant des outils de communication, de collaboration, de partage et d'organisation.''' Ils sont également un passage obligatoire pour la périnisation des projets (documentation, archives).

= Fonctionnement général =

<blockquote>'''Cette page Wiki vise à donner une description de chaque outil. Pour un tutoriel détaillé sur chaque service, référez vous aux guides disponible sur 3615 Clubelek ;)''' {.is-info}
</blockquote>
== 3615 Clubelek, à mettre dans vos favoris ! ==

'''[https://3615.clubelek.fr 3615 Clubelek] est le portail d'accès aux services du Clubelek.''' Il permet de se rediriger facilement vers chacun des services détaillés ci-dessous.

== Choisissez l'outil adapté à votre besoin ;) ==

== Comptes et authentification centralisée ==

Le Clubelek utilise [https://login.clubelek.fr Keycloak] comme gestionnaire d'authentification centralisée. Cette solution permet d'avoir un seul compte pour tous les services compatibles. Ce service permet également d'ajouter les utilisateurs à différents groupes (bureau, pôles, etc) afin de leur associer des droits et accès. Ce paramètrage des applications est assuré par les sysadmins du Clubelek.

'''Le compte Clubelek est automatiquement créé lorsque le bureau valide une primo-adhésion depuis l'intranet.''' Un mail est alors envoyé au membre pour qu'il puisse initialiser son mot de passe.

'''Le mot de passe et le mail sont modifiables depuis [https://login.clubelek.fr l'interface Keycloak] ou depuis le menu "Mon compte" de l'intranet.'''

<blockquote>Pour les membres du bureau ou les admins, il est possible d'accéder à [https://login.clubelek.fr/auth/admin/master/console/ l'interface d'administration] pour modifier les comptes, les groupes, les applications, etc. La documentation officielle Keycloak est assez fournie, il est cependant très vivement conseillé de passer par un sysadmin pour utiliser cette interface. Pour les opérations régulières opérées par le bureau, des outils agissant directement sur Keycloak sont proposés dans l'intranet. {.is-info}
</blockquote>
== Les mailing lists INSA ==

Les mailing lists du Clubelek utilisent le service de listes de diffusion de l'INSA. Un lien a été configuré entre l'intranet et ce service afin de pouvoir synchroniser automatiquement ces mailings avec les groupes du système d'authentification centralisé.

Les correspondances groupe/mailing list sont les suivantes :

* clubelek@insa-lyon.fr ou clubelek@listes.insa-lyon.fr : bureau
* clubelek-actifs@listes.insa-lyon.fr : membres-clubelek
* clubelek-anciens@listes.insa-lyon.fr : anciens
* clubelek-coupe@listes.insa-lyon.fr : Pôle coupe
* clubelek.drsstc.asso@listes.insa-lyon.fr : Pôle Electrotech'
* clubelek-formations@listes.insa-lyon.fr : NEANT
* clubelek-stages@listes.insa-lyon.fr : NEANT
* clubelek.handiresps.asso@listes.insa-lyon.fr : NEANT

Les listes ont des règles de diffusion différentes en fonction de leur nature (par exemple, seuls les mails approuvés par le bureau peuvent être envoyé à la liste des membres)

= Les services principaux =

Les services principaux sont '''les outils qui servent au quotidien du Clubelek''' et dont l'usage est vivement recommandé pour les projets perso et <ins>'''imposé'''</ins> (dans la mesure du raisonnable) pour les projets internes au club.

== L'[https://intranet.clubelek.fr intranet] : vie du club ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
L'intranet est une plateforme spécifiquement développée par le Clubelek et pour le Clubelek. '''C'est ce service qu'il faudra utiliser pour tout ce qui touche à la vie de l'asso''' :

* Adhésion
* Suivi de vos to-do lists de formations/compétences
* Consultation de la liste des membres formés sur les compétences sensibles
* Gestion de votre compte (mot de passe/mail, lier la carte étudiante)
* Calendrier de l'association (réunions, événements)
* Gestion des permanences au local
* Accès aux comptes rendus de réunions
* Gestion de la trésorerie et des achats (affichage des budgets publics, notes de frais, achats au club, demandes d'achats)
* Gestion des emprunts de matériel

L'intranet s'adapte aux droits de votre compte : si vous êtes répertorié comme ayant les accès au local, vous pourrez créer des crénaux de permanence et vous y inscrire, si vous êtes au bureau vous pourrez gérer les adhésions, etc.

'''Certains services requierent d'être connecté''' (accès aux CR des réunions, outils de trésorerie, etc).

'''Beaucoup de services de l'intranet ne sont pas accessibles aux membres par défaut :'''

* Le carnet de contact du Club (bureau et responsables de pôles)
* Suivi et modification des compétences (bureau)
* La gestion et le suivi des adhésions (bureau)
* La gestion de la trésorerie (bureau)
* La gestion des droits et des groupes d'utilisateurs (bureau)
* L'édition du catalogue d'emprunts et d'achats (bureau)
* La création d'évenements et de réunions (resp'pôles et bureau)
* L'inscription et la création de permanences (membres avec accès local)
* L'édition des listes de demandes d'achats des pôles (resp' pôles)
* L'édition du budget prévisionnel des pôles (resp' pôles)

== [https://chat.clubelek.fr Zulip] : le chat officiel ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' Il est cependant possible de créer un compte indépendant sur Zulip (utile pour les externes). {.is-success}
</blockquote>
Zulip est le chat du Clubelek. '''Il est impératif de savoir l'utiliser puisqu'il constitue, avec les mails, le moyen de communication officiel du Clubelek.''' Le chat est disponible depuis un navigateur mais également via des applications mobiles et PC. '''Nous recommandons vivement l'installation de l'application mobile.'''

== [https://cloud.clubelek.fr Nextcloud] : le partage et l'archivages de fichiers ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Sur Nexcloud, vous trouverez toutes les ressources des projets et de l'administration ainsi que les archives du Club. Les différents groupes auxquels vous pourrez apartenir vous donneront des droits d'accès et/ou d'écriture dans différents dossiers.

'''L'archivage des ressources utilisées pour un projet interne au club est obligatoire sur NextCloud ou Gitlab.'''

Le Nextcloud du club est organisé de la façon suivante :

* '''Projets hors pôles :''' ressources (modèles 3D, images, documents, etc) liés aux projets internes au Clubelek ou interassociatifs
* '''Projets des pôles :''' ressources (modèles 3D, images, documents, etc) liés aux projets des pôles du Clubelek
* '''Photos et vidéos :''' Toutes les photos et vidéos non techniques/administratives : archives de la vie du Club, des évenements, etc
* '''Communication et templates :''' ressources graphiques du Clubelek, template de formulaires ou d'affiches, vidéos de communication instituionnelles, campagnes d'affichages, etc
* '''Bureau et administratif :''' documentation liée à la vie administrative du Club et à l'action du bureau (demandes de subventions, BMF, etc)

== [https://gitlab.clubelek.fr Gitlab] : la forge logicielle ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
'''Gitlab est la forge logicielle du Clubelek.''' Reposant sur le système de versionnage Git. C'est sur cette plateforme que vous pouvez collaborer autour de projets de code ou autres fichiers versionnables (e.g. simulations LTSpice et PCB KiCAD). Les différents projets et groupes (ensembles de projets) sont liés aux équipes dont vous faites partie.

Certains projets ont un déploiement automatisé depuis Gitlab (atelier Apollo, site du Club) via des mécanismes de CI/CD.

== [https://wiki.clubelek.fr/ Wiki.js] : la documentation ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Wiki.js est le service que vous êtes actuellement en train de consulter. C'est ici que vous trouverez toute la documentation indispensable aux projets du Club ainsi que des articles liés à la vie du Club ou même de culture technique.

N'hésitez pas à créer et mettre à jour les pages existantes !

= Les services secondaires =

== CodiMD : prise de notes collaborative ==

<blockquote>'''''Ce service N'EST PAS intégré avec l'authentification centralisée.''''' L'authentification n'est pas nécessaire pour accéder au service. {.is-warning}
</blockquote>
CodiMD est le logiciel de prise de notes collaboratif utilisé au Clubelek. Les comptes rendus de réunion sont pris sur cette plateforme. La prise de note se fait au format Markdown, un format texte très simple de compréhension et très lisible permettant une mise en forme du texte. Une liste des syntaxes est disponible [https://www.markdownguide.org/cheat-sheet/ ici].

La création d'une compte rendu se fait, selon les bonnes pratiques, en cochant la case "générer un compte rendu CodiMD" lors de la création de l'événement correspondant sur le calendrier de l'intranet.

La liste des comptes rendus générés de cette façon est disponible, pour tout membre connecté, soit dans la fiche de chaque événement sur le calendrier de l'intranet, soit sur la plage dédiée de l'intranet.

== [https://tasks.clubelek.fr/ Wekan] : organisation des tâches ==[[Catégorie:Vie de l'association]]
2

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' {.is-success}
</blockquote>
Wekan est un espace de collaboration similaire à Trello (tableau Kanban), permettant l'organisation du travail et sa décomposition en diverses tâches qui peuvent être assignées à des utilisateurs. Ces tâches, sous forme de "post-it", sont déplaçables de colonnes en colonnes. Cela permet de suivre efficacement l'avancement d'un projet complexe.

Cet outil d'organisation est mis à la disposition des équipes qui le souhaite mais son usage n'est en rien imposé.

== [https://passwords.clubelek.fr/ BitWarden] : gestion des mots de passe du bureau ==

<blockquote>'''''Ce service N'EST PAS intégré avec l'authentification centralisée.''''' BitWarden est destiné à l'usage exclusif du bureau et des sysadmins du Clubelek dans leurs gestions des mots de passe. {.is-warning}
</blockquote>
Le club dispose de son serveur compatible BitWarden, '''permettant le stockage et le partage sécurisé des mots de passe.''' La plateforme sert à stocker les mots de passe du bureau et des sysadmins.

Chaque utilisateur possède un compte ('''la création du compte doit être faite depuis l'interface d'administration''') et peut être ajouté à des organisations (bureau et/ou sysadmins) qui partagent des collections de mots de passe. L'extension pour navigateur, l'interface en ligne ou l'application mobile BitWarden peuvent ensuite être utilisées simplement pour modifier, consulter ou ajouter des mots de passe.

= Les services internes aux équipes =

== [https://tesla-player.clubelek.fr Tesla player] : contrôlez les bobines Tesla ==

<blockquote>'''''Ce service est intégré avec l'authentification centralisée.''''' L'accès à ce service est possible seulement aux membres du bureau et aux membres du pôle électrotech. {.is-success}
</blockquote>
Le Tesla Player est un outil dédié au pôle électrotechnique. Associé au Syntherrupter, il permet de controler musicalement (en mode orchestre) les bobines Tesla sans avoir à installer de logiciel ou de fichiers de configuration sur son ordinateur. Il a été développé en interne du Clubelek et est partagé à la communauté en opensource.

Le site permet d'associer des configurations du syntherrupteur à un fichier MIDI pour former des "morceaux". Chaque morceau peut être ajouté à une playlist ou joué directement sur les bobines (le site est capable de les controller quand l'adaptateur USB/MIDI est branché au PC)

Utilisation des slicers 3D

2024-04-15T15:10:37Z

Antoine.rochebois :

== Introduction ==
Les imprimantes 3D sont commandées via un langage appelé '''g-code'''. Il n'y a pas de standard exact sur son fonctionnement, et chaque fabriquant a ses particularités (on les appelle les '''flavors''' de g-code).

Pour convertir d'un fichier 3D à un fichier g-code, on utilise un logiciel qui s'appelle un '''slicer'''. Ce logiciel découpe l'objet en couches, et génère une liste d'instructions g-code à envoyer à l'imprimante.

Les slicers récents supportent souvent de nombreux formats de fichiers 3D, mais le plus recommandé est le '''STL'''. ''(les formats STP, STEP et OBJ sont supportés aussi)''

== Liste des slicers utilisés ==
Le Clubelek possède plusieurs imprimantes 3D différentes, chacune avec ses particularités. Différents slicers doivent donc être utilisés :

* '''OrcaSlicer''' : le plus récent et le plus utilisé, il servira à slicer pour la Prusa MK3 et la Bambulab P1S. (peut aussi être utilisé pour l'Ender 3 et la Replicator 2X modifiée)
* '''MarkerBot Print''' : très peu pratique à utiliser, mais c'est le seul slicer qui supporte la Makerbot Replicator 2 (dans la version Legacy du logiciel).
* '''PrusaSlicer''' : utilisé auparavant pour la Prusa MK3, il a été remplacé par OrcaSlicer et sert donc uniquement à flash le firmware de la Prusa MK3.
{| class="wikitable"
|+
!
!Lien de téléchargement
!Imprimantes supportées
|-
|OrcaSlicer
|https://github.com/SoftFever/OrcaSlicer/releases/tag/v2.0.0
|Prusa MK3, Bambulab P1S, Ender 3, Replicator 2X modifiée
|-
|MakerBot Print
|https://makerbot-desktop.makerbot.com/installer/prerelease/4.3.0.1998/MakerBotPrintInstaller.exe (cette version précisément)
|Makerbot Replicator 2
|-
|PrusaSlicer
|https://github.com/prusa3d/PrusaSlicer/releases
|Prusa MK3
|}

== OrcaSlicer ==
OrcaSlicer est un programme entièrement indépendant et open source, basé sur PrusaSlicer et BambulabStudio. De ce fait, il supporte souvent les dernières avancées des slicers, comme le scarf joint ou les supports arborescents.

Une fois le programme téléchargé, vous pouvez soit commencer à l'utiliser sur-le-champ, ou prendre le temps de vous connecter via le compte Bambulab Cloud du Clubelek pour avoir accès à distance à la Bambulab P1S. Ce compte vous donnera également accès aux presets optimisés pour les filaments utilisés.

OrcaSlicer vous demandera sûrement de rajouter les imprimantes lors du premier lancement.Vous devez sélectionner ''Prusa MK3S 0.4mm nozzle'', et ''Bambulab P1S 0.4mm nozzle''.

=== Utilisation ===
Une fois le logiciel lancé, vous trouverez cette barre de navigation en haut de la fenêtre :
[[Fichier:Panneau de commande d'OrcaSlicer.png|sans_cadre|942x942px]]

==== ''Prepare'' ====
Cet onglet est l'onglet le plus important : il permet d'importer vos modèles 3D, de modifier leur position, et de changer les réglages d'impression.

Pour ce faire, le bouton représentant un cube avec un + à côté vous permettra d'importer votre modèle. Vous pouvez importer plusieurs modèles à la fois, mais attention à bien les espacer pour éviter les intersections ! Utilisez le bouton ''move'' et ''rotate'' pour les bouger. Vous pouvez aussi utiliser le bouton ''Arrange'' pour placer toutes les pièces sur votre plateau en un seul clic.

Dernièrement, il faudra placer vos pièces sur la bonne face, ce qui peut être fait manuellement avec le bouton ''Lay on Face'', ou automatiquement avec ''Auto Orient'' (non recommandé).
[[Fichier:Panneau de configuration de l'impression.png|vignette|Panneau de configuration de l'impression]]
Une fois vos pièces placées, choississez l'imprimante dans le panneau à gauche.

'''Uniquement pour les utilisateurs connectés au compte du Clubelek :''' Vous aurez le choix entre deux imprimantes pour la P1S, l'une d'entre elle (nommée ''Fast Startup'') réduit le temps de préparation avant impression de ~7m30s à ~4m. '''Attention :''' ce réglage n'est pas recommandé pour les longues impressions, car il passe un grand nombre de vérifications avant impression ''(purge, mise à niveau à chaud, résonance)'', et pourrait mener à des problèmes d'impression.

Pour la Bambulab P1S, prenez bien soin de sélectionner '''Textured PEI Plate''' en tant que plateau d'impression.

Vous pouvez ensuite choisir votre filament. Le filament '''Generic PLA''' ou '''Generic PETG''' fonctionnera très bien.

'''Uniquement pour les utilisateurs connectés au compte du Clubelek :''' Le filament '''ArianePlast PLA Plus''' a été optimisé spécialement pour la Bambulab P1S du club, et sera le filament préféré à l'avenir.

Dernièrement, il vous faudra régler vos paramètres d'impression. Vous pouvez les sélectionner pour le plateau entier ("''Global''") ou objet par objet ("''Objects''"). Attention à bien désactiver les supports (dans l'onglet "''Support''") si votre objet n'en a pas besoin !

'''Uniquement pour les utilisateurs connectés au compte du Clubelek :''' Le réglage 0.2mm "Tweaked" est un bon compromis entre vitesse, qualité et solidité.

'''Une fois vos réglages faits, vous pouvez cliquer sur "''Slice plate''" dans la barre de navigation.'''

==== ''Preview'' ====
L'onglet ''Preview'' vous permet de vérifier que votre fichier a bien été slicé, à l'aide des deux sliders à droite et en bas de l'écran (contrôlant respectivement la couche et l'instruction dans cette couche). Vous pouvez également y voir le temps total d'impression, et la quantité de filament consommée.

Une fois votre impression vérifiée, vous pouvez lancer l'impression en :

* Cliquant sur "''Print plate''", ce qui lancera l'impression sur la Bambulab du Clubelek. Une fenêtre apparaîtra vous demandant si vous voulez faire une calibration du lit (recommandé pour les longues impressions) et d'enregistrer un timelapse (non recommandé hormis pour la com)
* Cliquant sur "''Export G-Code''", ce qui vous permettra de mettre le fichier g-code sur une carte micro-SD, puis en l'insérant dans l'imprimante de votre choix.

==== ''Device'' ====
L'onglet Device, une fois connecté au compte du Clubelek, vous permet de garder un oeil sur l'état d'avancement de la Bambulab. Vous pouvez cliquer sur le bouton lancer de la fenêtre ''Camera'', pour voir la caméra interne de l'imprimante. '''Attention : une seule personne peut être sur la caméra à la fois, et cela bloque le lancement de nouvelles impressions''', merci de ne l'utiliser qu'en cas de besoin.

Vous pouvez aussi télécharger vos timelapse dans l'onglet ''MicroSD Card''.

==== ''Calibration'' ====
Cet onglet vous expliquera un grand nombre des étapes de calibration, qui sont décrites dans les pages dédiées aux imprimantes.
[[Catégorie:Utilisation des outils du local du Clubelek]]
[[Catégorie:Utilisation de logiciels]]

Catégorie:Utilisation de logiciels

2024-04-15T10:19:45Z

Antoine.rochebois : Page créée avec « Catégorie:Formations, outils et articles techniques »

[[Catégorie:Formations, outils et articles techniques]]

MediaWiki:Sidebar

2024-04-15T10:18:50Z

Antoine.rochebois :

* navigation
** mainpage|mainpage-description
** Créer un nouvel article|Créer un nouvel article
** Special:RecentChanges|Recent changes
** randompage-url|randompage
* Portails
** Catégorie:Vie de l'association|Vie de l'association
** Catégorie:Formations, outils et articles techniques|Formations, outils et articles techniques
** Catégorie:Projets individuels|Projets individuels
** Catégorie:Ateliers Jeunesse et Médiation scientifique|Ateliers Jeunesse et Médiation scientifique
** Catégorie:Pôle Coupe de France de robotique|Pôle Coupe de France de robotique
** Catégorie:Pôle Electrotechnique et haute tension|Pôle Électrotechnique et haute tension
** Catégorie:Pôle Electrochimie|Pôle Électrochimie
* SEARCH
* TOOLBOX

Catégorie:Projets individuels

2024-04-15T10:17:44Z

Antoine.rochebois : Page créée avec « Catégorie:Toutes les catégories »

[[Catégorie:Toutes les catégories]]

Catégorie:Bobines Tesla

2024-04-15T10:16:53Z

Antoine.rochebois : Page créée avec « Catégorie:Pôle Electrotechnique et haute tension »

[[Catégorie:Pôle Electrotechnique et haute tension]]

Utilisation des services informatiques du Clubelek

2024-04-15T10:15:31Z

Antoine.rochebois : Page créée avec « Catégorie:Vie de l'association »

[[Catégorie:Vie de l'association]]

Catégorie:Utilisation des outils du local du Clubelek

2024-04-15T10:09:49Z

Antoine.rochebois : Page créée avec « Catégorie:Formations, outils et articles techniques »

[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Articles techniques de mécanique

2024-04-15T10:08:17Z

Antoine.rochebois : Page créée avec « Catégorie:Formations, outils et articles techniques »

[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Articles techniques d'électronique

2024-04-15T10:07:51Z

Antoine.rochebois : Page créée avec « Catégorie:Formations, outils et articles techniques »

[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Articles techniques d'informatique

2024-04-15T10:07:18Z

Antoine.rochebois : Page créée avec « Catégorie:Formations, outils et articles techniques »

[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Articles techniques de robotique

2024-04-15T10:06:29Z

Antoine.rochebois :

[[Catégorie:Pôle Coupe de France de robotique]]
[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Pôle Coupe de France de robotique

2024-04-15T10:06:17Z

Antoine.rochebois :

[[Catégorie:Toutes les catégories]]

Catégorie:Pôle Coupe de France de robotique

2024-04-15T10:05:51Z

Antoine.rochebois :

[[Catégorie:Toutes les catégories]]
[[Catégorie:Formations, outils et articles techniques]]

Catégorie:Articles techniques de robotique

2024-04-15T10:05:26Z

Antoine.rochebois :

[[Catégorie:Pôle Coupe de France de robotique]]

Catégorie:Articles techniques de robotique

2024-04-15T10:03:39Z

Antoine.rochebois : Page vide créée

Créer un nouvel article

2024-04-15T10:02:14Z

Antoine.rochebois :

== Créer une nouvelle page ==
Pour créer une nouvelle page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version !''' (Attention, il n'est pas très facile de changer le titre d'une page par la suite, choisissez bien votre titre)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques de cette page''' pour associer votre page à la bonne catégorie et y inclure les bonnes informations.

Si vous souhaitez en restreindre l'accès (lecture/écriture) à certains membres du Clubelek, lisez également cette page.

== Règles de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il centralise l'ensemble. Il ne s'agit pas d'un "pense bête" pour les personnes travaillant sur le projet mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.''' Dans l'idéal, toutes les informations incluses (ou recensées) dans le Wiki, doivent permettre de reproduire entièrement le projet.

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par participation à la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception importants (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), elle propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à une catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

La plupart des pages seront dans une seule catégorie, cependant, vous pouvez relier une page à plusieurs catégories. Pour ne pas compliquer la lecture de l'arborescence, n'attachez pas une page une catégorie "parent" d'une catégorie dans laquelle votre page est déjà. ''Par exemple, vous pouvez attacher un article sur l'asservissement de robots au catégories "Coupe de Robotique > Techniques pour la coupe de robotique" et la catégorie "Articles Techniques de robotique".''

Certaines catégories sont restreintes en lecture et en écriture (''e.g. [[:Catégorie:Gestion courante (réservé bureau)|Gestion courante (réservé bureau)]]''). Vous pouvez y ajouter votre page si vous souhaitez qu'elle ne soit pas publique. '''Il est demandé de n'attacher les pages non publiques qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

== Tutoriels : Gestions des catégories et restrictions par groupes utilisateurs ==

=== Ajouter une page à une catégorie ===
Pour définir les catégories d'une page, dans l'éditeur de la page, il faut aller dans les '''"Options de la page" (icone ☰) puis "Catégories"''' puis choisir les catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer les catégories à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable.'''

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe. Dans l'idéal, le nom de la catégorie doit être explicite sans connaitre le nom de la catégorie parent. ''(e.g. ne pas faire "Coupe de France de robotique > Robots" mais "Coupe de France de robotique > Robots de la Coupe de France de Robotique")''

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page. '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories" (qui est la racine)'''. Sinon votre catégorie n’apparaîtra pas dans l'arborescence.

=== Modifier la barre de navigation ===
Pour modifier la barre de navigation, editez la page [[MediaWiki:Sidebar]]. Plus d'informations sur [[mediawikiwiki:Manual:Interface/Sidebar/fr|la documentation officielle.]]

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour cela, créez votre catégorie puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges (exemple ci-dessous).

<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, il faut protéger la catégorie qui contient DIRECTEMENT les pages. Une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée (si cette catégorie enfant n'est pas explicitement protégée).

<big>CategoryLockdown permet de protéger le texte des pages, l'architecture de Médiawiki ne permet néanmoins pas, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''</big>

MediaWiki:Sidebar

2024-04-15T09:53:25Z

Antoine.rochebois :

* navigation
** mainpage|mainpage-description
** Créer un nouvel article|Créer un nouvel article
** Special:RecentChanges|Recent changes
** randompage-url|randompage
* Portails
** Catégorie:Vie de l'association|Vie de l'association
** Catégorie:Formations, outils et articles techniques|Formations, outils et articles techniques
** Catégorie:Pôle Coupe de France de robotique|Pôle Coupe de France de robotique
** Catégorie:Pôle Electrotechnique et haute tension|Pôle Electrotechnique et haute tension
** Catégorie:Pôle Electrochimie|Pôle Electrochimie
** Catégorie:Ateliers Jeunesse et Médiation scientifique|Ateliers Jeunesse et Médiation scientifique
* SEARCH
* TOOLBOX

MediaWiki:Sidebar

2024-04-15T09:53:05Z

Antoine.rochebois :

* navigation
** mainpage|mainpage-description
** Créer un nouvel article
** Special:RecentChanges|Recent changes
** randompage-url|randompage
* Portails
** Catégorie:Vie de l'association|Vie de l'association
** Catégorie:Formations, outils et articles techniques|Formations, outils et articles techniques
** Catégorie:Pôle Coupe de France de robotique|Pôle Coupe de France de robotique
** Catégorie:Pôle Electrotechnique et haute tension|Pôle Electrotechnique et haute tension
** Catégorie:Pôle Electrochimie|Pôle Electrochimie
** Catégorie:Ateliers Jeunesse et Médiation scientifique|Ateliers Jeunesse et Médiation scientifique
* SEARCH
* TOOLBOX

Créer un nouvel article

2024-04-15T09:50:38Z

Antoine.rochebois :

== Créer une nouvelle page ==
Pour créer une nouvelle page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version !''' (Attention, il n'est pas très facile de changer le titre d'une page par la suite, choisissez bien votre titre)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques de cette page''' pour associer votre page à la bonne catégorie et y inclure les bonnes informations.

Si vous souhaitez en restreindre l'accès (lecture/écriture) à certains membres du Clubelek, lisez également cette page.

== Règles de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il centralise l'ensemble. Il ne s'agit pas d'un "pense bête" pour les personnes travaillant sur le projet mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.''' Dans l'idéal, toutes les informations incluses (ou recensées) dans le Wiki, doivent permettre de reproduire entièrement le projet.

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par participation à la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception importants (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), elle propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à une catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

La plupart des pages seront dans une seule catégorie, cependant, vous pouvez relier une page à plusieurs catégories. Pour ne pas compliquer la lecture de l'arborescence, n'attachez pas une page une catégorie "parent" d'une catégorie dans laquelle votre page est déjà. ''Par exemple, vous pouvez attacher un article sur l'asservissement de robots au catégories "Coupe de Robotique > Techniques pour la coupe de robotique" et la catégorie "Articles Techniques de robotique".''

Certaines catégories sont restreintes en lecture et en écriture (''e.g. [[:Catégorie:Gestion courante (réservé bureau)|Gestion courante (réservé bureau)]]''). Vous pouvez y ajouter votre page si vous souhaitez qu'elle ne soit pas publique. '''Il est demandé de n'attacher les pages non publiques qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

== Tutoriels : Ajouter des pages à des catégories, Créer des catégories, Gérer les restrictions par groupes utilisateurs ==

=== Ajouter une page à une catégorie ===
Pour définir les catégories d'une page, dans l'éditeur de la page, il faut aller dans les '''"Options de la page" (icone ☰) puis "Catégories"''' puis choisir les catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer les catégories à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable.'''

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe. Dans l'idéal, le nom de la catégorie doit être explicite sans connaitre le nom de la catégorie parent. ''(e.g. ne pas faire "Coupe de France de robotique > Robots" mais "Coupe de France de robotique > Robots de la Coupe de France de Robotique")''

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page. '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories" (qui est la racine)'''. Sinon votre catégorie n’apparaîtra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour cela, créez votre catégorie puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges (exemple ci-dessous).

<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, il faut protéger la catégorie qui contient DIRECTEMENT les pages. Une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée (si cette catégorie enfant n'est pas explicitement protégée).

<big>CategoryLockdown permet de protéger le texte des pages, l'architecture de Médiawiki ne permet néanmoins pas, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''</big>

Créer un nouvel article

2024-04-14T16:12:05Z

Antoine.rochebois : /* Règles/tutoriel de conception propres au Wiki du Clubelek */

== Créer une nouvelle page (formulaire) ==
Pour créer une page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page !''' (Attention, il n'est pas très facile de changer le titre d'une page...)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques/tutoriels de cette page''' pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

== Règles/tutoriel de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.'''

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception importants (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), elle propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à une catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories). Certaines catégories sont restreintes en lecture et en écriture (périmètre de restriction donné dans le nom de la catégorie). Si vous pouvez y ajouter votre page si vous souhaitez qu'elle ne soit pas publique.

'''Il est demandé de n'attacher les pages non publiques qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

==== Ajouter une catégorie à la page ====
Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)'''

== Créer des catégories, gérer les restrictions par groupes utilisateurs ==

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Votre catégorie doit être reliée à UNE SEULE catégorie parent.'''

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories"'''. Sinon votre catégorie n'apparaitra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''

Accueil

2024-04-14T15:51:13Z

Antoine.rochebois :

Créer un nouvel article

2024-04-14T15:42:50Z

Antoine.rochebois :

== Créer une nouvelle page (formulaire) ==
Pour créer une page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page !''' (Attention, il n'est pas très facile de changer le titre d'une page...)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques/tutoriels de cette page''' pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

== Règles/tutoriel de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.'''

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception sensibles (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), il propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à UNE seule catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

'''Il est demandé de n'attacher une page qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

==== Ajouter une catégorie à la page ====
Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)'''

== Créer des catégories, gérer les restrictions par groupes utilisateurs ==

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Votre catégorie doit être reliée à UNE SEULE catégorie parent.'''

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories"'''. Sinon votre catégorie n'apparaitra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''

Créer un nouvel article

2024-04-14T15:42:04Z

Antoine.rochebois :

== Créer une nouvelle page (formulaire) ==
Pour créer une page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page !''' (Attention, il n'est pas très facile de changer le titre d'une page...)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques/tutoriels de cette page''' pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

== Règles/tutoriel de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.'''

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception sensibles (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), il propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à UNE seule catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

'''Il est demandé de n'attacher une page qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

==== Ajouter une catégorie à la page ====
Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)'''

== Créer des catégories, gérer les restrictions par groupes utilisateurs ==

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Votre catégorie doit être reliée à UNE SEULE catégorie parent.'''

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories"'''. Sinon votre catégorie n'apparaitra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''

Créer un nouvel article

2024-04-14T15:41:37Z

Antoine.rochebois :

== Créer une nouvelle page (formulaire) ==
Pour créer une page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page !''' (Attention, il n'est pas très facile de changer le titre d'une page...)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques/tutoriels de cette page''' pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

== Règles/tutoriel de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.'''

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception sensibles (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), il propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à UNE seule catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

'''Il est demandé de n'attacher une page qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

==== Ajouter une catégorie à la page ====
Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)'''

== Créer des catégories, gérer les restrictions par groupes utilisateurs ==

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Votre catégorie doit être reliée à UNE SEULE catégorie parent.'''

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories"'''. Sinon votre catégorie n'apparaitra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

<syntaxhighlight lang="php" line>
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];
</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''

Créer un nouvel article

2024-04-14T15:38:25Z

Antoine.rochebois :

== Créer une nouvelle page (formulaire) ==
Pour créer une page, rien de plus simple, '''renseignez le nom de la page que vous souhaitez créer dans le champ ci-dessous puis rédigez une première version de votre page !''' (Attention, il n'est pas très facile de changer le titre d'une page...)

<inputbox>
type=create
width=100
break=no
buttonlabel=Créer un nouvel article
default=
placeholder=Titre de l'article (e.g. Utilisation de l'Autoset de l'Oscilloscope à travers l'histoire)
</inputbox>

'''Lisez les règles de bonnes pratiques/tutoriels de cette page''' pour associer votre page à la bonne catégorie ou si vous souhaitez en restreindre l'accès à certains membres du Clubelek.

== Règles/tutoriel de conception propres au Wiki du Clubelek ==

=== Une page Wiki n'est pas un "Readme" ! ===
Un Wiki doit orienter vers toutes les ressources nécessaires pour comprendre un projet. Il ne s'agit pas d'un "pense bête" pour la génération courante mais '''d'un document qui doit être compris 10 ans après, par des personnes qui n'étaient pas sur le projet.'''

Il est donc demandé de '''ne pas multiplier les pages courtes''' mais d'en faire '''une seule par projet''', quitte à ce qu'elle soit très longue ! (e.g. une seule page par robot de la coupe de France de Robotique, avec mention de l'année dans le titre)

Dans l'idéal, '''une page Wiki héberge directement tous les fichiers de conception sensibles (s'ils ne sont pas trop lourds)''' afin de ne minimiser le risque de perte de données et faciliter l'archivage des données importantes de l'association. A défaut (ou en complément), il propose les liens vers les repo Gitlab ou dossier Nextcloud des dites ressources.

=== Une page Wiki doit être reliée à UNE seule catégorie ! ===
Médiawiki permet de générer facilement une arborescence des pages, sur laquelle repose largement la navigation de ce Wiki. Cette arborescence est construite autour de la notion de catégorie<ref>https://www.mediawiki.org/wiki/Help:Categories/fr</ref> (les catégories sont également elles mêmes dans d'autres catégories).

'''Il est demandé de n'attacher une page qu'à une seule catégorie''', afin de clarifier la navigation et réduire le risque d'exposer une éventuelle page confidentielle à l'extérieur (si une page est dans 2 catégories et que l'une des 2 catégories n'est pas en accès restreint, la page n'est pas protégée).

==== Ajouter une catégorie à la page ====
Pour définir les catégories d'une page, dans l'éditeur de la page (à droite de la barre d'édition du haut, il faut aller dans les "Options de la page" (icone ☰)" puis "Catégories" puis choisir la catégorie adéquate dans la liste déroulante puis cliquer sur "Appliquer les modification". C'est tout ! Votre page devrait désormais apparaitre au bon endroit dans l'arborescence ! (vous pouvez changer la catégorie à tout moment)

'''Si la catégorie que vous souhaitez n'existe pas, créez là au préalable (tutoriel ci-dessous)'''

== Créer des catégories, gérer les restrictions par groupes utilisateurs ==

=== Création de catégorie ===
Une catégorie est '''une page spéciale dont le nom respecte le format <code>Catégorie:<Nom de la catégorie></code>''' où <code><Nom de la catégorie></code> est à remplacer par le nom désiré. Pour créer une nouvelle catégorie, vous pouvez donc utiliser le formulaire ci-dessus et créer une page respectant cette syntaxe.

Vous pouvez laisser le contenu de la page de la catégorie vide et enregistrer. La page sera automatiquement mise à jour avec les pages qui seront ajouté à la catégorie.

'''Votre catégorie doit être reliée à UNE SEULE catégorie parent.'''

'''Vous DEVEZ associer votre catégorie à une catégorie parent.''' Pour cela, depuis l'édition de la page de la catégorie, suivre la même procédure que pour ajouter une catégorie à une page (détaillée dans la section précédente). '''Si vous jugez que votre catégorie n'appartient à aucune catégorie''' existante, '''vous devez associer à la catégorie "Toutes les catégories"'''. Sinon votre catégorie n'apparaitra pas dans l'arborescence.

=== Restreindre l'accès aux pages d'une catégorie à certains groupes ===
'''Vous pouvez restreindre l'accès des pages contenues dans certaines catégories à des groupes (de l'authentification centralisée Clubelek) définis.''' Pour celà, créez votre catégorie normalement (essayez de mettre le périmètre de la restriction dans le nom de la catégorie) puis contactez un sysadmin pour qu'il modifie le fichier <code>LocalSettings.php</code> de l'instance Mediawiki sur le serveur afin de mettre à jour les privilèges.

‎<syntaxhighlight lang="php">
$wgCategoryLockdown['Gestion courante (réservé bureau)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion courante (réservé bureau)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['read'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Gestion des infrastructures (réservé bureau/sysadmins)']['edit'] = ['/bureau', '/sysadmin'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['read'] = ['/membre-clubelek', '/Anciens'];
$wgCategoryLockdown['Logisitique des événements (réservé membres/anciens)']['edit'] = ['/membre-clubelek', '/Anciens'];‎</syntaxhighlight>

Cette protection repose sur l'extension CategoryLockdown<ref>https://www.mediawiki.org/wiki/Extension:CategoryLockdown</ref>. Comme le détaille la documentation, une protection ne marchera pas sur une page qui est contenue dans une catégorie enfant d'une catégorie protégée. Il faut donc protéger la catégorie qui contient DIRECTEMENT les pages. Si cela permet de protéger le contenu des pages, l'architecture de Médiawiki ne permet pas, en l'état, de protéger les images et autres fichiers. '''Il ne faut donc pas mettre en ligne de ressources sensibles et il faut partir du principe que TOUS les fichiers uploadés sont visibles par TOUS.'''