Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Binary file added docs/user/assets/create_import-fr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/user/assets/créer_importer.png
Binary file not shown.
Binary file added docs/user/assets/keywords-and-categories-fr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/user/assets/mots-clés-et-catégories.png
Binary file not shown.
Binary file removed docs/user/assets/mots-clés-et-catégories.xcf
Binary file not shown.
Binary file removed docs/user/assets/paramètres.png
Binary file not shown.
Binary file added docs/user/assets/screen_structure-fr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/assets/screen_structure.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/assets/settings-fr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
46 changes: 37 additions & 9 deletions docs/user/index-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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.
Expand All @@ -32,31 +64,27 @@ 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

### Importer depuis un site web

Les recettes peuvent être importées en entrant une URL de recette dans le champ texte en haut à gauche de l'écran.

<img src="assets/créer_importer.png" alt="Champs pour importer une recette" width="200px" />
![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.

<img src="assets/paramètres.png" alt="Paramètres de Cookbook" width="200px" />

![Paramètres de Cookbook](assets/settings-fr.png)

### Partage public

Expand Down
40 changes: 37 additions & 3 deletions docs/user/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down