---
robots: noindex, nofollow
---
# PKM - Brainstorming
## 25/03/2024

:::info
Présent.e.s :
- Konrad Hinsen
- Nicolas Roelandt
- Nicolas Sauret
- Sébastien RC
- Raphaelle K.

Durée : ~1h
:::

### sur PKM - échanges sur les technos / veille / questions posées

- liste de liens "techno"
- question éditoriale / design / webinaire du 27 mai avec Nicolas Rougier
https://inacheve-dimprimer.net/
https://inacheve-dimprimer.net/articles/2021-05-27-nicolas-rougier.html
- dispositif utilisé actuellement sur le PKM
https://silverbullet.md/
- webomatic / éditorialisation d'ouvrage à partir de plateformes md
https://webomatic.vercel.app/
https://gitlab.com/pgno/webomatic
- hackmd import/export
https://github.com/hedgedoc/hedgedoc/issues/222
- liste de liens "sur le collectif"
- initiative alsacienne de culture convivialiste (réseau Eveille & Eco-info)
http://katzele.netlib.re/
- sur le détournement de gitlab - travail asynchrone & synchrone d'une traduction
https://intelligibilite-numerique.numerev.com/numeros/n-5-2024/2916-traduire-collectivement-l-ontologie-formelle-du-cidoc-crm-en-francais-sur-la-plateforme-gitlab-un-projet-sous-le-prisme-simondonien-d-un-humanisme-technologique

### sur la JE du GT notebook de l'automne à Condorcet (?)
- point budget, la demande côté CIST permet d'avoir 3000€ de plus qui viennent s'ajouter aux 500€ de l'IRIHS.
- proposition d'un hackathon PKM pendant la JE (sur 2 jours)

- conférences invité-es sur les questions
- éditoriale
- d'écosophie[^1]
- de reproductibilité
- de langage (WIP)
- langage de programmation & linguistique / Larry Wall (PERL)
https://piped.video/watch?v=ju1IMxGSuNE
https://piped.video/watch?v=LR8fQiskYII
- notes de lecture
- langages de programmation abstraits / concrets (B. Mélès) : https://hackmd.io/oY-VTywkSpmCKylHaf2l_Q,
- "langage des choses" / [WIP] webinaire : https://hackmd.io/yeXt7jzHTxy9K6WAABjdOQ
- langage & philosophie de la technique (L. Duhem) : à venir
- littéracie
- LP...
- ...

### un agenda de travail avril 2024
- **2 avril / 15h - 16h** (après le webinaire Journal of Digital History) :
- travail sur JE (programme) &
- suite webinaire (épisciences notamment)
- quid de l'article de positionnement du GT ?
- répondre à l'AAC technocritiques - 21/04 https://hackmd.io/oJBl-EwwSnOYxp575dJ5ug ?
- ou à celui de la revue humanités numériques - 8/07 https://journals.openedition.org/revuehn/3900 ?
- **11 avril / 10h - 12h PKM**

[^1]: voir par exemple : https://www.persee.fr/doc/chime_0986-6035_1996_num_28_1_2073
## 19/02/2024

:::info
Présent.e.s :
- Konrad Hinsen
- Nicolas Roelandt
- Sébastien RC
- Raphaelle K.

Excusé.e.s :
Absent.e.s :
:::

### déploiement actuel
https://gt-notebook.gitpages.huma-num.fr/nix/wiki-pandoc-nix/#home

### PKM Futur, cahier des charges :

### Outils à explorer

:::warning
Colonne à compléter avec les items du cahier des charges
:::

[bla2](/k9qJjRncSVCSHcjmey2NMg)

[super note](/FDxU3E_hSM27t5okdBDFXQ)

[[super note](/FDxU3E_hSM27t5okdBDFXQ)]

| Outils | Collaboration | Syntaxe | ZK Friendly | API | Citation | CLI | Versionnement |
| --------- |:--------------- |:---------- | ----------- | ----------- | -------- | ------------ | ------------- |
| Hackmd | Temp Reel | md | Semi[^h_zk] | Oui[^h_cli] | Non | Oui[^h_cli] | Oui (github) |
| LogSeq | Temp Reel[^l_c] | md et org | oui | Oui[l_cli] | Oui | Oui[^l_cli2] | Oui |
| MediaWiki | Temp Reel ? | md et wiki | non | Oui[^l_cli3]| Oui | ? | ? |
| Zetllr | ? | md | oui | non | Oui | ? | externe (git/nextcloud)|

[^h_zk]: Oui / Autocomplétion des notes ; Non / pas de backlink ; Non / Pas de graphe
[^h_cli]: Voir les informations : https://hackmd.io/c/tutorials/
[^l_c]: Prévu, mais pas encore là.
[^l_cli]: https://logseq.github.io/plugins/
[^l_cli2]: https://github.com/cldwalker/logseq-query
[^l_cli3]: https://www.mediawiki.org/wiki/API:Main_page/fr

Item :
- Pouvoir changer de cap, ne pas être "lockin"
- utiliser une syntaxe lisible par une grande variété d'outils. Markdown aisèment convertible en HTML
- Quels sont les formats supportés par le md/org (math, images, etc.)
- Collaboration CIDOC : traduction en markdown, directement sur gitlab, temps d'échanges sur la base de connaissance (élaboration et évolution de la base de connaissance)
- pour discuter du contenu: réunion en synchrone, un seul édite le document
- les commentaires des choix, modifications se font dans les issues.
- rendez-vous très réguliers
- organisation qui a mis du temps à émergé
- des issues orientées contenu et des issues sur le fonctionnement de la plateforme
- Contribution à minima : gitlab (compatible avec les novices)

- quel format pour la contribution ?
- contribution individuelle
- prévoir des moments de travail en groupe
- MédiaWiki :
- accepte le markdown, syntaxe wiki
- solide, pérenne
- gère l'édition simultanée
- https://www.mediawiki.org/wiki/API:Main_page
- Question du lockin et de la pérénité
- hackMD très consommateur en énergie
- Ce qui est structurant dans le GT c'est les webinaires, avec des notes prisent en temps réel qui invitent à des réflexions plus longues.
- HackMD serait à la fois base de connaissance et notes de réunion
- lien à Github uniquement : https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github
- `[[]]` permet de créer des notes avec des identifiants uniques (Zettelkasten friendly )
- penser à régler les droits d'accès (privée par défaut)
- Reconstruction de graphe possible côté front-end
- attention à porter sur les liens internes
-
- En multi-outil c'est important d'avoir un nom de fichier un tant soit peu explicite (element de titre, date et/ou timestamp)
- prévoir un modèle de note ?
- LogSeq a un système de template
- Org-Mode aussi
- Zettlr dispose de snippets

- Compatibilité entre les markdown :
- Logseq ajoute des extensions à lui dans le markdown
- `collapsed:: true`
- hiérachisation des titres
- ex: [[GT Notebook/bibliographie/Simondon]] crée le fichier `GT Noteboob__bibliographie__Simondon.md`
- conversion LogSeq => MD: https://github.com/kcarnold/logseq2pandoc/blob/main/logseq2md.py
- Entete un peu différente etre logseq et zettlr
- définir une structure compatible qui ne seraient pas parsées par les outils
- les métadonnées sont inclues dans le fichier
- date
- titre
- auteurs/autrices
- statut : finalisé, en cours, à faire
- catégories

- Il nous faut quelque chose qui clean/nettoie les ajouts des outils (ex collapsed::true)
- script lua pandoc ?
- git hook ?
-
- Entête minimaux, défini pour notre usage, pas forcément besoin d'être parsé

Plusieurs niveaux de compléxité
- complexe: Intégration avec une routine pour ceux qui ont un outil (LogSew, Emacs)
- intermédiaire : interface gitlab
- simple : Ceux qui n'ont aucun a priori peuvent utiliser HackMD
- HackMD parcouru régulièrement pour être intégré dans le git

Processus d'apprentissage à documenter
- git
- outils d'édition

Proto *dokuwiki* pour niveau intermédiaire
- plugin https://www.dokuwiki.org/plugin:gitbacked
- lien avec hackmd et l'api pour reventiler
- lien avec git

- Garder l'existant ?
- notes de webinaire
- matériau conséquent
- relire et structurer
- entrées bibliographiques
- note individuelle + commentaires

Tester MDWiki (rendu markdown avec npm/js):
- http://dynalon.github.io/mdwiki/
- liens bidirectionnels ?
- intégration avec git ?

La note bibliographique est un type de note
- à partir de Zotero, extraire et créer des notes/noeuds en fonction de certains tags

Privilégier les tags aux catégories
- à condition d'avoir un thésaurus (Karl Voit: https://karl-voit.at/=)
- https://karl-voit.at/2019/09/25/categories-versus-tags/
- https://karl-voit.at/2017/04/18/classification/

### PKM Existant :

https://gitlab.huma-num.fr/gt-notebook/nix

Trois éléments pour la compilation par le CI de gitlab (fichiers .gitlab.yml)

#### Logiciels de compilation des notes (wiki-script)

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/wiki-script/
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-script/-/blob/master/flake.nix)) package la librairie python qui compile les notes. C'est un fork de la librairie https://github.com/lggruspe/slipbox => https://github.com/reyman/slipbox .

:::warning
Depuis les modifications que j'avais fait dans le fork pour ajouter les citations ont été rappatriées dans la version originale de lggruspe.
:::

#### Pandoc

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/pandoc-2-14-02
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/pandoc-2-14-02/-/blob/main/flake.nix?ref_type=heads)) qui package la bonne version de pandoc pour utilisation par wiki-script

#### Script de compilation final (wiki-pandoc)

Le script qui fait la syntese des nix flakes : pandoc & wiki-script

C'est le [.gitlab.yml](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/-/blob/main/.gitlab-ci.yml) qui lance la compile des notes, requete Zotero et publie la page.

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/-/blob/main/flake.nix)) qui fait la synthese de wiki-pandoc et pandoc.

#### Synthèse

*Ce qui est bien :*

*Ce qui est pas bien :*