diff --git a/CHANGELOG.md b/CHANGELOG.md index 9b55c7bfd..243ff0722 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,8 @@ [#936](https://github.com/nextcloud/cookbook/pull/936) @zorglubu - Translate user documentation to French [#936](https://github.com/nextcloud/cookbook/pull/947) @zorglubu +- Updated French translation + [#957](https://github.com/nextcloud/cookbook/pull/957) @zorglubu ## 0.9.11 - 2022-03-28 diff --git a/docs/user/assets/create_import-fr.png b/docs/user/assets/create_import-fr.png new file mode 100644 index 000000000..0baf0945d Binary files /dev/null and b/docs/user/assets/create_import-fr.png differ diff --git "a/docs/user/assets/cr\303\251er_importer.png" "b/docs/user/assets/cr\303\251er_importer.png" deleted file mode 100644 index 04029eac8..000000000 Binary files "a/docs/user/assets/cr\303\251er_importer.png" and /dev/null differ diff --git a/docs/user/assets/keywords-and-categories-fr.png b/docs/user/assets/keywords-and-categories-fr.png new file mode 100644 index 000000000..57c1f1ad9 Binary files /dev/null and b/docs/user/assets/keywords-and-categories-fr.png differ diff --git "a/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.png" "b/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.png" deleted file mode 100644 index 3285827a3..000000000 Binary files "a/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.png" and /dev/null differ diff --git "a/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.xcf" "b/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.xcf" deleted file mode 100644 index 32ee44e22..000000000 Binary files "a/docs/user/assets/mots-cl\303\251s-et-cat\303\251gories.xcf" and /dev/null differ diff --git "a/docs/user/assets/param\303\250tres.png" "b/docs/user/assets/param\303\250tres.png" deleted file mode 100644 index 27efc7d77..000000000 Binary files "a/docs/user/assets/param\303\250tres.png" and /dev/null differ diff --git a/docs/user/assets/screen_structure-fr.png b/docs/user/assets/screen_structure-fr.png new file mode 100644 index 000000000..f5a1afe7d Binary files /dev/null and b/docs/user/assets/screen_structure-fr.png differ diff --git a/docs/user/assets/screen_structure.png b/docs/user/assets/screen_structure.png new file mode 100644 index 000000000..3efaed8b8 Binary files /dev/null and b/docs/user/assets/screen_structure.png differ diff --git a/docs/user/assets/settings-fr.png b/docs/user/assets/settings-fr.png new file mode 100644 index 000000000..a7083f16a Binary files /dev/null and b/docs/user/assets/settings-fr.png differ diff --git a/docs/user/index-fr.md b/docs/user/index-fr.md index 27704bb52..814685f76 100644 --- a/docs/user/index-fr.md +++ b/docs/user/index-fr.md @@ -3,6 +3,22 @@ ## Démarrer avec Cookbook +### Aperçu général + +![Screenshot of the app](assets/screen_structure-fr.png) + +1. Bouton pour créer une nouvelle recette +1. Champ pour télécharger une recette à partir d'une URL +1. Liste des catégories avec le nombre de recettes par catégorie +1. Bouton pour ouvrir/fermer le panneau latéral +1. La catégorie en cours +1. Mots-clés disponibles dans la catégorie en cours avec la nombre de recettes pour chaque mot-clé + - si un mot-clé devient indisponible parmi les recettes affichées, il devient grisé et non selectionnable +1. Liste déroulante pour différents ordres de tri des recettes +1. Les recettes avec leurs dates de création et de dernière modification + +### Où sont mes fichiers + Avant de créer votre première recette, vous devriez décider où seront stockées les recettes et images. Tous les fichiers seront accessibles dans votre gestionnaire de fichiers Nextcloud. @@ -11,19 +27,35 @@ Cela vous permet d'accéder à ces fichiers depuis une application tierce, en ut Par défaut, un répertoire *Recettes* sera situé dans votre répertoire principal. Vous pouvez simplement vérifier, dans les *Paramètres* de Cookbook, en bas à gauche, dans quel répertoire les recettes seront stockées sur Nextcloud. -## Ajouter une recette +![Settings](assets/settings-fr.png) + +## Créer / modifier / supprimer des recettes + +### Ajouter une nouvelle recette Cliquer sur le bouton *Créer une recette* et ajouter un titre et toute information utile. Si un bloc est vide, il ne sera pas affiché dans Cookbook. +### Ajouter une image + Une image peut être ajoutée à la recette. Il y a plusieurs façons de faire cela : - L'image peut être auparavant stockée sur votre instance Nextcloud. Cliquez sur l'icône à droite du champ image, et sélectionnez l'image. Cette dernière sera alors recopiée dans le répertoire de la recette. - L'image peut être chargée depuis une URL. Saisissez ou copiez l'URL dans le champ. L'application Cookbook téléchargera l'image et l'utilisera. +### Ajouter un lien + Des liens vers d'autres recettes peuvent être ajoutés dans les champs *Description*, *Ustensiles*, *Ingrédients*, et *Instructions* : - Tapez un `#` et sélectionnez, dans la liste déroulante, la recette à lier. +### Modifier une recette existante + +Cliquer sur la recette, puis cliquer sur le crayon en haut de l'écran. + +### Supprimer une recette + +Cliquer sur la recette, puis cliquer sur la poubelle en haut de l'écran. + ## Utiliser les mots-clés et catégories L'utilisation des mots-clés et catégories est totalement à votre choix. @@ -32,11 +64,9 @@ La différence principale entre les deux est qu'une recette ne peut avoir qu'une On peut accéder aux catégories de façon plus directe qu'aux mots-clés car elles sont affichées dans le panneau latéral. -En cliquant sur une catégorie dans le panneau latéral, vous pouvez filtrer rapidement des recettes comme "Plat principal" ou "Dessert". Les mots-clés peuvent ensuite être utilisés pour réduire la sélection avec des étiquettes comme "végétarien" ou "facile". De cette façon, les catégories opérent un filtrage large, et les mots-clés vont permettre d'affiner ce filtrage. - - -![Exemple utilisant les catégories pour un filtrage large, et les mots-clés pour affiner ce filtrage](assets/mots-clés-et-catégories.png) +En cliquant sur une catégorie dans le panneau latéral, vous pouvez filtrer rapidement des recettes comme "Légumes" ou "Pâtisserie". Les mots-clés peuvent ensuite être utilisés pour réduire la sélection avec des étiquettes comme "amandes" ou "facile". De cette façon, les catégories opérent un filtrage large, et les mots-clés vont permettre d'affiner ce filtrage. +![Exemple utilisant les catégories pour un filtrage large, et les mots-clés pour affiner ce filtrage](assets/keywords-and-categories-fr.png) ## Importer des Recettes @@ -44,19 +74,17 @@ En cliquant sur une catégorie dans le panneau latéral, vous pouvez filtrer rap Les recettes peuvent être importées en entrant une URL de recette dans le champ texte en haut à gauche de l'écran. -Champs pour importer une recette +![Champ pour importer une recette](assets/create_import-fr.png) Cependant l'application Cookbook nécessite que le site de recettes respecte les méta données JSON+LD du [standard des recettes schema.org](https://www.schema.org/Recipe). Les sites ne respectant pas ce standard ne sont à l'heure actuelle pas supportés. - ## Partager des recettes ### Partager avec un autre utilisateur Nextcloud Pour l'instant, la seule façon de partager des recettes est de partager, avec un autre utilisateur Nextcloud, le répertoire Nextcloud qui contient les recettes. À cette fin, le répertoire doit d'abord être partagé depuis le gestionnaire de fichiers de Nextcloud.Ensuite, il peut être indiqué comme répertoire de recette dans les *Paramètres* de l'application Cookbook. -Paramètres de Cookbook - +![Paramètres de Cookbook](assets/settings-fr.png) ### Partage public diff --git a/docs/user/index.md b/docs/user/index.md index e4cf99951..12dcc4f71 100644 --- a/docs/user/index.md +++ b/docs/user/index.md @@ -5,28 +5,62 @@ ## Starting with Cookbook +### How the app looks like + +![Screenshot of the app](assets/screen_structure.png) + +1. Button to create a new recipe +1. Field to download a recipe from an URL +1. List of categories with the number of recipes per category +1. Button to open/close the sidebar +1. The actual selected category +1. Keywords available in the current category with the number of recipes for each keyword + - if a keyword becomes unavailable among the displayed recipes, it is shaded and unselectable +1. Drop down list for different recipe's sort orders +1. The recipes with their creation date and last modification date + + +### Where are my files + Before creating your first recipe, you should decide where your recipes and pictures will be stored. All files will be accessible in your Nextcloud file manager. That allows you to access your files with 3rd party applications by using the usual Nextcloud file synchronization app/client. By default, the folder will be a localized folder in your users main folder. -You can simply check in the *Parameters* of Cookbook, in the low left corner, in which directory the recipes will be stored on Nextcloud. +You can simply check in the *Settings* of Cookbook, in the low left corner, in which directory the recipes will be stored on Nextcloud. + +![Settings](assets/settings.png) -## Adding a recipe +## Creating / modifying / removing recipes + +### Adding a new recipe Click on the button *Create a recipe* and add a title and any useful information. If a block of information is empty, it won't be displayed in Cookbook. - + +### Adding an image + An image may be added to the recipe. There are multiple ways to get this done: - The image can be previously stored on your Nextcloud instance. Click on the icon on the right of the image field, and select the image. Doing that, the image will be copied in the recipe's directory. - The image can be loaded from a URL. Just type or paste the URL in the field. The cookbook app will download and use the image. +### Adding a link + Links may be added to other recipes in the fields of *Description*, *Tools*, *Ingredients*, and *Instructions*: - Type a `#` and select, in the pop up list, the recipe to be linked. +### Modifying an existing recipe + +Click on the recipe, and then click on the pen on top of the screen. + +### Removing a recipe + +Click on the recipe, and then click on the dustbin on top of the screen. + + ## Using keywords and categories The use of keywords and categories is entirely up to you.