You are here: Telem>Wok Web>AideEnLigne (04 Oct 2010, UnknownUser)EditAttach

Comment utiliser ce site ?

Ce site repose sur la technologie du Wiki où les lecteurs sont aussi les rédacteurs des pages. Il est plutôt destiné au travail collaboratif qu'à l'édition en commun comme par exemple sur le modèle de Wikipédia.

Cette approche ouverte du travail en commun est confortée par les fonctionnalités suivantes :
  • les contributeurs sont identifiés, il est nécessaire de s'inscrire au site pour écrire et parfois lire,
  • chaque page conserve un historique intégral des modifications effectuées,
  • il est possible d'attacher des fichiers aux pages : documents bureautiques, images, vidéos, etc.,
  • l'information peut être structurée de différentes manières, notamment en espaces de travail et à l'aide de formulaires de bas de pages.

Le logiciel utilisé est TWiki (version installée : v1.1.9) un logiciel libre initialement créé par Peter Thoeny et maintenant développé par une importante communauté. Il utilise le langage Perl et le système de versionnement RCS (il ne requière pas de base de données).

Comme tous les outils collaboratifs de ce type, TWiki met à votre disposition un bac à sable. C'est la zone Sandbox où vous pouvez faire vos premiers pas et essayer tout ce que vous désirez sans aucun risque.

S'enregistrer, rejoindre la communauté des usagers

La liste des usagers est disponible dans l'espace Accueil. Il est possible de gérer les droits de ces usagers individuellement ou au travers de groupes d'usagers.

Pour éditer des pages, vous avez besoin d'avoir un compte TWiki.

  • Il existe un certain nombre de comptes banalisés qui vous permettent d'intervenir de manière ponctuelle, par exemple Albert Einstein (demandez l'identifiant et le mot de passe à votre correspondant)

  • Pour créer votre compte, cliquez sur le lien Inscription, en haut à gauche, sous le logo, ou allez à la page d'inscription puis renseignez le formulaire - indiquez le pourquoi de votre inscription dans le champ libre à la fin - et suivez les instruction de validation de votre compte et vous êtes prêts !

Le cas échéant

Lire et écrire

Deux boutons en haut à gauche de l'écran vous permettent de réaliser l'essentiel des actions de base (N'oubliez pas de choisir votre langue préférée pour l'interface à l'aide du sélecteur situé au dessus de ces bouton).

Bouton Modifier

Il existe deux modes d'édition des pages :
  • le mode plein texte associé à un langage de balisage qui permet de donner des indications de formatage (gras, italique, etc.) et de structuration (titres, listes, etc.) du document ainsi que de préciser les liens hypertextes ;
  • le mode WYSIWYG, acronyme de la locution anglaise What you see is what you get, en substance en français tel affichage, tel résultat, la saisie s'effectue alors dans une fenêtre à icones comme avec un logiciel de bureautique. Selon le contexte, vous éditez dans l'un de ces deux modes, le premier si il y a des directives TWiki dans le texte ou si l'adresse comporte le paramètre nowysiwyg=1, le second sinon.
Par défaut le mode WYSIWYG est utilisé.

Aide rapide au formatage plein texte :
  • paragraphes séparés par une ligne vide
  • gras mettre le mot, la phrase entre étoiles * : *votre phrase*
  • italique mettre le mot, la phrase entre soulignés _ : _votre phrase_
  • Note: soyez sûr de coller les signes * _ aux mots.
  • liste à puce 3 espaces, une étoile, 1 espace: * votre texte
  • titres 3 tirets, 1 à 6 plus, 1 espace: ---++ Votre titre
  • liens utiliser le nom de la page, Actu Docs, ou adresse http://yahoo.com, ou link to Yahoo

Les noms des pages sont des MotsWikis. C'est un dire qu'ils sont composés d'au moins deux mots avec leurs premières lettres en majuscule, sans espaces, sans ponctuation et (pour l'instant) sans accents. Lorsque vous tapez un MotWiki, vous établissez un lien hypertexte. Et voilà pour le principe, cette façon de faire donne des liens faciles à reconnaître et évite des thématiques trop vagues parce qu'il faut au moins deux mots.

Il suffit donc de mettre son nom si elle est dans le même espace, ou de le faire précéder par le nom de l'espace dans lequel elle se trouve par exemples :
  • WebHome pointe automatiquement vers la page d'accueil Actu Docs
  • et TWiki.DocumentationEnFrancais vers la page Documentation En Francais de l'espace TWiki.Wehome Voir ci-après la partie créer et gérer les pages.

Quelques remarques :

  • Insérez des MotsWikis dès que c'est nécessaire. C'est la richesse des interconnexions qui fait les succès d'un wiki.
  • Soyez précis. Dans un même espace, chaque nom de page est unique, alors plutot que d'écrire TachesEtPlannings à partir de la page MonProjet, écrivez plutot MonProjetTachesEtPlanning car d'autre projets auront aussi des tâches et des plannings.
  • HELP Pour éviter qu'une suite écrite comme un MotWiki génère un lien hypertexte, insérez un signe immediatement avant et immédiatement après ce MotWiki.

Si vous êtes allergiques au MotsWikis, il est possible de générer des liens en encadrant le nom de la page par des crochets doubles, par exemple une nouvelle page, TWiki opérera lui-même la conversion en UneNouvellePage

Onglet Attacher

Vous pouvez attacher n'importe quel type de fichier à votre sujet - des documents, des images, des programmes, n'importe quoi - et ils pourront être ouverts, lus ou téléchargés.

La liste des fichiers attachés est disponible (si il en existe) en bas de page sous la forme d'une table. Cette table peut être masquée, il suffit de cliquer sur le Afficher les fichiers attachés pour la faire apparaître.

La taille limite des fichiers est fixée à 30000 Ko.

Attacher un nouveau fichier :
  • sélectionnez le fichier en question dans votre système,
  • décrivez ce fichier, afin que les autres personnes sachent de quoi il s'agit (c'est obligatoire),
  • éventuellement, vous pouvez en cochant la première case, créer un lien vers le fichier attaché, s'il s'agit d'une image, elle sera affichée ; sinon, un lien vers le fichier attaché sera créé,
  • la case suivante précise de ne pas afficher ce nouveau fichier dans la liste des fichiers attachés (à éviter).

Il est possible de fournir une nouvelle version d'un fichier ou de modifier le commentaire en cliquant sur le lien gérer en face de chaque nom dans la table des fichiers attachés.

Comment s'y retrouver ?

Outre en lien vers cette documentation, la partie gauche de l'écran propose trois groupes de liens :
  • les informations de connexion,
  • des outils et des liens d'intérêt général,
  • la liste des espaces thématiques.

Les informations de connexions

De deux choses l'une. Soit vous êtes identifié, et cette partie affiche votre nom et un lien pour vous déconnecter (n'oubliez pas de cliquer ici lorsque vous cesser de travailler sur TWiki afin de ne pas laisser une porte grande ouverte sur les contenus). Soit vous n'êtes pas identifié et vous avez un compte, vous pouvez alors vous connecter en cliquant sur le lien, où bien vous n'avez pas de compte et vous devez vous enregistrer pour vous en procurer un.

Les outils et les liens d'intérêt général

Ils sont en nombre variable, mais vous retrouverez toujours ceux-là :
  • home Wok Web : retour vers la page d'accueil de l'espace thèmatique,
  • newtopic Create New Topic : création d'une nouvelle page,
  • index Index liste des pages de cet espace thématique,
  • searchtopic Search recherche à partir d'un nom de page ou d'un mot clé,
  • changes Changes liste des derniers changements dans cet espace.

La liste des espaces thématiques

Ce sont les espaces auxquels vous pouvez accéder en fonction des droits que les administrateurs du site vous ont accordé.

Les directives utiles

TWiki propose des directives, les Macros et issus des plugins installés, dont l'insertion dans les pages généère automatiquement des contenus ou des fonctionnalités avancées, souvent ces directives peuvent êtres combinées entre-elles.

Exemples:
  • %TOC% génère une table des matières
  • %INCLUDE{"page"}% permet d'inclure tout ou partie d'une autre page
  • %H, %ICON{"pdf"}%, %M%, %N%, %P%, %Q%, %S%, %T%, %U%, %X%, %Y% respectivement les icones HELP, pdf, MOVED TO..., NEW, REFACTOR, QUESTION?, PICK, TIP, UPDATED, ALERT!, DONE
  • %COMMENT% insère un champ de saisie de texte, cf Comment Plugin
  • %IMAGEGALLERY% génère un album photos à partir des images attachées à la page si le plugin Image Gallery Plugin est installé

Il est nécessaire de qualifier avec le style Protec forever si la page est éditée par l'éditeur WYSIWYG.

Les formulaires

Selon les espaces, il est possible ou non d'attacher un formulaire aux pages lors de la phase de création ou d'édition. Ce formulaire est lui même une page wiki. Il permet en général d'apporter des informations structurées en relation avec les contenus.

Dans le cas de http://telem.fr, le formulaire généralement utilisé Fiche Standard comporte deux champs : Type et Classement
  • le champ Type liste des pages de collecte communes à tous les espaces, elles sont elles-mêmes du type Wok Type.
  • le champ Classement liste des pages de collecte relative à tel ou tel espaces (elles peuvent aussi êtres partagées), elles sont elles-mêmes du type Wok Taxon.

References (en anglais)

Remarques et commentaires à propos de cette aide

Voir http://telem.fr/bin/view/Trash/Test/CommentairesAideEnLigne
Topic revision: r17 - 04 Oct 2010, UnknownUser
 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Telem? Send feedback