feat: support drafts

.aspell.fr.pws

@@ -1,4 +1,4 @@
-personal_ws-1.1 fr 239 
+personal_ws-1.1 fr 241 
 AVAX
 Aborted
 Add
@@ -22,6 +22,7 @@ DIP
 DNS
 Debian
 Deploy
+Dusk
 EKO
 EVO
 Ethereum
@@ -217,6 +218,7 @@ staker
 staking
 stream
 sup
+tDUSK
 tags
 teacher
 than

build.sh

@@ -4,6 +4,8 @@ SRC_DIR='sources'
 DST_DIR='luma'
 
 dev_live() {
+    [ -d '_live' ] && /bin/rm -rv '_live'
+
     sphinx-autobuild \
         --host '0.0.0.0' \
         --open-browser \
@@ -40,4 +42,8 @@ build_blog() {
     python minify.py
 }
 
-[ "${1}" == 'live' ] && dev_live || build_blog
+if [ "${1}" == 'live' ]; then
+    dev_live
+else
+    build_blog
+fi

sources/brouillons/diff-metadata.md

@@ -0,0 +1,34 @@
+# Comprendre les méta-données de diff
+
+Voici la sortie de `git diff` sur un fichier lambda :
+
+```{literalinclude} snippets/diff-metadata.diff
+    :caption: https://github.com/gorakhargosh/watchdog/issues/1025
+    :linenos:
+    :emphasize-lines: 2
+    :language: diff
+```
+
+Voyons de quoi se compose la ligne n° 2 :
+
+```{literalinclude} snippets/diff-metadata.diff
+    :lines: 2
+    :language: diff
+```
+
+```{literalinclude} snippets/diff-metadata.c
+    :caption: diff.c
+    :lines: 2-
+    :language: c
+```
+
+---
+
+## 🎣 Sources
+
+- [git/git diff.c](https://github.com/git/git/blob/v2.43.0/diff.c#L4480-L4484)
+
+## 📜 Historique
+
+2024-02-07
+: Premier jet.

sources/brouillons/node-dusk.md

@@ -0,0 +1,69 @@
+# Comment déployer un nœud Dusk ?
+
+```{figure} images/dusk-logo.svg
+ :width: 96
+  :height: 96
+  :alt: NuLink Logo
+  :align: center
+
+  Site web : [dusk.network](https://dusk.network)
+```
+
+```{attention}
+Cet article est en cours de rédaction.
+```
+
+Ce guide est une traduction libre et simplifiée de la [documentation officielle](https://docs.nulink.org/products/stakers/nulink_worker/) pour le déploiement d'un nœud Dusk, plus communément appelé *node validator*, *worker node* ou encore *staker node*.
+
+Configuration requise :
+
+- système d'exploitation : **Debian** GNU/Linux
+- architecture : x86-64
+- espace disque : 250 Gio
+- mémoire : 4 Gio de RAM
+
+À savoir, il te faudra 2 comptes :
+1. un compte *staker* qui *stake* ses [tDUSK](https://testnet.bscscan.com/token/0xa22bfb00be8938c50833bfd2444ec721a9eeacc1), n'importe quel compte Metamask ou Rabby fait l'affaire ;
+2. un compte *worker* qui sera lié au compte *staker* (on parle de *bond* en anglais), et nous allons voir tout de suite comment le générer.
+
+---
+
+## Avant-propos
+
+Les futures commandes à taper dans une console sont précédées par une légende pour indiquer sur quel environnement elles doivent être exécutées.
+
+Exemple avec une commande qui devra être tapée dans la console de ton ordinateur (PC) :
+
+```{code-block} shell
+    :caption: 🖥️ Ordinateur (PC)
+
+echo "Coucou depuis l'ordi !"
+```
+
+Et une commande qui devra être tapée dans la console du serveur (VPS, pour *Virtual Private Server*) sur lequel le nœud sera déployé :
+
+```{code-block} shell
+    :caption: ☁️ Serveur (VPS)
+
+echo 'Coucou depuis le serveur !'
+```
+
+```{tip}
+Chaque commande peut être copiée/collée directement depuis cet article vers ta console (il y a une icône qui apparait en haut à droite de chaque bloc de code quand la souris passe dessus).
+Quand il y a une partie de la commande a modifier manuellement :
+- je le préciserai en amont ;
+- la légende du bloc de code contiendra l'émoji ✍️ ;
+- la/les ligne en question sera surlignée.
+```
+
+```{tip}
+Afin de vérifier qu'une commande se soit terminée avec succès, tu dois voir que la dernière ligne affichée dans la console, après l'avoir exécutée, devra être "OK".
+Si ce n'est pas le cas, il y a eu une erreur.
+```
+
+---
+
+## 📜 Historique
+
+2024-01-27
+: Premier jet.

sources/brouillons/snippets/diff-metadata.c

@@ -0,0 +1,25 @@
+/* https://github.com/git/git/blob/v2.43.0/diff.c#L4480-L4484 */
+static void fill_metainfo(
+    struct strbuf *msg,
+    const char *name,
+    const char *other,
+    struct diff_filespec *one,
+    struct diff_filespec *two,
+    struct diff_options *o,
+    struct diff_filepair *p,
+    int *must_show_header,
+    int use_color
+) {
+    /* (...) */
+    strbuf_addf(
+        msg,
+        "%s%sindex %s..%s",
+        line_prefix,
+        set,
+        diff_abbrev_oid(&one->oid, abbrev),
+        diff_abbrev_oid(&two->oid, abbrev)
+    );
+    if (one->mode == two->mode) {
+        strbuf_addf(msg, " %06o", one->mode);
+    }
+}

sources/brouillons/snippets/diff-metadata.diff

@@ -0,0 +1,12 @@
+diff --git a/setup.py b/setup.py
+index 320d951..644d2b7 100644
+--- a/setup.py
++++ b/setup.py
+@@ -71,6 +71,7 @@ if is_macos or os.getenv("FORCE_MACOS_MACHINE", "0") == "1":
+                 "-Wno-newline-eof",
+                 # required w/Xcode 5.1+ and above because of '-mno-fused-madd'
+                 "-Wno-error=unused-command-line-argument",
++                "-mmacosx-version-min=10.13",
+             ],
+         ),
+     ]

sources/conf.py

@@ -71,3 +71,7 @@
     "source_docs_path": "/sources/",
     "source_version": "main",
 }
+
+# Do not include drafts when deploying to production
+if sys.argv[0].endswith("sphinx-build"):
+    exclude_patterns = ["brouillons/**"]

sources/index.rst

@@ -10,6 +10,12 @@ Base de Connaissances du `Luma`_
     :alt: Logo
     :align: center
 
+.. toctree::
+    :caption: 🚧 Brouillons
+    :glob:
+
+    brouillons/*
+
 .. toctree::
     :caption: 👾 Blockchain
     :glob: