📘 Bienvenue dans ObsiGate

ObsiGate est votre porte d'entrée web vers vos vaults Obsidian. Accédez, naviguez et recherchez dans toutes vos notes depuis n'importe quel appareil via une interface moderne et responsive.

🧭 Interface utilisateur

En-tête

La barre supérieure contient les éléments essentiels :

• Bouton menu hamburger (mobile) : Affiche/masque la sidebar
• Bouton toggle sidebar (desktop) : Masque la sidebar pour plus d'espace
• Logo ObsiGate : Retour à l'accueil
• Barre de recherche : Recherche globale avec autocomplétion
• Indicateur de vault : Affiche le contexte actif (All, vault1, etc.)
• Menu Options : Accès aux paramètres, thème, aide

Sidebar (barre latérale)

La sidebar est divisée en deux onglets :

• Vaults : Arborescence des fichiers et dossiers
• Tags : Nuage de tags cliquables

Fonctionnalités de la sidebar :

• Filtrage : Barre de recherche pour filtrer fichiers/tags
• Sélection rapide : Dropdown pour changer de vault
• Redimensionnement : Glissez le bord droit pour ajuster la largeur
• Masquage : Cliquez sur l'icône sidebar dans le header

Zone de contenu

La zone centrale affiche :

• Breadcrumb : Chemin du fichier (cliquable pour repositionner la sidebar)
• Titre et tags : Métadonnées du fichier
• Boutons d'action : Copier, Source, Télécharger, Éditer, Ouvrir dans nouvelle fenêtre
• Contenu rendu : Markdown avec wikilinks et images

🗺️ Navigation

Arborescence des vaults

Cliquez sur un vault pour l'ouvrir et voir son contenu. Les dossiers affichent un chevron et un badge avec le nombre d'éléments.

• Développer/Réduire : Cliquez sur un dossier
• Ouvrir un fichier : Cliquez sur le nom du fichier
• Icônes : Chaque type de fichier a son icône (markdown, code, etc.)

Filtrage de la sidebar

Utilisez la barre de filtrage en haut de la sidebar pour rechercher rapidement :

• Recherche instantanée : Tapez pour filtrer fichiers et dossiers
• Case-sensitive : Bouton "Aa" pour respecter la casse
• Effacer : Bouton "×" pour réinitialiser le filtre
• Résultats groupés : Affichage par vault avec chemins complets

Breadcrumb et repositionnement

Le chemin affiché au-dessus du contenu est interactif :

• Cliquez sur le vault : Focus sur le vault dans la sidebar
• Cliquez sur un segment : Navigation vers ce dossier
• Auto-scroll : La sidebar se positionne automatiquement

Sélection de vault

Changez de contexte pour filtrer l'affichage :

• Menu header : Dropdown "Vault" dans le menu Options
• Sidebar dropdown : Sélection rapide en haut de l'onglet Vaults
• Tous les vaults : Vue globale de tous vos contenus
• Vault spécifique : Focus sur un seul vault

🔍 Recherche

Recherche simple

Tapez dans la barre de recherche en haut pour lancer une recherche fulltext :

• Recherche dans tout : Titre, contenu, tags, chemins
• Scoring intelligent : Résultats classés par pertinence TF-IDF
• Snippets surlignés : Extraits avec termes en surbrillance
• Pagination : Navigation par pages de 50 résultats

Opérateurs avancés

Utilisez des opérateurs pour affiner votre recherche :

• tag:docker ou #docker : Filtrer par tag
• vault:IT : Rechercher dans un vault spécifique
• title:kubernetes : Chercher dans les titres uniquement
• path:recettes/soupes : Filtrer par chemin
• "phrase exacte" : Recherche de phrase entre guillemets

Exemple : tag:linux vault:IT serveur web recherche "serveur web" dans le vault IT avec le tag linux.

Autocomplétion

L'autocomplétion vous aide à trouver rapidement :

• Historique : Les 50 dernières recherches (localStorage)
• Fichiers : Suggestions de titres de fichiers
• Tags : Suggestions de tags avec compteurs
• Navigation clavier : ↑/↓ pour naviguer, Enter pour sélectionner

Chips de filtres actifs

Les opérateurs utilisés s'affichent sous forme de chips colorés :

• Visualisation : Voir d'un coup d'œil les filtres actifs
• Suppression : Cliquez sur "×" pour retirer un filtre
• Couleurs : Chaque type d'opérateur a sa couleur

Facettes et tri

Les résultats incluent des facettes pour affiner :

• Facettes tags : Compteurs par tag dans les résultats
• Facettes vaults : Compteurs par vault
• Tri par pertinence : Score TF-IDF (défaut)
• Tri par date : Dernière modification

🏷️ Tags

Tag cloud

L'onglet Tags de la sidebar affiche un nuage de tags :

• Tous les tags : Extraits des frontmatters YAML et inline (#tag)
• Cliquable : Cliquez pour filtrer les résultats
• Filtrage : Utilisez la barre de filtrage pour chercher un tag
• Contexte vault : Les tags s'adaptent au vault sélectionné

Tags inline vs frontmatter

ObsiGate supporte deux types de tags :

• Frontmatter YAML : tags: [docker, linux] ou tags: docker, linux
• Inline : #docker dans le contenu markdown
• Fusion automatique : Les deux types sont combinés

Filtrage de tags template

Dans les Configurations, vous pouvez masquer les tags de template :

• Patterns wildcards : Ex: #<% ... %> ou #{{ ... }}
• Regex générée : Aperçu de la regex appliquée
• Ajout/Suppression : Gérez vos patterns de filtrage

📄 Fichiers

Visualisation

Les fichiers markdown sont rendus avec :

• Wikilinks cliquables : [[lien]] et [[lien|texte]]
• Images Obsidian : Support de ![[image.png]]
• Syntax highlighting : Coloration des blocs de code
• Tables, listes, quotes : Rendu complet du markdown

Actions sur fichiers

Boutons disponibles au-dessus du contenu :

• Copier : Copie le contenu source dans le presse-papiers
• Source : Affiche/masque le markdown brut
• Télécharger : Télécharge le fichier
• Éditer : Ouvre l'éditeur CodeMirror
• Ouvrir dans nouvelle fenêtre : Ouvre le fichier dans un nouvel onglet

Édition avec CodeMirror 6

L'éditeur intégré offre :

• Coloration syntaxique : Support de nombreux langages
• Numéros de ligne : Navigation facile
• Autocomplétion : Suggestions contextuelles
• Recherche : Ctrl+F pour chercher dans le fichier
• Sauvegarde : Bouton ✓ pour enregistrer
• Suppression : Bouton corbeille pour supprimer

Types de fichiers supportés

ObsiGate indexe et affiche :

• Markdown : .md (rendu complet)
• Code : .py, .js, .ts, .jsx, .tsx, .java, .c, .cpp, .rs, .go, etc.
• Config : .json, .yaml, .yml, .toml, .xml, .ini, .env
• Scripts : .sh, .bash, .ps1, .bat
• Web : .html, .css, .scss
• Autres : .txt, .log, .sql, .csv

🎨 Personnalisation

Thème clair/sombre

Basculez entre les thèmes :

• Menu Options : Cliquez sur "Thème" dans le menu
• Raccourci : Ctrl+T
• Persistance : Votre choix est sauvegardé en localStorage
• Highlight.js : Les blocs de code s'adaptent au thème

Redimensionnement de la sidebar

Sur desktop, ajustez la largeur de la sidebar :

• Handle de redimensionnement : Bordure droite de la sidebar
• Glisser-déposer : Cliquez et glissez pour ajuster
• Limites : Min 200px, Max 500px
• Persistance : La largeur est sauvegardée

Configuration avancée

Le modal Configurations (menu Options) permet de :

• Paramètres de recherche : Délai debounce, résultats par page, timeout
• Paramètres backend : Workers, boosts TF-IDF, expansions préfixe
• Filtrage de tags : Patterns pour masquer les tags template
• Diagnostics : Stats index, mémoire, moteur de recherche
• Réindexation : Forcer un rescan des vaults

⌨️ Raccourcis clavier

Navigation

• Ctrl+K ou Cmd+K : Focaliser la barre de recherche
• / : Focaliser la recherche (hors champ texte)
• Escape : Fermer les suggestions / quitter la recherche

Recherche et autocomplétion

• ↑ / ↓ : Naviguer dans les suggestions
• Enter : Sélectionner la suggestion active ou lancer la recherche
• Escape : Fermer le dropdown de suggestions

Interface

• Ctrl+T : Basculer le thème clair/sombre

Éditeur CodeMirror

• Ctrl+F : Rechercher dans le fichier
• Ctrl+Z : Annuler
• Ctrl+Y : Refaire
• Ctrl+S : Sauvegarder (si configuré)

💡 Astuces et bonnes pratiques

Workflow recommandé

1. Sélectionnez un contexte : Choisissez un vault pour réduire le bruit
2. Explorez l'arborescence : Naviguez dans les dossiers
3. Utilisez les tags : Filtrez par tags pour affiner
4. Recherchez intelligemment : Combinez opérateurs et texte libre
5. Profitez de l'historique : Réutilisez vos recherches fréquentes

Optimisations

• Masquez la sidebar : Plus d'espace pour le contenu
• Utilisez le filtrage sidebar : Plus rapide que la recherche globale pour trouver un fichier
• Favorisez les opérateurs : tag: et vault: accélèrent la recherche
• Breadcrumb cliquable : Repositionnez rapidement la sidebar

Trucs et astuces

• Navigation visuelle : Le breadcrumb repositionne automatiquement la sidebar
• Gestion de l'espace : Réduisez les sections Vaults/Tags selon vos besoins
• Confort de lecture : Ajustez la largeur de la sidebar
• Mobile-friendly : Utilisez le bouton hamburger sur mobile
• Wikilinks : Naviguez entre notes comme dans Obsidian
• Images : Support complet des syntaxes Obsidian

Cas d'usage avancés

• Recherche multi-critères : tag:docker tag:linux vault:IT nginx
• Exploration par tags : Cliquez sur un tag dans une note pour voir toutes les notes similaires
• Édition rapide : Ouvrez l'éditeur, modifiez, sauvegardez
• Export : Téléchargez des fichiers pour backup ou partage
• Multi-fenêtres : Ouvrez plusieurs notes dans des onglets séparés