Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

--- aide:documenter [2014/12/12 20:30]
citeain
+++ aide:documenter [2018/12/19 17:11] (Version actuelle)
luk
@@ Ligne 6: / Ligne 6: @@
   * Vous vous engagez à partager cette documentation, en la publiant sur notre wiki. Ce partage peut se faire sous une licence qui restreint l’exploitation commerciale de votre projet, mais qui en autorise par défaut la reproduction à titre personnel, et les modifications, comme par exemple une licence [[wp>Licences_Creative_Commons|Creative Commons]].
-Documenter son projet c'est réaliser une page dédiée à votre réalisation dans la rubrique [[projets:index|]], avec la descriptions des différentes étapes du projet, les difficulté rencontrées etc.… Mais c'est aussi :
+Documenter son projet c'est réaliser une page dédiée à votre réalisation dans la rubrique [[projets:index|]], avec la description des différentes étapes du projet, les difficulté rencontrées etc.… Mais c'est aussi :
   * Documenter **l'utilisation des machines** dans la [[machines:index|rubrique dédiée]] (procédure, astuces, réglages, …)
   * Documenter **[[logiciels:index|les logiciels]]** utilisés (tutoriaux, astuces, plugins utiles, …)
-  * Indiquer dans la rubrique **[[ressources:fournisseurs|Les ressources/Fournisseurs de matériaux]]** où vous vous être procurés vos matériaux et les potentiels bon plans ou remarques vous vous auriez à partager.
+  * Indiquer dans la rubrique **[[ressources:fournisseurs|Les ressources/Fournisseurs de matériaux]]** où vous vous êtes procurés vos matériaux et les potentiels bons plans ou remarques que vous auriez à partager.
   * Ajouter des liens vers les ressources qui vous ont été utiles durant votre projet dans la rubrique **[[ressources:index]]**
   * Rédiger de petits articles sur tel ou tel sujet que vous auriez appris ou approfondi lors votre réalisation, et qui pourraient être utiles pour d'autre projets //(comme par exemple l'article sur les [[ressources:mecanique:engranges_denture_droite|]])//
   * …
-Votre documentation permettra ainsi à d'autres usager·ere·s de Fab Labs de refabriquer, d’améliorer ou d'adapter votre réalisation, mais aussi de partager les connaissances que vous aurez acquises lors de votre projet avec les autres utilisateur·trice·s.
+Votre documentation permettra ainsi à d'autres usager·e·s de Fab Labs de refabriquer, d’améliorer ou d'adapter votre réalisation, mais aussi de partager les connaissances que vous aurez acquises lors de votre projet avec les autres utilisateur·trice·s.
 N'hésitez pas non plus à corriger ou améliorer le contenu déjà présent dans ce wiki.
@@ Ligne 24: / Ligne 24: @@
-Lorsque vous créez une page dans la rubrique ''projets'' un squelette vous est proposé pour vous aider dans la rédaction. Les parties indiquées entre <html><!--</html> et <html>--></html> sont des commentaires, non affichés sur la page, il vous guideront dans la rédaction et vous pouvez les supprimer.
+Lorsque vous créez une page dans la rubrique ''projets'' un squelette vous est proposé pour vous aider dans la rédaction. Les parties indiquées entre <html><!--</html> et <html>--></html> sont des commentaires, non affichés sur la page, ils vous guideront dans la rédaction et vous pouvez les supprimer.
-Voici un présentation des différentes parties que nous vous proposons d’intégrer dans votre documentation. Ces quelques ligne directrices sont bien sur indicatives, et vous pouvez adapter la structure de votre page en fonction de vos besoins. Les éléments proposés nous semblent être une bonne base pour documenter un projet. Vous pouvez commencer la documentation de votre projet même si celui-ci n'est pas encore terminé.
+Voici une présentation des différentes parties que nous vous proposons d’intégrer dans votre documentation. Ces quelques lignes directrices sont bien sur indicatives, et vous pouvez adapter la structure de votre page en fonction de vos besoins. Les éléments proposés nous semblent être une bonne base pour documenter un projet. Vous pouvez commencer la documentation de votre projet même si celui-ci n'est pas encore terminé.
 ==== Contenu de ma page ====
@@ Ligne 33: / Ligne 33: @@
 Lorsque vous créez votre page, le titre sera pré-rempli, mais vous pouvez le modifier s'il ne vous convient pas.
 === Fiche projet ===
- Dans le squelette fournis lors de la création de votre page vous trouverez une fiche projet à compléter :
+ Dans le squelette fourni lors de la création de votre page vous trouverez une fiche projet à compléter :
 <code>
 {{{project
@@ Ligne 40: / Ligne 40: @@
 materiaux:
 logiciels:
-sources:
+fichiers:
 liens:
 tags:
@@ Ligne 51: / Ligne 51: @@
   * **machines : ** Liste des machines utilisées lors de la réalisation, séparées par des espaces. Il faut ici, si possible, indiquer l'identifiant de la page de la machine utilisé dans la rubrique [[machines:index|machines]] du wiki. Exemple : <code>machines: impression_3d:orca decoupe_laser vinyle:decoupeuse</code>
   * **materiaux : ** Liste des matériaux utilisés pour votre projet, séparés par des espaces. Ici encore, lorsque cela est possible, utilisez le nom de la page matériaux tel quelle existe dans la [[materiaux:index|rubrique idoine]] Vous pouvez, bien sur, créer une page si vous utilisez un matériau non encore référencé. Exemple : <code>matériaux: medium pmma abs pla cahoutchouc</code>
-  * **logiciels : ** Liste des logiciels utilisé lors de du projet. séparés par des espaces. Ici aussi, lorsque c'est possible, utilisez le nom de la page concernant ce logiciel dans la rubrique [[logiciels:index|logiciels]]. Exemple : <code>logiciels: inkscape freecad slic3r</code>
+  * **logiciels : ** Liste des logiciels utilisés lors de du projet. séparés par des espaces. Ici aussi, lorsque c'est possible, utilisez le nom de la page concernant ce logiciel dans la rubrique [[logiciels:index|logiciels]]. Exemple : <code>logiciels: inkscape freecad slic3r</code>
-  * **sources** : Liens vers les fichiers sources du projet, séparées par des espaces. Vous pouvez ici utiliser le bouton ''Ajouter des images ou d'autres fichiers'' pour lier vers des fichiers hébergés sur le wiki, ou bien utiliser des urls vers de fichiers hébergés sur d'autres serveurs. Exemple : <code>sources: {{:projets:obc_goodies:mains_obc.svg|}} http://www.thingiverse.com/download:122201</code>
+  * **fichiers** : Fichiers sources et fichiers de fabrication du projet(modèles 3d, fichiers svg, codes sources, ...) , séparés par des espaces. Vous pouvez ici utiliser le bouton ''Ajouter des images ou d'autres fichiers'' pour faire un lien vers des fichiers hébergés sur le wiki, ou bien utiliser des urls vers de fichiers hébergés sur d'autres serveurs. Exemple : <code>fichiers: {{:projets:obc_goodies:mains_obc.svg|}} http://www.thingiverse.com/download:122201</code>
   * **liens** : Liste de liens vers des ressources intéressantes ou vers d'autre projets qui vous ont inspirés. Vous pouvez utiliser tout type de lien supporté par la syntaxe dokuwiki (lien [[wiki:syntax#internes|interne]], lien [[wiki:syntax#externes|externe]] ou [[wiki:syntax#interwiki|interwiki]]). Exemple : <code>liens : [[projets:flocons_laser|]] [[wpfr>Flocon]] http://www.instructables.com/id/Paper-chain-snowflakes/</code>
   * **tags :** Liste de mots clefs catégorisants votre réalisation, séparés par des espaces. Exemple : <code>tags: boite bois steampunk bijoux</code>
-  * **usager :** Login du ou des usager·ere·s ayant participé·e·s à la réalisation, séparés par des espaces. Exemple : <code>usager·ere:bully isa</code>
+  * **usager :** Login du ou des usager·e·s ayant participé·e·s à la réalisation, séparés par des espaces. Exemple : <code>usager:bully isa</code>
-  * **licence :** Licence(s) sous laquel vous souahitez partager votre projet. Par exemple ''cc-by-sa'', ''cc-by'', ''cc-by-nc'', … pour une Licence [[cc>cc-by-sa|Creative common]], ou bien encore ''agpl'', ''gpl'', ''art-libre'', etc.… //(Pour vous aider dans le choix de votre licence vous pouvez consulter le rubrique [[ressources:licences|]] du wiki.)// <code> licence : cc-by</code>
+  * **licence :** Licence(s) sous laquelle vous souhaitez partager votre projet. Par exemple ''cc-by-sa'', ''cc-by'', ''cc-by-nc'', … pour une Licence [[cc>cc-by-sa|Creative common]], ou bien encore ''agpl'', ''gpl'', ''art-libre'', etc.… //(Pour vous aider dans le choix de votre licence vous pouvez consulter le rubrique [[ressources:licences|]] du wiki.)// <code> licence : cc-by</code>
 === Introduction ===
- Juste après la fiche projet, et avant le premier sous titre, vous pouvez indiquer quelques mots/phrases d'introduction présentant le projet, expliquant d’où est venue l'idée etc.… C'est cette petite introduction qui sera visible dans la liste des projets.
+ Juste après la fiche projet, et avant le premier sous-titre, vous pouvez indiquer quelques mots/phrases d'introduction présentant le projet, expliquant d’où est venue l'idée etc.… C'est cette petite introduction qui sera visible dans la liste des projets.
 === Conception ===
@@ Ligne 64: / Ligne 64: @@
 === Réalisation ===
-Dans la rubrique réalisation vous pouvez expliquer étape par étape comment vous avez concrétisé et fabriqué votre projet. N’hésitez pas à illustrer les différentes étapes par des schéma et/ou photos. Indiquez comment vous avez utilisé les machines et outils, quels réglages etc.…
+Dans la rubrique réalisation vous pouvez expliquer étape par étape comment vous avez concrétisé et fabriqué votre projet. N’hésitez pas à illustrer les différentes étapes par des schémas et/ou photos. Indiquez comment vous avez utilisé les machines et outils, quels réglages etc.…
 === Difficultés rencontrées ===
-Rien de mieux que de se tromper pour apprendre de ses erreurs. Indiquez les difficultés et problèmes rencontrés durant la conception et le réalisations de votre projet, et comment vous avez résolu ces problème, ou ce que vous changeriez si vous aviez à le refaire.
+Rien de mieux que de se tromper pour apprendre de ses erreurs. Indiquez les difficultés et problèmes rencontrés durant la conception et le réalisations de votre projet, et comment vous avez résolu ces problèmes, ou ce que vous changeriez si vous aviez à le refaire.
 === Suites du projet ===
@@ Ligne 87: / Ligne 87: @@
 Pour connaître la syntaxe particulière de DokuWiki (le logiciel utilisé pour ce site), consultez la [[syntaxe_de_mise_en_page|syntaxe de mise en page]].
-Pour télécharger un fichier, utilisez le [[http://cyberweb.cite-sciences.fr/fablab/wiki/doku.php?id=index&do=media|gestionnaire de médias]] (ouvrez-le dans un nouvel onglet). N’hésitez pas à créer des ''namespace'' pour ranger vos images et fichiers plutôt que de les laisser à la racine du wiki ou de la rubrique projets. //(=> Plus de détails dans la rubrique [[aide:upload_fichiers|]])//
+Pour télécharger un fichier, utilisez le [[http://cyberweb.cite-sciences.fr/fablab/wiki/doku.php?id=index&do=media|gestionnaire de médias]] (ouvrez-le dans un nouvel onglet). N’hésitez pas à créer des ''namespace'' pour ranger vos images et fichiers plutôt que de les laisser à la racine du wiki ou de la rubrique projets. Pour créer un ''namespace'' il convient de préfixer le nom du fichier avec le chemin que l'on souhaite créé après avoir sélectionné ses fichiers. Le nom du fichier s'affiche dans un champ. Il suffit alors de saisir le chemin souhaité, par exemple ''mon-espace:mon_projet:image.jpg''. En cliquant sur "Télécharger", les images s'enregistreront dans le ''namespace'' souhaité. //(=> Plus de détails dans la rubrique [[aide:upload_fichiers|]])//

Carrefour numérique² - fablab

Outils d'utilisateurs

Outils du Site

Différences

Outils de la Page