Setup DME et éditeurs

DME sur LXUP

Ce site web que tu lis actuellement intègres DME pour le rendu de ces pages ! Rien à installer à ce niveau.

Installer DME Desktop

DME c'est aussi une application desktop en cours de développement. Il n'y a pas encore de binaire publiquement disponible pour le moment, notamment parce que le projet n'est pas encore assez mature. Demander à Samuel Roland de lui envoyer une version de développement.

Pour les plus aventureux, il est possible de compiler depuis la source: https://github.com/samuelroland/dme

Démarrer DME facilement depuis diverses IDE

DME n'a pas d'extension dédiée à chaque IDE, cela serait beaucoup de travail pour peu de résultat. Le besoin principal est d'ouvrir l'aperçu d'un fichier Markdown ouvert. Techniquement, cela signifie définir un raccourci lançant la commande externe dme <fichier en cours>. Cette section permet de faciliter cette mise en place.

VSCode

VSCode ne supporte pas de lancement de commande externe depuis son système de raccourci. Il est nécessaire d'installer une extension pour le supporter.

Plusieurs extensions existe, nous avons choisi Command Runner.

code --install-extension edonet.vscode-command-runner

Dans settings.json qui s'ouvre avec Ctrl+shift+P > Preferences: Open User Settings (JSON), il suffit de rajouter ces configurations.

    "command-runner.terminal.name": "Command Runner Terminal",
    "command-runner.terminal.autoClear": true,
    "command-runner.terminal.autoFocus": false,
    "command-runner.commands": {
        "dme": "dme ${file} &"
    },

Dans keybindings.json qui s'ouvre avec Ctrl+shift+P > Preferences: Open Keyboard Shortcuts (JSON), il suffit de rajouter cette entrée. Elle redéfinit le raccourci d'aperçu ctrl+shift+v pour lancer la commande définie précédemment.

    // Use DME for Markdown Preview
    {
        "key": "ctrl+shift+v",
        "when": "editorLangId == markdown",
        "command": "command-runner.run",
        "args": {
            "command": "dme"
        }
    },

Pour valider l'intégration, ouvre n'importe quel fichier Markdown et press ctrl+shift+v. A la place de l'aperçu par défaut de VSCode, tu devrais voir une nouvelle fenêtre DME affichant le contenu du fichier.

Neovim

Tu peux reprendre cette définition Lua dans ta configuration et changer le raccourci si nécessaire.

-- Using DME as Markdown previewer - leader markdown preview
vim.keymap.set("n", "<leader>mp", function()
  vim.fn.jobstart({ "dme", vim.fn.expand("%:p") }, { detach = true })
end, { desc = "Markdown preview with DME" })

Autres ?

Contributions bienvenues !