Comment ne pas être perdu avec VSCode quand on vient de RStudio ?

Puis-je ouvrir un projet RStudio et être dans les mêmes conditions ?

Oui. Vous devez ouvrir votre répertoire directement : Fichier > Ouvrir le dossier.
Le répertoire de travail est la racine du projet.

Puis-je avoir plusieurs sessions VSCode en parallèle ?

Oui. Ouvrez une nouvelle fenêtre, puis vous pouvez ouvrir un nouveau projet : Fichier > Nouvelle fenêtre.

Je ne comprend pas sa façon d’ouvrir des fichiers dans des onglets…

• Double clic sur le nom du fichier : Ouvrir le fichier
• SHIFT + double-clic : Ouvrir dans un nouvel onglet
• CTRL + double-clic : Ouvrir dans un nouvel onglet avec une vue parallèle

Où est l’auto-indentation de mon code ?

Je ne sais pas ! Mais vous pouvez toujours utiliser l’Addin de {styler}

• Sélectionner son code
• CTRL + SHIFT + P
• Trouver “Rstudio Addin”
• Exécuter “Style selection” de {styler}

C’est quoi tous ces chiffres à côté de mon nom de fichier ?

Les sorties {lintr}. Lorsque vous ouvrez un fichier, {lintr} analyse votre code pour trouver les problèmes et les pratiques qui ne suivent pas le style classique d’écriture du code R.

Les lignes ou les mots problématiques sont soulignés dans le code. Survolez les avec votre souris pour obtenir l’information.

Comment démarrer et utiliser un fichier Rmarkdown ?

Vous le savez peut-être, je suis un grand fan de la méthode ‘Rmd First’ pour développer mes analyses et mes packages. C’est d’ailleurs la raison pour laquelle j’ai développé {fusen} : un package pour développer un package à partir d’un simple fichier Rmarkdown. Du coup, la possibilité de travailler avec un fichier RMarkdown dans VSCode est l’une de mes principales préoccupations.

Je n’ai pas trouvé comment ajouter le modèle par défaut comme dans RStudio. Cependant, vous pouvez démarrer un des deux modèles inclus dans {rmarkdown} :

• rmarkdown::draft(file = "bonjour", template = "github_document", package = "rmarkdown", edit = FALSE)
• rmarkdown::draft(file = "bonjour", template = "html_vignette", package = "rmarkdown", edit = FALSE)

Ensuite, ouvrez le fichier et écrivez votre code.

• Tricoter avec : CTRL + SHIFT + K
• Il n’y a pas de raccourci par défaut pour ajouter un nouveau chunk, mais vous pouvez créer des raccourcis clavier (voir ci-dessous).

Notez que vous pouvez ouvrir un aperçu en direct du fichier en cliquant sur l’icône de division avec une loupe en haut à droite de votre fichier.

Où est ma console R ?

Elle n’est pas ouverte par défaut lors de l’ouverture de votre projet R, car VSCode n’est pas spécifique aux utilisateurs de R. Mais vous êtes à un clic de l’ouvrir.

Cliquez sur “R: (not attached)” dans la barre de bas de page.

Y a-t-il une autocomplétion des fonctions et de l’aide de R ?

Oui, il y a une autocomplétion dans les fichiers avec l’apparition de la boîte d’aide des fonctions. Il y a une autocomplétion dans la Console R. Il y a aussi l’autocomplétion des balises “roxygen” lors de l’écriture de la documentation des fonctions.

Y a-t-il une autocomplétion pour les chemin de fichiers ?

Oui, si vous installez le plugin Path Intellisense : https://github.com/ChristianKohler/PathIntellisense

• Vous devrez commencer votre chemin relatif par "./" pour que l’autocomplétion démarre.

Comment puis-je savoir que mon fichier n’est pas encore enregistré ?

Il y a un point à droite de l’onglet du fichier.

Comment je “commit” et “push” mes modifications?

• Aller dans le menu Git

• Cliquez sur le + le long du nom du fichier que vous voulez ajouter au prochain commit. Notez des lettres similaires à celles que vous trouvez sur RStudio concernant l’état de vos fichiers (M, U, A, …).
  

• Vous pouvez rédiger votre message de commit

• Appuyez sur “CTRL + Enter” pour créer le commit.

• Cliquez sur les 3 points ... pour pousser vers le serveur.

  • Liste des opérations sur le dépôt git, comme push ou pull.

Dans le menu git view, lorsque vous ouvrez un des fichiers listés, vous verrez le “diff” avec la version commitée précédente.

Quels raccourcis clavier sont les mêmes?

• CTRL + Enter: Exécuter le code surligné
• CTRL + F: Chercher un mot dans le fichier en cours
• CTRL + SHIFT + F: Chercher un mot dans tout le dépôt
• CTRL + SHIFT + K: Knit un fichier RMarkdown

Puis-je ouvrir un répertoire avec plusieurs dépôts git ?

Oui De cette façon, vous pourrez voir l’état git de tous vos dépôts dans ce répertoire.

Conseils : J’ai un répertoire avec tous mes projets GitHub et je peux connaître leur état avec une vue unique.

Avantages : C’est bien parce que vous pouvez être sûr que vous n’avez pas de commit restant localement, jamais envoyé au serveur.

Inconvénients : Ne vous attendez pas à utiliser ce type de vue pour travailler avec R sur un projet spécifique, car le répertoire de travail ne sera pas celui que vous attendez comme venant de RStudio.

Comment commenter un groupe de lignes avec # ?

• CTRL + SHIFT + :

Comment explorer le code d’une fonction ?

VSCode n’ouvre pas automatiquement le code d’une fonction comme un fichier texte comme avec F2 et en utilisant browser() ou debugonce().

• Je peux utiliser manuellement View(function).

Où sont mes “Addins” RStudio ?

• Utilisez CTRL + SHIFT + P pour ouvrir l’explorateur de commandes.

  • Tapez “RStudio Addin”.

  • Trouvez l’addin que vous voulez utiliser

D’autres astuces ou différences intéressantes ?

• Utiliser CTRL + SHIFT + P pour ouvrir l’explorateur de commandes

• Dans Ubuntu, la console R est un terminal. Cela signifie que :

  • CTRL + C : Arrête l’action en cours (pas de copie)

  • SHIFT + Insert : Coller le texte que vous avez copié

• Les fonctions de {rstudioapi} fonctionnent en l’état avec VSCode

Où trouver VSCode ?

https://code.visualstudio.com/

Comment installer un plugin ?

Cliquez sur l’icône des quatre carrés à gauche de VSCode et commencez à chercher les plugins disponibles.

Requis: Installation de vscode-r

• vscode-r est un plugin VSCode : https://marketplace.visualstudio.com/items?itemName=Ikuyadeu.r
  • Installer sur Ubuntu : https://github.com/Ikuyadeu/vscode-R/wiki/Installation:-Linux

Outils Git

• GitLens - Git supercharged

  • Permet d’afficher l’historique de git et le “blame” de git en fonction des fichiers ouverts

  • Vue de l’historique Git

Autocompletion de chemins de fichiers

• Path Intellisense: https://github.com/ChristianKohler/PathIntellisense

Trouver tous les raccourcis clavier existants

CTRL + K, CTRL + S

Comment ajouter mes raccourcis clavier ?

Lorsque vous êtes dans la liste des raccourcis clavier, cliquez sur le bouton supérieur droit

Quelques raccourcis clavier intéressants à ajouter à “keybindings.json” pour commencer

Comme dit plus haut, je ne vous propose pas trop de modifications des fonctionnalités originales pour que l’environnement soit similaire entre utilisateurs.

• https://github.com/REditorSupport/vscode-R/wiki/Keyboard-shortcuts
• Pour PC (Pour MacOS, remplacer ctrl par cmd)

// Place your key bindings in this file to override the defaultsauto[]
[
    // assignment
    {
        "key": "alt+-",
        "command": "type",
        "when": "editorLangId == r || editorLangId == rmd && editorTextFocus",
        "args": {
            "text": " <- "
        }
    },
    // Pipe
    {
        "key": "ctrl+shift+m",
        "command": "type",
        "when": "editorLangId == r || editorLangId == rmd && editorTextFocus",
        "args": {
            "text": " |> "
        }
    },
    // Insert a chunk
    {
        "key": "ctrl+alt+i",
        "command": "type",
        "when": "editorLangId == r || editorLangId == rmd && editorTextFocus",
        "args": {
            "text": "```{r}\n\n```"
        }
    },
    // Roxygen skeleton
    {
        "key": "ctrl+alt+shift+r",
        "command": "type",
        "when": "editorLangId == r || editorLangId == rmd && editorTextFocus",
        "args": {
            "text": "#' Title\n#'\n#'Description\n#'\n#'@param $$\n#'\n#'@export\n#'\n#'@example\n#'"
        }
    }
]