..
  Copyright (C)  2023  Jeremie Salvi.
  Permission is granted to copy, distribute and/or modify this document
  under the terms of the GNU Free Documentation License, Version 1.3
  or any later version published by the Free Software Foundation;
  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
  A copy of the license is included in the section entitled "GNU
  Free Documentation License".
  
Configuration de VSCodium
=========================

VSCodium est un fork de l'environnement de développement créé par windows, mais qui
suprime la télémétrie Microsoft, et remplace les quelques portions sous licence du 
logiciel, comme l'icone et le logo par exemple. Il n'a malheureusement plus accès à
la bibliothèque en ligne d'extensions, il en utilise une alternative plutôt bien fournie,
mais certaines extensions devront ête téléchargées et installées à la main. 

je vais documenter ici ma configuration, les astuces pour utliser l'environnement, et les
extensions générales que j'utilise. Pour celles propre à des projets ou des langages, je
le documenterai dans la section en conséquence.

Prérequis
---------

Codium est basé sur electron, il est donc multi-plateforme. Pour les prérequis, ils sont 
listés sur `AUR (Arch User Repositories)  <https://aur.archlinux.org/packages/vscodium-bin>`_.

Installation
------------

On l'installe comme n'importe quel paquet AUR :

.. code-block:: bash

  cd /opt
  git clone https://aur.archlinux.org/vscodium-bin.git
  cd vscodium-bin/
  makepkg
  pacman -U vscodium-bin-1.72.2.22289-1-x86_64.pkg.tar.zst

Extensions
----------

Atom One Dark Theme
~~~~~~~~~~~~~~~~~~~

Un thème sombre mais avec des contrastes meilleurs que celui de base.
C'est le thème de base de l'éditeur Atom.
Il est dans le store, il suffit de tapper dark thème

.. image:: ../images/atom_dark_theme_extension.png

reStructuredText Syntax highlighting
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Très pratique pour la documentation avec Sphinx. Disponible dans le store.

.. image:: ../images/reStructuredText_extension.png

emojisense
~~~~~~~~~~
Très pratique à utiliser avec sphinx pour agrémenter notre documentation de 
petits emoji 😃. on lance l'intellisense avec ``Ctrl+i``.

.. image:: ../images/emoji_extension.png