Files
personotes/notes/documentation/bienvenue.md
2025-11-12 17:16:13 +01:00

293 lines
5.7 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Bienvenue dans PersoNotes
date: 08-11-2025
last_modified: 09-11-2025:01:13
tags:
- aide
- documentation
- tutorial
---
08/11/2025 -
C'est mon application de prise de note
## J'espére qu'elle va bien marcher
# Bienvenue dans PersoNotes
Bienvenue dans votre application de prise de notes en Markdown ! Cette page vous explique comment utiliser l'application et le format front matter.
## Qu'est-ce que le Front Matter ?
Le **front matter** est un bloc de métadonnées en YAML placé au début de chaque note, entre deux lignes `---`. Il permet d'ajouter des informations structurées à vos notes.
### Format du Front Matter
```yaml
---
title: Titre de votre note
date: 08-11-2025
last_modified: 08-11-2025:14:10
tags: [projet, urgent, backend]
---
```
### Champs disponibles
- **title** : Le titre de votre note (généré automatiquement depuis le nom du fichier)
- **date** : Date de création (format: JJ-MM-AAAA)
- **last_modified** : Dernière modification (format: JJ-MM-AAAA:HH:MM) - mis à jour automatiquement
- **tags** : Liste de tags pour organiser et rechercher vos notes
### Exemples de tags
Vous pouvez écrire vos tags de deux façons :
```yaml
# Format inline
tags: [projet, urgent, backend, api]
# Format liste
tags:
- projet
- urgent
- backend
- api
```
Les tags sont indexés et permettent de rechercher vos notes via la barre de recherche.
## Guide Markdown
### Titres
```markdown
# Titre niveau 1
## Titre niveau 2
### Titre niveau 3
```
### Emphase
```markdown
*italique* ou _italique_
**gras** ou __gras__
***gras et italique***
~~barré~~
```
Rendu : *italique*, **gras**, ***gras et italique***
### Listes
#### Liste non ordonnée
```markdown
- Élément 1
- Élément 2
- Sous-élément 2.1
- Sous-élément 2.2
- Élément 3
```
Rendu :
- Élément 1
- Élément 2
- Sous-élément 2.1
- Sous-élément 2.2
- Élément 3
#### Liste ordonnée
```markdown
1. Premier élément
2. Deuxième élément
3. Troisième élément
```
Rendu :
1. Premier élément
2. Deuxième élément
3. Troisième élément
### Liens et Images
```markdown
[Texte du lien](https://example.com)
![Texte alternatif](url-de-image.jpg)
```
Exemple : [Documentation Markdown](https://www.markdownguide.org/)
### Code
#### Code inline
Utilisez des backticks : `code inline`
#### Bloc de code
```markdown
```javascript
function hello() {
console.log("Hello World!");
}
```
```
Rendu :
```javascript
function hello() {
console.log("Hello World!");
}
```
### Citations
```markdown
> Ceci est une citation
> sur plusieurs lignes
```
Rendu :
> Ceci est une citation
> sur plusieurs lignes
### Tableaux
```markdown
| Colonne 1 | Colonne 2 | Colonne 3 |
|-----------|-----------|-----------|
| Ligne 1 | Données | Données |
| Ligne 2 | Données | Données |
```
Rendu :
| Colonne 1 | Colonne 2 | Colonne 3 |
|-----------|-----------|-----------|
| Ligne 1 | Données | Données |
| Ligne 2 | Données | Données |
### Séparateurs
```markdown
---
```
Rendu :
---
## Commandes Slash
Utilisez le caractère `/` au début d'une ligne pour accéder aux commandes rapides :
- `/h1`, `/h2`, `/h3` - Titres
- `/list` - Liste à puces
- `/date` - Insérer la date du jour
- `/link` - Créer un lien
- `/bold` - Texte en gras
- `/italic` - Texte en italique
- `/code` - Code inline
- `/codeblock` - Bloc de code
- `/quote` - Citation
- `/hr` - Ligne de séparation
- `/table` - Créer un tableau
**Navigation** : Utilisez les flèches ↑↓ pour naviguer, Entrée ou Tab pour insérer, Échap pour annuler.
## Raccourcis et Astuces
### Créer une note
Cliquez sur le bouton **✨ Nouvelle note** dans l'en-tête. Si la note existe déjà, elle sera ouverte, sinon elle sera créée.
### Rechercher des notes
Utilisez la barre de recherche en haut pour filtrer vos notes par tags. La recherche est mise à jour en temps réel.
### Sauvegarder
Cliquez sur le bouton **💾 Enregistrer** pour sauvegarder vos modifications. Le champ `last_modified` du front matter sera automatiquement mis à jour.
### Supprimer une note
Cliquez sur l'icône 🗑️ à côté du nom de la note dans la sidebar.
## Organisation avec les tags
Les tags sont un excellent moyen d'organiser vos notes. Voici quelques suggestions :
- **Par projet** : `projet-notes`, `projet-api`, `projet-frontend`
- **Par priorité** : `urgent`, `important`, `backlog`
- **Par type** : `documentation`, `tutorial`, `meeting`, `todo`
- **Par technologie** : `javascript`, `go`, `python`, `docker`
- **Par statut** : `en-cours`, `terminé`, `archive`
## Exemple complet
Voici un exemple de note complète :
```markdown
---
title: Réunion API Backend
date: 08-11-2025
last_modified: 08-11-2025:15:30
tags: [meeting, backend, api, urgent]
---
# Réunion API Backend
## Participants
- Alice (Lead Dev)
- Bob (Backend)
- Charlie (Frontend)
## Points discutés
### 1. Architecture de l'API
Nous avons décidé d'utiliser une architecture REST avec les endpoints suivants :
- `GET /api/notes` - Liste toutes les notes
- `POST /api/notes` - Créer une note
- `PUT /api/notes/:id` - Modifier une note
- `DELETE /api/notes/:id` - Supprimer une note
### 2. Authentification
> Utilisation de JWT pour l'authentification
Code d'exemple :
```go
func generateToken(userID string) (string, error) {
// Implementation
}
```
### 3. Prochaines étapes
- [ ] Implémenter les endpoints
- [ ] Écrire les tests
- [ ] Documentation API
## Actions
| Qui | Action | Deadline |
|---------|---------------------|------------|
| Bob | Endpoints API | 15-11-2025 |
| Charlie | Interface Frontend | 20-11-2025 |
| Alice | Review & Deploy | 25-11-2025 |
```
---
Bonne prise de notes ! 📝