From f604bebaee9ef35fead50bbb8c9c2f13ed3a47e6 Mon Sep 17 00:00:00 2001 From: Xavier Cazin Date: Fri, 28 Nov 2014 18:18:42 +0100 Subject: [PATCH] A few more translations plus new tiddlers for the fr-FR edition --- ...__editions_fr-FR_CSS Stylesheets_utils.tid | 15 ++++++++ .../tiddlers/Documentation Style Guide.tid | 16 +++++++++ .../Exporter un sous-ensemble de tiddlers.tid | 13 +++++++ editions/fr-FR/tiddlers/GitHub.tid | 13 +++++++ ... add a banner for GitHub contributions.tid | 24 +++++++++++++ .../How to add a new tab to the sidebar.tid | 18 ++++++++++ .../Improving TiddlyWiki Documentation.tid | 35 +++++++++++++++++++ .../Informations pour les traducteurs.tid | 19 +++++++--- 8 files changed, 148 insertions(+), 5 deletions(-) create mode 100644 editions/fr-FR/tiddlers/$__editions_fr-FR_CSS Stylesheets_utils.tid create mode 100644 editions/fr-FR/tiddlers/Documentation Style Guide.tid create mode 100644 editions/fr-FR/tiddlers/Exporter un sous-ensemble de tiddlers.tid create mode 100644 editions/fr-FR/tiddlers/GitHub.tid create mode 100644 editions/fr-FR/tiddlers/How to add a banner for GitHub contributions.tid create mode 100644 editions/fr-FR/tiddlers/How to add a new tab to the sidebar.tid create mode 100644 editions/fr-FR/tiddlers/Improving TiddlyWiki Documentation.tid diff --git a/editions/fr-FR/tiddlers/$__editions_fr-FR_CSS Stylesheets_utils.tid b/editions/fr-FR/tiddlers/$__editions_fr-FR_CSS Stylesheets_utils.tid new file mode 100644 index 000000000..75548f0a7 --- /dev/null +++ b/editions/fr-FR/tiddlers/$__editions_fr-FR_CSS Stylesheets_utils.tid @@ -0,0 +1,15 @@ +created: 20141128135102023 +creator: 127.0.0.1 +modified: 20141128135233410 +modifier: 127.0.0.1 +tags: $:/tags/Stylesheet +title: $:/editions/fr-FR/CSS Stylesheets/utils +type: text/css + +.inline-button { + height: 13px; + width: 13px; + vertical-align:-1ex; + display:inline-block; + fill:grey; +} \ No newline at end of file diff --git a/editions/fr-FR/tiddlers/Documentation Style Guide.tid b/editions/fr-FR/tiddlers/Documentation Style Guide.tid new file mode 100644 index 000000000..56d12783e --- /dev/null +++ b/editions/fr-FR/tiddlers/Documentation Style Guide.tid @@ -0,0 +1,16 @@ +created: 20140904164608166 +creator: 127.0.0.1 +fr-title: Manuel de style pour la documentation TiddlyWiki +modified: 20141128170624843 +modifier: 127.0.0.1 +tags: Improving TiddlyWiki Documentation +title: Documentation Style Guide +type: text/vnd.tiddlywiki + +La documentation de ~TiddlyWiki tente de suivre les règles suivantes. L'objectif est de s'assurer que la documentation issue d'auteurs différents se lira de façon aussi homogène que possible. + +# Adressez-vous au lecteur directement en disant "vous" +# Évitez la [[voix passive|http://bdl.oqlf.gouv.qc.ca/bdl/gabarit_bdl.asp?id=2950]] dans vos tutoriels et vos présentations +# Lorsque vous écrivez en Anglais, utilisez [[l'Anglais britannique de préférence à l'Anglais des États-Unis|http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences]]. En Français, si vous utilisez des expressions qui ne sont pas employées en France, reliez-les à un tiddler qui les replace dans leur contexte. + +Voir aussi les règles pour [[les titres des tiddlers|Adopt a Titles Policy]]. diff --git a/editions/fr-FR/tiddlers/Exporter un sous-ensemble de tiddlers.tid b/editions/fr-FR/tiddlers/Exporter un sous-ensemble de tiddlers.tid new file mode 100644 index 000000000..26318f774 --- /dev/null +++ b/editions/fr-FR/tiddlers/Exporter un sous-ensemble de tiddlers.tid @@ -0,0 +1,13 @@ +created: 20141128103901173 +creator: 127.0.0.1 +modified: 20141128170659622 +modifier: 127.0.0.1 +tags: Saving +title: Exporter un sous-ensemble de tiddlers +type: text/vnd.tiddlywiki + +Le mécanisme d'exportation qui a fait son apparition avec la version [[5.1.5]] de <> permet de sélectionner facilement un sous-ensemble de tiddlers afin de le sauvegarder dans un fichier. + +Si par exemple vous souhaitez sauvegarder dans un fichier tous les tiddlers ayant un tag `WikiText` et contenant un champ `fr-title`, entrez le [[filtre|Filters]] `[tag[WikiText]has[fr-title]]` dans l'onglet //Filtre// de la [[Recherche avancée|$:/AdvancedSearch]] et choisissez //Fichier de tiddlers au format JSON// après avoir cliqué sur @@.inline-button {{$:/core/images/export-button}}@@ + +Vous obtenez alors un fichier nommé `tiddlers.json`, qui contient tous les tiddlers sélectionnés et qui pourra être réutilisé plus tard via un simple glissé-déposé sur un <> ouvert. \ No newline at end of file diff --git a/editions/fr-FR/tiddlers/GitHub.tid b/editions/fr-FR/tiddlers/GitHub.tid new file mode 100644 index 000000000..e785f1393 --- /dev/null +++ b/editions/fr-FR/tiddlers/GitHub.tid @@ -0,0 +1,13 @@ +created: 20140910212609354 +creator: 127.0.0.1 +modified: 20141124150236839 +modifier: 127.0.0.1 +tags: Definitions +title: GitHub +type: text/vnd.tiddlywiki + +~GitHub est une société qui propose un service d'hébergement de code incluant des fonctions collaboratives puissantes. + +Le code et la documentation de ~TiddlyWiki est hébergé sur ~GitHub à l'adresse<> + +https://github.com/Jermolene/TiddlyWiki5 diff --git a/editions/fr-FR/tiddlers/How to add a banner for GitHub contributions.tid b/editions/fr-FR/tiddlers/How to add a banner for GitHub contributions.tid new file mode 100644 index 000000000..8dbe4289b --- /dev/null +++ b/editions/fr-FR/tiddlers/How to add a banner for GitHub contributions.tid @@ -0,0 +1,24 @@ +created: 20141123094403948 +creator: 127.0.0.1 +fr-title: Ajouter une bannière d'appel aux contributions GitHub +modified: 20141127214536062 +modifier: 127.0.0.1 +tags: Learning +title: How to add a banner for GitHub contributions +type: text/vnd.tiddlywiki + +Lorsque vous éditez un tiddler sur http://tiddlywiki.com, vous voyez un petit bandeau qui vous invite à éditer la source du tiddler sur ~GitHub. + +Si vous utilisez Node.js, vous pouvez répliquer cette fonction pour votre propre site basé sur TiddlyWiki de la manière suivante<> + +# Assurez-vous que la configuration suivante est incluse dans le fichier `tiddlywiki.info` de votre [[dossier TiddlyWiki|TiddlyWikiFolders]] +#> 
	"config": {
+		"retain-original-tiddler-path": true
+	}
+# Copiez le tiddler [[$:/ContributionBanner]] vers votre wiki +# Effectuez les changements suivants<> +## Ajuster le lien GitHub https://github.com/Jermolene/TiddlyWiki5/edit/master/editions/tw5.com/tiddlers/ pour le faire pointer vers votre propre répertoire GitHub. +## Assurez-vous que le texte commençant par "Can you help us improve this documentation?" est approprié pour vos visiteurs +## Remplacez le lien vers [[Améliorer la documentation de TiddlyWiki|Improving TiddlyWiki Documentation]] par un lien vers le tiddler qui contient vos instructions pour votre propre procédure de contributions. + + diff --git a/editions/fr-FR/tiddlers/How to add a new tab to the sidebar.tid b/editions/fr-FR/tiddlers/How to add a new tab to the sidebar.tid new file mode 100644 index 000000000..055e79c27 --- /dev/null +++ b/editions/fr-FR/tiddlers/How to add a new tab to the sidebar.tid @@ -0,0 +1,18 @@ +created: 20141117000000000 +creator: 127.0.0.1 +fr-title: Comment ajouter un nouvel onglet dans la barre latérale +modified: 20141127221257436 +modifier: 127.0.0.1 +tags: Learning [[Customise TiddlyWiki]] +title: How to add a new tab to the sidebar +type: text/vnd.tiddlywiki + +Pour créer un nouvel onglet dans le menu de la barre latérale<> + +# Créez un tiddler et étiquetez-le avec le [[tag système|SystemTags]] [[$:/tags/SideBar]] +#* Si vous souhaitez créer un onglet de table des matières, vous pouvez peupler ce nouveau tiddler à l'aide de la macro [[TableOfContentsMacro]]. Regardez par exemple comment fonctionne [[TableOfContents]] +# Par défault, libellé de l'onglet correspond au titre du tiddler, mais vous pouvez le remplacer en remplissant le champ `caption`. +# Pour définir l'ordre des onglets, servez-vous des champs `list-after` ou `list-before`, comme expliqué dans [[Tagging]] +#* Par exemple<> donnez à `list-after` la valeur [[$:/core/ui/SideBar/Open]] pour placer un onglet de barre latérale juste après l'onglet <> (//{{$:/language/SideBar/Open/Caption}}//) + +Notez qu'il est possible de créer de la même manière de nouveaux onglets sous l'onglet <> (//{{$:/language/SideBar/More/Caption}}//), en utilisant le tag ``$:/tags/MoreSideBar``. diff --git a/editions/fr-FR/tiddlers/Improving TiddlyWiki Documentation.tid b/editions/fr-FR/tiddlers/Improving TiddlyWiki Documentation.tid new file mode 100644 index 000000000..e95a0ffb4 --- /dev/null +++ b/editions/fr-FR/tiddlers/Improving TiddlyWiki Documentation.tid @@ -0,0 +1,35 @@ +created: 20140820151051019 +creator: 127.0.0.1 +fr-title: Améliorer la documentation de TiddlyWiki +modified: 20141128170605799 +modifier: 127.0.0.1 +tags: Community +title: Improving TiddlyWiki Documentation +type: text/vnd.tiddlywiki + +(''NB''<> si vous souhaitez travailler sur la traduction française, reportez-vous plutôt aux [[informations pour les traducteurs|Informations pour les traducteurs]].) + +N'importe qui peut proposer des améliorations à la documentation ~TiddlyWiki présente sur http://tiddlywiki.com<> + +# Lisez et suivez le [[Manuel de style pour la documentation TiddlyWiki|Documentation Style Guide]] +# Si vous n'en n'avez pas déjà un, créez un compte sur https://github.com +# Sur http://tiddlywiki.com, cliquez sur le bouton "edit" du tiddler que vous souhaitez améliorer +# Vous devriez voir un bandeau rose avec le texte suivant<> //Pouvez-vous nous aider à améliorer cette documentation ? Voyez comment éditer ce tiddler sur ~GitHub//. +# Cliquez sur le lien externe ...''ce tiddler sur ~GitHub'' +## Une alerte va s'afficher comme quoi <> (<>). Un //fork// est votre propre exemplaire du répertoire, qui intègrera les modifications que vous proposez +# Un nouvel onglet devrait s'ouvrir sur votre navigateur, pour permettre d'éditer le tiddler sur github.com. La dernière vidéo montre le contenu attendu dans cette zone. +# Sous la boîte d'édition du texte du tiddler, vous devriez voir une boîte indiquant ''Propose file change'' +# Entrez un titre bref expliquant la modification (par ex., "Clarifier l'instabilité de la syntaxe des attributs") +# Si nécessaire, entrez également une description plus détaillée +# Cliquez sur le bouton vert intitulé ''Propose file change'' +# Sur l'écran suivant, cliquez sur le bouton vert intitulé ''Create pull request'' + +[[Jermolene|https://github.com/Jermolene]] ou l'un des autres développeurs principaux sera alors en mesure de fusionner votre //pull request// de façon à l'intégrer à la prochaine version de http://tiddlywiki.com. + +Mario Pietsch a créé pour vous ces tutoriels vidéos<> + + + + + + diff --git a/editions/fr-FR/tiddlers/Informations pour les traducteurs.tid b/editions/fr-FR/tiddlers/Informations pour les traducteurs.tid index fc20dff2e..d8c575465 100644 --- a/editions/fr-FR/tiddlers/Informations pour les traducteurs.tid +++ b/editions/fr-FR/tiddlers/Informations pour les traducteurs.tid @@ -1,13 +1,22 @@ created: 20141115212945847 creator: 127.0.0.1 list-after: RoadMap -modified: 20141119193113226 +modified: 20141128171729909 modifier: 127.0.0.1 tags: $:/tags/SideBar About title: Informations pour les traducteurs type: text/vnd.tiddlywiki -;Les titres des tiddlers sont conservés en anglais -:de sorte que les tiddlers traduits soient écrasent la version d'origine au moment d'être servis, et que les références croisées soient maintenues. Pour faire apparaître les titres traduits, utilisez le champ `caption`, ainsi que le paramètre de libellé dans les [[liens wikitext|Linking in WikiText]]. -;Quelques raccourcis sont à votre disposition -:sous forme de macros dans le tiddler [[$:/editions/fr-FR/util-macros]]. Ils facilitent la saisie des chaînes de caractères typiquement françaises (comme les <>, mais aussi de mots fréquents (comme <>) ou compliqués comme <> (qui a sa propre [[feuille de style|$:/editions/fr-FR/CSS stylesheets/latex]]). N'hésitez pas à en ajouter<> \ No newline at end of file +Pour contribuer à cette traduction de la documentation //tiddlywiki.com//, commencez par repérer sur http://tiddlywiki.com/prerelease/languages/fr-FR quelques tiddlers non traduits, non mis à jour, voire mal traduits. Ensuite<> + +* si vous travaillez en mode Node.js sur un //clone git// de l'édition `fr-FR`, vous pouvez traduire à partir de votre clone en respectant les quelques indications ci-dessous, puis proposer un pull request sur ~GitHub en vous aidant si besoin de la [[documentation|Improving TiddlyWiki Documentation]] +* sinon, traduisez directement, soit en ligne, soit sur une [[sauvegarde du site|http://tiddlywiki.com/prerelease/languages/fr-FR/#%24%3A%2Fcore%2Fui%2FButtons%2Fsave-wiki]] (c'est plus prudent). Puis<> +** exportez votre travail [[dans un fichier JSON|Exporter un sous-ensemble de tiddlers]] +** envoyez ce fichier à une personne susceptible d'effectuer un //pull request// sur ~GitHub, ou directement sur la liste de diffusion. +Nous ne disposons pas encore de mécanismes très évolués pour gérer le travail de traduction en parallèle, donc ne gardez pas vos traductions sous le coude trop longtemps<> il est préférable d'envoyer un tiddler à la fois que de s'apercevoir trop tard que quelqu'un d'autre l'a traduit en parallèle. + +; Les titres des tiddlers sont conservés en anglais +: de sorte que les tiddlers traduits soient écrasent la version d'origine au moment d'être servis, et que les références croisées soient maintenues. Pour faire apparaître les titres traduits, utilisez le champ `fr-title`, ainsi que le paramètre de libellé dans les [[liens wikitext|Linking in WikiText]]. +: Pour disposer d'un libellé réduit, utile pour les onglets notamment, vous pouvez aussi traduire le champ `caption`. +; Quelques raccourcis sont à votre disposition +: sous forme de macros dans le tiddler [[$:/editions/fr-FR/util-macros]]. Ils facilitent la saisie des chaînes de caractères typiquement françaises (comme les <>, mais aussi de mots fréquents (comme <>) ou compliqués comme <> (qui a sa propre [[feuille de style|$:/editions/fr-FR/CSS stylesheets/latex]]). N'hésitez pas à en ajouter<> \ No newline at end of file